删除 HyperSwap 关系

使用 ha_delete 命令可删除 HyperSwap 关系。

ha_delete < vol=VolName | cg=cgName > [ target=TargetName ] [ force_on_slave=<Yes|No> ]

参数

名称 类型 描述 必需 缺省值
vol 对象名 本地主卷名称。 不适用(必须指定卷或一致性组)
cg 对象名 本地主一致性组名称。 不适用(必须指定卷或一致性组)
target 对象名 目标 HyperSwap 关系名称 [none]
force_on_slave 布尔值 强制删除从属同级上的 HyperSwap 关系。 仅当从属同级处于 Initializing 状态时可用。 no

只能在主同级上发出此命令。 此命令只删除 HyperSwap 关系的定义。 不会删除卷本身,也不会删除其快照。

要删除 HyperSwap 关系,必须满足以下先决条件:

  • HyperSwap 关系处于 Standby 状态,即刚创建或取消激活此关系。
  • 已建立通信。 如果未建立通信,那么只能删除主同级上的 HyperSwap 关系。 通信恢复后,从属同级上会发出配置错误。
  • 未映射从属卷。

删除 HyperSwap 关系后,会将其两个同级都标记为 none,表示不再将其配置为主同级或从属同级。

命令成功完成后,会替换从属卷的 SCSI 标识。 卷名称、外部标识、锁定状态以及元数据仍与主卷的值相同。

在 HyperSwap 关系处于不活动状态或连接失败时删除

在活动的主卷上

在活动的主卷上,可按照以上描述执行命令。

在活动的从属卷上

在同级间通信中断的情况下删除 HyperSwap 关系时,只会删除主同级上的 HyperSwap 关系。 要删除从属同级上的 HyperSwap 关系,请执行以下操作:
  • 运行 ha_change_role 命令,将从属同级转变为主同级
  • 运行 ha_delete

force_on_slave 参数只有在 HyperSwap 关系处于 Initializing 阶段时才可用。 在任何其他状态下,请将从属同级更改为主同级,然后再运行 ha_delete

在断开连接的主卷或从属卷上

要删除断开连接的同级卷上的 HyperSwap 关系,请重新连接同级卷,然后运行 ha_delete

如果无法重新连接同级卷,请联系 IBM 支持人员。

示例:

ha_delete vol=regular_volume -y

输出:

Command completed successfully

访问控制

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

警告

  • ARE_YOU_SURE_YOU_WANT_TO_DELETE_CG_HA

    确定要删除一致性组的 HyperSwap 关系以及其中的所有卷吗?

返回码

  • VOLUME_BAD_NAME

    卷名称不存在。

  • VOLUME_IS_NOT_HA

    这不是 HyperSwap 卷。

  • CONS_GROUP_IS_NOT_HA

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

  • CONS_GROUP_BAD_NAME

    一致性组名不存在。

  • LOCAL_PEER_IS_NOT_MASTER

    本地同级不是主同级。

  • HA_IS_ACTIVE

    自动故障转移当前处于活动状态。

  • FORCE_DELETE_NOT_ALLOWED_ON_MASTER

    只需在辅助镜像上强制执行删除操作。

  • VOLUME_BELONGS_TO_HA_CONS_GROUP

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

  • HA_RETRY_OPERATION

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

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

  • HA_IS_NOT_INITIALIZING

    仅在初始化阶段才允许删除 HyperSwap 关系。

  • TARGET_BAD_NAME

    目标名称不存在。

  • VOLUME_TARGET_MISMATCH

    卷和目标不匹配。

  • CONS_GROUP_BAD_TARGET

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

  • DATA_REDUCTION_TIER_IS_OFFLINE

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

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

  • SLAVE_VOLUME_IS_MAPPED

    已映射辅助卷。

  • MIRROR_CONS_GROUP_MEMBERSHIP_MISMATCH

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

  • VOLUME_IS_AN_UNAVAILABLE_HYPERSWAP_PEER

    不允许在不可用于 IO 的 HyperSwap 目标上进行操作。