HQbird 2027 for Linux:インストールガイド
このガイドは、オフラインインストーラー hqbird2027-fbNN-linux-<version>.run を使用して Linux サーバーに HQbird 2027 をインストールする管理者向けです。新規インストール、古い HQbird および以前の HQbird 2027 の更新、メンテナンスコマンド、HQCenter への接続、無人(スクリプト)インストール、インストール後のファイルの場所について説明します。
例では Ubuntu 24.04 上の Firebird 5.0 用インストーラーを示します。Firebird 2.5、3.0、4.0 用のインストーラーも同じように動作します。異なるのはバージョン、デフォルトポート、フォルダー名だけです。Windows セットアップについては Windows installation で説明しています。
目次
- 1. インストーラーがインストールするもの
- 2. インストールの概要
- 3. 新規インストール
- 4. インストール後
- 5. 古い HQbird(2024 以前)の更新
- 6. HQbird 2027 の新バージョンへの更新
- 7. メンテナンスコマンド
- 8. HQCenter への接続
- 9. 無人インストールとスクリプト
- 10. トラブルシューティング
1. インストーラーがインストールするもの
1 つの .run ファイル = 1 つの Firebird ライン。データベースが使用する Firebird バージョンのインストーラーを選択してください。
| インストーラー | インストールまたは更新する Firebird | ホスト上の最初の Firebird | サイズ |
|---|---|---|---|
hqbird2027-fb50-linux-<version>.run |
Firebird 5.0(HQbird ビルド) | /opt/firebird、ポート 3050 |
約 250 MB |
hqbird2027-fb40-linux-<version>.run |
Firebird 4.0(HQbird ビルド) | /opt/firebird、ポート 3050 |
約 220 MB |
hqbird2027-fb30-linux-<version>.run |
Firebird 3.0(HQbird ビルド) | /opt/firebird、ポート 3050 |
約 130 MB |
hqbird2027-fb25-linux-<version>.run |
Firebird 2.5(HQbird ビルド) | /opt/firebird、ポート 3050 |
約 80 MB |
すべてのインストーラーには以下が含まれ、インターネットなしでインストールされます。
- Firebird(そのラインの HQbird ビルド):新しいサーバー、またはホスト上に既にあるそのラインの Firebird のインプレース更新。
firebird.conf、databases.conf(2.5 ではaliases.conf)、セキュリティデータベース、SYSDBA パスワードは保持されます。 - Firebird デバッグファイル(クラッシュ解析用のシンボル):Firebird フォルダーにインストールされます。
--no-debugでスキップできます。 - HQbird エージェント(
fbagent):systemd ユニットhqbirdfbagent-fb50。ユーザーfirebirdとして実行され、バックアップ、監視、メンテナンスジョブ、更新を行います。名前は Firebird ライン(-fb25…-fb50)で終わります。同じラインの 2 番目のインスタンスは-fb50-2となります。 - HQ Monitor:この HQbird インスタンスの Web コンソール。ユニット
hqbirdmonitor-fb50、アドレスhttp://<server>:<20000 + Firebird port>/(ポート 3050 の Firebird の場合:http://localhost:23050/)。 - クラスターコンポーネント:クラスターコンソール RCM(
hqbirdrcm)とクラスターノード(hqclusternode)はエージェントのキャッシュにコピーされます。エージェント(fbagent)3.1.0 以降のキットでは、デフォルトでクラスターは作成されません。RCM なし、ペアリングウィンドウなし、ファイアウォールにクラスターポートなしです。2 つの質問(または--rcm on、--cluster-pairing on)で有効になります(セクション 3 の「Next: cluster」)。RCM を使用する場合、/opt/hqbirdrcmにインストールされ、ユニットhqbirdrcmとして実行されます。サマリーにはRCM:行にそのアドレスが表示されます。ノードは、RCM でホストをリンクしたときにユニット(例えばhqclusternode-master-p3050)を取得します。古いエージェントを持つ 2027.2.19 以降のキットは、各サーバーに RCM をインストールし(--rcm offでキャッシュに残す)、ペアリングウィンドウを開きます。2027.2.19 より前のキットは、両方のコンポーネントをエージェントのキャッシュにコピーするだけです。ユニットhqbirdrcmもRCM:行もありません。
2027.2.9 より前にインストールされたインスタンスでは、エージェント名に Firebird ポートが含まれます。フォルダー /opt/hqbird/fbagent-p3050、ユニット hqbirdfbagent-p3050 と hqbirdmonitor-p3050 です。更新してもこれらの名前は変わりません。新しいインスタンスのみが -fb<NN> 名を取得するため、1 つのホストに両方の形式が存在する可能性があります。
要件: x86_64、カーネル 3.2 以降、systemd、apt、dnf/yum または zypper を備えた Linux(Ubuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS など)、root。インストール中に /var/tmp に約 300 MB の空き容量が必要です(プログラムを実行できるフォルダー。--tmpdir を参照)。一部の OS ライブラリ(libtommath、ICU)はディストリビューションのリポジトリから取得されます。インターネットのないサーバーには、それらを準備するための正確なコマンドが提供されます(セクション 9)。
サポートされないもの: ディストリビューションのパッケージ(firebird3.0-server、firebird rpm)からインストールされた Firebird。インストーラーは何も変更する前に停止します(終了コード 7)。まずパッケージを削除してください(データベースの gbak バックアップを保持)。または --import-firebird を指定してオンラインインストーラーを使用してください。
1 つのサーバー上の複数の Firebird ライン: 各ラインには独自のインストーラーがあります。ホスト上の最初の Firebird は /opt/firebird に、2 番目のラインは /opt/fb<NN>(/opt/fb50、/opt/fb40、/opt/fb30)にそのラインのポートでインストールされます。3.0 は 3053、4.0 は 3054、5.0 は 3055 です。そのポートが使用中の場合、インストーラーは停止し、--port N を要求します。1 つのラインの複数インスタンス(別のポート上の 2 番目の Firebird 5.0)は、--fb-root <new folder> --port <port> でインストールします(セクション 7)。Firebird 2.5 は /opt/firebird に 1 つのインスタンスのみです。その隣に 2 番目のサーバーを置くには、別のライン(例えば /opt/fb50 の Firebird 5.0)を使用してください。
ポート 3050 と 3051 上の 2 つのインスタンスについて、すべてのラインを対象としたコピー&ペースト可能なコマンド付きのステップバイステップのランブックは、hqbird2027-linux-two-instances-runbook.ru.md(ロシア語)と hqbird2027-linux-two-instances-runbook.pt.md(ポルトガル語)にあります。
トライアル: ライセンスがない場合、エージェントは 7 日間のトライアルで動作します。トライアルメール(--email)で 30 日間に延長されます。ライセンスファイル(--license)または HQCenter への接続(セクション 8)がトライアルに代わります。
更新: キット 2027.2.31(エージェント 3.3.0)以降、どの HQCenter にも接続されていないサーバーはベンダーの更新サーバーをチェックします。デフォルトでは、エージェント、HQ Monitor、fbmcp は自動的に更新され、新しい Firebird パッケージがダウンロードされて待機します。--auto-update all|agent|off またはテキストインターフェースの Updates 行でこれを変更できます(セクション 4 の「Updates without HQCenter」)。HQCenter に接続されたサーバーは、その HQCenter から更新を受け取ります。
2. インストールの概要
サーバーチェックとインストール自体は、インストーラーが同梱する HQbird エージェント(fbagent --install-plan、fbagent --setup-install)によって行われます。不足している OS パッケージ以外は何もダウンロードされません。プランが確認される前に何も変更されません。OS パッケージは確認後にインストールされます。ターミナルでは、2027.2.30 以降のキットはテキストインターフェースを開きます(セクション 3 のステップ 3)。--no-tui はプレーンインストーラーを実行し、質問をテキスト行として行います。ターミナルがなく --yes もない場合、インストーラーは確認の段階で終了コード 4 で停止します。エージェントユニットが起動する前にインストールが失敗した場合、エージェントはユニットを以前の状態にロールバックします(終了コード 2。ロールバックが完全でなかった場合はコード 3 で、サマリーに確認すべき内容が表示されます)。
3. 新規インストール
ステップ 1:インストーラーをダウンロードして確認する
KIT=hqbird2027-fb50-linux-2027.2.9.run
curl -fL -O https://ib-aid.com/download/hqbird/v2027/$KIT -O https://ib-aid.com/download/hqbird/v2027/$KIT.sha256
sha256sum -c $KIT.sha256他のラインも fb40、fb30、fb25 に置き換えた同じ名前です。期待される結果:hqbird2027-fb50-linux-2027.2.9.run: OK。インターネットのないサーバーの場合:同じリンクで PC 上に 2 つのファイルをダウンロードし、サーバーにコピーします(scp、USB ドライブ、共有)。
インストーラーは、何かを展開する前に自身のペイロードもチェックします。切断された
または破損したダウンロードは終了コード 5(「再度ダウンロードしてください」)で停止します。
ステップ 2: ホストを変更せずに確認する(任意)
sudo sh hqbird2027-fb50-linux-2027.2.9.run --check--check はホストチェックを実行し、不足している OS ライブラリ(およびインターネットのないサーバーでそれらを入手するためのコマンド)を報告し、エージェントが見つけた内容と実行する内容を表示して終了します。何もインストールされません。
ステップ 3: インストーラーを実行する
sudo sh hqbird2027-fb50-linux-2027.2.9.run2027.2.30 以降のキットは、ターミナルで起動するとテキストインターフェースを開きます。プランと設定を表示する全画面ページです。2027.2.30 までのキット、および以下の「プレーンインストーラー」に記載のケースでは、質問がテキスト行として表示されます。どちらも同じオプションで同じインストールを行います。
テキストインターフェース
インストーラーはホストをチェックし、自身を展開し、プランを読み取り、最初のページを表示します。インストールページでインストールを開始するまで、ホスト上の何も変更されません。
HQbird 2027 setup <version> | Firebird 5.0 (5.0.5.1917)
Plan M1: New Firebird and HQbird agent
Firebird: new /opt/firebird (unit firebird, port 3050)
Agent: new, in /opt/hqbird/fbagent-fb50
OS packages to install: libtommath1 (see Plan details)
Language English (auto)
Firebird folder automatic (/opt/firebird)
Firebird port automatic (3050)
Agent id automatic (srv1261114-fb50)
SYSDBA password generated (for a new Firebird)
HQ Monitor port automatic, login admin
License not now (add it later in HQ Monitor)
HQCenter not attached
Cluster RCM off, discovery mode off
Components debug files: yes, fbmcp: yes
Updates HQbird only (recommended)
> Install
Plan details
About plans
Quit
Up/Down: move Enter: change or start Esc: quit上部の行は現在の設定に対するプランです。そのコードと、インストーラーが Firebird とエージェントに対して実行する内容を示します。実行不可能なプランは赤で表示され、理由が示され、カーソルはそれを修正する設定の上に置かれます。変更のたびに、インストーラーはプランを再度読み取ります。
| キー | 動作 |
|---|---|
| Up、Down | カーソルを移動(k、j も可) |
| Enter | カーソル下の設定を開く、項目を選択する、入力した値を受け入れる |
| Space | コンポーネントをオンまたはオフにする(コンポーネントページ) |
| Esc | 前のページに戻る。最初のページではインストーラーを終了する(先に確認を求めます) |
| Ctrl+C | インストーラーを直ちに停止する(終了コード 2)。インストールページより前は何も変更されていません |
値を入力するページ(フォルダ、ポート、アドレス)では、Enter で受け入れ、空の値は「自動」を意味します。Esc ではそのようなページを離れません。
| 設定 | 選択内容 | 対応するオプション |
|---|---|---|
| Language | 英語、ロシア語、ブラジルポルトガル語、ドイツ語。ページは即座に切り替わります | --lang |
| Firebird folder | 新しい Firebird のフォルダ、または更新する Firebird のフォルダ。Firebird 2.5 はフォルダが 1 つなので、そのインストーラーにはこの行がありません | --fb-root |
| Firebird port | Firebird の TCP ポート | --port |
| Agent id | 自動、ホスト名、ホスト名とインスタンス、または独自の値。新しいエージェントの場合のみ。インストール済みのエージェントは id を保持し、この行は表示されません | --agent-id |
| SYSDBA password | 新しい Firebird の場合: 生成、または独自の値 | --sysdba-pass-file |
| HQ Monitor | Web コンソールのポートとサインイン | --hqmonitor-port、--hqmonitor-login、--hqmonitor-password-file |
| License | 今はしない、メールによる 30 日間のトライアル(アドレス、プライバシー通知、ゾーン)、またはライセンスファイル | --email --accept-privacy --trial-zone、--license |
| HQCenter | HQCenter の attach.json ファイル |
--attach |
| Cluster | クラスターマネージャー RCM(クラスター id、管理者パスワード)、ディスカバリーモード、ペアリングポート | --rcm、--cluster-id、--rcm-password-file、--cluster-pairing、--pairing-port |
| Components | Firebird のデバッグファイル、fbmcp とそのリモートモードのアドレス | --no-debug、--no-fbmcp、--fbmcp-allow-from |
| Updates | HQbird のみ(エージェント、HQ Monitor、fbmcp は自動更新、新しい Firebird は手動を待つ)、HQbird と Firebird(Firebird も自動更新、夜間 03:30 から 04:00、Firebird の再起動を伴う)、またはオフ。キット 2027.2.31 以降。attach.json ファイルのない新しいエージェントの場合のみ: アタッチされたエージェントの更新は HQCenter が制御します |
--auto-update |
コマンドラインのオプションは、ページが開始時に持つ値です:
sudo sh hqbird2027-fb50-linux-<ver>.run --rcm on --port 3055 は、RCM オン、ポート 3055 で最初のページを開きます。
設定の下にある 4 つの行:
- Install はプランを完全に表示し、次に
Start the install now?と尋ね、カーソルは No に置かれます。プランの質問(古い HQbird、停止する実行中の Firebird)は同じページにあります: Yes はそれらすべてに答えます。Yes の後、ページは閉じ、インストールは以下のプレーンインストーラーと同様に、通常の画面にログとサマリーを出力します。 - Plan details はプランのコードの意味、インストーラーがホストで見つけた内容、警告、インストールする OS パッケージを表示します。
- About plans はすべてのコード(M1 … M17)を一覧表示します。コード上で Enter を押すと説明が表示されます。
*は現在のプランのコードを示します。 - Quit はインストーラーを終了します(終了コード 1)。何も変更されていません。
プレーンインストーラー
プレーンインストーラーは、次のいずれかが真の場合に実行されます:
- オプション
--no-tui、または変数HQBIRD_NO_TUI=1; --yes、--check、--uninstall、--extract、--plan-help、--help;- stdin または stdout がターミナルでない場合: スクリプト、ターミナルなしの
ssh host 'command'、または... 2>&1 | tee install.logのようなパイプ; TERMがdumbまたは未設定;- ウィンドウが 80 列 × 24 行より小さい場合(
tmux内ではステータス行があるため 80x24 のターミナルは 23 行になります: ウィンドウを大きくするか、--no-tuiを使用してください); - ホスト上の bash が 4.4 より古い場合(RHEL 7、CentOS 7);
- キットが 2027.2.30 以前の場合。
ウィンドウと bash については、出力の最初の行にページが開かなかった理由が表示されます。
Firebird のないサーバーでのプレーンインストーラーの典型的な実行例:
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] host: Ubuntu 24.04.5 LTS, kernel 6.8.0-142-generic
[install] checking the payload (sha256) ...
[install] unpacking into /var/tmp/hqbird2027.k3Qf1x ...
[install] OS libraries missing: libtommath.so.1 (packages: libtommath1)
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] OS packages to install: libtommath1
[install] Install as planned? Yes/No y
[install] installing from the package repository: libtommath1
[install] OS libraries: installed
[install] installing (fbagent --setup-install; log /var/log/fbagent/install.log) ...
...
Done: agent hqbirdfbagent-fb50 in /opt/hqbird/fbagent-fb50, Firebird 5.0.5.1916 in /opt/firebird (port 3050).
HQ Monitor: http://localhost:23050/ (login admin; password in /opt/hqbird/conf/access.properties)
[install] done. Uninstall: sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstallこの例はキット 2027.2.9 のものです。キット 2027.2.19 以降、サマリーにはクラスターコンソールの RCM: と Pairing: の行も含まれます(以下の「次へ: クラスター」)。エージェント 3.1.0 以降でクラスターが選択されていない場合、それらは次のとおりです:
RCM: off; turn it on in HQbird Monitor or with fbagent --cluster-init <id>
Pairing: off; turn it on in HQbird Monitor or with fbagent --cluster-pairing on (port 7450)各行の意味:
- host: ディストリビューションとカーネル。インストーラーは、x86_64 でない、systemd がない、または 3.2 より古いカーネルを実行しているホストを拒否します。
- OS libraries: このラインの Firebird が OS に必要とするもの(セクション 9)。プランは不足しているパッケージ(
OS packages to install)を一覧表示します。確認後、インストーラーはディストリビューションのリポジトリからそれらを取得します。リポジトリがない場合は終了コード 6 で停止します
コマンドを出力します。
- plan: エージェントが見つけた内容(
found Firebird ...、HQbird: ...の行)と、これから行う内容:Firebird new(新しいサーバー)、update(このラインの Firebird をその場で更新)、または理由を伴う拒否(終了コード 1、何も変更されません)。 - Install as planned? Yes/No: 何かが変更される前の最後の質問です。
yと答えてください。プラン自体に質問がある場合(古い HQbird、別のバージョンなど)は、代わりにそれらが表示されます(セクション 5)。ターミナルがない場合は--yesを渡してください。そうでなければインストーラーは終了コード 4 で停止します。 - クラスターの質問(エージェント 3.1.0 以降):
Install the cluster manager (RCM) on this host and make a new cluster? [y/N]およびTurn on discovery mode for 24 hours (an RCM on the network may invite this agent into its cluster; port 7450)? [y/N]。デフォルトは No です。1 つ目は、ホストに RCM がなく、エージェントがいずれのクラスターにも属していない場合にのみ尋ねられます。2 つ目は、エージェントがクラスターに属している場合、または RCM を実行している場合は尋ねられません。--yesおよびターミナルなしでの実行では No と回答されます(終了コード 4 にはなりません)。 - HQ Monitor: アドレスとログイン情報です。新規インストールではログイン
adminが設定され、生成されたパスワードは/opt/hqbird/conf/access.propertiesにあります(モード 0600、rootとエージェントのみ読み取り可能)。ホスト上のすべての HQbird 2027 インスタンスがこのファイルを共有します。パスワードは HQ Monitor で変更してください。
新しい Firebird の SYSDBA パスワードは生成され、/root/fbagent-install-sysdba.txt に保存されます(モード 0600):コメント行の後に SYSDBA_PASS=<password> の行が続きます。後で同じホストにさらに Firebird をインストールすると、このファイルから同じパスワードが使用されます。独自のパスワードを設定するには、--sysdba-pass-file <file>(ファイルの最初の行)または --sysdba-pass <password> を渡してください。
インストーラーの言語
2027.2.30 以降のキットは 4 つの言語に対応しています:英語、ロシア語(ru)、ブラジルポルトガル語(pt-BR)、ドイツ語(de)。インストーラーは次の順序で言語を選択します:
- オプション
--lang en|ru|pt-BR|de; - 変数
HQBIRD_LANG; - コンソールのロケール(
LC_ALL、次にLC_MESSAGES、次にLANG)。UTF-8 ロケールの場合のみ; - 英語。
出力の 2 行目には、どの言語か、およびその変更方法が表示されます。この行は常に英語です:
[install] Language: Русский (auto). Use --lang en to change.注意:
- PuTTY は
LANGをサーバーに送信しません。サーバー自身のロケールが適用されるため、言語は英語になることがよくあります。--langを使用してください。 --yesを指定し、ターミナルがない場合、自動言語は英語になります:スクリプトはその出力を読み取ります。そこでも--langは機能します。- インストーラーは他の言語のためにホスト上に UTF-8 ロケール(
C.UTF-8またはen_US.UTF-8)を必要とします。インストーラーは自身のために 1 つ設定します。ない場合は英語で表示されます。 - テキストインターフェースでは、最初のページの Language 行で言語が即座に変更されます。ターミナルは UTF-8 を表示できる必要があります(PuTTY:Window、Translation、Remote character set UTF-8。これがデフォルトです)。
- 英語のまま残るもの:インストール自体の進捗行、
Done:の概要、/var/log/fbagent/install.log、およびホストスキャンの警告。
プランのコード
プランにはコードがあります:M1、M2、… これはインストーラーがホスト上で見つけたケースを表します。インストーラーはコードの意味を出力します:
[install] plan M1: New Firebird and HQbird agent
[install] This host has no Firebird and no older HQbird. Setup installs a new Firebird and a new HQbird agent.
[install] plan M1: Firebird new /opt/firebird (unit firebird, port 3050)--plan-help はすべてのコードを出力して終了します。何も変更しません。テキストインターフェースでは、最初のページにコードとそのタイトルが表示され、「Plan details」にテキストが表示され、「About plans」にすべてのコードが一覧表示されます。
| コード | インストーラーが見つけた内容 | Firebird | エージェント | 古い HQbird |
|---|---|---|---|---|
| M1 | なし | 新規 | 新規 | — |
| M2 | このラインの Firebird、古い HQbird なし | 更新 | 新規 | — |
| M3 | 別のラインの Firebird、古い HQbird なし | 新規、ポート 305N | 新規 | — |
| M4 | このラインの Firebird を提供する古い HQbird | 更新 | 新規 | 停止、そのジョブは有効としてインポート |
| M5 | 別のラインの古い HQbird;このラインの Firebird が存在 | 質問の後に更新 | 新規 | 稼働を継続 |
| M6 | 別のラインの古い HQbird;このラインの Firebird なし | 質問の後に新規 | 新規 | 稼働を継続 |
| M7 | 既知のバージョンのローカル Firebird がない古い HQbird | 更新または新規 | 新規 | 稼働を継続、警告 |
| M8 | 別の Firebird 用の HQbird 2027 エージェント | 更新または新規 | 新規、最初のものの隣に | 変更なし |
| M9 | M8 と同様で、古い HQbird がこのラインを提供 | 更新 | 新規、最初のものの隣に | 停止、そのジョブは有効としてインポート |
| M10 | エージェントがすでにこの Firebird を提供(再実行) | 更新 | その場で | 実行中であれば停止 |
| M11 | --fb-root がこのラインの Firebird |
更新 | 新規またはその場で | 上記と同様 |
| M13 | --fb-root が空または新しいフォルダー |
そのフォルダーに新規 | 新規 | 上記と同様 |
拒否のコード(終了コード 1、何も変更されません):M12 フォルダーにインストーラーが更新できない Firebird がある(別のライン、読み取れないバージョン、無効なサービス);M14 フォルダーが空でなく、Firebird がない;M16 このラインの Firebird サーバーが複数ある、--fb-root を指定してください;M17 Firebird 2.5 は /opt/firebird でのみ動作します。M15 はエージェント専用キットです:Firebird はインストールも更新もされません。
エージェント ID
エージェント ID は、HQCenter、ライセンス、およびクラスター内でエージェントを識別します。最初のインストール時にのみ設定されます:
- デフォルト:ホスト名 + 日付 + インスタンス。例:
srv1261114-fb50。 --agent-id IDで独自の ID を指定(1〜128 文字の英字、数字、.、_、-;最初の文字は英字または数字)。- インストーラーは、ホストの別のエージェントが持つ ID を拒否します。
- テキストインターフェースでは、Agent id ページで自動 ID、ホスト名、インスタンス付きホスト名、および独自の値を選択でき、ホストがすでに持つ ID を一覧表示します。
- インストール済みのエージェントはその ID を保持します。再実行ではプランにそれが表示され(
id srv1 (kept))、テキストインターフェースにはそのとき Agent id 行がなく、そこでの--agent-idは警告のみを出します。以前のインストールが設定を残したフォルダー内の新しいエージェントも、その設定の ID を保持します。
ステップ 4:結果を確認する
systemctl status firebird hqbirdfbagent-fb50 hqbirdmonitor-fb50 --no-pager
ss -ltnp | grep -E ':3050|:23050'
ISC_PASSWORD="$(sed -n 's/^SYSDBA_PASS=//p' /root/fbagent-install-sysdba.txt)" \
/opt/firebird/bin/isql -user SYSDBA localhost/3050:/opt/firebird/examples/empbuild/employee.fdbサンプルデータベースのフルパスを使用してください:これはすべてのラインで機能し、更新後にも機能します。一方、古いインストールで保持された databases.conf には employee エイリアスがない場合があります(2027.2.3 の新規インストールにはあります)。
ブラウザで http://<server>:23050/ を開き、/opt/hqbird/conf/access.properties のパスワードで admin としてサインインしてください。Firebird ポートと HQ Monitor ポートは、firewalld が実行中であればそこ(ゾーン public)で、そうでなければ ufw がアクティブであればそこで開かれます。別のファイアウォールを使用している場合はご自身で開いてください。クラスターポートはクラスターオプションの場合にのみ開かれます:--rcm on で 7443、7444、およびノードポート;--cluster-pairing on でノードポートとペアリングポート。アクティブなファイアウォールがない場合、インストーラーは開かなかったポートを 1 行で出力します。インストール前に開いていたポートはそのままにされます。
次へ:クラスター
マスターサーバーからレプリカサーバーへデータベースをレプリケートするには、クラスターコンソール RCM で 2 つのサーバーをリンクします。エージェント 3.1.0 以降では、RCM をマスターにのみインストールし(--rcm on、または y と回答)、レプリカでディスカバリーモードを有効にします(--cluster-pairing on)。ディスカバリーモードは 24 時間ペアリングウィンドウを開きます:エージェントのスロットのペアリングポート(最初のインスタンスは 7450、2 番目は 7451、最大 7459)がファイアウォールで開かれ、RCM がエージェントを招待できるようになります。1 つのホストには 1 つの RCM(ポート 7443 と 7444)があります。それを作成したエージェントがそれを実行し、ペアリングウィンドウを開きません。
後で、インストーラーを使わずに:HQ Monitor → Clusters → Cluster on this
server、または fbagent --cluster-init <id> と fbagent --cluster-pairing on。2027.2.19 以降のキットで古いエージェントを使用する場合、各サーバーで RCM が起動し、
サマリーの RCM: 行にそのアドレスが表示されます。2027.2.19 より前のインストールは、
新しいキットで更新すると RCM を取得します(セクション 6)。クラスタガイド(キット 2027.2.33 用)は、
2 台の新しいサーバーから動作するレプリカまでの手順をスクリーンショット付きで
段階的に説明しています:
Linux クラスタガイド
(ロシア語 と
ポルトガル語 でも利用可能)。同じ手順を
コマンドのみで示したもの:
hqbird2027-linux-cluster-runbook.md
(hqbird2027-linux-cluster-runbook.ru.md、
hqbird2027-linux-cluster-runbook.pt.md)。
4. インストール後
ユニット
| ユニット | 内容 | 実行ユーザー |
|---|---|---|
firebird(/opt/firebird 内の 2.5、4.0、5.0);firebird-superserver(/opt/firebird 内の 3.0);別のフォルダーの場合はフォルダー名の / を _ に置換:firebird.opt_fb50、firebird.opt_fb40-2(/opt/fb50、/opt/fb40-2 内の 4.0、5.0)、firebird.opt_fb30-superserver(/opt/fb30 内の 3.0) |
Firebird サーバー | firebird |
hqbirdfbagent-fb50(2 番目のインスタンスは hqbirdfbagent-fb50-2;2027.2.9 より前は hqbirdfbagent-p<Firebird port>) |
HQbird エージェント | firebird |
hqbirdmonitor-fb50(hqbirdmonitor-fb50-2;2027.2.9 より前は hqbirdmonitor-p<Firebird port>) |
HQ Monitor | firebird |
3 つすべてが有効化され、起動時に開始されます。journalctl -u hqbirdfbagent-fb50
でエージェントのユニットログを表示できます。Firebird 3.0 にはユニット
firebird-classic.socket と [email protected]
(別のフォルダーでは firebird.opt_fb30-classic.*)もあり、Firebird 2.5 には
firebird.socket があります:これらは inactive のままですが、これは正常です。Firebird 2.5
のプロセスは fb_smp_server(SuperClassic)です。
ファイルの場所
例は、ポート 3050 の /opt/firebird にある最初の Firebird 5.0 インスタンスです。同じラインの
2 番目のインスタンスでは、エージェント名に -2 が付きます
(fbagent-fb50-2、hqbirdfbagent-fb50-2、hqbirdmonitor-fb50-2)。
2027.2.9 より前にインストールされたインスタンスでは、これらの名前にポートが含まれます
(fbagent-p3050、hqbirdfbagent-p3050、hqbirdmonitor-p3050)。
/opt/firebird/ Firebird 5.0 server: bin/, lib/, plugins/, firebird.conf,
databases.conf, security5.fdb, *.debug files (symbols)
/opt/fb50/ a Firebird 5.0 next to another line (/opt/fb40, /opt/fb30)
/opt/hqbird/ root of the HQbird agents
conf/access.properties HQ Monitor sign-in, shared by all instances of the host (0600)
fbagent-fb50/ HQbird agent of this Firebird
fbagent the agent (unit hqbirdfbagent-fb50)
hqmonitor HQ Monitor (unit hqbirdmonitor-fb50)
agent_config.json agent configuration (encrypted secrets: config_secret.key)
config.properties HQ Monitor configuration
hqbird2027-firebird.json the Firebird this installer installed
hqbird2027-hqmonitor-firewall.json the HQ Monitor port this installer opened in firewalld or ufw
conf/ trace and job settings
logs/ agent log (firebird-agent_<date>.jsonl), license_state.json;
journal.log and server_status.json after the first checks
bak/ backups of the configuration
outcoming/ status reports for HQCenter
update/ update cache: hqmonitor/, hqclusternode/, hqbirdrcm/
certs/ certificates after the attach to HQCenter
fbagent-hqbird-takeover.json state of the older HQbird units before the takeover (section 5)
/opt/hqbirdrcm/ the cluster console RCM (unit hqbirdrcm, owner firebird):
with agent 3.1.0 only after --rcm on (or HQ Monitor);
kits 2027.2.19+ with an older agent: unless --rcm off
/opt/hqclusternode/ the cluster node (owner firebird), empty until the host is
linked in RCM or HQCenter adds it to a cluster
/var/lib/hqmonitor/<server id>/ HQ Monitor data
/var/log/fbagent/install.log log of the installer's steps (passwords are hidden)
/root/fbagent-install-sysdba.txt SYSDBA password of a new Firebird (root only, 0600)
/etc/sysctl.d/90-hqbird-firebird.conf kernel settings for Firebird (vm.max_map_count), only when
the system value is lower (Ubuntu 24.04 needs none)
/etc/sudoers.d/ the agent's sudoers rules for its root helpers (updates, HQ Monitor)インストーラーは /var/tmp に何も残しません:作業フォルダー
/var/tmp/hqbird2027.XXXXXX は最後に、エラー後でも削除されます。
ログ
| ログ | 場所 |
|---|---|
| インストーラー | ターミナル;/var/log/fbagent/install.log |
| エージェント | /opt/hqbird/fbagent-fb50/logs/firebird-agent_<date>.jsonl、journal.log;journalctl -u hqbirdfbagent-fb50 |
| HQ Monitor | journalctl -u hqbirdmonitor-fb50;監査ログ /opt/hqbird/fbagent-fb50/hqmonitor_audit.log |
| Firebird | /opt/firebird/firebird.log |
HQCenter なしでの更新
キット 2027.2.31(エージェント 3.3.0)以降、どの HQCenter にも接続されていない
エージェントは、ベンダーの更新サーバーから新しいバージョンを取得します。更新モードは
agent_config.json のキー update.mode です:
| モード | 自動更新されるもの |
|---|---|
agent(デフォルト) |
エージェント、HQ Monitor、fbmcp。新しい Firebird パッケージはダウンロードされ、管理者の承認を待ちます |
all |
上記に加えて Firebird も、適用ウィンドウ内で(夜間 03:30 から 04:00;更新により Firebird が再起動されます) |
off |
何もなし:エージェントは更新チェックを行いません。更新するには、新しいバージョンのインストーラーを実行します(セクション 6) |
- インストール時:テキストインターフェースの Updates 行、または
--auto-update all|agent|off。これらを指定しない場合、インストーラーは モードを変更しません。 - 後から:HQ Monitor の Updates ページ、または再度インストーラーを
--auto-update <mode>で実行。 - 状態:
sudo /opt/hqbird/fbagent-fb50/fbagent --update-status(スクリプト用に--jsonを追加)。リリースソース、ゾーン、更新サーバーの 最後の応答を表示します。
エージェントは次のアドレスへの発信 HTTPS 接続のみを開きます。受信ポートは 必要ありません。
| 目的 | アドレス |
|---|---|
| 更新、ゾーン EU | liceu.ibsurgeon.com:9443 |
| 更新、ゾーン BR | licbr.ibsurgeon.com:9443 |
| 更新、ゾーン RU | licru.ibsurgeon.com:20943 |
| トライアルライセンス | trialeu.ibsurgeon.com:9443、trialbr.ibsurgeon.com:19443、trialru.ibsurgeon.com:23943 |
HQCenter に接続されているサーバーは更新アドレスを使用しません: その HQCenter から更新を取得します(セクション 8)。
通知
キット 2027.2.33(エージェント 3.4.0)以降、エージェントはサーバーの問題に関する
メッセージを、独自の Telegram ボット、webhook、またはメール(SMTP)に送信します。
インストーラーはチャネルを設定せず、チャネルを追加するまで何も送信されません:HQ
Monitor → Servers → Notifications。コマンドラインからチャネルをテストするには:
sudo -u firebird /opt/hqbird/fbagent-fb50/fbagent --notify-test <channel>;--notify-history は最後の配信を表示します。
5. 古い HQbird(2024 以前)の更新
インストーラーは /opt/hqbird にインストールされた HQbird(FBDataGuard)と
そのユニット、およびそれが管理する Firebird サーバーを検出します。その後、HQbird インストール
スクリプトと同じルールに従います:
ターミナルに表示される内容:
[install] found Firebird 5.0.5.1878: /opt/firebird, port 3050, unit firebird, no agent
[install] plan M4: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent new in /opt/hqbird/fbagent-fb50 (unit hqbirdfbagent-fb50), HQ Monitor hqbirdmonitor-fb50
[install] HQbird services to turn off: hqbird
[install] Firebird 5.0.5.1878: unit firebird, port 3050, 0 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1878? Yes/No y- プランには更新される Firebird が示されます。
--fb-rootと--portでそれを移動することはできません(ユニットが取得済みのため)。 - Confirm to stop running Firebird? の質問は、エンジンを停止する
必要があるときに尋ねられます。その前の行に開いている接続が表示されます。
Another versionは、古い HQbird が別バージョンの Firebird を管理して いる場合に尋ねられます(その Firebird を更新するか、その隣に新しいものを インストールします)。--yesはすべての質問に「はい」と答えます。端末がなく--yesもない 場合、インストーラーは終了コード 4 で停止し、何も変更しません。 --disable-hqbirdは古い HQbird のユニットをいずれの場合も停止します。--no-hqbirdは古い HQbird をそのままにします(HQbird 2027 の隣で 実行し続けます)。- SYSDBA パスワードは尋ねられません。エージェントが古い HQbird から 取得します。
- HQ Monitor は古い HQbird のサインインを使用します。そのファイル
/opt/hqbird/conf/access.propertiesは保持されるため、以前に使用した ログインとパスワードでサインインしてください。インストーラーはこの ファイルをモード 0600 でfirebirdに渡します(古い HQbird はすべての ユーザーが読み取り可能なままにしていました)。古い HQbird のゲスト ログイン(access.guest-login)は HQ Monitor では使用されません。
保持されるもの: firebird.conf、databases.conf / aliases.conf、
セキュリティデータベース、SYSDBA パスワード、データベース、バックアップ、
および古い HQbird のファイル。更新は Firebird のプログラムファイルを
その場で置き換えます。置き換えられたファイルは
/opt/fbagent-update-backup/<フォルダー名>-<id>/<時刻>_<旧バージョン>_to_<新バージョン>/
に保持されます(最新の 2 回の更新が残ります)。HQbird のジョブ(バック
アップ、スイープ、監視)は新しいエージェントにインポートされます。古い
HQbird の HQbird ライセンスは移行されません。新しいエージェントは、
ライセンスがインストールされるかサーバーが HQCenter に接続されるまで
トライアルで動作します。
キット 2027.2.33(エージェント 3.4.0)以降、古い HQbird の設定の インポートではさらに 2 つの処理が行われます:
- 古い HQbird のデータベースを Firebird のエイリアスファイル
(
databases.conf、2.5 ではaliases.conf)にname = path行として 登録します。古いファイルは最初にコピーされます。データベースの パスがすでにファイル内にある場合、またはそのファイルが存在しない場合は 除外されます。includeディレクティブを含むファイルは変更されません。 - 古い HQbird の古い監視ログを削除します: その出力フォルダーの
mon/outcomingおよびmon/outtraceフォルダーの内容(フォルダー 自体は残ります)。古い HQbird のサービスが実行中は何も削除されません。 削除は元に戻せません。これらのログが必要な場合は、インストール前に コピーしてください。
どちらもデフォルトで有効です。agent_config.json のキー
hqbird_import.register_databases と hqbird_import.clean_mon_logs
(どちらも HQ Monitor の設定エディターにあります)は、後のインポートで
これらを無効にします。インストーラーにはこれらのオプションはありません。
引き継ぎ前の古い HQbird ユニットの状態は
/opt/hqbird/fbagent-hqbird-takeover.json に保存されます。--uninstall
はそれらを再び有効にしません。
無人実行形式:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbird6. HQbird 2027 の新バージョンへの更新
同じラインの新しいインストーラーを HQbird 2027 がインストールされた ホストで実行すると、インストール済みのインスタンスをその場で更新します: Firebird、デバッグファイル、エージェント、HQ Monitor。設定、データベース、 トライアルまたはライセンスの状態、HQ Monitor のポートとサインインは 保持されます。
sudo sh hqbird2027-fb50-linux-2027.2.9.runテキストインターフェースでは、最初のページに
Plan M10: Update of an installed HQbird 2027、ID (kept) 付きの
エージェントが表示され、Agent id の行はありません。Install で更新が
開始されます。プレーンインストーラーは次を出力します:
[install] HQbird 2027 setup 2027.2.9, Firebird 5.0 (5.0.5.1916)
[install] found Firebird 5.0.5.1880: /opt/firebird, port 3050, unit firebird, agent hqbirdfbagent-p3050
[install] plan M10: Firebird update /opt/firebird (unit firebird, port 3050)
[install] agent in_place in /opt/hqbird/fbagent-p3050 (unit hqbirdfbagent-p3050), HQ Monitor hqbirdmonitor-p3050
[install] Firebird 5.0.5.1880: unit firebird, port 3050, 2 TCP connections
[install] Confirm to stop running Firebird 5.0.5.1880? Yes/No y
...
Firebird updated: 5.0.5.1880 -> 5.0.5.1916
HQ Monitor updated 1.31.0 -> 1.33.0 (...)
Done: agent hqbirdfbagent-p3050 in /opt/hqbird/fbagent-p3050, Firebird 5.0.5.1916 in /opt/firebird (port 3050).更新はエージェントフォルダーとユニットの名前を変更しません。この例の
インスタンスは 2027.2.9 より前にインストールされたため、
fbagent-p3050 のままです。
インストーラーの Firebird ビルドがすでにインストールされているものと
同じ場合(たとえば 2.5 用のすべての HQbird 2027 における
Firebird 2.5.9.27194)、エージェントと HQ Monitor のみが更新されます:
Firebird は停止されず、Confirm to stop の質問もありません。
古い HQbird 2027 でインストールされたインスタンスの保持された
databases.conf には employee エイリアスがない場合があります。
サンプルデータベースにはフルパスで接続してください(セクション 3、
ステップ 4)。Firebird 3.0 では、2027.2.0 からの更新により
/opt/firebird/examples/empbuild/employee.fdb がモード 0444 のままに
なり、Firebird がそれを開けません(no permission for read-write access)。
サンプルデータベースが必要な場合:
sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb。
独自のデータベースは変更されません。
- このラインのインスタンスが複数ある場合は、更新するものを指定します:
--fb-root /opt/fb50-2 --port 3056。 - 同じインストーラーをインストール済みバージョンの上で再度実行すると 修復になります: プログラムファイルとユニットが再書き込みされ、 データはそのまま残ります。
- HQCenter への接続後(セクション 8)、エージェント、HQ Monitor、 Firebird、クラスターコンポーネントは HQCenter カタログから更新されます。 その場合、新しいインストーラーは不要です。
- HQCenter に接続されておらず、エージェント 3.3.0 以降(2027.2.31 以降の
キット)のサーバーは、更新モードが
offでない限り(セクション 4 の 「Updates without HQCenter」)、エージェント、HQ Monitor、fbmcp を 自身で更新します。2027.2.31 より前のインストールでは、新しい インストーラーでの 1 回の更新後にこれが有効になります。インストーラー による更新は更新モードを保持します。--auto-update <mode>で変更 できます。
7. メンテナンスコマンド
すべてのメンテナンス操作は、オプション付きのインストーラーの実行、または
エージェントフォルダー内のエージェントコマンドです。端末では、--yes
なしの実行でこれらのオプションがすでに設定されたテキストインターフェース
が開きます(2027.2.30 以降のキット): 最初のページでプランを確認し、
Install を選択します。
| 操作 | コマンド |
|---|---|
| このラインの別インスタンス | sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50-2 --port 3056 |
| 修復 / 更新 | sudo sh hqbird2027-fb50-linux-<ver>.run(インスタンスが複数ある場合: --fb-root <folder> --port <port>) |
| HQCenter への接続 | インストール中に sudo sh hqbird2027-fb50-linux-<ver>.run --attach attach.json、または後で cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /path/attach.json |
| トライアルメールの送信 | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email [email protected] --accept-privacy |
| メールのトライアルコードの確認 | cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-confirm <code>(または HQ Monitor で) |
| ライセンスファイルのインストール | インストール中に --license <file>、または cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --license-install /path/license.json |
| インストールの状態 | sudo /opt/hqbird/fbagent-fb50/fbagent --install-state --json |
| 更新の状態(HQCenter なし) | sudo /opt/hqbird/fbagent-fb50/fbagent --update-status |
| 更新モードの変更(HQCenter なし) | HQ Monitor の Updates ページ、または sudo sh hqbird2027-fb50-linux-<ver>.run --auto-update all|agent|off |
| 削除 | sudo sh hqbird2027-fb50-linux-<ver>.run --uninstall [--remove-data] [--force] [--agent-dir /opt/hqbird/fbagent-fb50] |
別のインスタンス
sudo sh hqbird2027-fb50-linux-2027.2.9.run --fb-root /opt/fb50-2 --port 3056新しい Firebird は /opt/fb50-2(新規または空のフォルダ)にインストールされ、ユニット
firebird.opt_fb50-2、専用のエージェント(/opt/hqbird/fbagent-fb50-2、ユニット
hqbirdfbagent-fb50-2)、専用の HQ Monitor(http://localhost:23056/、
ユニット hqbirdmonitor-fb50-2)を持ちます。エージェントにはそのラインで最も小さい
空き番号が割り当てられます。2 番目のインスタンスなら fb50-2 となり、2027.2.9 より前に
インストールされたエージェント(fbagent-p3050)が存在する場合もその次の番号になります。
HQ Monitor のサインインファイル /opt/hqbird/conf/access.properties はホストの
インスタンス間で共有されます。--hqmonitor-login を指定しない新しいインスタンスは
既存のサインインを引き継ぎ、いずれかのインスタンスで
--hqmonitor-login/--hqmonitor-password-file を指定すると、すべてのインスタンスの
サインインが変更されます(古いファイルは access.properties.bak-<time> として
保持されます)。Firebird 2.5 は 2 番目のインスタンスをサポートしません。インストーラーは
refused (M17): Firebird 2.5 works only in /opt/firebird, not in <folder> で停止します
(終了コード 1、変更なし)。別のラインの Firebird をその隣にインストールしてください。
例: sudo sh hqbird2027-fb50-linux-<ver>.run --fb-root /opt/fb50 --port 3051。
削除
Windows と Linux での削除、クラスタ内のサーバー、ディスクに残るものについては 削除ガイド で詳しく説明しています。要約すると:
# the agent and HQ Monitor of this instance; Firebird, the databases, configs and logs stay
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
# the same, and the agent's configuration, logs, license state and HQ Monitor data too
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-data--agent-dir を指定しない場合、インストーラーは /opt/hqbird 内の唯一のエージェントを
削除します。ホスト上に複数のエージェントがある場合は停止し(終了コード 1)、
それらのフォルダを一覧表示して --agent-dir を要求します:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --agent-dir /opt/hqbird/fbagent-fb50-2--uninstall はエージェントとその HQ Monitor のユニット
(hqbirdfbagent-fb50、hqbirdmonitor-fb50)、エージェントとそのプログラム
(fbagent、hqmonitor)の sudoers ルールを停止・削除し、インストール時に
firewalld または ufw で開いた HQ Monitor のポートを閉じます。エージェントの
フォルダは設定とログとともに残ります。--remove-data はフォルダと
/var/lib/hqmonitor/ 内の HQ Monitor データも削除します。Firebird はインストール
されたまま残ります(ユニット、プログラムフォルダ、データベース)。無効化された
古い HQbird ユニットは無効のまま残ります。ホスト上に複数のエージェントがある場合、
共有の HQ Monitor サインインファイルは最後のエージェントが削除されるまで残ります。
エージェントがホストの RCM を実行していて、他のエージェントがその RCM を使用している場合、
--uninstall は終了コード 5 で拒否し、何も変更しません:
this agent runs the RCM of the host, and other agents use it: remove the cluster in the RCM console, or run again with --force。--force を指定すると
エージェントは強制的に削除されます。その場合クラスタは CA を失います(新しい証明書も
新しいメンバーも作成できません)。RCM ユニットは、ホストの他のエージェントが使用して
いる間は残ります。古い所有者がいなくなったときに別のエージェントを新しい RCM の所有者に
するには: fbagent --cluster-init <id> --rcm-takeover(新しい CA になります。メンバーを
再度リンクしてください)。
インストール終了時のヒント(Uninstall: sudo sh ... --uninstall)には
--agent-dir が含まれていません。複数のインスタンスがある場合は上記のように追加して
ください。
インスタンスの Firebird も削除するには(インストーラーはこれを行いません。先にその
データベースの gbak バックアップを作成してください)、例えば /opt/fb50-2 の
Firebird の場合:
B=/opt/fb50-2
U=firebird.$(echo ${B#/} | tr / _) # /opt/fb50-2 -> firebird.opt_fb50-2
systemctl list-unit-files "$U*" # the units that will be removed
sudo systemctl disable --now $(systemctl list-unit-files "$U*" --no-legend | awk '$1 !~ /@/ {print $1}')
sudo rm -f /usr/lib/systemd/system/$U* /etc/systemd/system/$U*
sudo systemctl daemon-reload
sudo rm -rf $B8. HQCenter への接続
HQCenter は、HQbird エージェント(ライセンス、設定、更新、バックアップの概要)を管理する 会社の中央サーバーです。HQCenter がない場合、エージェントはインストーラーおよび トライアルまたはライセンスファイルのバージョンで単独で動作します。
- HQCenter の管理パネルで Tokens
(
https://<hqcenter>:8443/admin/tokens)を開きます。Install script フォームで ライセンス(またはなし)、モード、サーバー数、有効期間(1〜365 日)を選択します。 プラットフォームと Firebird のフィールドは使用されません。 Download connection file をクリックしてattach.jsonを保存します。このファイルには シークレットトークンが含まれています: 安全に保管し(chmod 600)、使用後に削除し、 同じページの一覧でトークンを取り消してください。このフォームはadmin_panel.install_script_urlが設定されている場合にのみ表示されます。 attach.jsonをサーバーにコピーします。- 次のいずれかの方法で接続します:
# during the installation
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --attach /root/attach.json
# later, for an installed agent
cd /opt/hqbird/fbagent-fb50 && sudo ./fbagent --attach --file /root/attach.json通常のトークンの場合、コマンドは HQCenter の管理者がリクエストを承認するまで待機します (最大 30 分)。ライセンストークンの場合、エージェントは即座に接続され、ライセンスを 取得します。接続後、HQCenter がエージェントにライセンスを付与するとトライアルは終了し、 その後エージェント、HQ Monitor、Firebird、クラスタコンポーネントは HQCenter のカタログ から更新されます。インストール中の接続失敗はインストールを取り消しません。その旨が サマリーに表示され、上記のコマンドで再実行できます。
要件: HQCenter(goafts)1.15.0 以降(古いバージョンには接続ファイルのボタンがありません)。 サーバーは接続時に HQCenter のブートストラップポートに一度到達し、その後はエージェントの ポート(デフォルトでは 443)に到達する必要があります。HQCenter はインターネットなしでも 動作します。同じサーバーを同じ HQCenter に 2 回目に接続する場合は、ライセンストークンが あっても管理者の承認が必要です。
9. 無人インストールとスクリプト
すべてのオプションはターミナルでも動作します。無人実行には --yes が必要です(プランの
質問に回答します。ターミナルがなく --yes もない場合、インストーラーは終了コード 4 で
停止します)。--yes はテキストインターフェースを決して開きません。ターミナルで
インストーラーを起動し、その質問に自分で回答するスクリプト(例えば expect を使用)は、
--no-tui を追加するか HQBIRD_NO_TUI=1 を設定する必要があります。2027.2.30 以降の
キットはそこでページを開きます。終了コードが結果を示します。詳細はターミナルと
/var/log/fbagent/install.log にあります。
オプション
| オプション | 意味 | デフォルト |
|---|---|---|
--fb-root DIR |
新しい Firebird のフォルダ(新規または空)、または更新する Firebird のフォルダ | /opt/firebird、次に /opt/fb<NN> |
--port N |
Firebird のポート | 最初の Firebird は 3050。別のラインの場合はそのラインのポート(3.0 は 3053、4.0 は 3054、5.0 は 3055) |
--sysdba-pass-file F、--sysdba-pass P |
新しい Firebird の SYSDBA パスワード(F の最初の行。P は 0600 のファイルに書き込まれます) |
生成され、/root/fbagent-install-sysdba.txt に保存されます。ホスト上の追加の Firebird はそのファイルからパスワードを取得します |
--agent-id ID |
新しいエージェントの agent.id。最初のインストール時のみ。インストール済みのエージェントはその id を保持します(セクション 3 の「The agent id」) |
ホスト名 + 日付 + インスタンス |
--hqmonitor-port N |
HQ Monitor のポート | 20000 + Firebird のポート |
--hqmonitor-login L --hqmonitor-password-file F |
HQ Monitor のサインイン。ホストのすべてのインスタンスで共有され、1 つのインスタンスで指定するとすべてのサインインが変更されます | admin + 生成されたパスワード。更新または追加のインスタンスは既存のサインインを保持します |
--email ADDR --accept-privacy [--trial-zone RU|EU|BR] |
トライアル用メールアドレス(30 日間)。アドレスはベンダーのトライアルサーバーに送信されます | なし |
--auto-update all|agent|off |
HQCenter に接続していないサーバーの更新(2027.2.31 以降のキット): agent = エージェント、HQ Monitor、fbmcp が自動更新され、Firebird パッケージは手動を待ちます。all = Firebird もそのウィンドウで更新されます。off = 更新チェックなし(セクション 4 の「Updates without HQCenter」) |
モードは変更されません。新しいエージェントは agent です |
| --license F | インストールするライセンスファイル | なし |
| --attach F | HQCenter にアタッチする (attach.json) | なし |
| --no-hqbird, --disable-hqbird | 古い HQbird をそのまま残す / そのすべてのユニットを停止する | 自動 |
| --no-debug | Firebird のデバッグファイルをインストールしない | インストールされる |
| --no-fbmcp | fbmcp (AI クライアント用の MCP サーバー) をインストールせず、このホストの fbmcp も変更しない | インストールされる |
| --fbmcp-allow-from A,B | これらの管理者アドレス (IP または CIDR) に対して fbmcp のリモートモードを有効にする | ローカルのみ |
| --fbmcp-port N, --fbmcp-dns NAME,..., --fbmcp-ip ADDR | fbmcp のリモートポート; 証明書の追加名; 証明書とリスナーのアドレス | ポート 8650 |
| --rcm on\|off | このホストにクラスタコンソール RCM をインストールし、新しいクラスタを作成する (エージェント 3.1.0 以降) | 確認あり; いいえ |
| --rcm-password-file F | --rcm on と共に使用する RCM 管理者パスワード (F の最初の行) | 生成され、最後に表示される |
| --cluster-id ID | --rcm on と共に使用するクラスタ ID | ホスト名 |
| --cluster-pairing on\|off | ディスカバリモード: 24 時間のペアリングウィンドウ、RCM がこのエージェントを招待できる | 確認あり; いいえ |
| --rcm-allow A,B,... | ディスカバリモードでこのホストを招待できるのはこれらの RCM のみ (IP、CIDR またはホスト名) | 任意の RCM |
| --pairing-port N | 新しいエージェントのペアリングポート 7450–7459; スロットを選択する (ノードポート 7051+k、7061+k)。後でセットアップしてもスロットは維持される | 最初の空きスロット |
| --cluster-node on\|off | クラスタノードサービスをエージェントのキャッシュに入れる | on |
| --yes | プランの質問に「はい」と答える (クラスタの質問には「いいえ」) | 確認あり |
| --check | チェック、ライブラリ、プランのみ; 何も変更されない | — |
| --plan-help | プランのコード (M1、M2、…) の意味を表示して終了する | — |
| --no-tui | テキストインターフェースなしのプレーンインストーラー; 変数 HQBIRD_NO_TUI=1 も同様 (セクション 3 の「The plain installer」) | ターミナルではテキストインターフェース |
| --lang en\|ru\|pt-BR\|de | インストーラーの言語; 変数 HQBIRD_LANG も同様 (セクション 3 の「Language of the installer」) | コンソールの UTF-8 ロケール、なければ英語 |
| --tmpdir DIR | ここに展開する (プログラムを実行できるフォルダー) | /var/tmp |
| --extract DIR | ペイロードを DIR/payload に展開するだけで終了する | — |
| --uninstall [--remove-data] [--force] [--agent-dir DIR] | エージェントと HQ Monitor を削除する (Firebird は残る); --force は、他のエージェントが使用しているホストの RCM を実行しているエージェントも削除する | — |
オプションは --port 3055 または --port=3055 のように記述できます。相対パスは
現在のフォルダーから解決されます。
例
デフォルトでの新規インストール:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes
echo "exit code $?"選択したフォルダーとポートへの新規インストール、ファイルからの SYSDBA パスワードと HQ Monitor サインイン付き:
umask 077
printf '%s\n' 'S3cret-Sysdba' > /root/sysdba.txt
printf '%s\n' 'S3cret-Monitor' > /root/hqm.txt
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--fb-root /opt/firebird --port 3050 \
--sysdba-pass-file /root/sysdba.txt \
--hqmonitor-port 24000 --hqmonitor-login ops --hqmonitor-password-file /root/hqm.txt
rm -f /root/sysdba.txt /root/hqm.txtトライアルメール、ライセンスファイル、アタッチファイル付きの新規インストール:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes \
--email [email protected] --accept-privacy --trial-zone EU \
--license /root/hqbird-license.json \
--attach /root/attach.json古い HQbird の更新、古い HQbird のすべてのユニットを停止:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --disable-hqbirdHQbird 2027 を新しいバージョンに更新 (1 インスタンス; 複数の場合は
--fb-root と --port を追加):
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yesポート 3056 での 2 つ目の Firebird 5.0 インスタンス:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --yes --fb-root /opt/fb50-2 --port 3056削除:
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall
sudo sh hqbird2027-fb50-linux-2027.2.9.run --uninstall --remove-dataインストール失敗時に停止するスクリプト:
#!/bin/sh
set -e
sh hqbird2027-fb50-linux-2027.2.9.run --yes || {
rc=$?
echo "HQbird setup failed with code $rc, see /var/log/fbagent/install.log" >&2
exit $rc
}
echo "HQbird 2027 installed"インターネットのないサーバー: OS ライブラリ
各ラインの Firebird は、OS からこれらのライブラリを必要とします (glibc の他に):
| ライン | パッケージ (Debian/Ubuntu) | パッケージ (RHEL 系) |
|---|---|---|
| 5.0 | libtommath1, libicu<NN>, libgssapi-krb5-2 |
libtommath (EPEL), libicu, krb5-libs |
| 4.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 3.0 | libtommath1, libicu<NN> |
libtommath (EPEL), libicu |
| 2.5 | 通常は何も不要 (libstdc++6 はベースシステムに含まれる) |
通常は何も不要 |
ライン 3.0、4.0、5.0 の 2027.2.30 以降のキットは、Firebird のインストールスクリプトが
使用するプログラム colrm も必要とします: パッケージ bsdextrautils
(古い Debian と Ubuntu では bsdmainutils)。最小構成の Debian には含まれません;
RHEL 系では常に存在する util-linux に含まれます。
パッケージが不足していてリポジトリに到達できない場合、インストーラーは 終了コード 6 で停止し、何も変更されません:
[install] ERROR: no access to the package repository, or a package is not there; nothing was changed.
[install] Missing: libtommath1
[install] Install them, then run this file again:
[install] apt-get install -y libtommath1
[install] On a server without internet: on a PC with the same Ubuntu 24.04.5 LTS
[install] apt-get download libtommath1
[install] copy the .deb files here and run: apt-get install -y ./*.debRHEL 系では libtommath は EPEL にあります: リポジトリに到達できる場合、
インストーラーは epel-release を自動的に追加します。到達できない場合、コマンドは
dnf install -y epel-release、dnf download --resolve <packages>、dnf install -y ./*.rpm です。--check は同じリストを事前に表示するので、
インストールの時間枠の前にパッケージを準備できます。
終了コード
| コード | 意味 | ホスト上の変更 |
|---|---|---|
| 0 | 完了 (トライアルメール、アタッチ、ライセンスに関する警告はサマリーに表示される) | あり |
| 1 | 拒否: ホスト、オプション、ファイル、またはプラン (理由が表示される)。また: テキストインターフェースでの終了 | なし |
| 2 | インストールが失敗し、ロールバックされた。また: インストーラーがシグナル (Ctrl+C) で停止された | ロールバック済み; インストール前に停止した場合はなし |
| 3 | インストールが失敗し、ロールバックが完全でなかった (確認すべき内容はサマリーに表示される) | 一部 |
| 4 | プランの質問が確認されなかった (ターミナルなし、--yes なし)。 |
なし |
| 5 | ペイロードがチェック (sha256、署名) に合格しなかった: ファイルを再度ダウンロードしてください。--uninstall の場合: 拒否、エージェントがホストの RCM を実行しており、他のエージェントがそれを使用している (セクション 7) |
なし |
| 6 | OS ライブラリが不足しており、パッケージリポジトリに到達できない | なし |
| 7 | ディストリビューションのパッケージからの Firebird がインストールされている | なし |
10. トラブルシューティング
| 問題 | 対処方法 |
|---|---|
run as root (sudo sh ...) |
インストーラーを sudo または root として実行してください |
| テキストインターフェースのページが開かない | 最初の行に理由が表示されます: needs a window of 80x24 or larger (ウィンドウを大きくしてください; ステータス行のある tmux は 1 行を消費します) または needs bash 4.4 or newer。その後に実行されるプレーンインストーラーが同じインストールを行います |
| ページの文字化けや行の崩れ | ターミナルを UTF-8 に設定するか、--lang en で実行してください; --no-tui はプレーンインストーラーを実行します |
/var/tmp is mounted noexec |
--tmpdir /root で再度実行してください (プログラムを実行できる任意のフォルダー) |
is damaged or cut (終了コード 5) |
.run ファイルを再度コピーし、その sha256sum を公開された値と比較してください |
| 終了コード 6、ライブラリ不足 | 表示されたとおりにパッケージを準備し (セクション 9)、インストーラーを再度実行してください |
| 終了コード 7、ディストリビューションのパッケージからの Firebird | パッケージを削除する (apt-get remove firebird3.0-server、gbak バックアップは保持) か、--import-firebird を付けてオンラインインストーラーを使用してください |
| refused (M17): Firebird 2.5 works only in /opt/firebird | 2つ目の Firebird 2.5 は使用できません。別のラインを横にインストールしてください(セクション 7) |
| --uninstall が拒否されました(終了コード 1)、複数のエージェントが存在する場合 | 一覧のフォルダを指定して --agent-dir を追加してください。例: --agent-dir /opt/hqbird/fbagent-fb50-2 |
| --uninstall が拒否されました(終了コード 5): this agent runs the RCM of the host | まず RCM コンソールでクラスタを削除するか、--force を付けて再実行してください(セクション 7) |
| 更新後(3.0)に employee.fdb への no permission for read-write access | sudo chmod 660 /opt/firebird/examples/empbuild/employee.fdb(セクション 6) |
| refused (M14): the folder is not empty | --fb-root で空のフォルダまたは新しいフォルダを指定するか、更新する Firebird を指定してください |
| 終了コード 2 または 3 | /var/log/fbagent/install.log を確認してください。ユニットは実行前の状態に戻っている(コード 2)か、確認が必要です(コード 3) |
| HQ Monitor が開かない | systemctl status hqbirdmonitor-fb50(2027.2.9 より前は hqbirdmonitor-p<port>)を実行してください。ポートを他に何もリッスンしていないことを確認し、ファイアウォールでポートを開放してください。別のポートには --hqmonitor-port を使用してください |
| HQ Monitor のパスワードを紛失した | --hqmonitor-login admin --hqmonitor-password-file <file> を付けてインストーラを再実行(修復)してください。古い /opt/hqbird/conf/access.properties は access.properties.bak-<time> として保持されます。新しいサインイン情報はホストのすべてのインスタンスに適用されます |
| トライアルメールが送信されなかった(ネットワークなし) | 後で送信してください: cd /opt/hqbird/fbagent-fb50 && sudo -u firebird ./fbagent --trial-email <address> --accept-privacy |
| SELinux(AlmaLinux、RHEL) | enforcing モードでサポートされています。インストーラは書き込むファイルのコンテキストを復元するため、何もする必要はありません |