vmiunit status [共通引数] -unit <管理ユニット名>
               [-target {unit | virtualserver}]

管理ユニットまたは仮想サーバの状態を表示します。仮想サーバの状態を表示する場合，仮想サーバ識別子の昇順で出力されます。

-unit <管理ユニット名>

表示対象の管理ユニットの名称を指定します。

-target {unit | virtualserver}

表示対象を指定します。デフォルト値は，unitです。

unit

管理ユニットの状態を表示します。

virtualserver

管理ユニットに属する仮想サーバの状態を表示します。

管理ユニットの状態を表示する場合

vmiunit status -unit gyoumu01
vmiunit status -unit gyoumu01 -target unit

Definition Status: changed All Servers: 3 Active Servers: 2 Invalid Servers: 1

仮想サーバの状態を表示する場合

vmiunit status -unit gyoumu01 -target virtualserver

Virtual Server ID: 192.168.0.11 Update Scope: none Logical Status: working Observed Status: working LB Status: unblocked Access: online (空行) Virtual Server ID: 192.168.0.12 Update Scope: applications Logical Status: working Observed Status: working LB Status: blocked Access: online (空行) Virtual Server ID: 192.168.0.13 Update Scope: all Logical Status: working Observed Status: operating LB Status: unblocked (空行) Virtual Server ID: 192.168.0.14 Update Scope: all Logical Status: working Observed Status: stopped LB Status: blocked Access: offline MarkTime: 2009/08/10 15:01:23 JST MarkComment: 調査中

管理ユニットの状態を表示する場合

Definition Status

管理ユニットの定義の状態が表示されます。

• nonexistent
  管理ユニットの定義ディレクトリが何も取り込まれていません。
  
• changed
  仮想サーバの定義の変更範囲にnone以外が含まれます。
  
• latest
  仮想サーバの定義の変更範囲がすべてnoneです。
  

All Servers

管理ユニットに属する仮想サーバの数が出力されます。

Active Servers

業務を運用中の仮想サーバの数が出力されます。業務を運用中の仮想サーバとは，次の条件を満たすものです。

• 論理ステータス^※がworking
• 負荷分散機連携機能を有効にしている場合は負荷分散機ステータス^※がunblocked

Invalid Servers

不正な状態の仮想サーバの数を示します。不正な状態の仮想サーバとは，次のどちらかを満たすものです。

• 論理ステータス^※がfault
• 負荷分散機連携機能を有効にしている場合は負荷分散機ステータス^※がinvalidの仮想サーバを指します。

仮想サーバの状態を表示する場合

Virtual Server ID

仮想サーバ識別子が出力されます。

Update Scope

仮想サーバの定義の変更範囲が出力されます。

• none
  更新の必要はありません。
  
• applications
  アプリケーションの更新が必要です。
  
• all
  すべての定義の更新が必要です。
  

Logical Status

仮想サーバの論理ステータス^※が出力されます。

Observed Status

仮想サーバの実ステータス^※が出力されます。

LB Status

仮想サーバの負荷分散機ステータス^※が出力されます。

負荷分散機連携機能が無効な場合は出力されません。

Access

仮想サーバのサーバ通信エージェントとの通信状態が出力されます。

• online（正常）
  通信状態が正しいことを示します。
  
• offline（異常）
  通信状態が正しくないことを示します。この状態は，仮想サーバの電源が入っていない場合も出力されます。仮想サーバの実ステータス^※が「operating」の場合は，出力されません。
  

MarkTime

障害マークが設定された時刻が取得されます。

障害マークが設定されていない場合は出力されません。

MarkComment

障害マーク設定時に記入されたコメントを取得します。

障害マークが設定されていない場合は出力されません。

注※　仮想サーバのステータスには，論理ステータス，実ステータス，負荷分散機ステータスがあります。各ステータスの種類と意味を次に説明します。

• 論理ステータス
  仮想サーバマネージャが記憶している仮想サーバのステータスです。論理ステータスの種類と意味を次の表に示します。
  

  表9-3　論理ステータスの種類と意味

  ステータスの種類	意味
  initial	管理ユニットに登録した直後の状態です（初期状態）。未構築状態ともいいます。
  working	仮想サーバの業務が稼働している状態です（稼働中状態）。
  stopped	仮想サーバの業務が停止している状態です（停止状態）。
  starting	仮想サーバの業務の開始処理が実行中の状態です（開始中状態）。
  stopping	仮想サーバの業務の停止処理が実行中の状態です（停止中状態）。
  updating	仮想サーバの反映処理が実行中の状態です（反映中状態）。
  fault（starting）	仮想サーバの業務の開始処理に失敗した状態です（開始失敗による障害状態）。
  fault（stopping）	仮想サーバの業務の停止処理に失敗した状態です（停止失敗による障害状態）。
  fault（updating）	仮想サーバの反映処理に失敗した状態です（反映失敗による障害状態）。

• 実ステータス
  仮想サーバの実際の状態を示すステータスです。仮想サーバマネージャが仮想サーバに対する処理を実行するたびにチェックします。実ステータスの種類と意味を次の表に示します。
  

  表9-4　実ステータスの種類と意味

  ステータスの種類	意味
  initial	仮想サーバ上にアプリケーションサーバが構築されていない状態です（初期状態）。
  working	仮想サーバ上のサーバ通信エージェントが起動していて，アプリケーションサーバのすべてのプロセスが稼働している状態です（稼働中状態）。
  stopped	仮想サーバ上のサーバ通信エージェントが起動していて，アプリケーションサーバのすべてのプロセスが停止している状態です（停止状態）。
  invalid	仮想サーバ上のサーバ通信エージェントが起動しているが，「working」でも「stopped」でもない状態です（不正状態）。
  unknown	仮想サーバ上のサーバ通信エージェントと通信できない状態です（不明状態（initialを除く））。
  operating	仮想サーバマネージャによって，仮想サーバで何か処理が実行中である状態です（操作中状態）。

  注　アプリケーションサーバのすべてのプロセスとは，Management Server，運用管理エージェント，論理パフォーマンストレーサ，論理J2EEサーバ，論理Webサーバ，J2EEアプリケーション，およびリソースアダプタ（DB Connector）のことです。

  
  
• 負荷分散機ステータス
  仮想サーバの負荷分散機上の状態を示すステータスです。仮想サーバマネージャが負荷分散機に閉塞および閉塞解除を実行した状態を記憶しておきます。負荷分散機ステータスの種類と意味を次の表に示します。
  

  表9-5　負荷分散機ステータスの種類と意味

  ステータスの種類	意味
  initial	管理ユニットに仮想サーバを登録した直後の状態です（初期状態）。
  blocked	負荷分散機の操作で，仮想サーバを閉塞した状態です（閉塞状態）。
  unblocked	負荷分散機の操作で，仮想サーバの閉塞を解除した状態です（閉塞解除状態）。
  invalid	負荷分散機の操作に失敗した状態や，負荷分散機の状況が不明な状態です（障害状態）。

0：

正常終了しました。

1：

警告終了しました。

64：

異常終了しました。

項番	エラー・警告条件	戻り値
1	指定された管理ユニットがありません。	64
2	-target virtualserverオプション指定時に，管理ユニットに仮想サーバがありません。	1