Skip to content

Commit 057a89b

Browse files
PS-10369 Add the plugin and update links to open external links in a new tab (8.4) (#622)
* PS-10369 Add the plugin and update links to open external links in a new tab (8.4) modified: docs/quickstart-apt.md modified: docs/quickstart-docker.md modified: docs/quickstart-next-steps.md modified: docs/quickstart-overview.md modified: docs/quickstart-yum.md modified: docs/sequence-table.md modified: docs/server-version-numbers.md modified: docs/slow-extended.md modified: docs/slowlog-rotation.md modified: docs/stacktrace.md modified: docs/start-transaction-with-consistent-snapshot.md modified: docs/telemetry.md modified: docs/thread-based-profiling.md modified: docs/trademark-policy.md modified: docs/trigger-updates.md modified: docs/udf-percona-toolkit.md modified: docs/upgrade-checklist-8.4.md modified: docs/upgrade-components.md modified: docs/upgrade-pro.md modified: docs/upgrade-procedures.md modified: docs/upgrade-strategies.md modified: docs/upgrade.md modified: docs/use-keyring-file.md modified: docs/use-keyring-vault-component.md modified: docs/using-amz-kms.md modified: docs/using-kmip.md modified: docs/utility-user.md modified: docs/yum-download-rpm.md modified: docs/yum-repo.md modified: mkdocs-base.yml modified: requirements.txt * PS-10369 Add the plugin and update links to open external links in a new tab (8.4) modified: docs/quickstart-apt.md modified: docs/quickstart-docker.md modified: docs/quickstart-next-steps.md modified: docs/quickstart-overview.md modified: docs/quickstart-yum.md modified: docs/sequence-table.md modified: docs/server-version-numbers.md modified: docs/slow-extended.md modified: docs/slowlog-rotation.md modified: docs/stacktrace.md modified: docs/start-transaction-with-consistent-snapshot.md modified: docs/telemetry.md modified: docs/thread-based-profiling.md modified: docs/trademark-policy.md modified: docs/trigger-updates.md modified: docs/udf-percona-toolkit.md modified: docs/upgrade-checklist-8.4.md modified: docs/upgrade-components.md modified: docs/upgrade-pro.md modified: docs/upgrade-procedures.md modified: docs/upgrade-strategies.md modified: docs/upgrade.md modified: docs/use-keyring-file.md modified: docs/use-keyring-vault-component.md modified: docs/using-amz-kms.md modified: docs/using-kmip.md modified: docs/utility-user.md modified: docs/yum-download-rpm.md modified: docs/yum-repo.md modified: mkdocs-base.yml modified: requirements.txt * Fix conflicts modified: docs/upgrade-pro.md
1 parent 30c40e7 commit 057a89b

File tree

86 files changed

+223
-329
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

86 files changed

+223
-329
lines changed

docs/8.4-breaking-changes.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
Review these items before upgrading from 8.0 to {{vers}}. This document covers the most significant breaking behavioral changes, removed features, and removed variables that may affect your upgrade. Each entry includes the impact, replacement (if available), and recommended action.
44

5-
Review the [MySQL 8.4 Reference manual](https://dev.mysql.com/doc/refman/8.4/en/) for more information.
5+
Review the [MySQL 8.4 Reference manual :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.4/en/) for more information.
66

77
## Authentication and user management
88

docs/adaptive-network-buffers.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
To find the buffer size of the current connection, use the `network_buffer_length` status variable. Add `SHOW GLOBAL` to review the cumulative buffer sizes for all connections. This variable can help to estimate the maximum size of the network buffer’s overhead.
44

5-
Network buffers grow towards the [max_allowed_packet] size and do not shrink until the connection is terminated. For example, if the connections are selected at random from the pool, an occasional big query eventually increases the buffers of all connections. The combination of max_allowed packet set to a value between 64MB and 128MB and the connection number between 256 and 1024 can create a large memory overhead.
5+
Network buffers grow towards the [max_allowed_packet :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-variables.html#sysvar_max_allowed_packet) size and do not shrink until the connection is terminated. For example, if the connections are selected at random from the pool, an occasional big query eventually increases the buffers of all connections. The combination of max_allowed packet set to a value between 64MB and 128MB and the connection number between 256 and 1024 can create a large memory overhead.
66

77
Percona Server for MySQL implemented the [net_buffer_shrink_interval](#net_buffer_shrink_interval) variable to solve this issue. The default value is 0 (zero). If you set the value higher than 0, Percona Server records the network buffer’s maximum use size for the number of seconds set by net_buffer_shrink_interval. When the next interval starts, the network buffer is set to the recorded size. This action removes spikes in the buffer size.
88

@@ -19,5 +19,3 @@ You can achieve similar results by disconnecting and reconnecting the TCP connec
1919
| Default value: | 0 |
2020

2121
The interval is measured in seconds. The default value is 0, which disables the functionality. The minimum value is 0, and the maximum value is 31536000.
22-
23-
[max_allowed_packet]: https://dev.mysql.com/doc/refman/{{vers}}/en/server-system-variables.html#sysvar_max_allowed_packet

docs/advisors.md

Lines changed: 3 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,6 @@
11
# Use Percona Monitoring and Management (PMM) Advisors
22

3-
[Percona Monitoring and Management (PMM)](https://www.percona.com/software/database-
4-
tools/percona-monitoring-and-management) provides several categories of Advisors.
3+
[Percona Monitoring and Management (PMM) :octicons-link-external-16:](https://www.percona.com/software/database-tools/percona-monitoring-and-management) provides several categories of Advisors.
54
Each Advisor contains a set of automated checks. These checks investigate your
65
database settings for a specific range of possible issues.
76

@@ -11,10 +10,9 @@ Both options are enabled by default.
1110

1211
!!! note "Need Additional Guidance?"
1312
If you encounter complex advisor recommendations or require expert
14-
interpretation, [Percona Support](https://www.percona.com/services/support)
13+
interpretation, [Percona Support :octicons-link-external-16:](https://www.percona.com/services/support)
1514
offers professional assistance to help you optimize your database
1615
configuration and resolve any identified issues.
1716

1817
!!! admonition "See also"
19-
[PMM documentation - Advisor checks](https://docs.percona.com/percona-platform/
20-
advisors.html)
18+
[PMM documentation - Advisor checks :octicons-link-external-16:](https://docs.percona.com/percona-monitoring-and-management/3/advisors/advisors.html)

docs/aio-page-requests.md

Lines changed: 5 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -4,12 +4,11 @@ The I/O unit size in *InnoDB* is only one page, even if the server doing read ah
44
I/O unit size is too small for sequential reads, and less efficient than a larger I/O unit size. *InnoDB* uses Linux asynchronous I/O (`aio`) by default. By submitting multiple, consecutive 16KB read requests at the same time, Linux internally merges the requests and
55
reads more efficiently.
66

7-
This feature is able to submit multiple page I/O requests and works in the background. You can manage the feature with the [linear read-ahead technique]. This technique adds pages to the buffer pool based on the buffer pool pages being accessed sequentially. The [`innodb_read_ahead_threshold`] configuration parameter controls this operation.
7+
This feature is able to submit multiple page I/O requests and works in the background. You can manage the feature with the [linear read-ahead technique]. This technique adds pages to the buffer pool based on the buffer pool pages being accessed sequentially. The [`innodb_read_ahead_threshold`](https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold) configuration parameter controls this operation.
88

9-
[On a HDD RAID 1+0 environment](http://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html),
9+
[On a HDD RAID 1+0 environment :octicons-link-external-16:](http://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html),
1010
more than 1000MB/s disk reads can be achieved by submitting 64 consecutive pages
11-
requests at once, while only
12-
160MB/s disk reads is shown by submitting single page request.
11+
requests at once, while only 160MB/s disk reads is shown by submitting single page request.
1312

1413
## Status variables
1514

@@ -24,10 +23,6 @@ This variable shows the number of submitted buffered asynchronous I/O requests.
2423

2524
## Other reading
2625

27-
* [Making full table scan 10x faster in InnoDB](https://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html)
26+
* [Making full table scan 10x faster in InnoDB :octicons-link-external-16:](https://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html)
2827

29-
* [Bug #68659 InnoDB Linux native aio should submit more i/o requests at once](https://bugs.mysql.com/bug.php?id=68659)
30-
31-
[linear read-ahead technique]: https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-performance-read_ahead.html
32-
33-
[`innodb_read_ahead_threshold`]: https://dev.mysql.com/doc/refman/{{vers}}/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold
28+
* [Bug #68659 InnoDB Linux native aio should submit more i/o requests at once :octicons-link-external-16:](https://bugs.mysql.com/bug.php?id=68659)

docs/apt-download-deb.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
# Install Percona Server for MySQL {{vers}} using downloaded DEB packages
22

3-
Download the packages from [Percona Product Downloads](https://www.percona.com/downloads). If needed, [Instructions for the Percona Product Download](download-instructions.md) are available.
3+
Download the packages from [Percona Product Downloads :octicons-link-external-16:](https://www.percona.com/downloads). If needed, [Instructions for the Percona Product Download](download-instructions.md) are available.
44

55
The following example downloads Percona Server for MySQL {{release}} release packages for Ubuntu 22.04:
66

docs/apt-pinning.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -12,4 +12,4 @@ Pin: release o=Percona Development Team
1212
Pin-Priority: 1001
1313
```
1414

15-
For more information about the pinning, you can check the official [debian wiki](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
15+
For more information about the pinning, you can check the official [debian wiki :octicons-link-external-16:](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).

docs/apt-repo.md

Lines changed: 4 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Use an APT repository to install Percona Server for MySQL {{vers}}
22

3-
Ready-to-use packages are available from the Percona Server for MySQL software repositories and the [Percona downloads] page.
3+
Ready-to-use packages are available from the Percona Server for MySQL software repositories and the [Percona downloads :octicons-link-external-16:](https://www.percona.com/downloads/Percona-Server-{{vers}}/) page.
44

5-
Specific information on the supported platforms, products, and versions is described in [Percona Software and Platform Lifecycle](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
5+
Specific information on the supported platforms, products, and versions is described in [Percona Software and Platform Lifecycle :octicons-link-external-16:](https://www.percona.com/services/policies/percona-software-platform-lifecycle#mysql).
66

77
--8<-- "percona-release.md"
88

@@ -272,7 +272,7 @@ To install Percona Server for MySQL using APT, follow these steps:
272272

273273
* Review error messages for specific issues
274274

275-
See [Configuring Percona repositories with `percona-release`](https://docs.percona.com/percona-software-repositories/percona-release.html) for more information.
275+
See [Configuring Percona repositories with `percona-release` :octicons-link-external-16:](https://docs.percona.com/percona-software-repositories/percona-release.html) for more information.
276276

277277
--8<--- "storage-engines.md"
278278

@@ -282,7 +282,7 @@ After successful installation, see [Post-installation](post-installation.md) for
282282

283283
## Install Percona Toolkit UDFs (Optional)
284284

285-
Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These UDFs provide faster checksum calculations:
285+
Percona Server for MySQL includes user-defined functions (UDFs) from [Percona Toolkit :octicons-link-external-16:](https://docs.percona.com/percona-toolkit/). These UDFs provide faster checksum calculations:
286286

287287
* `fnv_64`: Fast hash function
288288

@@ -377,6 +377,4 @@ $ sudo apt update
377377
All packages are up to date.
378378
```
379379

380-
[Percona downloads]: https://www.percona.com/downloads/Percona-Server-{{vers}}/
381-
382380
[Telemetry data]: telemetry.md

docs/audit-log-filter-variables.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -676,7 +676,7 @@ This read-only variable specifies the syslog tag value. This variable requires a
676676
| Data type | String |
677677
| Default | LOG_USER |
678678

679-
This read-only variable specifies the syslog `facility` value. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
679+
This read-only variable specifies the syslog `facility` value. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).
680680

681681

682682
### `audit_log_filter.syslog_priority`
@@ -689,7 +689,7 @@ This read-only variable specifies the syslog `facility` value. This variable req
689689
| Data type | String |
690690
| Default | LOG_INFO |
691691

692-
This read-only variable defines the `priority` value for the syslog. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
692+
This read-only variable defines the `priority` value for the syslog. This variable requires a server restart to change. The option has the same meaning as the appropriate parameter described in the [syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).
693693

694694
## Audit log filter status variables
695695

docs/backup-restore-overview.md

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ A backup can be either a physical backup or a logical backup.
5252
A physical backup copies the files needed to store and recover the database. They can be data files, configuration files,
5353
logs, and other types of files. The physical database can be stored in the cloud, in offline storage, on disc, or tape.
5454

55-
[Percona XtraBackup] takes a physical backup. You can also
55+
[Percona XtraBackup :octicons-link-external-16:](https://docs.percona.com/percona-xtrabackup/{{vers}}/index.html) takes a physical backup. You can also
5656
use RDS/LVM Snapshots or the MySQL Enterprise Backup.
5757

5858
If the server is stopped or down, you can copy the datadir with the `cp` command or the `rsync` command.
@@ -61,10 +61,10 @@ If the server is stopped or down, you can copy the datadir with the `cp` command
6161

6262
A logical backup contains the structural details. This type of backup contains tables, views, procedures, and functions.
6363

64-
Tools like [`mysqldump`],
65-
[`mydumper`],
66-
[`mysqlpump`], and
67-
[`mysql shell`] take a logical backup.
64+
Tools like [`mysqldump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/mysqldump.html),
65+
[`mydumper` :octicons-link-external-16:](https://github.com/mydumper/mydumper)
66+
[`mysqlpump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/{{vers}}/en/mysqlpump.html), and
67+
[`mysql shell` :octicons-link-external-16:](https://dev.mysql.com/doc/mysql-shell/{{vers}}/en/mysql-shell-utilities-dump-instance-schema.html) take a logical backup.
6868

6969
### Comparison
7070

@@ -73,9 +73,3 @@ Tools like [`mysqldump`],
7373
| Content | The physical database files | The tables, users, procedures, and functions |
7474
| Restore speed | Restore can be quick | Restore can be slower and does not include file information. |
7575
| Storage | Can take more space | Based on what is selected, the backup can be smaller |
76-
77-
[`mysqldump`]: https://dev.mysql.com/doc/refman/{{vers}}/en/mysqldump.html
78-
[`mydumper`]: https://github.com/mydumper/mydumper
79-
[`mysqlpump`]: https://dev.mysql.com/doc/refman/{{vers}}/en/mysqlpump.html
80-
[`mysql shell`]: https://dev.mysql.com/doc/mysql-shell/{{vers}}/en/mysql-shell-utilities-dump-instance-schema.html
81-
[Percona XtraBackup]: https://docs.percona.com/percona-xtrabackup/innovation-release/index.html

docs/binary-tarball-install.md

Lines changed: 1 addition & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4,13 +4,10 @@ A binary tarball contains a group of files, including the source code, bundled t
44

55
See the list of the [binary tarball available based on the Percona Server for MySQL version](binary-tarball-names.md) to select the right tarball for your environment.
66

7-
You can download the binary tarballs from the `Linux - Generic` [section] on the download page.
7+
You can download the binary tarballs from the `Linux - Generic` [section :octicons-link-external-16:](https://www.percona.com/downloads/Percona-Server-{{vers}}/LATEST/binary/tarball/) on the download page.
88

99
Fetch and extract the correct binary tarball. For example for Ubuntu 22.04:
1010

1111
```{.bash data-prompt="$"}
1212
$ wget https://downloads.percona.com/downloads/Percona-Server-innovative-release/Percona-Server-{{release}}/binary/tarball/Percona-Server-{{release}}-Linux.x86_64.glibc2.35.tar.gz
1313
```
14-
15-
[section]: https://www.percona.com/downloads/Percona-Server-{{vers}}/LATEST/binary/tarball/
16-

0 commit comments

Comments
 (0)