jpcresto

形式

jpcresto     サービスキー
            ディレクトリ名
           [lhost=論理ホスト名
           [inst=インスタンス名

機能

jpcrestoコマンドは,jpcctrl backupコマンドでバックアップしたMaster StoreサービスまたはAgent Storeサービスのデータベースのデータをリストアするコマンドです。

リストアできるのは,リストアを実行するホスト上に,リストア対象のデータがバックアップされている場合だけです。

Storeバージョンが2.0の場合は,Storeバージョンを2.0にして取得したバックアップデータだけリストアできます。また,Storeバージョンが1.0の場合も,Storeバージョンを1.0にして取得したときのバックアップデータだけリストアできます。

コマンドを実行できるホスト

実行権限

Windowsの場合
  • Administrators権限を持つユーザー
  • Backup Operators権限を持つユーザー
UNIXの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
インストール先フォルダ¥tools¥
UNIXの場合
/opt/jp1pc/tools/

引数

サービスキー

リストアするデータのサービスキー名を指定します。Master Storeサービスのデータベースのデータをリストアする場合のサービスキーは,「mgr」です。Agent Storeサービスのサービスキーについては,各PFM - Agentマニュアルの,付録に記載されている識別子一覧を参照してください。

ディレクトリ名

バックアップファイルが格納されているディレクトリ名を指定します。1~130バイトで指定します。半角英数字,半角記号,または半角空白文字で指定します。ただし,次の記号は指定できません。

; , * ? ' " < > |

空白文字を含む場合," "で囲んでください。

lhost=論理ホスト名

コマンドを実行するホスト環境を指定します。コマンドを実行するマシンに論理ホストが構成されている場合,この引数を使用します。1~32バイトの半角英数字で指定します。空白文字は,指定できません。

指定を省略した場合,物理ホストが仮定されます。ワイルドカード文字は使用できません。

inst=インスタンス名

特定のインスタンスのデータベースにリストアする場合は,インスタンス名を指定します。このオプションは,サービスキーにインスタンス環境を持つPFM - Agentを指定した場合だけ有効です。1~32バイトの半角英数字で指定します。

注意事項

戻り値

0正常終了した。
1引数の指定に誤りがある。
2コマンドの実行権限がない。
4Master StoreサービスもしくはAgent Storeサービス,またはjpcrestoコマンドがStoreデータベースにアクセス中にコマンドを実行した。
5指定されたサービスがインストールされていない。
6バックアップファイルまたはディレクトリがない。
100Performance Managementの環境が不正である。
102指定された論理ホスト名またはインスタンスは,セットアップされていない。
210ディスク容量が不足している。
211バックアップファイルまたはディレクトリにアクセスできない。
212インデックスの作成に失敗した。
255予期しないエラーが発生した。

使用例1

デフォルト位置にバックアップしたPFM - Agent for Platform(Windows)のAgent Storeサービスのデータをリストアする場合のコマンド実行例を次に示します。

jpcresto agtt "c:¥program files¥hitachi¥jp1pc¥agtt¥store¥backup¥01"

使用例2

論理ホスト(ホスト名:jp1-ha1)のPFM - Agent for Oracleのインスタンス名inst1のデータを,/opt/jp1pc/agto/store/inst1/backup/01からリストアする場合のコマンド実行例を次に示します。

jpcresto agto /opt/jp1pc/agto/store/inst1/backup/01 lhost=jp1-ha1 inst=inst1