Hitachi

JP1 Version 12 JP1/Integrated Management 2 - Manager コマンド・定義ファイル・APIリファレンス


jcfcolvmhcsm

〈このページの構成〉

機能

HCSMから仮想化構成情報を取得し,仮想化構成情報ファイルに出力します。

なお,このコマンドを実行するための前提条件については,マニュアル「JP1/Integrated Management 2 - Manager 構築ガイド」の「3.3.1(1) 仮想化構成を管理するための前提条件」を参照してください。

形式

jcfcolvmhcsm
          -u ユーザーID
          -p パスワード
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

Windowsの場合:Administrators権限(WindowsのUAC機能が有効な場合は管理者コンソールから実行)

UNIXの場合:スーパーユーザー権限

格納ディレクトリ

Windowsの場合

Managerパス\bin\imcf\

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先HCSMのアカウントのユーザーIDを指定します。ユーザーIDは,制御文字を含まない255バイト以内の文字列で指定します。

-p パスワード

-uオプションで指定したユーザーIDのパスワードを指定します。パスワードは,制御文字を含まない255バイト以内の文字列で指定します。

-port ポート番号

接続先HCSMと通信するためのポート番号を指定します。ポート番号は,1〜65535の半角数字で指定します。このオプションを指定しなかった場合,23015が仮定されます。

-c ホスト名 [ホスト名]

HCSMが動作しているホストのホスト名を指定します。ホスト名は,255文字以内で指定します。オプションのあとに空白,またはタブ区切りで複数記述します。

-o 出力ファイル名

HCSMから取得した構成情報を格納する仮想化構成情報ファイルのファイル名を,相対パスまたは絶対パス形式で指定します。このオプションは省略できません。パスに空白を含む場合は,「"」で囲みます。

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

JavaVMの起動エラーが発生した

4

実行権限エラー

5

管理者コンソールから実行されなかった

6

出力ファイルがすでに存在する

7

仮想化構成情報の取得に失敗※2

8

入出力エラーが発生した

99

その他のエラー

注※1

一部取得できなかった仮想化構成情報があった場合も,コマンドとしては正常終了になります。

注※2

仮想化構成情報をどのホストからも取得できなかった場合に,戻り値を返します。

仮想化構成情報ファイルの形式

表1‒13 ヘッダー情報(1行目)

項目

出力値

仮想化構成情報ファイルの識別文字列

#VM

ファイルフォーマットバージョン

101000

文字コード

UTF-8固定

表1‒14 ヘッダー情報(2行目)

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

仮想化管理製品のバージョン

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

表1‒15 出力項目(3行目以降)

項目

説明

ホスト名

ホスト名。

VMMホスト名

仮想化環境ソフトウェアが稼働するホストのホスト名。

ゲストOSが存在しないVMMホストの場合,仮想ホスト名が空白で,VMMホスト名だけ設定される。

仮想化管理種別

仮想化構成を管理する製品の種別。

HCSMの場合:HCSM

日立サーバ論理分割機構の場合:Virtage

仮想化管理製品のバージョン

仮想化構成を管理する製品のバージョン。

仮想化管理種別がHCSMの場合,HCSMの外部接続インターフェースのバージョンが設定される。

なお,仮想化構成情報をHCSMから収集した場合,仮想化管理種別がVirtageのホストではバージョンを収集できない。

仮想化構成管理ホスト

VMMホストを管理するホスト名。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
WIN-T0NFDNMQ29E,,HCSM,7.2,
10.197.62.41,,Virtage,,WIN-T0NFDNMQ29E
bs20071-1,10.197.62.41,,,
WIN-77MGIUCU8P0,,,,WIN-T0NFDNMQ29E
guest01,,,,WIN-T0NFDNMQ29E