volume select snapshot select

Enables you to select a snapshot and perform the following tasks:

To display snapshot names, see volume select snapshot show .

Format

volume select vol_name snapshot select snap_name subcommand|parameter ...

Variables  

vol_name

Name of a volume.

snap_name

Name of a snapshot.

Subcommands  

clone

Clones a snapshot to create a new volume.

restore

Restores the volume from a snapshot.

show [connections]

Displays detailed information about a snapshot or about iSCSI connections to a snapshot.

Parameters 

description text

Description for the snapshot. If the text variable contains spaces, surround it with quotation marks.

iscsi-alias alias_name

iSCSI target alias for the snapshot, up to 64 alphanumeric characters. Some iSCSI initiators can see this alias.

lost-blocks action

Action to take when lost blocks occur on the snapshot, either:

return-error – Set the snapshot online but retain the lost cached block state. If an application attempts to read a lost block, an error will occur. If the block is rewritten, no error will occur and the block will no longer be considered lost. The snapshot will be in the online-lost-cached-blocks state.

mark-valid – Mark the lost blocks valid and set the snapshot online. This action may present a security risk, and the blocks may contain old data.

Note that lost cached blocks can occur if a power failure lasts longer than 72 hours.

offline|online

Snapshot status.

read-only|read-write

Snapshot permission.

Example

The following command sets a snapshot of volume db online:

> volume select db snapshot select db-2006-01-30-10:59:46.1 online