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

Set Virtual Disk

Description

This command defines the properties for a virtual disk. You can use most of the parameters to define properties for one or more virtual disks, however, some of the parameters define properties for only one virtual disk at a time. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk. The syntax for virtual disk mapping is listed separately.

Syntax Applicable To One Or More Virtual Disks

set (allVirtualDisks | virtualDisk
                                 [“
                                 virtualDiskName”] |
                                 virtualDisks [“
                                 virtualDiskName1” ...
                                    “virtualDiskNameN
                                 ”] |
                                 virtualDisk <
                                 wwID>)
                                 cacheFlushModifier=
                                 cacheFlushModifierValue
                                 cacheWithoutBatteryEnabled=(TRUE | FALSE)\
                                 mediaScanEnabled=(TRUE | FALSE)
                                 mirrorCacheEnabled=(TRUE | FALSE)
                                 modificationPriority=(highest | high | medium |
                                 low | lowest) owner=(0 | 1)
                                 readCacheEnabled=(TRUE | FALSE)
                                 writeCacheEnabled=(TRUE | FALSE)
                                 cacheReadPrefetch=(TRUE | FALSE)

CAUTION: Enabling Write Cache on a virtual disk generally improves performance for applications with significant Write content (unless the application features a continuous string of Writes. However, Write Cache does introduce some risk of data loss in the unlikely event of a RAID controller module failure.

Syntax Applicable To Only One Virtual Disk

set (virtualDisk [“virtualDiskName”] | virtualDisk <
                                 wwID>)
                                 addCapacity=
                                 virtualDiskCapacity
                                 [addPhysicalDisks=(
                                 enclosureID1,slotID1
                                    enclosureID2,slotID2 ... enclosureIDn,slotIDn
                                 )]
                                 consistencyCheckEnabled=(TRUE | FALSE)
                                 segmentSize=
                                 segmentSizeValue
                                 userLabel=
                                 virtualDiskName
                                 preReadRedundancyCheck=(TRUE | FALSE)

Syntax Applicable To Virtual Disk Mapping

set (virtualDisk [“
                                 virtualDiskName”] | virtualDisk <
                                 wwID>)
                                 accessVirtualDisk)
                                 logicalUnitNumber=
                                 LUN
                                 (host=”
                                 hostName” | hostGroup=(“
                                 hostGroupName” |
                                 defaultGroup)

Parameters

Parameter	Description
`allVirtualDisks`	Specifies the properties for all virtual disks in the storage array.
`virtualDisk or virtualDisks (name)`	Specifies the name of the virtual disk for which to define properties. You can enter more than one virtual disk name if you use the `virtualDisks` parameter. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets.
`virtualDisk`	Specifies the WWID of the virtual disk for which you are setting properties. You can use the WWID instead of the virtual disk name to identify the virtual disk. You must put angle brackets (< >) around the WWID. NOTE: When running this command, do not use colon separators in the WWID.
`cacheFlushModifier`	The maximum amount of time that data for the virtual disk stays in cache before the data is flushed to physical storage. Valid values are listed in the Notes section.
`cacheWithoutBatteryEnabled`	The setting to turn on or turn off caching without batteries. To turn on caching without batteries, set this parameter to `TRUE`. To turn off caching without batteries, set this parameter to `FALSE`.
`mediaScanEnabled`	The setting to turn on or turn off media scan for the virtual disk. To turn on media scan, set this parameter to `TRUE`. To turn off media scan, set this parameter to `FALSE`. (If media scan is disabled at the storage array level, this parameter has no effect.)
`mirrorCacheEnabled`	The setting to turn on or turn off the replication cache. To turn on the replication cache, set this parameter to `TRUE`. To turn off the replication cache, set this parameter to `FALSE`.
`modificationPriority`	The priority for virtual disk modifications while the storage array is operational. Valid values are `highest`, `high`, `medium`, `low`, or `lowest`.
`owner`	The RAID controller module that owns the virtual disk. Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1. Use this parameter only if you want to change the virtual disk owner.
`readCacheEnabled`	The setting to turn on or turn off the read cache. To turn on the read cache, set this parameter to `TRUE`. To turn off the read cache, set this parameter to `FALSE`.
`writeCacheEnabled`	The setting to turn on or turn off the write cache. To turn on the write cache, set this parameter to `TRUE`. To turn off the write cache, set this parameter to `FALSE`.
`cacheReadPrefetch`	The setting to turn on or turn off cache read prefetch. To turn off cache read prefetch, set this parameter to `FALSE`. To turn on cache read prefetch, set this parameter to `TRUE`.
`addCapacity`	The setting to increase the storage size (capacity) of the virtual disk for which you are defining properties. Size is defined in units of bytes, `KB`, `MB`, `GB`, or `TB`. The default value is `bytes`. NOTE: A space must be added between the last digit and the size (bytes, KB, MB, or GB) for values greater than `9`.
`addPhysicalDisks`	Adds new physical disks to the virtual disk. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk. Enclosure ID values are `0` to `99`. Slot ID values are `0` to `31`. You must put brackets ([ ]) around the enclosure ID values and the slot ID values. Use with the `addCapacity` parameter if you must specify additional physical disks to accommodate the new size.
`consistencyCheckEnabled`	Turns consistency checking during a media scan on or off. To turn consistency checking on, set to `TRUE`. To turn consistency checking off, set to `FALSE`.
`segmentSize`	Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are `8`, `16`, `32`, `64`, `128`, `256`, or `512`. For information about the `segmentSize` parameter, see Using The Auto Configure Command.
`userLabel`	Specifies the new name to give an existing virtual disk. You must put quotation marks (" ") around the new virtual disk name.
`preReadRedundancyCheck`	The setting to check the consistency of RAID redundancy data on the stripes during read operations. Do not use this operation for nonredundant virtual disks, for example RAID Level 0. To check redundancy consistency, set this parameter to `TRUE`. For no stripe checking, set this parameter to `FALSE`.
`accessVirtualDisk`	Specifies the logical unit number for the access virtual disk. The logical unit number is the only property that you can set for the access virtual disk. NOTE: If you specify the `accessVirtualDisk` parameter, the only property that you can set is the `logicalUnitNumber`.
`logicalUnitNumber`	Defines specific virtual disk-to-LUN mappings to an individual host or assigns the host to a host group.
`host`	Specifies the name of the host to which the virtual disk is mapped. You must put quotation marks (" ") around the host name.
`hostGroup`	Specifies the name of the host group to which the virtual disk is mapped. You must put quotation marks (" ") around the host group name.

NOTE: When using this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters.

NOTE: You can apply the addCapacity, segmentSize, userLabel, and logicalUnitNumber parameters to only one virtual disk at a time.

NOTE: Setting the addCapacity, addPhysicalDisks, or segmentSize parameter starts a long-running operation that you cannot stop. These long-running operations are performed in the background and do not prevent you from running other commands. To display the progress of long-running operations, use the show virtualDisk actionProgress command.

Benvenuto

Benvenuto in Dell