cluster コマンド

目的

Virtual I/O Server (VIOS) 区画を使用し、クラスター関連の操作を実行するクラスターを作成します。

構文

クラスターを作成するには、次のように入力します。

cluster -create -clustername ClusterName -repopvs PhysicalVolume ... -sp StoragePool -sppvs PhysicalVolume... [-addcompvs PhysicalVolume] [-hostname HostName]

cluster -create -clustername ClusterName -repopvs PhysicalVolume... -sp StoragePool -file -sppvs ファイル名[-addcompvs PhysicalVolume] [-hostname HostName]

cluster -create -clustername ClusterName -repopvs PhysicalVolume... -sp ストレージプール[-systier [SysTierName:] PhysicalVolume...] -usrtier UsrTierName:PhysicalVolume...[-addcompvs PhysicalVolume]...[-hostname HostName]

cluster -create -clustername ClusterName -repopvs PhysicalVolume... -sp StoragePool -file [-systier [SysTierName:] FileName] -usrtier UsrTierName：ファイル名1[-addcompvs PhysicalVolume] [-hostname HostName]

VIOS 区画ノードをクラスターに追加するには、以下のようにします。

cluster -addnode [-clustername ClusterName] -hostname HostName

VIOS 区画ノードをクラスターから除去するには、以下のようにします。

cluster -rmnode [-f] [-clustername ClusterName] {-hostname ホスト名 | -uuidホスト}

システムからクラスターを削除するには、次のように入力します。

cluster -remove [-clustername ClusterName]

クラスターのヘルス状況を表示するには、次のように入力します。

cluster -status [-clustername ClusterName] [-field FieldName...] [-fmt デリミタ] [-verbose ]

クラスターとオブジェクト・データ・マネージャー・マネージャー (ODM) を同期するには、次のように入力します。

cluster -sync [-clustername ClusterName]

すべてのクラスターをリストするには、次のように入力します。

cluster -list [-field フィールド名... ] [-fmt デリミタ]

注: IPv6 が構成されている場合、 VIOS ノードを共用ストレージ・プール (SSP) クラスターのメンバーとしてセットアップするには、 IPv6 ステートレス自動構成が推奨されます。

通信ディスク (comdisk) を既存のクラスターに追加するには、次のように入力します。

cluster -addcompvs PhysicalVolume

comdisk を既存のクラスターから削除するには、次のように入力します。

cluster -rmcompvs PhysicalVolume

SSP 通信に使用する必要がある指定のノードに関連付けられている IP アドレスを指定するには、次のように入力します。

cluster-addips 知的財産権-hostnameHostName

SSP 通信について削除する必要がある指定のノードに関連付けられている IP アドレスを指定するには、次のように入力します。

cluster-rmips 知的財産権 -hostnameHostName

説明

cluster コマンドは、クラスターを作成および除去する場合に使用します。

クラスターは、-systier オプションおよび -usrtier オプションを使用して、制限付きシステム・ティア (メタデータのみを保持) とユーザー・ティア (ユーザー・データのみを保持) を別個に含めて作成できます。デフォルトでは、クラスターは、-sppvs オプションを使用するか、または -usrtier オプションを単独で使用して、単一の混合ティア (メタデータとユーザー・データを保持) を含めて作成されます。

status サブコマンドは、グローバル・クラスターのヘルス状況と、クラスター内の各ノードの状況を表示します。クラスター状況は、OK、DEGRADED、または DOWN のいずれかです。クラスター状況が OK の場合、そのクラスターのすべてのノードが機能しています。クラスターのヘルス状況が DEGRADED の場合、クラスター・サービスが一部のノードで非アクティブになっている可能性があります。クラスター状況が DOWN の場合、クラスター・サービスがすべてのノードで非アクティブになっています。ノード状況は OK または DOWN のいずれかです。ノードが OK 状態であるのはクラスター・サービスがアクティブの場合です。また、ノードが DOWN 状態であるのはクラスター・サービスがそのノードで非アクティブになっている場合です。 DOWN 状態でないノードについては、それぞれプール状況が示されます。共用ストレージ・プール (SSP) 仮想ストレージをクライアント論理区画 (LPAR) に提供できる場合、そのノードのプール状況は OK です。プールがノードから使用できない場合、プール状況は DOWN です。

