vmiunit status（管理ユニットまたは仮想サーバグループの状態表示）

〈このページの構成〉

形式
機能
引数
入力例・出力例
出力ヘッダ
戻り値
エラーおよび警告条件

形式

管理ユニットの状態を表示する場合（形式1）

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

仮想サーバグループの状態を表示する場合（形式2）

vmiunit status [共通引数] -unit <管理ユニット名> -target group [-group <仮想サーバグループ名>]

仮想サーバの状態を表示する場合（形式3）

vmiunit status [共通引数] -unit <管理ユニット名> -target virtualserver [-group <仮想サーバグループ名>]

ページの先頭へ

機能

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

仮想サーバグループまたは仮想サーバの状態を表示する場合は，-groupオプションの設定によって表示内容が異なります。オプションの設定の組み合わせによる表示内容を次の表に示します。

表9‒3　オプションの設定の組み合わせによる表示内容
-targetオプションの設定	表示内容
-targetオプションの設定	-groupオプションの設定あり	-groupオプションの設定なし
group	特定の仮想サーバグループの状態	管理ユニットに属するすべての仮想サーバグループの状態
virtualserver	特定の仮想サーバグループに属する仮想サーバの状態	管理ユニットに属するすべての仮想サーバの状態

ページの先頭へ

引数

-unit <管理ユニット名>

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

-target {unit | group | virtualserver}

表示対象を指定します。

unit: 管理ユニットの状態を表示します。
group: 仮想サーバグループの状態を表示します。
virtualserver: 管理ユニットまたは仮想サーバグループに属する仮想サーバの状態を表示します。

-group <仮想サーバグループ名>

表示対象の仮想サーバグループの名称を指定します。

ページの先頭へ

入力例・出力例

入力例

管理ユニットの状態を表示する場合（形式1）

vmiunit status -unit gyoumu01 -target unit

仮想サーバグループの状態を表示する場合（形式2）

vmiunit status -unit gyoumu01 -target group
vmiunit status -unit gyoumu01 -target group -group group02

仮想サーバの状態を表示する場合（形式3）

vmiunit status -unit gyoumu01 -target virtualserver
vmiunit status -unit gyoumu01 -target virtualserver -group group02

出力例

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

Definition Status: latest
All Groups:        3
Active Groups:     1
Invalid Groups:    2

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

Group Name:         group01
Update Scope:       latest
Service Status:     active
All Servers:        4
Active Servers:     3
Invalid Servers:    1
(空行)
Group Name:         group02
Update Scope:       changed
Service Status:     blocked
All Servers:        3
Active Servers:     1
Invalid Servers:    0
(空行)
Group Name:         group03
Update Scope:       latest
Service Status:     invalid
All Servers:        3
Active Servers:     2
Invalid Servers:    1
Mark Time:          2009/08/10 15:01:23 JST
Mark Comment:       調査中

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

ティアが一つのとき

Virtual Server ID:  192.168.0.11
Tier ID:            combined-tier-001
Group Name:         group01
Update Scope:       none
Logical Status:     working
Observed Status:    working
LB Status:          unblocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.13
Tier ID:            combined-tier-001
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    unknown
Access:             offline

ティアが複数のとき

Virtual Server ID:  192.168.0.11
Tier ID:            http-tier-001
Group Name:         group01
Update Scope:       none
Logical Status:     working
Observed Status:    working
LB Status:          unblocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.12
Tier ID:            j2ee-tier-01
Group Name:         group01
Update Scope:       applications
Logical Status:     working
Observed Status:    working
Access:             online
(空行)
Virtual Server ID:  192.168.0.13
Tier ID:            http-tier-001
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    operating
LB Status:          blocked
Access:             online
(空行)
Virtual Server ID:  192.168.0.14
Tier ID:            j2ee-tier-01
Group Name:         group02
Update Scope:       all
Logical Status:     working
Observed Status:    unknown
Access:             offline

ページの先頭へ

