转换主卷和从属卷之间的角色
使用 ha_switch_roles 命令可转换主卷和从属卷之间的角色。
ha_switch_roles <vol=VolName | cg=cgName> [ target=TargetName ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 本地卷名。 | 否 | 不适用(必须指定卷或一致性组) |
| cg | 对象名 | 本地一致性组名称。 | 否 | 不适用(必须指定卷或一致性组) |
| target | 对象名 | 不适用 | 否 | [none] |
此命令只能在主卷上发出,并且只能在 HyperSwap 关系处于已激活且已同步状态时发出。
发出此命令后,系统将执行所有暂挂的写操作,并且只有在落实所有暂挂的写操作后,才会转换角色。
成功完成此命令之后:
- 先前的主卷将变为从属卷
- 先前的从属卷将变为主卷
- HyperSwap 关系仍为活动状态。
示例:
ha_switch_roles <vol=VolName | cg=cgName> [ target=TargetName ]
输出:
Command completed successfully
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 已允许 |
| 存储集成管理员 | 已允许 |
| 应用程序管理员 | 已允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
警告
- ARE_YOU_SURE_YOU_WANT_TO_SWITCH_THE_PEER_ROLES
拥有主卷的系统当前未连接到 Quorum Witness。如果您切换同级角色,那么自动故障转移可能会变为不可用。确定要继续吗?
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- LOCAL_PEER_IS_NOT_MASTER
本地同级不是主同级。
- HA_IS_NOT_SYNCHRONIZED
HyperSwap 关系未同步。
- VOLUME_HAS_DATA_MIGRATION
已针对该卷定义数据迁移。
- REMOTE_TARGET_NOT_CONNECTED
当前没有来自目标系统的连接。
- VOLUME_BELONGS_TO_HA_CONS_GROUP
此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。
- HA_CONNECTIVITY_NOT_SUFFICIENT
系统之间的连接不足,无法进行自动故障转移。
- HA_RELATION_MASTER_COULD_NOT_UPDATE_QW_AFTER_RETURN_TO_GOOD_STATE
在过去的故障期间,主卷已控制关系,并且在恢复后无法更新 Quorum Witness。
- HA_HAS_SYNC_JOB
不允许对具有活动同步作业的 HyperSwap 关系执行此操作。
- HA_RETRY_OPERATION
正在对该 HyperSwap 关系执行操作。
故障诊断:请在数秒后重试发出此命令。
- REMOTE_HA_IS_NOT_ACTIVE
此 HyperSwap 关系中的远程同级未处于活动状态。
- TARGET_BAD_NAME
目标名称不存在。
- VOLUME_TARGET_MISMATCH
卷和目标不匹配。
- CONS_GROUP_BAD_TARGET
目标名称与一致性组不匹配。
- COMMAND_NOT_SUPPORTED_FOR_OLVM_VOLUMES
IBM Hyper-Scale Mobility 卷不支持此命令。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- SYSTEM_OUT_OF_PHYSICAL_SPACE
系统物理空间不足,不允许执行此操作。
- VOLUME_IS_NOT_HA
这不是 HyperSwap 卷。
- CONS_GROUP_IS_NOT_HA
本地一致性组不具有 HyperSwap 定义。
- REMOTE_MAY_NOT_HAVE_COMPLETED_THE_OPERATION
此操作可能在远程目标上尚未完成。