-verbose オプションを要求すると、状況の詳細 (各状態にあるノードの数など) が追加で表示されます。 DOWN でない各ノードについては、ノードの観点から見たノードの役割とストレージ・プール状況が表示されます。

-fmt オプションを要求すると、区切り文字で値が区切られたレポートの形式で状況出力が表示されます。

-field オプションを使用すると、表示するフィールドを指定できます。プール情報を要求しない場合、コマンドは各ノードのプール状況を取り出さないため、コマンド応答時間が高速になります。

-addcompvs オプションを使用して、クラスター内のノード間での通信に使用する必要がある専用ディスクを指定できます。このディスクは、ネットワーク通信がクラスター内の一連のノード上で中断された場合に SSP (SFStore) が使用します。

-rmcompvs オプションを使用して、クラスター内のノード間での通信から削除する必要がある専用ディスクを指定できます。

-addips オプションを使用して、SSP 通信に使用する必要がある指定のノードに関連付けられている IP アドレスのリストを指定できます。

-rmips オプションを使用して、SSP 通信から削除する必要がある指定のノードに関連付けられている IP アドレスのリストを指定できます。

注: IP アドレスは、 IPv4 または IPv6 のいずれかの形式にすることができます。スペース区切り文字を使用して、複数の IP アドレスを指定できます。

フラグ

フラグ名	説明
-追加ノード	メンバー・ノードをクラスターに追加します。
-addcompvs (-addcompvs)	ディスク通信に使用する必要がある物理ボリュームを指定します。
-addips (加法)	SSP 通信に使用する必要がある指定のノードに関連付けられている IP アドレスを指定します。
-クラス名	クラスターの名前を指定します。
-作成する	クラスターを作成します。
-remove	クラスターを除去します。
-f	クラスターからの VIOS パーティションの除去を強制的に行います。
-field	-list フラグが指定されている場合、以下のフィールドがサポートされます。 `cluster_name, cluster_id` -status フラグが指定されている場合、以下のフィールドがサポートされます。 `cluster_name, cluster_state, node_name, node_mtm, node_partition_num, node_state, pool_state` -status フラグが -verbose オプションと共に指定されている場合、以下のフィールドがサポートされます。 `cluster_name, cluster_id, cluster_state, repos_mode, number_of_nodes, nodes_ok, nodes_down, pool_name, pool_id, pool_state, node_name, node_id, node_mtm, node_partition_num, node_state, node_repos_state, node_upgrade_status, node_roles`
-file	`-sppvs` オプションと共にファイル名を指定する必要があることを指定します。ファイルには、1 個のスペースで区切られた物理ボリューム名が含まれている必要があります。
-形式 (-fmt)	ユーザー指定の区切り文字により出力を分割します。
-ホスト名	VIOS 区画のホスト名または IP アドレスを指定します。
-list	現在のノードのメンバーシップを持つすべてのクラスターをリストします。
-repopvs (-repopvs)	リポジトリーを作成することができる物理ボリュームをリストします。
-rmcompvs (-rmcompvs)	ディスク通信から削除する必要がある物理ボリュームを指定します。
-rmnode	クラスターからメンバー・ノードを削除します。
-rmips	SSP 通信から削除する必要がある指定のノードに関連付けられている IP アドレスを指定します。
-sp	ストレージ・プールの名前を指定します。
-sppvs (-sppvs)	共用ストレージ・プールを作成することができる物理ボリュームをリストします。 -file オプションを指定すると、このフラグにより、物理ボリューム名のリストを含むファイル名がリストされます。
-システィエ	システム・ティアのオプション名を指定します。その後に物理ボリュームまたはファイル名のリストが続きます。このリストはシステム・ティアの作成に使用されます。
-usrtier (-usrtier)	ユーザー・ティアの名前を指定します。その後に物理ボリュームまたはファイル名のリストが続きます。このリストはユーザー・ティアの作成に使用されます。 -`systier` オプションを使用しない場合、cluster コマンドは混合タイプのティアを作成します。
-status	クラスターのヘルス状況を表示します。
-同期	クラスターと ODM を同期します。
-UUID	ノードの UUID を指定します。
-verbose	追加の詳細情報を表示します。

