Installing Percona XtraDB Cluster from Binaries

Ready-to-use binaries are available from the Percona XtraDB Cluster download page, including:

  • RPM packages for RHEL 5 and RHEL 6
  • Debian packages
  • Generic .tar.gz packages

Using Percona Software Repositories

Percona provides repositories for yum (RPM packages for Red Hat, CentOS and Amazon Linux AMI) and apt (.deb packages for Ubuntu and Debian) for software such as Percona Server, XtraDB, XtraBackup, and Percona Toolkit. This makes it easy to install and update your software and its dependencies through your operating system’s package manager.

This is the recommend way of installing where possible.

YUM-Based Systems

Once the repository is set up, use the following commands:

$ yum install Percona-XtraDB-Cluster-55

More detailed example of the Percona XtraDB Cluster installation and configuration can be seen in Installing Percona XtraDB Cluster on CentOS tutorial.

DEB-Based Systems

Once the repository is set up, use the following commands:

$ sudo apt-get install percona-xtradb-cluster-55

Note

For Ubuntu 14.04 (Trusty) percona-xtradb-cluster-galera-2.x will have to be specified with the meta package so the installation command should look like:

$ sudo apt-get install percona-xtradb-cluster-55 percona-xtradb-cluster-galera-2.x

More detailed example of the Percona XtraDB Cluster installation and configuration can be seen in Installing Percona XtraDB Cluster on Ubuntu tutorial.

Prerequisites

In order for Percona XtraDB Cluster to work correctly firewall has to be set up to allow connections on the following ports: 3306, 4444, 4567 and 4568. Percona XtraDB Cluster currently doesn’t work with SELinux or apparmor so they should be disabled, otherwise individual nodes won’t be able to communicate and form the cluster.

Initial configuration

In order to start using the Percona XtraDB Cluster, following options are needed in the MySQL configuration file my.cnf:

[mysqld]

wsrep_provider — a path to Galera library.
wsrep_cluster_address — Cluster connection URL containing the IPs of other nodes in the cluster
wsrep_sst_method - method used for the state snapshot transfer

binlog_format=ROW - In order for Galera to work correctly binlog format should be ROW
default_storage_engine=InnoDB - MyISAM storage engine has only experimental support
innodb_autoinc_lock_mode=2 - This changes how InnoDB autoincrement locks are managed

Additional parameters to specify:

wsrep_sst_auth=user:password

If any other State Snapshot Transfer method beside the rsync is specified in the wsrep_sst_method, credentials for SST need to be specified.

Example:

wsrep_provider=/usr/lib64/libgalera_smm.so
wsrep_cluster_address=gcomm://10.11.12.206
wsrep_slave_threads=8
wsrep_sst_method=rsync
binlog_format=ROW
default_storage_engine=InnoDB
innodb_autoinc_lock_mode=2

Detailed list of variables can be found in Index of wsrep system variables and Index of wsrep status variables.

Percona XtraDB Cluster
Call Us
+1-888-316-9775 (USA - Sales)
+1-208-473-2904 (USA - Sales)
+44-208-133-0309 (UK - Sales)
0-800-051-8984 (UK - Sales)
0-800-181-0665 (GER - Sales)
+1-877-862-4316 (Emergency)
+1-855-55TRAIN (Training)
+1-925-271-5054 (Training)

Table Of Contents

Previous topic

Percona XtraDB Cluster Errata (as of 5.5.34)

Next topic

Percona yum Repository

This Page



© Copyright 2012-2014, Percona LLC and/or its affiliates.
Except where otherwise noted, this documentation is licensed under the following license:
CC Attribution-ShareAlike 2.0 Generic
Created using Sphinx 1.2.2.
This documentation is developed in Launchpad as part of the Percona XtraDB Cluster 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.
]]>