Tuning Manager - Agents

[目次][索引][前へ][次へ]

18.2.7 htmhsrestore

形式

htmhsrestore     -dir リストア対象のバックアップデータ格納先ディレクトリ
                [-key サービスキー [-inst インスタンス名]
                [-lhost 論理ホスト名]]

機能

htmhsrestoreコマンドは，htmhsbackupコマンドでバックアップしたパフォーマンスデータおよび定義情報をリストアするコマンドです。リストアの実行単位は次のとおりです。

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

HTM - Agent for RAID，またはHTM - Agent for NASがインストールされているホスト

実行権限

Windowsの場合
Administrators権限を持つユーザー（WindowsのUAC機能が有効な場合は管理者コンソールから実行）

UNIXの場合
rootユーザー権限を持つユーザー

格納先ディレクトリ

Windowsの場合
インストール先フォルダ\htnm\bin\

UNIXの場合
/opt/jp1pc/htnm/bin/

引数

htmhsrestoreコマンドの引数を次の表に示します。

表18-7 htmhsrestoreコマンドの引数一覧

引数 説明
-dir リストア対象のバックアップデータ格納先ディレクトリ リストア対象のバックアップデータ格納先ディレクトリを指定します。ディレクトリは，パス長が1~80バイトの絶対パスで指定します。
指定できる文字は，次の文字を除く，半角英数字，半角記号および半角空白です。
; , * ? ' " < > |
また，パスに空白文字を含む場合はダブルクォーテーション（"）で囲んで指定します。
なお，次の指定はできません。
  • シンボリックリンク
  • ネットワークドライブ
  • ネットワークディレクトリ
-key サービスキー エージェントのサービスキーを指定します。 省略した場合，htmhsbackupコマンドでバックアップしたすべてのバックアップデータがリストア対象になります。
-inst インスタンス名 -keyオプションを指定した場合に有効となるオプションです。インスタンス名を指定します。 省略した場合，-keyで指定したエージェントのすべてのインスタンスがリストア対象になります。
-lhost 論理ホスト名 論理ホスト名を指定します。論理ホストのパフォーマンスデータをリストア対象にする場合に必ず指定します。マルチインスタンスでは-instオプションも合わせて必ず指定します。

前提条件

htmhsrestoreコマンドを実行して，リストアを実行する際の前提条件を次に示します。

Hybrid Storeの出力先ディレクトリをデフォルトから変更している場合は，次の条件も考慮する必要があります。

注意事項

戻り値

0 正常終了した。
1 指定したオプションが不正である。
4 リストア対象エージェントのインスタンスの次のサービスが起動している。または，サービスの起動コマンド，停止コマンド，セットアップコマンドが実行中である。
  • PFM - Agent
  • PFM - Manager
  • Tuning Manager Agent REST API コンポーネント
10 指定したエージェントがインストールされていない。
100 指定したインスタンスが存在しない。
101 次のどれかの原因で，リストアに失敗した。
  • ホストにHybrid Storeへ移行中のエージェントが存在する。
  • -keyオプションを指定している場合：
    -keyオプションで指定したエージェントのPerformanceデータベースがHybrid Storeになっていない。
  • -keyオプションを省略した場合：
    一部またはすべてのエージェントのPerformanceデータベースがHybrid Storeになっていない。
102 指定したディレクトリが存在しない。
103 リストア先のインスタンス名とバックアップデータのインスタンス名が一致していない。
104 リストア先エージェントのバージョンおよびリビジョンと，バックアップデータのエージェントのバージョンおよびリビジョンが一致していない。
105 ディレクトリを絶対パスで指定していない。
106 指定したディレクトリのパス長が上限を超えている。
110 容量が不足している。
111 ホストの環境が不正である。
200 メモリーが不足しているため，リストアに失敗した。
210 リストア中に容量が不足したため，リストアに失敗した。
211 ファイルまたはディレクトリにアクセスできないため，リストアに失敗した。
212 指定したディレクトリに必要なプロパティファイルが存在しない，もしくは指定したディレクトリが空である。または，バックアップデータのプロパティで設定した出力先ディレクトリの値が正しくない。
254 一部またはすべてのAgentインスタンスで，リストアに失敗した。
255 プロパティで設定した出力先ディレクトリの値が正しくない。または，予期しないエラーが発生した。

[目次] [前へ] [次へ]

[マニュアル発行元]

All Rights Reserved. Copyright© 2014, 2020, Hitachi, Ltd.