例

混合ティアを含むクラスターを作成するには、次のコマンドを入力します。
```
cluster -create -clustername testcluster -repopvs hdisk1 -sp testpool -sppvs hdisk2
```
システムは次の出力を表示します。
Cluster testcluster has been created successfully.
-file フラグを使用して混合ティアを含むクラスターを作成するには、次のコマンドを入力します。
```
cluster -create -clustername testcluster -repopvs hdisk1 -sp testpool -file -sppvs pvlist.txt
```
システムは次の出力を表示します。
Cluster testcluster has been created successfully.
制限付きシステム・ティアおよびユーザー・ティアを含むクラスターを作成するには、次のコマンドを入力します。
```
cluster -create
            -clustername testcluster -repopvs repo_hdisk -sp testsp -systier metadatatier: hdisk2
            -usrtier datatier: hdisk3
```
システムは次の出力を表示します。
Cluster testcluster has been created successfully.
混合ティアを含むクラスターを作成するには、次のコマンドを入力します。
```
cluster -create -clustername testcluster -repopvs hdisk1 -sp testsp -usrtier mixedtier: hdisk2
```
システムは次の出力を表示します。
Cluster testcluster has been created successfully.
システムからクラスターを除去するには、次のコマンドを入力します。
```
cluster -remove
```
システムは次の出力を表示します。
Cluster testcluster has been removed successfully.
クラスターでメンバー・ノードを追加するには、次のコマンドを入力します。
```
cluster -addnode -hostname testhost2
```
システムは次の出力を表示します。
testhost2 has been added to the testcluster cluster.
クラスターからメンバー・ノードを削除するには、次のコマンドを入力します。
```
cluster -rmnode -hostname testhost2
```
システムは次の出力を表示します。
testhost2 has been removed from the testcluster cluster.

ヘルス状況要約を表示するには、次のコマンドを入力します。

cluster -status

システムは次の出力を表示します。

Cluster Name State
testcluster OK
Node Name Pool State MTM Partition #State
testhost1 OK 9115-505031006A2A 1 OK
testhost2 DOWN 9115-5050310069FA 1 OK

詳細ヘルス状況レポートを表示するには、次のコマンドを入力します。

cluster -status -verbose

システムは次の出力を表示します。

Cluster Name:                      testcluster
Cluster Id:                        d23624fe335f11e0bd510011257e1447
Cluster State:                     OK
Repository Mode:                   EVENT
Number of Nodes:                   2
Nodes OK:                          2
Nodes DOWN:                        0

       Pool Name:                  testpool
       Pool Id:                    b118d73c42b322d0a5850011257e1447
       Pool Mirror State:          NOT_MIRRORED

       Pool MFS Node:              testhost2
       Pool Leader Node:           testhost1 

       Node Name:                  testhost2
       Node Id:                    4d5012722f9f11e0813c0011257e1447
       Node MTM:                   8233-E8B020687AER
       Node Partition Num:         2
       Node State:                 OK
       Node Repos State:           OK
       Node Upgrade Status:        4.1.1.00 ON_LEVEL
       Node Roles:
          Pool Name:               testpool
          Pool Id:                 b118d73c42b322d0a5850011257e1447
          Pool State:              OK

       Node Name:                  testhost1   
       Node Id:                    3d5012722f9f11e0813c0011257e13444
       Node MTM:                   8233-E8B020687AER
       Node Partition Num:         6
       Node State:                 OK 
       Node Repos State:           OK
       Node Upgrade Status:        4.1.1.00 ON_LEVEL
       Node Roles:                 DBN
          Pool Name:               testpool
          Pool Id:                 b118d73c42b322d0a5850011257e1447
          Pool State:              OK

定様式ヘルス状況レポートを表示するには、次のコマンドを入力します。
```
cluster -status -fmt ’,’
```
システムは次の出力を表示します。
```
testcluster,OK,testhost1,9115-505031006A2A,4,OK,OK
testcluster,OK,testhost2,9115-5050310069FA,9,OK,OK
```

