3.9.4.1 Create a Volume Clone
An Exascale volume clone is a thinly-provisioned read-write point-in-time copy of a volume snapshot.
To create an Exascale volume
clone, use the ESCLI mkvolume
command and specify the attributes for a volume
clone. The command syntax is:
@> mkvolume --attributes volumeSnapshot=parent_snapshot_id[,name=clone_name][,iopsProvisioned=integer_value][,iopsInherited={true|false}]
In the command:
-
volumeSnapshot=parent_snapshot_id
: Identifies the volume snapshot that you want to clone. You can use thelsvolumesnapshot
command to find the identifier for each volume snapshot. -
name=clone_name
: Optionally specifies the name of the volume clone, which makes it easier for you to identify later. If not specified, a system-generated name is assigned. -
iopsProvisioned=integer_value
: Optionally specifies the I/O bandwidth provisioned for the volume clone. The I/O bandwidth is expressed as the number of I/Os per second (IOPS). -
iopsInherited={true|false}
: Optionally specifies whether the volume clone inherits I/O bandwidth from the nearest ancestor in the volume hierarchy with provisioned I/O bandwidth (not inherited).
The following describes the relationship between the
iopsProvisioned
and iopsInherited
attribute
settings:
-
If
iopsProvisioned
is unspecified andiopsInherited
is not set tofalse
(iopsInherited
is unspecified oriopsInherited=true
), then:-
The volume clone inherits I/O bandwidth from its nearest ancestor.
-
The volume clone has the setting:
iopsInherited=true
.
-
-
If
iopsProvisioned
is unspecified andiopsInherited=false
, then:-
The volume clone is provisioned with unlimited
iopsProvisioned
. -
The volume clone has the setting:
iopsInherited=false
.
-
-
If you specify a value for
iopsProvisioned
andiopsInherited
is not set totrue
(iopsInherited
is unspecified oriopsInherited=false
), then:-
The volume clone is governed by the specified
iopsProvisioned
value. -
The volume clone has the setting:
iopsInherited=false
.
-
-
An error occurs if you specify a value for
iopsProvisioned
andiopsInherited=true
. This is an invalid combination.
After you create a volume clone, you must create an attachment to access the contents. By itself, an unattached volume clone is not available to any clients.
Parent topic: Administer Volume Clones