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.