vmiunit list管理ユニットまたは仮想サーバグループに属する仮想サーバの一覧表示

形式

vmiunit list [共通引数] -unit <管理ユニット名>
            [-group <仮想サーバグループ名>] [-format {list|xml}]

機能

管理ユニットに属するすべての仮想サーバ,または仮想サーバグループ内の仮想サーバの情報を一覧で表示します。一覧には,仮想サーバの情報が仮想サーバ識別子の昇順で出力されます。

引数

-unit <管理ユニット名>
表示対象の管理ユニットの名称を指定します。
-group <仮想サーバグループ名>
表示対象の仮想サーバグループの名称を指定します。
-format {list | xml}
一覧の表示形式を指定します。デフォルト値はlistです。
list
仮想サーバごとに一覧情報を表示します。
xml
仮想サーバグループ情報ファイルの形式で表示します。仮想サーバグループ情報ファイルの形式については,マニュアル「アプリケーションサーバ リファレンス 定義編(サーバ定義)」の「11.13 仮想サーバグループ情報ファイル」を参照してください。

入力例・出力例

入力例
  • 仮想サーバごとに一覧情報を表示する場合
    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