MariaDB Galera Clusterでマルチマスターレプリケーションを構築する手順|3ノード同期構成のインストールから状態確認まで

運営:リナックスマスター.JP(代表 宮崎智広)
HOME > Linux技術 リナックスマスター.JP(Linuxマスター.JP) > Linuxtips > データーベース管理 > MariaDB Galera Clusterでマルチマスターレプリケーションを構築する手順|3ノード同期構成のインストールから状態確認まで
データベースサーバーが1台止まるたびにシステムが停止する、という状況に悩んでいませんか。
非同期レプリケーションで冗長化しているつもりでも、プライマリが落ちると切り替えに手間がかかることがあります。

この記事では、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%'でクラスターサイズや同期状態を確認できる


「このままじゃマズい」と感じていませんか?
参考書を開く気力もない、同年代に取り残される不安——
でも安心してください。プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

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

node2では wsrep_node_address="192.168.1.102"・wsrep_node_name="node2"、
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に接続してクラスターサイズを確認する mariadb -u root -p -- ノード数を確認する(出力例) SHOW STATUS LIKE 'wsrep_cluster_size'; -- +--------------------+-------+ -- | Variable_name | Value | -- +--------------------+-------+ -- | wsrep_cluster_size | 1 | -- +--------------------+-------+

wsrep_cluster_sizeが1なら、node1単体でクラスターが起動した状態です。

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台共通)。

# /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

起動すると、SSTによりnode1からデータが転送されます。
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

よくある原因は次の3点です。

・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が1のノード、またはseqnoが最も大きいノードでgalera_new_clusterを実行します。
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

再初期化が完了したら、残り2台で通常のsystemctl startを実行します。

3. SSTが失敗する

SSTはmariabackupが実行されます。mariadb-backupパッケージが入っていない、またはSSTユーザーの権限が不足している場合に失敗します。

# mariadb-backupパッケージがインストールされているか確認する rpm -q mariadb-backup # mariadb-backup-10.11.x-... ← インストール済みなら表示される # インストールされていなければ追加する dnf install -y mariadb-backup

SSTユーザーの権限は次のコマンドで確認します(RELOAD・PROCESS・LOCK TABLES・REPLICATION CLIENTが必要です)。

-- 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サーバー構築の「型」を体系的に身につけたい方へ、
>>【初心者向けLinuxセミナー(2日間ハンズオン)】

無料メルマガで学習を続ける

Linuxの実践スキルをメールで毎週お届け。
登録は30秒、解除もいつでも可。

登録無料・いつでも解除できます

暗記不要・1時間後にはサーバーが動く

3,100名以上が実践した「型」を無料で公開中

プロのエンジニアはコマンドを暗記していません。
「現場で使える型」を効率よく使いこなしているだけです。
その「型」を図解60Pにまとめた入門マニュアルを、完全無料でプレゼントしています。

姓・名・メールの3つだけ/30秒/解除は3秒 / 詳細はこちら

Linux無料マニュアル(図解60P) 名前とメールで30秒登録

運営

リナックスマスター.JP(代表 宮崎智広)

株式会社イーネットマーキュリーが運営するLinux教育サイトです。代表の宮崎智広は現役のLinuxサーバー管理者として20年以上の実務経験を持ち、累計3,100名以上のエンジニアを指導してきました。実践型のLinuxセミナーや無料マニュアルの配布を通じてLinux人材の育成に取り組んでいます。