このページは機械翻訳されています。英語の原文をお読みください。 English

他の言語:Русский、Português。

このガイドでは、2台のクリーンなサーバーから動作する Firebird 5.0 レプリカを構築するまでの手順を説明します。インストールと1つのフォルダを除き、すべてをブラウザで RCM コンソールから行います。スクリーンショットは 2026-11-17 の実行によるものです:キット 2027.2.33、RCM とノード 2027.5.12、Ubuntu 24.04、英語 UI。2026-11-08 の以前の実行のレポート:hqbird2027-rcm-cluster-check-report.ru.md(ロシア語、セクション「Прогон 2」)。スクリーンショットなしのコマンドのみ:hqbird2027-linux-cluster-runbook.md。各 RCM ページの詳細:RCM ユーザーガイド(リポジトリ hqcluster-node、docs/user-guide/)。

このガイドはキット 2027.2.24 以降を対象としています。キット 2027.2.22 については、git 履歴にある 2026-11-07 版のこのファイルを参照してください。

ダウンロードするキットは 2027.2.33(2026-11-16)です:agent 3.4.0、HQ Monitor 1.57.0、RCM とノード 2027.5.12、Firebird 5.0.5.1917。このガイドは 2026-11-17 にこれを用いて検証されました(2台のサーバー、Ubuntu 24.04、3 MB と 167 MB のデータベース):すべてのステップが成功しました。本文ではその実行の結果を「2026-11-17 の実行」と呼びます。スクリーンショットは同日の同じキットによる2回目の実行のものです(3 MB と 2.88 GB のデータベース)。その他の数値は引き続き 2026-11-08 の実行によるものです。2027.2.27 以降のキットがクラスタに関して変更した内容:

キット 変更
2027.2.29(agent 3.1.0、RCM 2027.5.9) デフォルトではクラスタなし(下記参照)。1つのホストの複数の agent がクラスタに参加可能:それぞれ独自のペアリングポート(7450–7459)とノードポートを持つ。fbagent --cluster-leave。HQ Monitor の Clusters ページ
2027.2.30(RCM 2027.5.10) サービスのスイッチオーバーとフェイルオーバー、ルーター
2027.2.31(agent 3.3.0、RCM 2027.5.11) インストーラーがターミナルでテキストインターフェースを開く(ステップ 1)。RCM の Services ページ。どの HQCenter にも接続されていないサーバーは agent、HQ Monitor、fbmcp を自身で更新する
2027.2.33(agent 3.4.0、RCM 2027.5.12) RCM がアラートを Telegram、webhook、または e-mail に送信する(「次に監視するもの」)。2つの Docker コンテナのクラスタ:Docker ガイド

すべての変更:What’s New。

agent(fbagent)3.1.0 以降のキット(2027.2.29 以降)はデフォルトではクラスタを作成しません:RCM なし、ペアリングウィンドウなし、クラスタポートはファイアウォールで閉じたままです。ステップ 1 でマスターの RCM とレプリカのディスカバリモードを有効にします。

所要時間:約30分にデータベースのコピーを加えた時間(1 Gbit/s ネットワークで 3 GB あたり約1分)。

得られるもの

