2 ノード・1 セグメント構成
2 台のサーバーと、業務と HA の通信を兼ねるネットワーク 1 本で作る最小の構成です。独立した fencing の装置が無い前提です。
- 冷起動と計画停止での引き継ぎは自動です(両ノードが接続している時)。
- 相手の喪失は自動では引き継ぎません。 運用者が相手の停止を確かめてから手動で切り替えます。ネットワークが 1 本なので、通信断と相手の停止を区別できないためです。
検証状況:共通設定と 2 ノードの切替は Linux 上の模擬試験済み(1 台の Rocky Linux 10.2 の上で network namespace を使った 2 ノード)。物理的に別の 2 台では 未検証。
| 項目 | 内容 |
|---|---|
| サーバー | 2 台(Rocky Linux 9 / 10) |
| ネットワーク | 1 本(同じ L2。gratuitous ARP が届くこと) |
| ポート | TCP 7946(node-a → node-b) |
| VIP | 未使用のアドレス 1 つ |
| ホスト | アドレス | 役割 |
|---|---|---|
| node-a | 192.168.100.11 | 優先ノード(preferred = true) |
| node-b | 192.168.100.12 | peer link を待ち受ける側(id が大きい) |
| VIP | 192.168.100.50/24 | Active の側だけに付く |
1. 両ノードの準備
Section titled “1. 両ノードの準備”dnf install ./mikagami-0.8.0-1.el10.aarch64.rpm nginxsystemctl disable --now nginx # サービスは Mikagami だけが起動するfirewall-cmd --permanent --add-port=7946/tcp && firewall-cmd --reload共有鍵(PSK)を両ノードに同じ内容で置きます。
2. 設定(両ノードで同じファイル)
Section titled “2. 設定(両ノードで同じファイル)”# /etc/mikagami/mikagami.toml — 2 ノード・1 セグメント(両ノードで同じファイル)[cluster]id = "web-1seg"topology = "two-node"
[nodes.node-a]preferred = true # 冷起動で先に Active を求める(自動で戻すことはしない)
[nodes.node-b]
[two_node]fencing_device = "none" # 独立した fencing の装置なし(相手の喪失では自動で引き継がない)
[[two_node.link]]segment = "lan"role = "combined" # 業務と HA の通信を 1 本で兼ねるport = 7946address = { node-a = "192.168.100.11", node-b = "192.168.100.12" }interface = { node-a = "eth0", node-b = "eth0" }
[vip]address = "192.168.100.50/24"interface = "eth0"
[service]manager = "systemd"unit = "nginx.service"
[health]command = ["/usr/libexec/mikagami/check-http", "http://127.0.0.1/", "--timeout", "2"]timeout_sec = 5
[security]psk_file = "/etc/mikagami/cluster.psk"chmod 600 /etc/mikagami/mikagami.toml にします。ノードごとに違うのは、次の登録だけです。
# node-a でmikagami node register --config /etc/mikagami/mikagami.toml --node-id node-a# node-b でmikagami node register --config /etc/mikagami/mikagami.toml --node-id node-b# 両ノードでmikagami node show --config /etc/mikagami/mikagami.tomlmikagami two-node init --config /etc/mikagami/mikagami.tomlnode show の configuration summary が 2 台で同じであることを確かめます。違えば 2 台は接続しません。
3. VIP
Section titled “3. VIP”[vip] addressは CIDR(例192.168.100.50/24)、interfaceは付ける NIC です。- Active になる時、サービスより先に VIP を付け、ヘルスチェックが成功してから gratuitous ARP で公開します。停止の時はサービスを止めてから VIP を外します。
- VIP を手で付けたり、他の仕組みで管理したりしないでください。
4. 起動・停止
Section titled “4. 起動・停止”systemctl enable --now mikagami # 両ノードで起動直後は両ノードとも Standby です。両ノードが接続し、資源を持たない状態が続くと、node-a(preferred)が先に Active になります。
systemctl stop mikagami # Active で実行すると、資源を解放して相手に引き継ぐ5. 正常時の確認
Section titled “5. 正常時の確認”mikagami two-node status --config /etc/mikagami/mikagami.tomlip -o addr show dev eth0 | grep 192.168.100.50 # Active の側だけに出るjournalctl -u mikagami -o catdaemon (...): role active ... peer connected が片方、role standby がもう片方に出ます。
6. 障害時の切替
Section titled “6. 障害時の切替”| 障害 | 動作 |
|---|---|
Active の計画停止(systemctl stop mikagami) |
資源を解放し、相手が引き継ぐ(自動) |
| Active のサービスの異常(health) | on_failure に従う(既定は警告のみ。ヘルスチェック) |
| Active の OS の停止・ネットワークの断 | 自動では引き継がない。Standby は相手を見失ったと記録するだけ |
相手が本当に止まっていることを、電源・ハイパーバイザー・コンソールで確かめてから、残ったノードで手動で切り替えます。
mikagami two-node takeover --config /etc/mikagami/mikagami.toml --attest-peer-stopped node-asystemctl kill --kill-whom=main -s USR1 mikagami止まったノードを直して systemctl start mikagami で起動します。起動したノードは、まず自分の資源を解放して Standby になります。サービスを自動で戻すこと(failback)はしません。戻したい時は、今の Active で systemctl stop mikagami を実行し、引き継がせてから起動し直します。
安全上の注意
Section titled “安全上の注意”- 1 セグメントでは、通信断と相手の停止を区別できません。自動の引き継ぎが必要なら 2 セグメント構成と fencing の装置を使います。
- 管理するサービス(nginx)を OS の起動時に自動で起動しないでください。
- 2 台の設定ファイルを同じに保ってください(違うと接続しません)。
node-idファイルは他のノードへ写さないでください。