1.7.6 restoresystem(JP1/AOシステムのリストア)
機能
backupsystemコマンドで取得したJP1/AOの設定情報やデータベース情報のバックアップデータをリストアします。
コマンド実行時にリストアするデータを次に示します。
-
タスク※
-
デバッグタスク※
-
タスクの履歴
-
サービス
-
デバッグサービス
-
サービステンプレート
-
ユーザー
-
ユーザーグループ
-
サービスグループ
-
エージェントレス接続先定義
-
サービス共有プロパティ
-
各種定義ファイル
- 注※
-
リストア後のタスクおよびデバッグタスクの状態は次のように変更されます。
表1‒18 バックアップ時とリストア後のタスクおよびデバッグタスクの状態 バックアップ時のタスクおよびデバッグタスクの状態
リストア後のタスクおよびデバッグタスクの状態
待機中
キャンセル(タスクおよびデバッグタスクの終了日時にはリストアした日時が設定されます)
保留中
実行中
失敗
応答待ち中
異常検出
停止中
正常終了
正常終了
失敗
失敗
キャンセル
キャンセル
形式
restoresystem /dir バックアップデータのパス [/auto]
引数
- /dir バックアップデータのパス
-
backupsystemコマンドで指定したバックアップデータが格納されているバックアップフォルダのパスを絶対パスまたは相対パスで指定します。
- /auto
-
JP1/AO,JP1/OAおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行します。このオプションを省略した場合は,JP1/AO,JP1/OAおよびHitachi Command Suite製品のサービスとデータベースの停止・開始を自動で実行しません。
なお,クラスタ環境でこのオプションを指定する場合は,クラスタソフトに登録したサービスがオフラインである必要があります。
実行権限
Administrators権限またはroot権限を持つユーザーで実行してください。Administrators権限またはroot権限がない場合は,権限昇格を求めるメッセージが表示されます。
注意事項
-
このコマンドは実行時に一時ファイルが作成されます。このため,バックアップファイルを格納するフォルダに十分な空き容量があることを確認してください。必要な空き容量は次のとおりです。
バックアップ対象ファイルの容量+20MB
-
このコマンドでは,次のファイルはリストアされません。必要に応じて手動で再設定してください。
-
https接続用のSSLサーバ証明書ファイル
-
https接続用の秘密鍵ファイル
-
公開鍵認証用の秘密鍵ファイル
-
作成したクラスタサービス制御コマンド(Linuxでクラスタ構成の場合)
https接続用のファイルはuser_httpsd.confファイル,公開鍵認証用のファイルはユーザー設定プロパティファイル(config_user.properties)で定義されている,それぞれの格納先に配置してください。
-
-
autoオプションを指定しない場合,JP1/AOのサービスが停止していることを確認してからこのコマンドを実行してください。
停止していない場合は,hcmds64srvコマンドにstopオプションを指定して実行し,サービスを停止してください。
-
JP1/AOのインストールパスに半角スペースが含まれる場合,半角の直前までのパスと同名のパスのファイルやフォルダが存在すると,restoresystemコマンドの実行が戻り値114で失敗します。この現象が発生した場合は,該当ファイルまたはフォルダを別のパスに移動してください。その後,JP1/AOを再インストールし,restoresystemコマンドを再度実行してください。
(例)JP1/AOを"C:\Program Files\HITACHI\JP1AO"にインストールしていて,"C:\Program"のファイルまたはフォルダが存在した場合restoresystemコマンドの実行に失敗します。
-
リストアしたタスクおよびデバッグタスクは,次の操作を選択できません。
-
失敗したステップからリトライ
-
失敗した次のステップからリトライ
-
-
リストアしたタスクおよびデバッグタスクは,ステップの進捗や状態が表示されません。
戻り値
コマンドの戻り値を次の表に示します。
戻り値 |
説明 |
---|---|
0 |
正常に終了しました。 |
1 |
引数が不正です。 |
2 |
コマンドの実行を中断しました。 |
3 |
サービスの状態が不正です。 |
4 |
ほかのコマンドを実行中です。 |
7 |
パスの指定が不正です。 |
9 |
指定したパスが存在しません。 |
10 |
指定したパスにアクセスできません。 |
14 |
コマンドの実行権限がありません。 |
110 |
リストアの実行に失敗しました。 |
111 |
サービスの開始/停止に失敗しました。 |
113 |
バックアップファイルが不正です。 |
114 |
スケジューラーデータベースへのアクセスエラーが発生しました。 |
255 |
そのほかのエラーでコマンドの実行が中断しました。 |
使用例
Windowsで,指定したバックアップフォルダ(C:\Users\Backup)のデータをリストアする場合のコマンドの使用例を示します。
restoresystem /dir C:\Users\Backup /auto