创建快照

使用 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

    已达到允许的最大快照数。