HQbirdサーバーメンテナンス
夜勤なしのメンテナンス
スイープ、データベース検証、インデックス統計の再計算、お客様の SQL スクリプト、Firebird の更新が、スケジュールに従って夜間に実行されます。グループスイープ、SQL スクリプト、Firebird の更新は、それぞれ専用の時間枠でのみ開始されます。エージェントはバックアップやユーザーの邪魔をしません。問題が発生した場合、エージェント自身が以前の状態に復元します。
- 4 件のメンテナンスジョブ
- データベースごとに1 件の重い操作
- サーバーごとに2 件の重いタスク
- 03:30–04:00 Firebird 更新の時間枠
- チェックに失敗した場合は自動ロールバック
デフォルトスケジュール
サーバーの夜間
メンテナンスは夜間に実行され、各ジョブはそれぞれの時刻に実行されます。以下はデフォルトの時刻と時間枠です。これらはエージェント設定エディターで変更できます。
スイープ、gfix 検証、インデックス再計算、SQL スクリプトはデフォルトではオフです。お客様のデータベースに対して有効にしてください。時刻はエージェントのタイムゾーンを使用します。
日曜日の夜は次の順序で実行されます。02:30 に gfix 検証、03:00 にスイープ、04:00 にインデックス再計算。まずチェック、次にガベージコレクション、最後に稼働中のデータに対する統計です。
sweep · gfix · indexes · SQL
4 つのメンテナンスジョブ
各ジョブは通常の Firebird コマンドです。エージェントは、DBA が通常手作業で行うことを追加します。スケジュール、時間枠、データベースロック、ログ、明確なエラー理由です。
| ジョブ | 実行内容 | 対象データベース | デフォルト |
|---|---|---|---|
| スイープ | gfix -sweep: 古いレコードバージョンを削除します。 | 明示的なデータベースリスト | 日 03:00 |
| グループスイープ | フォルダー内のすべてのデータベースに対する同じスイープ。マスク、除外、スキャン深度。 | フォルダー、マスク *.fdb | 00:15–01:15 |
| gfix 検証 | gfix -v -full: すべてのデータベースページをチェックします。 | 明示的なリストのみ | 日 02:30 |
| インデックス再計算 | ユーザーインデックスに対する SET STATISTICS。非アクティブなインデックスも検出します。 | データベースリスト | 日 04:00 |
| SQL スクリプト | 受信スクリプトフォルダーまたはキューからのお客様の DDL および DML。 | スクリプトごとに 1 つのデータベース | 03:00–04:00 |
- スイープ前の長時間トランザクションオプションとして、エージェントは 5 時間より古いトランザクションを持つ接続を切断します (しきい値は設定可能)。gbak、gfix、gstat、fbsvcmgr には触れません。
- グループは停止しない1 つのデータベースでのエラーは、他のデータベースのスキャンを停止しません。
- 明確な理由Firebird 3 以降では、ユーザーが接続しているデータベースの検証は許可されません。エージェントはエラーコードだけを表示するのではなく、まさにそのことを伝えます。
- SQL: エージェントが COMMIT を追加DDL: 各ステートメントの後に COMMIT、DML: 100 ステートメントごとに COMMIT。
SET BAIL ON: 最初のエラーでスクリプトが停止します。 - 危険な SQL は実行されない
DROP DATABASE、ユーザーとロール、GRANTとREVOKE、ALTER DATABASE: そのようなスクリプトは全体が隔離されます。 - 実行ログどのコマンドが、いつ、どのような結果で実行されたか。スイープと gfix 検証については、エージェントはコマンド履歴を保持します。ジョブごとに最大 50 件、エディターには最後の 2 件が表示されます。パスワードがログに記録されることはありません。
時間枠 · ロック · スロット
サーバーがビジー状態の場合、ジョブは待機するかデータベースをスキップします
開始前に、エージェントはいくつかの条件をチェックします。条件が満たされない場合、ジョブは待機するかデータベースをスキップします。他の作業を中断することはありません。
左側の条件をオンにして、フォルダーのグループスイープ中にエージェントが sales.fdb データベースに対して何を行うかを確認してください。
| ルール | 対象となるもの | エージェントの動作 |
|---|---|---|
| メンテナンス時間枠 | グループスイープ 00:15–01:15、SQL スクリプト 03:00–04:00、パフォーマンステスト 土 22:00 — 日 06:00。 | 時間枠外ではジョブは開始されません。時間枠の残りが 1 分未満の場合も開始されません。 |
| データベースごとに 1 件の重い操作 | バックアップ、スイープ、検証、インデックス再計算、リストア、SQL スクリプトはデータベースロックを取得します。 | バックアップはデータベースが空くまで最大 60 分待機します。スイープ、検証、インデックス再計算は、ビジー状態のデータベースを次回のスケジュール実行までスキップします。今すぐ実行は待機して再試行します。 |
| サーバーごとに重いタスクは最大2つまで | バックアップ、リストア、スイープ、検証、インデックス再計算、SQLスクリプト、完全なgstat、テスト。エージェント自体の重い処理もスロットを占有します:トレースとログの処理です。 | 3つ目のタスクは空きスロットを待ちます。設定で数値を変更できます。新しい値はエージェントの再起動後に有効になります。 |
.delta ファイル | データベースの隣に .delta ファイルがあります:nbackupがデータベースを保持しています。 | スイープはそのようなデータベースをスキップします。 |
| グループ内の1つのデータベースでのエラー | グループ内の1つのデータベースのスイープがエラーで終了しました。 | グループのスイープは次のデータベースで続行されます。続行がオフの場合、このジョブのみが停止します。エラーが発生したデータベースはジョブの結果に記載されます。 |
同じデータベースのgbakバックアップとnbackupが同じ分に重なった場合、gbakバックアップは15分後に移動します。「今すぐ実行」による手動開始は移動しません。
ワンボタン
今すぐ実行:すぐに開始
ソフトウェア更新の前にバックアップが必要ですか、それとも今すぐスイープを実行しますか?ジョブ行の「今すぐ実行」ボタンでジョブが1回だけ開始されます。スケジュールは変更されません。
今すぐ実行は、バックアップ、リストア、スイープ、インデックス再計算、gfix検証で利用できます。無効化されたジョブも1回だけ実行できます。その後も無効のままです。エージェントはスケジュール実行と同じ条件を確認し、何を待っているかを表示します。
- 何を待っているかがわかるデータベースが別の操作でビジーである、ジョブがウィンドウを待っている、ディスク容量が少ない。
- キャンセル実行がキュー待ちまたは待機中の場合、キャンセルできます。開始されたジョブはキャンセルされません。
- リクエストの有効期間は60分この時間内にエージェントが受け取らなかった場合、実行は期限切れとして扱われ、失われたわけではありません。
- どのデータベースが実行されるかがわかる実行ウィンドウはデータベースフィールドから始まります。グループジョブの場合、データベースのチェックボックスと「N / M 選択済み」の行が表示されます。
- リクエストに応じたパフォーマンスレポート今すぐ実行は、最大24時間までの任意の範囲のレポートを、データベース、期間、プログラムによるフィルター付きで作成します。これはレポートページの「レポートを作成…」ボタンと同じ実行です。
- ローカルからもセンターからもローカルコンソールはエージェントに直接アクセスします。センターからは、リクエストはgoaftsを経由します。エージェントは次の同期時、約1分で受け取ります。
- データベースの置き換えは別扱い置き換えを伴うリストアとバックアップ-リストア-置き換えサイクル:データベースファイル名を入力し、別の権限が必要です。このようなジョブのリモート開始は、サーバーではデフォルトでオフです。
- 保存直後今すぐ実行は、エージェントが新しい設定を受け入れるまで待ち、それからジョブを開始します。
エンジン更新
新しいFirebirdビルドは通常の夜間作業
エージェントは新しいFirebirdビルドを自身でダウンロードし、メンテナンスウィンドウを待ち、インストールして確認します。確認が失敗した場合、エージェントは前のバージョンに戻し、このビルドを再度インストールしません。
- ウィンドウデフォルトでは03:30〜04:00。ウィンドウ外では、ダウンロードされたビルドはウィンドウが開くまで待機します。ウィンドウ内で更新が延期された場合、エージェントは10分後に再試行します。エージェントは約1時間でセンター内の新しいビルドを検出します。
- 中断してはならないジョブgbak、nbackup、リストア、SQLスクリプトが実行中の場合、更新は次のチェックまで待機します。スイープ、gfix検証、gstatはブロックしません。これらは繰り返し実行できます。
- 一度に1つのエンジン複数のFirebirdインスタンスがあるサーバーでは、一度に1つだけが更新されます。
- 容量とロックされたファイルFirebirdが停止する前に、空き容量と別のプログラムが保持しているファイルが確認されます。ファイルを置き換えられない場合、Firebirdは停止しません。
- あなたのファイルはそのままエージェントはディストリビューションファイルのみを置き換えます。firebird.conf、databases.conf、replication.conf、セキュリティデータベース、UDF、サードパーティプラグインはそのまま残ります。firebird.confには不足している必須パラメーターのみが追加されます。
- ロールバック置き換えられたファイルは更新バックアップに保持されます。ロールバックでそれらが戻されます。最後の2つのバックアップが保持されます。
- バージョンブロック自動または手動でロールバックされたビルドはブロックされます。1つのコマンドでブロックを解除できます。
- 未完了の更新プロセスが途中で停止した場合、管理者が前回の更新をロールバックまたは完了するまで、新しい更新は開始されません。
エージェントはOSパッケージ(apt、dnf)からインストールされたFirebirdを更新しません。ファイルはパッケージマネージャーが管理します。そのようなサーバーをHQbirdに移行する方法は以下で説明します。
テスト · databases.conf · 移行
管理者ツール
サーバーパフォーマンステスト
エージェントは週に1回、IBSurgeonテストを実行します:一時データベースの100万行に対するINSERT、UPDATE、DELETEです。テスト履歴は、ハードウェア、ディスク、設定の変更前後にサーバーがどのように動作したかを示します。
テストはディスクに負荷をかけるため、専用のウィンドウでのみ実行されます。一時データベースはFirebird自体が削除します。テスト中にエージェントがクラッシュした場合、ファイルは次回起動時に削除されます。
| 時間枠 | 土 22:00 — 日 06:00 |
|---|---|
| 開始 | 日 01:00 |
| 行数 | 1 000 000 |
| 空きディスク容量 | 約 7.2 GiB、それ未満の場合はテストを開始しません |
| 履歴 | 直近 30 回の実行 |
| 同時実行 | テストは 1 つ。2 回目の実行はスキップされます |
Firebird ユーザー: Security.fdb/Users
専用の設定ページにサーバーのセキュリティデータベースが表示されます。共有のもの、プライベートなもの、データベースに埋め込まれたものです。ラベルは問題を示します。読み取り用のログインがない、一覧が更新されていない、エントリが古い、などです。
ユーザーを作成ボタンはエージェント経由で Firebird ユーザーを作成します。ウィンドウには、名前、パスワード(2 回)、UserManager 設定からのプラグイン、「アクティブ」と「管理者」のフラグがあります。管理者権限は 2 番目のステップで確認されます。実行前にコマンドのテキストが表示され、パスワードは隠されます。
作成はローカルエージェントで動作し、Firebird 2.5 では動作しません。
databases.conf エディター
ファイルはデータベースパスの一覧として表示されます。各パスにはエイリアスとパラメーターブロックがあります。パラメーター一覧には、この Firebird バージョンが単一のデータベースに対して受け入れるものだけが含まれます。その横に firebird.conf の値が表示されます。
エイリアスの重複と、同じパスに対する 2 つ目のブロックはエラーです。そのようなファイルは保存できません。パラメーター名の誤字にはヒントが表示されます。保存時に、エージェントはファイルを再度チェックし、以前のファイルのコピーをその横に保持します。編集中にファイルが変更された場合、エージェントは拒否し、あなたのテキストはエディターに残ります。フォームでの編集はファイル内のコメントに影響しません。各保存は監査ログに記録されます。
センターからは、ファイルは goafts 経由で配信されます。エージェントは約 1 分で適用し、結果を報告します。受理または拒否です。
HQbird への移行と設定の変更
FBDataGuard
古い HQbird 設定は自動的に引き継がれます
初回起動時に、エージェントは FBDataGuard の設定を見つけ、バックアップ、スイープ、インデックス統計のジョブを移行します。インポートは 1 回だけ実行されます。デフォルトではジョブは無効の状態で引き継がれます。インストーラーが FBDataGuard を無効にする場合、FBDataGuard が実行していて警告なしでインポートされたジョブを有効にします。これにより、サーバーがバックアップなしになることはありません。その他のジョブは無効のままです。確認してご自身で有効にしてください。エージェントは FBDataGuard のジャーナルから古いバックアップを自身の記録に取り込みます。保持とリストアでそれらが参照されます。
apt · dnf
OS パッケージからの Firebird
インストーラーはパッケージからインストールされた Firebird を検出し、何も変更せずに停止します。パッケージを削除し、セキュリティデータベース、databases.conf、データベースを保持するコマンドを表示します。その後、インストーラーは HQbird をインストールし、古いサーバーのユーザーとエイリアスを引き継ぎます。Firebird 2.5、3.0、4.0、5.0 でテスト済みです。
再起動なし
新しい設定をチェック付きで
エージェントは新しい設定をチェックし、古い設定のコピーを作成して、再起動なしで新しい設定を適用します。新しい設定が読み込まれない場合、エージェントは以前の設定に戻します。ほとんどの設定は再起動なしで適用されます。再起動が必要なのは、データフォルダー、エージェントログ、Local API、センターへの接続、Prometheus、クラスター、負荷制限、エージェントのタイムゾーンです。エージェントは、どの変更が再起動を待っているかを報告します。