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

PDF

User-Defined Parameters

Parameters for the create snapshotVirtualDisk command enable you to define the snapshot virtual disk to suit the requirements of your storage array. The following table lists the parameters and descriptions of Snapshot Virtual Disk.

Table 1. Snapshot Virtual Disk Parameters
Parameter	Description
`physicalDiskType`	Specifies the type of physical disk to use for the snapshot repository virtual disk. The type must be specified as Serial Attached SCSI (SAS). This parameter works only with the count-based repository method of defining a snapshot virtual disk.
`repositoryDiskGroup`	Specifies the disk group in which to build the snapshot virtual disk. Default builds the snapshot repository virtual disk in the same disk group as the source virtual disk.
`freeCapacityArea`	Specifies the amount of storage space to use for the snapshot repository virtual disk. Free storage space is defined in units of bytes, kilobytes, megabytes, or gigabytes.
`userLabel`	Specifies the name to give to the snapshot virtual disk. If you do not choose a name for the snapshot virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the source virtual disk name is Mars_Spirit_4 and it does not have a snapshot virtual disk, the default snapshot virtual disk name is Mars_Spirit_4‑1. If the source virtual disk already has n – 1 number of snapshot virtual disks, the default name is Mars_Spirit_4‑n.
`repositoryUserLabel`	Specifies the name to give to the snapshot repository virtual disk. If you do not choose a name for the snapshot repository virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the source virtual disk name is Mars_Spirit_4 and it does not have an associated snapshot repository virtual disk, the default snapshot repository virtual disk name is Mars_Spirit_4‑R1. If the source virtual disk already has n – 1 number of snapshot repository virtual disks, the default name is Mars_Spirit_4‑Rn.
`warningThresholdPercent`	Specifies how full to allow the snapshot repository virtual disk to get before sending a warning that the snapshot repository virtual disk is close to capacity. The warning value is a percentage of the total capacity of the snapshot repository virtual disk. The default value is 50, which represents 50 percent of total capacity. (Change this value using the `set snapshotVirtualDisk` command.)
`repositoryPercentOfSource`	Specifies the size of the snapshot repository virtual disk as a percentage of the source virtual disk size. The default value is 20, which represents 20 percent of the source virtual disk size.
`repositoryFullPolicy`	Specifies how snapshot processing continues if the snapshot repository virtual disk is full. You can choose to fail writes to the source virtual disk ( `failSourceWrites`) or fail writes to the snapshot virtual disk ( `failSnapShot`). The default value is `failSnapShot`.
`enableSchedule`	Turns on or off the ability to schedule a snapshot operation. To turn on snapshot scheduling, set the parameter to `TRUE`. To turn off snapshot scheduling, set the parameter to `FALSE`. Schedules a snapshot operation of the following type: `immediate` `startDate` `scheduleDay` `startTime` `scheduleInterval` `endDate` `noEndDate` `timesPerDay` `timeZone`

The following example of the create sourceVirtualDisk command includes user‑defined parameters:

client>smcli 123.45.67.89 -c "create
                                 snapshotVirtualDisk sourceVirtualDisk=
                                 \"Mars_Spirit_4\" repositoryRAIDLevel=5
                                 repositoryPhysicalDiskCount=5 physicalDiskType=
                                 SAS userLabel=\"Mars_Spirit_4_snap1\"
                                 repositoryUserLabel=\"Mars_Spirit_4_rep1\"
                                 warningThresholdPercent=75
                                 repositoryPercentOfSource=40
                                 repositoryFullPolicy=
                                 failSnapShot;"enableSchedule=TRUE schedule=
                                 (immediate | snapshotSchedule)]

The following example is the script file version of the command:

create snapshotVirtualDisk sourceVirtualDisk=
                                 "Mars_Spirit_4" repositoryRAIDLevel=5
                                 repositoryPhysicalDiskCount=5 physicalDiskType=
                                 SAS userLabel="Mars_Spirit_4_snap1"
                                 repositoryUserLabel="Mars_Spirit_4_rep1"
                                 warningThresholdPercent=75
                                 repositoryPercentOfSource=40
                                 repositoryFullPolicy=failSnapShot;

NOTE: In the previous examples, the names for the snapshot virtual disk and repository virtual disk are defined by the user. If you do not choose to create names for the snapshot virtual disks or the repository virtual disks, the RAID controller modules provide default names. (See Names Of Snapshot Virtual Disks And Repository Virtual Disks for an explanation of naming conventions.)