Compiling and Installing from Source Code

The source code is available from the Launchpad project here. The easiest way to get the code is with bzr branch of the desired release, such as the following:

bzr branch lp:percona-xtrabackup/2.0

You should then have a directory named after the release you branched, such as percona-xtrabackup.

Compiling on Linux

Prerequisites

The following packages and tools must be installed to compile Percona XtraBackup from source. These might vary from system to system.

In Debian-based distributions, you need to:

$ apt-get install debhelper autotools-dev libaio-dev wget automake \
  libtool bison libncurses-dev libz-dev cmake bzr

In RPM-based distributions, you need to:

$ yum install cmake gcc gcc-c++ libaio libaio-devel automake autoconf bzr \
  bison libtool ncurses-devel zlib-devel

Compiling with build.sh

Once you have all dependencies met, the compilation is straight-forward with the bundled build.sh script in the utils/ directory of the distribution.

The script needs the codebase for which the building is targeted, you must provide it with one of the following values or aliases:

Value Alias Server
innodb51_builtin 5.1 build against built-in InnoDB in MySQL 5.1
innodb51 plugin build against InnoDB plugin in MySQL 5.1
innodb55 5.5 build against InnoDB in MySQL 5.5
xtradb51 xtradb build against Percona Server with XtraDB 5.1
xtradb55 xtradb55 build against Percona Server with XtraDB 5.5
innodb56 5.6 build against InnoDB in MySQL 5.6

Note that the script must be executed from the base directory of Percona XtraBackup sources, and that directory must contain the packages with the source code of the codebase selected. This may appear cumbersome, but if the variable AUTO_LOAD="yes" is set, the build.sh script will download all the source code needed for the build.

Note

The exact versions expected by build.sh script should be used. Changing the version info in build.sh to have it build against a different server version is not supported.

At the base directory of the downloaded source code, if you execute

$ AUTO_DOWNLOAD="yes" ./utils/build.sh xtradb

In case you’re not able to use AUTO_DOWNLOAD="yes" option, sources can be downloaded manually for each release:

After the build has finished Percona XtraBackup will be ready to be used. The xtrabackup binary will be located in the percona-xtrabackup/src subdirectory.

After this you’ll need to copy innobackupex (in the root folder used to retrieve Percona XtraBackup) and the corresponding xtrabackup binary (in the src folder) to some directory listed in the PATH environment variable, e.g. /usr/bin.

© Copyright Percona LLC and/or its affiliates, 2009-2013.
Except where otherwise noted, this documentation is licensed under the following license:
CC Attribution-ShareAlike 2.0 Generic
Created using Sphinx 1.1.3.
This documentation is developed in Launchpad as part of the Percona XtraBackup source code.
If you spotted innacuracies, errors, don't understood it or you think something is missing or should be improved, please file a bug.