vmiunit list(管理ユニットまたは仮想サーバグループに属する仮想サーバの一覧表示)
形式
vmiunit list [共通引数] -unit <管理ユニット名> [-group <仮想サーバグループ名>] [-format {list|xml}]
機能
管理ユニットに属するすべての仮想サーバ,または仮想サーバグループ内の仮想サーバの情報を一覧で表示します。一覧には,仮想サーバの情報が仮想サーバ識別子の昇順で出力されます。
引数
- -unit <管理ユニット名>
-
表示対象の管理ユニットの名称を指定します。
- -group <仮想サーバグループ名>
-
表示対象の仮想サーバグループの名称を指定します。
- -format {list | xml}
-
一覧の表示形式を指定します。デフォルト値はlistです。
- list
-
仮想サーバごとに一覧情報を表示します。
- xml
-
仮想サーバグループ情報ファイルの形式で表示します。仮想サーバグループ情報ファイルの形式については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「9.2.12 仮想サーバグループ情報ファイル」を参照してください。
入力例・出力例
- 入力例
-
-
仮想サーバごとに一覧情報を表示する場合
vmiunit list -unit gyoumu01
vmiunit list -unit gyoumu01 -group group02
-
管理ユニットに属するすべての仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合
vmiunit list -unit gyoumu01 -format xml
vmiunit list -unit gyoumu01 -group group02 -format xml
-
- 出力例
-
仮想サーバごとに一覧情報を表示する場合
-
ティアが一つのとき
Virtual Server ID: 192.168.0.11 Server Communication Agent Port: 20580 Service IP Address: 192.168.20.1 Tier ID: combined-tier-001 Group Name: group01 (空行) Virtual Server ID: 192.168.0.13 Server Communication Agent Port: 20580 Service IP Address: 192.168.20.3 Tier ID: combined-tier-001 Group Name: group02
-
ティアが複数のとき
Virtual Server ID: 192.168.0.11 Server Communication Agent Port: 20580 Service IP Address: 192.168.20.1 Tier ID: http-tier-001 Group Name: group01 (空行) Virtual Server ID: 192.168.0.12 Server Communication Agent Port: 20580 Service IP Address: 192.168.20.2 Tier ID: j2ee-tier-01 Group Name: group01 (空行) Virtual Server ID: 192.168.0.13 Server Communication Agent Port: 20580 Service IP Address: 192.168.20.3 Tier ID: http-tier-001 Group Name: group02
管理ユニットに属するすべての仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合
-
ティアが一つのとき
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0"> <group name="set_001"> <virtualserver tier="combined-tier-01" ip="111.111.111.101" port="20580" serviceip="111.111.155.101"/> </group> <group name="set_002"> <virtualserver tier="combined-tier-01" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/> </group> :
-
ティアが複数のとき
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0"> <group name="set_001"> <virtualserver tier="http-tier" ip="111.111.111.101" port="20580" serviceip="111.111.155.101"/> <virtualserver tier="j2ee-tier-01" ip="111.111.222.101" port="20580" serviceip="111.111.166.101"/> </group> <group name="set_002"> <virtualserver tier="http-tier" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/> <virtualserver tier="j2ee-tier-01" ip="111.111.222.102" port="20580" serviceip="111.111.166.102"/> </group> :
仮想サーバグループ内の仮想サーバの情報を仮想サーバグループ情報ファイルの形式で表示する場合
-
ティアが一つのとき
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0"> <group name="set_002"> <virtualserver tier="combined-tier-01" ip="111.111.111.002" port="20580" serviceip="111.111.155.002"/> </group> </virtualserver-info>
-
ティアが複数のとき
<virtualserver-info xmlns="http://www.cosminexus.com/mngsvr/schema/VirtualServerInfo-1.0"> <group name="set_002"> <virtualserver tier="http-tier-001" ip="111.111.111.102" port="20580" serviceip="111.111.155.102"/> <virtualserver tier="j2ee-tier-01" ip="111.111.222.102" port="20580" serviceip="111.111.166.102"/> </group> </virtualserver-info>
-
出力ヘッダ
仮想サーバごとに一覧情報を表示する場合の出力ヘッダの意味を次に示します。
- Virtual Server ID
-
仮想サーバの仮想サーバ識別子が出力されます。
- Server Communication Agent Port
-
仮想サーバのサーバ通信エージェント接続ポートが出力されます。
- Service IP Address
-
仮想サーバの業務用IPアドレスが出力されます。
管理ユニットへの仮想サーバの登録時に省略した場合は,仮想サーバ識別子と同じIPアドレスが出力されます。
- Tier ID
-
仮想サーバに割り当てられているティア識別子が出力されます。
- Group Name
-
仮想サーバグループの名称が出力されます。
戻り値
- 0:
-
正常終了しました。
- 64:
-
異常終了しました。
エラーおよび警告条件
項番 |
エラー・警告条件 |
戻り値 |
---|---|---|
1 |
指定された管理ユニットがありません。 |
64 |
2 |
指定された仮想サーバグループがありません。 |
64 |
3 |
指定された管理ユニットに仮想サーバグループが一つも登録されていません。 |
64 |