インストールとアップデート
予期せぬ事態のないインストール
Firebird の各ラインごとに 1 つのインストーラー。サーバー上の Firebird、古い HQbird、エージェントを検出し、計画を表示し、「はい」と言うまで何も変更しません。その後は、エージェントが自身、コンソール、Firebird をチェックとロールバック付きで自動的に更新します。
- 4 つのインストーラー: Firebird 2.5 · 3.0 · 4.0 · 5.0
- 計画を確認するまで0 件の変更
- インターネット不要 すべて 1 つのファイルに
- Windows と Linux ウィザード、サイレントモード、.run
- ロールバック インストールやアップデートが失敗した場合
setup.exe · .run
キットの内容
インストーラーは 1 つのファイルです: Windows 用は hqbird2027-fb50-setup-<version>.exe、Linux 用は hqbird2027-fb50-linux-<version>.run。サーバーに必要なものはすべて含まれています。何もダウンロードされません。
各インストーラーは 1 つの Firebird ラインをインストールします。データベースが動作しているラインを選択してください。インストールはキット内のエージェントが行います: サーバーをチェックし、計画を立てて実行します。
| コンポーネント | 役割 | Windows | Linux |
|---|---|---|---|
| Firebird、HQbird ビルド | 新しいサーバー、またはインプレース更新。すでにインストールされているサーバーの場合は、firebird.conf に 1 行追加されます: MonitoringPlugin = fblwmon。新しいサーバーの場合は、インストーラーがポートも設定します。databases.conf、セキュリティ DB、SYSDBA パスワードは変更されません。 | サービス FirebirdServer… | /opt/firebird |
| fbagent エージェント | バックアップ、監視、メンテナンス、アップデート。 | HQbirdFBAgent-fb50 | hqbirdfbagent-fb50、ユーザー firebird |
| HQbird Monitor | このサーバー用の Web コンソール。ポート = 20000 + Firebird ポート: 3050 の場合は 23050 です。ポートはインストール時に選択され、後で Firebird のポートを変更しても変わりません。 | HQbirdMonitor-fb50 | hqbirdmonitor-fb50 |
| クラスタコンポーネント | クラスタのプログラムはサーバーに配置されますが、有効にはなりません: RCM とペアリングウィンドウはデフォルトでオフです。RCM はサーバーを新しいクラスタの中心にし、ポート 7443 と 7444 を開きます。ペアリングウィンドウは 24 時間ポート 7450–7459 を開きます: これを通じて、別のサーバーの RCM がこのサーバーを招待できます。インストール後に両方を有効にすることもできます。 | ウィザードページ「Replication and cluster setup」; /RCM、/DISCOVERY | --rcm on、--cluster-pairing on |
| fbmcp MCP サーバー | AI クライアントから Firebird へのアクセス。デフォルトではこのサーバーからのみ。 | ウィザードのチェックボックスまたは /NOFBMCP | --no-fbmcp |
| Firebird デバッグファイル | Firebird のクラッシュを分析するためのシンボル。 | — | あり、--no-debug でオフになります |
- Windows対応: Windows 10 および 11、Windows Server 2016 以降、64 ビット。管理者権限。インストーラーは IBSurgeon Software によって署名されています: Windows は権限のプロンプトに発行元を表示します。
- ウィザードまたはサイレントモードすべてのウィザードページはスイッチとしても利用できます:
/VERYSILENT /YES /LOG=…。スクリプトや 100 台のサーバーに適しています。 - 8 言語のウィザード英語、ポルトガル語 (ブラジル)、ドイツ語、ロシア語、スペイン語、ポーランド語、トルコ語、中国語 (簡体字)。デフォルトは Windows の言語です。スイッチ:
/LANG=en|pt_BR|de|ru|es|pl|tr|zh_CN。 - サーバー名ウィザードは新しいエージェントの名前を尋ねます; HQCenter はこの名前でサーバーを表示します。デフォルトはコンピューター名です。サイレントモード:
/AGENTID=、Linux では--agent-id。すでにインストールされているエージェントは名前を保持します。
- Linuxx86_64、カーネル 3.2 以降、systemd、root。Ubuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS、および apt、dnf、yum、zypper を備えたその他。
- インターネットのないサーバーインストーラーはリポジトリからいくつかの OS ライブラリ (libtommath、ICU) を取得します。リポジトリがない場合は、正確なコマンドを表示し、何も変更しません。
キットは 2 回チェックされます。展開前: キット全体の sha256。Firebird とエージェントのインストール前: 各ファイルの署名。破損したダウンロードは、Firebird、エージェント、コンソールへの変更前にインストールを停止します。
fbagent --install-plan
まず計画、その後で変更
最初に、インストーラーは読み取りのみを行います: サービス、レジストリ、Firebird および HQbird のフォルダー。次に、検出した内容と実行する内容を表示します。変更は「はい」と言った後に始まります。
サーバー上にあるものを選択し、計画を確認してください。テキストは短縮および翻訳されています; 順序と判断は Firebird 5.0 インストーラーと同じです。
- 1サーバーチェック権限、ビット数; Linux では systemd とカーネルも
- 2キットチェック展開前の sha256; インストール前のファイル署名
- 3計画検出された内容と実行される内容
- 4質問HQCenter 用のサーバー名; Firebird を停止しますか? 別のバージョン?
- 5インストールFirebird、エージェント、コンソール、サービス
- 6✓ 結果サービス、コンソールアドレス、ログイン
問題が発生した場合
プラン段階での拒否(ポートが使用中、フォルダが空でない)では何も変更されません。インストーラーが理由を示します。ウィザードでは、値が正しくない限りページを離れることはできません。
インストール中、エージェントサービス起動前の失敗:サービスは以前の状態に戻ります。停止していた古い HQbird は再び起動します。
| コード | 意味(Linux .run) |
|---|---|
| 0 | 完了 |
| 1 | 拒否:サーバー、スイッチ、またはプラン。何も変更なし |
| 2 | インストール失敗、変更はロールバック済み |
| 3 | ロールバック不完全:結果に確認すべき内容が記載 |
| 4 | 回答が必要:ターミナルも --yes もなし |
| 5 | キットがチェックに失敗:再ダウンロードしてください |
| 6 | OS ライブラリもリポジトリもなし |
| 7 | ディストリビューションのパッケージから Firebird |
| コード | 意味(Windows setup.exe) |
|---|---|
| 0 | インストール済み |
| 1 | インストール前に拒否:スイッチまたはファイルが不正、より新しいバージョンがインストール済み、管理者権限なし |
| 4 | インストーラーに質問があったが、/YES スイッチがない |
| 7 | サーバーチェックまたはインストールに失敗。理由はログと結果ファイルに記載 |
| 10 | インストール済みだが、HQCenter への接続に失敗 |
-p3050)を使用。新しいインストールでは -fb50 になります。FBDataGuard → fbagent
HQbird 2024 からの移行
インストーラーは古い HQbird とそれが提供する Firebird を検出します。この Firebird はその場で更新され、FBDataGuard ジョブはエージェントに移行し、古いサービスは停止されます。データベース、設定、パスワードはそのまま残ります。
- 変更されないもの
databases.confまたはaliases.conf、セキュリティ DB、SYSDBA パスワード、データベース、バックアップ、古い HQbird ファイル。firebird.confには、存在しない場合に限りMonitoringPlugin = fblwmonの行が追加されます。 - 古い Firebird のコピー古い Firebird のプログラムフォルダは、
<folder>.old_<time>として隣に保持されます。 - ジョブgbak および nbackup バックアップ、スイープ、インデックス統計。インポートは一度だけ実行され、新しい設定のチェックを通過します。古い設定は保持されます。
- 古いバックアップエージェントは FBDataGuard ジャーナルからバックアップを自身の記録に取り込みます。保持ルールとリストアは、新しいものと同じようにそれらを認識します。nbackup レベルの名前は同じままです。
- ジョブ名ジョブ名は FBDataGuard のデータベース名で終わります(例:「Verified backup - MANUAL」)。グループジョブはソースフォルダのツリーを再現します。
- 古いサービス:3つのオプション自動(推奨):FBDataGuard が提供するすべての Firebird にエージェントがある場合に無効化します。すべて無効化:
/DISABLEHQBIRD。そのままにする:/NOHQBIRD。 - 元に戻せます無効化前の各サービスの状態は
fbagent-hqbird-takeover.jsonに保存されます。このファイルを使用して、古い HQbird を再び有効にできます。 - ライセンス古い HQbird ライセンスは引き継がれません。新しいライセンスを取得するか HQCenter に接続するまで、試用期間が続きます。
- 不明なパスインポートが FBDataGuard パス内の置換を展開できない場合、そのまま保持し、ジョブを無効のままにします。パスを修正してジョブを有効にしてください。
ジョブがインポートされても古いサービスがまだ実行中の場合(例えば、サーバー上で FBDataGuard の下に2つの Firebird サーバーがある場合)、ジョブは無効状態で到着します。これにより、1つのジョブが2回実行されることはありません。
ポート · フォルダ · サービス
1台のマシン上の複数の Firebird サーバー
Firebird ごとに1つのエージェント。新しいインスタンスは、独自のポート、独自のエージェント、独自のコンソールで、他のインスタンスの隣にインストールされます。インストール済みのインスタンスは変更されません。
Firebird サーバーを追加し、インストーラーが選択する名前とポートを確認します。
- ラインごとのポートサーバー上の最初の Firebird は 3050 を取得します。次のものは、2.5 なら 3052、3.0 なら 3053、4.0 なら 3054、5.0 なら 3055 です。インストーラーは使用中のポートを取得しません。
- 同じラインの 2 つ目のインスタンスフォルダー名とサービス名に番号
-2が付きます。Windows では、これはウィザードのオプション「別のインスタンスをインストール」です。ポートはそのラインの範囲で最初に空いているものです。
- 更新は同じライン内のみ5.0.x → 5.0.y。3.0 から 5.0 への移行は、最初のインスタンスの隣に 2 つ目のインスタンスを置くことを意味します。データベースはバックアップとリストアによって移行します。
- Windows での XNETポート 3050 にない Firebird は、独自の名前
IpcName = FIREBIRD_<port>を持ちます。2 つ目のサーバーへのローカル XNET 接続は機能します。 - エージェントごとに 1 つのコンソールHQbird Monitor は 20000 + Firebird ポート: 23050、23055。サーバー上のすべてのインスタンスに対して 1 つのログインファイルです。
- ポートは固定コンソールとエージェントのローカル API のポートはインストール時に書き込まれます。後で Firebird のポートを変更しても、それらは変わりません。エージェントは同じポートを受け付けません。
- クラスター: エージェントごとに 1 つのスロットサーバー上の各エージェントは 0 から 9 までの独自のスロットを取得します。ペアリングポート 7450 + スロット、ノードポート 7051 + スロットおよび 7061 + スロットです。これにより、1 つのサーバーの 2 つのエージェントがクラスターに参加できます。
--pairing-portスイッチはスロットを明示的に設定します。
イメージ · compose · ポート
Docker での HQbird
Firebird の各ライン用の既成イメージがあります。Firebird、エージェント、HQbird Monitor がコンテナー内で動作します。エージェントは、サーバーがクラスターに参加するときに、コンテナー自体の中でクラスターノードをインストールします。RCM は、このサーバーがクラスターの RCM として割り当てられた場合にのみインストールします。
| イメージ | Firebird | Firebird ポート | HQbird Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
- 初回起動キットから
compose.yamlをコピーし、SYSDBA パスワードをシークレットファイルに書き込み、secrets:行から#を削除して、docker compose up -dを実行します。docker compose psがhealthyを表示したらサーバーの準備が完了です。 - Firebird ポート
HQBIRD_FB_PORT変数で、デフォルトは 3050 です。HQbird Monitor は 20000 + このポートで待ち受けます。 - イメージ署名イメージは cosign ツールで署名されています。検証用の公開鍵はまだ公開されていません。
- 1 つのホスト上の複数インスタンスFirebird は 3050 + N、HQbird Monitor は 20000 + Firebird ポート、クラスターノードは 7051 + N です。ホスト上の 1 つのインスタンスのみが RCM を持てます。
- 外側と内側で同じポート番号
3051:3050ではなく3051:3051を公開してください。エージェントとクラスターは、コンテナー内で見えるポートを報告します。 - クラスターメンバーアドレスは Docker ホストのアドレスです。ノードポートを公開し、RCM の場合はポート 7443 と 7444 も公開します。
Docker は ufw を越えてポートを公開します。「ポート 22 のみ」という ufw ルールはコンテナーのポートを閉じません。ポートを 1 つのホストアドレスで公開するか、外部ファイアウォールで閉じてください。
クラウドと Docker: 設定、ボリューム、ポート、更新エージェント · コンソール · クラスター · Firebird
インストール後の更新
HQCenter に接続した後、エージェントは自身、HQbird Monitor、クラスターコンポーネント、fbmcp、Firebird を自動的に更新します。HQCenter のないサーバーも自身を更新します。エージェントは IBSurgeon の更新サーバーから新しいバージョンを取得します。
エージェントは自身の新しいバージョンを 1 分以内に HQCenter で認識します。HQbird Monitor、fbmcp、Firebird の新しいバージョンは 1 時間以内です。すべての更新は 1 つのパターンに従います。確認し、ロールバックポイントを保存し、置き換え、動作を確認します。動作しない場合は、古いものを復元します。
HQCenter なしでの更新
- 自動で更新されるものエージェント、HQbird Monitor、MCP サーバー。確認は 6 時間ごとに 1 回実行されます。
- Firebird はコマンドを待つFirebird パッケージはダウンロードされ、待機します。管理者が適用します。更新ページのボタン、またはコマンド
fbagent --firebird-update --applyを使用します。 - モードは自分で選択インストールスイッチ
--auto-update all|agent|off、Windows では/AUTOUPDATE=all|agent|off。agentがデフォルトです。allは更新ウィンドウ内で Firebird もインストールします。offは何も確認しません。
- HQbird Monitor の更新ページエージェントがバージョンを取得する場所、モード、サーバーの最後の応答、Firebird、コンソール、MCP サーバーの更新の状態を表示します。管理者はモードを変更し、Firebird パッケージを適用します。
- ソースの確認更新サーバーは固定された鍵に対して確認されます。ベンダーの署名は常に必要です。
- クラスターはセンター経由クラスターノードと RCM はこの方法では更新されません。HQCenter または RCM がそれらを更新します。
エージェントの自己更新
- 前方のみエージェントは自身より古いバージョンをインストールしません。それが必須のものであっても同様です。チェックは最初のバイトがダウンロードされる前に実行されます。これにより、偽のサーバーが古い脆弱なビルドを復活させることはできません。例外は、エージェント自身の設定で許可された1つの古いバージョンです(
allow_downgrade_to)。 - 署名リリースはEd25519キーで署名され、公開キーはエージェントに組み込まれています。誤った署名は常に拒否されます。「署名のみ」モードはサーバーからではなく、エージェント自身の設定で有効になります。
- 手動ロールバックエージェントの隣にスクリプト
rollback_to_version_NNNがあります。これは以前のエージェントと設定を復元し、失敗したバージョンをブロックします。最新の2つのロールバックポイントが保持され、それより古いものは自動的に削除されます。 - Linux: rootは自身のコピーのみを実行エージェントは
firebirdとして実行されます。置き換えは、rootのみが書き込み可能なフォルダ内の検証済みコピーによって行われます。
Firebirdの更新
Firebirdはそのライン内でのみ、かつ新しいビルドへのみ更新されます。エージェントはいつでもパッケージをダウンロードして準備できますが、Firebirdを停止するのは更新ウィンドウ内でのみです。
- 1準備ダウンロード、署名、エンジンより古くないビルド
- 2ウィンドウ毎日のウィンドウ; 必須リリースもウィンドウを待つ
- 3ジョブgbak、nbackup、またはSQLスクリプトが実行中: 試行は延期される
- 4置き換え古いエンジンファイルは退避され、設定は残る
- 5チェックFirebirdが起動し、ポートで応答する
- 6✓ またはロールバック古いファイルが戻り、ビルドがブロックされる
| 更新されるもの | 保護 | 失敗した場合 |
|---|---|---|
| fbagentエージェント | 署名、新しいもののみ、180秒以内に準備完了かつ45秒の稼働 | ロールバック、30分間の一時停止; 2回目の失敗でバージョンをブロック |
| HQbird Monitor、クラスタ、fbmcp | 署名、インストール済みより新しいもののみ | 以前のバージョンが残る; 最新の2つのコピーが保持される |
| Firebird | ウィンドウ、バックアップの完了待ち、起動後のチェック | 古いエンジンが戻り、ビルドはブロックリストに入る |
ブロックされたバージョンは再度インストールされませんが、次のバージョンは通常どおりインストールされます。これにより、サーバーが「更新 → ロールバック → 更新」をループすることはありません。
フォルダ · ログ · アンインストール
ファイルの場所とアンインストール方法
Windows
C:\HQbird\ Firebird50\ Firebird 5.0、設定、セキュリティDB fbagent-fb50\ エージェントとHQbird Monitor agent_config.json エージェント設定 logs\ bak\ update\ ログ、コピー、更新キャッシュ C:\HQbirdData\ エージェントとコンソールの作業データ config\access.properties コンソールログイン C:\ProgramData\fbagent\ インストール結果とログ
Linux
/opt/firebird/ Firebird 5.0(2番目のライン: /opt/fb50) /opt/hqbird/ conf/access.properties コンソールログイン、0600 fbagent-fb50/ エージェントとHQ Monitor agent_config.json エージェント設定 logs/ bak/ update/ ログ、コピー、更新キャッシュ /var/lib/hqmonitor/ コンソールデータ /var/log/fbagent/install.log インストールログ、パスワードなし
- アンインストールはデータベースに触れませんデータベースとバックアップ(
*.fdb、*.gdb、*.fbk、*.nbk)は常に残ります。データの削除では、セキュリティDBとFirebirdパッケージのサンプルのみが削除されます。 - Windows「アプリ」: エージェント、コンソール、このエージェントのRCM、ファイアウォールルール、およびこのインストーラが新規にインストールしたFirebirdを削除します。他のエージェントがこのエージェントのRCMを使用している場合、ウィザードは「このインスタンスをそれでも削除しますか?」と尋ねます。サイレントアンインストールには
/FORCEが必要です。更新されたFirebirdは残ります。設定とセキュリティDBは「データを削除」を選択した場合にのみ削除されます。
- Linux
--uninstallはエージェントとコンソールのサービス、このエージェントのRCM、sudoersルール、およびインストーラがfirewalldまたはufwで開いたポートを削除します。エージェントはまずクラスタから離脱します。他のエージェントがそのRCMを使用している場合は、--forceスイッチが必要です。Firebirdは残ります。--remove-dataは設定、ログ、コンソールデータも削除します。 - 旧HQbirdHQbird 2027をアンインストールしても、古いサービスは再び有効になりません。管理者が状態ファイルを使用してこれを決定します。
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2