激活 HyperSwap 关系
使用 ha_activate 命令可激活卷或一致性组的 HyperSwap 关系。
ha_activate < vol=VolName | cg=cgName > [ target=TargetName ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 主卷名称。 | 否 | 不适用(必须指定卷或一致性组) |
| cg | 对象名 | 主一致性组名称。 | 否 | 不适用(必须指定卷或一致性组) |
| target | 对象名 | 目标 HyperSwap 关系名称。 | 否 | [none] |
此命令会更新 Quorum Witness 中执行该操作后 HyperSwap 关系的状态。 如果 HyperSwap 为启用状态,那么在 Quorum Witness 更新失败的情况下,此命令也将失败。如果 HyperSwap 为禁用状态,那么即使 Quorum Witness 更新失败,此命令也可能会成功执行。
成功完成命令需要满足以下条件:
- 在同一 Quorum Witness 上配置了主卷和从属卷
- 主卷和从属卷与 Quorum Witness 的连接正常运行
- 指定的卷为主卷
- 主卷与从属卷之间的连接足以满足 HyperSwap 要求(也就是说,ha_list 命令输出中的 link up 状态为 yes)。
如果关系已处于活动状态,那么将不执行任何操作,并会返回一个成功代码。
- 在 cg_add_volume 或 cg_remove_volume 命令后,由于命令超时或意外失败,在未收到从属卷应答的主卷上发出此命令。 在此情况下,命令将失败,并会返回 HA_CONFIGURATION_ERROR 代码。 这意味着 HyperSwap 一致性组同级的成员列表不相同。
- 在 vol_resize 命令后,由于命令超时或意外失败,在未收到从属卷应答的主卷上发出此命令。 在此情况下,命令将失败,并会返回 HA_CONFIGURATION_ERROR 代码。 该错误意味着 HyperSwap 卷同级的大小不相同。
示例:
ha_activate vol=regular_volume target=123
输出:
Command completed successfully
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 已允许 |
| 存储集成管理员 | 已允许 |
| 应用程序管理员 | 已允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- LOCAL_PEER_IS_NOT_MASTER
本地同级不是主同级。
- HA_CONFIGURATION_ERROR
HyperSwap 关系的本地配置与其远程配置不匹配。
- REMOTE_MAX_VOLUMES_REACHED
已达到远程机器上的最大卷数。
- SYNC_ALREADY_ACTIVE
同步已处于活动状态。
- VOLUME_BELONGS_TO_HA_CONS_GROUP
此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。
- DOMAIN_MAX_VOLUMES_REACHED
域超出了所允许的最大卷数。
- HA_CAN_NOT_BE_ACTIVATED
无法激活自动故障转移。
- HA_CONS_GROUP_MEMBERSHIP_MISMATCH
HyperSwap 一致性组包含不同的主卷和辅助卷。只要先前发出了 cg_add_vol 或 cg_remove_vol 命令并且主机器在命令超时前未收到辅助机器的应答,或发生其他任何意外故障,就会发生此问题。
- HA_SIZE_MISMATCH
此 HyperSwap 关系中主卷和辅助卷的大小不同。
- HA_RETRY_OPERATION
正在对该 HyperSwap 关系执行操作。
故障诊断:请在数秒后重试发出此命令。
- TARGET_BAD_NAME
目标名称不存在。
- VOLUME_TARGET_MISMATCH
卷和目标不匹配。
- CONS_GROUP_BAD_TARGET
目标名称与一致性组不匹配。
- VOLUME_TOO_MANY_ACTIVE_MIRRORS
如果卷上已激活多个镜像,那么无法使用此命令。
- REMOTE_DOMAIN_MAX_VOLUMES_REACHED
已达到远程机器域中的最大卷数。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- REMOTE_DATA_REDUCTION_TIER_IS_OFFLINE
远程系统的数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- REMOTE_SYSTEM_OUT_OF_PHYSICAL_SPACE
远程系统物理空间不足,不允许执行此操作。
- TARGET_PEER_NOT_HEALTHY
目标同级未标识为正常运行。
故障诊断:请检查 Quorum Witness 配置。
- TARGET_HAS_NO_QUORUM_WITNESS
本地目标未定义 Quorum Witness。
- REMOTE_TARGET_HAS_NO_QUORUM_WITNESS
远程系统上的目标未定义 Quorum Witness。
- VOLUME_IS_NOT_HA
这不是 HyperSwap 卷。
- CONS_GROUP_IS_NOT_HA
本地一致性组不具有 HyperSwap 定义。
- HA_CONNECTIVITY_NOT_SUFFICIENT
系统之间的连接不足,无法进行自动故障转移。
- HA_PEER_QUORUM_WITNESS_CONFIGURATION_NOT_VERIFIED
未验证同级与 Quorum Witness 之间的连接。
- HA_REMOTE_PEER_QUORUM_WITNESS_CONFIGURATION_NOT_VERIFIED
未验证远程同级与 Quorum Witness 之间的连接。
- HA_TARGET_QUORUM_WITNESS_IS_NOT_ACTIVATED
已取消激活与目标关联的 Quorum Witness。
- HA_REMOTE_TARGET_QUORUM_WITNESS_IS_NOT_ACTIVATED
已取消激活与远程目标关联的 Quorum Witness。