集群命令

用途

创建使用 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 -sppvsFileName[-addcompvs PhysicalVolume][-hostname HostName]

cluster -create -clustername ClusterName -repopvs PhysicalVolume... -sp StoragePool[-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 主机名 | -uuidHostUuid}

从系统中除去集群：

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 IP-hostname HostName

要指定与必须为 SSP 通信除去的指定节点相关联的 IP 地址，请执行以下操作:

cluster -rmips IP -hostname HostName

描述

cluster 命令用于创建和除去集群。

可通过使用 -systier 选项和 -usrtier 选项，创建具有独立的受限系统层（仅保存元数据）和用户层（仅保存用户数据）的集群。在缺省情况下，将使用 -sppvs 选项或只使用 -usrtier 选项创建具有单一融合层（存放元数据和用户数据）的集群。

status 子命令用于显示全局集群运行状态以及集群中每个节点的状态。集群状态可以为 OK、DEGRADED 或 DOWN。如果集群状态为 OK，那么表示集群的所有节点都正常工作。如果集群运行状态为 DEGRADED，那么集群服务在某些节点上可能未处于活动状态。如果集群状态是 DOWN，那么表示所有节点上的集群服务都不活动。节点状态为 OK 或 DOWN。如果集群服务处于活动状态，那么其状态为 OK；如果在该节点上集群服务未处于活动状态，那么其状态为 DOWN。对未处于 DOWN 状态的每个节点提供了池状态。如果某个节点可以向客户机逻辑分区 (LPAR) 提供共享存储池 (SSP) 虚拟化存储器，那么对于该节点，池状态为 OK。如果池在节点中不可用，那么其状态为 DOWN。

如果请求了 -verbose 选项，那么将提供更多状态详细信息，例如处于各种状态的节点数。对于未处于 DOWN 状态的每个节点，此选项显示节点角色以及从节点角度看的存储池状态。

如果请求了 -fmt 选项，那么将以定界符分隔的值报告格式显示状态输出。

在使用 -field 选项时，您可以指定要显示的字段。如果未请求任何池信息，那么此命令不会检索每个节点上的池状态，从而减少了命令响应时间。

使用 -addcompvs 选项，可以指定必须用于集群之间节点之间通信的专用磁盘。当集群中的一组节点上的网络通信中断时， SSP (SFStore) 将使用此磁盘。

使用 -rmcompvs 选项，可以指定必须从集群之间节点之间的通信中除去的专用磁盘。

使用 -addips 选项，可以指定与必须用于 SSP 通信的指定节点相关联的 IP 地址的列表。

使用 -rmips 选项，可以指定与必须从 SSP 通信中除去的指定节点相关联的 IP 地址的列表。

注: IP 地址可以采用 IPv4 或 IPv6 格式。您可以使用空间分隔符来指定多个 IP 地址。

标志

标志名称	描述
-添加节点	向集群添加成员节点。
-addcompvs	指定必须用于磁盘通信的物理卷。
-邮编	指定与必须用于 SSP 通信的指定节点相关联的 IP 地址。
-用户名	指定集群的名称。
-创建	创建集群。
-remove	除去集群。
-f	强制从集群中除去 VIOS 分区。
-领域	支持下列字段（如果指定了 -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`
-文件	指定必须使用 `-sppvs` 选项指定文件名。文件必须包含以空格分隔的物理卷名称。
-ft	以用户指定的定界符分隔输出。
-主机名	指定 VIOS 分区的主机名或 IP 地址。
-清单	列示具有当前节点的成员资格的所有集群。
-repopvs	列示可在其中创建存储库的物理卷。
-rmcompvs	指定必须从磁盘通信中除去的物理卷。
-rmnode	从集群中除去成员节点。
-rmips	指定与必须从 SSP 通信中除去的指定节点相关联的 IP 地址。
-sp	指定存储池的名称。
-sppvs	列示可在其中创建共享存储池的物理卷。如果指定了 -file 选项，那么此标志将列示包含物理卷名称列表的文件名。
-系统	指定系统层的可选名称。随后指定物理卷或文件名列表，它们用于创建系统层。
-我们的管理员	指定用户层的名称。随后指定物理卷或文件名列表，它们用于创建用户层。如果不使用 -`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.
```