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

ページの先頭へ