Support #337
Updated by Daniel Curtis about 10 years ago
Here’s the steps (down to the commands to run as root) to install and configure the MariaDB Galera Clustered Database server software on Debian 7 running across a 3 Node Cluster (3 nodes to increase DB consistency, response time & reduce split-brain occurrences of full DB re-syncs). Also note that currently (in MariaDB 5.5 at least) the MariaDB Galera Cluster only supports the InnoDB/XtraDB storage engine, so ensure that your Databases to be Clustered are InnoDB based for DB type. Some Linux or system level requirements or pre-install setup tasks are: * 1) Ensure the /etc/hosts files are the same on each Node and that it contains entries for each DB Node’s IP addresses and hostname (both the node hostname and its fully qualified hostname). <pre> vi /etc/hosts </pre> > 192.168.0.1 db1 db1.example.com node1 node1.example.com > 192.168.0.2 db2 db2.example.com node2 node2.example.com > 192.168.0.3 db3 db3.example.com node3 node3.example.com * 2) Ensure that each Node’s Firewall permits each other node host IP addresses access to ports 4444 and 4567 and the standard MySQL port of 3306. h2. Install the MariaDB Galera on node 1: each node: * Install prerequisite Debian Packages: <pre> apt-get -y install perl python-software-properties rsync </pre> * Setup the MariaDB 5.5 Repository: <pre> apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xcbcb082a1bb943db add-apt-repository 'deb http://ftp.osuosl.org/pub/mariadb/repo/5.5/debian wheezy main' </pre> * Install MariaDB Galera: <pre> apt-get install mariadb-galera-server galera </pre> * Ensure that there’s no “Empty” MySQL Users: <pre> mysql -p -e "SET wsrep_on = OFF; DELETE FROM mysql.user WHERE user = '';" </pre> Once all 3 Nodes have the above software installed and the initial MySQL settings applied, bring them all up and online (mysql running with the default Debian settings on each node is ok at this point). Install the relevant Database content to the “first” Node, which we’ll call “Node1″ or reference as “node1″, this may well involve using and knowing the MySQL ‘root’ username and its password. * After that and on Node 1, restart its MySQL software as the initiating node of a Galera Cluster by loading the following configuration file(s) and restarting Node1′s MySQL server software, similar to the following: <pre> vi /etc/mysql/conf.d/cluster.cnf </pre> #* And add > [server] > bind_address = 0.0.0.0 > > [mysqld] > #!# > #!# gcomm:// only for initial start of first Node > #!# After that it should list each Node's IP as it's joined to the following: Cluster, ending up with: <pre> > #!#wsrep_cluster_address = 'gcomm://192.168.0.2,192.168.0.3' [mysqld] > > wsrep_cluster_address = 'gcomm://' > > wsrep_provider = /usr/lib/galera/libgalera_smm.so > #!#wsrep_retry_autocommit = 0 > wsrep_sst_method = rsync > binlog_format=ROW default-storage-engine=innodb > query_cache_size=0 > default_storage_engine=InnoDB > innodb_autoinc_lock_mode=2 bind-address=0.0.0.0 # Galera Provider Configuration > innodb_locks_unsafe_for_binlog=1 wsrep_provider=/usr/lib/galera/libgalera_smm.so > > #! optional additional suggested settings: #wsrep_provider_options="gcache.size=32G" # Galera Cluster Configuration > #!#innodb_buffer_pool_size=28G wsrep_cluster_name="alt_cluster" > #!#innodb_log_file_size=100M wsrep_cluster_address="gcomm://192.168.0.1,192.168.0.2,192.168.0.3" # Galera Synchronization Congifuration > #!#innodb_file_per_table wsrep_sst_method=rsync > #!#innodb_flush_log_at_trx_commit=2 #wsrep_sst_auth=user:pass # Galera Node Configuration > > [mysqld_safe] wsrep_node_address="192.168.0.1" wsrep_node_name="db1.example.com" </pre> > log-error=/var/log/mysql/mysqld_safe.log * Restart the MySQL Server on Node 1 with the above /etc/mysql/conf.d/cluster.cnf file installed: <pre> service mysql stop restart service mysql start --wsrep-new-cluster </pre> * Check how MySQL Galera Cluster servers is going after restart with: <pre> tail -n 20 /var/log/mysql/mysqld_safe.log </pre> * Check how the MariaDB Galera Server is running as a Cluster with the local mysql client command: <pre> mysql -uroot -p -e "SHOW STATUS LIKE 'wsrep_%';" </pre> You should see output like: <pre> +----------------------------+--------------------------------------+ | Variable_name | Value | +----------------------------+--------------------------------------+ | wsrep_local_state_uuid | cafebeef-0123-1234-9876-5ebcdef01234 | | wsrep_protocol_version | 4 | | wsrep_last_committed | 1 | | wsrep_replicated | 0 | | wsrep_replicated_bytes | 0 | | wsrep_received | 2 | | wsrep_received_bytes | 232 | | wsrep_local_commits | 0 | | wsrep_local_cert_failures | 0 | | wsrep_local_bf_aborts | 0 | | wsrep_local_replays | 0 | | wsrep_local_send_queue | 0 | | wsrep_local_send_queue_avg | 0.500000 | | wsrep_local_recv_queue | 0 | | wsrep_local_recv_queue_avg | 0.000000 | | wsrep_flow_control_paused | 0.000000 | | wsrep_flow_control_sent | 0 | | wsrep_flow_control_recv | 0 | | wsrep_cert_deps_distance | 0.000000 | | wsrep_apply_oooe | 0.000000 | | wsrep_apply_oool | 0.000000 | | wsrep_apply_window | 0.000000 | | wsrep_commit_oooe | 0.000000 | | wsrep_commit_oool | 0.000000 | | wsrep_commit_window | 0.000000 | | wsrep_local_state | 4 | | wsrep_local_state_comment | Synced | | wsrep_cert_index_size | 0 | | wsrep_causal_reads | 0 | | wsrep_incoming_addresses | 192.168.0.1:3306 | | wsrep_cluster_conf_id | 4 | | wsrep_cluster_size | 1 | | wsrep_cluster_state_uuid | cafebeef-0123-1234-9876-5ebcdef01234 | | wsrep_cluster_status | Primary | | wsrep_connected | ON | | wsrep_local_index | 1 | | wsrep_provider_name | Galera | | wsrep_provider_vendor | Codership Oy | | wsrep_provider_version | 23.2.7-wheezy(r) | | wsrep_ready | ON | +----------------------------+--------------------------------------+ </pre> h2. Configure node 2 * Install prerequisite Debian Packages: <pre> apt-get -y install perl python-software-properties rsync </pre> * Setup the MariaDB 5.5 Repository: <pre> apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xcbcb082a1bb943db add-apt-repository 'deb http://ftp.osuosl.org/pub/mariadb/repo/5.5/debian wheezy main' </pre> * Install MariaDB Galera: <pre> apt-get install mariadb-galera-server galera </pre> * Ensure that there’s no “Empty” MySQL Users: <pre> mysql -p -e "SET wsrep_on = OFF; DELETE FROM mysql.user WHERE user = '';" </pre> With Node 1 now running a single-node Galera Cluster, you can configure and start Nodes 2 and 3 with these following commands done and verified on Node 2 and then Node 3: * Load MariaDB Cluster config file, listing Node 1′s IP address as the initial ‘gcomm’ Cluster server, on Node 2 do: <pre> vi /etc/mysql/conf.d/cluster.cnf </pre> And add the following: > [server] <pre> > bind_address = 0.0.0.0 > > [mysqld] > > #!# gcomm:// only for initial start of first Node > #!# After that it should list each Node's IP as it's joined to the Cluster, ending up with: > #!# wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.3' (for Node 2) and > #!# wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.2' (for Node 3) once all nodes are in the Cluster. > > wsrep_cluster_address = 'gcomm://192.168.0.1' > > wsrep_provider = /usr/lib/galera/libgalera_smm.so > ##wsrep_retry_autocommit = 0 > wsrep_sst_method = rsync > binlog_format=ROW default-storage-engine=innodb > query_cache_size=0 > default_storage_engine=InnoDB > innodb_autoinc_lock_mode=2 bind-address=0.0.0.0 # Galera Provider Configuration > innodb_locks_unsafe_for_binlog=1 wsrep_provider=/usr/lib/galera/libgalera_smm.so > > #! optional additional suggested settings: #wsrep_provider_options="gcache.size=32G" # Galera Cluster Configuration > #!#innodb_buffer_pool_size=28G wsrep_cluster_name="alt_cluster" > #1#innodb_log_file_size=100M wsrep_cluster_address="gcomm://192.168.0.1,192.168.0.2,192.168.0.3" # Galera Synchronization Congifuration > #!#innodb_file_per_table wsrep_sst_method=rsync > #!#innodb_flush_log_at_trx_commit=2 #wsrep_sst_auth=user:pass # Galera Node Configuration > > [mysqld_safe] wsrep_node_address="192.168.0.1" wsrep_node_name="db1.example.com" </pre> > log-error=/var/log/mysql/mysqld_safe.log * Restart the MySQL Server on Node 2 with the above @/etc/mysql/conf.d/cluster.cnf@ file installed: <pre> service mysql restart </pre> * Check how MySQL Galera Cluster servers is going after restart with: Note: Any UUID numbers are replaced with ‘…’ in the following output <pre> cat /var/log/mysql/mysqld_safe.log </pre> You should see log file entries about each node joining and being syncronised into the Galera MySQL Cluster on Node 1, entries like: > [Note] WSREP: declaring ... stable > [Note] WSREP: Node ... state prim > [Note] WSREP: (..., 'tcp://0.0.0.0:4567') turning message relay requesting on, nonlive peers: tcp://192.168.0.3:4567 > [Note] WSREP: view(view_id(PRIM,...,11) memb { > ..., > ..., > } joined { > } left { > } partitioned { > ..., > }) > [Note] WSREP: New COMPONENT: primary = yes, bootstrap = no, my_idx = 1, memb_num = 2 > [Note] WSREP: STATE EXCHANGE: Waiting for state UUID. > [Note] WSREP: forgetting ... (tcp://192.168.0.3:4567) > [Note] WSREP: (..., 'tcp://0.0.0.0:4567') turning message relay requesting off > [Note] WSREP: STATE EXCHANGE: sent state msg: ... > [Note] WSREP: STATE EXCHANGE: got state msg: ... from 0 (node1.domain.name) > [Note] WSREP: STATE EXCHANGE: got state msg: ... from 1 (node2.domain.name) > [Note] WSREP: Quorum results: > version = 2, > component = PRIMARY, > conf_id = 8, > members = 2/2 (joined/total), > act_id = 162, > last_appl. = 0, > protocols = 0/4/2 (gcs/repl/appl), > group UUID = ... > [Note] WSREP: Flow-control interval: [23, 23] > [Note] WSREP: New cluster view: global state: ...:162, view# 9: Primary, number of nodes: 2, my index: 1, protocol version 2 > [Note] WSREP: wsrep_notify_cmd is not defined, skipping notification. > [Note] WSREP: Assign initial position for certification: 162, protocol version: 2 > 14:24:37 [Note] WSREP: cleaning up ... (tcp://192.168.0.3:4567) > [Note] WSREP: declaring ... stable > [Note] WSREP: declaring ... stable > [Note] WSREP: Node ... state prim > [Note] WSREP: view(view_id(PRIM,...,12) memb { > ..., > ..., > ..., > } joined { > } left { > } partitioned { > }) > [Note] WSREP: New COMPONENT: primary = yes, bootstrap = no, my_idx = 1, memb_num = 3 > [Note] WSREP: STATE EXCHANGE: Waiting for state UUID. > [Note] WSREP: STATE EXCHANGE: sent state msg: ... > [Note] WSREP: STATE EXCHANGE: got state msg: ... from 0 (node1.domain.name) > [Note] WSREP: STATE EXCHANGE: got state msg: ... from 1 (node2.domain.name) > [Note] WSREP: STATE EXCHANGE: got state msg: ... from 2 (node3.domain.name) > [Note] WSREP: Quorum results: > version = 2, > component = PRIMARY, > conf_id = 9, > members = 3/3 (joined/total), > act_id = 162, > last_appl. = 0, > protocols = 0/4/2 (gcs/repl/appl), > group UUID = ... > [Note] WSREP: Flow-control interval: [28, 28] > [Note] WSREP: New cluster view: global state: ...:162, view# 10: Primary, number of nodes: 3, my index: 1, protocol version 2 > [Note] WSREP: wsrep_notify_cmd is not defined, skipping notification. > [Note] WSREP: Assign initial position for certification: 162, protocol version: 2 > [Note] WSREP: Member 2 (node3.domain.name) synced with group. * Again, use the mysql client on Node 2 to query Node 2′s Galera Server. Run on Node 2: <pre> mysql -uroot -pMYSQLROOTPASSWD -e "SHOW STATUS LIKE 'wsrep_%';" </pre> With Node 1 and 2 now running a dual-node Galera Cluster, you can configure and start Node 3 with these following commands done and verified on Node 1 and then Node 2. 2: h2. Configure Node 3 * Install prerequisite Debian Packages: <pre> apt-get -y install perl python-software-properties rsync </pre> * Setup the MariaDB 5.5 Repository: <pre> apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xcbcb082a1bb943db add-apt-repository 'deb http://ftp.osuosl.org/pub/mariadb/repo/5.5/debian wheezy main' </pre> * Install MariaDB Galera: <pre> apt-get install mariadb-galera-server galera </pre> * Ensure that there’s no “Empty” MySQL Users: <pre> mysql -p -e "SET wsrep_on = OFF; DELETE FROM mysql.user WHERE user = '';" </pre> * Load MariaDB Cluster config file, listing Node 1 and 2′s IP address as the initial ‘gcomm’ Cluster server, on Node 3 do: <pre> vi /etc/mysql/conf.d/cluster.cnf </pre> And add the following: > [server] <pre> > bind_address = 0.0.0.0 > > [mysqld] > > #!# gcomm:// only for initial start of first Node > #!# After that it should list each Node's IP as it's joined to the Cluster, ending up with: > #!#wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.2' (for Node 3) once all nodes are in the Cluster. > > wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.2' > > wsrep_provider = /usr/lib/galera/libgalera_smm.so > ##wsrep_retry_autocommit = 0 > wsrep_sst_method = rsync > binlog_format=ROW default-storage-engine=innodb > query_cache_size=0 > default_storage_engine=InnoDB > innodb_autoinc_lock_mode=2 bind-address=0.0.0.0 # Galera Provider Configuration > innodb_locks_unsafe_for_binlog=1 wsrep_provider=/usr/lib/galera/libgalera_smm.so > > #! optional additional suggested settings: #wsrep_provider_options="gcache.size=32G" # Galera Cluster Configuration > #!#innodb_buffer_pool_size=28G wsrep_cluster_name="alt_cluster" > #!#innodb_log_file_size=100M wsrep_cluster_address="gcomm://192.168.0.1,192.168.0.2,192.168.0.3" # Galera Synchronization Congifuration > #!#innodb_file_per_table wsrep_sst_method=rsync > #!#innodb_flush_log_at_trx_commit=2 #wsrep_sst_auth=user:pass # Galera Node Configuration > > [mysqld_safe] wsrep_node_address="192.168.0.1" wsrep_node_name="db1.example.com" </pre> > log-error=/var/log/mysql/mysqld_safe.log * Restart the MySQL Server on Node 3 with the above @/etc/mysql/conf.d/cluster.cnf@ file installed: <pre> service mysql restart </pre> Check the @mysqld_safe.log@ logfiles on all nodes to see that Node 3 also joins and syncronises with the Cluster. At this point you have all 3 x Nodes in the Galera MySQL Cluster and you can now update Node 1 and Node 2′s cluster.cnf file to set the IP Addresses of all Nodes in the Cluster. * On Node 1, change the line in @/etc/mysql/conf.d/cluster.cnf@ that says: From: > wsrep_cluster_address = 'gcomm://' To: > wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.2,192.168.0.3' And then restart MySQL on Node 1, checking the relevant log files and mysql client command to query the Cluster membership once Node 1′s mysql server software has restarted, with: <pre> service mysql restart </pre> <pre> tail -f /var/log/mysql/mysqld_safe.log </pre> <pre> mysql -uroot -p -e "SHOW STATUS LIKE 'wsrep_%';" </pre> h2. Finalize the Galera Cluster configuration Once Node 1 has been reconfigured to know of all Cluster Members, do the same step above on Node 2 and Node 3, setting Node 2 and Node 3′s *wsrep_cluster_address* in @/etc/mysql/conf.d/cluster.cnf@ to: > wsrep_cluster_address = 'gcomm://192.168.0.1,192.168.0.2,192.168.0.3' And restarting their MySQL Servers and checking that they then each rejoin the live Cluster. Finally by now you should have a running live 3 Node MariaDB Galera MySQL Cluster, the status of which on each Node should list that there’s 3 members of the Cluster, via: <pre> mysql -uroot -pMYSQLROOTPASSWD -e "SHOW STATUS LIKE 'wsrep_%';" | egrep "wsrep_incoming_addresses|wsrep_cluster_size" </pre>