14.3.4 status(クラスタ状態の確認)
- 〈この項の構成〉
(1) 機能
クラスタの状態を確認します。
(2) 規則
-
このサブコマンドはクラスタの状態に関係なく実行できます。
-
このサブコマンドは,EADsサーバが次の状態のときに実行できます。
-
初期化中(initializing)
-
初期化状態(initialized)
-
稼働状態(running)
-
閉塞中(closing)
-
閉塞状態(closed)
-
縮退状態(isolated)
-
停止中(stopping)
-
(3) 形式
eztool status [-v] [-s|-c <表示内容の項目名>==<状態>]
(4) オプションおよび引数
(a) -vまたは--verbose
コマンド実行結果の詳細を表示したい場合に指定します。
(b) -sまたは--single
クラスタ全体ではなく,コマンドを実行するEADsサーバの状態だけを確認したい場合に指定します。
(c) -cまたは--count <表示内容の項目名>==<状態>
クラスタに参加する各EADsサーバの状態がそろっていることを確認したい場合に指定します。
指定した項目が,指定した状態と完全一致するEADsサーバ数を,リターンコードとして返します。ただし,情報が取得できないためにアスタリスク(*)が表示された項目については,カウントされません。
- ■表示内容の項目名
-
指定できる表示内容の項目名を次の表に示します。
表示内容の項目名
説明
表示の有無
-vまたは--verboseオプション指定
なし
あり
ID
EADsサーバID
○
○
IP_Address
EADsサーバのIPアドレス
○
○
ServerName
EADsサーバ名(運用ディレクトリ名)
×
○
ClientPort
EADsクライアントとの通信に使用するEADsサーバのポート番号
○
○
ServerPort
EADsサーバ間のデータの多重化に使用するポート番号
×
○
ManagePort
コマンドが使用する通信ポートを確認するためのポート番号
×
○
Position
EADsサーバの位置
○
○
Cluster
クラスタへの参加状況
○
○
State
EADsサーバの状態
○
○
Operation
現在実行中のサブコマンド名,またはコマンドのオプション名
○
○
Lock
EADsサーバの排他状態
×
○
KeyCount
EADsサーバ内のkeyの総数
×
○
UsedCache
EADsサーバ内の,メモリキャッシュまたは2Wayキャッシュのvalue部分が格納される領域のメモリ使用量(Explicitヒープ)の割合(メモリ使用量/メモリ総容量)
(単位:メガバイト)
×
○
Version
バージョン情報
×
○
- (凡例)
-
○:表示されます。
×:表示されません。
- ■状態
-
指定した表示内容の項目名で表示される文字列を指定します。
ASCIIコード「0x20」〜「0x7E」の文字が指定できます。
半角スペースは二重引用符(")で囲むことで使用できますが,表示内容の項目名,および状態の前後の半角スペースは無視されます。
なお,情報が取得できない項目にはアスタリスク(*)が表示されるため,アスタリスク(*)だけを指定した場合はエラーとなります。
(5) 出力例
eztool statusコマンドの実行結果の出力例を次に示します。
■-vまたは--verboseオプションを指定しない場合
■-vまたは--verboseオプションを指定する場合
表示内容を次の表に示します。
項番 |
表示内容 |
説明 |
表示の有無 |
|
---|---|---|---|---|
-vまたは--verboseオプション指定 |
||||
なし |
あり |
|||
1 |
Cluster Health |
クラスタの状態 次のどれかが表示されます。
|
○ |
○ |
2 |
TotalCount |
EADsサーバ数 -sまたは--singleオプションを指定した場合は表示されません。 |
○ |
○ |
3 |
OnlineCount |
クラスタに参加しているEADsサーバ数 -sまたは--singleオプションを指定した場合は表示されません。 また,クラスタの状態がNOT_AVAILABLEの場合,カウントされません。 |
○ |
○ |
4 |
OfflineCount |
クラスタに参加していないEADsサーバ数 -sまたは--singleオプションを指定した場合は表示されません。 また,クラスタの状態がNOT_AVAILABLEの場合,カウントされません。 |
○ |
○ |
5 |
StandbyCount |
クラスタに参加する予定のEADsサーバ数 -sまたは--singleオプションを指定した場合は表示されません。 また,クラスタの状態がNOT_AVAILABLEの場合,カウントされません。 |
○ |
○ |
6 |
ID |
EADsサーバID |
○ |
○ |
7 |
IP_Address |
EADsサーバのIPアドレス |
○ |
○ |
8 |
ServerName |
EADsサーバ名(運用ディレクトリ名) |
× |
○※1※2 |
9 |
ClientPort |
EADsクライアントとの通信に使用するEADsサーバのポート番号 |
○ |
○ |
10 |
ServerPort |
EADsサーバ間のデータの多重化に使用するポート番号 |
× |
○※2 |
11 |
ManagePort |
コマンドが使用する通信ポートを確認するためのポート番号 |
× |
○※2 |
12 |
Position |
EADsサーバの位置 位置(ハッシュ値)は降順で表示されます。 |
○ |
○ |
13 |
Cluster |
クラスタへの参加状況 次のどれかが表示されます。
|
○ |
○※3 |
14 |
State |
EADsサーバの状態 次のどれかが表示されます。
|
○ |
○※1※2 |
15 |
Operation |
現在実行中のサブコマンド名,またはコマンドのオプション名 次のどれかが表示されます。
export,import,importecfおよびstopについては,処理の進捗率も表示されます。 (例)export(88%) 実行中でない場合はnoneが表示されます。 |
○ |
○※1※2 |
16 |
Lock |
EADsサーバの排他状態 次のどちらかが表示されます。
|
× |
○※3 |
17 |
KeyCount |
EADsサーバ内のkeyの総数 多重化によってコピーされるkey数も含みます。 |
× |
○※1※2 |
18 |
UsedCache |
EADsサーバ内の,メモリキャッシュまたは2Wayキャッシュのvalue部分が格納される領域のメモリ使用量(Explicitヒープ)の割合(メモリ使用量/メモリ総容量) (単位:メガバイト)
|
× |
○※1※2 |
19 |
Version |
バージョン情報 03-00の場合,03-00-00と表示されます。 |
× |
○※1※2 |
- (凡例)
-
○:表示されます。
×:表示されません。
- 注※1
-
接続失敗,通信エラー,または通信タイムアウトの場合,アスタリスク(*)が表示されます。
- 注※2
-
EADsサーバのクラスタへの参加状況がstandbyの場合,アスタリスク(*)が表示されます。
- 注※3
-
クラスタの状態がNOT_AVAILABLEの場合,アスタリスク(*)が表示されます。
(6) リターンコード
0:成功
0以外:エラー
- -sまたは--singleオプションを指定した場合
-
EADsサーバの状態をリターンコードとして返します。
0:稼働状態(running)
1:初期化中(initializing)
2:初期化状態(initialized)
3:閉塞中(closing)
4:閉塞状態(closed)
5:停止中(stopping)
10:縮退状態(isolated)
101:失敗
110:接続失敗
111:通信タイムアウト
- -cまたは--countオプションを指定した場合
-
指定した項目が,指定した状態になっているEADsサーバ数を,リターンコードとして返します。
コマンドの実行に失敗した場合は101を返します。
(7) 注意事項
-
EADsサーバIDがいちばん小さいEADsサーバが起動していない場合,ほかのEADsサーバはクラスタに参加できません。また,クラスタに参加していないEADsサーバでこのコマンドを実行した場合,ほかのEADsサーバが複数起動していても,コマンドを実行したEADsサーバの情報しか表示されません。
-
復旧中のEADsサーバでこのコマンドを実行した場合,復旧が完了するまではほかのEADsサーバの情報は表示されません。
-
縮退状態のEADsサーバしか存在しない場合,クラスタ構成情報が更新されないために古い情報が表示されることがあります。
-
出力処理中にコマンドがタイムアウトした場合,出力結果が欠落することがあります。また,出力処理が完了していても,コマンドがタイムアウトになることがあります。このような場合には,コマンドのタイムアウト時間を大きくしてから再実行してください。