Skip to content

For help, click the link below to get free database assistance or contact our experts for personalized support.

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-server package depends on percona-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, and zlib1g-dev (required by the development package), come from the distribution repositories. Install the downloaded packages with apt (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.

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

    $ 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
    
  2. The command line instruction uses the tar command to extract files from a tarball (a type of compressed file). The tar command is a Unix utility that stores and extracts files from an archive file known as a tarfile.

    The xvf option combines three separate options: x, v, and f.

    • x extract the files from the archive

    • v verbose - print the file names as they are extracted

    • f file - 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.tar file and prints the file names.

    $ tar xvf Percona-Server-8.0.31-23-r71449379-buster-x86_64-bundle.tar
    
    Expected 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
    
  3. Download the percona-telemetry-agent package for your distribution into the same directory. The following example downloads the package for Debian 12 (bookworm). For another distribution, replace bookworm with 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
    
  4. Install Percona Server for MySQL with apt. The installation requires either root or the sudo command. sudo allows you to run programs with the security privileges of another user, usually as the superuser.

    Unlike dpkg -i, apt installs the missing dependencies from the distribution repositories. With dpkg -i *.deb, packages fail with dependency problems - leaving unconfigured errors.

    The ./*.deb is a wildcard that matches any file in the current directory that ends with the .deb extension. The ./ prefix tells apt to install local files instead of packages from a repository.

    $ sudo apt install ./*.deb
    

    Warning

    If you already ran dpkg -i *.deb and it failed with dependency errors, check the plan before you accept apt --fix-broken install (apt -f install). That command can remove percona-server-server and 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.