定様式の詳細ヘルス状況レポートを表示するには、次のコマンドを入力します。

cluster -status -fmt ’,’ -verbose

システムは次の出力を表示します。

testcluster,d23624fe335f11e0bd510011257e1447,OK,ASSERT,2,2,0,
testhost1,da18d52a32b211e0a5850011257e1447,9115-505031006A2A,4,OK,OK,ON_LEVEL,DBN,testpool, 
b118d73c42b322d0a5850011257e1447,OK
testcluster,d23624fe335f11e0bd510011257e1447,OK,ASSERT,2,2,0,
testhost2,4d5012722f9f11e0813c0011257e1447,9115-5050310069FA,9,OK,OK,ON_LEVEL,,testpool,
b118d73c42b322d0a5850011257e1447,OK

いくつかの特定フィールドを含む定様式ヘルス状況レポートを表示するには、次のコマンドを入力します。
```
cluster -status -fmt ’:’ -field cluster_name node_name pool_label pool_state -verbose
```
システムは次の出力を表示します。
```
testcluster:testhost1:testpool:OK
testcluster:testhost2:testpool:OK
```

特定のフィールドを含む特定のヘルス状況レポートを表示するには、次のコマンドを入力します。

cluster -status -field node_name node_state cluster_name cluster_state

システムは次の出力を表示します。

Node Name: testhost1
Node State: OK
Cluster Name: testcluster
Cluster State: OK
Node Name: testhost2
Node State: OK
Cluster Name: testcluster
Cluster State: OK

現行ノードのクラスター情報を表示するには、次のコマンドを入力します。
```
cluster -list
```
システムは次の出力を表示します。
```
CLUSTER_NAME: testcluster
CLUSTER_ID: a64c8c725bfc11e1993500215e188da0
```
-fmt フラグを使用してフォーマット済み出力で現行ノードのクラスター情報を表示するには、次のコマンドを入力します。
```
cluster -list -fmt ,
```
システムは次の出力を表示します。
```
testcluster,a64c8c725bfc11e1993500215e188da0
```

comdisk が構成されるクラスターを作成するには、次のコマンドを入力します。

cluster -create -clustername testcluster -sp testpool -repopvs 
hdisk1 -sppvs hdisk2 -addcompvs hdisk3

システムは次の出力を表示します。

Cluster testcluster has been created successfully.

comdisk を既存のクラスターに追加するには、次のコマンドを入力します。
```
cluster -addcompvs hdisk4
```
システムは次の出力を表示します。
```
Add com disk(s) successful.
```
comdisk を既存のクラスターから削除するには、次のコマンドを入力します。
```
cluster -rmcompvs hdisk4
```
システムは次の出力を表示します。
```
Remove com disk(s) successful.
```
指定のノードに関連付けられている IP アドレスを追加するには、次のコマンドを入力します。
```
cluster -addips 10.10.10.21 2020::20 2021::21 -hostname vios164
```
システムは次の出力を表示します。
```
Additional IPs associated with hostname vios164 has been added to the mycluster cluster.
```
指定のノードに関連付けられている IP アドレスを削除するには、次のコマンドを入力します。
```
cluster -rmips 10.10.10.21 2020::20 -hostname vios164
```
システムは次の出力を表示します。
```
Additional IPs associated with hostname vios164 have been removed from the mycluster cluster.
```
混合モード・クラスターでは、異なるノードに、異なる VIOS バージョンをインストールすることができます。例えば、いくつかのノードで VIOS バージョンが 3.1.1 で、また別のノードで VIOS バージョンが 2.2.6 という混合モード・クラスターを考えます。そのようなシナリオでは、VIOS 3.1.1 ノードで IP アドレスを追加しようとすると、次のエラー・メッセージが表示されます。
```
cluster -addips 10.10.10.21 2020::20 2021::21 -hostname vios164
The requested operation can not be performed since the software capability is currently not enabled.
Please upgrade all nodes within the cluster and retry the request once the upgrade has completed successfully.
```