Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion docs/adaptive-network-buffers.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

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.

Network buffers grow towards the [max_allowed_packet](https://dev.mysql.com/doc/refman/8.0/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 to 128MB and the connection number between 256 to 1024 can create a large memory overhead.
Network buffers grow towards the [max_allowed_packet :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/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 to 128MB and the connection number between 256 to 1024 can create a large memory overhead.

*Percona Server for MySQL* version 8.0.23-14 introduces 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.

Expand Down
4 changes: 2 additions & 2 deletions docs/added-features.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,6 @@ The following is a list of the latest supported features:

* Using a global variable `rocksdb_cancel_manual_compactions` to cancel all ongoing manual compactions.

* **Percona Server for MySQL** 8.0.23-14 adds supported for [Generated Columns](https://dev.mysql.com/doc/refman/8.0/en/create-table-generated-columns.html) and index are supported. Generated columns are not supported in versions earlier than 8.0.23-14.
* **Percona Server for MySQL** 8.0.23-14 adds supported for [Generated Columns :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/create-table-generated-columns.html) and index are supported. Generated columns are not supported in versions earlier than 8.0.23-14.

* **Percona Server for MySQL** 8.0.23-14 adds support for [explicit DEFAULT value expressions](https://dev.mysql.com/doc/refman/8.0/en/data-type-defaults.html). From version 8.0.13-3 to version 8.0.22-13, MyRocks did not support these expressions.
* **Percona Server for MySQL** 8.0.23-14 adds support for [explicit DEFAULT value expressions :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/data-type-defaults.html). From version 8.0.13-3 to version 8.0.22-13, MyRocks did not support these expressions.
6 changes: 3 additions & 3 deletions docs/advisors.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,11 @@
# Use Percona Monitoring and Management (PMM) Advisors

[Percona Monitoring and Management (PMM)](https://www.percona.com/software/database-tools/percona-monitoring-and-management) provides several categories of Advisors. Each Advisor contains a set of automated checks. These checks investigate your database settings for a specific range of possible issues.
[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. Each Advisor contains a set of automated checks. These checks investigate your database settings for a specific range of possible issues.

[The Percona Platform](https://www.percona.com/software/percona-platform) hosts the Advisors.
[The Percona Platform :octicons-link-external-16:](https://www.percona.com/software/percona-platform) hosts the Advisors.

The PMM Server automatically downloads the Advisors if the `Advisors` and `Telemetry` options are enabled in `Configuration > Settings > Advanced Settings`. Both options are enabled by default.

!!! admonition "See also"

[PMM documentation - Advisor checks](https://docs.percona.com/percona-platform/advisors.html)
[PMM documentation - Advisor checks :octicons-link-external-16:](https://docs.percona.com/percona-platform/advisors.html)
8 changes: 4 additions & 4 deletions docs/aio-page-requests.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,9 +4,9 @@ The I/O unit size in *InnoDB* is only one page, even if the server doing read ah
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
reads more efficiently.

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](https://dev.mysql.com/doc/refman/8.0/en/innodb-performance-read_ahead.html). 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/8.0/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold) configuration parameter controls this operation.
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 :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/innodb-performance-read_ahead.html). This technique adds pages to the buffer pool based on the buffer pool pages being accessed sequentially. The [`innodb_read_ahead_threshold` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/innodb-parameters.html#sysvar_innodb_read_ahead_threshold) configuration parameter controls this operation.

[On a HDD RAID 1+0 environment](http://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html),
[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),
more than 1000MB/s disk reads can be achieved by submitting 64 consecutive pages
requests at once, while only
160MB/s disk reads is shown by submitting single page request.
Expand All @@ -28,6 +28,6 @@ This variable shows the number of submitted buffered asynchronous I/O requests.

## Other reading

* [Making full table scan 10x faster in InnoDB](https://yoshinorimatsunobu.blogspot.hr/2013/10/making-full-table-scan-10x-faster-in.html)
* [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)

* [Bug #68659 InnoDB Linux native aio should submit more i/o requests at once](https://bugs.mysql.com/bug.php?id=68659)
* [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)
2 changes: 1 addition & 1 deletion docs/apt-download-deb.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ When installing packages manually, you must resolve all the dependencies and ins

* `libmecab2`.

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.
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.

1. The following example uses `Wget` to download the Percona Server 8.0 bundle from the specified URL. The bundle is a tar archive containing the Percona Server 8.0.31-23 binary for Debian Buster (x86_64 architecture):

Expand Down
2 changes: 1 addition & 1 deletion docs/apt-pinning.md
Original file line number Diff line number Diff line change
Expand Up @@ -19,4 +19,4 @@ Pin-Priority: 1001

Save this file and update your package lists with `sudo apt update`. Finally, install Percona Server for MySQL 8.0 with `sudo apt install percona-server-server-8.0`, and apt will adhere to your pinning preferences.

For more information, see [debian wiki on AptConfiguration](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
For more information, see [debian wiki on AptConfiguration :octicons-link-external-16:](https://wiki.debian.org/AptConfiguration?action=show&redirect=AptPreferences).
10 changes: 5 additions & 5 deletions docs/apt-repo.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,17 @@
# Use an APT repository to install Percona Server for MySQL 8.0

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

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).
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).

We gather [Telemetry data] in the Percona packages and Docker images.

Review [Get more help](get-help.md) for ways that we can work with you.

## Version changes

Starting with [Percona Server 8.0.37-29](release-notes/8.0.37-29.md), the following operating systems on [Percona Software Download](https://www.percona.com/downloads) include ARM64 packages with the `arm64.deb` extension:
Starting with [Percona Server 8.0.37-29](release-notes/8.0.37-29.md), the following operating systems on [Percona Software Download :octicons-link-external-16:](https://www.percona.com/downloads) include ARM64 packages with the `arm64.deb` extension:

* Debian GNU/Linux 12.0

Expand Down Expand Up @@ -80,12 +80,12 @@ Starting with [Percona Server 8.0.37-29](release-notes/8.0.37-29.md), the follow
$ sudo apt install percona-server-server
```

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


Starting with Percona Server for MySQL 8.0.28-19 (2022-05-12), the TokuDB storage engine is no longer supported. For more information, see the [TokuDB Introduction](tokudb-intro.md) and [TokuDB version changes](tokudb-version-changes.md).

Percona Server for MySQL contains user-defined functions from the [Percona Toolkit](https://docs.percona.com/percona-toolkit/). These user-defined functions provide faster checksums. For more details on the user-defined functions, see [Percona Toolkit UDF functions](udf-percona-toolkit.md).
Percona Server for MySQL contains user-defined functions from the [Percona Toolkit :octicons-link-external-16:](https://docs.percona.com/percona-toolkit/). These user-defined functions provide faster checksums. For more details on the user-defined functions, see [Percona Toolkit UDF functions](udf-percona-toolkit.md).

After the installation completes, run the following commands to create these functions:

Expand Down
2 changes: 1 addition & 1 deletion docs/apt-run.md
Original file line number Diff line number Diff line change
Expand Up @@ -30,7 +30,7 @@ Run the following commands as root or by using the sudo command

!!! note

Debian 9.0 (stretch) and Ubuntu 18.04 LTS (bionic) come with [systemd](http://freedesktop.org/wiki/Software/systemd/) as the default system and service manager. You can invoke all the above commands with `systemctl` instead of `service`. Currently, both are supported.
Debian 9.0 (stretch) and Ubuntu 18.04 LTS (bionic) come with [systemd :octicons-link-external-16:](http://freedesktop.org/wiki/Software/systemd/) as the default system and service manager. You can invoke all the above commands with `systemctl` instead of `service`. Currently, both are supported.

## Working with AppArmor

Expand Down
2 changes: 1 addition & 1 deletion docs/audit-log-filter-variables.md
Original file line number Diff line number Diff line change
Expand Up @@ -727,7 +727,7 @@ messages. The default value is "audit-filter".
| Data type | String |
| Default | LOG_INFO |

Defines the `priority` value for the syslog. 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).
Defines the `priority` value for the syslog. 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).

## Performance and buffering

Expand Down
10 changes: 5 additions & 5 deletions docs/audit-log-plugin.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

Percona Audit Log Plugin provides monitoring and logging of connection and query
activity that were performed on specific server. Information about the activity
is stored in a log file. This implementation is alternative to the [MySQL Enterprise Audit Log Plugin](https://dev.mysql.com/doc/refman/8.0/en/audit-log.html).
is stored in a log file. This implementation is alternative to the [MySQL Enterprise Audit Log Plugin :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/audit-log.html).

## Version specific information

Expand Down Expand Up @@ -283,7 +283,7 @@ The audit Log plugin generates a log of following events.

## Stream the audit log to syslog

To stream the audit log to syslog you’ll need to set audit_log_handler variable to `SYSLOG`. To control the syslog file handler, the following variables can be used: audit_log_syslog_ident, audit_log_syslog_facility, and audit_log_syslog_priority These variables have the same meaning as appropriate parameters described in the [syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
To stream the audit log to syslog you’ll need to set audit_log_handler variable to `SYSLOG`. To control the syslog file handler, the following variables can be used: audit_log_syslog_ident, audit_log_syslog_facility, and audit_log_syslog_priority These variables have the same meaning as appropriate parameters described in the [syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).

!!! note

Expand Down Expand Up @@ -879,7 +879,7 @@ will be written to syslog.

This variable is used to specify the `ident` value for syslog. This variable
has the same meaning as the appropriate parameter described in the [syslog(3)
manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).

### `audit_log_syslog_facility`

Expand All @@ -893,7 +893,7 @@ manual](https://man7.org/linux/man-pages/man3/syslog.3.html).

This variable is used to specify the `facility` value for syslog. This
variable has the same meaning as the appropriate parameter described in the
[syslog(3) manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
[syslog(3) manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).

### `audit_log_syslog_priority`

Expand All @@ -918,7 +918,7 @@ lower the level as needed, while the facility stays at its default unless you
change it explicitly.

For more details about syslog priority levels, see the [syslog(3)
manual](https://man7.org/linux/man-pages/man3/syslog.3.html).
manual :octicons-link-external-16:](https://man7.org/linux/man-pages/man3/syslog.3.html).

## Status Variables

Expand Down
8 changes: 4 additions & 4 deletions docs/backup-restore-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -61,10 +61,10 @@ If the server is stopped or down, you can copy the datadir with the `cp` command

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

Tools like [`mysqldump`](https://dev.mysql.com/doc/refman/8.0/en/mysqldump.html) ,
[`mydumper`](https://github.com/mydumper/mydumper),
[`mysqlpump`](https://dev.mysql.com/doc/refman/5.7/en/mysqlpump.html), and
[`mysql shell`](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-utilities-dump-instance-schema.html)
Tools like [`mysqldump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/8.0/en/mysqldump.html) ,
[`mydumper` :octicons-link-external-16:](https://github.com/mydumper/mydumper),
[`mysqlpump` :octicons-link-external-16:](https://dev.mysql.com/doc/refman/5.7/en/mysqlpump.html), and
[`mysql shell` :octicons-link-external-16:](https://dev.mysql.com/doc/mysql-shell/8.0/en/mysql-shell-utilities-dump-instance-schema.html)
take a logical backup.

### Comparison
Expand Down
2 changes: 1 addition & 1 deletion docs/binary-tarball-install.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ A binary tarball contains a group of files, including the source code, bundled t

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.

You can download the binary tarballs from the `Linux - Generic` [section](https://www.percona.com/downloads) on the download page.
You can download the binary tarballs from the `Linux - Generic` [section :octicons-link-external-16:](https://www.percona.com/downloads) on the download page.

Fetch and extract the correct binary tarball. For example, for Debian 10:

Expand Down
2 changes: 1 addition & 1 deletion docs/binary-tarball-names.md
Original file line number Diff line number Diff line change
Expand Up @@ -78,7 +78,7 @@ If the `glibc2` version from your operating system is not listed, then this Perc
| Debian 11.1 | Able to run the ZenFS plugin |
| Ubuntu 20.04.3 | Requires the 5.11 HWE kernel patched with the allow blk-zoned ioctls without CAPT_SYS_ADMIN patch |

If you do not enable the ZenFS functionality on Ubuntu 20.04, the binaries with ZenFS support can run on the standard 5.4 kernel. [Other Linux distributions](https://zonedstorage.io/docs/distributions/linux/) are adding support for ZenFS, but Percona does not provide installation packages for those distributions.
If you do not enable the ZenFS functionality on Ubuntu 20.04, the binaries with ZenFS support can run on the standard 5.4 kernel. [Other Linux distributions :octicons-link-external-16:](https://zonedstorage.io/docs/distributions/linux/) are adding support for ZenFS, but Percona does not provide installation packages for those distributions.

=== "8.0.20-11 to 8.0.25-17"

Expand Down
Loading
Loading