创建 HyperSwap 卷快照(特别同步作业)
使用 ha_create_snapshot 命令可在 HyperSwap 关系的两个同级上同时创建快照。
ha_create_snapshot <vol=VolName | cg=cgName> [ target=TargetName ]
name=Name [ slave_name=SnapshotName ] [ delete_priority=del_value ]
参数
| 名称 | 类型 | 描述 | 必需 | 缺省值 |
|---|---|---|---|---|
| vol | 对象名 | 要为其创建快照的卷的名称。 | 否 | 不适用 |
| cg | 对象名 | 本地主一致性组名称。 | 否 | 不适用 |
| target | 对象名 | 目标 HyperSwap 关系名称。 | 否 | [none] |
| name | 对象名 | 新快照的名称。 | 是 | 不适用 |
| slave_name | 对象名 | 从属卷上新快照的名称。 | 否 | [none] |
| delete_priority | 整数 | 卷快照的删除优先级。 | 否 | 1 |
此命令会同时获取源同级(主同级)和目标同级(从属同级)的快照。 在主同级和从属同级上同时创建的快照是相同的。
- HyperSwap 关系已激活且已同步。
由此命令创建的快照可通过常规快照命令进行管理。 例如,要删除这些快照,可在每个同级上发出 snapshot_delete 命令。
示例:
ha_create_snapshot <vol=VolName | cg=cgName> [ target=TargetName ]
name=Name [ slave_name=SnapshotName ] [ delete_priority=del_value ]
输出:
Command completed successfully
访问控制
| 用户类别 | 许可权 | 条件 |
|---|---|---|
| 存储管理员 | 已允许 | 不适用 |
| 存储集成管理员 | 已允许 | 不适用 |
| 应用程序管理员 | 有条件允许 | 卷已映射到与用户关联的主机或集群。 |
| 安全性管理员 | 不允许 | 不适用 |
| 只读用户 | 不允许 | 不适用 |
| 技术人员 | 不允许 | 不适用 |
返回码
- CONS_GROUP_MISMATCH
快照组与一致性组卷不匹配。
- CONS_GROUP_EMPTY
不允许对空的一致性组执行此操作。
- CONS_GROUP_BAD_NAME
一致性组名不存在。
- VOLUME_IS_NOT_HA
这不是 HyperSwap 卷。
- CONS_GROUP_IS_NOT_HA
本地一致性组不具有 HyperSwap 定义。
- LOCAL_PEER_IS_NOT_MASTER
本地同级不是主同级。
- HA_IS_NOT_SYNCHRONIZED
HyperSwap 关系未同步。
- HA_RETRY_OPERATION
正在对该 HyperSwap 关系执行操作。
故障诊断:请在数秒后重试发出此命令。
- HA_IS_NON_OPERATIONAL
此 HyperSwap 卷不可操作。
- MAX_VOLUMES_REACHED
已达到允许的最大卷数。
- DOMAIN_MAX_VOLUMES_REACHED
域超出了所允许的最大卷数。
- OPERATION_NOT_ALLOWED_ON_LOOPBACK
在回送目标上不允许执行请求的操作。
- OVERWRITE_SNAPSHOT_BAD_NAME
快照名称不存在。
- OVERWRITE_SNAPSHOT_GROUP_DOES_NOT_BELONG_TO_GIVEN_GROUP
快照组属于另一个一致性组。
- POOL_SNAPSHOT_LIMIT_REACHED
没有足够的空间来创建快照。
- REMOTE_POOL_SNAPSHOT_LIMIT_REACHED
远程目标上没有足够的空间用于创建快照。
- REMOTE_MAX_VOLUMES_REACHED
已达到远程机器上的最大卷数。
- REMOTE_MAX_SNAPSHOTS_FOR_VOLUME_REACHED
在版本不是 10.2.4 的远程机器上已达到每个卷允许的最大快照数。
- REMOTE_VOLUME_IS_MASTER
已将远程机器上的卷定义为主卷。
- REMOTE_VOLUME_IS_SNAPSHOT
辅助卷是快照。
- REMOTE_SNAPSHOT_NAME_EXISTS
远程快照名称已存在。
- REMOTE_SNAPSHOT_ILLEGAL_PRIORITY
非法快照优先级(远程);必须为 1 与 4 之间的整数。
- REMOTE_SNAPSHOT_GROUP_NAME_EXISTS
远程快照组名已存在。
- REMOTE_SNAPSHOT_GROUP_ILLEGAL_PRIORITY
非法快照组优先级(远程);必须为 1 与 4 之间的整数。
- REMOTE_SNAPSHOT_GROUP_BAD_PREFIX
远程快照组名具有保留的前缀。
- REMOTE_SNAPSHOT_BAD_PREFIX
远程快照名称具有保留的前缀。
- REMOTE_CONS_GROUP_EMPTY
不允许对空的一致性组(远程)执行此操作。
- REMOTE_CONS_GROUP_MISMATCH
远程快照组与一致性组卷不匹配。
- SNAPSHOT_ILLEGAL_PRIORITY
非法快照优先级;必须为 1 与 4 之间的整数。
- SNAPSHOT_IS_INTERNAL
无法映射、修改或删除内部快照。
- SNAPSHOT_GROUP_IS_INTERNAL
无法映射、修改或删除内部快照。
- SNAPSHOT_GROUP_NAME_EXISTS
快照组名已存在。
- SNAPSHOT_GROUP_ILLEGAL_PRIORITY
非法快照组优先级;必须为 1 与 4 之间的整数。
- SNAPSHOT_GROUP_BAD_NAME
快照组名不存在。
- SNAPSHOT_GROUP_BAD_PREFIX
快照组名具有保留的前缀。
- SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
快照是快照组的一部分。
- VOLUME_BAD_PREFIX
卷名称具有保留的前缀。
- VOLUME_BELONGS_TO_HA_CONS_GROUP
此卷属于 HyperSwap 一致性组。可以针对不属于一致性组的卷或者一致性组本身执行此操作。
- VOLUME_EXISTS
卷名称已存在。
- VOLUME_BAD_NAME
卷名称不存在。
- VOLUME_IS_NOT_CONSISTENT_SLAVE
不允许针对不一致的辅助卷执行此操作。
- VOLUME_IS_SNAPSHOT
不允许对快照执行此操作。
- CONS_GROUP_BAD_TARGET
目标名称与一致性组不匹配。
- TARGET_BAD_NAME
目标名称不存在。
- VOLUME_TARGET_MISMATCH
卷和目标不匹配。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行此操作。
故障诊断:请联系 IBM 支持人员
- MAX_SNAPSHOTS_PER_VOLUME_REACHED
已达到允许的最大快照数。
- REMOTE_MAX_SNAPSHOTS_PER_VOLUME_REACHED
远程系统上已达到允许的最大快照数。
- REMOTE_DOMAIN_MAX_VOLUMES_REACHED
已达到远程机器域中的最大卷数。
- REMOTE_CONS_GROUP_BAD_NAME
远程一致性组名不存在。
- SNAPSHOT_CAN_NOT_BE_CREATED_REMOTE_CONS_GROUP_IO_IS_NOT_PAUSED
由于远程一致性组未处于停止状态,因此无法创建快照组。
- SNAPSHOT_CAN_NOT_BE_CREATED_REMOTE_CONS_GROUP_DEFINITION_CHANGED
由于在发出 io_pause 命令后远程一致性组中的卷已更改,因此将不会创建快照组。
- REMOTE_OVERWRITE_SNAPSHOT_GROUP_DOES_NOT_BELONG_TO_GIVEN_GROUP
远程快照组属于另一个一致性组。