Skip to main content

vserver consistency-group volume create

Contributors
Suggest changes
PDFs

Create a new volume in a consistency group

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

Description

The vserver consistency-group volume create command creates new volumes in a consistency group.

Parameters

-vserver <Vserver Name> - Vserver Name

This parameter specifies the Vserver that contains the consistency group in which the volumes will be created.

-consistency-group <text> - Consistency Group

This parameter specifies the consistency group in which the volumes will be created.

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

This parameter specifies the parent of the consistency group in which the volumes will be created.

-volume <volume name> - Volume

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

-size {<integer>[KB|MB|GB|TB|PB]} - 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.

[-volume-count <integer>] - Number of volumes

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

{ [-export-policy <export policy name>] - Volume Export Policy

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

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

This parameter specifies the junction path for mounting the volumes.

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

This parameter specifies the NAS gid.

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

This parameter specifies the NAS junction parent volume.

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

This parameter specifies the NAS security style.

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

This parameter specifies the NAS UID.

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

This parameter specifies the NAS UNIX permissions.

[-cifs-shares <Share>,…​] - Volume CIFS Share Names

This parameter specifies the name of the CIFS share to be created.

[-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 UNIXID

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.

| [-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

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

[-lun-os-type <LUN Operating System Format>] - OS 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

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

[-namespace-os-type {aix|linux|vmware|windows}] - OS Type

This parameter specifies the OS type for the new namespaces.

[-subsystem <text>] - Subsytem Name }

This parameter specifies the name of the nvme subsystem.

Examples

+ The following command creates 2 new volumes in consistency group singleCG.
cluster1::> vserver consistency-group volume create -vserver vs0 -consistency-group singleCG -parent-consistency-group - -volume vol_singleCG -size 20M -volume-count 2
          (vserver consistency-group volume create)
        [Job 100] Job succeeded: Success
+ The following command creates 2 new volumes in consistency group singleCG with 2 new LUNs in each volume.
cluster1::> vserver consistency-group volume create -vserver vs0 -consistency-group singleCG -parent-consistency-group - -volume vol -size 20M -volume-count 2 -lun lun -lun-count 2 -lun-os-type linux -igroup ig1
          (vserver consistency-group volume create)
        [Job 101] Job succeeded: Success
+ The following command creates 2 new volumes in consistency group singleCG with 2 new nvme namespaces in each volume.
cluster1::> vserver consistency-group volume create -vserver vs0 -consistency-group singleCG -parent-consistency-group - -volume vol -size 20M -volume-count 2 -namespace ns -namespace-count 2 -namespace-os-type linux -subsystem ss1
          (vserver consistency-group volume create)
        [Job 102] Job succeeded: Success
+ The following command creates a new volume in consistency group singleCG with CIFS share along with acl properties.
cluster1::> vserver consistency-group volume create -vserver vs0 -consistency-group singleCG -parent-consistency-group - -volume vol_singleCG -size 20M -volume-count 2 -cifs-shares share1 -cifs-share-acl-type windows -cifs-share-acl-user-or-group Everyone -cifs-share-acl-permission Read -nas-path "/vol"
          (vserver consistency-group volume create)
        [Job 103] Job succeeded: Success