更改 HyperSwap 关系同级的目标
使用 ha_change_designation 命令可将 HyperSwap 关系同级的名称由主同级更改为从属同级,反之亦然。
ha_change_designation < vol=VolName | cg=cgName > [ target=TargetName ]
[ new_designation=<Primary|Secondary|None> ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 主卷名称。 | 否 | 不适用 |
| cg | 对象名 | 主一致性组名称。 | 否 | 不适用 |
| target | 对象名 | 目标的名称。 | 否 | [none] |
| new_designation | 枚举项 | 同级的新名称。 如果未指定,那么此命令会交换主从同级的名称。 |
否 | none |
HyperSwap 关系中的名称反映用户的决定,确定了主同级与辅助(从属)同级的位置。由于手动角色更改或自动故障转移,两个同级在任意指定时刻所执行的实际角色可能会与其名称不同。
此命令在主同级上发出,但两个同级均受影响。 要使命令成功完成,必须激活 HyperSwap 关系。
不强制指定新的名称。 如果未指定新名称,那么此命令会交换两个同级的名称:主同级将变为辅助同级,而辅助同级将变为主同级。
示例:
ha_change_designation vol=regular_volume new_designation=Secondary
输出:
Command executed successfully.
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 已允许 |
| 存储集成管理员 | 已允许 |
| 应用程序管理员 | 不允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- VOLUME_IS_NOT_HA
这不是 HyperSwap 卷。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- CONS_GROUP_IS_NOT_HA
本地一致性组不具有 HyperSwap 定义。
- LOCAL_PEER_IS_NOT_MASTER
本地同级不是主同级。
- MIRROR_DESIGNATION_NOT_SUPPORTED_BY_TARGET
镜像的目标不支持镜像角色指定。
- HA_IS_NON_OPERATIONAL
此 HyperSwap 卷不可操作。
- VOLUME_BELONGS_TO_HA_CONS_GROUP
此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。
- TARGET_BAD_NAME
目标名称不存在。
- VOLUME_TARGET_MISMATCH
卷和目标不匹配。
- CONS_GROUP_BAD_TARGET
目标名称与一致性组不匹配。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员