Install on Debian or Ubuntu¶

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

The packages are available in the official Percona software repository and on the download page. It is recommended to install Percona XtraDB Cluster from the official repository using APT.

We gather Telemetry data in the Percona packages and Docker images.

Review Get more help for ways that we can work with you.

Prerequisites¶

You need to have root access on the node where you will be installing Percona XtraDB Cluster (either logged in as a user with root privileges or be able to run commands with sudo).
Make sure that the following ports are not blocked by firewall or used by other software. Percona XtraDB Cluster requires them for communication.
- 3306
- 4444
- 4567
- 4568

Install from Repository¶

Update the sytem:
```
sudo apt update
```

Install the necessary packages:

sudo apt install -y wget gnupg2 lsb-release curl

Download the repository package

wget https://repo.percona.com/apt/percona-release_latest.generic_all.deb

Install the package with dpkg:

sudo dpkg -i percona-release_latest.generic_all.deb

Refresh the local cache to update the package information:
```
sudo apt update
```
Enable the release repository for Percona XtraDB Cluster:
```
sudo percona-release setup pxc80
```

Install the cluster:

sudo apt install -y percona-xtradb-cluster

During the installation, you are requested to provide a password for the root user on the database node.

Note

If needed, you could also install the percona-xtradb-cluster-full meta-package, which includes the following additional packages:

libperconaserverclient21
libperconaserverclient21-dev
percona-xtradb-cluster
percona-xtradb-cluster-client
percona-xtradb-cluster-common
percona-xtradb-cluster-dbg
percona-xtradb-cluster-full
percona-xtradb-cluster-garbd
percona-xtradb-cluster-garbd-debug
percona-xtradb-cluster-server
percona-xtradb-cluster-server-debug
percona-xtradb-cluster-source
percona-xtradb-cluster-test

Next steps¶

After you install Percona XtraDB Cluster and stop the mysql service, configure the node according to the procedure described in Configuring Nodes for Write-Set Replication.

Last update: 2025-02-06