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

予期せぬ事態のないインストール

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 ラインをインストールします。データベースが動作しているラインを選択してください。インストールはキット内のエージェントが行います: サーバーをチェックし、計画を立てて実行します。

コンポーネント役割WindowsLinux
Firebird、HQbird ビルド新しいサーバー、またはインプレース更新。すでにインストールされているサーバーの場合は、firebird.conf に 1 行追加されます: MonitoringPlugin = fblwmon。新しいサーバーの場合は、インストーラーがポートも設定します。databases.conf、セキュリティ DB、SYSDBA パスワードは変更されません。サービス FirebirdServer…/opt/firebird
fbagent エージェントバックアップ、監視、メンテナンス、アップデート。HQbirdFBAgent-fb50hqbirdfbagent-fb50、ユーザー firebird
HQbird Monitorこのサーバー用の Web コンソール。ポート = 20000 + Firebird ポート: 3050 の場合は 23050 です。ポートはインストール時に選択され、後で Firebird のポートを変更しても変わりません。HQbirdMonitor-fb50hqbirdmonitor-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. 1サーバーチェック権限、ビット数; Linux では systemd とカーネルも
  2. 2キットチェック展開前の sha256; インストール前のファイル署名
  3. 3計画検出された内容と実行される内容
  4. 4質問HQCenter 用のサーバー名; Firebird を停止しますか? 別のバージョン?
  5. 5インストールFirebird、エージェント、コンソール、サービス
  6. 6✓ 結果サービス、コンソールアドレス、ログイン

問題が発生した場合

プラン段階での拒否(ポートが使用中、フォルダが空でない)では何も変更されません。インストーラーが理由を示します。ウィザードでは、値が正しくない限りページを離れることはできません。

インストール中、エージェントサービス起動前の失敗:サービスは以前の状態に戻ります。停止していた古い HQbird は再び起動します。

コード意味(Linux .run)
0完了
1拒否:サーバー、スイッチ、またはプラン。何も変更なし
2インストール失敗、変更はロールバック済み
3ロールバック不完全:結果に確認すべき内容が記載
4回答が必要:ターミナルも --yes もなし
5キットがチェックに失敗:再ダウンロードしてください
6OS ライブラリもリポジトリもなし
7ディストリビューションのパッケージから Firebird
コード意味(Windows setup.exe)
0インストール済み
1インストール前に拒否:スイッチまたはファイルが不正、より新しいバージョンがインストール済み、管理者権限なし
4インストーラーに質問があったが、/YES スイッチがない
7サーバーチェックまたはインストールに失敗。理由はログと結果ファイルに記載
10インストール済みだが、HQCenter への接続に失敗
ウィザードでのプラン。「このコンピューターで検出されたもの」と「セットアップで実行される内容」。下部:インストールをクリックするまで何も変更されません。
結果。インストールされたもの、このコンピューターからおよび別のコンピューターからのコンソールアドレス、ログインパスワードの場所。初期ビルドからの取得:そこではエージェントサービスとフォルダ名にポート(-p3050)を使用。新しいインストールでは -fb50 になります。

FBDataGuard → fbagent

HQbird 2024 からの移行

インストーラーは古い HQbird とそれが提供する Firebird を検出します。この Firebird はその場で更新され、FBDataGuard ジョブはエージェントに移行し、古いサービスは停止されます。データベース、設定、パスワードはそのまま残ります。

HQbird 2024 からの移行:FBDataGuard ジョブは HQbird 2027 エージェントに移行し、Firebird はその場で更新され、古い HQbird サービスは無効化されます
  • 変更されないもの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 スイッチはスロットを明示的に設定します。
同じラインの 2 つのインスタンス。プランは両方の Firebird サーバーと両方のエージェントを認識し、選択されたインスタンスのみを変更します。

イメージ · compose · ポート

Docker での HQbird

Firebird の各ライン用の既成イメージがあります。Firebird、エージェント、HQbird Monitor がコンテナー内で動作します。エージェントは、サーバーがクラスターに参加するときに、コンテナー自体の中でクラスターノードをインストールします。RCM は、このサーバーがクラスターの RCM として割り当てられた場合にのみインストールします。

イメージFirebirdFirebird ポートHQbird Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050
  • 初回起動キットから 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 がそれらを更新します。

エージェントの自己更新

エージェントの自己更新: チェック、ロールバックポイント、置き換え、180秒以内に準備完了、45秒の稼働; 失敗時: ロールバック、30分間の一時停止、2回目の失敗後にバージョンをブロック
  • 前方のみエージェントは自身より古いバージョンをインストールしません。それが必須のものであっても同様です。チェックは最初のバイトがダウンロードされる前に実行されます。これにより、偽のサーバーが古い脆弱なビルドを復活させることはできません。例外は、エージェント自身の設定で許可された1つの古いバージョンです(allow_downgrade_to)。
  • 署名リリースはEd25519キーで署名され、公開キーはエージェントに組み込まれています。誤った署名は常に拒否されます。「署名のみ」モードはサーバーからではなく、エージェント自身の設定で有効になります。
  • 手動ロールバックエージェントの隣にスクリプトrollback_to_version_NNNがあります。これは以前のエージェントと設定を復元し、失敗したバージョンをブロックします。最新の2つのロールバックポイントが保持され、それより古いものは自動的に削除されます。
  • Linux: rootは自身のコピーのみを実行エージェントはfirebirdとして実行されます。置き換えは、rootのみが書き込み可能なフォルダ内の検証済みコピーによって行われます。

Firebirdの更新

Firebirdはそのライン内でのみ、かつ新しいビルドへのみ更新されます。エージェントはいつでもパッケージをダウンロードして準備できますが、Firebirdを停止するのは更新ウィンドウ内でのみです。

  1. 1準備ダウンロード、署名、エンジンより古くないビルド
  2. 2ウィンドウ毎日のウィンドウ; 必須リリースもウィンドウを待つ
  3. 3ジョブgbak、nbackup、またはSQLスクリプトが実行中: 試行は延期される
  4. 4置き換え古いエンジンファイルは退避され、設定は残る
  5. 5チェックFirebirdが起動し、ポートで応答する
  6. 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をアンインストールしても、古いサービスは再び有効になりません。管理者が状態ファイルを使用してこれを決定します。
Linux、1つのインスタンスをアンインストール(Firebirdとデータベースは残ります):
sudo sh hqbird2027-fb50-linux-<version>.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2

← HQbird 2027の概要に戻る · サーバーヘルス →