サーバー 1 サーバー 2
役割 マスター + RCM コンソール レプリカ
データベース /databases/master/*.fdb /databases/replica/<replica node>/<master node>/*.fdb
サービス firebird、hqbirdfbagent-fb50、hqbirdmonitor-fb50、fbmcp、hqbirdrcm、hqclusternode-master-p3050 同じだが、hqclusternode-replica-p3050 で hqbirdrcm なし(古いキットは独自の RCM をそこに停止状態で残す)

必要なもの

  • 2台の Linux x86-64 サーバー(Ubuntu 24.04 で検証済み)、2コア、4 GB メモリ。
  • ディスク容量。マスター:データベースサイズの 105 % 以上の空き(ロック中に .delta ファイルが増加する)。レプリカ:データベースサイズの 105 % 以上に加えて下限 limits.free_space_floor_gb(デフォルト 1 GB)。既存のレプリカに対する再初期化では古いファイルが最後まで保持されるため、レプリカボリュームには約 2 × データベースサイズが必要です。Remove the old replica if space is short チェックボックス(ステップ 8)を使用する場合、105 % に下限を加えた容量で十分です。
  • サーバー間のネットワーク:ポート 3050、7051、7443、7444、7450。これらはサーバーの最初のインスタンス(スロット 0)のポートです。サーバーの2番目のインスタンスはペアリングポート 7451 とノードポート 7052 を使用します。
  • お使いの PC がマスターのポート 7444(RCM コンソール)に到達できること(直接または SSH トンネル経由)。
  • sudo 権限を持つユーザー。

ファイアウォール。 インストーラーは有効な firewalld または ufw(システム言語を問わず)でポートを開きます:3050 と 23050 は常に、クラスタポートはステップ 1 のオプションに対してのみ。マスター:7443、7444、7051。レプリカ:7450、7051。agent はペアリングウィンドウが終了するかホストがリンクされると 7450 を再び閉じます。Ubuntu では通常 ufw は無効です。その場合、インストーラーは1行書き込みます。例えばマスターでは:no active firewall (firewalld or ufw): ports 3050, 23050, 7443, 7444, 7051/tcp are not opened by this install; they are reachable from every network; close them or enable a firewall。クラウドでは、クラウドファイアウォールでポートを閉じてください:外部からは自分のアドレスのみ、サーバー間は内部ネットワークのみ。

以下は実行時のアドレスです:マスター 10.114.0.5、レプリカ 10.114.0.6(プライベートネットワーク)。ご自身のアドレスを使用してください。

ステップ 1. 両方のサーバーにインストール

各サーバーで:

Command
V=2027.2.33
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run
wget https://ib-aid.com/download/hqbird/v2027/hqbird2027-fb50-linux-$V.run.sha256
sha256sum -c hqbird2027-fb50-linux-$V.run.sha256
sudo sh hqbird2027-fb50-linux-$V.run

ターミナルで、インストーラーがテキストインターフェースを開きます(キット 2027.2.31 以降)。最初のページには Cluster RCM off, discovery mode off という行があります。Cluster を開いて1行変更します:

Cluster ページの行 マスター レプリカ
Cluster manager (RCM) on off
Discovery mode (24 h) off(この agent が RCM を実行) on

Cluster id(デフォルト:ホスト名)、RCM admin password(デフォルト:生成済み)、Pairing port(デフォルト:最初の空きポート、7450)の行はそのままにできます。戻って(Esc)Install を選択します。インストーラーがプランを表示します:Enter を押します。次に Nothing on this host was changed yet. Start the install now? と尋ねられます。カーソルは No にあります:Yes に移動して Enter を押します。インストーラーは不足しているライブラリ(例えば libtommath1)を自身で追加します。テキストインターフェースの完全な説明:hqbird2027-linux-setup-guide.md。

--no-tui の場合、およびキット 2027.2.29–2027.2.30 では、インストーラーが質問します。最初の質問は Install as planned? Yes/No です:y と答えます。次にクラスタに関する2つの質問があります。デフォルトの回答は No です(Enter):

質問 マスター レプリカ
Install the cluster manager (RCM) on this host and make a new cluster? [y/N] y Enter(No)
Turn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N] 尋ねられない:この agent が RCM を実行 y

または回答をオプションとして指定します:ターミナルでは Cluster ページが開く前に値を設定します。ターミナルなしの実行にも使用してください:--yes のみは両方とも No を意味します。

Command
sudo sh hqbird2027-fb50-linux-$V.run --rcm on               # master
sudo sh hqbird2027-fb50-linux-$V.run --cluster-pairing on   # replica

インストールには約1分かかります(2026-11-17 の実行:マスターで 61 秒、レプリカで 43 秒)。キット 2027.2.33 のマスターでの出力の最後(ハッシュはここでは短縮されています。以下の例のクラスタ id は hq27d-m、2026-11-08 の実行による):

text
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1917 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
RCM:        https://10.114.0.5:7444 (cluster hq27d-m)
CA hash:    sha256:9754e0be…087cb195
Login:      rcmadmin
Password:   in /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password (read it with sudo; RCM asks for a new one at the first login)
Pairing:    not needed: this agent runs the RCM; other agents link through it
fbmcp:      2027.2.24, service running; local only (remote mode: sudo fbmcp ctl hqbird-install --allow-from CIDR)

レプリカでは:

text
RCM:        off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing:    port 7450 open until 2026-11-09T16:25:27Z (fingerprint sha256:0d137a71…09fe44cf); an RCM may invite this host

古いキットでは、マスター上で Pairing: not opened (this agent runs the RCM) と表示されます。

マスターの RCM: と CA hash: の行、およびレプリカの Pairing: の行を書き留めてください。ステップ3で fingerprint が必要になります。

古いキット(3.1.0より前のエージェント、たとえばキット 2027.2.27)はクラスターに関する質問をしません。すべてのサーバーにRCMをインストールし、すべての場所でペアリングウィンドウを開きます。マスターのRCMを使用してください。2台目のサーバーのRCMはリンク後に自動的に停止します。

後から、インストーラーを使わずに。 サーバーのHQ Monitorで、Clusters、セクションCluster on this serverを開きます。マスター上で: Enable the cluster console (RCM)。HQ Monitorがファイアウォールの7443と7444を開きます。レプリカ上で: Open the pairing window for 24 hours。エージェントのユーザーとしてコマンドでも同じです:

Command
cd /opt/hqbird/fbagent-fb50
sudo -u firebird ./fbagent --cluster-init hq27d-m     # master; open 7443 and 7444 yourself
sudo -u firebird ./fbagent --cluster-pairing on       # replica

ペアリングウィンドウが開いている間、エージェントはファイアウォールのペアリングポートを開きます。ウィンドウが終了するか、ホストがリンクされるとポートを閉じます。

出力にパスワードは含まれません。RCMのパスワードは Password: 行のファイルに、SYSDBAのパスワードは /root/fbagent-install-sysdba.txt に、HQ Monitorのパスワードは /opt/hqbird/conf/access.properties にあります。

ライセンスをインストールする必要はありません。新しいエージェントは自動的に7日間のトライアルを開始し、クラスターノードは動作します。

ステップ2. RCMにサインインする

マスターの RCM: 行のアドレスを開きます。ポート7444がお使いのPCに対して閉じている場合は、SSHトンネルと https://localhost:7444 を使用してください:

Command
ssh -L 7444:127.0.0.1:7444 <user>@<master>

ポート7444がお使いのPCで使用中の場合は、別のローカルポートを使用してください。たとえば -L 17444:127.0.0.1:7444 と https://localhost:17444 です。

ブラウザが証明書について警告します。クラスターCAがRCM証明書に署名しているためです。サインインページにはCluster CA hashが表示されます。インストーラー出力の CA hash: 行と比較してください。一致する場合は、CA証明書(同じページのDownload the CA certificate (hqcluster-ca.crt) リンク)を信頼済みとしてインストールするか、警告を受け入れてください。一致しない場合はサインインせず、アドレスを確認してください。

RCM sign-in
RCM sign-in

ユーザー名は rcmadmin です。パスワードは Password: 行のファイルにあります:

Command
# the path is from the Password: line of your output
sudo cat /opt/hqbird/fbagent-fb50/clusterca/hq27d-m/rcm-initial-password

RCMはすぐに新しいパスワードを要求します(12文字以上):

New password at the first sign-in
New password at the first sign-in

2027.5.12より前のRCMでは、このページが何度も繰り返し読み込まれることがありました。RCM 2027.5.12(キット 2027.2.33)には修正が含まれています。

パスワード変更後、マスターのエージェントは1分以内に rcm-initial-password ファイル自体を削除します。古いキットでは、2台目のサーバーにも独自のRCMがあります。リンク後、エージェントはその以前のクラスターをフォルダー cluster/left/ に移動します。エージェント 3.1.0 はそこにある rcm-initial-password を削除しますが、古いエージェントは削除しません。その場合はファイルを自分で削除してください:

Command
# on server 2, after step 3
sudo find /opt/hqbird -name rcm-initial-password
sudo rm <path from the find output>

ファイル /opt/hqbirdrcm/initial-admin.json は削除しないでください。これには古いパスワードのハッシュのみが含まれており、これがないと、ユーザーファイルを失ったRCMはデフォルトパスワードで起動します。

パスワード変更後、RCMはすぐにSettings → Link hostsを開きます。クラスターにはまだノードがありません。Releases in the mirrorリストには、エージェントがノードをインストールする元となる hqbirdrcm と hqclusternode のリリースが表示されます。

Link hosts after the sign-in
Link hosts after the sign-in

ステップ3. ホストをリンクする

リストの最初の行はすでに入力されています(RCMホスト)。2行目を追加します。マスターが到達できるレプリカのアドレスです。サーバーに共通のDNSがない場合はIPを入力してください。RCMは文字列をそのまま保持し、ノードはそれによって互いを見つけます。

List of hosts
List of hosts

Check hostsをクリックします。ポートのないホストの場合、RCMはペアリングポート7450~7459を読み取り、応答する各エージェントに対して host:port として1行ずつ表示します(ここでは 10.114.0.6:7450)。1つのポートのみを読み取るには host:port と記述します。RCMホストにはペアリングウィンドウは不要です。RCMは自身のレジストリでそのエージェントを見つけます。Certificate fingerprintをインストーラー出力(レプリカの Pairing: 行)と比較してください。一致する必要があります。2番目のホストの状態はReady to linkです。 Member ID列には、ホストがクラスター内で取得する名前が表示されます: <host name>-<role>、たとえば hq27d-m-master。インスタンスのサフィックス(-fb50)は、ホストに複数のエージェントがある場合にのみ追加されます。

Check of the hosts
Check of the hosts

各行にはチェックボックス、ポート、インスタンス、ノードポートがあります。Linkはチェックされた行のみを対象とします。エラー状態の行はチェックできず、他の行を停止させることもありません。テーブルの下に、RCM 2027.5.12 は 10.114.0.6, no agent: closed or no answer: 7451-7459 のような行を書き込みます。これは他のエージェントが応答しないホストのペアリングポートを示しています。これらはエラーではありません。

マスターは、本番データベースが置かれるホストです。Linkをクリックして確認します:

Confirmation
Confirmation

進行状況: 「Joining → Joined → The node starts → Running」。今回の実行では、リンクに56秒かかりました(2026-11-17の実行では47秒)。

Link progress
Link progress
Done
Done

Overviewにはマスターとレプリカの2つのノードが表示されるようになりました。リンク直後、レプリカは1分間「stale」になることがあります。その後「online」になります。

Overview: two nodes
Overview: two nodes

すでにリンクされているホストに対して再度Check hostsをクリックすると、ペアリングポートでエージェントが応答しない、またはホストに到達できないと表示されます。そのホストのペアリングウィンドウは閉じており、ファイアウォールのペアリングポートも閉じています。これはエラーではありません。

マスターが存在するクラスターへの1ホストの追加。 1行のみのリンクは lone_master で拒否されます。その行が何になるかを指定してください。そのマスターのレプリカにする場合は -replica-of <master member> を、独自のマスターにする場合は -new-master(Link hostsページのチェックボックス)を追加してください。

ステップ4. マスター上のデータベースフォルダー

マスター上で、データベースはユーザー firebird がアクセスできるフォルダーにある必要があります:

Command
sudo install -d -o firebird -g firebird -m 0770 /databases/master
# example: the sample database from the kit
sudo cp /opt/firebird/examples/empbuild/employee.fdb /databases/master/
sudo chown firebird:firebird /databases/master/employee.fdb

レプリカ上では何も準備する必要はありません。Create folder

Initialize ダイアログのボタンは、コピー用のフォルダを作成します(ステップ 6)。

ステップ 5. マスター上のデータベースを登録する

Databases → Nodes テーブルで、マスターの行 → Enroll。

  • そのサーバー上のフォルダパス: /databases/master、再帰的。
  • 含めるファイルマスク: *.fdb。
  • 同期追跡テーブル: Verify ボタンが行数を比較するテーブル。 このリストは、登録する各データベースごとに設定します。 フィールドを空のままにすると、データベースは自身のパブリケーションテーブルを カウントします。すでに管理されているデータベースの場合は、 マスターデータベースのページでリストを変更します。
Enroll form
Enroll form

Preview → データベースを選択 → Enroll selected をクリックして確認します。

Confirmation of the enrollment
Confirmation of the enrollment

結果は「Enrolled: 2.」と、マスターの Firebird を再起動する必要がある というヒントです。その下の「No new databases matched.」というテキストは エラーではありません。データベースはすでに登録されています。

Result of the enrollment
Result of the enrollment

データベースは再起動を待っています:

Waits for the restart
Waits for the restart

マスターのいずれかのデータベースの行で Restart Firebird of the master を クリックし(すべてに対して 1 回の再起動で十分です)、確認します。マスターの Firebird へのすべての接続が数秒間(実行では 4 秒間)切断されます。 適切なタイミングを選んでください。

Restart of Firebird of the master
Restart of Firebird of the master

再起動後、マスターノードは CONFIGURED になります。各データベースには publication OFF バッジが付き、レプリカは「not paired」と表示します。

After the restart
After the restart

ステップ 6. レプリカを初期化する

データベースの行のレプリカ列 → Initialize。ダイアログのタイトルは 「Initialize database?」です。

Initialize dialog
Initialize dialog
  • Publication. データベースのパブリケーションがオフの間、Firebird は 変更をジャーナルに書き込まず、レプリカには何も届きません。 ダイアログはその旨を表示し、Sync publication and initialize ボタンを表示します。これをクリックすると、RCM は主キーまたは一意キーを 持つすべてのテーブルをパブリケーションに追加し、直ちに初期化を開始します。 パブリケーションがオフの間は Initialize ボタンは役に立ちません。 マスターノードが拒否します(publication_off)。
  • Replica folder: ダイアログは /databases/replica/<replica node> を提案し、実行では /databases/replica/hq27d-r-replica です。 ホストの各レプリカノードには独自のフォルダが必要です。そのままにしてください。 フィールドに「✗ The folder does not exist」と表示された場合は、 Create folder をクリックします。すると「✓ The folder was created.」と 表示されます。コピーは /databases/replica/hq27d-r-replica/hq27d-m-master/ に作成されます。 次のデータベースではフォルダはすでに設定されており、ダイアログは それを変更しません。
  • Method: Smooth(デフォルト)。ロックの前に書き込みトランザクションを チェックします。Standard はデータベースを直ちにロックします。
  • 新しいレプリカでは、「Let … stop its Firebird for this reinit」および 「Remove the old replica if space is short」のチェックボックスは 必要ありません。

最初のパブリケーション同期後にアプリケーションを再接続してください。 パブリケーションが有効になる前に開かれていたマスターデータベースへの接続は、 再接続するまでジャーナルに記録されません。2026-11-17 の実行では、 Sync publication and initialize の前に開かれていた接続がコピー後に 約 9,500 行を書き込み、レプリカにはそのうち 1 行も届きませんでした。 RCM は両側とも「Ok」と表示し、Verify(ステップ 9)だけが 「Not ok (desynced)」と表示しました。新しい接続の行は直ちにレプリケート されました。したがって、データベースの最初の Sync publication の後は、 アプリケーションを再接続する(またはマスターの Firebird を再起動する)してから、 書き込みなしで Verify を実行してください。レプリカに行が欠けている場合は、 再初期化を実行します(ステップ 7)。

負荷がかかった状態での初回初期化。 マスターのアーカイブにまだジャーナル セグメントがない間、データベースに書き込みが行われていると Smooth が 拒否することがあります。データベースの行には long_transactions: … the archive holds no segment yet と、UI 言語での ヒントが表示されます:

Refusal of the smooth method
Refusal of the smooth method

実行では、これは Sync publication and initialize の後にも発生しました (レポートの所見 G-04)。この時点でパブリケーションはすでにオンです。 マスターデータベースが「archive: 1 seg」以上を表示するまで待ち(実行では 15 秒)、Smooth メソッドで Initialize を再度クリックします。または Standard を選択します。2026-11-17 の実行(1 接続から約 49 トランザクション/秒) では、Smooth は拒否されませんでした。

進行状況はデータベースの行に表示されます: SPACE CHECK → LOCKING → COPYING TO NODE (%) → UNLOCKING → SEEDING → RESTARTING REPLICA。進行状況はページを 再読み込みした後も表示されます。この間、Initialize ボタンは非アクティブです。

Initialization progress
Initialization progress

コピーの後、レプリカノードは予定された分にレプリカの Firebird を自ら再起動します。 行にはその時刻が表示され、Restart Firebird of the replica ボタンで 直ちに実行できます。この瞬間、レプリカの Firebird へのすべての接続が切断されます。

Waits for the restart of Firebird of the replica
Waits for the restart of Firebird of the replica

大きなデータベースも同じように動作します。実行では、bulk.fdb(3.13 GB)が Sync publication and initialize ボタンで、負荷なしで初期化されました:

Copy of the large database
Copy of the large database

マスターとレプリカが「Ok」と表示し、レプリカの「last applied seg」が マスターの「last seg」に達したら完了です。新しい書き込みがないデータベース (ここでは bulk.fdb)は、レプリカのセグメント 0 で「Pending」と表示されます。 これは正常です。

Both databases ready
Both databases ready

実行の測定値(約 55 トランザクション/秒の負荷下の employee.fdb):

Database Size Master: from start to end Lock on the master Pair “Ok”
employee.fdb 4 MB 0.7 s 0.35 s after ≈1 min (waited for the replica restart)
bulk.fdb 3.13 GB 64 s (≈55 MB/s) 59 s after ≈2 min

2026-11-17 の実行(キット 2027.2.33): employee.fdb(3 MB)は 3 秒かかりました

マスター側では、bulk.fdb(167 MB)で15秒でした。レプリカ側は開始から約40秒後にペアリングされました(レプリカのFirebirdの再起動を待っていました)。

ロック中もマスターデータベースは動作します。変更は.deltaファイルに書き込まれます。

後からのパブリケーション。 データベースに新しいテーブルが現れたときは、マスターデータベースのSync publicationボタンが必要です。これにより、1つのトランザクションでパブリケーションがテーブルに一致します。Firebirdは再起動しません。

Sync publication
Sync publication

Publication tablesは、どのテーブルがレプリケーションされるかを示します。キーのないテーブルはパブリッシュできません。主キーを設定してください。

Publication tables
Publication tables

ステップ7. 再初期化

レプリカがマスターと異なる場合、またはノードがそれを要求した場合(NEEDS_REINIT)に必要です。レプリカの行 → Reinit、メソッドはSmoothです。セグメントアーカイブはすでにあり、smoothメソッドは負荷がかかっていても動作します。ジャーナル履歴より古い書き込みトランザクションを待ち、それらを表示します。

Reinit, smooth method
Reinit, smooth method

進行状況は初期化時と同じです。再初期化では通常、レプリカのFirebirdの再起動は不要です。2026-11-17の実行では、employee.fdbの再初期化でレプリカのFirebirdが再起動しました。レプリカへの接続の切断を見込んでください。この再初期化はマスター側で約49トランザクション/秒の負荷の下で4秒かかりました。書き込みが停止した後、行数は一致しました(負荷テーブルは両側とも14,418行)。

Copy at the reinit
Copy at the reinit

実行の測定値:

データベース 負荷 時間 ロック その他
employee.fdb ≈55トランザクション/秒 1.7秒 0.32秒 セグメントから417トランザクションを再生
bulk.fdb なし 61秒 55秒 レプリカのFirebirdの再起動なし

負荷の下でのsmooth再初期化の後、レプリカはinfoアラートreplication_conflict_resolved(「Record being inserted … already exists, updating instead」)を表示することがあります。レプリカが、すでにコピーに含まれていたトランザクションを再生したためです。データは一致します。実行では、すべてのテーブルの行数が一致しました。アラートは確認できます(レポートの所見G-07)。

ステップ8. レプリカのディスク容量不足

レプリカのボリュームには、データベースサイズの105%以上に加えて、古いコピーより1 GB以上の空きが必要です。古いコピーは最後まで残り、新しいファイルは一度にその全体サイズを占めるためです。容量が不足している場合、ダイアログには必要な容量、空き容量、古いコピーが占める容量が表示されます(RCMの見積もりで、レプリカノードが判断します)。古いコピーなしで容量が足りる場合は、ダイアログがRemove the old replica if space is shortチェックボックスを提案します。

Low space: the “Remove the old replica if space is short” box
Low space: the “Remove the old replica if space is short” box

このチェックボックスを付けると、レプリカノードはマスターのロック後にレプリカのFirebirdを停止し、古いコピーを削除してからFirebirdを再び起動します。実行では(空き2.97 GB、新しいコピーには3.29 GB必要、古いコピーは3.13 GB)、チェックボックス付きのbulk.fdbの再初期化は65秒かかりました。チェックボックスなしでは、ノードはinsufficient disk space on replicaで拒否します。

ダイアログは、1 GBの下限だけが不足している場合には数値を表示しないことがあります。2026-11-17の実行では(空き1.1 GB、データベースは167 MB)、ダイアログは見積もりを表示せず、チェックボックスなしの再初期化は3秒で失敗しました。データベースの行とCommandsページに理由が表示されました: insufficient disk space on replica: need 184125850 bytes (105% of the database) + 1073741824 bytes free_space_floor_gb; free 1152950272 … Removing the old replica copy would free 175357952 bytes: ask again with remove_old_replica。同じ再初期化をチェックボックス付きで行うと9秒かかりました。

チェックボックスのリスク。 コピーの実行中は、このデータベースのレプリカが存在しません。再初期化が失敗すると、ペアはNEEDS_REINITになり、レプリカにはアラートreplica_removed_for_reinit(warn)が表示され、再試行は新たな完全再初期化になります。自動再初期化が古いコピーを削除するのは、RCMキーauto_reinit.remove_old_replica_when_shortがオンの場合のみです(デフォルトはオフ)。

ステップ9. 検証

レプリカの行のVerifyは、マスターとレプリカの追跡テーブルのCOUNT(*)を比較します。行そのものは比較しません。「Table list source」の行には、データベース自身のリスト、ノードのリスト、パブリケーションテーブル、またはRDB$FIELDSというリスト名が表示されます。行数には桁区切りが付きます。

負荷の下では、レプリカは数秒遅れ、Verifyは書き込み中のテーブルに対して「Not ok」を返します:

Verify under load
Verify under load

書き込みがなければ、カウントは一致します:

Verify without load
Verify without load

どちらのデータベースにも存在しないテーブルは「not in the database」です。これは不一致ではありません。片側にしかないテーブルは「no table」です。これは不一致です。

より安全なチェックは、書き込みが停止した後に両側のすべてのテーブルの行数を確認することです(スクリプトはhqbird2027-linux-cluster-runbook.mdにあります)。実行では、11個のテーブルすべてが一致しました(employee.fdb: 10、bulk.fdb: 1、2,800,000行)。

定期チェック(Data check)はデフォルトでオフです。Turn on for all nodesをクリックして確認します。各ノードが自身の行を数え、マスターがカウントを比較します。再起動は不要です。RCMは「Saved and in force now: the node needs no restart.」と表示します。最初のチェックは1インターバル後(デフォルトでは2時間)に実行されます。

Periodic check
Periodic check

次に確認すべきこと

  • Overview: ノード、その状態、データベースルート、ディスク容量。

    Overview
    Overview
  • Alerts: ノードとデータベースの問題。実行には2つのアラートがあり、どちらも確認できます: smooth再初期化後のreplication_conflict_resolved(ステップ7)と、マスター上のparse_no_observations(「no events parsed from /opt/firebird/replication.log」)。マスターのFirebirdはreplication.logにエラーのみを書き込むため、空のログは正常です(レポートの所見G-06)。

    Alerts
    Alerts

    RCM 2027.5.12以降(キット2027.2.33)は、重大度warn以上のアラートを独自のTelegramボット、webhook、またはメールに送信できます。チャネルはファイル/opt/hqbirdrcm/rcm.jsonのキーnotify.channelsで設定し、RCMを再起動します(sudo systemctl restart hqbirdrcm)。このページのNotification channelsブロックにチャネルが一覧表示され、それぞれにSend testボタンがあります。チャネルがない場合は「No channel is configured: RCM sends its alerts nowhere.」と表示されます。Telegramチャネルの場合:

json
  "notify": { "channels": [ { "name": "ops", "type": "telegram",
      "token_file": "secrets/telegram-ops.token", "chat_id": "-1001234567890" } ] }

2026-11-17 の実行では、チャネルなしでブロックをチェックしました。メッセージは 送信されませんでした。

  • サービス (RCM 2027.5.11 以降、キットは 2027.2.31 以降): サービスのマスター、 レプリカ、ルーター、および操作のスイッチオーバー、フェイルオーバー、再参加。 このガイドではこれらを扱いません。RCM ユーザーガイドを参照してください。 使用する前に、RCM とノードを同じバージョンに更新してください。

  • コマンド: 結果を含む各 RCM 操作。時刻はブラウザのローカル時刻とその タイムゾーンです (例: 17:59:45 UTC+1)。ツールチップには UTC の時刻が 表示されます。ノードのログは UTC を使用します。

    Commands
    Commands
  • HQ Monitor: http://<server>:23050/、ユーザー名 admin、パスワードは /opt/hqbird/conf/access.properties にあります。サーバーとデータベースが 表示されます。エージェント 3.1.0 以降のキットでは、HQ Monitor に Clusters ページがあります。マスター (RCM ホスト) では、エージェントを 通じてクラスターが表示され、HQ Monitor に RCM 設定はありません。レプリカでは、 RCM のホスト名が表示され、そのコンソールへのリンクがあります。HQ Monitor 1.49.0 にはレプリケーション状態も RCM へのリンクもありません。キット 2027.2.33 (エージェント 3.4.0) 以降、エージェントはそのサーバーの問題を お使いのチャネルにも送信します: Servers → Notifications。

クラスターを更新する

最初に HQbird RCM を更新し、次にノードを更新します。キット 2027.2.31 以降、 どの HQCenter にも接続されていないサーバーは、エージェント、HQ Monitor、 fbmcp を自身で更新します (hqbird2027-linux-setup-guide.md の 「Updates without HQCenter」)。HQCenter に接続されているサーバーは、その HQCenter から更新を受け取ります。

ホストをクラスターから外す

Command
cd /opt/hqbird/fbagent-fb50
sudo ./fbagent --cluster-leave

エージェントは停止し、ノードサービスを登録解除し、それらのノードポートを 閉じ、クラスター証明書を削除し、cluster.source を none に設定します。 ノードフォルダーは残ります (--remove-data で削除されます)。RCM を実行して いるエージェントは拒否されます。また、RCM がエージェントを取り消した場合や 最後のメンバーを外した場合にも、エージェントは自ら離脱します。アンインストール は常にクラスターから離脱します。同じフォルダーへの再インストールは自由な状態 から始まります。2026-11-17 の実行では、コマンドは Cluster: left <cluster id> と出力し、レプリカデータベースはそのフォルダーに残り、1 分後も RCM にはその ホストのノードが表示されていました。クラスターサーバーからの HQbird の削除、 RCM を実行しているサーバーからの削除についても: hqbird2027-removal-guide.md、セクション 4。

よくあるエラー

表示内容 原因 対処方法
初期化時の publication_off パブリケーションがオフである、またはデータベースにキー付きのテーブルがあるのにパブリケーションにテーブルがない Sync publication and initialize ボタン (ステップ 6)
long_transactions … the archive holds no segment yet データベースへの書き込み中にスムーズ方式で初回初期化を行い、マスターのアーカイブが空である 「archive: 1 seg」を待って Smooth を再試行するか、Standard を選択
reinit_pre_publication_transactions パブリケーションが有効になる前に開始された書き込みトランザクションが 1 分以上開いている それを終了 (COMMIT または ROLLBACK) して再試行
ダイアログの「✗ The folder does not exist on …」 レプリカフォルダーが誰にも作成されていない ダイアログの Create folder ボタン、またはレプリカで install -d -o firebird -g firebird -m 0770 <folder>
Verify の「Not ok (desynced)」 データベースへの書き込み中で、レプリカが数秒遅れている 負荷なしで再試行し、Match 列を確認
書き込みがないのに Verify の「Not ok (desynced)」、両側とも「Ok」 パブリケーションが有効になる前にアプリケーション接続が開かれ、ジャーナルされていない アプリケーションを再接続してから Reinit (ステップ 6、初回パブリケーション同期に関する注記)
Link hosts でホストが「unreachable」または「no agent」 ホストのペアリングウィンドウが閉じている (デフォルトでオフ、または 24 時間が経過)、またはサーバー間のファイアウォールが 7450–7459 を閉じている ホストでウィンドウを開く: HQ Monitor → Clusters → Open the pairing window for 24 hours、または fbagent --cluster-pairing on。クラウドファイアウォールでポートを開く
再初期化時の insufficient disk space on replica 古いレプリカは最後まで残り、新しいファイルがそのフルサイズを占める レプリカボリューム上の古いファイルの上に、データベースサイズの 105 % + 1 GB 以上の空きを確保するか、Remove the old replica if space is short チェックボックス (ステップ 8)
Link hosts 後にノードが表示されない RCM ミラーに署名済みの hqclusternode リリースがない Link hosts ページの Releases in the mirror (ステップ 2)