激活 HyperSwap 关系

使用 ha_activate 命令可激活卷或一致性组的 HyperSwap 关系。

ha_activate < vol=VolName | cg=cgName > [ target=TargetName ]

参数

名称 类型 描述 必需 缺省值
vol 对象名 主卷名称。 不适用(必须指定卷或一致性组)
cg 对象名 主一致性组名称。 不适用(必须指定卷或一致性组)
target 对象名 目标 HyperSwap 关系名称。 [none]

此命令会更新 Quorum Witness 中执行该操作后 HyperSwap 关系的状态。 如果 HyperSwap 为启用状态,那么在 Quorum Witness 更新失败的情况下,此命令也将失败。如果 HyperSwap 为禁用状态,那么即使 Quorum Witness 更新失败,此命令也可能会成功执行。

成功完成命令需要满足以下条件:

  • 在同一 Quorum Witness 上配置了主卷和从属卷
  • 主卷和从属卷与 Quorum Witness 的连接正常运行
  • 指定的卷为主卷
  • 主卷与从属卷之间的连接足以满足 HyperSwap 要求(也就是说,ha_list 命令输出中的 link up 状态为 yes)。

如果关系已处于活动状态,那么将不执行任何操作,并会返回一个成功代码。

如果出现以下情况,将无法激活 HyperSwap 关系:
  • cg_add_volumecg_remove_volume 命令后,由于命令超时或意外失败,在未收到从属卷应答的主卷上发出此命令。 在此情况下,命令将失败,并会返回 HA_CONFIGURATION_ERROR 代码。 这意味着 HyperSwap 一致性组同级的成员列表不相同。
  • vol_resize 命令后,由于命令超时或意外失败,在未收到从属卷应答的主卷上发出此命令。 在此情况下,命令将失败,并会返回 HA_CONFIGURATION_ERROR 代码。 该错误意味着 HyperSwap 卷同级的大小不相同。

示例:

ha_activate vol=regular_volume target=123

输出:

Command completed successfully

访问控制

用户类别 许可权
存储管理员 已允许
存储集成管理员 已允许
应用程序管理员 已允许
安全性管理员 不允许
只读用户 不允许
技术人员 不允许

返回码

  • VOLUME_BAD_NAME

    卷名称不存在。

  • CONS_GROUP_BAD_NAME

    一致性组名不存在。

  • LOCAL_PEER_IS_NOT_MASTER

    本地同级不是主同级。

  • HA_CONFIGURATION_ERROR

    HyperSwap 关系的本地配置与其远程配置不匹配。

  • REMOTE_MAX_VOLUMES_REACHED

    已达到远程机器上的最大卷数。

  • SYNC_ALREADY_ACTIVE

    同步已处于活动状态。

  • VOLUME_BELONGS_TO_HA_CONS_GROUP

    此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。

  • DOMAIN_MAX_VOLUMES_REACHED

    域超出了所允许的最大卷数。

  • HA_CAN_NOT_BE_ACTIVATED

    无法激活自动故障转移。

  • HA_CONS_GROUP_MEMBERSHIP_MISMATCH

    HyperSwap 一致性组包含不同的主卷和辅助卷。只要先前发出了 cg_add_vol 或 cg_remove_vol 命令并且主机器在命令超时前未收到辅助机器的应答,或发生其他任何意外故障,就会发生此问题。

  • HA_SIZE_MISMATCH

    此 HyperSwap 关系中主卷和辅助卷的大小不同。

  • HA_RETRY_OPERATION

    正在对该 HyperSwap 关系执行操作。

    故障诊断:请在数秒后重试发出此命令。

  • TARGET_BAD_NAME

    目标名称不存在。

  • VOLUME_TARGET_MISMATCH

    卷和目标不匹配。

  • CONS_GROUP_BAD_TARGET

    目标名称与一致性组不匹配。

  • VOLUME_TOO_MANY_ACTIVE_MIRRORS

    如果卷上已激活多个镜像,那么无法使用此命令。

  • REMOTE_DOMAIN_MAX_VOLUMES_REACHED

    已达到远程机器域中的最大卷数。

  • DATA_REDUCTION_TIER_IS_OFFLINE

    数据降维层处于脱机状态,不允许执行此操作。

    故障诊断:请联系 IBM 支持人员

  • REMOTE_DATA_REDUCTION_TIER_IS_OFFLINE

    远程系统的数据降维层处于脱机状态,不允许执行此操作。

    故障诊断:请联系 IBM 支持人员

  • REMOTE_SYSTEM_OUT_OF_PHYSICAL_SPACE

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

  • TARGET_PEER_NOT_HEALTHY

    目标同级未标识为正常运行。

    故障诊断:请检查 Quorum Witness 配置。

  • TARGET_HAS_NO_QUORUM_WITNESS

    本地目标未定义 Quorum Witness。

  • REMOTE_TARGET_HAS_NO_QUORUM_WITNESS

    远程系统上的目标未定义 Quorum Witness。

  • VOLUME_IS_NOT_HA

    这不是 HyperSwap 卷。

  • CONS_GROUP_IS_NOT_HA

    本地一致性组不具有 HyperSwap 定义。

  • HA_CONNECTIVITY_NOT_SUFFICIENT

    系统之间的连接不足,无法进行自动故障转移。

  • HA_PEER_QUORUM_WITNESS_CONFIGURATION_NOT_VERIFIED

    未验证同级与 Quorum Witness 之间的连接。

  • HA_REMOTE_PEER_QUORUM_WITNESS_CONFIGURATION_NOT_VERIFIED

    未验证远程同级与 Quorum Witness 之间的连接。

  • HA_TARGET_QUORUM_WITNESS_IS_NOT_ACTIVATED

    已取消激活与目标关联的 Quorum Witness。

  • HA_REMOTE_TARGET_QUORUM_WITNESS_IS_NOT_ACTIVATED

    已取消激活与远程目标关联的 Quorum Witness。