Compile and install from Source Code¶

If you want to compile Percona XtraDB Cluster, you can find the source code on GitHub. Before you begin, make sure that the following packages are installed:

	apt	yum
Git	`git`	`git`
SCons	`scons`	`scons`
GCC	`gcc`	`gcc`
g++	`g++`	`gcc-c++`
OpenSSL	`openssl`	`openssl`
Check	`check`	`check`
CMake	`cmake`	`cmake`
Bison	`bison`	`bison`
Boost	`libboost-all-dev`	`boost-devel`
Asio	`libasio-dev`	`asio-devel`
Async I/O	`libaio-dev`	`libaio-devel`
ncurses	`libncurses5-dev`	`ncurses-devel`
Readline	`libreadline-dev`	`readline-devel`
PAM	`libpam-dev`	`pam-devel`
socat	`socat`	`socat`
curl	`libcurl-dev`	`libcurl-devel`

You will likely have all or most of the packages already installed. If you are not sure, run one of the following commands to install any missing dependencies:

For Debian or Ubuntu:

$ sudo apt install -y git scons gcc g++ openssl check cmake bison \
libboost-all-dev libasio-dev libaio-dev libncurses5-dev libreadline-dev \
libpam-dev socat libcurl-dev

For Red Hat Enterprise Linux or CentOS:

$ sudo yum install -y git scons gcc gcc-c++ openssl check cmake bison \
boost-devel asio-devel libaio-devel ncurses-devel readline-devel pam-devel \
socat libcurl-devel

To compile Percona XtraDB Cluster from source code:

Clone the Percona XtraDB Cluster repository:
```
$ git clone https://github.com/percona/percona-xtradb-cluster.git
```
Important

Clone the latest repository or update it to the latest state. Old codebase may not be compatible with the build script.

Check out the 8.4 branch and initialize submodules:

$ cd percona-xtradb-cluster
$ git checkout 8.4
$ git submodule update --init --recursive

Download the matching Percona XtraBackup 8.4 tarball (*.tar.gz) for your operating system from Percona Downloads.

The following example extract the Percona XtraBackup 8.0.32-25 tar.gz file to the target directory ./pxc-build:

```{.bash data-prompt="$"}
$ tar -xvf percona-xtrabackup-8.0.32-25-Linux-x86_64.glibc2.17.tar.gz -C ./pxc-build
```

Run the build script ./build-ps/build-binary.sh. By default, it attempts building into the current directory. Specify the target output directory, such as ./pxc-build:
```
$ mkdir ./pxc-build
$ ./build-ps/build-binary.sh ./pxc-build
```

When the compilation completes, pxc-build contains a tarball, such as Percona-XtraDB-Cluster-8.0.x86_64.tar.gz, that you can deploy on your system.

Note

The exact version and release numbers may differ.

Get expert help¶

If you need assistance, visit the community forum for comprehensive and free database knowledge, or contact our Percona Database Experts for professional support and services.

Community Forum Get a Percona Expert

Last update: 2024-01-18