删除 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 关系处于不活动状态或连接失败时删除
在活动的主卷上
在活动的主卷上,可按照以上描述执行命令。
在活动的从属卷上
要点: 请勿将从属卷映射到主机。 如果需要读取或更新数据,请使用 vol_copy 命令将数据复制到新卷,然后将该新卷映射到主机。
|
- 运行 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 目标上进行操作。