管理ユニットに関する情報の取得

Cosminexus V9 アプリケーションサーバ仮想化システム構築・運用ガイド

管理ユニットに関する情報として，管理ユニット，仮想サーバグループまたは仮想サーバの状態に関する情報と，管理ユニットに属する仮想サーバの一覧を取得する方法について説明します。

ポイント: 作業を実施するユーザ：システム構築者

ここでは，管理ユニット「gyoumu_a」，仮想サーバグループ「vmgroup_1」，「vmgroup_2」，および仮想サーバ識別子が「192.168.1.101」，「192.168.1.102」の仮想サーバについて情報を取得する例を示します。

●管理ユニットの情報取得

特定の管理ユニットの情報が取得できます。操作対象の管理ユニットの内容や，所有者などを確認できます。JP1/Base（認証サーバ）によるアカウント管理を利用している場合，管理ユニットの所有者に関する情報は取得されません。

管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。
vmiunitコマンドのサブコマンド「info」で，-unitオプションに情報を取得したい管理ユニット名を指定して，管理ユニットの情報を取得します。
コマンドの実行例と実行結果の例を次に示します。なお，ここで示すコマンド実行結果は，仮想サーバマネージャによるアカウント管理を利用している場合の例になります。
vmiunit info -unit gyoumu_a
（コマンド実行結果の例）
UnitName: gyoumu_a Owner: user_a Description: 業務A Tier count: 1 Tier ID: combined-system01 type: combined-tier
この例は，管理ユニット「gyoumu_a」が業務A用の管理ユニットにティア識別子「combined-system01」のティア（combined-tier）が一つあり，システム構築者「user_a」が所有していることを示しています。

●管理ユニットごとの状態取得

管理ユニットごとの状態が取得できます。管理ユニットに属する仮想サーバグループへの定義ディレクトリの反映状況や，仮想サーバグループの数などを確認できます。

管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。
vmiunitコマンドのサブコマンド「status」で，-targetオプションにunitを指定して，管理ユニットの状態を取得します。
コマンドの実行例と実行結果の例を次に示します。
vmiunit status -unit gyoumu_a -target unit
（コマンド実行結果の例）
Definition Status: changed All Groups: 2 Active Groups: 1 Invalid Groups: 1
この例は，管理ユニットに属する仮想サーバグループは，稼働状態が一つ，障害状態が一つの計二つで，仮想サーバグループの定義の変更範囲にlatest以外が含まれていることを示しています。

●仮想サーバグループごとの状態取得

仮想サーバグループごとの状態が取得できます。仮想サーバグループ内の仮想サーバへの定義ディレクトリの反映状況や，仮想サーバの数などを確認できます。

管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。
vmiunitコマンドのサブコマンド「status」で，-targetオプションにgroup，-groupオプションに仮想サーバグループ名を指定して，仮想サーバグループの状態を取得します。
コマンドの実行例と実行結果の例を次に示します。
vmiunit status -unit gyoumu_a -target group -group vmgroup_1
（コマンド実行結果の例）
Group Name: vmgroup_1 Update Scope: latest Service Status: active All Servers: 1 Active Servers: 1 Invalid Servers: 0
この例は，仮想サーバグループ「vmgroup_1」内仮想サーバは，稼働状態が1台，障害状態が0台の計1台で，仮想サーバの定義の変更範囲はすべてnoneであることを示しています。

●仮想サーバごとの状態取得

管理ユニットに属する仮想サーバすべての状態が取得できます。仮想サーバ上のサーバ通信エージェントとの接続状況や，定義ディレクトリの反映状況，仮想サーバのステータスなどを確認できます。

管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。

vmiunitコマンドのサブコマンド「status」で，-targetオプションにvirtualserverを指定して，管理ユニットに属する仮想サーバすべての状態を取得します。
コマンドの実行例と実行結果の例を次に示します。

vmiunit status -unit gyoumu_a -target virtualserver

（コマンド実行結果の例）

Virtual Server ID:  192.168.1.101
Tier ID:            combined-system01
Group Name:         vmgroup_1
Update Scope:       none
Logical Status:     working
Observed Status:    working
LB Status:          unblocked
Access:             online
 
Virtual Server ID:  192.168.1.102
Tier ID:            combined-system01
Group Name:         vmgroup_2
Update Scope:       applications
Logical Status:     fault(updating)
Observed Status:    working
LB Status:          blocked
Access:             online

この例は，管理ユニットに属する仮想サーバが次の表に示す状態であることを示しています。

実行結果の項目	説明	管理ユニットに属する仮想サーバの状態
Virtual Server ID	仮想サーバ識別子	192.168.1.101	192.168.1.102
Tier ID	ティア識別子	combined-system01	combined-system01
Group Name	仮想サーバグループ名	vmgroup_1	vmgroup_2
Update Scope	仮想サーバの定義の変更範囲	更新の必要なし	アプリケーションの更新が必要
Logical Status	仮想サーバの論理ステータス	稼働中状態	反映失敗の障害状態
Observed Status	仮想サーバの実ステータス	稼働中状態	稼働中状態
LB Status	仮想サーバの負荷分散機ステータス	閉塞解除状態	閉塞状態
Access	サーバ通信エージェントとの通信状態	正常	正常

●仮想サーバの一覧取得

管理ユニットまたは仮想サーバグループに属する仮想サーバの仮想サーバ識別子や，業務用IPアドレス，仮想サーバに割り当てられているティア識別子などが取得できます。一覧の形式のほかに，仮想サーバグループ情報ファイルの形式で情報を取得できます。仮想サーバの不要な仮想サーバが登録されていないかなどを確認できます。ここでは，管理ユニットに属する仮想サーバの情報を一覧の形式で取得する例を示します。

管理用端末マシンから仮想化システム管理用サーバマシンにリモート接続します。

vmiunitコマンドのサブコマンド「list」を使用して，管理ユニットに属する仮想サーバの一覧を取得します。
コマンドの実行例と実行結果の例を次に示します。

vmiunit list -unit gyoumu_a -format list