Hitachi

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


jcfcolvmkvm

〈このページの構成〉

機能

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

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

形式

jcfcolvmkvm
          -u ユーザーID
          -i 秘密鍵ファイルパス
          [-port ポート番号]
          -c ホスト名 [ホスト名]
          -o 出力ファイル名

実行権限

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

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

格納ディレクトリ

Windowsの場合

Managerパス\bin\imcf\

UNIXの場合

/opt/jp1imm/bin/imcf/

引数

-u ユーザーID

接続先KVMが動作しているホストのユーザーIDを指定します。ユーザーIDは,空白およびタブを含まない255バイト以内の半角文字列で指定します。

-i 秘密鍵ファイルパス

接続先KVMと通信するための秘密鍵ファイル名を絶対パス形式で指定します。秘密鍵ファイルパスは,制御文字を含まない256バイト以内の文字列で指定します。秘密鍵ファイルパスは,大文字,小文字を区別します。また,パスに空白を含む場合は,「"」で囲みます。

-port ポート番号

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

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

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

-o 出力ファイル名

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

戻り値

0

正常終了※1

1

引数エラー

2

メモリー不足

3

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

4

実行権限エラー

5

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

6

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

7

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

8

入出力エラーが発生した

99

その他のエラー

注※1

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

注※2

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

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

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

項目

出力値

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

#VM

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

101000

文字コード

UTF-8固定

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

項目

出力値

ホスト名

Host_name

VMMホスト名

VMM_host_name

仮想化管理種別

Virtual_manager_type

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

Manager_version

仮想化構成管理ホスト

Virtual_host_manager

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

項目

説明

ホスト名

ホスト名。

VMMホスト名

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

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

仮想化管理種別

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

KVMの場合,「KVM」を出力する。

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

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

仮想化構成管理ホスト

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

jcfcolvmkvmコマンドの場合,常に空白。

出力例

#VM,101000,UTF-8
Host_name,VMM_host_name,Virtual_manager_type,Manager_version,Virtual_host_manager
jp1-sf7800b,,KVM,0.12.1,
kv7801,jp1-sf7800b,,,
kv7802,jp1-sf7800b,,,
kv7803,jp1-sf7800b,,,
kv7804,jp1-sf7800b,,,