Installing Percona Server for MySQL 8.0.18-9

This page provides the information on how to you can install Percona Server for MySQL. Following options are available:

Before installing, you might want to read the Percona Server for MySQL 8.0 Release notes.

Installing Percona Server for MySQL from Repositories

Percona provides repositories for yum (RPM packages for Red Hat, CentOS and Amazon Linux AMI) and apt (.deb packages for Ubuntu and Debian) for software such as Percona Server for MySQL, Percona XtraBackup, and Percona Toolkit. This makes it easy to install and update your software and its dependencies through your operating system’s package manager. This is the recommended way of installing where possible.

Following guides describe the installation process for using the official Percona repositories for .deb and .rpm packages.

Installing Percona Server for MySQL from a Binary Tarball

Percona Server for MySQL offers multiple tarballs depending on the OpenSSL library available in the distribution:

  • ssl100 - for Debian prior to 9 and Ubuntu prior to 14.04 versions (libssl.so.1.0.0 => /usr/lib/x86_64-linux-gnu/libssl.so.1.0.0 (0x00007f2e389a5000));
  • ssl101 - for CentOS 6 and CentOS 7 (libssl.so.10 => /usr/lib64/libssl.so.10 (0x00007facbe8c4000));
  • ssl102 - for Debian 9 and Ubuntu versions starting from 14.04 (libssl.so.1.1 => /usr/lib/libssl.so.1.1 (0x00007f5e57397000);

You can download the binary tarballs from the Linux - Generic section on the download page.

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

$ wget https://www.percona.com/downloads/Percona-Server-LATEST/Percona-Server-8.0.13-3/binary/tarball/Percona-Server-8.0.13-3-Linux.x86_64.ssl102.tar.gz

Installing Percona Server for MySQL from a Source Tarball

Fetch and extract the source tarball. For example:

$ wget https://www.percona.com/downloads/Percona-Server-LATEST/Percona-Server-8.0.13-3/source/tarball/Percona-Server-8.0.13-3-Linux.x86_64.ssl102.tar.gz
$ tar xfz percona-server-8.0.13-3.tar.gz

Next, follow the instructions in Compiling Percona Server for MySQL from Source below.

Installing Percona Server for MySQL from the Git Source Tree

Percona uses the Github revision control system for development. To build the latest Percona Server for MySQL from the source tree you will need git installed on your system.

You can now fetch the latest Percona Server for MySQL 8.0 sources.

$ git clone https://github.com/percona/percona-server.git
$ cd percona-server
$ git checkout 8.0
$ git submodule init
$ git submodule update

If you are going to be making changes to Percona Server for MySQL 8.0 and wanting to distribute the resulting work, you can generate a new source tarball (exactly the same way as we do for release):

$ cmake .
$ make dist

Next, follow the instructions in Compiling Percona Server for MySQL from Source below.

Compiling Percona Server for MySQL from Source

After either fetching the source repository or extracting a source tarball (from Percona or one you generated yourself), you will now need to configure and build Percona Server for MySQL.

Important

Make sure that gcc installed on your system is at least of a version in the 4.9 release series.

First, run cmake to configure the build. Here you can specify all the normal build options as you do for a normal MySQL build. Depending on what options you wish to compile Percona Server for MySQL with, you may need other libraries installed on your system. Here is an example using a configure line similar to the options that Percona uses to produce binaries:

$ cmake . -DCMAKE_BUILD_TYPE=RelWithDebInfo -DBUILD_CONFIG=mysql_release -DFEATURE_SET=community

Now, compile using make

$ make

Install:

$ make install

Percona Server for MySQL 8.0 will now be installed on your system.

Building Percona Server for MySQL Debian/Ubuntu packages

If you wish to build your own Debian/Ubuntu (dpkg) packages of Percona Server for MySQL, you first need to start with a source tarball, either from the Percona website or by generating your own by following the instructions above( Installing Percona Server for MySQL from the Git Source Tree).

Extract the source tarball:

$ tar xfz Percona-Server-8.0.13-3-Linux.x86_64.ssl102.tar.gz
$ cd Percona-Server-8.0.13-3

Put the debian packaging in the directory that Debian expects it to be in:

$ cp -ap build-ps/debian debian

Update the changelog for your distribution (here we update for the unstable distribution - sid), setting the version number appropriately. The trailing one in the version number is the revision of the Debian packaging.

$ dch -D unstable --force-distribution -v "8.0.13-3-1" "Update to 8.0.13-3"

Build the Debian source package:

$ dpkg-buildpackage -S

Use sbuild to build the binary package in a chroot:

$ sbuild -d sid percona-server-8.0_8.0.13-3-1.dsc

You can give different distribution options to dch and sbuild to build binary packages for all Debian and Ubuntu releases.

Note

PAM Authentication Plugin is not built with the server by default. In order to build the Percona Server for MySQL with PAM plugin, additional option -DWITH_PAM=ON should be used.