HQbird 2027の新機能
この文書は HQbird 2027 の変更を、新しいものから順に記します。各部はリリースの番号とその日付で始まります。新しいリリースはその部を先頭に加え、それより下の部はこれまでどおり残します。
- 2027.2.34 以降: リリースごとに 1 つの部があります。
- 2027.2.33: そのリリース時点の HQbird 2027 全体を、HQbird 2024 と比べたものです。
- 2027.2.8 から 2027.2.33 までの各キットの記録は、ダウンロードサイトの hqbird2027-whats-new-2027.2.8-2027.2.33.md にあります。
インストーラ: HQbird 2027 のダウンロード。
ダウンロード: https://ib-aid.com/download/hqbird/v2027/
(Firebird 2.5、3.0、4.0、5.0 向けの Windows セットアップ .exe と Linux .run。チェックサムは SHA256SUMS にあります)。
Docker イメージ: ghcr.io/ibsurgeon/hqbird2027-fb25、-fb30、-fb40、-fb50。
2027.2.35 (2026-11-18)
バージョン
| コンポーネント | バージョン | 変更 |
|---|---|---|
| HQbird エージェント(fbagent、enroll) | 3.6.0 | はい |
| HQbird Monitor | 1.59.0 | はい |
| 設定エディタ(HQbird Monitor 内) | 1.63.0 | はい |
| HQbird RCM | 2027.5.13 | はい |
| HQCluster ノード | 2027.5.13 | はい |
| fbmcp(Firebird 用 MCP サーバ) | 2027.2.24 | いいえ |
| Firebird | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 | いいえ |
クラスタ: マスタデータベースのバックアップとリストアのあとの再初期化
- マスタデータベースのバックアップとリストア(gbak)は、そのデータベースに新しい GUID を与えます。レプリカは、そのジャーナルをもう適用できません。ノードはこれを数秒で見つけ、これまでどおり各レプリカへの配送を一時停止し(理由は
master_db_replaced)、マスタをNEEDS_REINITに設定します。 - 新機能: RCM は、
rcm.jsonの設定auto_reinit.on_master_restore(設定ページにもあります)に従い、次に何をするかを決めます。auto: RCM は 300 秒待ったあと(auto_reinit.master_restore_settle_sec)、そのデータベースのすべてのレプリカを自ら再初期化します。window: RCM は、自動再初期化ウィンドウでそのレプリカを再初期化します。propose: RCM は何も始めず、オペレーターを待ちます。
- この設定がない場合、動作は変わりません。自動再初期化がオンなら
window、オフならproposeです。 - データベースページにあるマスタデータベースの行は、何が起きたかと、RCM が何をするかを示します。新しいボタンすべてのレプリカを今すぐ再初期化は、すべてのレプリカの再初期化を順に 1 つずつ始めます。スヌーズは再初期化を保留します。
- ノードは、データベースファイルの置き換えであれば、どれにも反応します。手作業のリストアでも、エージェントのバックアップとリストアのサイクルでも同じです。確認したのは Firebird 2.5、3.0、5.0 です。アラート
master_db_replacedは RCM の通知チャネルへ届きます。
クラスタ: HQbird 2024(FBDataGuard)のレプリケーションが RCM へ移る
- HQbird 2024 から更新したサーバでは、エージェントが FBDataGuard のレプリケーション設定(ロール、ジャーナルとアーカイブのフォルダ、レプリカの宛先)を読み、RCM に渡します。
- RCM はレプリカのホストを自らリンクします。リンクできないホストは、ホストをリンクのページに候補として表示されます。
- そのあと RCM は、データベースのレプリケーションをあるがまま引き継ぎます。レプリカを再初期化せず、Firebird を再起動せず、ファイルを削除しません。FBDataGuard がまだ動作しているあいだは待ちます。
- 設定 → FBDataGuard からインポートのページは、インポートの状態を表示し、インポートを繰り返します。コマンドラインには
hqbirdrcm dg-import statusとhqbirdrcm dg-import retryがあります。 - ノードは、FBDataGuard が
replication.confに書いたブロックと、.uploadedに名前を変えたジャーナルセグメントを読みます。 - このインポートは Linux サーバで確認しました。
RCM: データベースページ
- 公開がオンのマスタデータベースの行は、公開に入っているテーブルの数と、オペレーターが外した数を示します。たとえば
publication on · tables: 118 · taken out: 2です。
インストーラ: 最初の RCM パスワード
- RCM を含むインストールのあと、Linux のインストーラは、生成した
rcmadminのパスワードを、そのファイルのパスとともにターミナルに表示します。Windows のセットアップは、結果ページに表示します。 - パスワードを表示するのはターミナルだけです。ログ、パイプ、インストール結果のファイルには書きません。
HQbird Monitor: 範囲の時刻
- 時間範囲の時刻フィールド(ダッシュボード、データベースページ、ログ、エラー)は、一覧に代わって、時と分を入力するフィールド 2 つです。上下の矢印は値を 1 ずつ変え、
:は時から分へ移り、短い一覧は 15 分刻みを示します。
HQbird Monitor の設定エディタ
- タイムスタンプは正確な時刻です。経過時間(「23 分前」)はツールチップにあります。
- バックアップジョブの結果パネルにサイズの行があります。その実行のバックアップファイルと、テストリストアが作ったデータベースです。
- エージェントの設定ページは、スマートフォンと 1280 px の画面に収まります。タブの行は折り返します。設定は、項目を横にスクロールする 1 行として表示します。ジョブとバックアップの表は、1280 px では横にスクロールしなくなりました。
修正
- HQbird 2024 から更新したサーバでは、クラスタを構成したあと HQbird 3.0 が起動しませんでした(“Incorrect version of replication config file”)。Firebird が
pluginsフォルダから、レプリケーションプラグインの古いコピーを読み込んだためです。今は、そのコピーをそのフォルダの外に置きます。 - ノードは、
limits.rescan_interval_secの変更を再起動なしで適用します。
アップグレード
- 2027.2.35 の Windows セットアップ、または Linux の
.runでインストールまたは更新します。自動更新のあるサーバは、エージェント 3.6.0 と HQbird Monitor 1.59.0 を自ら取得します。 - クラスタでは、RCM をノードより先に、または同時に更新してください。RCM 2027.5.13 は古いノードでも動作します。FBDataGuard からのインポートには、ノード 2027.5.13 が必要です。
- クラスタのマスタデータベースで、スケジュールしたバックアップとリストアのサイクルを行うときは、
auto_reinit.on_master_restoreをautoにします。そうしないと、サイクルのあと、オペレーターが再初期化を始めるまで、レプリカに変更は届きません。 - Docker: 2027.2.35 のイメージを pull し、同じボリュームで新しいコンテナを起動します。
2027.2.34 (2026-11-17)
バージョン
| コンポーネント | バージョン | 変更 |
|---|---|---|
| HQbird エージェント(fbagent、enroll) | 3.5.0 | はい |
| HQbird Monitor | 1.58.0 | はい |
| 設定エディタ(HQbird Monitor 内) | 1.62.0 | はい |
| fbmcp(Firebird 用 MCP サーバ) | 2027.2.24 | いいえ |
| HQbird RCM | 2027.5.12 | いいえ |
| HQCluster ノード | 2027.5.12 | いいえ |
| Firebird | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 | いいえ |
gbak ジョブのログをすべて残す
- 以前は、エージェントが 16 MiB を超える gbak ログの途中を削っていました。今は、バックアップまたはリストアのジョブの各フェーズのログが、gbak が表示した内容をすべて収めた 1 つの
.log.zipアーカイブになります。 - アーカイブのそばに、エージェントは出力とエラーの末尾 100 行を収めた小さなテキストファイルを残します。
- 設定エディタのログをダウンロードは、そのアーカイブを保存します。ジョブのログ行とリストア履歴にある新しいボタン末尾の行は、ダウンロードせずにログの末尾を表示します。
- 30 MB を超えるアーカイブは HQCenter へ送りません。その行にはサーバだけに保管とあり、ログをダウンロードはサーバ上のアーカイブのパスを示します。末尾の行は引き続き送ります。
- 以前のバージョンが書いたログ(
.log.gz)は残し、これまでどおりダウンロードできます。
スマートフォンでの HQbird Monitor
- 幅が 768 px 以下の画面では、ヘッダーは 1 行です。戻る矢印、サーバ名、メニューボタンです。ボタンを押すと、サーバメニュー、設定、言語、ログアウトがパネルで開きます。以前のヘッダーは 3 行を使い、7 つのメニュー項目のうち 4 つを表示していました。
- 時間範囲はボタン 1 つです。日付、区間、プリセットがパネルで開きます。ログ、エラー、競合の「含める」フィルタと「除外」フィルタは、フィルターボタンの下に折りたたまれます。
- 幅が 600 px 以下の画面では、サーバ、ダッシュボードのデータベース、エラー、ログレコードがカードになります。横方向のスクロールはありません。
- ボタンとフィールドの高さは少なくとも 44 px で、フィールドの文字は 16 px です。そのため iPhone の Safari は、フィールドをタップしてもページを拡大しません。
HQbird Monitor のデータベースページ
- データベースのページはサーバメニューを残します。ログ、設定、エラー、競合、パフォーマンスレポート、ジョブ、バックアップへは、クリック 1 回で移動できます。以前はデータベースの項目がサーバメニューの位置に入っていました。
- データベースの項目(データベース、メトリクス、クライアントのバージョン、統計、パフォーマンスレポート)は、ヘッダーの下で 1 行に並びます。行はDBラベルとデータベース名から始まり、スクロールしてもその位置を保ちます。
- データベース名をクリックすると、そのサーバのデータベースが見えます。それぞれの名前、パス、サイズです。別のデータベースは、同じページ、同じ日、同じ時間範囲で開きます。データベースが 8 個以上になると、一覧に検索フィールドが付きます。
- パフォーマンスレポートは、データベースの一覧でそのデータベースが選ばれているあいだ、そのデータベースの行を表示します。
- データベースページで、ダッシュボードへのリンクはロゴではなくサーバ名です。
- ユーザーガイド(英語とブラジルポルトガル語)を更新し、新しい図を入れました。
Linux インストーラ
- ALT Linux。クリーンな ALT 11 では、Firebird 3.0、4.0、5.0 向けのキットがコード 6 で止まっていました。インストーラが Debian のパッケージ名を求めていたためです。インストーラは今、ALT Linux を認識し、正しいパッケージをインストールします。
sudoを使えるグループが 1 つだけの場合。sudoを実行できるのが 1 つのグループだけであるシステム(ALT Linux ではグループwheel)では、インストールがロールバックしていました。インストーラは今、エージェントのアカウントをそのグループに追加し、そのことを表示します。そのグループがパスワードなしですべてのコマンドを実行できる場合、または root だけがsudoを実行できる場合は、理由を示して停止します。- 失敗したインストールは何も残しません。ロールバックは今、削除されたフォルダから動作してポートを占有していた Firebird サービスを止め、エージェントのフォルダとその sudoers ファイルを削除します。次の試行は何もない状態から始まります。
- SELinux。AlmaLinux 8 では HQbird Monitor がインストールされていませんでした。ユニットファイルの SELinux ラベルが誤っていたためです。インストーラは今、そのラベルを設定します。
Docker イメージ
- クラスタルータ(HAProxy)がコンテナ内で起動するようになりました。以前は、イメージ内でルータサービスが起動していませんでした。
- 古いコンテナのボリュームを使う新しいコンテナは、そのボリューム上にルータがあっても、再起動の繰り返しで止まらなくなりました。
修正
- スマートフォンの HQbird Monitor: 設定エディタを持たないエージェントのサーバに、ジョブとバックアップの項目が出ていました。
アップグレード
- 2027.2.34 の Windows セットアップ、または Linux の
.runでインストールまたは更新します。自動更新のあるサーバは、エージェント 3.5.0 と HQbird Monitor 1.58.0 を自ら取得します。 - エージェントの新しい
.log.zipログを HQCenter がダウンロードするには、HQbird Monitor 1.58.0 が必要です。HQCenter をエージェントより先に、または同時に更新してください。 - HQbird Monitor の前段にあり、応答のコンテンツタイプを絞り込むプロキシは、
api/joblogでapplication/zipを許可する必要があります。 - Docker: 2027.2.34 のイメージを pull し、同じボリュームで新しいコンテナを起動します。
2027.2.33 (2026-11-16): HQbird 2024 と比べた HQbird 2027
ソースコードの状態は 2026-11-16 時点のものです。リリースされたキットは 2027.2.33(2026-11-16)でした。この部は、HQbird 2024 に対する全体像です。
1. 概要
- Java ツールの FBDataGuard は置き換えられました。その仕事は今、サービス fbagent と、Web コンソール HQbird Monitor が行います。
- 新機能: HQbird Cluster。クラスタマネージャ(RCM)と各サーバ上のノードにより、Web ページからのレプリカ設定、スイッチオーバー、フェイルオーバー、再参加ができます。
- 新機能: HQCenter。多数の HQbird サーバのための、自分用の中央サーバです。コンソールは 1 つで、設定の配信、更新、ライセンス、問題の監視を行います。
- 新機能: fbmcp。AI アシスタントが Firebird の DBA として作業できる MCP サーバです。重大な変更には、AI クライアントの外にいる人の承認が必要です。
- 新しいインストーラ。Firebird のメジャーバージョンごとにオフラインのセットアップが 1 つあり、Windows(
.exe)と Linux(.run)向けです。1 台のサーバに、複数の Firebird メジャーバージョンと複数のインスタンスを置けます。メジャーバージョンごとの Docker イメージもあります。 - 新しいライセンス。署名付きライセンスファイル、登録なしの 7 日間の試用、ライセンスゾーン EU / RU / BR。
- エージェント、HQbird Monitor、fbmcp、クラスタのプログラム、Firebird の自動更新。署名の検査とロールバックがあります。
- エンジン。NGRAM インデックス、マテリアライズドビュー、
CREATE INDEX CONCURRENTLY、CREATE TABLE AS SELECT、高度なトレースオプション、データベースごとの接続数の上限、Linux での Active Directory ログイン。
2. コンポーネント: 2024 と 2027
| HQbird 2024 | HQbird 2027 |
|---|---|
| FBDataGuard(Java、ポート 8082 の Web コンソール) | fbagent(サービス)+ HQbird Monitor(Web コンソール)+ Monitor 内の設定エディタ |
| Advanced Monitoring Viewer(AMV)、デスクトップツール | HQbird Monitor のページ: ダッシュボード、パフォーマンスレポート、エラー、競合、統計 |
| 手作業または FBDataGuard で行うレプリケーション設定、手動フェイルオーバー | HQbird Cluster: RCM + ノード、スイッチオーバー、フェイルオーバー、ルータ |
| 中央サーバはない | サーバ群のための HQCenter(Linux) |
| AI ツールはない | 約 120 のツールを持つ MCP サーバ、fbmcp |
| コンポーネント入りの Windows セットアップ 1 つと、Linux スクリプト | Firebird のメジャーバージョンごとのオフラインセットアップ、.exe と .run、Docker イメージ |
| メールアドレスとパスワードによるアクティベーション | 署名付きライセンスファイル、試用、ライセンスゾーン |
| FBDataGuard からのメールアラート | HQCenter の状態監視からのメール。エージェントからの Telegram、ウェブフック、メール |
3. バージョン
| コンポーネント | キット 2027.2.33 のバージョン |
|---|---|
| Firebird(HQbird ビルド) | 2.5.9.27194, 3.0.15.33893, 4.0.8.3332, 5.0.5.1917 |
| fbagent | 3.4.0 |
| HQbird Monitor | 1.57.0 |
| 設定エディタ(Monitor 内) | 1.61.0 |
| HQbird RCM / クラスタノード | 2027.5.12 |
| fbmcp | 2027.2.24 |
| HQCenter(goafts、site stack) | 1.22.0 |
| fblogspacker(fbagent 内) | 1.5.12 |
4. Firebird エンジン(HQbird ビルド)
HQbird の Firebird ビルドには、同じバージョンの vanilla Firebird にはないサーバレベルの機能(プラグインとコアの変更)があります。表は各機能と、それを持つ Firebird のメジャーバージョンを示します。出典は HQbird 2027 のサーバレベルの改善 です。
| 機能 | 得られるもの | パラメータ | メジャーバージョン |
|---|---|---|---|
| NGRAM インデックス | VARCHAR とテキスト BLOB に対する、インデックスを使う部分文字列検索(LIKE '%search%') |
- | 5.0 |
| マテリアライズドビュー | BI と複雑なクエリのための CREATE MATERIALIZED VIEW。バルク挿入を使います |
- | 5.0 |
| クエリ結果としてのテーブル | CREATE TABLE AS SELECT。バルク挿入を使います |
- | 5.0 |
| 負荷がかかった状態でのインデックス作成 | CREATE INDEX ... CONCURRENTLY: テーブルは利用できるままです |
- | 5.0 |
| 高速な MON$ テーブル | 不要なデータの収集を止めます | FillMonCompiledStatements, FillMonStatements, FillMonCallStack |
5.0 |
| 5.0 への移行を容易にする仕組み | 旧形式のリテラルを認識します。古いアプリケーション向けに COUNT(*) を INT として記述します |
LegacyTimeLiterals, LegacyIntForCount |
5.0 |
| GSSAPI/SSPI 認証 | Active Directory 用の gssauth プラグイン。Windows と Linux のサーバおよびクライアント |
- | 5.0 |
| INET エラーを記録しない | ネットワークエラーを firebird.log に書きません |
DisableLogNetIOErrors |
5.0 |
| 軽量モニタリング | 負荷をかけずにサーバの状態を追跡します | MonitoringPlugin |
2.5, 3.0, 4.0, 5.0 |
| データベースへの接続数の上限 | 接続の急増から守ります | WarnCountAttachments, MaxCountAttachments |
3.0, 4.0, 5.0 |
| 高度なトレースオプション | 競合(デッドロック)と変更(たとえば変更の監査)を追跡します | - | 3.0, 4.0, 5.0 |
| 実行中のクエリ置換 | サーバがクエリのテキストを置き換えます。新しいテキストはトレースと MON$ で見えます | SqlSubstDirectory |
2.5, 3.0, 4.0, 5.0 |
| 一時領域の BLOB キャッシュ | BLOB が 15-200% 速くなります | BlobTempSpace |
2.5, 3.0, 4.0, 5.0 |
| 大きなソートを行うクエリのログ | クエリのテキストを firebird.log に書きます |
TempSpaceLogThreshold |
2.5, 3.0, 4.0, 5.0 |
| 外部データソース: MySQL と ODBC | MySQL と ODBC への EXECUTE STATEMENT ... ON EXTERNAL |
- | 3.0, 4.0, 5.0 |
| ストリーミング / CDC(Kafka、RabbitMQ、JSON、Mongo) | 選んだテーブルの INSERT/UPDATE/DELETE を、レプリケーションに基づいて送ります。依頼に応じて提供 | - | 4.0, 5.0 |
| 全文検索(Lucene) | オープンソースの UDR と、ストリーミングに基づくプラグイン | - | 3.0, 4.0, 5.0 |
| キャッシュパラメータの自動修正 | firebird.conf / databases.conf にある誤った DefaultDbCachePages の値を修正します |
DefaultDbCachePages, MinDbCachePages, MaxDbCachePages |
4.0, 5.0 |
| HQbird バージョンのマスク | Firebird API が HQbird のバージョン文字列を返すかどうかを設定します | HQbirdVersionString |
2.5, 3.0, 4.0, 5.0 |
| データベース暗号化(プラグイン) | AES-256、オーバーヘッド 4-20%。依頼に応じて提供 | - | 3.0, 4.0, 5.0 |
| JOIN オプティマイザ | 暗黙の内部結合を明示的な結合にします | LeftJoinConversion |
3.0, 4.0 |
| 準備済みクエリのキャッシュ | 準備済みクエリを接続のメモリに残します | DSQLCacheSize |
3.0, 4.0 |
| マルチスレッドのバックアップ、リストア、スイープ、インデックス作成 | バックアップとスイープが最大 4-6 倍、リストアが 2-4 倍速くなります(8 コア、SSD) | - | 2.5, 3.0, 4.0 |
| ネイティブレプリケーション | プラグイン。PK/UK のないレコードを除外できます | - | 2.5, 3.0 |
| 大きなソートのオプティマイザ | リフェッチプラン | SortDataStorageThreshold |
2.5, 3.0 |
| 並列データ読み取り | make_dbkey() と共有スナップショット |
- | 2.5, 3.0 |
| 外部接続のプール | Firebird への並列な外部クエリ | ExtConnPoolSize, ExtConnPoolLifeTime |
2.5, 3.0 |
| Amazon S3 へのバックアップ(プラグイン) | 依頼に応じて提供 | - | 記載なし |
5. fbagent: FBDataGuard に代わるエージェント
エージェント 1 つが Firebird インスタンス 1 つを受け持ちます。1 台のホストで複数のエージェントを実行できます。エージェントは、Windows と Linux 上の Firebird 2.5、3.0、4.0、5.0 で動作します。
5.1 バックアップ
- 検証付きバックアップ(gbak)。対象は 1 つのデータベース、またはフォルダにまとめたデータベース群で、テストリストアは任意です。
- 増分 nbackup。レベルは 0 から 4。モードはシンプル、詳細、グループです。
- nbackup のプランモード: ルールがレベル、日、時刻を決めます。エディタはカレンダーとストレージの予測を表示します。保持では、レベル 0 とその増分をまとめて残します。
- バックアップとリストアのサイクル: バックアップ、リストア、稼働中データベースの入れ替えを行い、クラッシュのあとはロールバックします。
- リストアジョブ。
.fbkまたは.nbkから。ローカル、または S3 から。 - 圧縮: deflate、zip、gz、zstd。
- 暗号化: 鍵の預託付き AES-256 zip アーカイブ。
- クラウド: ローカルファイルを作らない、S3 へのストリーミングバックアップ。S3 および FTP/FTPS へのコピー。
- バックアップ一覧: すべてのバックアップファイルとすべてのリストアの記録。サイズ、時刻、検証結果を含みます。
- コマンド履歴: ジョブあたり最大 50 回の起動と、gbak のログ。
5.2 メンテナンス
- スイープ、インデックス統計、
gfixによる検証、実行ウィンドウ付きの SQL スクリプト、メタデータの追跡。 - すべてのジョブに、cron のスケジュールと実行ウィンドウがあります。
- 重要なジョブの今すぐ実行。ローカル、または HQCenter を経由したリモート。進行状況の表示とキャンセルができます。
- 夜間の時間帯に行うディスク速度テスト。
5.3 健全性チェック
- 約 10 分ごとのサーバ状態。各検出結果にはレベル、根拠の行、ヒントがあります。状態は傾向(たとえばディスクが満杯になるまでの時間)を示し、問題の背後にあるトランザクションまたはプログラムの名前を出します。
- ホストのメトリクス: プログラム別の CPU とメモリ、ディスクごとの遅延と IOPS、どのサービスがディスクを使っているか、OS キャッシュ内のデータベース。
- Linux の制限: TasksMax、NPROC、NOFILE、OOM kill。
- ディスク容量: 空き容量の下限と、急速に埋まる状態の検出。
- ログ:
firebird.logとreplication.logをシグネチャで分類します。たとえば破損の可能性です。 - ヘッダーページから分かるデータベースの状態。シャットダウン、nbackup ロック、レプリカ、読み取り専用。
- Firebird モード: SuperServer、SuperClassic、Classic。モードの変更が再起動を待っているときは、検出結果になります。
- トークン付きの Prometheus
/metricsエンドポイント。 - リソースガードが、エージェント自身の CPU とメモリを制限します。バックアップを中断することはありません。
5.4 パフォーマンス
- ウォッチドッグ付きの継続トレース。
- 時間の範囲ごとのパフォーマンスレポート。所要時間、頻度、合計時間、フェッチ、読み取り、書き込みによる順位。プラン、プロシージャ、トリガ。誰が、いつ、どこから文を実行したか。失敗した実行。
- 選んだ範囲とデータベースに対するオンデマンドのパフォーマンスレポート。
- 双方の SQL が付くロック競合とデッドロック。
- クライアントアプリケーションとアドレスが付く、クラス別のトレースエラー。
fblwmonプラグインによる軽量モニタリング。
5.5 設定
- エージェントは再起動なしで設定を読み直します。検証、バックアップ、エラー時のロールバックがあります。
databases.confエディタ(2.5 ではaliases.conf)。エンジンのバージョンごとの検査、保存前の控え、コメントの保持。- ユーザー: セキュリティデータベースのユーザー一覧と、ユーザーの作成。
- HQCenter からの設定配信。各変更の状態は、送信済み、適用済み、拒否、ドリフトです。
5.6 ログ配送(fblogspacker)
- エージェントは新しいデータだけを HQCenter に送ります。
firebird.logとreplication.logの新しい末尾、1 分ごとのトレースファイルと監視ファイル、メトリクス、サーバ状態です。 - アーカイブには大きさの上限があります(既定は 120 MiB)。大きなファイルは分割して送ります。
- バックアップとデータベースが送られることはありません。
6. HQbird Monitor: 新しい Web コンソール
Firebird インスタンスごとにコンソールが 1 つです(ポートは 20000 に Firebird のポートを足した番号。例: 23050)。または、1 つの HQCenter に属するすべてのサーバ向けの中央コンソールが 1 つです。
- サーバ: すべてのサーバ。状態、Firebird のバージョンとモード、エージェントのバージョン、ライセンス、小さなグラフ。
- ダッシュボード: CPU、メモリ、接続。プログラム別の CPU。ディスクとメモリの使用元。一時ファイル。ディスクの空き、遅延、速度。状態バッジ付きのデータベース表。分をクリックすると、その分が表示されます。
- サーバ健全性レポート: 24 時間、7 日、または 14 日にわたる 18 系統のマトリクス。問題の時系列。領域ごとの検出結果。ディスク、トランザクション、レプリケーション、エラー、クエリ、バックアップの表。操作ボタンを押すと、エディタで修正箇所が開きます。
- データベースページ: モニタリング、I/O、トランザクションのグラフ。選んだ分の上位クエリと接続。
- パフォーマンスレポート: 10 種類の順位、1 時間ごとの実行、2 つの時間範囲の比較、文の 30 日分の履歴、オンデマンドのレポート。
- エラーと競合: CSV エクスポート付きのトレースエラー。1 分ごとのロック競合とデッドロック。
- 統計: 推奨、傾向、予測付きの gstat 分析。Excel と JSON へのエクスポート。
- ログと設定: フィルタ付きで、日ごとの
firebird.logとreplication.log。.confファイルの変更履歴。 - ジョブ、バックアップ、アクティビティ: 組み込みの設定エディタとバックアップ一覧。
- ライセンス、更新、ユーザー、クラスタ、設定。
- 通知ページ(ボタンはサーバのページにあります)。誰が送るか(エージェント、HQCenter、両方、または誰も送らない)、チャネル、テストメッセージ、Telegram ボットのチャット ID、直近 50 件の配送。このページが、保存されたトークン、URL、パスワードを表示することはありません。
- 言語: 英語、ロシア語、ドイツ語、ブラジルポルトガル語、スペイン語。
- アクセス: ログインは 1 つ、またはサーバ一覧と管理者ロールを持つ複数のユーザー。監査ログ。ライト、ダーク、ハイコントラストのテーマ。名前と SQL リテラルを隠すデモモード。インターネットがなくても動作します。
7. HQbird Cluster: RCM とノード
HQbird 2024 にはレプリケーションがあり、クラスタマネージャはありませんでした。HQbird 2027 がこれを加えます。
- 構成。各 Firebird インスタンスのそばにノードが 1 つあり、クラスタごとに RCM が 1 つあります。Web コンソール(HTTPS、ポート 7444)、コマンドライン、API があります。
- レプリケーションは非同期です。Firebird 4.0 と 5.0 はネイティブレプリケーションを使います。HQbird 2.5 と 3.0 はレプリケーションプラグインを使います。
- HQCenter のないクラスタ。
fbagent --cluster-initが RCM と最初の管理者を作ります。ホストをリンクのページが、1 回限りのトークンで他のサーバを参加させます。クラスタは既定でオフです。インストール時、または HQbird Monitor からオンにします。 - コンソールからのレプリカ設定: データベースを登録し、公開設定を行い、初期化します。コピーは nbackup で作ります。スムーズ再初期化は、長い書き込みトランザクションを待ちます。ノードが稼働中のデータベースを上書きすることはありません。
- 引き継ぎ。手作業の設定ですでにレプリケーションしているデータベースが対象です。
- 1 つのマスタに対する複数のレプリカ。
- データベースごとの状態と遅延(同期済み、遅延、再初期化が必要、その他)。それぞれに理由が付きます。
- 検証: マスタとレプリカの行数の比較。要求時、またはスケジュールで行います。
- サービス: 1 つの論理データベースを、複数のホストに置きます。
- スイッチオーバーはデータを失いません。その後、以前のマスタはレプリカとして再参加します。
- 手動フェイルオーバーは、マスタのホストが失われたときに行い、データ損失の報告が付きます。
- 自動フェイルオーバーはサービスごとで、既定ではオフです。ルータが必要です。
- ルータ(HAProxy、Linux)は、クライアントに安定したアドレスを 1 つ渡します。
- コンソール: 6 言語、読み取り専用の閲覧ロール、監査ログ、コードごとのランブック付きアラート。
- 重要度
warn以上の問題向けのアラートチャネル(Telegram、ウェブフック、メール)。アラートページには、チャネルごとのテストボタンがあります。 - セキュリティ: クラスタ認証局のもとでの相互 TLS、証明書の自動更新、署名付きリリース。
制限: クラスタを通じた同期レプリケーションはありません。公開されるのは、主キーまたは一意キーを持つテーブルだけです。ライセンスでは、クラスタあたり最大 3 ホストです。RCM はクラスタあたり 1 つです。ルータは Linux だけです。スイッチオーバーは、Linux 上の Firebird 5.0 でラボ検証済みです。
ガイド: クラスタガイド、クラスタのランブック。
8. HQCenter: 多数の HQbird サーバのための中央サーバ
- 概要。自分のネットワーク内にある Linux サーバです。エージェントがここに登録し、データをアップロードします。中央の HQbird Monitor と管理パネルがあります。
- インストールは、Ubuntu 22.04 / 24.04 / 26.04 または AlmaLinux 9 / 10 でコマンド 1 つです。閉じたネットワークにも対応し、持ち込んだバンドルからインストールできます。
- 登録: エージェントが自分の鍵を作ります。オペレーターが承認するか、空きシートがあるあいだはライセンストークンが承認します。エージェントの通信はすべて相互 TLS です。
- サーバ群の表: エージェントと Firebird のバージョン、最終連絡、リリースチャネル。
- エージェントへの設定の配信。履歴と復元があります。どのサーバでも、重要なジョブを今すぐ実行できます。
- サーバ群の更新: エージェント、HQbird Monitor、クラスタのプログラム、Firebird は、HQCenter のカタログから来ます。ベンダーの署名を検査します。
- HQCenter は自分自身を更新します。署名付きスタックから行い、検査と自動ロールバックがあります。所有者がこれをオフにできます。
- 状態監視: すべてのサーバについて、新しい問題、重大度が上がった問題、解消した問題。メールと週次レポート。Telegram、ウェブフック、SMTP のチャネル、静かな時間帯、「応答のないサーバ」のイベント。
- ライセンス: アップロード、エージェントへの割り当て、シート数。
- リクエスト監査: 誰がサーバ上の何を変更したか。
- スコープ付きトークンを使う API。HQCenter 自身のための Prometheus メトリクスと Grafana ダッシュボード。
- 管理パネルの言語は 4 つです。英語、ブラジルポルトガル語、ロシア語、ドイツ語。
ガイド: site-install.md。
9. fbmcp: AI アシスタント向けの Firebird ツール
- データベースのホスト上で動く MCP サーバです。AI クライアント(たとえば Claude Desktop や Claude Code)がこれを使い、Firebird 2.5 から 5.0 を調べ、管理します。
- 約 120 のツール: プランと統計付きのクエリ、スキーマ、セッション、インデックスの助言、gstat、傾向。バックアップ、テストリストア、検証、スイープ。DDL と移行。ユーザーと権限。トレース。
firebird.conf。スケジューラ。fbagent 向けの約 30 のツール(状態、レポート、ジョブ、ライセンス、更新)。クラスタ(リンク、登録、再初期化、検証、スイッチオーバー、フェイルオーバー)。 - 段階による安全策:
- 読み取りに承認は不要です。読み取り専用トランザクションで実行します。
- 通常の変更は、AI クライアントの中で、ワンタイムトークンにより確認します。
- 影響の大きい変更を承認できるのは、AI クライアントの外だけです(Windows ではトレイのウィンドウ、サーバではコマンド)。開いているメンテナンスの時間帯と、作成から 24 時間未満の検証済みバックアップも必要です。
- データベースの削除はオフです。
- すべての判断は監査ログに残ります。
- HQbird のセットアップは、fbmcp を既定でインストールします。対象はローカル利用だけです。リモート利用には HTTPS と API キーが必要です。
10. インストーラ
Windows
- セットアップは 4 つで、Firebird のメジャーバージョンごとに 1 つです(
fb25、fb30、fb40、fb50)。それぞれオフラインで、必要なファイルはすべて中に入っています。 - 各セットアップは Firebird、fbagent、HQbird Monitor、fbmcp をインストールします。クラスタのプログラムはコピーされ、オンにするまでオフのままです。
- 1 台のサーバに複数の Firebird メジャーバージョンを置けます。同じメジャーバージョンのインスタンスも複数置けます。
- 試用、ライセンスファイル、HQCenter への接続、自動更新のためのウィザードページ。
- 各ページに対応するスイッチによるサイレントインストール。
- ウィザードの言語は 8 つです。英語、ブラジルポルトガル語、ドイツ語、ロシア語、スペイン語、ポーランド語、トルコ語、簡体字中国語。
- セットアップとアンインストーラには Authenticode 署名があります。
- アンインストールは、1 つのインスタンス、またはすべてを削除します。データベースは常に残ります。
ガイド: HQbird の Windows インストールガイド。
Linux
- Firebird のメジャーバージョンごとに、オフラインの
.runファイルが 1 つです。ダウンロードされるのは、不足している OS パッケージだけです。 - 対象ホスト: systemd と、apt、dnf/yum、または zypper がある x86_64(Ubuntu、Debian、AlmaLinux、Rocky、RHEL、Oracle Linux、openSUSE、RED OS)。SELinux の enforcing モードで動作します。
- 既定は全画面のテキスト画面で、言語は英語、ロシア語、ブラジルポルトガル語、ドイツ語です。
--no-tuiはプレーンテキストのモードにします。 - 1 台のホストに複数のインスタンスを置けます(Firebird 2.5 はインスタンス 1 つ)。
--yesとオプションによる非対話のインストール。
ガイド: HQbird の Linux セットアップガイド。
Docker
- 公開イメージは
ghcr.io/ibsurgeon/hqbird2027-fb25、-fb30、-fb40、-fb50です。コンテナ 1 つが、すべてのコンポーネントを持つインスタンス 1 つを収めます。 - イメージは cosign で署名されています。
- compose ファイル付きのクラスタの役割
HQBIRD_CLUSTER_ROLE=master|replica。 - イメージ内のフォルダは他のユーザーから閉じられており、新しいコンテナは RCM アカウントを保持します。
ガイド: Docker ガイド。
11. ライセンスと試用
- 署名付きライセンスファイル。エージェントはベンダーの署名を検査します。ライセンス処理がデータベースを止めることはありません。
- 試用: ネットワーク上の手続きなしで 7 日間。仕事用のメールアドレスと 6 桁のコードで、30 日まで延長できます。
- ライセンスゾーン EU、RU、BR。それぞれ独自の鍵があります。
- オフライン: インストール時にライセンスファイルを渡します。Windows のセットアップは、ライセンス要求ファイルを作れます。
- HQCenter を使う場合: ライセンスを 1 回アップロードし、エージェントに割り当てます。
- 新しいライセンスは自分で届きます。試用の申請でライセンスを受け取ったエージェントは、1 時間に 1 回、ベンダーのライセンスサーバに問い合わせます。サーバがそのエージェントに持っているライセンスをインストールします。試用の延長、試用から作られた有償ライセンス、またはサブスクリプションの次の期間です。サーバ上で行う作業はありません。ベンダーのライセンスサーバは、このようなライセンスの提供を段階的に始めます。
- 試用の 30 日が過ぎたあとでも、試用の申請を送れます。そのメールアドレスは、ライセンスを持つ顧客のものである場合があります。
12. 自動更新
- エージェントは自分自身を更新します。ベンダーの署名を検査し、ダウングレードを拒否し、ロールバックできます。
- エージェントは HQbird Monitor、fbmcp、クラスタのプログラム、Firebird を更新します。Firebird の更新には、バックアップ、適用の時間帯、健全性チェック、差し戻しがあります。
- HQCenter がある場合: 更新は、リリースチャネルに従い、HQCenter のカタログから来ます。
- HQCenter がない場合: 更新はベンダーのゾーンから来ます。モードは
all、agent(Firebird は管理者の操作を待ちます)、offです。HQbird Monitor の更新ページが状態を表示します。
13. アラートと通知
- HQCenter の状態監視は、サーバ群の問題についてメールを送ります。クラスタのコンソールはアラートを表示します。
- エージェントは、サーバの問題について自分のメッセージを送ります。問題が新しいとき、悪化したとき、解消したときです。1 回の状態チェックで起きた変更は、1 通のメッセージにまとまります。
- チャネルは、自分で用意する Telegram ボット、ウェブフック(Slack、Teams、Discord、Mattermost、Rocket.Chat、ntfy)、メール(SMTP)です。重要度のフィルタと、通知を控える時間帯があります。チャネルは複数持てます。チャネルを追加するまで、何も送りません。
- 日次のまとめ: 未解決の問題を、1 日に 1 通のメッセージで送ります(
notify.daily_summary、既定はオフ)。 - 1 台のマシンにエージェントが複数あるとき、マシン自体の問題(ディスク、メモリ)を送るのは、そのうちの 1 つだけです。
- エージェントのコマンドは 2 つです。
--notify-history [N]は直近の配送を表示し、--notify-test <channel>はテストメッセージを送ります。 - ライセンスが送信を許可しないあいだ、エージェントは送りません。
- HQbird の Telegram ボット: 有効なライセンスを持つサーバまたは HQCenter が、ワンタイムコードでチャットを結びます。自分のボットは不要です。ベンダーのサーバは、このサービスをまだ提供していません。提供が始まるまでは、自分の Telegram ボット、ウェブフック、またはメールを使ってください。
- RCM は、クラスタのアラートを同じ種類のチャネルへ送ります(
rcm.jsonのnotify.channels)。
14. セキュリティ
- エージェント、HQCenter、クラスタの相互 TLS。
- 署名付きリリース。有効なベンダー署名のない更新を、エージェントは拒否します。
- Windows のセットアップとプログラムには Authenticode。Docker イメージには cosign。
- バックアップアーカイブの AES-256 暗号化。
- 秘密情報は、コマンドラインと設定のスナップショットに入りません。
- エージェント上のリクエスト監査ログ。HQbird Monitor、HQCenter、RCM、fbmcp の監査ログ。
- サーバ上でリモートコマンドをオフにできます(
--remote-commands off)。
15. HQbird 2024 からのアップグレード
- 2027 のセットアップは HQbird 2024 を見つけ、Firebird をその場で更新し、古いフォルダをコピーとして残します。
- FBDataGuard のジョブは、最初の起動時に 1 回だけインポートされます。対象は gbak、nbackup(レベル 0 から 4)、グループバックアップ、スイープ、インデックス統計です。エージェントは、既存のバックアップセットを継続します。
- インポートされないもの: レプリケーション、トレース、ファイル転送、クラウドバックアップ、リストア、検証。これらはエディタで設定し直します。
- 2024 のライセンスは引き継がれません。新しいエージェントは試用モードで起動します。2027 のライセンスをインストールしてください。
- 廃止: ポート 8082 の FBDataGuard コンソール、AMV、VSS バックアップ、FTP サーバ、SFTP アップロード。
- 2024 のセットアップ向けスクリプトでは、2027 に相当するものがあるスイッチを受け付けます。それ以外のスイッチは拒否し、代わりとなる名前をメッセージに示します。
- インポートは、FBDataGuard のデータベースを登録します。登録先は Firebird のエイリアスファイルです(
databases.conf。Firebird 2.5 ではaliases.conf)。古いファイルは先にコピーします。パスがすでにファイルにある場合、またはそのファイルが存在しない場合、そのデータベースは対象外です。include指令のあるファイルは変更しません。 - インポートは、FBDataGuard の古い監視ログを削除します(フォルダ
mon\outcomingとmon\outtrace)。古い HQbird のサービスが動作しているあいだは、何も削除しません。削除は元に戻せません。 - どちらも既定でオンです。オフにするには、
hqbird_import.register_databasesまたはhqbird_import.clean_mon_logsをfalseにするか、--no-register-databasesと--no-clean-mon-logsを--import-hqbird-configと一緒に使います。