出力ヘッダ

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

Definition Status

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

not imported

管理ユニットに定義ディレクトリが何も取り込まれていません。
unattached

管理ユニットに定義ディレクトリは取り込まれているが，仮想サーバグループが登録されていません。
changed

仮想サーバグループの定義の変更範囲（Update Scope）にlatest以外が含まれます。
latest

仮想サーバグループの定義の変更範囲（Update Scope）がすべてlatestです。

All Groups

管理ユニットに登録されている仮想サーバグループの数が出力されます。次の場合は0が出力されます。

定義ディレクトリが取り込まれていない場合（管理ユニットの定義の状態（Definition Status）がnot importedの場合）
仮想サーバグループが登録されていない場合（管理ユニットの定義の状態（Definition Status）がunattachedの場合）

Active Groups

業務を運用中の仮想サーバグループの数が出力されます。業務が運用中の仮想サーバグループとは，業務ステータス（Service Status）がactiveであるものを指します。

Invalid Groups

不正な状態の仮想サーバグループの数が出力されます。不正な状態の仮想サーバグループとは，業務ステータス（Service Status）がInvalidであるものを指します。

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

Group Name

仮想サーバグループの名称が出力されます。

Update Scope

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

noupdate

仮想サーバに定義ディレクトリが反映されていません。
changed

仮想サーバの定義の変更範囲（Update Scope）にnone以外が含まれています。
latest

仮想サーバの定義の変更範囲（Update Scope）がすべてnoneです。

Service Status

仮想サーバグループの業務ステータス（運用状態）が出力されます。仮想サーバグループ内の仮想サーバの状態によって，出力される内容が異なります。

active

仮想サーバグループ内のすべての仮想サーバが業務を運用中であること（All Serversの値=Active Serversの値）を示します。
no active

仮想サーバグループ内の一部の仮想サーバが業務を運用中で，かつ不正な状態の仮想サーバがないこと（All Serversの値＞Active Serversの値，かつInvalid Serversの値=0）を示します。
blocked

仮想サーバグループ内に，負荷分散機ステータスがblockedである仮想サーバが一つ以上あることを示します。負荷分散機連携機能を有効にしている場合に出力されます。
invalid

仮想サーバグループ内の一部の仮想サーバが不正な状態であること（Invalid Serversの値＞0）を示します。

All Servers

仮想サーバグループ内の仮想サーバの数が出力されます。

Active Servers

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

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

Invalid Servers

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

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

Mark Time

仮想サーバグループに障害マークが設定された時刻が出力されます。障害マークが設定されていない場合は出力されません。

Mark Comment

仮想サーバグループに障害マークが設定された時に記入されたコメントが出力されます。障害マークが設定されていない場合は出力されません。

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

Virtual Server ID

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

Tier ID

仮想サーバに割り当てられているティア識別子が出力されます。

Group Name

仮想サーバグループの名称が出力されます。

Update Scope

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

none

更新の必要はありません。
applications

アプリケーションの更新が必要です。
all

すべての定義の更新が必要です。

Logical Status

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

Observed Status

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

LB Status

仮想サーバの負荷分散機ステータス^※が出力されます。負荷分散機連携機能が無効な場合は出力されません。

Access

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

online（正常）

通信状態が正しいことを示します。
offline（異常）

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

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

論理ステータス

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

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

実ステータス

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

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

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

負荷分散機ステータス

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

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

ページの先頭へ

戻り値

0：: 正常終了しました。
1：: 警告終了しました。
64：: 異常終了しました。

ページの先頭へ

エラーおよび警告条件

項番	エラー・警告条件	コマンド形式	戻り値
1	指定された管理ユニットがありません。	形式1，形式2	64
2	指定された仮想サーバグループがありません。	形式2，形式3	64
3	指定された管理ユニットに仮想サーバグループが一つも登録されていません。	形式2	1
4	指定された管理ユニットに仮想サーバが一つも登録されていません。	形式3	1

ページの先頭へ