There are binary installation packages available for RPM and Debian-based distributions, which will pull in all required Galera dependencies.
If these are not available, you will need to build Galera from source, as follows:
make cannot manage dependencies for Galera or the build process, so the following packages need to be installed first:
apt-get build-dep mariadb-server # for Galera: apt-get install -y scons check
If running on an alternative system, or the commands are available, the following packages are required. You will need to check the repositories for the correct package names on your distribution - these may differ between distributions, or require additional packages:
From MariaDB 10.1, the wsrep API for Galera Cluster is included by default. You can use Git to download the source code, as MariaDB source code is available through GitHub. Clone the repository:
git clone https://github.com/mariadb/server mariadb
cd mariadb git checkout 10.4
cd .. git clone -b mariadb-4.x https://github.com/MariaDB/galera.git
If you are using MariaDB 10.3 or earlier, you should checkout
After this, the source files for the database server will be in the
/server directory, and for Galera in the
Newer MariaDB servers include Galera by default. To build the database server, cd into the server/ directory and run the following commands:
cmake . make make install
The standard and Galera cluster database servers are the same, except that for Galera Cluster, the wsrep API patch is included. Enable the patch with the CMake configuration options
WITH_INNODB_DISALLOW_WRITES. To build the database server, cd into the server/ directory and run the following commands:
cmake -DWITH_WSREP=ON -DWITH_INNODB_DISALLOW_WRITES=ON ./ make make install
There are also some build scripts in the BUILD/ directory which may be more convenient to use. For example, the following pre-configures the build options discussed above:
There are several others as well, so you can select the most convenient.
The Galera Replication Plugin both implements the wsrep API and operates as the database server's wsrep Provider. To build, cd into the galera/ directory and do:
git submodule init git submodule update ./scripts/build.sh mkdir /usr/lib64/galera## cp libgalera_smm.so /usr/lib64/galera
The path to
libgalera_smm.so needs to be defined in the my.cnf configuration file.
Building Galera Replication Plugin from source on FreeBSD runs into issues due to Linux dependencies. To overcome these, either install the binary package:
pkg install galera, or use the ports build available at
After building, a number of other steps are necessary:
groupadd mysql useradd -g mysql mysql
cd /usr/local/mysql ./scripts/mysql_install_db --user=mysql
chown -R mysql /usr/local/mysql chgrp -R mysql /usr/local/mysql
cp /usr/local/mysql/supported-files/mysql.server /etc/init.d/mysql chmod +x /etc/init.d/mysql chkconfig --add mysql
© 2019 MariaDB
Licensed under the Creative Commons Attribution 3.0 Unported License and the GNU Free Documentation License.