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

Specific information on the supported platforms, products, and versions is described in Percona Software and Platform Lifecycle.

Install Percona Server for MySQL using APT¶

Update the package repositories:
```
$ sudo apt update
```
Install the curl download utility if needed:
```
$ sudo apt install curl
```

Download the percona-release repository package:

$ curl -O https://repo.percona.com/apt/percona-release_latest.generic_all.deb

Install the downloaded package with apt as root or with sudo:

$ sudo apt install gnupg2 lsb-release ./percona-release_latest.generic_all.deb

Refresh the local cache to update the package information:
```
$ sudo apt update
```
Use percona-release to set up the repository for the Percona Server for MySQL 8.0 version:
```
$ sudo percona-release setup ps80
```
You can check the repository setup for the Percona original release list in /etc/apt/sources.list.d/percona-original-release.list.
Install the server package with the percona-release command:
```
$ sudo apt install percona-server-server
```

See Configuring Percona repositories with percona-release for more information.

Percona Server for MySQL 8.0 comes with the TokuDB and MyRocks storage engine and can be installed as a plugin. For information on installing and configuring MyRocks, refer to the Percona MyRocks Installation Guide.

For information on installing and configuring TokuDB, refer to the TokuDB Installation Guide.

From Percona Server for MySQL 8.0.28-19, the TokuDB storage engine is no longer supported. We have removed the storage engine from the installation packages and disabled the storage engine in our binary builds.

From Percona Server for MySQL 8.0.26-16, the binary builds and packages include but disable the TokuDB storage engine plugins. The tokudb_enabled option and the tokudb_backup_enabled option control the state of the plugins and have a default setting of FALSE. The result of attempting to load the plugins are the plugins fail to initialize and print a deprecation message.

We recommend Migrating the data to the MyRocks storage engine. To enable the plugins to migrate to another storage engine, set the tokudb_enabled and tokudb_backup_enabled options to TRUE in your my.cnf file and restart your server instance. Then, you can load the plugins.

The TokuDB storage engine was declared as deprecated in Percona Server for MySQL 8.0. For more information, see the Percona blog post: Heads-Up: TokuDB Support Changes and Future Removal from Percona Server for MySQL 8.0.

Percona Server for MySQL contains user-defined functions from Percona Toolkit. These user-defined functions provide faster checksums. For more details on the user-defined functions, see Percona Toolkit UDF functions.

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

mysql -e "CREATE FUNCTION fnv1a_64 RETURNS INTEGER SONAME 'libfnv1a_udf.so'"
mysql -e "CREATE FUNCTION fnv_64 RETURNS INTEGER SONAME 'libfnv_udf.so'"
mysql -e "CREATE FUNCTION murmur_hash RETURNS INTEGER SONAME 'libmurmur_udf.so'"

Install the Percona Testing repository using APT¶

Percona offers pre-release builds from the testing repository. To enable it, run percona-release with the testing argument. Run the following command as root or use the sudo command:

$ sudo percona-release enable ps80 testing

These builds should not be run in production. This build may not contain all of the features available in the final release. The features may change without notice.

Contact us

For free technical help, visit the Percona Community Forum.

To report bugs or submit feature requests, open a JIRA ticket.

For paid support and managed or consulting services , contact Percona Sales.

Last update: 2023-09-27