Install Percona Server for MySQL 8.0 using downloaded DEB packages¶
When installing packages manually, you must provide all the dependencies. The bundle does not contain all of them:
-
The
percona-server-serverpackage depends onpercona-telemetry-agent. This package is not in the bundle or in the distribution repositories, so you must download it separately (see step 3). -
The other dependencies, such as
libaio1,libmecab2,libnuma1,libatomic1, andzlib1g-dev(required by the development package), come from the distribution repositories. Install the downloaded packages withapt(see step 4), which installs these dependencies automatically.
Download the packages from Percona Product Downloads . If needed, Instructions for the Percona Product Download are available.
-
The following example uses
Wgetto 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):$ wget https://downloads.percona.com/downloads/Percona-Server-8.0/Percona-Server-8.0.31-23/binary/debian/buster/x86_64/Percona-Server-8.0.31-23-r71449379-buster-x86_64-bundle.tar -
The command line instruction uses the
tarcommand to extract files from a tarball (a type of compressed file). Thetarcommand is a Unix utility that stores and extracts files from an archive file known as a tarfile.The
xvfoption combines three separate options:x,v, andf.-
xextract the files from the archive -
vverbose - print the file names as they are extracted -
ffile - use the following argument as the name of the archive file
The following command extracts the contents of the
Percona-Server-8.0.31-23-r71449379-buster-x86_64-bundle.tarfile and prints the file names.$ tar xvf Percona-Server-8.0.31-23-r71449379-buster-x86_64-bundle.tarExpected output
libperconaserverclient21_8.0.31-23-1.buster_amd64.deb libperconaserverclient21-dev_8.0.31-23-1.buster_amd64.deb percona-mysql-router_8.0.31-23-1.buster_amd64.deb percona-server-client_8.0.31-23-1.buster_amd64.deb percona-server-common_8.0.31-23-1.buster_amd64.deb percona-server-dbg_8.0.31-23-1.buster_amd64.deb percona-server-rocksdb_8.0.31-23-1.buster_amd64.deb percona-server-server_8.0.31-23-1.buster_amd64.deb percona-server-source_8.0.31-23-1.buster_amd64.deb percona-server-test_8.0.31-23-1.buster_amd64.deb -
-
Download the
percona-telemetry-agentpackage for your distribution into the same directory. The following example downloads the package for Debian 12 (bookworm). For another distribution, replacebookwormwith its codename.$ wget https://repo.percona.com/telemetry/apt/pool/main/p/percona-telemetry-agent/percona-telemetry-agent_1.0.17-1.bookworm_amd64.deb -
Install Percona Server for MySQL with
apt. The installation requires either root or thesudocommand.sudoallows you to run programs with the security privileges of another user, usually as the superuser.Unlike
dpkg -i,aptinstalls the missing dependencies from the distribution repositories. Withdpkg -i *.deb, packages fail withdependency problems - leaving unconfigurederrors.The
./*.debis a wildcard that matches any file in the current directory that ends with the.debextension. The./prefix tellsaptto install local files instead of packages from a repository.$ sudo apt install ./*.debWarning
If you already ran
dpkg -i *.deband it failed with dependency errors, check the plan before you acceptapt --fix-broken install(apt -f install). That command can removepercona-server-serverand the packages that depend on it, instead of installing the missing dependencies.
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 and TokuDB changes by Percona Server for MySQL version.