Dell PowerVault Modular Disk Storage ArraysCLI Guide
Establish Remote Replicated Pair...
The activate storageArray feature=remoteReplication command provides three methods for defining the physical disks for your replication repository vir
This example shows how to use the command in a script file:activate storageArray feature=remoteReplicationrepositoryDiskGroup=2 freeCapacityArea=2;Act
The command takes this form:create remoteReplication primary=“primaryVirtualDiskName”secondary=“secondaryVirtualDiskName”(remoteStorageArrayName=“stor
This example shows how to use the set remoteReplication command:c:\...\smX\client>smcli 123.45.67.88 123.45.67.89-c “set remoteReplication localVir
This example shows how to use the command in a script file:resume remoteReplication virtualDisk Jan_04_AccountwriteConsistency=false;Removing A Replic
Interaction With Other Premium FeaturesYou can run the Remote Replication (legacy) premium feature while running these premium features:• Snapshot—bot
Storage PartitioningStorage partitioning enables hosts to share access to virtual disks in a storage array. You create a storage partition when you de
9Maintaining A Storage ArrayMaintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all ho
Consistency mismatchesConsistency errors are found, and a media error is forced on the block stripe so that it is found when the physical disk is scan
... virtualDiskNameN] | virtualDisk <wwid>consistencyCheckEnabled=TRUEOnce you have enabled both media scan and consistency check, use the check
Save RAID Controller Module NVSRAM...251Sa
To clear persistent virtual disk reservations, run the following command:clear (allVirtualDisks |virtualDisk[virtualDiskName] | virtualDisks[virtualDi
Type of Information DescriptionCurrent KB/second Current transfer rate in kilobytes per second (current means the number of kilobytes per second since
Defragmenting A Disk GroupWhen you defragment a disk group, you consolidate the free capacity in the disk group into one contiguous area. Defragmentat
The ssdCacheName parameter names the cache group. Setting the updateExistingVirtualDisks parameter to TRUE enables SSD caching for all virtual disks i
The following additional SSD cache-related commands are available in this document:• Change SSD Cache Application Type• Blink SSD Cache• Rename SSD Ca
The test results contain a generic, overall status message and a set of specific test results. Each test result contains the following information:• T
Changing RAID Controller Module OwnershipYou can change which RAID controller module owns a virtual disk by using the set virtualDisk command. The fol
where, virtualDiskName is the identifier for the virtual disk.NOTE: Initializing a thin virtual disk may take an extremely long time.Redistributing Vi
10Script CommandsCAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operatio
Set Snapshot Virtual Disk Media Scan...2
• You must enter spaces in the commands as they are shown in the command descriptions.• Brackets are used in two ways:– As part of the command syntax–
For Linux, and when used in a script file, the name appears as the following:["Engineering"]When you enter the World Wide Identifier (WWID)
Host Topology CommandsCreate HostCreate Host GroupCreate Host PortCreate iSCSI InitiatorDelete HostDelete Host GroupDelete Host PortDelete iSCSI Initi
Set Physical Disk Hot SpareSet Physical Disk Channel StatusSet Physical Disk StateShow Physical DiskShow Physical Disk Channel StatisticsShow Physical
Create Remote ReplicationCheck Storage Array ConnectivityClear Remote Replication FaultDeactivate Remote ReplicationDeactivate Remote Replication (Leg
Re-Create SnapshotSet Snapshot Virtual DiskStop SnapshotSSD Cache CommandsAdd Physical Disks to SSD CacheChange SSD Cache Application TypeCreate SSD C
Save Storage Array Performance StatisticsSave Storage Array SAS PHY CountsSave Storage Array State CaptureSave Storage Array Support DataSet Storage A
Show Virtual Disk Performance StatisticsShow Virtual Disk ReservationsStart Virtual Disk InitializationVirtual Disk Copy CommandsCreate Virtual Disk C
128
11Commands Listed AlphabeticallyFollowing are the script commands listed alphabetically.Activate Remote Replication FeatureNOTE: This command is used
Show Storage Array DBM Database...338
ParametersParameter DescriptionrepositoryRAIDLevelThe RAID level for the replication repository virtual disk. Valid values are 1, 5, or 6.repositoryPh
Parameter Descriptionexample, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk
Activate Storage Array FirmwareDescriptionThis command activates firmware previously downloaded to the pending configuration area in the RAID controll
ParametersParameter DescriptionconsistencyGroupThe name of the consistency group to which you want to add a new member virtual disk. The new member vi
• You can reuse an existing repository virtual disk if that repository virtual disk is empty and is not related to another member virtual disk. You mi
Parameter DescriptionEnclosure ID values are 0 to 99. Drawer ID values are 0 to 4. Slot ID values are 0 to 31. Enclose the enclosure ID values, the dr
Parameter Description• Use an existing repository virtual disk name.• Create a new repository virtual disk when you run this command.The name of an ex
SyntaxautoConfigure storageArrayphysicalDiskType=(SAS)raidLevel=(0 | 1 | 5 | 6)diskGroupWidth=numberOfPhysicalDisksdiskGroupCount=numberOfDiskGroupsvi
Parameter DescriptionsecurityTypeThe setting to specify the security level when creating the disk groups and all associated virtual disks.• none—The d
ParameterParameter DescriptionssdCacheThe alphanumeric identifier (including - and _) of the SSD cache that you want to locate. Enclose the identifier
Stop Disk Group Blink...
ParametersParameter DescriptionssdCacheThe alphanumeric identifier (including - and _) of the SSD cache for which you want to change the application t
Check Remote Replication Group ConsistencyDescriptionThis command applies to a remote replication group that has underlying repository virtual disks.
virtualDiskCopy target[targetName] repositoryConsistency |localVirtualDisk="localVirtualDiskName"]file="filePath"ParametersParamet
NOTE: Connectivity is tested using all possible channels, and if it is a dual RAID controller module configuration, connectivity is checked from each
ParametersParameter DescriptionvirtualDiskName of the specific virtual disk to check consistency. You must put brackets ([ ]) around the virtual disk
Clear Remote Replication FaultDescriptionThis command clears a remote replication "sticky" fault from one or more remote replication groups
Parameter Descriptionremote replication fault. Enclose the member virtual disk name in square brackets ([ ]). If the virtual disk name has special cha
Parameter DescriptionallThe setting to remove the entire configuration of the storage array, including security and identity information. Removing all
Syntaxclear storageArray eventLogParametersNone.Clear Storage Array Firmware Pending AreaDescriptionThis command deletes a previously downloaded firmw
Clear Virtual Disk ReservationsDescriptionThis command clears persistent virtual disk reservations.Syntaxclear (allVirtualDisks | virtualDisk [virtual
1About The Command Line InterfaceThis guide is intended for system administrators, developers, and engineers who need to use the command line interfac
ParametersParameter DescriptionallVirtualDisksClears unreadable sector information from all of the virtual disks in the storage array.virtualDisk or v
Convert Snapshot (Legacy) Virtual Disk To Snapshot GroupDescriptionThis command migrates a snapshot (legacy) virtual disk to a snapshot group and conv
ParametersParameter DescriptionuserLabelThe name of the new consistency group that you want to create. Enclose the new consistency group name in doubl
NotesA consistency group is a logical entity that enables you to manage in batch form all of the snapshot images that you add to the collection. The c
completed successfully for all of the consistency group members, the operation fails and new snapshot images are not created.Normally, all members of
Parameter DescriptionmembersThe identifier of one base virtual disk or more than one base virtual disks that you want to add. The members identifier i
• Creating a read/write consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 of only members cgm1 and cgm2:create cgS
A host group is an optional topological element that you can define if you want to designate a collection of hosts that share access to the same virtu
Parameter Description• allMedia — Use this option when you want to use all types of physical disk media that are in the expansion enclosure.physicalDi
Parameter Description• capable—The disk group and virtual disks are capable of having security set, but security has not been enabled.• enabled—The di
A CLI command consists of the following elements:• The term SMcli• Storage array identifier• Parameters• Script commandsThe following syntax is the ge
• set storageArray securityKey• start secureErase (physicalDisk | physicalDisks)• enable diskGroup [diskGroupName] securityEnclosure Loss Protection a
ParametersParameter DescriptionphysicalDisksThe physical disks you want to assign to the disk pool. Enclosure ID values are 0 to 99; drawer ID values
Parameter DescriptionphysicalDiskMediaTypeYou must use this parameter when you have more than one type of physical disk media in your storage array.Va
ParametersParameter DescriptionuserLabelThe name that you want to give the host that you are creating. Enclose the host name in double quotation marks
Syntaxcreate hostPort identifier="wwid" userLabel="portLabel" host="hostName"interfaceType=SASParametersParameter Descri
ParametersParameter DescriptioniscsiNameThe default identifier of the iSCSI initiator.userLabelThe name that you want to use for the iSCSI initiator.
Parameter DescriptionNOTE: The physicalDiskCount parameter enables you to choose the number of physical disks to use in the disk group. You do not nee
Parameter DescriptiondrawerLossProtectThe setting to enforce drawer loss protection when you create the replication repository disk group. To enforce
Parameter DescriptionNOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed. Com
Parameter Descriptionbefore writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmen
Table 1. Command Name ConventionsParameter Definitiona|bpipe symbol indicating alternative ("a" or "b")italicized-wordsterminals[.
enclosureLossProtect=(TRUE | FALSE)drawerLossProtect=(TRUE | FALSE)dssPreAllocate=(TRUE | FALSE)securityType=(none | capable | enabled)]ParametersPara
Parameter DescriptionNOTE: If you do not specify a capacity, all physical disk capacity available in the disk group is used. If you do not specify cap
Parameter Description• enabled—The disk group and virtual disks have security enabled.For information about securityType, see Security Type.Create RAI
Parameter Descriptionthe RAID controller module firmware determines the owner.mappingThis parameter enables you to map the virtual disk to a host. If
ParametersParameter DescriptionuserLabelThe name that you want to give to a snapshot virtual disk. Enclose the snapshot virtual disk name in double qu
Create Remote ReplicationNOTE: This command is valid only with Fibre Channel storage arrays.DescriptionThis command creates both the primary virtual d
Parameter DescriptionautoResyncThe settings for automatic resynchronization between the primary virtual disks and the secondary virtual disks of a rem
one entity. You create a remote replication group to define the synchronization settings for all replicated pairs within the group. Each replicated pa
Parameter Descriptionarray must be connected through a proper Fibre Channel fabric or iSCSI interface.remotePasswordThe password for the remote storag
Notes• The Remote Replication premium feature must be enabled and activated on the local and remote storage arrays that will be used for replication a
[-n storage-array-name | -w WWID | -h host-name |-r (host_sa | direct_sa)] [-S]SMcli -d [-w][-i][-s][-v][-S]SMcli -m host-name-or-IP-address -F email-
Parameter DescriptionrepositoryVirtualDiskThe name of the repository virtual disk that contains the snapshot group. Enclose the snapshot repository vi
• 32 MB to support fixed overhead for the snapshot group and for copy-on-write processing.• Capacity for rollback processing, which is 1/5000th of the
NotesYou can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 c
enclosureLossProtect=(TRUE | FALSE)userLabel="snapshotVirtualDiskName"warningThresholdPercent=percentValuerepositoryPercentOfBase=percentVal
Parameter Descriptionrepository virtual disk. Enclose the name of the repository disk group in double quotation marks (" ").userLabelThe nam
Parameter DescriptionwarningThresholdPercentThe percentage of repository capacity at which you receive a warning that the snapshot (legacy) repository
One technique for naming the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk is to add a hyphenated suffix to the ori
startTimeThe time of a day you want to create a snapshot (legacy) virtual disk and start performing a copy-on-write operation. The format for entering
Syntaxcreate snapVirtualDisk userLabel="snapVirtualDiskName" snapImageID="snapImageID"[repositoryVirtualDisk="repos_xxxx"
• The identifier of the snapshot image.For example, if you want to create a snapshot virtual disk named snapData1, using the most recent snapshot imag
Parameter Definition-cUse to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command
Parameter Descriptionvalues, the drawer ID values, and the slot ID values in parentheses.updateExistingVirtualDisksThis optional parameter specifies w
Parameter DescriptionfileThe file path and the file name to which you want to save the security key. For example,file="C:\Program Files\CLI\sup\s
Create Virtual Disk CopyDescriptionThis command creates a virtual disk copy and starts the virtual disk copy operation.CAUTION: Before you create a ne
ParametersParameter DescriptionsourceName of an existing virtual disk to use as the source virtual disk. You must put quotation marks (" ")
Deactivate Remote Replication (Legacy)NOTE: This command valid only with Fibre Channel storage arrays.DescriptionThis command deactivates the Remote R
Parameter Descriptionset this parameter to FALSE. The default setting is FALSE.Delete Consistency Group Snapshot ImageDescriptionThis command deletes
state. A snapshot virtual disk member in the Stopped state no longer has a relationship to the snapshot group of the deleted snapshot image. However,
Delete Disk PoolDescriptionThis command deletes a disk pool.Syntaxdelete diskPool [diskPoolName]ParameterParameter DescriptiondiskPoolNameThe alphanum
Delete Host GroupDescriptionThis command deletes a host group.CAUTION: This command deletes all of the host definitions in the host group.Syntaxdelete
Parameter DescriptionNOTE: An HBA host port is a physical connection on a host bus adapter that resides within a host system. An HBA host port provide
Notes, Cautions, and WarningsNOTE: A NOTE indicates important information that helps you make better use of your computer.CAUTION: A CAUTION indicates
Parameter Definition• eventOnly— Only event information is included in the e-mail.• profile— Event and array profile information is included in the e-
ParametersParameter DescriptionsnapGroupThe alphanumeric identifier (including - and _) of the snapshot group that you want to delete. Enclose the sna
Parameter Descriptionsnapshot group names in double quotation marks (" "). Enclose all of the snapshot group names in parenthesizes.If you d
Delete Snapshot (Legacy) Virtual DiskDescriptionThis command deletes one or more snapshot (legacy) virtual disks or snapshot (legacy) repository virtu
ParametersParameter DescriptionsnapVirtualDiskThe name of the snapshot virtual disk that you want to delete. Enclose the snapshot virtual disk identif
Delete SSD CacheDescriptionThis command deletes the SSD cache. All data in the SSD cache is purged.Syntaxdelete ssdCache [ssdCacheName]ParameterParame
ParametersParameter DescriptionallVirtualDisksDeletes all virtual disks in a storage array.NOTE: Using the allVirtualDisks parameter deletes virtual d
ParametersParameter DescriptionallVirtualDisksThis parameter deletes all of the virtual disks on a disk pool.virtualDisk or virtualDisks The name of t
• 1 — Reads the test• 2 — Performs a data loop-back test• 3 — Writes the testThe diagnostic tests consist of loop-back tests in which data is written
Parameter DescriptionpatternFileFile path and file name of the file that contains a data pattern to use as test data. Enclose the path and file name w
NotesWhen you run the cable diagnostic test, the firmware returns the following information:• Port: The port on which the diagnostic test was run.• Th
Parameter DefinitioneveryEvent. If you set the-I parameter to either profile or supportBundle, this information is included with the e-mails with the
ParameterParameter Descriptionprimary or primaries The name of the primary virtual disk of the remote replication pair to be tested. More than one pri
NOTE: This command must be run from the command line. It cannot be run in the MD Storage Manager script editor.SyntaxsupportBundle auto showParameters
Parameter Description• The allEnclosures parameter, which downloads new firmware to all of the EMMs in the storage array• The enclosure parameter, whi
ParametersParameter DescriptionphysicalDiskPhysical disk to which to download the firmware image. Specify the enclosure ID and slot ID for the physica
Parameter DescriptionTRUE if you want to download an earlier version of firmware.activateNowActivates the firmware and NVSRAM images. The default valu
Download Storage Array NVSRAMDescriptionThis command downloads NVSRAM values for the storage array RAID controller module.Syntaxdownload storageArray
Enable Disk Pool SecurityDescriptionThis command converts a non-secure disk pool to a secure disk pool.Syntaxenable diskPool [diskPoolName] securityPa
ParametersParameter DescriptionvirtualDisk, snapVirtualDisk, or cgSnapVirtualDiskThe name of the specific virtual disk for which you want to turn on o
Syntaxenable storageArray [featurePack | feature]file=”filename”ParameterParameter DescriptionfileFile path and file name of a valid feature key file.
Parameter DescriptionEnclose the virtual disk name in double quotation marks (" ").asyncRemoteReplicationGroupThe name of an existing remote
Parameter Definitionarray configuration and the relationship between the devices. Use the configuration file to reconstruct a storage array).-x (lower
ParameterParameter DescriptionaddPhysicalDisksThe setting to add new physical disks to the virtual disk. For high-capacity expansion enclosures, speci
Parameter Description\DBMbackup_03302010.dbm". This command does not automatically append a file extension to the saved file. You must specify a
Syntaxset diskPool [diskPoolName]((addDrives=[enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn]| addCapacity=(addCapacityValue[KB|MB|
ParametersParameter DescriptiontargetName of the target virtual disk for which to reinitiate a virtual disk copy operation. You must put brackets ([ ]
• User-defined disk group• User-defined number of physical disksIf you choose to define a number of physical disks, the RAID controller module firmwar
Parameter DescriptionrepositoryPhysicalDiskCountThe number of unassigned physical disks that you want to use for the replication repository virtual di
ParametersParameter DescriptionvirtualDisk or virtualDisks Name of the specific virtual disk for which to start a fresh copy-on-write operation. You c
virtual disks are not re-created. If the validation is successful for all of the snapshot virtual disks in the list, but one or more of the snapshots
NOTE: Formatting a virtual disk starts a long-running operation that cannot be stopped.Syntaxstart virtualDisk [virtualDiskName] initialize[existingRe
Syntaxremove asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"]incompleteReplication virtualDisk="virtualDiskName"Par
When an exception occurs while executing a command, the CLI automatically saves the error information to a file named excprpt.txt. The CLI attempts to
Remove Physical Disks From SSD CacheDescriptionThis command decreases the capacity of the SSD cache by removing Solid State Disks (SSDs).Syntaxset ssd
Syntaxremove remoteReplication (localVirtualDisk [virtualDiskName] |localVirtualDisks [virtualDiskName1... virtualDiskNameN])ParameterParameter Descri
Remove Virtual Disk From Remote Replication GroupDescriptionThis command removes a member virtual disk from an existing remote replication group. Opti
ParametersParameter DescriptionallVirtualDisksRemoves the LUN mapping from all virtual disks.virtualDisk or virtualDisks Name of the specific virtual
ParametersParameter DescriptionsnapVirtualDiskThe name of the snapshot virtual disk that you want to rename. Enclose the snapshot virtual disk name in
Repair Virtual Disk ConsistencyDescriptionThis command repairs the consistency errors on a virtual disk.Syntaxrepair virtualDisk [virtualDiskName] con
ParametersParameter DescriptionphysicalDisk Specifies the physical disks to assign to the virtual disk that you want to create. Specify the enclosure
ParametersParameter DescriptionremoteStorageArrayNameThe name for the remote storage array for which you are resetting the iSCSI IP address. Enclose t
controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 1, then RAID controller module 0 holds RAID
Parameter Description• errors—Statistics are reset for the most recent 20 failed resynchronization samples.NotesStatistics are reset for replicated vi
Status Value Meaning24 The wrong management station was specified.25 The command was not available.26 The device was not in the configuration file.27
Reset Storage Array iSCSI BaselineDescriptionThis command resets the iSCSI baseline for the storage array to 0.Syntaxreset storageArray iscsiStatsBase
Reset Storage Array Virtual Disk DistributionDescriptionThis command reassigns (moves) all virtual disks to their preferred RAID controller module.Syn
Parameter DescriptionThe identifier for the snapshot image can be one of these:• An integer value that is the sequence number of the snapshot in the c
Parameter Descriptionname must also be enclosed in double quotation marks (“ ”).writeConsistencyThe setting to identify the virtual disks in this comm
If the rollback operation cannot be resumed, the selected snapshot virtual disk reverts to a paused state, and the Needs Attention condition is displa
cannot be resumed, the selected snapshot (legacy) virtual disk reverts to a paused state, and the Needs Attention condition is displayed.Syntaxresume
Parameter Description• NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group.• OLDEST - Use this opti
Revive Disk GroupDescriptionThis command forces the specified disk group and associated failed physical disks to the Optimal state. All physical disks
Revive Physical DiskDescriptionThis command forces the specified physical disk to the optimal state.CAUTION: Correct use of this command depends on th
Revive Snapshot Virtual DiskDescriptionThis command forces a specified snapshot virtual disk to the Optimal state. The snapshot virtual disk can be:•
This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example. The -e parameter runs the file without
Save Physical Disk Channel Fault Isolation Diagnostic StatusDescriptionThis command saves the physical disk channel fault isolation diagnostic data th
ParameterParameter DescriptionlogFileName of the file to which to write the log sense data. You must put quotation marks (" ") around the fi
Syntaxsave storageArray arvmStats asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"]arvmStats file="filename"[virtual
Parameter Description• errors—Statistics are recorded for the most recent 20 failed resynchronization samples. These samples include a failure code.re
ParametersParameter DescriptionfileName of the file that contains the configuration values. You must put quotation marks (" ") around the fi
ParameterParameter DescriptionfileThe file path and the file name to which you save the core dump. Enclose the file name in double quotation marks (&q
Parameter Description• If the parameter is set to all, all data that resides in the database will be retrieved. This includes disk group and disk pool
Parameter Descriptionexample: dbmDatabase="C:\Array Backups \DBMbackup_03302010.dbm". This command does not automatically append a file exte
file="filename" [count=numberOfEventsforceSave=(TRUE | FALSE)]ParametersParameter DescriptionallEventsSaves all events to a file.criticalEve
ParametersParameter DescriptionrawThis parameter defines that the statistics collected are all statistics from the RAID controller module start‑of‑day
Save Storage Array SAS PHY CountsDescriptionThis command saves the storage array SAS physical layer (SAS PHY) counters to a file. To reset the SAS PHY
Support-related information includes:• The storage array profile• The Major Event Log information• The NVSRAM data• Current problems and associated re
[startTime=HH:MM][startDate=MM:DD:YY][endDate=MM:DD:YY](daysOfWeek={} | months={}(onDays={} |weekNumber=(First|Second|Third|Fourth|Last) dayOfWeek=(Su
Parameter Descriptionwednesday, thursday, friday, saturday, sunday, and all. For example: scheduleDay=wednesday.startTimeDefines time of a day you wan
NOTE: To remove a schedule, use the delete virtualDisk command with the schedule parameter. The delete command with the schedule parameter deletes onl
Parameter Descriptionsnapshot images for a repository full policy. The default value is 32.rollBackPriorityThe priority for rollback operations for a
raidLevel=(0 | 1 | 5 | 6)owner=(0 | 1)ParametersParameter DescriptiondiskGroupSequence number of the disk group for which to set properties. You must
• Create the required disk group size using other unassigned physical disks.• Delete the current disk group and then recreate the disk group with the
ParametersParameter DescriptiondiskPoolsThe list of diskPoolNames identifies multiple physical disk pool which have their parameters reset by the comm
Set Enclosure AttributeDescriptionThis command sets user-defined attributes for an enclosure.Syntaxset enclosure [enclosureID] (chassisName | assetTag
2About The Script CommandsYou can use the script commands to configure and manage a storage array. The script commands are distinct from the command l
ParametersParameter DescriptionenclosureService tag of the RAID enclosure or the expansion enclosure for which you are setting the enclosure ID. You m
Set HostDescriptionThis command assigns a host to a host group or moves a host to a different host group. You can also create a new host group and ass
Host Group Parameter Host Has Individual Virtual Disk-to-LUN MappingsHost Does Not Have Individual Virtual Disk-to-LUN MappingsdefaultGroupThe command
Syntaxset hostGroup [hostGroupName] userLabel="newHostGroupName"ParametersParameter DescriptionhostGroupName of the host group to rename. Yo
Parameter DescriptionuserLabelThe new name that you want to give to the HBA host port. Enclose the new name of the HBA host port in double quotation m
Syntaxset iscsiTarget [“iscsiID”](authenticationMethod=(none | chap) |chapSecret=”securityKey” |targetAlias=”userLabel”)ParametersParameter Descriptio
Parameter Description2. You must put brackets ([ ]) around the physical disk channel number.statusCondition of the channel. You can set the channel st
Syntaxset (physicalDisk [enclosureID,slotID] |physicalDisks [enclosureID1,slotID1 enclosureID2, slotID2... enclosureIDn,slotIDn])operationalState=fail
Parameter Descriptionfirmware for the RAID controller module returns a syntax error.availabilityThe mode for the RAID controller module, which you can
Syntax Element Statement DataOptions for the Ethernet Port ParameterenableIPv4=(TRUE | FALSE) |enableIPv6=(TRUE | FALSE) |IPv6LocalAddress=(0-FFFF):(0
where, command identifies the action to be performed, operand-data represents the storage array component to configure or manage (such as a RAID contr
Use the show controller NVSRAM command to show the NVSRAM information. When the duplexMode option is set to TRUE, the selected Ethernet port is set to
Parameter DescriptionrepositoryFullLimitThe percentage of repository virtual disk capacity at which you receive a warning that the snapshot image repo
Parameter Descriptionthis parameter to secondary. This parameter applies only when the virtual disk is part of a replication relationship.forceThe rol
Set Remote Replication GroupDescriptionUse this command to change the synchronization settings and warning thresholds that the RAID controller module
Parameter Descriptionprevious update. You can specify the length of time in minutes, hours, or days.NOTE: You must set the Recovery Point Threshold to
Parameter DescriptionEnclose the name of the existing repository virtual disk in double quotation marks (" ").If you want to create a new re
element. The capacity of the expandable repository virtual disk is exactly that of the single element. You can increase the capacity of an expandable
Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can
Parameter Descriptionsnapshot images for a repository full policy. Use integer values. The default value is 32.rollBackPriorityUse this parameter to d
Parameter Descriptionthis parameter to TRUE. To turn off consistency checking, set this parameter to FALSE.Set Snapshot Group Repository Virtual Disk
Object Type Identifierenclosure Enclosure IDvirtualDisk Virtual disk user label or the World Wide Identifier (WWID) for the virtual disk (set command
Syntaxset snapGroup ["snapGroupName"]enableSchedule=(TRUE | FALSE)schedule=(immediate | snapshotSchedule)ParametersParameter Descriptionsnap
repositoryFullPolicy=(failSourceWrites |failSnapshot)enableSchedule=(TRUE | FALSE) |schedule=(immediate | snapshotSchedule)rollbackPriority=(0 | 1 | 2
Parameter Descriptionperformance. A value of 0 indicates that the rollback operation is prioritized over all other host I/O. A value of 4 indicates th
Parameter Descriptioncopy-on-write operations because of the duration of a copy operation. You can ensure that copy-on-write operations maintain a cor
Set Snapshot Virtual Disk Media ScanDescriptionThis command runs a media scan on the physical disks used for a snapshot virtual disk. You also can per
ParametersParameters DescriptionsnapVirtualDiskThe alphanumeric identifier (including - and _) of the snapshot virtual disk for which you are setting
ParametersParameter DescriptionautoSupportConfigThe setting for automatically collecting support data each time the firmware detects a critical MEL ev
Additional InformationWhen you use this command, you can specify one or more of the optional parameters.Auto Support DataWhen enabled, the set storage
NOTE: If you are using self-encrypting disk physical disks in your storage array, you must use these criteria for your storage array password.NOTE: Yo
Set Storage Array ICMP ResponseDescriptionThis command returns the default values for negotiable settings for sessions and connections, which represen
ContentsNotes, Cautions, and Warnings...21 About The C
Command Syntax Descriptionrecover object {statement‑data} Re-creates an object from saved configuration data and the statement attributes (similar to
Syntaxset storageArray isnsIPv6Address=ipAddressParameterParameter DescriptionisnsIPv6AddressThe IPv6 address that you want to use for the iSNS server
Syntaxset storageArray learnCycleDate(daysToNextLearnCycle=numberOfDays |day=dayOfTheWeek) time=HH:MMParametersParameter DescriptiondaysToNextLearnCyc
Set Storage Array Security KeyDescriptionUse this command to set the security key that is used throughout the storage array to implement the Physical
Set Storage Array Unnamed Discovery SessionDescriptionThis command enables the storage array to participate in unnamed discovery sessions.Syntaxset st
Parameter DescriptionEnclose the virtual disk name in double quotation marks (" ") inside of square brackets ([ ]).virtualDiskThe World Wide
virtualDisks [“virtualDiskName1” ...“virtualDiskNameN”] |virtualDisk <wwID>)cacheFlushModifier=cacheFlushModifierValuecacheWithoutBatteryEnabled
Parameter DescriptioncacheFlushModifierThe maximum amount of time that data for the virtual disk stays in cache before the data is flushed to physical
Parameter Descriptionassign to the virtual disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the e
NOTE: Setting the addCapacity, addPhysicalDisks, or segmentSize parameter starts a long-running operation that you cannot stop. These long-running ope
Parameter DescriptionvirtualDiskThe World Wide Identifier (WWID) of the virtual disk for which you are setting properties. You can use the WWID instea
Recurring Syntax Syntax Valuecreate-raid-vol-attr-value-listcreate-raid-virtual disk-attribute-valuepair{create-raid-virtual disk-attribute-valuepair}
Parameter DescriptionreplicationCacheEnabledThe setting to turn on or turn off the replication cache. To turn on the replication cache, set this param
Add Capacity, Add Physical Disks, And Segment SizeSetting the addCapacity parameter, the addPhysicalDisks parameter, or the segmentSize parameter star
Modification PriorityModification priority defines the amount of system resources that are used when modifying virtual disk properties. If you select
ParametersParameter DescriptiontargetSpecifies the name of the target virtual disk for which to define properties. You must put brackets ([ ]) around
ParametersParameter DescriptionvirtualDiskThe name of the specific virtual disk for which you want to define mapping. Enclose the virtual disk name in
Syntaxshow ((CGSnapImage [(CGSnapImageName | CGSnapImageSequenceNumber)]) | (CGSnapImages [(CGSnapImageNumber1 ... CGSnapImageNumbern | CGSnapImageSeq
To show the most recent snapshot image in a snapshot consistency group that has the name snapCGroup1, you would use this command:show snapImage ["
Show Disk GroupDescriptionThis command returns the following information about a disk group:• Status (online or offline)• Physical disk type (SAS)• En
Show Disk Group Import DependenciesDescriptionThis command shows a list of dependencies for the physical disks in a disk group that you want to move f
Show Host PortsDescriptionFor all HBA host ports connected to a storage array, this command returns the following information:• HBA host port identifi
Recurring Syntax Syntax ValueIPV4GatewayIP= ipv4-address |IPV6HopLimit=integer |IPV6NdDetectDuplicateAddress= integer |IPV6NdReachableTime=integer |IP
– Enclosure location and slot location– Preferred channel– Redundant channel• Hot spare coverage• Details for each physical diskDepending on the size
Parameter DescriptionNOTE: To determine the type of physical disk in a specific location, use the physicalDisk parameter, and enter the enclosure and
ParametersNone.NOTE: When all firmware downloads have successfully completed, this command returns a Successful status. If any firmware downloads fail
Parameter Descriptionidentifier values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller
Show Remote Replication GroupDescriptionThis command displays configuration information for one or more remote replication groups. This command also d
NOTE: There are two types of synchronization: initial synchronization and periodic synchronization. Initial remote replication group synchronization p
ParametersParameter DescriptionprimaryThe name of the local virtual disk that you want for the primary virtual disk in the remote-replicated pair. Enc
Syntaxshow (allSnapGroups | snapGroup [snapGroupName] |snapGroups [snapGroupName1 ... snapGroupNamen])[summary | schedule]ParametersParameter Descript
Associated base volume: 2Cluster size: 65,536 bytesRepositoryTotal repository volumes: 3Aggregate repository status: OptimalTotal repository capacity:
Parameter Descriptiondouble quotation marks (" ") inside square brackets ([ ]). Separate each snapshot image name with a white space.allSnap
Recurring Syntax Syntax Value[physicalDiskType=physical disk-type][enclosureLossProtect=boolean]WWIDstring-literalFor hostPort identifiers this is a 1
Parameter Descriptionretrieving information. Enclose the snapshot virtual disk name in square brackets ([ ]).When you enter more than one snapshot vir
Parameter Descriptionidentifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must
ParametersParameter DescriptionssdCacheThe alphanumeric identifier (including - and _) of the SSD cache for which you want to get information. Enclose
Cache Allocation (%)The amount of SSD cache storage that is allocated, expressed as a percentage of the SSD cache storage that is available to this RA
Populate Actions (Host Reads) - BlocksNumber of blocks in Populate Actions (Host Reads).Populate Actions (Host Writes)Number of host writes where data
ParametersParameter DescriptionprofileDisplays all properties of the logical and physical components that comprise the storage array. The information
Parameter DescriptiontimeDisplays the current time to which both RAID controller modules in the storage array are set.virtualDiskDistributionDisplays
ParametersParameter DescriptionphysicalDiskTypeType of physical disk to use for the storage array. Valid physical disk type is SAS. This parameter is
Syntaxshow storageArray coreDumpParametersNone.Show Storage Array DBM DatabaseDescriptionThis command retrieves and shows metadata for the on-board ba
Syntaxshow storageArray lunMappings [host ["hostName"] | hostgroup ["hostGroupName"]]ParametersParameter DescriptionhostName of a
Recurring Syntax Syntax Valuerecover-raid-virtual-disk-attr-value-pair owner=(0 | 1)Table 8. Range of Values for Recurring Syntax ElementsRecurring Sy
ParametersNone.Show Storage Array Unreadable SectorsDescriptionThis command returns a table of the addresses of all of the sectors in the storage arra
NOTE: You must enclose the string in double quotation marks (“ ”).Show Thin Virtual DiskDescriptionThis command returns the expansion history or the c
Virtual Disk Physical CapacityConsumned CapacityQuota % Prov. ConsumedvirtualDiskName500.000 GB 230.000 GB 700.000 GB 46%Show Virtual DiskDescriptionF
ParametersParameter DescriptionallvirtualDisksThe setting to return information about all of the virtual disks in the storage array.virtualDisk or vir
Show Virtual Disk CopyDescriptionThis command returns information about virtual disk copy operations. The following information is returned:• Copy sta
ParametersNone.Additional InformationThis command returns virtual disk copy source information as shown in this example.Virtual Disk Name: financeCapa
ParametersParameter DescriptionallvirtualDisksThe setting to return performance statistics about all of the virtual disks in the storage array.virtual
ParametersNone.NotesUpon completion of the diagnostic test, the controller firmware returns one of these results:• Diagnosis completed without errors.
ParametersParameter DescriptionconsistencyGroupNameThe name of the consistency group for which you want to start a rollback operation. Enclose the nam
ParametersParameter DescriptiondiskGroupNumber of the disk group to identify. You must put brackets ([ ]) around the disk group number.Start Disk Grou
NOTE: The capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its
Additional InformationWhen this command is successful, you can run the start diskGroup import command to finish moving the disk group to a Complete st
ParametersParameter DescriptiondiskPoolThe alphanumberic identifier of the disk pool (including – and _) that you want to locate. Enclose the diskPool
NOTE: This operation ends the iSCSI connections for the portal and brings down the portal temporarily.Start Physical Disk BlinkDescriptionThis command
Start Physical Disk Channel Fault Isolation DiagnosticsDescriptionThis command runs the physical disk channel fault isolation diagnostics and stores t
NOTE: Use the save physicalDiskChannel faultDiagnostics command and the stop physicalDiskChannel faultDiagnostics command in association with the star
Start Remote Replication SynchronizationDescriptionThis command starts Remote Replication synchronization.Syntaxstart asyncRemoteReplicationGroup [&q
Start Secure Physical Disk EraseDescriptionThis command erases all of the data from one or more self-encrypting disk (SED) physical disks so that they
ParametersParameter DescriptionvirtualDisk orvirtualDisksNames the specific snapshot virtual disk or snapshot virtual disks for which you want to star
Parameter DescriptionEnclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]).NotesThe name of a snapsho
• Retrieve the performance modeling data using PowerVault MD Storage Manager.Performance modeling ends, but no data is available when one of the follo
36
ParametersParameter DescriptionsourceLocationThis parameter specifies the location of the database.• disk indicates that data comes directly from the
NOTE: Executing a consistency check with the diagnosticType parameter set to a value other than filesystem, and with the sourceLocation parameter set
Start Virtual Disk InitializationDescriptionThis command starts the formatting of a virtual disk in a storage array.NOTE: Initializing a virtual disk
NOTE: Canceling a consistency group snapshot rollback operation leaves the base virtual disk in an indeterminate state with potentially invalid or inc
NOTE: This command does not delete a consistency group snapshot virtual disk. To delete a consistency group snapshot virtual disk use the delete cgSna
Syntaxstop diskPool locateStop Enclosure BlinkDescriptionThis command turns off the indicator LED on the enclosure that was turned on by the start enc
Syntaxstop physicalDisk blinkParametersNone.Stop Physical Disk Channel BlinkDescriptionThis command turns off the indicator lights on the expansion en
Stop Snapshot Group ImageDescriptionThis command cancels a pending snapshot image copy-on-write operation on a snapshot image group. If the snapshot i
Parameter Descriptionsnapshot images. Enclose the snapshot group identifier in square brackets ([ []).consistencyGroupThe alphanumeric identifier (inc
snapshot (legacy) virtual disk name that the RAID controller modules might create is, if the base virtual disk name is aaa and does not have a snapsho
3Configuring A Storage ArrayThis chapter explains how to run script commands from the command line to create a virtual disk from a group of physical d
ParametersParameter DescriptionvirtualDiskNames the specific snapshot virtual disk for which you want to resume a rollback operation. Enclose the snap
NotesThe name of a snapshot image has two parts separated by a colon (:):• The identifier of the snapshot group• The identifier of the snapshot imageF
ParametersParameter DescriptionssdCacheThe alphanumeric identifier (including - and _) of the SSD cache that you want to locate. Enclose the identifie
* = Current SSD cache physical capacity.SSD Cache Performance Modeling Data (Cache Hit %):Cache Capacity Cache Hit %186 GB 0 %372 GB 0 %557 GB * 0 %55
ParametersNone.NotesThe controller firmware returns a confirmation that the diagnostic test was cancelled.In addition, you can start the database conf
ParametersNone.Stop Virtual Disk CopyDescriptionThis command stops a virtual disk copy operation.Syntaxstop virtualDiskCopy target [targetName] [sourc
ParametersParameter Descriptionprimary or primariesThe name of the virtual disk for which you want to suspend operation. Enclose the virtual disk name
Parameter Descriptionsquare brackets ([ ]). If the remote replication group name has special characters, you also must enclose the remote replication
ParametersParameter DescriptionasyncRemoteReplicationGroupThe name of an existing remote replication group that you want to test. Enclose the remote r
ParametersParameter DescriptionfileThe file path and the file name to which you want to save the security key. For example,file="C:\Program Files
Determining What Is On Your Storage ArrayEven when you create a configuration on a previously unconfigured storage array, you still need to determine
12Sample Script FilesThis appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a co
The first line of text is the show string command. This command displays text bounded by quotation marks (" ") on a monitor screen when the
set virtualDisk["7"] mediaScanEnabled=false;set virtualDisk["7"] consistencyCheckEnabled=false;set virtualDisk["7"] modi
13CLI Command UpdatesThis chapter reflects new and updated commands that are available for use with Dell's PowerVault Modular Disk Series of stor
• Delete Remote Replication Group• Delete Snapshot Group• Delete Snapshot Image• Delete Snapshot Virtual Disk• Delete Snapshot (Legacy) Virtual Disk•
• Show Consistency Group Snapshot Image• Show Remote Replication Group• Show Remote Replication Group Synchronization Progress• Show Snapshot Group• S
• Set Snapshot (Legacy) Virtual Disk• Set Virtual Disk Copy• Show Virtual Disk• Stop Snapshot (Legacy)388
profile command, but is constrained to the specific component. (The following commands are not complete commands. For information about a command, see
Snapshot Images And Groups...
Using The Create Virtual Disk CommandThe create virtualDisk command enables you to create new virtual disks in the storage array in three ways:• Creat
NOTE: The capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its
The diskGroup parameter is the number of the disk group in which you want to create a new virtual disk. If you do not know the disk group numbers on t
• Size of each segment on the physical disksAfter defining these parameters, the MD Storage Manager automatically creates the disk groups, virtual dis
Example Of The Auto Configuration Commandclient>smcli 123.45.67.89 -c "autoConfigurestorageArray physicalDiskType=SAS raidLevel=5diskGroupWidt
Setting Up SMTP And SNMP AlertsThe storage array can be set up to send automatic e-mail alert messages to specified email addresses when specific even
the host types with which the RAID controller modules can communicate; it does not return a list of the hosts. The following examples show how to use
1. Identify the location of the physical disks by enclosure ID and slot ID.2. Set the hotSpare parameter to TRUE to enable the hot spare or FALSE to d
5. Click OK.Configuring Alert NotificationsYou can use the Configure Alerts dialog box to set up an email alert notification in the event of an error
4Using The Snapshot FeatureThe following types of virtual disk snapshot premium features are supported on the MD storage array:• Snapshot Virtual Disk
Re-creating The Snapshot Virtual Disk ...72Pre
• Consistency groupsSnapshot Groups And Snapshot Consistency GroupsThe Snapshot Virtual Disk premium feature supports two types of snapshot groups:• S
• Snapshots created using the Snapshot Virtual Disk (Legacy) premium feature cannot be included in a consistency group.• A base virtual disk can resid
repositoryVirtualDisk="repos_XXXX"[repositoryFullPolicy=(failBaseWrites | purgeSnapImages) |rollbackPriority=(high | highest | medium | low
Unique command syntax and naming rules apply. The name of a snapshot image has two parts separated by a colon (:):• identifier of the snapshot group•
where, consistencyGroup is the name of the consistency group for which you are creating snapshot images.Deleting A Snapshot Virtual Disk Or A Consiste
• Create Consistency GroupStarting, Stopping And Resuming A Snapshot RollbackThe command line interface allows you to:• start a rollback operation fro
– The base virtual disk is currently in a synchronizing operation. The snapshot image creation completes as soon as the synchronization operation is c
This action frees repository capacity so it can be used to satisfy ongoing copy-on-write requirements for the remaining snapshot images.For other valu
The oldest snapshot images in the snapshot group until the maximum number of images defined with the parameter is met. Deleting snapshot images frees
To remove CGGroup_1, as well as all repository virtual disks:set consistencyGroup ["CGGroup_1"] removeCGMemberVirtualDisk=" payroll_bac
Removing A Virtual Disk Or Repository Virtual Disk From A Remote Replication Group...91Disabling The Remote Repli
preReadConsistencyCheckThe setting to turn on or turn off preread consistency checking. Turning on preread consistency checking verifies the consisten
To decrease capacity, replace increaseRepositoryCapacity with decreaseRepository:set snapVirtualDisk ["snapVirtualDiskName"] decreaseReposit
5Using The Snapshot (Legacy) FeatureThe following types of virtual disk snapshot premium features are supported on the MD storage array:• Snapshot Vir
Table 9. Snapshot Virtual Disk ComponentsComponent DescriptionSource virtual disk Standard virtual disk from which the snapshot is createdSnapshot vir
• Define a disk group in which the snapshot repository virtual disk resides. Optionally define the capacity of the repository virtual disk.• Define th
1. Stop all I/O activity to the source.2. Using your Windows system, flush the cache to the source. At the host prompt, type SMrepassist -f <filena
See step 1 through step 4 in the preceding section, Preparing Host Servers To Create An Initial Snapshot Virtual Disk. The following example is the sc
The following example is the script file version of the command:create snapshotVirtualDisk sourceVirtualDisk="Mars_Spirit_4" repositoryDiskG
Table 11. Snapshot Virtual Disk ParametersParameter DescriptionphysicalDiskTypeSpecifies the type of physical disk to use for the snapshot repository
Monitoring Performance...
Parameter Descriptionfail writes to the source virtual disk (failSourceWrites) or fail writes to the snapshot virtual disk (failSnapShot). The default
in quotation marks. The character string cannot contain a new line. Make sure that you use unique names or the RAID controller module firmware returns
virtualDisk command to stop the copy‑on‑write operations. When you stop a snapshot virtual disk, the snapshot virtual disk and the repository virtual
Re-creating A Snapshot Virtual DiskAfter first preparing the host server(s) as specified in the preceding procedure, use the following examples to re-
74
6Using The Virtual Disk Copy FeatureThis chapter describes how the Virtual Disk Copy feature works, lists the script commands for Virtual Disk Copy, a
After completion of the virtual disk copy of a snapshot (legacy), the legacy snapshot is disabled. After completion of the virtual disk copy using a s
1. Enable the Virtual Disk Copy feature.2. Determine candidates for a virtual disk copy.3. Create the target virtual disk and source virtual disk for
1. Stop all I/O activity to the source and target virtual disk.2. Using your Windows system, flush the cache to both the source and the target virtual
Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Create A Virtual Disk Copy. The following example is the script file ve
Activate Remote Replication Feature...
• After the virtual disk copy has completed re-creating a virtual disk copy using the recopy virtualDiskCopy commandWhen you create a virtual disk cop
Preparing Host Servers To Recopy A Virtual DiskCAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or
Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Recopy A Virtual Disk. The following example is the script file version
About Snapshot (Legacy) Premium Features With Virtual Disk Copy• A source virtual disk for a virtual disk copy can be a standard virtual disk or a thi
84
7Using The Remote Replication Premium FeatureThe following types of Remote Replication premium features are supported on the MD storage array:Remote R
completes, the system uses the point-in-time images on the secondary virtual disk to ensure that the data is maintained in a consistent state during s
corrected (the secondary virtual disk is placed online or recovered to an Optimal status), then synchronization is required. The replicated pair then
Remote Replication Requirements And RestrictionsTo use the standard Remote Replication premium feature, you must have:• Two storage arrays with write
In this command, asyncReplication is literal and is appended with the activation_key, which is provided by Dell. For example, if your activation key v
Create Remote Replication Group...
Changing Remote Replication Group SettingsThe set asyncRemoteReplicationGroup command lets you change settings for an existing replication group.The f
Suspending A Remote Replication GroupUse the asyncRemoteReplicationGroup command to stop data transfer between a primary virtual disk and a secondary
Disabling The Remote Replication Premium FeatureYou disable the Remote Replication premium feature to prevent the new replication relationship from be
Command Descriptionsynchronization statistics for member virtual disks to relative 0.show asyncRemoteReplicationGroup synchronizationProgressShows pro
94
8Using The Remote Replication (Legacy) Premium FeatureThe Remote Replication (legacy) premium feature provides for online, real-time replication of da
In the event of a disaster or a catastrophic failure at the primary site, you can perform a role reversal to promote the secondary virtual disk to a p
Synchronous Write ModeSynchronous write mode provides the highest level security for full data recovery from the secondary storage array in the event
ResynchronizationData replication between the primary virtual disk and the secondary virtual disk in a replication relationship is managed by the RAID
– A full synchronization at the lowest synchronization priority level takes approximately eight times as long as a full synchronization at the highest
Kommentare zu diesen Handbüchern