volume clone create

Create a FlexClone volume

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The volume clone create command creates a FlexClone volume on the aggregate containing the specified parent volume. This command is only supported for flexible volumes. The maximum volume clone hierarchy depth is 500 and the default depth is 60. You can optionally specify the following attributes for the new FlexClone volume:

Parameters

-vserver <vserver name> - Vserver Name
This parameter specifies the Vserver on which the FlexClone volume is to be created. If only one data Vserver exists, you do not need to specify this parameter.
-flexclone <volume name> - FlexClone Volume
This parameter specifies the name of the FlexClone volume. The name must be unique within the hosting Vserver.
[-type {RW|DP}] - FlexClone Type
This parameter specifies the type of FlexClone volume. A read-only FlexClone volume is created if you specify the type as DP; otherwise a read-write FlexClone volume is created.
[-parent-vserver <vserver name>] - FlexClone Parent Vserver
This parameter specifies the name of the Vserver to which the FlexClone parent volume belongs. If it is different from the Vserver on which the FlexClone volume is to be created, then the FlexClone volume inherits the export policies from the residing Vserver, and not from the FlexClone parent volume.
-parent-volume | -b <volume name> - FlexClone Parent Volume
This parameter specifies the name of parent volume from which the FlexClone clone volume is derived.
[-parent-snapshot <snapshot name>] - FlexClone Parent Snapshot
This specifies the name of the parent snapshot from which the FlexClone clone volume is derived.
[-junction-path <junction path>] - Junction Path
This specifies the junction path at which the new FlexClone clone volume should be mounted.
[-junction-active {true|false}] - Junction Active
This optionally specifies whether the volume's junction path is active. The default setting is true. If the junction path is inactive, the volume does not appear in the Vserver's namespace. This parameter is available only at the advanced privilege level and higher.
[-space-guarantee | -s {none|volume}] - Space Guarantee Style
This optionally specifies the space guarantee style for the FlexClone volume. A value of volume reserves space on the aggregate for the entire volume. A value of none reserves no space on the aggregate, meaning that writes can fail if the aggregate runs out of space. The default setting is inherited from the parent volume.
[-comment <text>] - Comment
This optionally specifies a comment for the FlexClone volume.
[-foreground {true|false}] - Foreground Process
This optionally specifies whether the FlexClone volume create operation runs as a foreground process. The default setting is true (that is, the operation runs in the foreground).
{ [-qos-policy-group <text>] - QoS Policy Group Name
This parameter optionally specifies which QoS policy group to apply to the FlexClone volume. The policy group defines measurable service level objectives (SLOs) that apply to the storage objects with which the policy group is associated. If you do not assign a policy group to the FlexClone volume, the system does not monitor and control the traffic to the volume.
| [-qos-adaptive-policy-group <text>]} - QoS Adaptive Policy Group Name
This optionally specifies which QoS adaptive policy group to apply to the volume. This policy group defines measurable service level objectives (SLOs) and Service Level Agreements (SLAs) that adjust based on the volume allocated space or used space. This parameter is not supported on FlexGroups.
[-caching-policy <text>] - Caching Policy Name
This optionally specifies the caching policy to apply to the volume. A caching policy defines how the system caches this volume's data in Flash Cache modules. If a caching policy is not assigned to this volume, the system uses the caching policy that is assigned to the containing Vserver. If a caching policy is not assigned to the containing Vserver, the system uses the default cluster-wide policy. The available caching policies are:
  • none - Does not cache any user data or metadata blocks.
  • auto - Read caches all metadata and randomly read user data blocks, and write caches all randomly overwritten user data blocks.
  • meta - Read caches only metadata blocks.
  • random_read - Read caches all metadata and randomly read user data blocks.
  • random_read_write - Read caches all metadata, randomly read and randomly written user data blocks.
  • all_read - Read caches all metadata, randomly read, and sequentially read user data blocks.
  • all_read_random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data.
  • all - Read caches all data blocks read and written. It does not do any write caching.
  • noread-random_write - Write caches all randomly overwritten user data blocks. It does not do any read caching.
  • meta-random_write - Read caches all metadata and write caches randomly overwritten user data blocks.
  • random_read_write-random_write - Read caches all metadata, randomly read and randomly written user data blocks. It also write caches randomly overwritten user data blocks.
  • all_read-random_write - Read caches all metadata, randomly read, and sequentially read user data blocks. It also write caches randomly overwritten user data blocks.
  • all_read_random_write-random_write - Read caches all metadata, randomly read, sequentially read and randomly written user data. It also write caches randomly overwritten user data blocks.
  • all-random_write - Read caches all data blocks read and written. It also write caches randomly overwritten user data blocks.
Note that in a caching-policy name, a hyphen (-) separates read and write policies. Default caching-policy is auto.
[-vserver-dr-protection {protected|unprotected}] - Vserver DR Protection
This optionally specifies whether the volume should be protected by Vserver level SnapMirror. This parameter is applicable only if the Vserver is the source of a Vserver level SnapMirror relationship. By default the clone volume will inherit this value from the parent volume.
[-uid <integer>] - Volume-Level UID
This parameter optionally specifies a volume-level user ID (UID). All files and directories in a FlexClone volume will inherit this UID.
[-gid <integer>] - Volume-Level GID
This parameter optionally specifies a volume-level group ID (GID). All files and directories in a FlexClone volume will inherit this GID.

Examples