jpctool db restore

〈このページの構成〉

形式
機能
コマンドを実行できるホスト
実行権限
格納先ディレクトリ
引数
注意事項
戻り値
使用例1
使用例2

形式

jpctool db restore     -key サービスキー
                       -d ディレクトリ名
                       [-lhost 論理ホスト名]
                       [-inst インスタンス名]

ページの先頭へ

機能

jpctool db restoreコマンドは，jpctool db backupコマンドでバックアップしたMaster Storeサービス，Agent Storeサービス，またはRemote Monitor Storeサービスのデータベースのデータをリストアするコマンドです。

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

Agent StoreおよびRemote Monitor Storeサービスのデータは，Storeデータベースのバージョンが同一の場合だけリストアできます。

ページの先頭へ

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

PFM - Manager
PFM - Agent
PFM - RM

ページの先頭へ

実行権限

Windowsの場合

Administrators権限を持つユーザー
Backup Operators権限を持つユーザー

UNIXの場合

rootユーザー権限を持つユーザー

ページの先頭へ

格納先ディレクトリ

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

ページの先頭へ

引数

-key サービスキー

リストアするデータのサービスキー名を指定します。プロダクト名表示機能が有効な場合はプロダクト名でも指定できます。Master Storeサービスのデータベースのデータをリストアする場合のサービスキーは，「Manager」または「mgr」です。Agent StoreおよびRemote Monitor Storeサービスのサービスキーについては，マニュアル「JP1/Performance Management 設計・構築ガイド」の付録の，命名規則について説明している個所を参照してください。

-d ディレクトリ名

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

; , * ? ' " < > |

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

-lhost 論理ホスト名

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

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

-inst インスタンス名

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

ページの先頭へ

注意事項

リストアする前に，リストアの対象となるPFM - Agent，PFM - RM，またはPFM - Managerのサービスを停止してください。
引数は，「形式」にある順番で指定してください。
リストアすると，既存のデータは削除されます。
リストアすると，サービス起動時にデータベースのインデックスが再構築されるため，再起動に時間が掛かる場合があります。
jpctool db backupコマンドでバックアップしたデータベースのデータモデルバージョンと異なるバージョンのデータベースにはリストアできません。
サービスキーがjpctool db backupコマンドでバックアップしたデータのものと異なる時はリストアできません。
コマンドの実行をCtrl+Cキーやシグナルで中断した場合，特定の戻り値が返りません。そのため，コマンドをCtrl+Cキーやシグナルで中断した場合は戻り値を無視してください。
Storeバージョンが1.0の場合は，インデックスが再構築されます。Storeバージョンが2.0の場合は，バックアップファイルにIDXファイルが含まれるため，インデックスは再構築されません。

ページの先頭へ

戻り値

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

ページの先頭へ

使用例1

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

jpctool db restore -key Windows -d "c:\program files\hitachi\jp1pc\agtt\store\backup\01"

ページの先頭へ

使用例2

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

jpctool db restore -key Oracle -d /opt/jp1pc/agto/store/inst1/backup/01 -lhost jp1-ha1 -inst inst1

ページの先頭へ