更改 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

    系统物理空间不足,不允许执行此操作。