JP1/Automatic Job Management System 2 コマンドリファレンス
形式
ajsembdbrstr
[-mh 論理ホスト名]
[-M]
-i 組み込みDB運用ディレクトリ
-d データ領域名称
-bf バックアップファイル
[-l アンロードログファイル1,アンロードログファイル2,...|-lr]
-e 出力結果ファイル格納ディレクトリ
[-rp]
[-id 組み込みDBセットアップ識別子]
機能
組み込みDBをバックアップ,またはバックアップとアンロードログファイルを使ってリストアします。
実行権限
Windowsの場合:Administrators権限
UNIXの場合:スーパーユーザー権限
格納先ディレクトリ
- Windowsの場合
- JP1/AJS2 - Managerのインストール先フォルダ\tools\
- UNIXの場合
- /opt/jp1ajs2/tools/
引数
-mh 論理ホスト名
クラスタ運用環境で実行する場合に指定します。論理ホスト名を指定してください。指定できる文字数は,1〜32(単位:バイト)です。ajsembdbbuild -mhで指定した値と同じ値を指定してください。省略した場合,環境変数JP1_HOSTNAMEの設定があれば,環境変数値が仮定されます。
-M
システム領域を回復する時に指定してください。
システム領域とは,組み込みDBのシステムの内部情報を格納している領域のことです。
組み込みDBのシステム領域を回復する場合には,システム領域を回復するための特別なモードで起動する必要があります。
このモードでは,データ領域の回復を行うことができないので,システム領域の回復が完了したあと,一度ajsembdbstopコマンドを実行して組み込みDBを停止させ,再度ajsembdbstartコマンドにオプションを指定しないで再開始する必要があります。
システム領域とデータ領域を回復する場合,-M以外のオプション,バックアップファイル,アンロードログファイルは同じものを指定してください。
別々のものを指定した場合,データを破壊してしまう場合がありますので十分注意してください。
次の場合,このオプションを指定してシステム領域を回復したあと,データ領域を回復してください。
- 組み込みDBサーバが障害により停止し,再起動しても起動しない場合。
- 組み込みDBの障害を取り除いてください。
- ajsembdbstartコマンドに-rオプションを指定して実施し,システム領域回復可能な状態で組み込みDBを起動してください。
- ajsembdbrstrに-Mオプションを指定して実行し,組み込みDBのシステム領域を回復してください。
- 3.が正常に終了した場合,ajsembdbstopコマンドを実施し,システム領域を回復できる状態で起動している組み込みDBを停止させてください。
- 組み込みDBのajsembdbstartコマンドを実施し,通常の状態で組み込みDBを起動してください。
- ajsembdbrstrを実行し,組み込みDBのデータ部分の回復を行ってください。
ajsembdbstartコマンドおよびajsembdbstopコマンドの詳細については,「1. コマンド ajsembdbstart」および「1. コマンド ajsembdbstop」を参照してください。
-i 組み込みDB運用ディレクトリ
組み込みDBの運用ディレクトリを指定します。ディレクトリは絶対パスで指定してください。Windows版の場合,指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。ajsembdbbuild -iで指定したディレクトリと同じディレクトリを指定してください。UNIXのセットアップでajsembdbbuild -iを省略した場合は,このオプションを省略できます。
省略時は/opt/HiRDB_J/が仮定されます。
このオプションは,下位バージョン互換のためのオプションです。08-00以降に構築した組み込みDB,またはセットアップ識別子の設定を行った環境では,このオプションではなく,-idオプションを指定してください。
-idオプションと同時に指定した場合,-iオプションに指定した値が有効になります。
-d データ領域名称
組み込みDBのデータ領域名称を指定します。ディレクトリは絶対パスで指定してください。Windows版の場合,指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。ajsembdbbuild -dで指定した場合は次のように指定してください。
- Windowsの場合
- [-dで指定したディレクトリ名称]\ajssys02
- UNIXの場合
- [-dで指定したディレクトリ名称]/ajssys02
ajsembdbbuild -aで指定した場合は次のように指定してください。
- Windowsの場合
- [-aで指定したRDエリアパーティション]
- UNIXの場合
- [-aで指定したRDエリアパーティション]
-bf バックアップファイル
ajsembdbbackupで取得したバックアップファイルを指定します。
ディレクトリは絶対パスで指定してください。Windows版の場合,指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。
-l アンロードログファイル1,アンロードログファイル2...
組み込みDBで取得したアンロードログファイルを回復で使用する場合に指定します。このオプションは組み込みDB環境構築時に-blオプションを指定した場合に指定してください。
アンロードログファイルは絶対パスで指定してください。Windows版の場合,指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。アンロードログファイルを指定する場合,指定する順番はアンロードログファイルを取得した順番に指定してください。また,2個以上の複数のアンロードログファイルを指定する場合も,-lから後ろのパスは「"(ダブルクォーテーションマーク)」で囲んでください。
バックアップ取得時に,-sを指定していない場合は,アンロードログファイルの入力を省略できます。その場合は,バックアップ取得時点までデータベースを回復します。
-lr
システムログとバックアップで回復する運用を適応しているときに指定してください。
バックアップ取得時にajsembdbbackupのオプションに-zを指定していない場合は,このオプションを指定するとエラーになります。
-e
リストアの出力結果ファイルを格納するディレクトリを指定してください。Windows版の場合,ディレクトリは絶対パスで指定してください。指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。指定したディレクトリは,事前に作成しておいてください。ディレクトリがない場合はエラーになります。
指定したディレクトリには,次のファイルが格納されます。
- 処理出力結果ファイル
ファイル名称はスクリプトで自動的に決定します。名称は,次の規則によって決定されます。
- 出力結果ファイル:RSTR_XXXXYYZZVVWW.log
XXXX:西暦
YY:月
ZZ:日
VV:時間
WW:分
-rp
JP1/AJS2 - Datareplicator用の領域回復を行う場合に指定します。
JP1/AJS2 - Datareplicator用の領域が作成されていない環境でこのオプションを指定して実行するとエラーとなります。
-id 組み込みDBセットアップ識別子
組み込みDBを識別するセットアップ識別子を「_JAn」(nは0〜9またはA〜Z)の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。
このオプションを省略した場合は,_JA0が仮定されます。
-iオプションと同時に指定した場合,-iオプションが優先されます。
注意事項
- ajsembdbrstrを実行する前に次の組み込みDBのコマンドを実行してください。
pdlogswap -d sys- スケジューラーサービスを停止した状態で実行してください。
- リストア実行時にエラーが発生した場合,データベースの回復が不完全である場合があります。エラーが発生した場合,そのままスケジューラーサービスを起動しないでください。
- ajsembdbbackupのオプションに-sを指定してバックアップを取得した場合,ajsembdbrstrスクリプトでのリストアでは,入力情報としてアンロードログファイル,またはシステムログファイルが必要になります。
- ajsembdbbackupのオプションに-sを指定しないでバックアップを取得した場合,ajsembdbrstrスクリプトでのリストアではアンロードログファイル,またはシステムログファイルを参照しないでバックアップファイルだけで回復を行うことができます。その場合,バックアップ取得時までデータベースを回復できます。
- リストアが正常終了したあと,バックアップを取得してください。
- コマンドの実行結果は,ログファイルに出力されます。格納先は,次の場所になります。
- Windowsの場合
- JP1/AJS2 - Managerのインストール先フォルダ\log
ファイル名はajsembdbrstr.logです。このファイルは,上書きしないためファイルサイズが無限に大きくなります。必要に応じて,編集,削除を行ってください。
- UNIXの場合
- /var/opt/jp1ajs2/log
このファイルが存在しない場合は,ajsembdbrstrを実行すると,新たに作成されます。
- ajsembdbrstr実行時にエラーが発生した場合は,組み込みDBのデータ格納領域は閉塞状態になっています。この状態で再度ajsembdbrstrを実行するとエラーが発生します。その場合,次の組み込みDBのコマンドを実行して,データ格納領域の閉塞状態を解除してください。
pdrels -r ALL -o- 組み込みDBの環境を削除して,再構築したあとにデータを回復する場合は,ajsembdbsetupが完了した状態でajsembdbrstrを実行してください。
また,ajsembdbaddareaコマンドで組み込みDBのデータ領域またはインデクス領域を拡張していた場合は,このコマンドの実行前に同様の拡張を行っておく必要があります。拡張手順を次に示します。
Windowsの場合
- 次のフォルダを退避する。
組み込みDB運用フォルダ\CONF\embrm
- ajsembdbunsetコマンドを実行する。
- ajsembdbbuildコマンドを実行する。
- ajsembdbsetupコマンドを実行する。
- 手順1で退避したフォルダにあるaddareaファイルをaddarea.batにリネームして実行する。
- ajsembdbrstrコマンドを実行する。
- 手順5でリネームしたファイル名をaddareaに戻す。
- 手順1で退避したフォルダを次のフォルダにリストアする。
組み込みDB運用フォルダ\CONF
- 手順1で退避したフォルダを削除する。
UNIXの場合
- 次のディレクトリを退避する。
組み込みDB運用ディレクトリ/conf/embrm
- ajsembdbunsetコマンドを実行する。
- ajsembdbbuildコマンドを実行する。
- ajsembdbsetupコマンドを実行する。
- 手順1で退避したディレクトリにあるaddareaファイルのパーミッションに実行権限を追加して実行する。
- ajsembdbrstrコマンドを実行する。
- 手順1で退避したディレクトリを次のディレクトリにリストアする。
組み込みDB運用ディレクトリ/conf
- 手順1で退避したディレクトリを削除する。
- -lオプションを指定するとき,実際に指定したアンロードログファイルに更新情報が格納されていない場合,ajsembdbrstrがエラーとなります。
- Windows Server 2008のホストでこのコマンドを実行する際には,コマンドプロンプトを管理者として起動する必要があります。コマンドプロンプトを起動する際は,Windowsの[スタート]メニューの[コマンドプロンプト]を右クリックし,ショートカットメニューから[管理者として実行]を選択してください。UAC機能が無効の場合は,コマンドプロンプトを管理者として起動する必要はありません。
戻り値
0 正常終了。 0以外 異常終了。
エラー発生時の対処
ajsembdbrstrを実行時,エラーが発生する場合があります。エラーが発生した場合は次の表に従って対処してください。
表1-29 ajsembdbrstr実行時のエラー発生時の対処
メッセージ 原因 対処 KFPR26227-E アンロードログファイルが指定されていません。 次の組み込みDBのコマンドを実行後に,-lにアンロードログファイルを指定して,再実行してください。
pdrels -r ALL -oKAVS0996-E
- 引数に誤りがあります。
- オプションの指定が不足しています。
- 同時に指定できないオプションが指定されています。
- -iに指定したパスが組み込みDB運用ディレクトリではありません。または,読み取り権限がありません。
指定している引数を見直して,再実行してください。 KFPR00765-I Pdrstr terminated, return code=8またはKFPR00765-I Pdrstr terminated, return code=12
- -mhに指定したホスト名が誤っています。
- -d,-bf,-e,-lに指定したパスが誤っています。
- -d,-bf,-e,-lに指定したパスがフルパスで指定されていません。
指定しているパスを見直し,次の組み込みDBのコマンドを実行後に,再実行してください。
pdrels -r ALL -oKFPS01984-E -iに指定したパスがフルパスで指定されていません。 指定しているパスを見直して,pdstartコマンドを実行後に,再実行してください。 KFPH27008-E RDエリアが閉塞状態であるため,参照できません。 次の組み込みDBのコマンドを実行後に,再実行してください。
pdrels -r ALL -oBad directory specified in -i option -iに指定したディレクトリが,組み込みDBの運用ディレクトリでないか,セットアップが正常に行われていません。 -iに正しい組み込みDBの運用ディレクトリを指定してください。組み込みDBの運用ディレクトリの指定に問題がない場合は,組み込みDBの再セットアップを行ってください。 KAVS2104-E -idで指定したセットアップ識別子が不正か,組み込みDBがセットアップされていません。 -idで指定したセットアップ識別子の値が正しいことを確認してください。または,スケジューラーサービスの データベースに組み込みDBを設定しているか,ajsstatusで確認してください。 KFPR26206-E ajsembdbrpsetupで作成される拡張領域がないため回復できません。 ajsembdbrstrを実行した組み込みDBに,ajsembdbrpsetupで作成した拡張領域がありません。-rpオプションを指定せずにコマンドを実行してください。 KFPR16318-E ajsembdbbackupで取得したバックアップが,ajsembdbrpsetupで作成する拡張領域のバックアップを含んでいません。 ajsembdbrpsetupを実行したあとにajsembdbbackupを実行してください。
Copyright (C) 2006, 2010, Hitachi, Ltd.
Copyright (C) 2006, 2010, Hitachi Software Engineering Co., Ltd.