Skip to main content

Clone an ONTAP consistency group

Contributors netapp-ahibbard netapp-aaron-holt netapp-lenida netapp-aherbin
PDFs

Beginning with ONTAP 9.12.1, you can clone a consistency group to create a copy of a consistency group and its contents. Cloning a consistency group creates a copy of the consistency group configuration, its metadata such as application type, and all the volumes and its contents such as files, directories, LUNs or NVMe namespaces.

About this task

When cloning a consistency group, you can clone it with its current configuration, but with volume contents as they are or based on an existing consistency group snapshot.

Cloning a consistency group is supported only for the entire consistency group. You cannot clone an individual child consistency group in a hierarchical relationship: only the complete consistency group configuration can be cloned.

When you clone a consistency group, the following components are not cloned:

  • iGroups

  • LUN maps

  • NVMe subsystems

  • NVMe namespace subsystem maps

Before you begin

  • When you clone a consistency group, ONTAP will not create SMB shares for the cloned volumes if a share name is not specified. * Cloned consistency groups are not mounted if a junction path is not specified.

  • If you attempt to clone a consistency group based on a snapshot that does not reflect the consistency group's current constituent volumes, the operation will fail.

  • After you clone a consistency group, you need to perform the appropriate mapping operation.

    Refer to Map igroups to multiple LUNs or Map an NVMe namespace to a subsystem for more information.

  • Cloning a consistency group is not supported for a consistency group in a SnapMirror active sync relationship or with any associated DP volumes.

System Manager
Steps

  1. Select Storage > Consistency groups.

  2. Select the consistency group you want to clone from the Consistency Group menu.

  3. At the top right of the overview page for the consistency group, select Clone.

  4. Enter a name for the new, cloned consistency group or accept the default name.

    1. Choose if you want to enable Thin Provisioning.

    2. Choose Split Clone if you want to dissociate the consistency group from its source and allocate additional disk space for the cloned consistency group.

  5. To clone the consistency group in its current state, choose Add a new Snapshot.

    To clone the consistency group based on a snapshot, choose Use an existing snapshot. Selecting this option will open a new sub-menu. Choose the snapshot that you want to use as the basis for the clone operation.

  6. Select Clone.

  7. Return to the Consistency Group menu to confirm your consistency group has been cloned.

CLI

Beginning with ONTAP 9.14.1, you can clone a consistency group using the CLI with cluster admin credentials.

Before you begin

  • You must be at the admin privilege level to perform this task.

  • Beginning with ONTAP 9.15.1, any user at the admin privilege level can perform this task. In ONTAP 9.14.1, you must be a cluster or SVM administrator to perform this task.

Clone a consistency group

  1. The consistency-group clone create command clones the consistency group at its current point-in-time status. To base the clone operation on a snapshot, include the -source-snapshot parameter.

    consistency-group clone create -vserver svm_name -consistency-group clone_name -source-consistency-group consistency_group_name [-source-snapshot snapshot_name]

    Learn more about consistency-group clone create in the ONTAP command reference.

Next steps