2.63.1 pdlogswapの形式と規則
(1) 機能
ログ関係のファイルをスワップします。スワップ先のファイルがない場合は,コマンドエラーとなります。
(2) 実行者
HiRDB管理者が実行できます。
(3) 形式
(a) HiRDB/シングルサーバの場合
pdlogswap -d sys 〔-s サーバ名〕 〔-w〔-t 有効化待ち監視時間〕 〔-m〕〕
(b) HiRDB/パラレルサーバの場合
pdlogswap -d sys -s サーバ名 〔-w〔-t 有効化待ち監視時間〕〕
(4) オプション
(a) -d sys
システムログファイルをスワップします。
(b) -s サーバ名 〜<識別子>((1〜8))
スワップするファイルグループに対応するサーバの名称を指定します。
(c) -w
システムログファイルのスワップ後に取得するシンクポイントダンプの有効化完了まで,コマンド実行の終了を遅延させる場合に指定します。
アンロードレスシステムログ運用の場合に,データベースのバックアップ取得直前にこのオプションを指定してシステムログファイルをスワップしておくと,次に示す運用上の利点があります。
-
データベースのバックアップ取得後にシステムログファイルをアンロード済みにする場合,バックアップ取得直前までに使用していたすべてのシステムログファイルをアンロード済みにできます。
-
データベースの回復時,データベース回復ユティリティの入力としなければならないシステムログファイルの数を最小限にできます。
(d) -t 有効化待ち監視時間 〜<符号なし整数>((10〜32768))《180》
-wオプションを指定してシンクポイントが有効化されるまでコマンド実行の終了を遅延させる場合に,シンクポイントダンプの有効化を監視する時間を秒単位で指定します。このオプションは,-wオプションを指定したときだけ有効となります。
(e) -m
リードレプリカ機能自動反映方式の更新DBで,シンクポイント有効化時点のシステムログブロックの位置情報を,更新DBのマスタディレクトリ用RDエリアに登録します。このオプションは,-wオプションを指定したときだけ有効となります。
なお,-tオプションで指定した時間を過ぎてタイムアウトした場合,KFPS01280-Eメッセージが出力され,コマンドは異常終了します(終了コード:8)。この場合,シンクポイント有効化完了メッセージ(KFPS02183-I)が出力されるまで待機し,有効化完了後に再度-mオプションを指定してコマンドを実行してください。
(5) 規則
-
pdlogswapコマンドは,HiRDBが稼働中のときだけ実行できます。
ただし,次の場合は実行できません。
-
HiRDB開始処理中のとき
-
HiRDB終了処理中のとき
-
pdstart -rコマンドでHiRDBが稼働中のとき
-
-
pdlogswapコマンドは,シングルサーバ又はシステムマネジャがあるサーバマシンで実行してください。
-
pdlogswapコマンド実行中の場合は,再度pdlogswapコマンドを実行できません。ただし,-wオプションを指定したpdlogswapコマンドがシンクポイントダンプの有効化待ちの状態のときには,-wオプションを指定しないpdlogswapコマンドを実行できます。
(6) 注意事項
-
pdlogswapコマンドの結果は,pdloglsコマンド,エラーメッセージ(KFPS01280-E(理由コードが105又は116))の有無,又はコマンド実行時のリターンコードで確認できます。コマンド実行時のリターンコードは, echo $statusによって求められます。コマンド実行時のリターンコードを次に示します。
- 0:
-
正常終了しました。
- 4:
-
システムログファイルはスワップしましたが,-tオプションでの有効化待ち監視時間を経過してもシンクポイントダンプが有効化されなかったので,強制的にコマンド処理を終了しました。
- 8:
-
異常終了しました。
-
-wオプションを指定してpdlogswapコマンドを実行し,-tオプションでの有効化待ち監視時間を経過してもシンクポイントダンプが有効化されない場合には,pdlogswapコマンドは強制的に処理を終了します。
-
pd_log_remain_space_checkオペランドにsafe又はwarnを指定している場合,次のどちらかに該当するときは,システムログファイルの空き容量監視機能によってシステムログファイルの空き容量不足と判定されることがあります。
-
スワップ先にできる状態,かつ待機の状態のファイルグループの容量が,現用のファイルグループの容量より少ない状態で,pdlogswapコマンドを実行した場合
-
pdlogswapコマンドを連続して実行した場合
システムログファイルの空き容量監視機能については,マニュアル「HiRDB システム運用ガイド」を参照してください。
-
-
-mオプション指定のpdlogswapコマンドは,更新DBでは実行できますが,参照DBでは実行できません。参照DBで実行した場合はエラーとなります(KFPS01280-E(理由コード:110))。-mオプション指定のpdlogswapコマンドを使用したリードレプリカ機能自動反映方式の環境構築手順については,マニュアル「HiRDBシステム運用ガイド」を参照してください。