Dell PowerVault MD 32XX/36XX Series Storage Arrays CLI Guide

Create Consistency Group Snapshot Virtual Disk

Description

This command creates a snapshot virtual disk of specific images in the base virtual disks in a consistency group. You can select one base virtual disk or more than one base virtual disks from the consistency group to include in the snapshot virtual disk. When you create a snapshot virtual disk of a consistency group, you are creating a virtual disk with contents that you can view.

Syntax With User Specified Base Virtual Disks

create cgSnapVirtualDisk userLabel="
                                 cgVirtualDiskName"
                                 cgSnapImageID="
                                 snapCGID:imageID"
                                 members=(
                                 baseVirtualDisk:repositoryVirtualDisk...baseVirtualDisk:repositoryVirtualDisk)

Syntax When Setting The Consistency Group Snapshot Virtual Disk To Read Only

create cgSnapVirtualDisk userLabel="
                                 cgVirtualDiskName"
                                 cgSnapImageID="
                                 snapCGID:imageID"
                                 readOnly

Syntax When Setting The Repository Full Limit

create cgSnapVirtualDisk userLabel="
                                 cgVirtualDiskName"
                                 cgSnapImageID="
                                 snapCGID:imageID"
                                 repositoryFullLimit=
                                 percentValue

Parameters

Parameter	Description
`userLabel`	The name that you want to give the consistency group snapshot virtual disk that you are creating. Enclose the consistency group snapshot virtual disk name in double quotation marks (" ").
`cgSnapImageID`	The identifier of the snapshot image from the snapshot consistency group that you want to include in the consistency group snapshot virtual disk. Enclose the snapshotImage identifier in double quotation marks (" ").
`members`	The identifier of one base virtual disk or more than one base virtual disks that you want to add. The members identifier is comprised of the base virtual disk name concatenated with the repository virtual disk name. You must use a colon (:) between the two names. Enclose all of the member identifiers in parentheses. If you enter more than one member separated the members with a space. When you do not use the members parameter, all of the members are automatically added to the new consistency group snapshot virtual disk.
`repositoryFullLimit`	The percentage of repository capacity at which the consistency group snapshot repository virtual disk is nearing full. Use integer values. For example, a value of `70` means 70 percent.
`readOnly`	The setting to determine whether you can write to the snapshot virtual disk or only read from the snapshot virtual disk. To write to the snapshot virtual disk, do not include this parameter. To prevent writing to the snapshot virtual disk, include this parameter.

Notes

You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters.

If you do not specify the repositoryVolType or readOnly parameters, the MD storage management software selects the repositories for the consistency group snapshot virtual disk. If the disk group or disk pool where the base virtual disk resides does not have enough space, this command fails.

The create cgSnapVirtualDisk command has unique forms that are explained by these examples:

Creating a read/write consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 that has three members cgm1, cgm2, and cgm3. The repository virtual disks already exist and selected by the user in this command.
```
create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk1" cgSnapImageID="snapCG1:oldest" members=(cgm1:repos_0010 cgm2:repos_0011
                                          cgm3:repos_0007);
                                       
```
Note the use of the colon (:) in the name of the snapshot image to be included in the consistency group snapshot virtual disk. The colon is a delimiter that separates the name of the snapshot virtual disk from a particular snapshot image that you might want to use. You can use one of these options following the colon:
- An integer value that is the actual sequence number of the snapshot image.
- newest - Use this option when you want to show the latest consistency group snapshot image.
- oldest - Use this option when you want to show the earliest snapshot image created.
The use of the colon following the names of the members of the snapshot consistency group acts define the mapping between the member and a repository virtual disk. For example, in cgm1:repos1_10, member cgm1 maps to repository virtual disk repos1_0010.
Creating a read/write consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 of only members cgm1 and cgm2:
```
create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk2" cgSnapImageID="snapCG1:14214" members=(cgm1:repos_1000 cgm2:repos_1001);
```
Creating a read-only consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 that has three memebers cgm1, cgm2, and cgm3:
```
create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageID="snapCG1:oldest" readOnly;
```
Creating a consistency group snapshot virtual disk that has a repository full limit set to 60 percent on a snapshot consistency group named snapCG1 that has three members cgm1, cgm2, and cgm3:
```
create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageID="snapCG1:oldest" repositoryFullLimit=60;
```
Creating a read/write consistency group snapshot virtual disk with automatic repository selection on a snapshot consistency group named snapCG1 that has three memebers cgm1, cgm2, and cgm3:
```
create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk4" cgSnapImageID="snapCG1:oldest";
```

Welcome

Welcome to Dell