更改 HyperSwap 卷中的同级角色
使用 ha_change_role 命令可更改本地 HyperSwap 关系同级的角色,可将主同级更改为从属同级,或将从属同级更改为主同级。
ha_change_role <vol=VolName | cg=cgName> [ target=TargetName ]
[ new_role=<Master|Slave|None> ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 本地卷名。 如果将此命令用于某卷,那么必须指定该参数。 |
否 | 不适用 |
| cg | 对象名 | 一致性组名。 如果将此命令用于某一致性组,那么必须指定该参数。 |
否 | 不适用 |
| target | 对象名 | 目标 HyperSwap 关系名称。 | 否 | [none] |
| new_role | 枚举项 | 同级的角色名称。 如果未指定,那么此命令可在主从同级间交换同级角色。 |
否 | none |
当 HyperSwap 关系处于未激活状态时,此命令可更改本地同级的角色,可将主同级更改为从属同级,或将从属同级更改为主同级。在关系再次被激活之前,应当在两个同级上发出此命令,以便在重新连接时,仍有一个主同级和一个从属同级。
此命令在自动故障转移后的恢复期间使用,或在未执行自动故障转移时用于执行手动故障转移。
要成功地将角色从“主”更改为“从属”,卷可以处于除 Initializing 外的任何阶段。主同级将停止为主机请求提供服务,并被设置为将来自另一个同级的复制接受为从属项。
要成功地将从属同级更改为主同级,必须取消激活 HyperSwap 关系。
在将从属同级更改为主同级之前:
- 确保原来的主同级不可用,并无法在另一个同级成为主同级后变得可用。 要对其进行验证,请在该主同级上运行 ha_list 命令,并检查 IO Service 属性的值。 仅当返回的值为 Unavailable 时,才可以继续在从属同级上发出 ha_change_role 命令。
- 停止使用 HyperSwap 卷的应用程序。 请注意,必须完全停止每个应用程序,而不只是暂停,以确保其不会在角色更改后首次访问卷时使用任何高速缓存状态。
警告: 不满足以上两个要求可能会导致数据完整性问题。
|
在将从属同级成功更改为主同级之后,卷会开始接受来自主机的请求。在显式激活时,它将开始复制到另一个同级(原来的主同级)。
如果同步镜像在再同步过程期间中断,那么从属卷极有可能会不一致。从属卷的最后一个一致映像保留在 last_consistent 快照 (LCS) 中,该快照将在再同步开始前立即自动创建。如果存在 LCS,那么该命令将发出警告:确定要将镜像/HyperSwap 本地同级变为主同级吗?本地同级具有最后一个一致快照。在这种情况下,管理员必须选择是使用先前从属卷的现有内容(可能不一致),还是在发出 ha_change_role 命令之前将先前的从属卷还原为其 last_consistent 快照。
示例:
ha_change_role vol=regular_volume
输出:
Command completed successfully
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 已允许 |
| 存储集成管理员 | 已允许 |
| 应用程序管理员 | 已允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
警告
- SOME_DATA_WILL_BE_LOST_ARE_YOU_SURE
确定要将镜像/HyperSwap 本地同级变为辅助同级并丢失未复制的数据吗?
- ARE_YOU_SURE_YOU_WANT_TO_CHANGE_A_PEER_WITH_LCS_TO_MASTER
确定要将镜像/HyperSwap 本地同级变为主同级吗?本地同级具有最后一个一致快照。
返回码
- VOLUME_IS_NOT_HA
这不是 HyperSwap 卷。
- CONS_GROUP_IS_NOT_HA
本地一致性组不具有 HyperSwap 定义。
- HA_IS_ACTIVE
自动故障转移当前处于活动状态。
- HA_IS_INITIAL
在 HyperSwap 关系初始化阶段,不允许执行此操作。
- VOLUME_BELONGS_TO_HA_CONS_GROUP
此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。
- VOLUME_BAD_NAME
卷名称不存在。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- VOLUME_HAS_DATA_MIGRATION
已针对该卷定义数据迁移。
- HA_RETRY_OPERATION
正在对该 HyperSwap 关系执行操作。
故障诊断:请在数秒后重试发出此命令。
- HA_HAS_NO_SYNCHED_SNAPSHOT
此 HyperSwap 卷不具有已同步的快照。
- MASTER_CANNOT_BE_DEMOTED
主卷无法降级为辅助卷。同级状态不匹配。
- 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
系统物理空间不足,不允许执行此操作。