创建快照
使用 snapshot_create 命令可创建现有卷的快照。
snapshot_create vol=VolName < [ name=Name ]
[ delete_priority=del_value ] > | < overwrite=Name > [ ext_id=Identifier ]
参数
| Name | 类型 | 描述 | 必需 | Default |
|---|---|---|---|---|
| 卷 | 对象名 | 要获取快照的卷的名称。 | Y | 不适用 |
| name | 对象名 | 新快照的名称。 | N | 自动生成的名称。 |
| delete_priority | 整数 | 卷快照的删除优先级。 | N | 1 |
| overwrite | 对象名 | 要使用当前卷内容覆盖的现有快照的名称。 | N | 不适用 |
| ext_id | String | 卷的外部标识符。 | N | 不适用 |
此命令可为现有卷(称为快照的主卷)创建新的快照。 快照的内容与创建快照时主卷的内容完全相同。 即使主卷的内容在创建快照后发生更改,快照的内容也保持不变。 成功完成此命令后,将创建快照并为其指定一个供其他命令使用的名称。 此名称不要求是全新的。 它可以使用现有快照的名称(在此情况下,将覆盖现有的快照)。
创建快照的同时可以处理写操作,这意味着写操作请求是在命令执行前发送到系统的,但是该写操作是在执行命令后才确认的。 在此情况下,快照的内容是不确定的,可能包含写操作前的原始值,也可能包含写操作后的新值。 实际上,快照的数据可能包含两种的混合,其中某些块与执行写操作之前的卷内容相同,而另一些块则与执行写操作之后的值相同。
新快照最初被锁定,不允许更改。
- 快照的名称既可以由其主卷的名称自动生成,也可以作为命令的参数指定。 用户随后可以修改此名称,而不会改变快照的修改状态。
- 成功执行此命令后,系统会向此快照分配一个唯一 SCSI 标识。 快照的创建时间将设置为当前时间,该值直到快照删除前都不会更改。
- 快照的大小与其主卷的大小相同,但不会为快照保留存储空间。 换而言之,快照的功能无法保证。 快照存储池的空间一旦不足,可能会将快照删除。
- 快照的锁定状态最初设置为“locked”,只要它的状态不是“unlocked”,那么快照将保留创建时主卷的完整映像,并且可作为恢复操作的源。 快照的修改状态最初设置为“unmodified”。
创建期间,可以明确设置快照的删除优先级,或者会自动设置为缺省值。 删除优先级确定在存储池的快照存储空间不足时要首先删除的快照。 写入时重定向机制可能到导致此情况发生,该机制在卷及其快照之间以及相同卷的快照之间共享未更改的数据。
自动删除优先级的值可以在 1 到 4 之间,如下所示:
- 1 = 最后一个自动删除(“1”是系统设置的缺省值)
- ...
- 4 = 第一个自动删除
快照与其主卷关联,只要快照存在,便无法中断或更改此关联。
overwrite 选项会将卷的当前内容复制到其某个现有的快照(设置为输入自变量)中。 覆盖的快照保持相同的 SCSI 设备 WWN 和相同的映射,因此主机可以维护到快照的连续映射,而无需重新扫描或执行类似操作。 被覆盖的快照必须是给定卷的现有快照。 被覆盖的快照不能属于快照组。
如果在主卷所属的存储池中未定义快照空间,那么此命令将失败。
镜像限制:
- 如果卷是异步镜像耦合的从属项,那么该命令将失败。
- 如果卷是不一致同步耦合的从属项,那么该命令将失败。
示例:
snapshot_create vol=DBVolume name=DBVolume.snapshot1 delete_priority=2
输出:
Command executed successfully.
访问控制
| 用户类别 | 许可权 | 条件 |
|---|---|---|
| 存储管理员 | 允许 | 不适用 |
| 存储集成管理员 | 允许 | 不适用 |
| 应用程序管理员 | 特定条件下才能获得允许 | 卷已映射到与用户关联的主机或集群。 如果使用快照覆盖,那么目标快照必须是服务器管理员创建的快照。 |
| 安全性管理员 | 不允许 | 不适用 |
| 只读用户 | 不允许 | 不适用 |
| 技术人员 | 不允许 | 不适用 |
返回码
- VOLUME_BAD_NAME
卷名称不存在。
- MAX_VOLUMES_REACHED
已达到允许的最大卷数。
- DOMAIN_MAX_VOLUMES_REACHED
域超出了所允许的最大卷数。
- SNAPSHOT_ILLEGAL_PRIORITY
非法快照优先级;必须为 1 与 4 之间的整数。
- VOLUME_IS_SNAPSHOT
不允许对快照执行此操作。
- VOLUME_EXISTS
卷名称已存在。
- VOLUME_BAD_PREFIX
卷名称具有保留的前缀。
- VOLUME_DATA_MIGRATION_UNSYNCHRONIZED
到该卷的数据迁移尚未完成。
- OVERWRITE_SNAPSHOT_BAD_NAME
快照名称不存在。
- OVERWRITE_SNAPSHOT_IS_MASTER_VOL
由于此快照是主卷,因此无法覆盖。
- SNAPSHOT_OVERWRITE_MISMATCH
指定的快照不是指定卷的快照。
- SNAPSHOT_IS_PART_OF_SNAPSHOT_GROUP
快照属于快照组。
- SNAPSHOT_IS_INTERNAL
无法映射、修改或删除内部快照。
- POOL_SNAPSHOT_LIMIT_REACHED
没有足够的空间来创建快照。
- VOLUME_IS_NOT_CONSISTENT_SLAVE
不允许针对不一致的辅助卷执行此操作。
- VOLUME_IS_NOT_CONSISTENT_OLVM_DESTINATION
不允许针对不一致的 IBM Hyper-Scale Mobility 卷执行此操作。
- VOLUME_IS_OLVM_PROXY
卷处于 IBM Hyper-Scale Mobility Proxy 阶段。
- SNAPSHOT_HAS_ACTIVE_SYNC_JOB
快照当前是活动同步作业的目标。
故障诊断:请等待同步作业完成。
- TOO_MANY_FAST_SNAPSHOTS_IN_VOLUME
已达到此卷允许的最大快速快照数。
- OPERATION_DENIED_OBJECT_MANAGED
这是一个受管对象。 只有管理软件和 xiv_maintenance/xiv_development 才可以对此对象执行此操作。
- NUM_VOLUMES_WILL_EXCEED_MAXIMUM
不能创建所有卷,否则卷的数量将超过允许的最大值。
- DOMAIN_WILL_EXCEED_MAXIMUM_VOLUMES_ALLOWED
不能创建所有卷,否则将超过域中允许的最大卷数。
- DATA_REDUCTION_TIER_IS_OFFLINE
数据降维层处于脱机状态,不允许执行该操作。
故障诊断:请联系 IBM 支持人员
- MAX_SNAPSHOTS_PER_VOLUME_REACHED
已达到允许的最大快照数。