Gosuke Miyashita

MHA for MySQL の概要

MHA for MySQL の導入を検討していて、まずは社内の技術者向けに、MHA for MySQL の概要を伝えようと、主に オフィシャルなドキュメント からポイントを抜粋して社内向けの Wiki に書いてみた。本当なら、オフィシャルドキュメント全体に目を通してもらうのがいいんだけど、英語なので、はじめの一歩としては敷居が高く感じる人もいるだろう、ということで。

特に外に出してまずい情報があるわけでもないので、このブログでも曝しておきます。

MHA の概要

MySQL エキスパートとして世界的にも著名な松信嘉範氏による、MySQL マスターの HA 化を行うためのツール。Perl 製。

最小限のダウンタイムで、データの不整合を防ぎつつ、マスターのフェイルオーバーを行う、というのが主な機能。

また、既に動作している MySQL に影響を与えることなく導入できる。

機能は大きくわけると以下の4つ。

MHA のコンポーネントと動作概要

マスターの監視とフェイルオーバーを MHA で自動的に行う場合の構成は以下のようになる。

動作の流れは以下の通り。

動作の詳細についてはオフィシャルドキュメントの Sequences of MHA を参照。

Manager の拡張

Manager の本体である masterha_manager には拡張ポイントがいくつかあり、設定ファイル中で以下のパラメータに対してスクリプトを指定することで、動作を拡張することができる。拡張ポイントは以下の通り。

例えば、MHA 自体には、マスターがフェイルオーバーした時に VIP を付け替える機能はないが、以下のように VIP 付け替え用のスクリプトを設定ファイルで指定すると、フェイルオーバー時に VIP の付け替えをしてくれる。（スクリプトは自分で用意する。）

master_ip_failover_script=/usr/local/sample/bin/master_ip_failover

詳細は Custom Extensions を参照。

Manager の設定例

拡張スクリプトの設定など、必須ではないものも含む。

[server default]
# mysql user and password
user=root
password=mysqlpass
# working directory on the manager
manager_workdir=/var/log/masterha/app1
# manager log file
manager_log=/var/log/masterha/app1/app1.log
# working directory on MySQL servers
remote_workdir=/var/log/masterha/app1
secondary_check_script= masterha_secondary_check -s remote_host1 -s remote_host2
ping_interval=3
master_ip_failover_script=/script/masterha/master_ip_failover
shutdown_script=/script/masterha/power_manager
report_script=/script/masterha/send_master_failover_mail

[server1]
hostname=host1
candidate_master=1 # 次のマスター候補

[server2]
hostname=host2

[server3]
hostname=host3
no_master=1 # このホストはマスターにしない

以下のように設定ファイルを指定して起動する。

# masterha_manager --conf=/etc/mha.cnf

設定パラメータ一覧はオフィシャルドキュメントの Parameters を参照。

チュートリアル

オフィシャルドキュメントの Tutorial を参照。

FAQ

FAQ からいくつかピックアップ。超意訳。

よくあるエラーと対処方法

オフィシャルドキュメントの TypicalErrors を参照。

必要条件

オフィシャルドキュメントの Requirements からいくつかピックアップして超意訳。

MHA を動作させるためには、以下の設定が必要。masterha_manager や masterha_check_repl 実行時に自動的にチェックしてくれる。

その他

参考 URL