更改镜像卷的角色
使用 mirror_change_role 命令可将本地镜像同级的角色由主角色更改为从属角色或由从属角色更改为主角色。
mirror_change_role <vol=VolName | cg=cgName>
[ target=TargetName ] [ new_role=<Master|Slave|None> ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 本地卷名。
如果将此命令用于某卷,那么必须指定该参数。 |
N | 不适用 |
| cg | 对象名 | 一致性组名。 如果将此命令用于某一致性组,那么必须指定该参数。 |
N | 不适用 |
| target | 对象名 | 目标镜像名称。 如果在卷上定义了 2 个镜像,那么该参数是必需的。 | N | [none] |
| new_role | 枚举 | 同级的角色名称。 如果未指定,那么此命令可在主从同级间交换同级角色。 |
N | none |
当耦合不可操作时,此命令可将本地同级的角色由主角色更改为从属角色或由从属角色更改为主角色。假定在耦合的两个同级上同时发出此命令,那么在该耦合再次进入操作状态之后,重新连接时将仍一个主同级和一个从属同级。
要成功完成命令:
- 请勿在状态为正在初始化的同级上发出该命令。
- 请勿在更改跟踪状态下发出该命令。
- 请勿在属于已镜像一致性组的卷上发出该命令,否则该命令将返回错误并失败。
在同步镜像中更改角色
当在主同级上应用时,主同级将变为从属同级,这将停止为主机请求提供服务,并被设置为将来自另一个同级的复制接受为从属项。
在从属同级上应用时,从属同级将变为主同级,开始接受来自主机的请求,显式激活后开始复制到另一个同级(原来的主同级)。
如果同步镜像在再同步过程期间中断,那么从属卷可能非常不一致。从属卷的最后一个一致映像保留在 last_consistent 快照 (LCS) 中,该快照将在再同步开始前立即自动创建。如果存在 LCS,那么该命令将发出警告:确定要将镜像/HyperSwap 本地同级变为主同级吗?本地同级具有最后一个一致快照。在这种情况下,管理员必须选择是使用先前从属卷的现有内容(可能不一致),还是在发出 mirror_change_role 命令之前将先前的从属卷还原为其 last_consistent 快照。
在异步镜像中更改角色
在主同级上成功应用时,会将主同级还原为镜像的 last_replicated 快照上记录的映像,并停止接受主机请求。
应用于从属同级时:
- 会显示警告。
- 生成事件。
- 新的主同级将停止接受来自先前主同级的复制请求,并且还原到 last_replicated 快照。
- 新的主同级开始接受主机请求。
- 在日志中记录流程完成。
- 需要显式激活镜像。
访问控制
| 用户类别 | 许可权 |
|---|---|
| 存储管理员 | 允许 |
| 存储集成管理员 | 允许 |
| 应用程序管理员 | 允许 |
| 安全性管理员 | 不允许 |
| 只读用户 | 不允许 |
| 技术人员 | 不允许 |
警告
- SOME_DATA_WILL_BE_LOST_ARE_YOU_SURE
确定要将镜像/HyperSwap 本地同级变为辅助同级并丢失未复制的数据吗?
- ARE_YOU_SURE_YOU_WANT_TO_CHANGE_A_PEER_WITH_LCS_TO_MASTER
确定要将镜像/HyperSwap 本地同级变为主同级吗?本地同级具有最后一个一致快照。
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- VOLUME_NO_MIRROR
本地卷不具有远程镜像定义。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- CONS_GROUP_NO_MIRROR
本地一致性组不具有远程镜像定义。
- MIRROR_IS_INITIAL
在初始化阶段期间不允许进行操作。
- MIRROR_IS_ACTIVE
远程镜像当前处于活动状态。
- VOLUME_HAS_DATA_MIGRATION
已针对该卷定义数据迁移。
- VOLUME_BELONGS_TO_MIRRORED_CONS_GROUP
卷镜像是一致性组镜像的一部分。
- MIRROR_RETRY_OPERATION
在此镜像中正在进行某项操作。
故障诊断:请在几秒钟后再试一次该命令。
- MIRROR_HAS_NO_SYNCHED_SNAPSHOT
镜像没有已同步的快照。
- MASTER_CANNOT_BE_DEMOTED
主卷无法降级为辅助卷。同级状态不匹配。
- VOLUME_HAS_MULTIPLE_MIRRORS
卷具有多个镜像。不允许执行此操作,或者必须指定目标。
- TARGET_BAD_NAME
目标名称不存在。
- VOLUME_TARGET_MISMATCH
卷和目标不匹配。
- CONS_GROUP_BAD_TARGET
目标名称与一致性组不匹配。
- MIRROR_IS_STANDBY
镜像标记为“备用”。
- COMMAND_NOT_SUPPORTED_FOR_OLVM_VOLUMES
IBM Hyper-Scale Mobility 卷不支持此命令。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- SYSTEM_OUT_OF_PHYSICAL_SPACE
系统物理空间不足,不允许执行此操作。