Clones the selected volume snapshot.
Cloning a snapshot creates a new volume with the same contents as the original volume at the time the snapshot was created. Hosts can connect to the new volume, and you can manage the volume as usual. For example, you can change the volume size, create access control records, or set up a snapshot schedule.
By default, the new volume will be set online, have read-write permission, and use the group-wide snapshot space and iSCSI settings, unless you override them.
Because the new clone is considered a volume, it is displayed in the output of the volume show command.
The snapshot will still exist after cloning. The cloned snapshot will be in the same pool as the volume.
Format
volume select vol_name snapshot select snap_name clone new_vol_name [parameters]
Variables
|
vol_name |
Name of a volume. |
|
snap_name |
Name of a snapshot. |
|
new_vol_name |
Name for new volume. |
Parameters
|
bind member_name |
Binds the new volume to the specified member. Volume data will be restricted to this member. Binding a volume to a member will override any RAID preference for the volume. |
|
description text |
Snapshot description, up to 128 alphanumeric characters. 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 the alias. The default is the group-wide setting, as described in grpparams def-iscsi-alias. |
|
offline|online |
New volume status. The default is online. |
|
read-only|read-write |
New volume permission. The default is read-write. |
|
snap-depletion action |
Action to take when the new volume’s snapshot reserve is exceeded, either delete-oldest (delete the oldest snapshots, the default) or volume-offline (set the volume and its snapshots offline). The default is the group-wide setting, as described in grpparams def-snap-depletion . |
|
snap-reserve n% |
Amount of space, as a percentage of the new volume size, reserved for snapshots of the new volume. You must include the percent sign. The default is the group-wide setting, as described in grpparams def-snap-reserve . |
|
snap-warn n% |
Threshold at which an alarm is generated because the amount of free space reserved for snapshots of the new volume has fallen below this value, as a percentage of the total reserved snapshot space. You must include the percent sign. The default is the group-wide setting, as described in grpparams def-snap-warn . |
|
unrestricted |
Allows unrestricted host access to the new volume. Unrestricted access is not recommended. Instead, after cloning the snapshot, you should create one or more access control records for the volume to restrict host access. See volume select access create . |
Example
The following command clones a snapshot and names the new volume stf2:
> volume select stf snapshot select stf-10-2006-01-11-15:44:35.11 clone stf2