非同期レプリケーションで冗長化しているつもりでも、プライマリが落ちると切り替えに手間がかかることがあります。
この記事では、MariaDB Galera Clusterを使って3ノードのマルチマスター同期レプリケーションをLinuxサーバーに構築する手順を解説します。想定環境はRocky Linux 9系、MariaDB 10.11 LTSです。
インストールからmy.cnfの設定・クラスター初期化・状態確認・トラブル対処まで、順を追って説明します。
この記事のポイント
・Galera Clusterは全ノードにリアルタイム同期書き込みするマルチマスター構成
・my.cnfのwsrep設定とgalera_new_clusterコマンドがセットアップの核心
・最初の1台はgalera_new_clusterで初期化、残りはsystemctl startで参加できる
・SHOW STATUS LIKE 'wsrep%'でクラスターサイズや同期状態を確認できる
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
MariaDB Galera Clusterとは何か
MariaDB Galera ClusterはMariaDB社が提供するマルチマスター同期レプリケーション技術です。通常の非同期レプリケーション(1台のプライマリ → 複数のレプリカへ遅延あり転送)とは異なり、すべてのノードが同等の書き込み権限を持ち、コミット前に全ノードへ同期して書き込みます。
主な特徴は次のとおりです。
・全ノードへのリアルタイム同期書き込み(書き込み後のデータのずれがない)
・任意のノードへの読み書きが可能(プライマリとレプリカの区別がない)
・ノード障害時の自動切り離し(Quorumを維持できる場合)
・SST(State Snapshot Transfer)による新規ノードのデータ自動同期
Quorum(多数決)の仕組み上、ノード数は3台以上の奇数が推奨です。
2台構成だと片方が落ちたとき、残った1台がQuorumを判断できず停止します。
構成の前提と事前準備
1. ノード構成とIPアドレス
この記事では次の3台構成を想定します。・node1: 192.168.1.101
・node2: 192.168.1.102
・node3: 192.168.1.103
3台それぞれで同じ手順を実施します(wsrep_node_addressとwsrep_node_nameのみノードごとに異なります)。
2. ファイアウォールのポート開放
Galeraは次の4つのポートを使います。| ポート | プロトコル | 用途 |
|---|---|---|
| 3306 | TCP | MariaDBクライアント接続 |
| 4567 | TCP/UDP | Galeraレプリケーション通信 |
| 4568 | TCP | IST(増分状態転送) |
| 4444 | TCP | SST(スナップショット状態転送) |
3台それぞれで次のコマンドを実行します。
# Galeraに必要なポートを開放する firewall-cmd --permanent --add-port=3306/tcp firewall-cmd --permanent --add-port=4567/tcp firewall-cmd --permanent --add-port=4567/udp firewall-cmd --permanent --add-port=4568/tcp firewall-cmd --permanent --add-port=4444/tcp firewall-cmd --reload # 設定を確認する(出力例。環境により異なります) firewall-cmd --list-ports # 3306/tcp 4444/tcp 4567/tcp 4567/udp 4568/tcp
3. hostsファイルの設定
/etc/hostsに3台のエントリを追加します(DNS解決できる環境では不要です)。# /etc/hostsに追記する(3台共通) 192.168.1.101 node1 192.168.1.102 node2 192.168.1.103 node3
MariaDBとGaleraのインストール(3台共通)
1. MariaDBリポジトリの追加
MariaDB公式リポジトリをセットアップします。# MariaDBリポジトリセットアップスクリプトをダウンロードして実行する curl -LsS https://r.mariadb.com/downloads/mariadb_repo_setup \ | bash -s -- --mariadb-server-version="mariadb-10.11"
2. パッケージのインストール
mariadb-serverとgalera-4、mariadb-backupをインストールします。mariadb-backupはSST(スナップショット状態転送)で使うツールで、Galera設定とセットで入れます。
dnf install -y mariadb-server galera-4 mariadb-backup # バージョンを確認する(出力例。環境により異なります) mariadbd --version # mariadbd Ver 10.11.x MariaDB ... galera_new_cluster --version # galera_new_cluster 10.11.x ...
my.cnfにGalera設定を追加する
Galera専用の設定ファイルを作成します。/etc/my.cnf.d/galera.cnfを新規作成し、各ノードに合わせた設定を記述します。主要な設定項目は次のとおりです。
| 設定項目 | 説明 |
|---|---|
| wsrep_on | Galeraレプリケーションを有効化 |
| wsrep_provider | Galeraライブラリ(libgalera_smm.so)のパス |
| wsrep_cluster_name | クラスターの名前(全ノードで統一) |
| wsrep_cluster_address | 全ノードのIPアドレスリスト |
| wsrep_node_address | このノード自身のIPアドレス |
| wsrep_node_name | このノードの名前(ログで識別するための任意文字列) |
| wsrep_sst_method | SST方式(mariabackupを推奨) |
node1の/etc/my.cnf.d/galera.cnfを作成します(node2・node3はwsrep_node_addressとwsrep_node_nameを変更します)。
# /etc/my.cnf.d/galera.cnf(node1用) [mysqld] # バイナリログを有効化する(Galeraとの整合性のため) log_bin binlog_format=ROW # Galeraレプリケーション設定 wsrep_on=ON wsrep_provider=/usr/lib64/galera-4/libgalera_smm.so # クラスター共通設定(3台共通で同じ値にする) wsrep_cluster_name="my_galera_cluster" wsrep_cluster_address="gcomm://192.168.1.101,192.168.1.102,192.168.1.103" # このノード固有の設定(ノードごとに変更する) wsrep_node_address="192.168.1.101" wsrep_node_name="node1" # SST設定(mariabackupを使う) wsrep_sst_method=mariabackup
node3では wsrep_node_address="192.168.1.103"・wsrep_node_name="node3" に変更します。
SSTにmariabackupを使う場合、SST用のMariaDBユーザーが必要です。
クラスター初期化後にnode1で次を実行して作成します(後述のh3「SSTユーザーの作成」で説明します)。
最初のノードでクラスターを初期化する
node1でクラスターを起動します。最初のノードは通常のsystemctl startではなく、galera_new_clusterコマンドを使います。このコマンドはwsrep_cluster_addressを「gcomm://」(空アドレス)として扱い、既存クラスターへの参加を試みずに新しいクラスターを初期化します。
# node1でクラスターを初期化する galera_new_cluster # 起動状態を確認する(出力例。環境により異なります) systemctl status mariadb # Active: active (running) ...
# MariaDBに接続してクラスターサイズを確認する mariadb -u root -p -- ノード数を確認する(出力例) SHOW STATUS LIKE 'wsrep_cluster_size'; -- +--------------------+-------+ -- | Variable_name | Value | -- +--------------------+-------+ -- | wsrep_cluster_size | 1 | -- +--------------------+-------+
SSTユーザーの作成
node2・node3が参加するときにSSTでデータを転送します。その際に使うMariaDBユーザーを作成します。-- node1のMariaDBで実行する -- SSTユーザーを作成する(パスワードは実環境に合わせて変更する) CREATE USER 'sst_user'@'localhost' IDENTIFIED BY 'StrongPass123!'; GRANT RELOAD, PROCESS, LOCK TABLES, REPLICATION CLIENT ON *.* TO 'sst_user'@'localhost'; FLUSH PRIVILEGES;
# /etc/my.cnf.d/galera.cnfに追記する(3台共通) [sst] user=sst_user password=StrongPass123!
残り2台をクラスターに参加させる
node2とnode3で、通常のsystemctl startを実行します。# node2・node3で実行する systemctl start mariadb systemctl enable mariadb
node2で起動後、node1からwsrep_cluster_sizeを確認すると2に増えているはずです。
node3も同様に起動すればwsrep_cluster_sizeが3になります。
データが多い本番環境でSSTを実施するときは、転送完了まで時間がかかることがあります。
journalctl -u mariadbでログを追いながら完了を待ってください。
# node2参加中のログを確認する journalctl -u mariadb -f # SSTが完了すると次のようなメッセージが出ます(出力例。環境により異なります) # ... SST complete, seqno: 5 ... # ... Synchronized with group, ready for connections ...
クラスターの状態を確認する
クラスター状態の確認にはSHOW STATUS LIKE 'wsrep%'を使います。任意のノードで実行できます。
-- クラスター全体の状態を確認する(出力例。環境により異なります) SHOW STATUS LIKE 'wsrep%'; -- +--------------------------+-------------------+ -- | Variable_name | Value | -- +--------------------------+-------------------+ -- | wsrep_cluster_size | 3 | -- | wsrep_local_state_comment | Synced | -- | wsrep_connected | ON | -- | wsrep_ready | ON | -- | wsrep_flow_control_paused | 0.000000 | -- +--------------------------+-------------------+ -- (抜粋。実際はより多くの変数が表示されます)
| 変数名 | 正常な値 | 意味 |
|---|---|---|
| wsrep_cluster_size | 3 | クラスターに参加しているノード数 |
| wsrep_local_state_comment | Synced | このノードの状態(同期完了) |
| wsrep_connected | ON | Galeraネットワークへの接続状態 |
| wsrep_ready | ON | 書き込みリクエストを受け付けられる状態 |
| wsrep_flow_control_paused | 0に近い値 | フロー制御で書き込みが止まっていた割合 |
wsrep_flow_control_pausedが継続して高い値を示す場合、ノード間のレプリケーションが追いついていないサインです。
ネットワーク帯域やディスクI/Oの確認が必要です。
Linuxサーバーの運用スキルを体系的に身につけたい方は、【初心者向けLinuxセミナー(2日間ハンズオン)】もあわせてご参照ください。
Galera Clusterのトラブル対処
1. ノードがクラスターに参加できない
systemctl start mariadbが失敗するときは、journalctlでログを確認します。journalctl -u mariadb --no-pager | tail -50
・wsrep_cluster_addressに記載したIPへの疎通がない(ファイアウォール・ポート確認)
・wsrep_node_addressにこのノードのIPが設定されていない(galera.cnfの設定確認)
・クラスター内に稼働ノードがない(先にgalera_new_clusterで初期化する)
まずpingとtelnetで各ポートへの疎通を確認します。
# node2からnode1の4567ポートへの疎通を確認する # -zオプションで実際に接続せずポートの開放を確認する nc -zv 192.168.1.101 4567 # Connection to 192.168.1.101 4567 port [tcp/*] succeeded! ← 開いている
2. 全ノード停止後のQuorum復旧
電源断などで3台すべてが同時に停止した場合、再起動後にどのノードもQuorumを得られずに停止することがあります。最後まで稼働していたノードのデータが最新なので、そのノードでgalera_new_clusterを実行してクラスターを再初期化します。
最後に停止したノードを特定するには、各ノードの/var/lib/mysql/grastate.datファイルのseqnoを比較します。
# 各ノードでgrastate.datを確認する(出力例。環境により異なります) cat /var/lib/mysql/grastate.dat # # GALERA saved state # version: 2.1 # uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx # seqno: 42 # safe_to_bootstrap: 1
safe_to_bootstrapが0の場合は、一時的に1に変更してから実行します。
# safe_to_bootstrapが0の場合は一時的に1に変更する # (必ず最もseqnoが大きいノードで実施する) sed -i 's/safe_to_bootstrap: 0/safe_to_bootstrap: 1/' /var/lib/mysql/grastate.dat # クラスターを再初期化する galera_new_cluster
3. SSTが失敗する
SSTはmariabackupが実行されます。mariadb-backupパッケージが入っていない、またはSSTユーザーの権限が不足している場合に失敗します。# mariadb-backupパッケージがインストールされているか確認する rpm -q mariadb-backup # mariadb-backup-10.11.x-... ← インストール済みなら表示される # インストールされていなければ追加する dnf install -y mariadb-backup
-- node1のMariaDBで実行する(出力例。環境により異なります) SHOW GRANTS FOR 'sst_user'@'localhost'; -- GRANT RELOAD, PROCESS, LOCK TABLES, REPLICATION CLIENT ON *.* TO 'sst_user'@'localhost'
本記事のまとめ
| 手順 | コマンド・設定 |
|---|---|
| ポート開放(3台共通) | firewall-cmd --permanent --add-port=4567/tcp ほか4ポート |
| パッケージインストール(3台共通) | dnf install mariadb-server galera-4 mariadb-backup |
| Galera設定(ノードごと) | /etc/my.cnf.d/galera.cnfを作成・wsrep設定を記述 |
| クラスター初期化(node1のみ) | galera_new_cluster |
| 残りノードの参加 | systemctl start mariadb |
| 状態確認 | SHOW STATUS LIKE 'wsrep%' |
| 全停止後の復旧 | grastate.datのseqnoを比較 → galera_new_cluster |
MariaDB Galera Clusterを構築すると、1台が落ちてもデータベースを止めることなく運用を続けられます。
まず検証環境で3台構成を試し、wsrep_cluster_sizeが3になることとノード停止・復帰の動作を確認してから本番への適用を検討してください。
>>【初心者向けLinuxセミナー(2日間ハンズオン)】
3,100名以上が実践した「型」を無料で公開中
プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら
- 前のページへ:MySQLのタイムゾーン(time_zone)をAsia/Tokyoに設定する手順|my.cnfの永続設定とタイムゾーンテーブルのロードまで
- この記事の属するカテゴリ:データーベース管理へ戻る

無料メルマガで学習を続ける
Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。
登録無料・いつでも解除できます