Tuning Manager - Agents

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

18.2.6 htmhsmigrate

形式

htmhsmigrate execute     [-key サービスキー]
                         [–dir Hybrid Store移行後のデータの格納先ディレクトリ]

機能

htmhsmigrateコマンドは，PerformanceデータベースをStoreデータベースからHybrid Storeに移行するコマンドです。

このコマンドを使用すると，存在しているStoreデータベースのパフォーマンスデータをHybrid Storeのデータ形式に変換するとともに，Hybrid Storeで運用できる状態に移行します。そのため，Hybrid Storeのシステム要件（OS，ディスクの空き容量など）を満たす環境で，かつ一度にすべてのパフォーマンスデータを引き継ぎたい場合の使用に適しています。　

注意

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

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

実行権限

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

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

格納先ディレクトリ

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

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

引数

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

表18-6 htmhsmigrateコマンドの引数一覧

引数 説明
-key サービスキー エージェントのサービスキーを指定します。省略した場合，Hybrid Storeをサポートするすべてのエージェントが移行対象になります。
-dir Hybrid Store移行後のデータの格納先ディレクトリ Hybrid Store移行後のデータの格納先ディレクトリを指定します。格納先を指定した場合には，全てのインスタンスで，Hybrid Store移行後のデータを指定したパスに格納します。格納先を指定しなかった場合には，各インスタンスのStoreディレクトリ配下（Storeデータベースの格納先をデフォルトから変更している場合はその格納先）に移行後のデータを出力します。
ディレクトリは，パス長が1~80バイトの絶対パスで指定します。
指定できる文字は，次の文字を除く，半角英数字，半角記号および半角空白です。
; , * ? ' " < > |
また，パスに空白文字を含む場合はダブルクォーテーション（"）で囲んで指定します。
なお，次の指定はできません。
  • シンボリックリンク
  • ネットワークドライブ
  • ネットワークディレクトリ

前提条件

htmhsmigrateコマンドを実行して，StoreデータベースからHybrid Storeに移行する際の前提条件を次に示します。

注意事項

パフォーマンスデータの変換が途中で失敗した場合は，変換に失敗したインスタンスのデータを削除したあとに，コマンドを再実行してください。

戻り値

0 正常終了した。
1 指定したオプションが不正である。
3 Hybrid Storeで運用しているためコマンドの実行が無効である。
4 移行対象エージェントの次のサービスが起動している。または，サービスの起動コマンド，停止コマンド，セットアップコマンドが実行中である。
  • PFM - Agent
  • PFM - Manager
  • Tuning Manager Agent REST API コンポーネント
5 移行対象にStoreバージョン1.0のインスタンスが含まれている。
10 指定したエージェントがインストールされていない。
11 指定したエージェントの移行は正常終了したが，ほかに移行中のエージェントが存在している。
12 Hybrid Storeに移行できるエージェントが存在しない。
100 環境にSTDICT.DATファイルが存在しない。
101 次のどちらかが原因で，移行に失敗した。
  • Hybrid Storeをサポートするエージェントが存在しない。
  • 非サポート構成になってしまう指定である。
102 指定したディレクトリが存在しない。
103 移行するデータの格納先ディレクトリのパス長が上限を超えるため，移行するデータを格納できない。
105 ディレクトリを絶対パスで指定していない。
106 指定したディレクトリのパス長が上限を超えている。
110 容量が不足している。
200 メモリーが不足しているため，移行に失敗した。
210 移行中に容量が不足したため，移行に失敗した。
211 ファイルまたはディレクトリにアクセスできないため，移行に失敗した。
231 移行対象のデータが不正であるため，移行に失敗した。
232 次のどれかの原因で，設定の引き継ぎに失敗した。
  • ファイルまたはディレクトリにアクセスできない
  • マージ対象の設定ファイルの値が不正である
  • 予期しないエラーが発生した
233 Storeデータベースの削除に失敗した。
234 Tuning Manager APIの利用の有効化に失敗した。
235 設定ファイルの更新に失敗した。
236 インスタンス情報の更新に失敗した。
254 一部またはすべてのAgentインスタンスで，データベースの移行の設定に失敗した。
255 予期しないエラーが発生した。

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

[マニュアル発行元]

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