Skip to main content
Sign Out

Welcome to Dell

My Account
  • Place orders quickly and easily
  • View orders and track your shipping status
  • Create and access a list of your products
  • Manage your Dell EMC sites, products, and product-level contacts using Company Administration.
Sign In Create an Account Premier Sign In Partner Program Sign In
Contact Us

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

PDF

Set Snapshot (Legacy) Virtual Disk

Description

This command defines the properties for a snapshot virtual disk and lets you rename a snapshot virtual disk.

Syntax

set (virtualDisk [
                                 virtualDiskName] |
                                 virtualDisks [
                                 virtualDiskName1 ...
                                    virtualDiskNameN
                                 ])
                                 userLabel=”
                                 snapshotVirtualDiskName”
                                 warningThresholdPercent=
                                 percentValue
                                 repositoryFullPolicy=(failSourceWrites |
                                 failSnapshot)
                                 enableSchedule=(TRUE | FALSE) |
                                 schedule=(immediate | 
                                 snapshotSchedule)
                                 rollbackPriority=(0 | 1 | 2 | 3 | 4)

Parameters

Parameter Description
virtualDisk or virtualDisks The name of the specific snapshot virtual disk for which you want to define properties. (You can enter more than one virtual disk name if you use the virtualDisks parameter). Enclose the snapshot virtual disk name in double quotation marks (“ ”) inside of square brackets ([ ]).
userLabel A new name that you want to give to a snapshot virtual disk. Enclose the new snapshot virtual disk name in double quotation marks (“ ”).
warningThresholdPercent The percentage of repository capacity at which you receive a warning that the snapshot repository is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 50.
repositoryFullPolicy How you want snapshot processing to continue 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 snapshot scheduling feature. To turn on snapshot scheduling, set this parameter to TRUE. To turn off snapshot scheduling, set this parameter to FALSE.
schedule Use this parameter to schedule a snapshot operation, with the following options:
  • immediate
  • startDate
  • scheduleDay
  • startTime
  • scheduleInterval
  • endDate
  • noEndDate
  • timesPerDay
  • timeZone
For more information, see Scheduling Snapshots.
rollbackPriority Determines whether system resources must be allocated to the rollback operation at the expense of system performance. A value of 0 indicates that the rollback operation is prioritized over all other host I/O. A value of 4 indicates that the rollback operation must be performed with minimal impact to the host I/O.

Notes

When you use this command, you can specify one or more of the optional parameters. You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters.

You can set the warningThresholdPercent parameter and the repositoryFullPolicy parameter for both the snapshot repository virtual disk or the snapshot virtual disk.

Scheduling Snapshots (Legacy)

You can use the enableSchedule and the schedule parameters to create snapshots for a snapshot group. Automatic snapshots can be scheduled daily, weekly, or monthly (by day or by date). The enableSchedule parameter turns on or off the ability to schedule snapshots. When you enable scheduling, you use the schedule parameter to define when you want the snapshots to occur.

Parameters

Parameter Description
immediate Begins a snapshot operation immediately; a snapshot virtual disk is created and a copy-on-write operation begins.
startDate Defines a specific start date snapshot virtual disk creation. The format for this option is MM:DD:YY. If no start date is provided, the current date is used. For example: startDate=06:27:11.
scheduleDay Defines a day of the week you want to create a snapshot virtual disk and perform a copy-on-write operation. The values that you can enter are: monday, tuesday, wednesday, thursday, friday, saturday, sunday, and all. For example: scheduleDay=wednesday.
startTime Defines time of a day you want to create a snapshot virtual disk and start performing a copy-on-write operation. The format for entering the time is HH:MM, where HH is the hour and MM is the minute past the hour. Use a 24-hour clock. For example: startTime=14:27, which corresponds to 2:27 PM.
scheduleInterval Amount of time, in minutes that defines a minimum between two copy-on-write operations. It is possible for you to create a schedule in which you have overlapping copy-on-write operations because of the duration of a copy operation. You can ensure that copy-on-write operations maintain a correct interval by using this option. The maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180.
endDate Specific date to stop creating a snapshot virtual disk and end the copy-on-write operations. The format is MM:DD:YY, where MM is the month, DD the day and YY the year. For example: endDate=11:26:11.
noEndDate Use this option to prevent a scheduled copy-on-write operation from ending. If you later decide to end the copy-on-write operations, you must re-enter the create snapshotVirtualDisk command and specify an end date.
timesPerDay Number of times you want the snapshot schedule to run in a day. For example, timesPerDay=4.
timeZone Specifies the time zone to use for the scheduling operations, using one of the following values:
  • GMT±HH:MM—The offset from Greenwich Mean Time (GMT), in hours and minutes. For example, GMT-06:00 must be used to specify Central Standard Time (CST).
  • Text string—A standard time zone text string, in quotation marks. For example, "USA/Chicago" or "Germany/Berlin". Time zone text strings are case sensitive. If you enter an incorrect text string, the default time zone is GMT.
Examples of code string for defining a schedule: 
enableSchedule=true schedule startTime=14:27
                                    
                                    enableSchedule=true schedule scheduleInterval=180
                                    
                                    enableSchedule=true schedule timeZone=GMT-06:00
                                    
                                    enableSchedule=true schedule timeZone="USA/Chicago"
  • NOTE: If you also use the scheduleInterval option, the firmware chooses between the timesPerDay option and the scheduleInterval option by selecting the lowest value of the two options. The firmware calculates an integer value for the scheduleInterval option by dividing 1440 by the scheduleInterval option value that you set. For example, 1440/180 = 8. The firmware then compares the timesPerDay integer value with the calculated scheduleInterval integer value and uses the smaller value.
  • NOTE: To remove a schedule, use the delete virtualDisk command with the schedule parameter. The delete virtualDisk command with the schedule parameter deletes only the schedule, not the snapshot virtual disk.

Rate this content

Accurate
Useful
Easy to understand
Was this article helpful?
0/3000 characters
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please provide ratings (1-5 stars).
  Please select whether the article was helpful or not.
  Comments cannot contain these special characters: <>()\