Skip to main content
ONTAP commands

vserver consistency-group create

Suggest changes
PDFs

Create a new consistency group

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

Description

The vserver consistency-group create command can be used to create a consistency group using existing consistency groups or volumes, or by creating new volumes.

Parameters

-vserver <Vserver Name> - Vserver Name

This parameter specifies the Vserver in which the consistency group is to be created.

-consistency-group <text> - Consistency Group Name

This parameter specifies the name of the consistency group which is to be created.

[-parent-consistency-group <text>] - Parent Consistency Group Name

This parameter specifies the name of the existing parent consistency group in which the consistency group is to be created. If the parent consistency group does not exist, it will be created.

[-storage-service <text>] - Storage Service

This parameter specifies the storage service name. If not specified, the default value is the most performant for the platform.

[-qos-policy <text>] - QoS Policy Group

This parameter specifies the QoS policy to be applied to the consistency group during creation.

[-tiering-placement-rules <FabricPool Placement Preferences>] - Tiering Placement Rules

This parameter specifies the storage tiering placement rules for the consistency group.

[-tiering-policy <Tiering Policy>] - Tiering Policy

This parameter specifies the tiering policy to be applied to the consistency group during creation.

[-object-stores <text>,…​] - Object Store Name

This parameter specifies the remote object stores to used for placement.

[-snapshot-policy <snapshot policy>] - Snapshot Copy Policy

This parameter specifies the snapshot policy to be applied to the consistency group during creation.

{ [-application-type <Application type for the parent or top level CG>] - Application Type

This parameter specifies the application type for the parent consistency group.

| [-application-component-type <Application component type for child CG>] - Application Component Type }

This parameter specifies the application component type of the child consistency group.

{ [-consistency-groups <text>,…​] - Consistency Groups

This parameter optionally specifies a comma separated list of existing consistency groups under the Vserver.

| [-volumes <text>] - Volume Names

This parameter specifies a filter to choose any existing volumes in the Vserver to add to the new consistency group.

| [-volume-prefix <volume name>] - Volume Name Prefix

This parameter specifies a volume prefix to be added to the volume name for new volumes created in the new consistency group.

[-volume-count <integer>] - Number of Volumes to Create }

This parameter specifies the number of new volumes to be created in the new consistency group.

[-size {<integer>[KB|MB|GB|TB|PB]}] - Provisioned Size

This parameter specifies the size of each new volume that is to be created in the consistency group. If -lun or -namespace parameter is specified, this refers to the size of each LUN or namespace.

{ [-luns <text>] - Existing LUN Names

This parameter specifies a filter to choose any existing LUNs in the Vserver to add to the new consistency group.

[-lun-prefix <text>] - LUN Name Prefix

This parameter specifies the name of the LUN to be created in the consistency group. If the -lun-count parameter is specified this field is treated as prefix.

[-lun-count <integer>] - Number of LUNs to Create

This parameter specifies the number of new LUNs to be created in the consistency group.

[-lun-os-type <LUN Operating System Format>] - LUN Operating System Type

This parameter specifies the OS type for the new LUNs.

[-igroup <text>] - iGroup Name

This parameter specifies the name of the initiator group.

| [-namespaces <text>] - Existing Namespace Names

This parameter specifies a filter to choose any existing namespaces in the Vserver to add to the new consistency group.

[-namespace-prefix <text>] - Namespace Name Prefix

This parameter specifies the name of the namespace to be created in the consistency group. If the -namespace-count parameter is specified this field is treated as prefix.

[-namespace-count <integer>] - Number of Namespaces to Create

This parameter specifies the number of new namespaces to be created in the consistency group.

[-namespace-os-type {aix|linux|vmware|windows}] - NVME Operating System Type

This parameter specifies the OS type for the new namespaces.

[-subsystem <text>] - Subsystem Name

This parameter specifies the name of the nvme subsystem.

| [-export-policy <text>] - Export Policy Name

This parameter specifies the name of the export policy to be associated with the newly created volumes.

[-nas-gid <integer>] - NAS Group ID

This parameter specifies the UNIX group ID of the newly created volumes.

[-nas-path <text>] - Junction Path

This parameter specifies the mount path for the newly created volumes.

[-nas-junction-parent-volume <volume name>] - Junction Parent Volume Name

This parameter specifies the name of the parent volume that contains the junction inode of this volume.

[-nas-security-style <security style>] - NAS Security Style

This parameter specifies the security style associated with the newly created volumes.

[-nas-uid <integer>] - NAS User ID

This parameter specifies the UNIX user ID of the newly created volumes.

[-nas-unix-permissions <unix perm>] - NAS UNIX Permissions

This parameter specifies the UNIX permissions for the newly created volumes.

[-cifs-share <Share>] - Volume CIFS Share Name

This parameter specifies the name of the CIFS share for each volume in the new consistency group.

[-cifs-share-acl-user-or-group <text>] - CIFS User/Group Name

This parameter specifies the ACL user or group of the CIFS share for each volume in the new consistency group.

[-cifs-share-acl-win-unix-id <text>] - Windows SID or UNIX ID

This parameter specifies the ACL windows or unix id of the CIFS share for each volume in the new consistency group.

[-cifs-share-acl-type {windows|unix-user|unix-group}] - CIFS User or Group Type

This parameter specifies the ACL type of the CIFS share for each volume in the new consistency group.

[-cifs-share-acl-permission <access rights>] - CIFS Access Type }

This parameter specifies the ACL permission of the CIFS share for each volume in the new consistency group.

Examples

+ The following command creates a new parent consistency group parentcg with existing consistency groups cg1 and cg2.
cluster1::> vserver consistency-group create -consistency-group parentcg -consistency-groups cg1,cg2
        (vserver consistency-group create)
    [Job 32] Job succeeded: Success