ajsembdbrstr

形式

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以外のオプション,バックアップファイル,アンロードログファイルは同じものを指定してください。

別々のものを指定した場合,データを破壊してしまう場合がありますので十分注意してください。

次の場合,このオプションを指定してシステム領域を回復したあと,データ領域を回復してください。

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版の場合,ディレクトリは絶対パスで指定してください。指定する絶対パスに空白文字を含む場合はパスを「"(ダブルクォーテーションマーク)」で囲んでください。指定したディレクトリは,事前に作成しておいてください。ディレクトリがない場合はエラーになります。

指定したディレクトリには,次のファイルが格納されます。

ファイル名称はスクリプトで自動的に決定します。名称は,次の規則によって決定されます。

-rp

JP1/AJS2 - Datareplicator用の領域回復を行う場合に指定します。

JP1/AJS2 - Datareplicator用の領域が作成されていない環境でこのオプションを指定して実行するとエラーとなります。

-id 組み込みDBセットアップ識別子

組み込みDBを識別するセットアップ識別子を「_JAn」(nは0~9またはA~Z)の4文字で指定します。ajsembdbbuildコマンドの-idオプションで指定した値を指定してください。

このオプションを省略した場合は,_JA0が仮定されます。

-iオプションと同時に指定した場合,-iオプションが優先されます。

注意事項

戻り値

0正常終了。
0以外異常終了。

エラー発生時の対処

ajsembdbrstrを実行時,エラーが発生する場合があります。エラーが発生した場合は次の表に従って対処してください。

表1-29 ajsembdbrstr実行時のエラー発生時の対処

メッセージ原因対処
KFPR26227-Eアンロードログファイルが指定されていません。次の組み込みDBのコマンドを実行後に,-lにアンロードログファイルを指定して,再実行してください。

pdrels -r ALL -o

KAVS0996-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 -o

KFPS01984-E-iに指定したパスがフルパスで指定されていません。指定しているパスを見直して,pdstartコマンドを実行後に,再実行してください。
KFPH27008-ERDエリアが閉塞状態であるため,参照できません。次の組み込みDBのコマンドを実行後に,再実行してください。

pdrels -r ALL -o

Bad directory specified in -i option-iに指定したディレクトリが,組み込みDBの運用ディレクトリでないか,セットアップが正常に行われていません。-iに正しい組み込みDBの運用ディレクトリを指定してください。組み込みDBの運用ディレクトリの指定に問題がない場合は,組み込みDBの再セットアップを行ってください。
KAVS2104-E-idで指定したセットアップ識別子が不正か,組み込みDBがセットアップされていません。-idで指定したセットアップ識別子の値が正しいことを確認してください。または,スケジューラーサービスの データベースに組み込みDBを設定しているか,ajsstatusで確認してください。
KFPR26206-Eajsembdbrpsetupで作成される拡張領域がないため回復できません。ajsembdbrstrを実行した組み込みDBに,ajsembdbrpsetupで作成した拡張領域がありません。-rpオプションを指定せずにコマンドを実行してください。
KFPR16318-Eajsembdbbackupで取得したバックアップが,ajsembdbrpsetupで作成する拡張領域のバックアップを含んでいません。ajsembdbrpsetupを実行したあとにajsembdbbackupを実行してください。