Skip to main content

vserver consistency-group clone create

Contributors
Suggest changes
PDFs

Create a consistency group clone

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

Description

The vserver consistency-group clone create command creates a clone of a specified consistency group. It also takes in an optional parameter source-snapshot-name to use for creating the clone. Only parent consistency groups support cloning.

Parameters

-vserver <Vserver Name> - Vserver Name

This parameter specifies the Vserver that contains the consistency group whose clone is to be created.

-clone-consistency-group <text> - Consistency Group Name of the Clone

This parameter specifies the name of the clone consistency group.

-source-parent-consistency-group <text> - Parent Consistency Group Name of the Source

This parameter specifies the name of the consistency group to clone from or its parent consistency if cloning a child consistency group.

[-source-snapshot-name <snapshot name>] - Snapshot of the Source Consistency Group

This parameter optionally specifies the snapshot of the source parent consistency group to be used for creating the clone.

[-space-guarantee {none|volume}] - Space Guarantee Style

This parameter optionally specifies the space guarantee style for the FlexClone volumes in the clone consistency group. 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 in the source parent consistency group.

[-split-after-clone <true>] - Split clone Volumes

This parameter optionally specifies if the FlexClone volumes within the clone consistency group would be split from their parent volume in the source parent consistency group after the FlexClone volume is created.

[-clone-volume-prefix <text>] - Clone Volume Name Prefix

This parameter specifies an optional volume name prefix for cloned volumes in the clone consistency group.

[-clone-volume-suffix <text>] - Clone Volume Name Suffix

This parameter specifies an optional volume name suffix for cloned volumes in the clone consistency group.

Examples

The following example creates a clone clone1 of the source parent consistency group container1 on Vserver vs0. The space guarantee of the cloned volumes under the clone consistency group is volume and the volume names have a prefix clone1 and suffix of clone1end. The cloned volumes have split initiated as True to split the clones from the parent volumes.

cluster1::> vserver consistency-group clone create -vserver vs0 -clone-consistency-group clone1 -source-parent-consistency-group container1 -space-guarantee volume -clone-volume-prefix clone1 -clone-volume-suffix clone1end -split-after-clone true -snaplock-type enterprise
        (vserver consistency-group clone create)
    [Job 264] Job succeeded: Success
+ The following example creates a clone clone_child_1 of the source child consistency group child_1 in parent consistency group parentcg on Vserver vs0.
cluster1::> vserver consistency-group clone create -vserver vs0 -clone-child-consistency-group clone_child_1 -source-parent-consistency-group parentcg
        (vserver consistency-group clone create)
    [Job 264] Job succeeded: Success

The following example creates a clone clone1 of the source parent consistency group container1 on Vserver vs0. The storage unit names have a prefix pre_clone and suffix of clone_end. The cloned consistency group will have SnapLock type to be enterprise.

cluster1::> vserver consistency-group clone create -vserver vs0 -clone-consistency-group clone1 -source-parent-consistency-group container1 -clone-storage-unit-prefix pre_clone -clone-storage-unit-suffix clone_end -snaplock-type enterprise
        (vserver consistency-group clone create)
    [Job 264] Job succeeded: Success