HQCenter:サーバーフリート
多数のサーバーを1つのコンソールで
HQCenter は顧客サイトにある1台の Linux サーバーです。顧客のすべてのエージェントがこのサーバーに接続します。エージェントはデータをここへ送り、設定、コマンド、ライセンス、新しいバージョンをここから取得します。管理者は HQ Monitor でフリート全体を確認し、ブラウザから管理します。
- センターとの通信に必要な受信ポートは0
- エージェントごとにmTLS証明書
- データがセンターに届くまで3分
- 設定がエージェントに届くまで約1分
- エージェントとセンターの更新はロールバック付き
Agent · nginx · goafts · fblogspacker · HQ Monitor
受信ポートなしの接続
すべての接続はエージェントが開きます。HQCenter がデータベースサーバーに接続することはありません。そのため、センターと通信するために Firebird サーバーのポートを開ける必要はなく、NAT の背後にある支店のサーバーも、隣のラックにあるサーバーと同じように動作します。
HQCenter では nginx の背後で3つのプログラムが動作します。goafts はアーカイブを受信し、証明書を発行し、設定、コマンド、ライセンス、新しいバージョンを保存します。fblogspacker はアーカイブをエージェントのフォルダーに振り分けます。HQ Monitor はこれらのフォルダーをブラウザに表示します。
| HQCenter のポート | 接続するもの | 確認内容 |
|---|---|---|
:443 | エージェント: アーカイブ、設定、コマンド、ライセンス、新しいバージョン | TLS 1.3 とエージェント証明書。失効した証明書は拒否される |
:9443 | 初回接続時の新しいエージェント、およびインストーラー | エージェント証明書なし: attach.json のキーによる証明書要求、センターキーのフィンガープリント、インストーラーのダウンロード |
:8443 | 管理者とコンソール: 管理 | 管理者証明書と許可されたアドレスのリスト |
:8085 | ブラウザ: HQ Monitor コンソール | 許可されたアドレスのリスト |
- 1つのコマンドで接続センターはファイル
attach.jsonを提供します。これにはアドレス、キーのフィンガープリント、有効期限が含まれます。サーバー上で:fbagent --attach --file attach.json。HQbird 2027 のインストーラーはこれを自動で行います。通常のキーによる要求は、センターのパネルで管理者が承認します。ライセンスキーは、ライセンスに空きシートがある間、要求自体を承認します。 - エージェント名は証明書名エージェントのデータフォルダー、設定、コンソールの行はこの名前を使用します。Windows インストーラーはサーバー名を尋ね、既定値はコンピューター名です。証明書の有効期間は1年で、失効した証明書は即座に機能を停止します。
- 何も失われないアーカイブは最大 120 MiB です。ネットワークエラー時は3回再試行します。送信済みのアーカイブは削除され、未送信のアーカイブは決して削除されません。各エージェントは最大 150 秒の独自のオフセットで送信するため、1つのセンターのエージェントが同じ秒に到着することはありません。
- センターからのライセンスエージェントは約1分で新しいライセンスを取得します。設定ポーリングへの応答がライセンスについて通知します。エージェントは起動時と6時間ごとにもライセンスを要求します。ライセンスの確認はネットワークなしでエージェント自身が行います。ライセンスページには各サーバーの状態が表示されます。
- コンソールはデータベースに触れないHQ Monitor はエージェントのファイルからページを構築します。Firebird に接続せず、データベースに負荷をかけません。
- 1台の Linux サーバーUbuntu または AlmaLinux。1つのスクリプトでセンターをインストールし、2回目の実行で既存のものを更新し、パスワードとキーを保持します。
IBSurgeon はサマリーを受信します: サーバーの健全性、サーバーリスト、バックアップとリストアのリスト(ファイルを除く)、イベントと週次レポート、クラスターの説明、ライセンス。ログ、トレース、バックアップファイル、パスワード、監査ログは顧客のもとに留まります。
設定エディター · 今すぐ実行 · 配信ステータス
センターからの設定
センターは各エージェントの設定のコピーを保持します。管理者はエージェントのそばにあるのと同じエディターでジョブと設定を変更し、保存してエージェントに送信をクリックします。エージェントは約1分で変更を取得します。
エージェントは動作中の設定の上に新しい設定を書き込みません。まず候補を確認します。不良な候補は脇に置かれ、動作中の設定はそのまま残り、コンソールに拒否の理由が表示されます。
サーバーページのステータス
各サーバーについて、最後の変更がどこまで進んだかがわかります: ステータスアイコン、送信時刻(push)、エージェントの応答時刻(ack)。アイコンのヒントには、エージェントが拒否した理由と正確な時刻が表示されます。
1分で、どのサーバーが新しいバックアップジョブを取得したか、取得しなかったのはどれか、そしてその理由がわかります。
リストのサーバーレベルは、サーバー全体に対するエージェントの判定です。アイコンの下には、主な所見を1行で表示します。別の「Agent」アイコンは、エージェント自体の状態がサーバーの状態より悪い場合にのみ表示されます。
30分以上応答がないサーバーには灰色の「no data since …」アイコンが表示され、リストの末尾に移動します。リスト上部のサマリー行には、レベル別のサーバー数が表示されます。
エージェントがサーバーを保護します
エージェントは自身のメモリと CPU を監視します。エージェントのタスクが使いすぎた場合、エージェントはそのタスクを一時停止し、メモリを保持している実行を停止します。バックアップとデータアップロードには影響しません。それでもエージェントのメモリが増え続ける場合、エージェントは自身を再起動します。エージェントがオフにしたタスクはヘルスレポートとエディターに表示され、ボタン1つで再びオンにできます。
中央から今すぐ実行
スケジュールを待たずに、バックアップ、リストア、スイープ、gfix チェック、インデックス再計算を今すぐ開始できます。リクエストは同じ経路を通ります。gofats に入り、エージェントがポーリング時に取得してキューに入れ、通常のチェックが行われます。
- 下書きコンソールで変更を保存し、後で送信できます。状態が表示されます: 未送信、送信済み、適用済み、上書き済み。
- パスワードは中央から隠されますコンソールは新しいパスワードをエージェントの公開鍵で暗号化します。復号できるのは自身のサーバー上のエージェントだけです。
- 設定のコピー各置き換えの前に、エージェントはコピーを保存します: 直近10件、最低14日間。拒否された候補は90日間保持されます。
- サーバーのみリリース署名チェック、ライセンス、リモートコマンド、プログラムパス、コンソールログインは中央から変更できません。
- データベースの置き換えには両側の許可が必要稼働中のデータベースを置き換えるリモートリストアは、サーバー自体が許可し、ユーザーに別の権限がある場合にのみ実行されます。開始前にデータベースファイル名を入力する必要があります。
- 中央からの databases.confファイルを1つのエージェントに送信できます。gofats はそれを転送するだけで、エージェントがファイルをチェックして書き込み、古いファイルをその隣に保持します。
署名 · ロールバックポイント · チェック
ロールバック付きアップデート
エージェントはインターネットからではなく、HQCenter から新しいバージョンを取得します。エージェントは自身、HQ Monitor、クラスタープログラム、Firebird を更新します。すべてのアップデートは同じ手順に従います: 署名を確認し、ロールバックポイントを保存し、インストールし、動作を確認します。動作しない場合は、古いバージョンに戻します。
- 1署名IBSurgeon による署名済みリリース
- 2ロールバックポイント現在のバージョンのコピー
- 3インストールファイルを置き換え
- 4チェック新しいバージョンが「I am working」を報告し、45秒間動作
- 5完了新しいバージョンが動作
- ↺ロールバックロールバックポイントからコピーを復元
- ✓古いバージョンが動作2回のロールバック後、そのバージョンはブロックされます
| 更新対象 | タイミング | 保護 |
|---|---|---|
| エージェント | 設定ポーリングへの応答が新しいバージョンを報告したときに即座、および1時間に1回。そのような応答がない場合は180秒ごと | 署名、2つのロールバックポイント。新しいバージョンは「I am working」を報告し、45秒間動作する必要があります。2回のロールバック後、そのバージョンはブロックされます。 |
| HQ Monitor | 設定ポーリングが動作している間は1時間に1回。それ以外は180秒ごと | 30秒間のコンソールヘルスチェック、古いバージョンのコピー。 |
| クラスタープログラム | 180秒ごとにチェック | レプリカを先に、次にマスター。 |
| Firebird | ウィンドウ内のみ、デフォルトは03:30–04:00 | バックアップの完了を待機します。インストール後にチェックし、失敗時はロールバックします。ロールバックされたビルドは再インストールされません。 |
| HQCenter | IBSurgeon がこのセンターのアップデートを有効にしている場合、15分ごと。IBSurgeon が設定するウィンドウ内、例えば02:00–05:00 | デフォルトではオフ。センターの所有者はアップデートを禁止できます: STACK_UPDATE=off。スタック署名がチェックされ、その後最大5分間サービスがチェックされます。失敗した場合、キャッシュから以前のスタックがインストールされます。 |
- まずテスト、次に全員IBSurgeon はリリースをまずテストゾーンに公開し、チェック後に本番ゾーンに公開します。HQCenter は自身のゾーンのリリースを1時間に1回コピーします。
- 署名は2回チェックセンターはダウンロード前に署名をチェックし、書き込まれたバイトに対して再度チェックします。エージェントはインストール前にさらにチェックします。
- ダウングレード不可サーバー自体が許可しない限り、現在のバージョンより低いバージョンはインストールできません。
- Linux では root がファイルを変更するエージェントサービスは root として実行されないため、信頼されたインストールファイルを置き換えることはできません。
ステータス監視 · メール · webhook
問題通知メールと週次レポート
HQCenter は各エージェントのヘルススナップショットを読み取ります。新しい問題、または悪化した問題はイベントです。メールや webhook はセンター自身が送信します。週に一度、センターはフリート全体のレポートを作成します。
センター自体は何も変更しません。問題が何週間も続き、それがそのサーバーにとって正常である場合、センターは新しいしきい値を提案します。適用するのは人だけです。
- 1ステータスを読み取るエージェントファイルが変更された場合、2 分ごと
- 2イベント新規、悪化、解消、再発
- 3メールまたは webhook。24 時間以内の再送なし
- 4週次レポートデフォルトでは月曜日 07:00
- 5✓ 提案新しいしきい値。管理者が適用します
14 日間のフリート全体
各サーバーについて: 問題のない時間の割合、週あたりのエピソード数、そしてどの検出項目が「停滞」しているか。
ノイズではなく正常
少なくとも半分の時間アクティブで、かつ少なくとも 1 週間連続しているもの。たとえば、サーバーの CPU が常にしきい値付近にある場合などです。
実データに基づくしきい値
サーバーが示した値を少し超える値: 最大値より 4 分の 1 上。空き容量などの下限しきい値の場合は、最小値より 5 分の 1 下。承認前に変更できます。有効期間は 30 日間です。
- 1 ホストにつき 1 通のメール1 つのホストで複数のエージェントが動作している場合、ホストの CPU、メモリ、ディスクの問題は 1 回としてカウントされます。
- 解消または非表示イベントには、問題が解消した理由が示されます: 修正済み、管理者による確認済み、または情報に変わった。
- 承認は新しい設定バージョンしきい値は管理者の代理として通常の配信でエージェントに届きます。各承認と拒否は監査ログに記録されます。
- メール内のリンクメールにはホスト名、ヒント、および HQ Monitor の該当サーバーへのリンクが記載されます。
メールと webhook はセンター管理者が有効にします。設定が完了するまで、メールは送信されません。イベントとレポートはセンターパネルとその API で確認できます。
ユーザー · 権限 · 監査 · 言語
ユーザーと権限
各ユーザーは自分のサーバーのみを表示できます。変更を行う権限は、個別に 1 つずつ付与されます。
管理者はすべてのサーバーを表示し、ユーザーを管理します。一般ユーザーは自分のリストにあるサーバーを表示します。新しい権限や新しいリストは次回のページ読み込み時に有効になります。新しいパスワードを設定すると、ユーザーはすべてのブラウザからサインアウトされます。
| 権限 | 許可される操作 |
|---|---|
| 設定を送信 | センター経由で変更された設定をエージェントに送信します。 |
| ジョブを実行 | バックアップ、リストア、スイープ、インデックス再計算を開始およびキャンセルします (今すぐ実行)。 |
| データベースを置き換えるジョブ | 稼働中のデータベースを置き換えるリストアを開始します。実行権限と併せてのみ可能で、かつエージェント側でも許可されている場合に限ります。 |
- 監査ログ各保存、送信、パスワード変更、ジョブ開始はユーザーログインとともに記録されます。goafts ではハッシュチェーンがログを保護します。
- エージェントリクエストログエージェント自体が、サーバーを変更する各リクエストと各アクセス拒否について 1 行記録します: Local API、センターからのコマンド、今すぐ実行、設定変更、更新。パスワードとリクエスト本文はログに記録されません。ファイルはログとともにセンターに送信されます。
- HQ Monitor ログインセッションは 7 日間続きます。1 つのアドレスからのログイン試行は 15 分間に 8 回までです。
- センター管理パネル別のログインで、管理者証明書のみで可能です。セッションは 8 時間続きます。15 分間に 5 回失敗すると、ログインは 15 分間閉鎖されます。
- 最大 2000 ユーザー各ユーザーが独自のパスワードとサーバーリストを持ち、サーバーを割り当てる際にサーバーで検索できます。
- 5 つのインターフェース言語英語、ロシア語、ドイツ語、ポルトガル語 (ブラジル)、スペイン語。統計レポートも選択した言語を使用します。