Skip to main content

vserver consistency-group create

Contributors
Suggest changes

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.

{ [-lun <text>] - LUN Name

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.

| [-namespace <text>] - Namespace Name

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
+ The following command creates a new consistency group singlecg with existing volumes vol1 and vol2.
cluster1::> vserver consistency-group create -consistency-group singlecg -volumes vol1,vol2
        (vserver consistency-group create)
    [Job 33] Job succeeded: Success
+ The following command creates a new consistency group singlecg with two new volumes each of size 1gb and volume name prefix with db_vols.
cluster1::> vserver consistency-group create -consistency-group singlecg -volume-prefix db_vols -volume-count 2 -size 1gb
        (vserver consistency-group create)
    [Job 34] Job succeeded: Success
+ The following command creates a new consistency group singlecg2 with two new volumes each of size 1gb and volume name prefix with db_vols and a snapshot policy of default and application-type mongodb.
cluster1::> vserver consistency-group create -consistency-group singlecg -volume-prefix db_vols -volume-count 2 -size 1gb -snapshot-policy default -application-type mongodb
        (vserver consistency-group create)
    [Job 35] Job succeeded: Success
+ The following command creates a new consistency group child1 under existing parent consistency group parent1 and create two new volumes each of size 1gb.
cluster1::> vserver consistency-group create -consistency-group child1 -parent-consistency-group parent1 -volume-count 2 -size 1gb
        (vserver consistency-group create)
    [Job 36] Job succeeded: Success
+ The following command creates a new consistency group child2 under existing parent consistency group parent2 and creates two new volumes each of size 1gb and volume name prefix with child2_volumes.
cluster1::> vserver consistency-group create -consistency-group child2 -parent-consistency-group parent2 -volume-prefix child2_volumes -volume-count 2 -size 1gb
        (vserver consistency-group create)
    [Job 37] Job succeeded: Success
+ The following command creates a new consistency group child3 under existing parent consistency group parent2 and creates two new volumes vol1 and vol2 each of size 1gb.
cluster1::> vserver consistency-group create -consistency-group child3 -parent-consistency-group parent2 -volumes vol1,vol2 -size 1gb
        (vserver consistency-group create)
    [Job 38] Job succeeded: Success
+ The following command creates a new consistency group singlecg with two new volumes each of size 1gb and volume name prefix with db_vols and CIFS share share1 and ACL properties.
cluster1::> vserver consistency-group create -consistency-group singlecg -volume-prefix db_vols -volume-count 2 -size 1gb -cifs-share share1 -cifs-share-acl-type windows -cifs-share-acl-user-or-group Everyone -cifs-share-acl-permission Read -nas-path "/vol"
        (vserver consistency-group create)
    [Job 39] Job succeeded: Success