Clones the selected volume, creating a new volume.
The new volume will have a different name, but the same size and contents as the original volume at the time of the cloning. By default, the new volume will be online and have read-write permission and use the group-wide snapshot and iSCSI settings, unless you override them.
Cloning a volume consumes 100% of the original volume size from free pool space. Cloned volumes inherit the original volume’s thin-provision status. If the original volume has thin provisioning enabled, so will the clone, with all the same attributes as the original. However, a volume clone does not inherit the RAID preference policy of the parent volume; it is set to none, by default.
The new volume does not inherit the original volume’s snapshot reserve settings; the new volume is created with the group-wide default value for snapshot reserve. The new volume also does not inherit the original volume’s replication space settings or configuration. If you want to create replicas of the new volume, you must configure replication on the new volume.
The new volume is available immediately and you can use and modify it as you would any other volume.
The cloned volume will reside in the same pool as the original volume. To change the pool, modify the new volume.
Note: Cloning a volume does not have any effect on the original volume, which continues to exist after being cloned.
Format
volume select vol_name clone clone_name parameter ...
Variables
|
vol_name |
Name of a volume. |
|
clone_name |
Name for the 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 |
Description for the new volume. If the text variable contains spaces, surround it with quotation marks. |
|
iscsi-alias alias_name |
iSCSI target alias, up to 64 alphanumeric characters, for the new volume. 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-write|read-only |
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, to reserve 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 volume, create one or more access control records for the new volume to restrict host access. See volume select access create . |
Example
The following command clones volume dbvol, creating the new volume vol3:
> volume select dbvol clone vol3
Volume creation succeeded.
iSCSI target name is iqn.2001-05.com.equallogic:6-8b0900-2ae20000-
99e00000067405b5-vol3
Cloning is in progress.