Page 1 Dell PowerVault Modular Disk Storage Arrays CLI Guide...
Page 2 CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2013 Dell Inc. All Rights Reserved. Trademarks used in this text: Dell , the Dell logo, Dell Boomi...
Page 3: Table Of Contents
Contents 1 About The Command Line Interface..............15 ..................16 How To Use The Command Line Interface ...........................16 Usage Notes ..........................16 CLI Commands ......................18 Command Line Parameters ......................... 22 Formatting Considerations ........................22 Detailed Error Reporting ............................23 Exit Status ..........................
Page 4 ......................52 Snapshot Consistency Groups ....................53 Understanding Snapshot Repositories ..................53 Snapshot Consistency Group Repositories ...................53 Consistency Groups And Remote Replication ........................53 Creating Snapshot Images ......................54 Creating A Snapshot Image ......................54 Deleting A Snapshot Image ..............54 Creating A Consistency Group Snapshot Virtual Disk .................
Page 5 6 Using The Virtual Disk Copy Feature..............77 ........................77 About Virtual Disk Copy ........................77 Virtual Disk Copy Types .......................78 Creating A Virtual Disk Copy ..................79 Enabling The Virtual Disk Copy Feature .................. 79 Determining Virtual Disk Copy Candidates ......................79 Creating A Virtual Disk Copy ..............79...
Page 6 ..................95 Interaction With Other Premium Features ..................95 Standard Remote Replication Commands 8 Using The Remote Replication (Legacy) Premium Feature......97 ..................97 How Remote Replication (Legacy) Works .....................98 Replication Repository Virtual Disks ......................98 Replication Relationships ..........................98 Data Replication ..............99 Link Interruptions Or Secondary Virtual Disk Errors ........................
Page 7 ...................... 116 Defragmenting A Disk Group ..........................116 Using SSD Cache ..................116 Enabling SSD Cache For A Virtual Disk ........................117 Creating SSD Cache ................117 Adding Physical Disks To Existing SSD Cache ..............117 Removing Physical Disks From Existing SSD Cache .....................117 SSD Cache Performance Modeling ........118...
Page 8 ....................138 Add Physical Disks To SSD Cache ................139 Add Virtual Disk To Remote Replication Group ......................140 Autoconfigure Storage Array ..................142 Autoconfigure Storage Array Hot Spares ..........................142 Blink SSD Cache ................143 Cancel Remote Replication Group Role Reversal ....................
Page 9 ....................187 Create Snapshot (Legacy) Virtual Disk ......................192 Create Snapshot Virtual Disk ..........................194 Create SSD Cache ....................195 Create Storage Array Security Key ........................197 Create Virtual Disk Copy ..................199 Deactivate Remote Replication (Legacy) ....................... 199 Delete Consistency Group ................... 200 Delete Consistency Group Snapshot Image ................201 Delete Consistency Group Snapshot Virtual Disk...
Page 10 ..........................227 Modify Disk Pool ......................... 228 Recopy Virtual Disk Copy ..............229 Re-Create Remote Replication Repository Virtual Disk .......................... 231 Re-Create Snapshot ......................233 Reinitialize Thin Virtual Disk ......234 Remove Incomplete Remote Replicated Pair From Remote Replication Group ..............235 Remove Member Virtual Disk From Consistency Group ..................
Page 11 ....................260 Save Storage Array DBM Database ................ 262 Save Storage Array DBM Validator Information File ........................ 263 Save Storage Array Events ....................264 Save Storage Array iSCSI Statistics ..................265 Save Storage Array Performance Statistics ....................265 Save Storage Array SAS PHY Counts ....................
Page 12 ....................305 Set Storage Array ICMP Response ..................305 Set Storage Array iSNS Server IPv4 Address ..................306 Set Storage Array iSNS Server IPv6 Address ...................306 Set Storage Array iSNS Server Listening Port ......................307 Set Storage Array Learn Cycle ....................
Page 13 ................347 Show Storage Array Unconfigured iSCSI Initiators ..................347 Show Storage Array Unreadable Sectors ............................348 Show String ........................348 Show Thin Virtual Disk ..........................349 Show Virtual Disk ....................351 Show Virtual Disk Action Progress ........................351 Show Virtual Disk Copy ..................352 Show Virtual Disk Copy Source Candidates ..................
Page 14 ........................373 Stop Physical Disk Blink ..................... 373 Stop Physical Disk Channel Blink ..............373 Stop Physical Disk Channel Fault Isolation Diagnostics ......................374 Stop Snapshot Group Image ................374 Stop Snapshot Group Pending Snapshot Images ........................375 Stop Snapshot (Legacy) .....................
Page 15: About The Command Line Interface
The command line interface gives you direct access to a script engine utility in the Dell PowerVault Modular Disk Storage Manager software (MD Storage Manager). The script engine reads the commands, or runs a script file, from the command line and performs the operations instructed by the commands.
Page 16: How To Use The Command Line Interface
How To Use The Command Line Interface Using the CLI commands, you can access the script engine, specify which storage array receives the script commands, and set operation environment parameters. A CLI command consists of the following elements: • The term SMcli •...
Page 17 The following are general forms of the CLI commands, showing the parameters and terminals used in each command. The table below lists definitions for the parameters shown in the CLI commands. Table 1. Command Name Conventions Parameter Definition pipe symbol indicating alternative ("a" or "b") italicized-words terminals [...] (square brackets)
Page 18: Command Line Parameters
[-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-address [-g contactInfoFile][-S] SMcli -A [host-name-or-IP-address [host-name-or-IP-address]] [-S] SMcli -X (-n storage-array-name | -w WWID | -h host-name) SMcli -? Command Line Parameters Table 2.
Page 19 Parameter Definition Use to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command by using a semicolon (;) You cannot place more than one -c parameter on the same command line. You can include more than one script command after the -c parameter.
Page 20 Parameter Definition Use with the -a and -x parameters to specify the host name that is running the SNMP agent to which the storage array is connected. Use to specify the type of information to be included in the e-mail alert notifications. The following are valid information arguments: •...
Page 21 Parameter Definition • The password is specified in a script file that is running. • The storage array password is specified by using the -c parameter and the set session password=password command. Use to specify how frequently to include additional profile or support bundle information in the e-mail alert notifications.
Page 22: Formatting Considerations
Parameter Definition Use with the -d parameter to display the alert -s (lowercase) settings in the configuration file. Use with the -d parameter to display the current global status of the known devices in the storage array configuration file. (The configuration file lists all of the devices in a storage array configuration and the relationship between the devices.
Page 23: Exit Status
• If the CLI must abnormally end execution or abort script command execution, error data is collected and saved before the CLI aborts. • The CLI automatically saves the error data by writing the data to a file with a standard name. •...
Page 24: Usage Examples
Status Value Meaning Invalid script syntax was found. The RAID controller module was unable to communicate with the storage array. A duplicate argument was entered. An execution error occurred. A host was not at the specified address. The World Wide Identifier (WWID) was not in the configuration file. The WWID was not at the address.
Page 25 Windows: SMcli -n "Payroll_Array" -c "set storageArray userLabel=\"Finance_Array\";" Linux: SMcli -n ‘Payroll_Array’ -c ‘set storageArray userLabel="Finance_Array";’ This example shows how to delete an existing virtual disk and create a new virtual disk on a storage array. The existing virtual disk name is Stocks_<_Bonds. The new virtual disk name is Finance. The RAID controller module host names are finance1 and finance2.
Page 27: About The Script Commands
About The Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or run a file of script commands.
Page 28: Script Command Structure
Script Command Structure All script commands have the following structure: command operand-data {statement-data} where, command identifies the action to be performed, operand-data represents the storage array component to configure or manage (such as a RAID controller module, physical disk, or disk group), and statement-data is what you want to do to the component (such as, specifying the RAID level or availability of a disk group).
Page 29: Script Command Synopsis
Object Type Identifier snapGroup A snapshot group contains a sequence of snapshot images of an associated base virtual disk. A snapshot group has a repository virtual disk that is used to save data for all of the snapshot images that are part of the snapshot group.
Page 30: Recurring Syntax Elements
Command Syntax Description ‑ data} diagnose object {statement Runs a test and displays the results. ‑ data} disable object {statement Prevents a feature from operating. ‑ data} download object {statement Transfers data to the storage array or hardware associated with the storage array. ‑...
Page 31 Table 7. Recurring Syntax Elements Recurring Syntax Syntax Value raid-level (0 | 1 | 5| 6) snapshot-repository-raid-level (1 | 5 | 6) capacity-spec integer-literal [KB | MB | GB | TB | Bytes] segment-size-spec integer-literal boolean (TRUE | FALSE) user-label string-literal user-label-list user-label {user-label}...
Page 32 Recurring Syntax Syntax Value IPV6LocalAddress=ipv6-address | IPV6RoutableAddress=ipv6-address | IPV6RouterAddress=ipv6-address | enableIPV4= boolean | enableIPV6=boolean | enableIPV4Vlan=boolean | enableIPV6Vlan=boolean | enableIPV6Priority=boolean | enableIPV6Priority=boolean | IPV4ConfigurationMethod=(static | dhcp) | IPV6ConfigurationMethod=(static | auto) | IPV4GatewayIP= ipv4-address | IPV6HopLimit=integer | IPV6NdDetectDuplicateAddress= integer | IPV6NdReachableTime=integer | IPV6NdRetransmitTime=integer | IPV6NdTimeOut=integer | IPV4Priority=integer |...
Page 33 Recurring Syntax Syntax Value NOTE: For enclosure loss protection to work, each physical disk in a disk group must be on a separate enclosure. If you set enclosureLossProtect=TRUE and have selected more than one physical disk from any one enclosure, the storage array returns an error.
Page 34 Recurring Syntax Syntax Value NOTE: The physicalDiskType parameter is not required if only one type of physical disk is in the storage array. If you use the physicalDiskType parameter, you must also use the hotSpareCount and diskGroupWidth parameters. If you do not use the physicalDiskType parameter, the configuration defaults to SAS physical disks.
Page 35: Usage Guidelines
Recurring Syntax Syntax Values NOTE: The maxFramePayload parameter is shared between IPv4 and IPv6. The payload portion of a standard Ethernet frame is set at 1500 bytes, and a jumbo Ethernet frame is set at 9000 bytes. When using jumbo frames, make sure that all of the devices contained in the network path can handle the larger frame size.
Page 36 • The script engine interprets any text typed between / * and * / as a comment. If the script engine does not find both a beginning and ending comment notation, an error message is displayed, and the script operation is terminated. /* Deletes the existing configuration */ clear storageArray Configuration;...
Page 37: Configuring A Storage Array
Configuring A Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts and terminology.
Page 38: Determining What Is On Your Storage Array
• A disk group and associated RAID level • The virtual disks • Which hosts have access to the virtual disks This section explains how to use the script commands to create a configuration from an array of physical disks. Determining What Is On Your Storage Array Even when you create a configuration on a previously unconfigured storage array, you still need to determine the hardware and software features that must be included with the storage array.
Page 39: Saving A Configuration To A File
When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. To return a brief list of the storage array features and components, use the summary parameter. The command is similar to the following example: client>smcli 123.45.67.89 -c "show storageArray summary;"...
Page 40: Using The Create Virtual Disk Command
hostTopology=(TRUE | FALSE) | lunMappings=(TRUE | FALSE)] You can choose to save the entire configuration or specific configuration features. The command for setting this parameter value looks like the following example: client>smcli 123.45.67.89 -c "save storageArray configuration file= \"c:\folder\storageArrayconfig1.scr\";" In this example, the name folder is the folder in which you choose to place the configuration file, and storageArrayconfig1.scr is the name of the file.
Page 41 The owner parameter defines the RAID controller module to which you want to assign the virtual disk. If you do not specify a RAID controller module, the RAID controller module firmware determines the owner of the virtual disk. The segmentSize parameter is the same as described for the autoConfigure storageArray command.
Page 42 The command in this example creates the same virtual disk as the previous create virtualDisk command, however, in this case the user does not know which physical disks are assigned to this disk group. Creating Virtual Disks In An Existing Disk Group To add a new virtual disk to an existing disk group, use the following command: create virtualDisk DiskGroup=diskGroupNumber userLabel="virtualDiskName"...
Page 43: Using The Auto Configure Command
Method enclosureLossProtect= TRUE enclosureLossProtect=FALSE group has enclosure loss protection. The enclosureLossProtect parameter is not valid when creating virtual disks on existing disk groups. Using The Auto Configure Command The autoConfigure storageArray command creates the disk groups on a storage array, the virtual disks in the disk groups, and the hot spares for the storage array.
Page 44: Modifying Your Configuration
• The diskGroupCount parameter defines the number of new disk groups wanted in the storage array. • The virtualDisksPerGroupCount parameter defines the number of virtual disks wanted in each disk group. • The hotSpareCount parameter defines the number of hot spares wanted in each disk group. •...
Page 45: Setting The Storage Array Password
• Storage array host type • Global hot spares NOTE: Before modifying your configuration, save a copy of your current configuration to a file (see Saving A Configuration To A File). If you have problems with your modifications, you can use the information in the file to restore your previous configuration.
Page 46: Setting The Raid Controller Module Clocks
Setting The RAID Controller Module Clocks To synchronize the clocks on the RAID controller modules with the host, use the set storageArray time command. Running this command helps ensure that event timestamps written by RAID controller modules to the Major Event Log (MEL) match event timestamps written to the host log files. The RAID controller modules remain available during synchronization.
Page 47: Assigning Global Hot Spares
• Changing the RAID level of a disk group The lowest priority rate favors system performance, but the modification operation takes longer. The highest priority rate favors the modification operation, but the system performance might be degraded. The set virtualDisk command enables you to define the modification priority for a virtual disk. The following syntax is the general form of the command: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1...
Page 48: Configuring Alert Notifications
monitor is installed automatically with the MD storage management software. When an event occurs, alert notifications in the form of emails and SNMP trap messages are sent to the destination addresses that are specified in the Configure Alerts dialog. For more information about how to specify the destination addresses, refer to the Configuring the Email and SNMP Alert Notification Settings online help topic in the Enterprise Management Window (EMW).
Page 49 Select the storage array for which you want to receive email alerts and click OK. The Configure Alerts dialog box appears. NOTE: If you do not know which storage array to select, click Blink to turn on the indicator lights of the storage array. Fill in the information for the selected tab and click OK.
Page 51: Using The Snapshot Feature
Using The Snapshot Feature The following types of virtual disk snapshot premium features are supported on the MD storage array: • Snapshot Virtual Disks using multiple point-in-time (PiT) groups • Snapshot Virtual Disks (Legacy) using a separate repository for each snapshot NOTE: This section describes the Snapshot Virtual Disk using PiT groups.
Page 52: Snapshot Groups And Snapshot Consistency Groups
• Standard virtual disks • Thin provisioned virtual disks • Consistency groups Snapshot Groups And Snapshot Consistency Groups The Snapshot Virtual Disk premium feature supports two types of snapshot groups: • Snapshot groups • Consistency groups Snapshot Groups The purpose of a snapshot group is to create a sequence of snapshot images on a given base virtual disk without impacting performance.
Page 53: Understanding Snapshot Repositories
• Consistency groups can be rolled back. • A virtual disk can belong to multiple consistency groups. • Only standard virtual disks and thin virtual disks can be included in a consistency group. • Snapshots created using the Snapshot Virtual Disk (Legacy) premium feature cannot be included in a consistency group.
Page 54: Creating A Snapshot Image
used with the create snapGroup command allows you to choose to either fail the write attempt or automatically purge a specified number of older snapshot images. create snapGroup userLabel="snapGroupName" sourceVolume="virtualDiskName" repositoryVirtualDisk="repos_XXXX" [repositoryFullPolicy=(failBaseWrites | purgeSnapImages) | rollbackPriority=(high | highest | medium | low | lowest)| repositoryFullLimit=percentValue | autoDeleteLimit=numberOfSnapImages] •...
Page 55: Creating A Consistency Group Snapshot Image
• read-only • repository full value • automatic repository selection 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 • identifier of the snapshot image If you do not specify the repositoryVirtualDiskType or readOnly parameters, the repositories for the consistency group snapshot virtual disk will be selected automatically.
Page 56: Deleting A Snapshot Virtual Disk Or A Consistency Group Snapshot Virtual Disk
virtual disk that is a member of the consistency group before creating the snapshot images. If the snapshot image cannot be completed successfully for all of the consistency group members, this command fails and new snapshot images are not created. Since all members of a snapshot consistency group normally contain the same number of snapshot images, adding a new member to a snapshot consistency group with this command create a new member lacking previously created snapshot images.
Page 57: Starting, Stopping And Resuming A Snapshot Rollback
You can create a schedule that runs daily or weekly in which you select specific days of the week (Sunday through Saturday). An example of the set snapGroup command using the schedule parameters: set snapGroup ["snapGroupName"] enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule) Valid schedule values for the schedule parameter are immediate, startDate, scheduleDay, startTime, scheduleInterval, endDate, noEndDate, timesPerDay and timeZone.
Page 58: Creating A Snapshot Group
Creating A Snapshot Group A snapshot group is a sequence of point-in-time images of a single associated base virtual disk. A snapshot group uses a repository to save data for all snapshot images contained in the group. The repository is created at the same time the snapshot group is created. Guidelines when creating a snapshot group: •...
Page 59: Creating A Consistency Group
Creating A Consistency Group A consistency group contains simultaneous snapshots of multiple virtual disks to ensure consistent copies of a group of virtual disks. When you add a virtual disk to a consistency group, the system automatically creates a new snapshot group that corresponds to this member virtual disk. The following command creates a new, empty consistency group.
Page 60: Adding A Member Virtual Disk To A Consistency Group
repositoryFullLimit=percentValue| autoDeleteLimit=numberOfSnapImages| rollbackPriority=(lowest | low | medium | high | highest)] The repositoryFullPolicy parameter determines how you want snapshot processing to continue if the snapshot repository virtual disks are full. You can choose to fail writes to the base virtual disk (failBaseWrites) or delete (purgeSnapImages) the snapshot images.
Page 61: Removing A Member Virtual Disk From A Consistency Group
To add a new base virtual disk to a consistency group and create a new repository virtual disk using a disk pool: set consistencyGroup ["consistencyGroupName"] addCGMemberVolume="baseVirtualDiskName" repositoryVirtualDisk=("diskPoolName" capacity=capacityValue(KB|MB|GB|TB|bytes)) Restrictions • The Snapshot premium feature must be enabled on the storage array. •...
Page 62 • Snapshot group • Snapshot virtual disk • Consistency group member virtual disk • Replicated Pair This command defines the properties for a virtual disk. You can use most parameters to define properties for one or more virtual disks. You can also use some parameters to define properties for only one virtual disk.
Page 63: Setting Snapshot Virtual Disk Repository Virtual Disk Capacity
ignores consistency pre-read. If the virtual disk is subsequently migrated back to a RAID level that supports consistency, the option becomes available again. NOTE: Enabling the option on overall repository virtual disks without consistency does not affect the virtual disk. However, the attribute is retained for that overall repository virtual disk if it is ever changed to one with consistency information.
Page 64: Reviving Disk Groups, Physical Disks, Snapshot Groups, And Snapshot Virtual Disks
Reviving Disk Groups, Physical Disks, Snapshot Groups, And Snapshot Virtual Disks The revive command forces failed physical disks, disk groups, snapshot groups and snapshot virtual disks into an Optimal state. However, this command should only be performed by qualified storage administrators.
Page 65: Using The Snapshot (Legacy) Feature
NOTE: If you ordered Premium Features for the Snapshot Virtual Disks, you would have received a Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature. For more information, see Premium Feature —...
Page 66: Using Host Servers To Create An Initial Snapshot Virtual Disk
This can result in data loss on the source virtual disk or an inaccessible snapshot. For details on mapping the snapshot virtual disk to the secondary node, see the Dell PowerVault MD3200 and MD3220 Storage Arrays With Microsoft Windows Server Failover Clusters or Dell PowerVault MD3200i and MD3220i Storage Arrays With Microsoft Windows Server Failover Clusters at dell.com/support/manuals.
Page 67: Creating A Snapshot Virtual Disk
• You must satisfy the requirements of your host operating system for creating snapshot virtual disks. Failure to meet the requirements of your host operating system results in an inaccurate point-in-time image of the source virtual disk or the target virtual disk in a virtual disk copy. Creating A Snapshot Virtual Disk The create snapshotVirtualDisk command provides three methods for defining the physical disks for your snapshot repository virtual disk:...
Page 68: Preparing Host Servers To Create An Initial Snapshot Virtual Disk
Preparing Host Servers To Create An Initial Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the source virtual disk.
Page 69: Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks
NOTE: Use one or all of the optional parameters as needed to help define your configuration. You do not need to use any optional parameters. See step 1 through step 4 in the preceding section, Preparing Host Servers To Create An Initial Snapshot Virtual Disk.
Page 70: Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks
NOTE: Use one or all of the optional parameters as needed to define your configuration. It is not necessary to use any optional parameters. The following example is a command in which software assigns the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVolume= \"Mars_Spirit_4\"...
Page 71: User-Defined Parameters
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 11. Snapshot Virtual Disk Parameters Parameter Description Specifies the type of physical disk to use for the...
Page 72 Parameter Description 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.) Specifies the size of the snapshot repository virtual repositoryPercentOfSource 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.
Page 73: Names Of Snapshot Virtual Disks And Repository Virtual Disks
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.) Names Of Snapshot Virtual Disks And Repository Virtual Disks The names of snapshot virtual disks and repository virtual disks can be any combination of alphanumeric...
Page 74: Stopping And Deleting A Snapshot Virtual Disk
When you change the warning threshold percent and repository full policy, you can apply the changes to one or several snapshot virtual disks. The following example uses the set (snapshot) virtualDisk command to change these properties on more than one snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisks [\"Mars_Spirit_4-1\"...
Page 75: Re-Creating A Snapshot Virtual Disk
NOTE: Removing the drive letter of the associated virtual disk in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the drive for the Snapshot. Before re-creating a snapshot virtual disk, both the server and the associated virtual disk you are re‑creating have to be in the proper state.
Page 77: Using The Virtual Disk Copy Feature
NOTE: If you ordered Premium Features for Virtual Disk Copy, you received a Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature. For more information, see "Premium Feature —...
Page 78: Creating A Virtual Disk Copy
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 snapshot image, the snapshot image is deleted and the snapshot virtual disk is disabled. NOTE: You can have a maximum of eight virtual disk copies in progress at one time. If you try to create more than eight virtual disk copies at one time, the RAID controller modules return a status of Pending until one of the virtual disk copies that is in progress finishes and returns a status of Complete.
Page 79: Enabling The Virtual Disk Copy Feature
You can have a maximum of eight virtual disk copies in progress at one time. Any virtual disk copy greater than eight has a status of Pending until one of the virtual disk copies with a status of In Progress completes.
Page 80: Copying The Virtual Disk
NOTE: Removing the drive letter of the associated virtual disk(s) in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the drive for the virtual disk copy. Before creating a virtual disk copy, both the server and the associated virtual disk you are copying have to be in the proper state.
Page 81: Viewing Virtual Disk Copy Properties
The command in this example copies the data from the source virtual disk named Jaba_Hut to the target virtual disk named Obi_1. Setting the copy priority to medium provides a compromise between the following storage array operations: • The speed with which the data is copied from the source virtual disk to the target virtual disk •...
Page 82: Changing Virtual Disk Copy Settings
Changing Virtual Disk Copy Settings The set virtualDiskCopy command enables you to change the property settings for a virtual disk copy pair. Using this command, you can change the following items: • Copy priority • Read/write permission for the target virtual disk Copy priority has five relative settings, which range from highest to lowest.
Page 83: Recopying A Virtual Disk
Recopying A Virtual Disk CAUTION: The recopy virtualDiskCopy command overwrites existing data on the target virtual disk and makes the target virtual disk read‑only to hosts. The recopy virtualDiskCopy command fails all snapshot virtual disks associated with the target virtual disk, if any exist. Using the recopy virtualDiskCopy command, you can create a new virtual disk copy for a previously defined copy pair that has a status of Stopped, Failed, or Completed.
Page 84: Recopying The Virtual Disk
Recopying The Virtual Disk After first preparing the host server(s) as specified in the preceding procedure, use the following examples to make a virtual disk copy. The following syntax is the general form of the command: recopy virtualDiskCopy target [targetName] [source [sourceName] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] NOTE: Use one or all of the optional parameters as needed to help define your configuration.
Page 85: Interaction With Other Features
CAUTION: If the virtual disk copy has a status of In Progress, you must stop the virtual disk copy before you can remove the virtual disk copy pair from the storage array configuration. The following syntax is the general form of the command: remove virtualDiskCopy target [targetName] [source [sourceName]] The following example shows a command to remove a virtual disk copy pair: client>smcli 123.45.67.89 -c "remove...
Page 87: Using The Remote Replication Premium Feature
Using The Remote Replication Premium Feature The following types of Remote Replication premium features are supported on the MD storage array: Remote Standard asynchronous replication using point-in-time images to batch the Replication resynchronization between the local and remote site. This type of replication is supported on either Fibre Channel or iSCSI storage arrays (both local and remote arrays must have the same data protocol).
Page 88: Replication Pairs And Replication Repositories
primary virtual disk of the pair are tracked by the RAID controller firmware and captured in a point-in- time image and transferred to the secondary virtual disk in the pair. Remote Replication groups allow you to manage synchronization of both virtual disks to create a consistent data set across local and remote storage arrays.
Page 89: Resynchronization
completion to the primary host. The primary host can continue to write to the primary virtual disk, but remote writes do not take place. When communication is restored between the RAID controller module owner of the primary virtual disk and the RAID controller module owner of the secondary virtual disk, a resynchronization takes place. This resynchronization happens automatically, or it must be started manually, depending on which write mode you chose when setting up the replication relationship.
Page 90: Previous Users Of Remote Replication (Legacy) Premium Feature
• The local storage array serves as the primary side of the Remote Replication group, while the remote storage array serves as the secondary side of the Remote Replication group. • At the virtual disk level, all virtual disks added to the Remote Replication group on the local storage array serve as the primary role in the Remote Replication configuration.
Page 91: Setting Up Remote Replication
In this command, asyncReplication is literal and is appended with the activation_key, which is provided by Dell. For example, if your activation key value is 999999: enable storageArray feature file="asyncReplication999999" Activating The Remote Replication Premium Feature Activating the Remote Replication premium feature prepares the storage arrays to create and configure replication relationships.
Page 92: Adding Primary Virtual Disk To Remote Replication Group
warning will be triggered when the capacity of a replication repository virtual disk reaches 75 percent of capacity (warningThresholdPercent=). create asyncRemoteReplicationGroup userLabel="RRG-001" remoteStorageArrayName="Remote_SS_A101" interfaceType=iSCSI remotePassword="123Dell321" warningThresholdPercent=75; Adding Primary Virtual Disk To Remote Replication Group The add virtualDisk command adds a primary virtual disk to a remote replication group. This command is valid only on the local storage array that contains the remote replication group to which you want to add the primary virtual disk.
Page 93: Adding Secondary Virtual Disk To Remote Replication Group
The full command syntax is shown below: set asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] [syncInterval=integer (minutes | hours | days) warningSyncThreshold=integer (minutes | hours | days) warningRecoveryThreshold=integer (minutes | hours | days) warningThresholdPercent=percentValue autoResync=(TRUE | FALSE) virtualDisk="virtualDiskName" increaseRepositoryCapacity (repositoryVirtualDisk="repos_xxxx" | repositoryVirtualDisk=(diskGroupName [capacity=capacityValue]) repositoryVirtualDisk=(diskPoolName [capacity=capacityValue])) role=(primary| secondary) ([force=TRUE|FALSE]|[noSync=TRUE|FALSE]) Adding Secondary Virtual Disk To Remote Replication Group...
Page 94: Deleting A Remote Replication Group
This example shows the resume remoteReplicationGroup command: resume asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"]; Deleting A Remote Replication Group Use the delete asyncRemoteReplicationGroup command to delete one or more replication groups from the local or remote storage array. The replication group you are attempting to delete must be empty (contain no virtual disks or replicated pairs) before running this command.
Page 95: Interaction With Other Premium Features
Interaction With Other Premium Features You can run the Remote Replication premium feature while running these premium features: • Snapshot—both standard Snapshot and Snapshot (legacy) premium features • Virtual Disk Copy When you run the Remote Replication (legacy) premium feature with other premium features, you must consider the requirements of the other premium features to ensure that you set up a stable storage array configuration.
Page 97: Using The Remote Replication (Legacy) Premium Feature
Using The Remote Replication (Legacy) Premium Feature The Remote Replication (legacy) premium feature provides for online, real-time replication of data between storage arrays over a remote distance. In the event of a disaster or a catastrophic failure on one storage array, you can promote the second storage array to take over responsibility for computing services.
Page 98: Replication Repository Virtual Disks
RAID controller module owner of the primary virtual disk but will not accept host write requests. Hosts are able to read from the secondary virtual disk, which appears as read-only. 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 primary role.
Page 99: Link Interruptions Or Secondary Virtual Disk Errors
write operation to copy the affected data blocks to the secondary virtual disk at the secondary storage array. The Remote Replication (legacy) premium feature provides two write mode options that affect when the I/O completion indication is sent back to the host: Synchronous and Asynchronous. Synchronous Write Mode Synchronous write mode provides the highest level security for full data recovery from the secondary storage array in the event of a disaster.
Page 100: Resynchronization
mode you chose when setting up the replication relationship. During the resynchronization, only the blocks of data that have changed on the primary virtual disk during the link interruption are copied to the secondary virtual disk. After the resynchronization starts, the replicated pair transitions from an Unsynchronized status to a Synchronization in Progress status.
Page 101: Performance Considerations
Determine candidates for a remote replicated pair. Create the remote relationship. Performance Considerations Keep these performance considerations in mind when you create replication relationships: • The RAID controller module owner of a primary virtual disk performs a full synchronization in the background while processing local I/O writes to the primary virtual disk and associated remote writes to the secondary virtual disk.
Page 102 controller module. If you enter a value for the repository storage space that is too small for the replication repository virtual disks, the firmware returns an error message that gives the amount of space needed for the replication repository virtual disks. The command does not try to activate the Remote Replication (legacy) premium feature.
Page 103 This example shows how to use the command in a script file: activate storageArray feature=remoteReplication repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5); Activating The Remote Replication (Legacy) Premium Feature With Software-Assigned Physical Disks With this version of the activate storageArray feature= remoteReplication command, you choose an existing disk group in which to place the replication repository virtual disk.
Page 104: Determining Candidates For A Remote Replicated Pair
Determining Candidates For A Remote Replicated Pair All of the virtual disks and physical disks on the remote storage array might not be available for use as secondary virtual disks. To determine which virtual disks on a remote storage array that you can use as candidates for secondary virtual disks, use the show remoteReplication candidates command.
Page 105: Changing Remote Replication (Legacy) Settings
data on the primary virtual disk as possible. The highest synchronization priority does, however, use more system resources, which can reduce system performance. This example shows how to use the command in a script file: create remoteReplication primary=”Jan_04_Account” secondary=”Jan_04_Account_B” remoteStorageArrayName=”Tabor” remotePassword=”jdw2ga05”...
Page 106: Removing A Replication Relationship
blocks on the primary virtual disk are written to the secondary virtual disk. Full synchronization is not required. NOTE: If you suspend a remote replication that is set up in the Write consistency mode, you suspend all remote replicated pairs within the group. You can then resume replication operations for any of the individual remote replicated pairs that are in the group.
Page 107: Deleting A Primary Virtual Disk Or A Secondary Virtual Disk
To re-establish the link between a primary virtual disk and a secondary virtual disk, use the create remoteReplication command. Deleting A Primary Virtual Disk Or A Secondary Virtual Disk Use the delete virtualDisk command to remove a primary virtual disk or a secondary virtual disk from a storage array.
Page 108: Snapshot Virtual Disks
Snapshot Virtual Disks A snapshot virtual disk is a point-in-time image of a virtual disk. It is typically created so that an application, such as a backup, can access the snapshot virtual disk and read the data while the source virtual disk remains online and accessible to hosts.
Page 109: Virtual Disk Expansion
access to the virtual disk, and any attempt to write to the read-only target virtual disk results in a host I/O error. If you want hosts to have write access to the data on the target virtual disk, use the set virtualDiskCopy command to disable the read-only attribute for the target virtual disk.
Page 111: Maintaining A Storage Array
Maintaining A Storage Array Maintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all hosts. This chapter provides descriptions of command line interface (CLI) and script commands that you can use to perform storage array maintenance. The commands are organized into four sections: •...
Page 112: Running A Consistency Check With A Media Scan
Recovered The physical disk could not read the requested data on its first attempt. media error The result of this action is that the data is rewritten to the physical disk and verified. The error is reported to the MEL. Consistency Consistency errors are found, and a media error is forced on the block stripe so mismatches...
Page 113: Resetting A Raid Controller Module
RAID 0 virtual No redundancy exists. disks NOTE: Do not run consistency checking commands on RAID 0 virtual disks. Before attempting a consistency check, you must enable consistency checking using the set virtualDisk command. Use the following command to set the consistencyCheckEnabled parameter to TRUE: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1...
Page 114: Synchronizing Raid Controller Module Clocks
• Change or delete logical unit number (LUN) mappings on a virtual disk holding a reservation. • Delete virtual disk groups or virtual disks that have any reservations. To determine which virtual disks have reservations, run the following command: show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...
Page 115: Changing Raid Levels
Type of Information Description module pair, regardless if one, both, or neither are selected for monitoring Total I/Os Number of total I/Os performed since the storage array was started Read Percentage Percentage of total I/Os that are read operations (calculate the write percentage by subtracting the read percentage from 100 percent) Cache Hit Percentage Percentage of reads that are fulfilled by data from the cache rather...
Page 116: Defragmenting A Disk Group
performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | <wwid>) segmentSize=segmentSizeValue where, segmentSizeValue is the new segment size you want to set. Valid segment size values are 8, 16, 32, 64, 128, 256, and 512.
Page 117: Creating Ssd Cache
Creating SSD Cache To create ssdCache command SSD read cache: create ssdCache userLabel="ssdCacheName" physicalDisks=(enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn) [updateExistingVirtualDisks=(TRUE|FALSE)] The ssdCacheName parameter names the cache group. Setting the updateExistingVirtualDisks parameter to TRUE enables SSD caching for all virtual disks in the storage array. The following restrictions apply: •...
Page 118: Additional Information About Ssd Cache And Performance Modeling
NOTE: If you reboot a RAID controller module or make configuration changes to any SSD Cache options during the modeling run, no data will be saved. Additional Information About SSD Cache And Performance Modeling For complete description of the SSD Cache feature, see the Administrator's Guide. The following additional SSD cache-related commands are available in this document: •...
Page 119: Recovery Operations
For best results, run all three tests at initial installation. Also, run the tests any time you make changes to the storage array or to components connected to the storage array (such as hubs, switches, and host adapters). A custom data pattern file called diagnosticsDataPattern.dpf is included on the Utility directory of the installation CD.
Page 120: Changing Raid Controller Module Ownership
might significantly reduce performance. The disk groups are automatically transferred back to the preferred RAID controller module when it is placed back online. CAUTION: A multipath driver is required on all hosts and is the only supported configuration. If the multipath driver is not installed, the virtual disks are not accessible. Before you place a RAID controller module in Service mode, ensure that a multipath driver is installed on all hosts using these virtual disks.
Page 121: Initializing A Virtual Disk
Initializing A Virtual Disk CAUTION: When you initialize a virtual disk, all data on the virtual disk and all information about the virtual disk are erased. A virtual disk is automatically initialized when you first create it. If the virtual disk starts exhibiting failures, you might be required to re-initialize the virtual disk to correct the failure condition.
Page 123: Script Commands
Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the current configuration so that you can reinstall it if the changes do not work.
Page 124 • 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 – To indicate which parameters are optional The description of each parameter tells you when you must put brackets around a parameter value. •...
Page 125: Firmware Compatibility Levels
On Microsoft Windows, you must put a backslash (\) before and after the name in addition to other delimiters. For example, the following name is used in a command running under a Windows operating system: [\"Engineering"\] For Linux, and when used in a script file, the name appears as the following: ["Engineering"] When you enter the World Wide Identifier (WWID) of an HBA host port, some usages require quotation marks around the WWID.
Page 126: Host Topology Commands
Start Enclosure Blink Stop Enclosure Blink Host Topology Commands Create Host Create Host Group Create Host Port Create iSCSI Initiator Delete Host Delete Host Group Delete Host Port Delete iSCSI Initiator Set Host Set Host Group Set Host Channel Set Host Port Set iSCSI Initiator Set iSCSI Target Properties Show Host Ports...
Page 127: Raid Controller Module Commands
Set Physical Disk Hot Spare Set Physical Disk Channel Status Set Physical Disk State Show Physical Disk Show Physical Disk Channel Statistics Show Physical Disk Download Progress Start Physical Disk Blink Start Physical Disk Initialize Start Physical Disk Channel Blink Start Physical Disk Channel Fault Isolation Diagnostics Start Physical Disk Reconstruction Start Remote Replication Synchronization...
Page 128: Session Command
Check Storage Array Connectivity Clear Remote Replication Fault Deactivate Remote Replication Deactivate Remote Replication (Legacy) Delete Remote Replication Group Diagnose RAID Controller Module iSCSI Host Cable Establish Remote Replicated Pair Re-Create Remote Replication Repository Virtual Disk Remove Incomplete Remote Replicated Pair from Remote Replication Group Remove Remote Replication Remove Virtual Disk from Remote Replication Group Reset iSCSI IP Address...
Page 129: Ssd Cache Commands
SSD Cache Commands Add Physical Disks to SSD Cache Change SSD Cache Application Type Create SSD Cache Delete SSD Cache Enable or Disable SSD Cache for a Virtual Disk Blink SSD Cache Remove Physical Disks from SSD Cache Rename SSD Cache Resume SSD Cache Show SSD Cache Show SSD Cache Statistics...
Page 130: Virtual Disk Commands
Set Storage Array Set Storage Array Enclosure Positions Set Storage Array ICMP Response Set Storage Array iSNS Server IPv4 Address Set Storage Array iSNS Server IPv6 Address Set Storage Array iSNS Server Listening Port Set Storage Array Learn Cycle Set Storage Array Redundancy Mode Set Storage Array Security Key Set Storage Array Time Set Storage Array Unnamed Discovery Session...
Page 131: Virtual Disk Copy Commands
Virtual Disk Copy Commands Create Virtual Disk Copy Recopy Virtual Disk Copy Remove Virtual Disk Copy Set Virtual Disk Copy Show Virtual Disk Copy Show Virtual Disk Copy Source Candidates Show Virtual Disk Copy Target Candidates Stop Virtual Disk Copy...
Page 133: Commands Listed Alphabetically
Commands Listed Alphabetically Following are the script commands listed alphabetically. Activate Remote Replication Feature NOTE: This command is used to activate both Remote Replication and Remote Replication (Legacy). Description This command creates the replication repository virtual disks and activates the Remote Replication and Remote Replication (legacy) premium features.
Page 134 Parameters Parameter Description The RAID level for the replication repository virtual repositoryRAIDLevel disk. Valid values are 0, 1, 5, or 6. The physical disks for the replication repository repositoryPhysicalDisks virtual disk. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you assign to the replication repository virtual disk.
Page 135: Activate Storage Array Firmware
Notes The repositoryPhysicalDisks parameter supports both high-capacity expansion enclosures and low-capacity expansion enclosures. A high-capacity expansion enclosure has drawers that hold the physical disks. The drawers slide out of the expansion enclosure to provide access to the physical disks. A low-capacity expansion enclosure does not have drawers.
Page 136: Add Member To Consistency Group
Syntax activate storageArray firmware Parameters None Add Member To Consistency Group Description This command adds a new base virtual disk as a member to a an existing consistency group. You can specify an existing repository virtual disk for the new consistency group member, or create a new repository virtual disk.
Page 137 Parameter Description If the specified virtual disk is an existing repository virtual disk or an existing snapshot virtual disk, the command fails. This parameter performs two functions: repositoryVirtualDisk • In an existing consistency group that has a repository virtual disk, this parameter identifies the repository virtual disk.
Page 138: Add Physical Disks To Ssd Cache
You can place the repository virtual disk in a disk group or a disk pool of your choosing. You are not required to have the repository virtual disk in the same location as other repository virtual disks. To place the repository virtual disk in a disk group or a disk pool of your choice, use the repositoryVirtualDisk parameter and identify the disk group or the disk pool and a size for the repository virtual disk.
Page 139: Add Virtual Disk To Remote Replication Group
Notes The SSD cache can contain any number of SSDs. The maximum size of the SSD cache is 5 TB, but might be less depending on the size of the RAID controller module’s primary cache. Add Virtual Disk To Remote Replication Group Description This command adds a primary virtual disk to a remote replication group.
Page 140: Autoconfigure Storage Array
Parameter Description • The term repos. • A four digit numerical identifier that you assign to the repository virtual disk name. Enclose the name of the existing repository virtual disk in double quotation marks (" "). If you want to create a new repository virtual disk when you run this command you must enter the name of either a disk group or a disk pool in which you want the repository virtual disk.
Page 141 hotSpareCount=numberOfHotSpares segmentSize=segmentSizeValue cacheReadPrefetch=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description physicalDiskType Type of physical disks to use for the storage array. Valid physical disk type is Serial Attached SCSI (SAS). This parameter is not required if only one type of physical disk is in the storage array.
Page 142: Autoconfigure Storage Array Hot Spares
Parameter Description • enabled—The disk group and virtual disks have security enabled. Autoconfigure Storage Array Hot Spares Description This command automatically defines and configures the hot spares in a storage array. You can run this command at any time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters...
Page 143: Cancel Remote Replication Group Role Reversal
Cancel Remote Replication Group Role Reversal Description This command cancels a pending role reversal operation between remote replication groups. Syntax stop asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] rolechange Parameter Parameter Description The name of the remote replication group for asyncRemoteReplicationGroup which you want to cancel the pending role reversal operation.
Page 144: Check Remote Replication Status
Parameter Description cache. Valid values are webServer, dataBase, or fileSystem. Check Remote Replication Status NOTE: This command valid only with Fibre Channel storage arrays. Description This command returns the status of a remote replication virtual disk. Use this command to determine when the status of the remote replication virtual disk becomes Optimal.
Page 145: Check Repository Consistency
Parameters Parameter Description The alphanumeric identifier (including - and _) of asyncRemoteReplicationGroup the remote replication group on which to run a consistency check. Enclose the remote replication group identifier in square brackets ([ ]). Specifies the alphanumeric identifier of a local localVirtualDisk virtual disk that participates in the replication relationship.
Page 146: Check Storage Array Connectivity
Parameter Description check. Enclose the snapshot group identifier in square brackets ([ ]). The alphanumeric identifier (including - and _) of snapVirtualDisk the snapshot virtual disk on which to run a consistency check. Enclose the snapshot virtual disk identifier in square brackets ([ ]). The alphanumeric identifier (including - and _) of virtualDisk the thin virtual disk on which to run a consistency...
Page 147: Check Virtual Disk Consistency
Parameters Parameter Description The name for the remote storage array for which remoteStorageArrayName you are checking connectivity. Enclose the storage array name in double quotation marks (" "). The World Wide Identifier (WWID) of the storage remoteStorageArrayNameWwid array for which you are checking connectivity. You can use the WWID instead of the storage array name to identify the storage array.
Page 148: Clear Physical Disk Port Statistics
Parameter Description special characters, you must also put quotation marks (" ") around the virtual disk name. Name of the file in which to save the consistency consistencyErrorFile error information. You must put quotation marks (" ") around the file name. Name of the file in which to save the media error mediaErrorFile information.
Page 149: Clear Remote Replication Fault
Clear Remote Replication Fault Description This command clears a remote replication "sticky" fault from one or more remote replication groups and one or more remote replication group member virtual disks. A remote replication group and its member virtual disks can encounter remote replication "sticky" faults, which occur at a single point-in-time but do not impact the functionality of the replications.
Page 150: Clear Storage Array Configuration
Parameter Description clear the remote replication fault. Enclose the member virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" ") inside square brackets. If the virtual disk name consists only of numbers, such as "1002,"...
Page 151: Clear Storage Array Core Dump
Parameter Description information returns the storage array to its initial state. The setting to remove the virtual disk configuration diskGroups and the disk group configuration. The rest of the configuration stays intact. NOTE: When you run this command, the storage array becomes unresponsive, and all script processing is cancelled.
Page 152: Clear Storage Array Firmware Pending Area
Parameters None. Clear Storage Array Firmware Pending Area Description This command deletes a previously downloaded firmware image or nonvolatile static random access memory (NVSRAM) values from the pending area buffer. CAUTION: As soon as you run this command, the contents of the existing pending area in the storage array are deleted.
Page 153: Clear Virtual Disk Unreadable Sectors
Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1... virtualDiskNameN]) reservations Parameters Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which to clear reservations. You can enter more than one virtual disk name.
Page 154: Configure Automatic Support Bundle Collection
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Configure Automatic Support Bundle Collection Description This command enables or disables the automatic collection of support bundles on one or more storage...
Page 155: Create Consistency Group
Parameter Parameter Description The alphanumeric identifier (including - and _) of baseVirtualDisk the base virtual disk that has the snapshots (legacy) that you want to convert into a snapshot group. Enclose the base virtual disk name in double quotation marks (" "). Create Consistency Group NOTE: This command does not apply to the snapshot (legacy) commands.
Page 156 Parameter Description selected to purge the snapshot images for a repository full policy. The default value is 32. Whether the ability to schedule a snapshot enableSchedule operation is turned on or turned off. To turn on snapshot scheduling, set this parameter to TRUE. To turn off snapshot scheduling, set this parameter to FALSE.
Page 157: Create Consistency Group Snapshot Image
successfully for all of the consistency group members, the operation fails and has no affect (that is, new snapshot images are not created). Based on this behavior all members for a consistency group usually have the same number of PiTs. However, when a new member is added to a consistency group, that new member lacks the snapshot images that were previously created on the established members of the consistency group.
Page 158: Create Consistency Group Snapshot Virtual Disk
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.
Page 159 Parameter Description When you do not use the members parameter, all of the members are automatically added to the new consistency group snapshot virtual disk. The percentage of repository capacity at which the repositoryFullLimit consistency group snapshot repository virtual disk is nearing full.
Page 160: Create Consistency Group Snapshot Virtual Disk Mapping
• 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"...
Page 161: Create Disk Group
Create Disk Group Description This command creates either a free-capacity disk group or a disk group with one virtual disk when you enter a set of assigned physical disks. Syntax create diskGroup physicalDisks=(enclosureID1,drawerID1,slotID1 enclosureID2,slotID2... enclosureIDn,drawerIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6) userLabel=”diskGroupName”...
Page 162 Parameter Description The type of physical disk that you want to use in the virtual disk. physicalDiskType You cannot mix physical disk types. The valid physical disk type is SAS. You must specify a physical disk type. The size of the virtual disk that you are adding to the storage capacity array.
Page 163 Parameter Description • enabled—The disk group and virtual disks have security enabled. Additional Information Cache Read Prefetch The cacheReadPrefetch command lets the RAID controller module copy additional data blocks into cache while the RAID controller module reads and copies data blocks that are requested by the host from the physical disks into cache.
Page 164: Create Disk Pool
• create storageArray securityKey • set storageArray securityKey • start secureErase (physicalDisk | physicalDisks) • enable diskGroup [diskGroupName] security Enclosure Loss Protection and Drawer Loss Protection For enclosure loss protection to work, each physical disk in a disk group must be in a separate enclosure. If you set the enclosureLossProtect parameter to TRUE and have selected more than one physical disk from any one enclosure, the storage array returns an error.
Page 165 Parameters Parameter Description The physical disks you want to assign to the disk physicalDisks pool. Enclosure ID values are 0 to 99; drawer ID values are 0 to 4; slot ID values are 0 to 31. NOTE: A disk pool must contain at least 11 physical disks.
Page 166: Create Host
Parameter Description • enabled—The virtual disk candidates have security enabled. The default value is none. You must use this parameter when you have more physicalDiskMediaType than one type of physical disk media in your storage array. Valid physical disk media are: •...
Page 167: Create Host Group
[hostType=(hostTypeIndexLabel | hostTypeIndexNumber)] Parameters Parameter Description The name that you want to give the host that you are creating. userLabel Enclose the host name in double quotation marks (“ ”). The name of the host group in which you want to create a new hostGroup host.
Page 168: Create Iscsi Initiator
Syntax create hostPort identifier="wwid" userLabel="portLabel" host="hostName" interfaceType=SAS Parameters Parameter Description WWID of the HBA host port. You must put identifier quotation marks (" ") around the WWID. Name to give the new HBA host port. You must put userLabel quotation marks (" ") around the port label. Name of the host for which you are defining an host HBA host port.
Page 169: Create Raid Virtual Disk (Automatic Physical Disk Select)
Parameters Parameter Description The default identifier of the iSCSI initiator. iscsiName The name that you want to use for the iSCSI initiator. Enclose the userLabel name in double quotation marks (" "). The name of the host in which the iSCSI initiator is installed. host The password that you want to use to authenticate a peer chapSecret...
Page 170 Parameter Description NOTE: The physicalDiskCount parameter enables you to choose the number of physical disks to use in the disk group. You do not need to specify the physical disks by enclosure ID and slot ID. The RAID controller modules choose the specific physical disks to use for the disk group.
Page 171: Create Raid Virtual Disk (Free Capacity Base Select)
Parameter Description information about the enclosureLossProtect parameter, see Enclosure Loss Protection. The setting to enforce drawer loss protection when you create drawerLossProtect the replication repository disk group. To enforce drawer loss protection, set this parameter to TRUE. The default value is FALSE.
Page 172 Parameter Description NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation.
Page 173: Create Raid Virtual Disk (Manual Physical Disk Select)
Parameter Description The setting to turn on or turn off cache read cacheReadPrefetch prefetch. To turn on cache read prefetch, set this parameter to TRUE. To turn off cache read prefetch, set this parameter to FALSE. Amount of data (in kilobytes) that the RAID segmentSize controller module writes on a single physical disk in a virtual disk before writing data on the next...
Page 174 Syntax create virtualDisk physicalDisks (enclosureID1,drawerID1,slotID1 enclosureID2,slotID2... enclosureIDn,drawerIDn,slotIDn) [diskGroupUserLabel=[diskGroupName]] raidLevel=(0 | 1 | 5 | 6) userLabel=”virtualDiskName” [capacity=virtualDiskCapacity owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia) enclosureLossProtect=(TRUE | FALSE) drawerLossProtect=(TRUE | FALSE) dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description...
Page 175 Parameter Description Name that you want to give the new virtual disk. userLabel You must put quotation marks (" ") around the new virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed.
Page 176: Create Raid Virtual Disk On A Disk Pool
Parameter Description should be the default values. The default values are based on the typical I/O usage pattern of the application that is using the virtual disk. Valid values are fileSystem, dataBase, or multiMedia. The setting to make sure that reserve capacity is dssPreAllocate allocated for future segment size increases.
Page 177 Parameter Description Size is defined in units of MB, GB, or TB. The following are examples of the syntax: • capacity=500MB • capacity=2GB This parameter enables thin provisioning for the thinProvisioned new virtual disk. To use thin provisioning, set this parameter to TRUE.
Page 178: Create Read-Only Snapshot Virtual Disk
Create Read-Only Snapshot Virtual Disk Description This command creates a read-only snapshot virtual disk for the snapshot images of a base virtual disk. To change a read-only snapshot virtual disk to a read/write virtual disk, use the set snapVirtualDisk convertToReadWrite command. NOTE: You cannot use this command for a snapshot image that is used in online virtual disk copy.
Page 179: Create Remote Replication
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. The identifier of a snapshot image has two parts separated by a colon (:): •...
Page 180 Parameter Description The name of the remote storage array. Enclose the remoteStorageArrayName remote storage array name in double quotation marks (“ ”). The World Wide Identifier (WWID) of the remote remoteStorageArrayWwn storage array. Enclose the WWID in double quotation marks (“ ”). The password for the remote storage array.
Page 181: Create Remote Replication Group
priority level is selected, the data synchronization uses the most system resources to perform the full synchronization, which decreases performance for host data transfers. The writeOrder parameter applies only to asynchronous replications and makes them become part of a consistency group. Setting the writeOrder parameter to preserved causes the remote replication pair to transmit data from the primary virtual disk to the secondary virtual disk in the same order as the host writes to the primary virtual disk.
Page 182 Parameter Description replication group name in double quotation marks (" "). The name must be unique on the local and remote storage arrays. The name for the remote storage array on which remoteStorageArrayName you are replicating the remote replication group. Enclose the storage array name in double quotation marks ("...
Page 183: Create Snapshot Group
Parameter Description NOTE: You must set the Recovery Point Threshold to be twice as large as the synchronization interval threshold. Specify the length of time to wait until a warning is warningThresholdPercent triggered when the capacity of a replication repository virtual disk reaches the defined percentage.
Page 184 repository virtual disk that is used to save data for all of the snapshot images that are part of the snapshot group. Syntax create snapGroup userLabel="snapGroupName" sourceVolume="virtualDiskName" repositoryVirtualDisk="repos_xxxx" [repositoryFullPolicy=(failBaseWrites | purgeSnapImages) | rollbackPriority=(high | highest | medium | low | lowest) | repositoryFullLimit=percentValue | autoDeleteLimit=numberOfSnapImages] Parameters...
Page 185 Parameter Description The percentage of repository capacity at which repositoryFullLimit you receive a warning that the snapshot image repository virtual disk is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 75. The maximum number of snapshot images that autoDeleteLimit you want to automatically delete if you have...
Page 186: Create Snapshot Image
Over Threshold The snapshot group repository virtual disk usage is at or beyond its alert threshold. Any snapshot group in this state causes a Needs-Attention condition to be posted for the storage array. Failed The snapshot group has encountered a problem that has made all snapshot images in the snapshot group unusable.
Page 187: Create Snapshot (Legacy) Virtual Disk
Create Snapshot (Legacy) Virtual Disk Description This command creates a snapshot virtual disk. When you use this command, you can define the snapshot virtual disk in one of three ways: • User-defined physical disks • User-defined disk group • User-defined number of physical disks for the snapshot virtual disk If you choose to define a number of physical disks, the RAID controller module firmware chooses which physical disks to use for the snapshot (legacy) virtual disk.
Page 188 enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule)] Parameters Parameter Description The name of the base virtual disk from which you baseVirtualDisk want to take a snapshot (legacy). Enclose the base virtual disk name in double quotation marks (" "). Use this parameter when you create a new disk repositoryRAIDLevel group.
Page 189 Parameter Description virtual disk. To enforce enclosure loss protection, set this parameter to TRUE. The default setting is FALSE. The type of physical disk media that you want to physicalMediaType use for the disk group. Valid physical disk media consists of: •...
Page 190 Parameter Description The size of the snapshot (legacy) repository virtual repositoryPercentOfSource disk as a percentage of the source virtual disk. Use integer values. For example, a value of 40 means 40 percent. The default value is 20. The name to give to the snapshot (legacy) repositoryUserLabel repository virtual disk.
Page 191: Enclosure Loss Protection
the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk. For example, if you have a base virtual disk with a name of Engineering Data, the snapshot (legacy) virtual disk can have a name of Engineering Data-S1, and the snapshot (legacy) repository virtual disk can have a name of EngineeringData- R1.
Page 192: Create Snapshot Virtual Disk
The time of a day you want to create a snapshot (legacy) virtual disk and start startTime 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.
Page 193 NOTE: You cannot use this command for a snapshot image that is used in online virtual disk copy. Syntax create snapVirtualDisk userLabel="snapVirtualDiskName" snapImageID="snapImageID" [repositoryVirtualDisk="repos_xxxx" | repositoryFullLimit=percentValue] Parameters Parameter Description The alphanumeric identifier (including - and _) that userLabel you want to give to a snapshot virtual disk. Enclose the snapshot virtual disk name in double quotation marks ("...
Page 194: Create Ssd Cache
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. The identifier of a snapshot image has two parts separated by a colon (:): •...
Page 195: Create Storage Array Security Key
Parameter Description (#) for the identifier. Identifiers can have a maximum of 30 characters. The physical disks that you want to use to create physicalDisks the SSD cache. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you want to assign to the SSD cache.
Page 196 file=fileName | commitSecurityKey=(TRUE | FALSE) Parameters Parameter Description A character string that you can read that is a keyIdentifier wrapper around a security key. A character string that encrypts the security key so passPhrase that you can store the security key in an external file.
Page 197: Create Virtual Disk Copy
• The pass phrase must be between eight and 32 characters long. • The pass phrase must contain at least one uppercase letter. • The pass phrase must contain at least one lowercase letter. • The pass phrase must contain at least one number. •...
Page 198 Parameters Parameter Description Name of an existing virtual disk to use as the source source virtual disk. You must put quotation marks (" ") around the source virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names.
Page 199: Deactivate Remote Replication (Legacy)
Parameter Description snapshot (legacy), set this parameter to online. To create a virtual disk copy without a snapshot (legacy), set this parameter to offline. If this parameter is not used, the virtual disk copy is created without a snapshot (legacy). Deactivate Remote Replication (Legacy) NOTE: This command valid only with Fibre Channel storage arrays.
Page 200: Delete Consistency Group Snapshot Image
Parameter Description characters, you must enclose the snapshot consistency group name in double quotation marks (" "). The setting to delete on or retain the repository deleteRepositoryMembers virtual disks. To delete the repository virtual disks, set this parameter to TRUE. To retain the repository virtual disks, set this parameter to FALSE.
Page 201: Delete Consistency Group Snapshot Virtual Disk
Parameter Description the snapshot virtual disk, set this parameter to FALSE. The default value is FALSE. Notes If the snapshot images cannot be deleted for all of the relevant consistency groups, the operation fails and none of the snapshot images are deleted. When you delete a consistency group snapshot image that is associated with a consistency group snapshot virtual disk, the corresponding snapshot virtual disk member in the consistency group snapshot virtual disk transition to the Stopped state.
Page 202: Delete Disk Pool
Syntax delete diskGroup [diskGroupNumber] Parameter Parameter Description Number of the disk group to delete. You must put diskGroup brackets ([ ]) around the disk group number. Delete Disk Pool Description This command deletes a disk pool. Syntax delete diskPool [diskPoolName] Parameter Parameter Description...
Page 203: Delete Host Group
Parameter Parameter Description Name of the host to delete. You must put brackets host ([ ]) around the host name. If the host name has special characters, you must also put quotation marks (" ") around the host name. NOTE: A host is a system that is attached to the storage array and accesses the virtual disks on the storage array through its HBA host ports.
Page 204: Delete Iscsi Initiator
Syntax delete hostPort [hostPortName] Parameter Parameter Description Name of the HBA host port to delete. You must put hostPort brackets ([ ]) around the name of the HBA host port. NOTE: An HBA host port is a physical connection on a host bus adapter that resides within a host system.
Page 205: Delete Snapshot Group
Delete Snapshot Group CAUTION: Possible damage to the storage array configuration – All of the data in the snapshot group is lost as soon as you run this command. Description This command deletes an entire snapshot group and optionally the associated member virtual disks. Syntax delete snapGroup ["snapGroupName"] [deleteRepositoryMembers=(TRUE | FALSE)
Page 206 (deleteCount=numberOfSnapshotImages | retainCount=numberOfSnapshotImages | ignoreSnapVirtualDisk=(TRUE | FALSE) | snapImageID=OLDEST) Parameters Parameter Description snapGroup or snapGroups The name of the snapshot group that has the snapshot image that you want to delete. Enclose the name of the snapshot group in double quotation marks ("...
Page 207: Delete Snapshot (Legacy) Virtual Disk
Parameter Description The snapImageID parameter accepts only the snapImageID OLDEST option. This parameter deletes the earliest snapshot image created. Notes You can delete the oldest snapshot image from a snapshot group repository virtual disk. The definition of a snapshot image that you delete is removed from the system. The space occupied by the snapshot image that you delete from the snapshot group repository virtual disk is released and made available for reuse within the snapshot group.
Page 208: Delete Snapshot Virtual Disk
Delete Snapshot Virtual Disk Description This command deletes a snapshot virtual disk and optionally the associated snapshot repository members. NOTE: You cannot use this command for snapshot images involved in online virtual disk copy. Syntax delete snapVirtualDisk ["snapVirtualDiskName"] [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter Description...
Page 209: Delete Ssd Cache
Parameters Parameter Description virtualDisk or virtualDisks The name of the snapshot virtual disk to delete. You can enter more than one snapshot virtual disk name. Enclose the snapshot virtual disk name in square brackets ([ ]). If the snapshot virtual disk name has special characters, you must also enclose the snapshot virtual disk name in double quotation marks ("...
Page 210: Delete Virtual Disk On A Disk Pool
Syntax delete (allVirtualDisks | virtualDisk [virtualDiskName] |virtualDisks [virtualDiskName1... virtualDiskNameN]) removeDiskGroup=(TRUE | FALSE) Parameters Parameter Description Deletes all virtual disks in a storage array. allVirtualDisks NOTE: Using the allVirtualDisks parameter deletes virtual disks until all are removed or until an error is encountered. If an error is encountered, this command does not attempt to delete the remaining virtual disks.
Page 211: Diagnose Raid Controller Module
Parameters Parameter Description This parameter deletes all of the virtual disks on a allVirtualDisks disk pool. virtualDisk or virtualDisks The name of the virtual disk that you want to delete. You can enter more than one virtual disk name. Enclose the virtual disk name in square brackets ([ ]).
Page 212 The testID parameter takes the following options, which you can use to verify that a RAID controller module is functioning correctly: • 1 — Reads the test • 2 — Performs a data loop-back test • 3 — Writes the test The diagnostic tests consist of loop-back tests in which data is written to physical disks and read from the physical disks.
Page 213: Diagnose Raid Controller Module Iscsi Host Cable
Diagnose RAID Controller Module iSCSI Host Cable Description NOTE: This command valid only for the PowerVault MD3600i storage array. This command runs diagnostic tests on the copper cables between the iSCSI Host interface cards and a RAID controller module. You can run diagnostics on a selected port or all ports. The ports must be able to support the cable diagnostics.
Page 214: Diagnose Remote Replication
Parameter Description Specifies the identifier for the diagnostic test you testID want to run. For this diagnostic test, the value is cableDiagnostics. Notes When you run the cable diagnostic test, the firmware returns the following information: • Port: The port on which the diagnostic test was run. •...
Page 215: Disable Storage Array Feature
Parameter Parameter Description primary or primaries The name of the primary virtual disk of the remote replication pair to be tested. More than one primary virtual disk name can be entered. Enclose the primary virtual disk names in square brackets ([ ]).
Page 216: Display Support Bundle Collection Schedule
NOTE: This command must be run from the command line. It cannot be run in the MD Storage Manager script editor. Syntax supportBundle auto show Parameters None. Display Support Bundle Collection Schedule Description This command displays the schedule for collecting support bundles for all storage arrays. NOTE: This command must be run from the command line.
Page 217: Download Physical Disk Firmware
Parameter Description • The enclosure parameter, which downloads new firmware to a specific EMM. If you need to download new firmware to more than one EMM, but not all RAID controller modules, you must enter this command for each storage array.
Page 218: Download Storage Array Firmware/Nvsram
Parameters Parameter Description Physical disk to which to download the firmware physicalDisk image. Specify the enclosure ID and slot ID for the physical disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value.
Page 219: Download Storage Array Physical Disk Firmware
Parameter Description downgrade to TRUE if you want to download an earlier version of firmware. Activates the firmware and NVSRAM images. The activateNow default value is TRUE. If you set activateNow to FALSE, you must use the activate storageArray firmware command to activate the firmware and NVSRAM values at a later time.
Page 220: Download Storage Array Nvsram
Download Storage Array NVSRAM Description This command downloads NVSRAM values for the storage array RAID controller module. Syntax download storageArray NVSRAM file="filename" [healthCheckMelOverride=(TRUE | FALSE)] Parameter Parameter Description file The file path and the file name that contains the NVSRAM values. Enclose the NVSRAM file name in double quotation marks ("...
Page 221: Enable Disk Pool Security
Parameter Parameter Description The alphanumeric identifier (including - and _) of diskGroup the disk group that you want to place in the Security Enabled state. Enclose the disk group identifier in square brackets ([ ]). Additional Information To successfully run this command, the following conditions must be met: •...
Page 222: Enable Or Disable Ssd Cache For A Virtual Disk
Enable Or Disable SSD Cache For A Virtual Disk Description This command turns on or off caching using the SSD cache feature for a specific virtual disk. The virtual disk can be either a standard virtual disk, a snapshot virtual disk, or a consistency group snapshot virtual disk.
Page 223: Enable Storage Array Feature
Parameter Parameter Description RAID controller module that you want to revive. controller Valid RAID controller module identifier values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure.
Page 224: Establish Remote Replicated Pair
Establish Remote Replicated Pair Description Use this command to complete a remote replicated pair on the remote storage array by adding a secondary virtual disk to an existing remote replication group. Before you run this command, the remote replication group must exist and the primary virtual disk must exist in the remote replication group. After this command successfully completes, remote replication starts between the primary virtual disk and the secondary virtual disk.
Page 225: Increase Virtual Disk Capacity On A Disk Pool
Increase Virtual Disk Capacity On A Disk Pool Description This command defines the properties for a virtual disk. You can use most parameters to define properties for one or more virtual disks. You also can use some parameters to define properties for only one virtual disk.
Page 226 file can be just RAID configuration data or all data, including data for RAID configuration, disk groups and disk pools. The data in a cache location always includes all data. Before using this command with the file option, you must first obtain a validator string (a security code) from your Technical Support representative.
Page 227: Modify Disk Pool
Parameter Description • If the parameter is set to all, all of the data including disk pool configuration data is retrieved. The default is raidConfiguration. Notes Depending on the size of the database image, restoring the database might take up to 30 minutes. The host software does not show the controllers in an optimal state till all actions for loading the database image are completed on the controllers.
Page 228: Recopy Virtual Disk Copy
Recopy Virtual Disk Copy Description This command reinitiates a virtual disk copy operation by using an existing virtual disk copy pair. NOTE: See Preparing Host Servers To Recopy A Virtual Disk. CAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and (if applicable, the target disk) to ensure that you capture an accurate point-in-time image of the source virtual disk.
Page 229: Re-Create Remote Replication Repository Virtual Disk
Parameter Description NOTE: CopyPriority defines the amount of system resources used to copy the data between the source and target virtual disks of a virtual disk copy pair. If you select the highest priority level, the virtual disk copy uses the most system resources to perform virtual disk copy, which decreases performance for host data transfers.
Page 230 User-Defined Disk Group recreate storageArray replicationRepository repositoryDiskGroup=diskGroupName [freeCapacityArea=freeCapacityIndexNumber] User-Defined Number of Drives recreate storageArray replicationRepository repositoryRAIDLevel=(1 | 5 | 6) repositoryPhysicalDiskCount=numberOfPhysicalDisks [enclosureLossProtect=(TRUE | FALSE)] Parameters Parameter Description The RAID level for the replication repository virtual repositoryRAIDLevel disk. Valid values are 1, 5, or 6. The physical disks for the replication repository repositoryPhysicalDisks virtual disk.
Page 231: Re-Create Snapshot
Notes If a value is entered for the repository storage space that is too small for the replication repository virtual disks, the RAID controller module firmware returns an error message that indicates the amount of space needed for the replication repository virtual disks. The command does not try to change the replication repository virtual disk.
Page 232 Parameter Description virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Name of the snapshot virtual disk. You must put userLabel quotation marks (" ") around the snapshot virtual disk name. If you enter more than one snapshot virtual disk name, this command fails.
Page 233: Reinitialize Thin Virtual Disk
NOTE: If the warningThresholdPercent parameter or the repositoryFullPolicy parameter is not specified, the previously set values are used. If you use the optional parameters, the re-create snapshot processes each snapshot virtual disk separately. If the same userLabel (name) is specified for more than one virtual disk, the command fails.
Page 234: Remove Incomplete Remote Replicated Pair From Remote Replication Group
Parameter Description • The old repository virtual disk will be deleted by default. Use this parameter to allocate a new repository diskPoolUserLabel virtual disk with the specified capacity. If this parameter is set to TRUE, the old repository retainRepositoryMember is retained. By default, the old repository is deleted. This parameter is ignored if the existing repository is reused.
Page 235: Remove Member Virtual Disk From Consistency Group
Remove Member Virtual Disk From Consistency Group Description This command removes a member virtual disk from a an existing snapshot consistency group. Optionally, you can delete the repository virtual disk members from the consistency group. Syntax set consistencyGroup ["consistencyGroupName"] removeCGMemberVirtualDisk=memberName [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter...
Page 236: Remove Remote Replication
Parameter Description the identifier in double quotation marks (" ") inside square brackets. The physical disks that you want to remove from removePhysicalDisks the SSD cache. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each SSD that you want to remove.
Page 237: Remove Virtual Disk Copy
Remove Virtual Disk Copy Description This command removes a virtual disk copy pair. Syntax remove virtualDiskCopy target [targetName] [source [sourceName]] copyType=(online | offline) Parameters Parameter Description Name of the target virtual disk to remove. You target must put brackets ([ ]) around the target virtual disk name.
Page 238: Remove Virtual Disk Lun Mapping
Parameters Parameter Description The name of the specific virtual disk that you want virtualDisk to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" ") inside square brackets ([ ]). The name of the remote replication group that asyncRemoteReplicationGroup contains the member virtual disk that you want to remove.
Page 239: Rename A Snapshot Virtual Disk
Parameter Description CAUTION: The host agent uses the access virtual disks to communicate in-band with a storage array. If you remove an access virtual disk mapping for a storage array from a host that has an agent running on it, the storage management software is no longer able to manage the storage array through the in- band agent.
Page 240: Rename Ssd Cache
Rename SSD Cache Description This command changes the name of the SSD cache. Syntax set ssdCache [old_ssdCacheName] userLabel="new_ssdCacheName" Parameters Parameter Description The alphanumeric identifier (including - and _) of ssdCache the SSD cache that you want to rename. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks ("...
Page 241: Replace Physical Disk
Parameter Description special characters, you must also put quotation marks (" ") around the virtual disk name. Name of the file that contains the consistency consistencyErrorFile error information you use to repair the errors. You must put quotation marks (" ") around the file name.
Page 242: Reset Iscsi Ip Address
Parameter Description to the virtual disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. Reset iSCSI IP Address Description This command resets the IP address for the remote storage array to re-establish connection with the local storage array.
Page 243: Reset Remote Replication Group Statistics
NOTE: When you reset a RAID controller module, the RAID controller module is not available for I/O operations until the reset is complete. If a host is using virtual disks owned by the RAID controller module being reset, the I/O directed to the RAID controller module is rejected. Before resetting the RAID controller module, either verify that the virtual disks owned by the RAID controller module are not in use or ensure a multipath driver is installed on all hosts using these virtual disks.
Page 244 Parameters Parameter Description The name of the remote replication group for asyncRemoteReplicationGroup which you are resetting the synchronization statistics. Enclose the remote replication group name in square brackets ([ ]). If the remote replication group name has special characters, you also must enclose the remote replication group name in double quotation marks ("...
Page 245: Reset Storage Array Battery Install Date
• Recovery point age Reset Storage Array Battery Install Date Description This command resets the age of the batteries in a storage array to zero days. You can reset the batteries for an entire storage array or just the battery for a specific RAID controller module or in a specific battery pack.
Page 246: Reset Storage Array Sas Phy Baseline
Example -c "reset storageArray iscsiStatsBaseline;" Reset Storage Array SAS PHY Baseline Description This command resets the SAS physical layer (SAS PHY) baseline for all devices except physical disks, and removes the list of errors from the .csv file. The .csv file is generated by running the save storageArray SASPHYCounts command.
Page 247 Syntax resume cgSnapVirtualDisk ["snapVirtualDiskName"] cgSnapImage="snapImageName" Parameters Parameter Description The name of the consistency group snapshot cgSnapVirtualDisk virtual disk for which you want to restart a rollback operation. Enclose the name of the consistency group snapshot virtual disk in double quotation marks ("...
Page 248: Resume Remote Replication
Resume Remote Replication Description NOTE: This command valid only with Fibre Channel storage arrays. This command resumes a suspended Remote Replication operation. Syntax resume remoteReplication (primary [virtualDiskName] | primaries [virtualDiskName1 ... virtualDiskNameN]) [writeConsistency=(TRUE | FALSE)] Parameters Parameter Description The name of the primary virtual disk for which you primary or primaries want to resume operation.
Page 249: Resume Snapshot Image Rollback
Syntax resume asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] [deleteRecoveryPointIfNecessary] Parameter Parameter Description The name of the remote replication group for asyncRemoteReplicationGroup which you want to start synchronization. Enclose the remote replication group name in double quotation marks (" ") inside square brackets ([ ]"). The parameter to delete the recovery point if the deleteRecoveryPointIfNecessary recoverable synchronization data has exceeded...
Page 250: Resume Snapshot (Legacy) Rollback
Parameter Description • NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group. • OLDEST - Use this option when you want to show the earliest snapshot image created in the snapshot group.
Page 251: Resume Snapshot Virtual Disk
Parameter Description (legacy) virtual disk name has special characters, you must also enclose the snapshot (legacy) virtual disk name in double quotation marks (" "). Resume Snapshot Virtual Disk Description This command resumes a snapshot virtual disk operation that was stopped. Syntax resume snapVirtualDisk [snapVirtualDiskName] snapImage="snapImageName"...
Page 252: Resume Ssd Cache
Notes The name of a snapshot image has two parts separated by a colon (:): • The identifier of the snapshot group • The identifier of the snapshot image For example, if you want to resume snapshot virtual disk operations for snapshot image 12345 in a snapshot group that has the name snapGroup1, use the following command: resume snapVirtualDisk [snapVol1] snapImage=["snapGroup1:12345"];...
Page 253: Revive Disk Pool
Syntax revive diskGroup [diskGroupNumber] Parameter Parameter Description Number of the disk group to be set to the optimal diskGroup state. You must put brackets ([ ]) around the disk group number. Revive Disk Pool Description This command forces a disk pool and its associated physical disks to the Optimal state. CAUTION: Correct use of this command depends on the data configuration on all of the physical disks in the disk pool.
Page 254: Revive Snapshot Group
Parameter Parameter Description Identifies the enclosure and slot where, the physicalDisk physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and the slot ID value.
Page 255: Save Enclosure Log Data
Parameter Parameter Description The alphanumeric identifier (including - and _) of snapVirtualDisk the snapshot virtual disk that you want to set to the Optimal state. Enclose the snapshot virtual disk identifier in square brackets ([ ]). Save Enclosure Log Data Description This command saves the enclosure log sense data to a file.
Page 256: Save Physical Disk Log
Parameter Description Valid values for the identifier number are 1 or 2. Enclose the identifier number in square brackets ([ ]). The name of the file in which you are storing the file results of the fault isolation diagnostics test on the drive channel.
Page 257: Save Remote Replication Group Statistics
Parameter Description controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure. You must put brackets ([ ]) around the RAID controller module identifier. Name of the file in which to save the values. You file must put quotation marks ("...
Page 258 Parameter Description the remote replication group name in double quotation marks (" ") inside square brackets. The file path and the file name to which you want file to save the synchronization statistics. Enclose the file name in double quotation marks (" "). For example: file="C:\Program Files\CLI\logs \iscsistat.csv"...
Page 259: Save Storage Array Configuration
• Minimum write time (for a single write) • Minimum synchronization data rate • Maximum synchronization data rate • Total write time • Repository utilization (%) • Recovery point age During initial synchronization, statistics samples are captured approximately every 15 minutes. The synchronization statistics are included in the support bundle.
Page 260: Save Storage Array Core Dump
Parameter Description prevent saving the host topology, set this parameter to FALSE. The default value is FALSE. Saves the LUN mapping to the file. To save the lunMappings LUN mapping, set this parameter to TRUE. To prevent saving the LUN mapping, set this parameter to FALSE.
Page 261 Parameters Parameter Description This parameter specifies the location from which sourceLocation to obtain backup database information. • disk indicates that data comes directly from the database on the physical disk • cache indicates that data comes from the RPA memory location The default location is disk.
Page 262: Save Storage Array Dbm Validator Information File
Save Storage Array DBM Validator Information File Description This command saves the database management (DBM) validation information for a storage array in an XML file. Support personnel can use this XML file to generate a validator string (a security code). The validator string must be included in the load storageArray dbmDatabase command when restoring a storage array back to a pre-existing configuration.
Page 263: Save Storage Array Events
</Trailer> </DbmImageMetadata> Save Storage Array Events Description This command saves events from the Major Event Log (MEL) to a file. Any or all of the following events can be saved: • Critical events—Errors occurring on the storage array that needs to be addressed immediately. Loss of data access may occur if the error is not immediately corrected.
Page 264: Save Storage Array Iscsi Statistics
Parameter Description the last event entered) are saved to the file. Use integer values. forceSave When set to TRUE, force saves all critical events to a file. Default value is FALSE. Save Storage Array iSCSI Statistics Description This command saves the iSCSI performance of the storage array to a file. The following statistics are saved to the file: •...
Page 265: Save Storage Array Performance Statistics
Save Storage Array Performance Statistics Description This command saves the performance statistics to a file. Before you use this command, issue the set session performanceMonitorInterval and set session performanceMonitorIterations commands to specify how often statistics are collected. Syntax save storageArray performanceStats file="filename" Parameters Parameter Description...
Page 266: Save Storage Array State Capture
Save Storage Array State Capture Description This command saves the state capture to a file. Syntax save storageArray stateCapture file="filename" Parameters Parameter Description Name of the file to which to save the state capture. file You must put quotation marks (" ") around the file name.
Page 267: Schedule Support Bundle Collection Configuration
Parameters Parameter Description The path and the file name where support-related file data for the storage array is saved. Enclose the file path and the file name in double quotation marks (" "). For example, file="C:\Program Files\CLI \logs\supdat.zip". This command does not automatically append a file extension to the saved file.
Page 268: Scheduling Snapshots
Scheduling Snapshots NOTE: This command is applicable to both the Snapshot and the Snapshot (Legacy) premium feature. Description You can use the enableSchedule and the schedule parameters to schedule automatic snapshots. 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.
Page 269: Set Consistency Group Attributes
Parameter Description Specific date to stop creating a snapshot virtual endDate 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. Use this option to prevent a scheduled copy-on- noEndDate write operation from ending.
Page 270: Set Consistency Group Snapshot Virtual Disk
autoDeleteLimit=numberOfSnapImages| rollbackPriority=(lowest | low | medium | high | highest)] Parameters Parameter Description The name of the consistency group for which you consistencyGroupName are setting properties. Enclose the consistency group name in double quotation marks (" ") inside square brackets ([ ]). The new name that you want to give to the userLabel snapshot consistency group.
Page 271: Set Disk Group
Parameters Parameter Description The name of the consistency group virtual disk that cgSnapVirtualDisk you want to rename. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]). The new name that you want to give to the userLabel snapshot virtual disk in the consistency group.
Page 272: Set Disk Group Forced State
Parameter Description values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure. Use this parameter only if you want to change the disk group owner.
Page 273: Set Disk Pool
Syntax set diskGroup [diskGroupName] forcedState Parameters Parameter Description Sequence number of the disk group for which to diskGroup set properties. You must put brackets ([ ]) around the disk group number. NOTE: You can move the physical disks that comprise a disk group from one storage array to another storage array.
Page 274: Set Disk Pool Complete
Parameter Description full capacity. Use integer values. For example, a value of 70 means 70 percent. For best operation, the value for this parameter must be less than the value for the criticalThreshold parameter. Setting this parameter to 0 disables warning alerts. This parameter governs the priority for critical criticalPriority reconstruction activities on the disk pool.
Page 275: Set Enclosure Identification
Parameters Parameter Description Identifies a specific enclosure for which to set the enclosureID attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. Chassis name or number to give the new chassisName enclosure.
Page 276: Set Foreign Physical Disk To Native
Set Foreign Physical Disk to Native A physical disk is considered to be native when it is a part of a storage array disk group. A physical disk is considered to be foreign when it does not belong to a storage array disk group or when it fails to be imported with the physical disks of a disk group that are transferred to a new storage array.
Page 277 Parameters Parameter Description The name of the host that you want to assign to a host host group. Enclose the host name in square brackets ([ ]). If the host name has special characters, you must also enclose the host name in double quotation marks ("...
Page 278: Set Host Channel
Set Host Channel Description This command defines the loop ID for the host channel. Syntax set hostChannel [hostChannelNumber] preferredID=portID Parameters Parameter Description The identifier number of the host channel for hostChannel which you want to set the loop ID. The host channel identifier number is constructed by combining the controller number and the host channel number.
Page 279: Set Host Port
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Set Host Port Description This command changes the host type for an HBA host port.
Page 280: Set Iscsi Target Properties
host=”newHostName” | chapSecret=”newSecurityKey”) Parameters Parameter Description The name of the iSCSI initiator for which you want to iscsiID set attributes. The new name that you want to use for the iSCSI userLabel initiator. The name of the new host to which the HBA host host port is connected.
Page 281: Set Physical Disk Channel Status
NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a “secret.” A secret is a security key that is similar to a password. NOTE: Use the chapSecret parameter only for initiators requiring mutual authentication. NOTE: The targetAlias is a descriptive name that you can give to the target to help make it easier to identify.
Page 282: Set Physical Disk State
Parameters Parameter Description The enclosure and the slot where the physical disk physicalDisk or physicalDisks resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. Enclose the enclosure ID values and the slot ID values in square brackets ([ ]). The setting to assign the physical disk as the hot hotSpare spare.
Page 283 nvsramBitSetting)] [IPv4GatewayIP=ipAddress] [IPv6RouterAddress=ipv6Address] [iscsiHostPort [(0 | 1 | 2 | 3)] iscsiHostPortOptions] [rloginEnabled=(TRUE | FALSE)] [serviceAllowedIndicator=(on | off)] Parameters Parameter Description The controller for which you want to define controller properties. Valid controller identifiers are 0 or 1, where 0 is the controller in the top slot, and 1 is the controller in the bottom slot.
Page 284 Parameter Description subnet mask address, the IPv4 priority, and the IPv6 priority. The setting for whether the remote login feature is rloginEnabled turned on or turned off. To turn on the remote login feature, set this parameter to TRUE. To turn off the remote login feature, set this parameter to FALSE.
Page 285: Set Read-Only Snapshot Virtual Disk To A Read/Write Virtual Disk
Options for the Ethernet Port Parameter IPv6VlanId=[1-4094] | maxFramePayload=[frameSize] | tcpListeningPort=[3260, 49152-65536] | portSpeed=[(autoNegotiate | 1 | 10)] Notes When you use this command, you can specify one or more of the parameters. You do not need to use all of the parameters.
Page 286: Set Remote Replication
Syntax set snapVirtualDisk ["snapImageVirtualDiskName"] convertReadOnlyToReadWrite [repositoryVirtualDisk="repos_xxxx" | repositoryFullLimit=percentValue] Parameters Parameter Description The name of the snapshot virtual disk that you snapVirtual Disk want to change from read-only to read/write. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside of square brackets ([ ]).
Page 287 Parameters Parameter Description localVirtualDisk The name of the local virtual disk for which you want to define properties. Enclose the primary virtual disk name in square brackets ([ ]). If the primary virtual disk name has special characters or numbers, you must enclose the primary virtual disk name in double quotation marks ("...
Page 288: Set Remote Replication Group
Parameter Description the secondary virtual disk. Valid values are preserved or notPreserved. writeMode This parameter defines how the primary virtual disk writes to the secondary virtual disk. Valid values are synchronous or asynchronous. force The role reversal is forced if the communications link between the storage arrays is down and promotion or demotion on the local side results in a dual-primary condition or a dual-secondary...
Page 289 Parameters Parameter Description The name of the remote replication group that you asyncRemoteReplicationGroup want to modify. Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" ") inside square brackets.
Page 290 Parameter Description secondary virtual disks of a remote replicated pair within a remote replication group. This parameter has these values: • enabled—Automatic resynchronization is turned on. You do not need to do anything further to resynchronize the primary virtual disk and the secondary virtual disk.
Page 291 Parameter Description If you do not use the capacity option, the MD storage management software sets the capacity to 20 percent of the base virtual disk capacity. Enclose the name of the new repository virtual disk in parenthesis ( ). Use this parameter to promote the remote role replication group to a primary role or demote the...
Page 292: Set Session
Set Session Description This command defines how you want the current script engine session to run. Syntax set session errorAction=(stop | continue) password=”storageArrayPassword” performanceMonitorInterval=intervalValue performanceMonitorIterations=iterationValue Parameters Parameter Description How the session responds if an error is errorAction encountered during processing. You can choose to stop the session if an error is encountered, or you can continue the session after encountering an error.
Page 293: Set Snapshot Group Attributes
Set Snapshot Group Attributes Description This command defines the properties for a snapshot group. Syntax set snapGroup ["snapGroupName"] [userLabel="snapGroupName" | repositoryFullPolicy=(failBaseWrites | purgeSnapImages) | repositoryFullLimit=percentValue | autoDeleteLimit=numberOfSnapImages | rollbackPriority=(lowest | low | medium | high | highest) Parameters Parameter Description The alphanumeric identifier (including - and _) of snapGroup the snapshot group for which you are setting...
Page 294: Set Snapshot Group Media Scan
Parameter Description operation at the expense of system performance. Valid values are highest, high, medium, low, or lowest. A value of high indicates that the rollback operation is prioritized over all other host I/O. A value of lowest indicates that the rollback operation should be performed with minimal impact to host I/O.
Page 295: Set Snapshot Group Repository Virtual Disk Capacity
Set Snapshot Group Repository Virtual Disk Capacity Description This command increases or decreases the capacity of a snapshot group repository virtual disk. Syntax For Increasing Capacity set snapGroup ["snapGroupName"] increaseRepositoryCapacity repositoryVirtualDisks=(repos_xxxx) Syntax For Decreasing Capacity set snapGroup ["snapGroupName"] decreaseRepositoryCapacity count=numberOfVirtual disks Parameters Parameter Description...
Page 296: Set Snapshot (Legacy) Virtual Disk
Syntax set snapGroup ["snapGroupName"] enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule) Parameters Parameter Description The alphanumeric identifier (including - and _) of snapGroup the snapshot group for which you are setting properties. Enclose the snapshot group name in double quotation marks (" ") inside of square brackets ([ ]).
Page 297 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).
Page 298 Parameter Description Determines whether system resources must be rollbackPriority 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.
Page 299 Parameter Description Amount of time, in minutes that defines a scheduleInterval 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.
Page 300: Set Snapshot Virtual Disk Media Scan
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.
Page 301: Set Snapshot Virtual Disk Repository Virtual Disk Capacity
Set Snapshot Virtual Disk Repository Virtual Disk Capacity Description This command defines the capacity the you can set for a snapshot virtual disk repository virtual disk. Syntax set snapVirtualDisk ["snapVirtualDiskName"] (repositoryFullLimit=percentValue | increaseRepositoryCapacity (repositoryVirtualDisk=(repos_xxxx) | decreaseRepositoryCapacity count=numberOfVirtualDisks) Parameters Parameters Description The alphanumeric identifier (including - and _) of snapVirtualDisk the snapshot virtual disk for which you are setting...
Page 302 Syntax set storageArray (cacheBlockSize=cacheBlockSizeValue | cacheFlushStart=cacheFlushStartSize | cacheFlushStop=cacheFlushStopSize | defaultHostType=("hostTypeName" | "hostTypeIdentifier") failoverAlertDelay=delayValue | mediaScanRate=(disabled | 1-30) | userRole=(admin | monitor) password="password" | userLabel="storageArrayName" isnsRegistration=(TRUE | FALSE)) Parameters Parameter Description The cache block size that is used by the RAID cacheBlockSize controller module for managing the cache.
Page 303 Parameter Description Defines the user role for the password. The user userRole role can be either: • admin – Enables you to view and modify storage array configurations • monitor – Enables you to view storage array configurations and monitor storage array health conditions, but not modify the configuration The userRole parameter is optional.
Page 304: Set Storage Array Enclosure Positions
Media scan runs on all of the virtual disks in the storage array that have Optimal status, do not have modification operations in progress, and have the mediaScanRate parameter enabled. Use the set virtualDisk command to enable or disable the mediaScanRate parameter. Password Passwords are stored on each storage array.
Page 305: Set Storage Array Icmp Response
expansion enclosure 1 in the first position, expansion enclosure 50 in the third position, and expansion enclosure 12 in the fourth position. NOTE: You must include all of the enclosures in the storage array in the list defined by the enclosurePositions parameter.
Page 306: Set Storage Array Isns Server Ipv6 Address
Set Storage Array iSNS Server IPv6 Address Description This command sets the IPv6 address for the iSNS server. Syntax set storageArray isnsIPv6Address=ipAddress Parameter Parameter Description The IPv6 address that you want to use for the iSNS isnsIPv6Address server. Set Storage Array iSNS Server Listening Port Description This command sets the iSNS server listening port.
Page 307: Set Storage Array Learn Cycle
Set Storage Array Learn Cycle Description This command sets the learn cycle for the battery backup unit. The learn cycle enables the MD storage management software to predict the remaining battery life. Learn cycles run at set intervals and store the results for software analysis.
Page 308: Set Storage Array Security Key
Parameter Parameter Description Use simplex mode when you have a single RAID redundancyMode controller module. Use duplex mode when you have two RAID controller modules Set Storage Array Security Key Description Use this command to set the security key that is used throughout the storage array to implement the Physical Disk Security premium feature.
Page 309: Set Storage Array Unnamed Discovery Session
Parameters None. Set Storage Array Unnamed Discovery Session Description This command enables the storage array to participate in unnamed discovery sessions. Syntax set storageArray unnamedDiscoverySession=(TRUE | FALSE) Parameter Parameter Description This parameter turns on or turns off unnamed unnamedDiscoverySession discovery sessions. Set the parameter to TRUE to turn on unnamed discovery sessions.
Page 310 Parameters Parameter Description virtualDisk or virtualDisks The name of the specific 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 virtual disk name in double quotation marks (" ") inside of square brackets ([ ]).
Page 311: Set Virtual Disk
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.
Page 312 Parameters Parameter Description Specifies the properties for all virtual disks in the allVirtualDisks storage array. Specifies the name of the virtual disk for which to virtualDisk or virtualDisks (name) define properties. You can enter more than one virtual disk name if you use the virtualDisks parameter.
Page 313 Parameter Description The setting to turn on or turn off the read cache. readCacheEnabled To turn on the read cache, set this parameter to TRUE. To turn off the read cache, set this parameter to FALSE. The setting to turn on or turn off the write cache. writeCacheEnabled To turn on the write cache, set this parameter to TRUE.
Page 314: Set Virtual Disk Attributes For A Disk Pool
Parameter Description The setting to check the consistency of RAID preReadRedundancyCheck 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.
Page 315 NOTE: In configurations where disk groups consist of more than 32 virtual disks, the operation can result in host I/O errors or internal RAID controller module reboots due to the expiration of the timeout period before the operation completes. If you experience host I/O errors or internal RAID controller module reboots, bring the host to a quiescent state and try the operation again.
Page 316 Parameter Description The setting to add new physical disks to the virtual addPhysicalDisks disk. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for the physical disk. For low- capacity expansion enclosures, specify the enclosure ID value and the slot ID value for the physical disk.
Page 317 Parameter Description The setting to turn on or turn off preread preReadConsistencyCheck consistency checking. Turning on preread consistency checking verifies the consistency of RAID redundancy data for the stripes containing the read data. Preread consistency checking is performed on read operations only. To turn on preread consistency checking, set this parameter to TRUE.
Page 318: Modification Priority
Cache Flush Modifier Valid values for the cache flush modifier are listed in the following table. Value Description Data is flushed as soon as it is placed into the Immediate cache. Data is flushed after 250 ms. Data is flushed after 500 ms. Data is flushed after 750 ms.
Page 319: Set Virtual Disk Copy
Cache Read Prefetch The cacheReadPrefetch parameter enables the RAID controller module to copy additional data blocks into cache while the RAID controller module reads and copies data blocks that are requested by the host from the physical disk into cache. This action increases the chance that a future request for data can be fulfilled from cache.
Page 320: Set Virtual Disk Mapping
Parameter Description ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the target virtual disk name. Specifies the name of the source virtual disk for source which to define properties.
Page 321: Show Consistency Group Snapshot Image
Parameters Parameter Description The name of the specific virtual disk for which you virtualDisk want to define mapping. Enclose the virtual disk name in double quotation marks (" ") inside of square brackets ([ ]). The World Wide Identifier (WWID) of the virtual disk for which you are setting properties.
Page 322 Syntax show ((CGSnapImage [(CGSnapImageName | CGSnapImageSequenceNumber)]) | (CGSnapImages [(CGSnapImageNumber1 ... CGSnapImageNumbern | CGSnapImageSequenceNumber1 ... CGSnapImageSequenceNumbern)]) | allCGSnapImages [summary] Parameters Parameter Description cgSnapImage or cgSnapImages The name of the snapshot image in a consistency group. The name of a snapshot image is comprised of two parts: •...
Page 323: Show Current Iscsi Sessions
For example, if you want to show snapshot image 12345 in a snapshot consistency group that has the name snapCGroup1, you would use this command: show snapImage ["snapCGroup1:12345"]; To show the most recent snapshot image in a snapshot consistency group that has the name snapCGroup1, you would use this command: show snapImage ["snapCGroup1:newest"];...
Page 324: Show Disk Group
NOTE: This command can be entered without defining any arguments, i.e. show iscsiSessions. When the command is entered without arguments, the information displayed is for all active iSCSI sessions. To limit the information displayed, enter a specific iSCSI initiator or a specific iSCSI target. The command then displays only information about that particular iSCSI initiator or iSCSI target session.
Page 325: Show Disk Group Import Dependencies
Parameter Parameter Description Number of the disk group for which to display diskGroup information. You must put brackets ([ ]) around the disk group number. Show Disk Group Import Dependencies Description This command shows a list of dependencies for the physical disks in a disk group that you want to move from one storage array to a second storage array.
Page 326: Show Host Ports
Parameter Parameter Description The alphanumberic identifier of the disk pool diskPool (including – and _) that you want to set to a Complete state. Enclose the diskPoolName in square brackets ([ ]). Show Host Ports Description For all HBA host ports connected to a storage array, this command returns the following information: •...
Page 327 – Status – Capacity – Data transfer rate – Product ID – Firmware level • Physical disk channel information: – Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long.
Page 328: Show Physical Disk Channel Statistics
Parameter Description The type of physical disk for which you want to physicalDiskType retrieve information. The valid physical disk type is SAS. Identifies the enclosure and slot where the physical physicalDisk or physicalDisks disk resides. You can enter enclosure IDs and slot IDs for one or several physical disks.
Page 329: Show Physical Disk Download Progress
Show Physical Disk Download Progress Description This command returns the status of firmware downloads for the physical disks targeted by the download physicalDisk firmware or download storageArray physicalDiskFirmware commands. Syntax show allPhysicalDisks downloadProgress Parameters None. NOTE: When all firmware downloads have successfully completed, this command returns a Successful status.
Page 330: Show Raid Controller Module Nvsram
Syntax show (allControllers | controller [(0 | 1)]) [summary] Parameters Parameter Description Returns information about both RAID controller allControllers modules in the storage array. Returns information about a specific RAID controller controller module in the storage array. Valid RAID controller module identifier values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the...
Page 331: Show Remote Replication Group
Parameter Description hostTypeTable command to generate a list of available host type identifiers. Specifies the name of the host connected to the host RAID controller modules. You must put quotation marks (" ") around the host name. NOTE: Use the show controller NVSRAM command to display parts or all of the NVSRAM before using the set controller command to change NVSRAM values.
Page 332: Show Remote Replication Group Synchronization Progress
Show Remote Replication Group Synchronization Progress Description This command displays the progress of periodic synchronization of the remote replication group between the local and remote storage array. This command returns the progress of data synchronization on all of the replicated pairs within the remote replication group. This command shows the progress as a percentage of data synchronization that has been completed.
Page 333: Show Remote Replication Virtual Disk Synchronization Progress
Syntax show remoteReplication candidates primary= ”virtualDiskName” remoteStorageArrayName=storageArrayName Parameters Parameter Description The name of the local virtual disk that you want for primary the primary virtual disk in the remote-replicated pair. Enclose the primary virtual disk name in double quotation marks (“ ”). The remote storage array that contains possible remoteStorageArrayName virtual disks for a secondary virtual disk.
Page 334: Show Snapshot Group
Show Snapshot Group Description This command returns this information about one or more snapshot image groups. Syntax show (allSnapGroups | snapGroup [snapGroupName] | snapGroups [snapGroupName1 ... snapGroupNamen]) [summary | schedule] Parameters Parameter Description The parameter to return information about all of allSnapGroups the snapshot groups in the storage array.
Page 335: Show Snapshot Image
Total Available Snapshot Image Snapshot Scheduled Repository Repository Limit Images Capacity Capacity 10.318 GB 10.318 GB (100%) DETAILS Snapshot Group "2_SG_01" Status: Optimal Type: Standard Associated base volume: 2 Cluster size: 65,536 bytes Repository Total repository volumes: 3 Aggregate repository status: Optimal Total repository capacity: 10.318 GB Used capacity: 0.000 MB (0%) Available repository capacity: 10.318 GB (100%)
Page 336: Show Snapshot Virtual Disks
Parameter Description • NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group. • OLDEST - Use this option when you want to show the earliest snapshot image created in the snapshot group.
Page 337: Show Ssd Cache
Parameters Parameter Description The parameter to return information about all of allSnapVirtualDisks the snapshot virtual disks in the storage array. snapVirtualDisk or snapVirtualDisks The alphanumeric identifier (including - and _) of a specific snapshot virtual disk about which you are retrieving information.
Page 338 Syntax show ssdCache [ssdCacheName] Parameter Parameter Description The alphanumeric identifier (including - and _) of ssdCache the SSD cache for which you want to get information. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks ("...
Page 339: Show Ssd Cache Statistics
Show SSD Cache Statistics Description This command displays data about the SSD cache usage. Syntax show ssdCache [ssdCacheName] ssdCacheStatistics [RAID controller module=[(0|1| both)] file="filename"] Parameters Parameter Description The alphanumeric identifier (including - and _) of ssdCache the SSD cache for which you want to get information.
Page 340 Writes Total number of host writes to SSD cache-enabled virtual disks. Cache Hits A count of the number of cache hits. Cache Hits (%) Derived from Cache Hits/total reads. The Cache Hit percentage should be greater than 50% for effective SSD cache operation.
Page 341 from the cached HDD virtual disk. The SSD cache offers no performance benefit for this type of hit. If the partial cache hit blocks count is higher than the full cache hit blocks, it is possible that a different I/O characteristic type (file system, database, or web server) could improve the performance.
Page 342: Show Storage Array
The available bytes, allocated bytes, and user data bytes are used to compute the Cache Allocation % and the Cache Utilization %. User Data Bytes Number of allocated bytes in the SSD cache that contain data from base virtual disks. The available bytes, allocated bytes, and user data bytes are used to compute the Cache Allocation % and the Cache Utilization %.
Page 343 Parameter Description NOTE: The previous command syntax is for a host running Windows. The actual syntax varies depending on your operating system. The parameter to return information about the autoSupportConfig current state of the operation to automatically collect support data. The information this parameter returns is: •...
Page 344: Show Storage Array Auto Configure
Parameter Description • Time remaining NOTE: When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. Show Storage Array Auto Configure Description This command shows the default autoconfiguration that the storage array creates if you issue the autoConfigure storageArray command.
Page 345: Show Storage Array Core Dump
Parameter Description Number of equal-capacity virtual disks per disk virtualDisksPerGroupCount group. Use integer values. Number of hot spares desired in the storage array. hotSpareCount Use integer values. For information about hot spares, see Assigning Global Hot Spares. Amount of data (in kilobytes) that the RAID segmentSize controller module writes on a single physical disk in a virtual disk before writing data on the next...
Page 346: Show Storage Array Host Topology
Syntax show storageArray dbmDatabase Parameters None. Show Storage Array Host Topology Description This command returns the storage partition topology, the host type labels, and the host type index for the host storage array. Syntax show storageArray hostTopology Parameters None. Show Storage Array LUN Mappings Description This command returns information from the storage array profile about the storage array LUN mappings.
Page 347: Show Storage Array Negotiation Defaults
Show Storage Array Negotiation Defaults Description This statement returns information about connection-level settings that are subject to initiator-target negotiation. Syntax show storageArray iscsiNegotiationDefaults Parameters None. NOTE: Information returned includes RAID controller module default settings (settings that are the starting point for negotiation), and the current active settings. Show Storage Array Unconfigured iSCSI Initiators Description This command returns a list of initiators that have been detected by the storage array but are not yet...
Page 348: Show String
The data is sorted first by the virtual disk user label and second by the logical block address (LBA). Each entry in the table corresponds to a single sector. Syntax show storageArray unreadableSectors Parameters None. Show String Description This command shows a string of text from a script file. This command is similar to the echo command in MS-DOS and UNIX.
Page 349: Show Virtual Disk
Parameter Description name has special characters, you also must enclose the virtual disk name in double quotation marks (" "). The setting to return a concise list of information consumedCapacity about the consumed capacity of the thin virtual disks. The setting to return a concise list of information expansionHistory about the expansion history of the thin virtual disks.
Page 350 • Details: – The virtual disk ID – The subsystem ID – The physical disk type (SAS) – Enclosure loss protection – The preferred owner – The current owner – The segment size – The modification priority – The read cache status (enabled or disabled) –...
Page 351: Show Virtual Disk Action Progress
Notes For snapshot virtual disk copies, the show virtualDisk command returns information about the schedules for the snapshot virtual disk copies. The schedule information is in this form: Schedule State: "Active" | "Disabled" | "Completed" Last Run Time: <mm/dd/yyyy> <hh:mm a.m. | p.m.> Next Run Time: <mm/dd/yyyy>...
Page 352: Show Virtual Disk Copy Source Candidates
Syntax show virtualDiskCopy (allVirtualDisks | source ["sourceName"] | target ["targetName"]) Parameters Parameter Description Returns information about virtual disk copy allVirtualDisks operations for all virtual disk copy pairs. Name of the source virtual disk about which to source retrieve information. You must put quotation marks ("...
Page 353: Show Virtual Disk Copy Target Candidates
Show Virtual Disk Copy Target Candidates Description This command returns information about the candidate virtual disks that you can use as the target for a virtual disk copy operation. Syntax show virtualDiskCopy source ["sourceName"] targetCandidates Parameters Parameter Description Name of the source virtual disk for which you are source trying to find a candidate target virtual disk.
Page 354: Start Configuration Database Diagnostic
Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] virtualDisks [virtualDiskName1... virtualDiskNameN] reservations Parameters Parameter Description Returns reservation information about all virtual allVirtualDisks disks in the storage array. Name of the specific virtual disk for which you are virtualDisk or virtualDisks retrieving reservation information. You can enter more than one virtual disk name.
Page 355: Start Consistency Group Snapshot Rollback
To stop the database configuration diagnostic test, use the stop storageArray configDbDiagnostic command. In addition, the database configuration diagnostic test can be started using the storage management software GUI but cannot be stopped using the storage management software GUI. If you want to stop a running diagnostic test, you must use the stop storageArray configDbDiagnostic command.
Page 356: Start Disk Group Blink
Notes To start a roll back operation for an entire consistency group that has the name congroup1, you would use this command: start cgSnapImage ["congroup1"] rollback; To start a roll back operation for base virtual disk members memVol1, memVol2, and memVol3 in a consistency group that has the name congroup2, you would use this command: start cgSnapImage ["CG2:12345"] rollback memberVirtualDiskset=("memVol1 memVol2 memVol3");...
Page 357: Start Disk Group Export
Start Disk Group Export Description This command moves a disk group into an Exported state. Then you can remove the physical disks that comprise the disk group and reinstall the physical disks in a different storage array. NOTE: Within the disk group, you cannot move virtual disks that are associated with the premium features from one storage array to another storage array.
Page 358: Start Disk Pool Locate
Parameters Parameter Description Number of the disk group to defragment. You diskGroup must put brackets ([ ]) around the disk group number. NOTE: Higher-level virtual disks that are specifically related to premium features (Snapshot, Remote Virtual Disk Mirroring, Virtual Disk Copy, mapping, and persistent reservations) are removed as part of the import operation.
Page 359: Start Iscsi Dhcp Refresh
Start iSCSI DHCP Refresh Syntax start controller [(0 | 1)] iscsiHostPort [(1 | 2 | 3 | 4)] dhcpRefresh Parameters Parameter Description The identifier letter of the RAID controller module controller that has the iSCSI host ports. Valid RAID controller module identifier values are 0 or 1, where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1.
Page 360: Start Physical Disk Channel Blink
Start Physical Disk Channel Blink Description This command identifies the expansion enclosures that are connected to a specific physical disk port by turning on the indicator lights for the expansion enclosure that is connected to the physical disk port. Use the stop physicalDiskChannel blink command to turn off the indicator lights on the expansion enclosure.
Page 361: Start Physical Disk Initialize
Parameter Description identifier values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure. The identifiers of the devices (RAID controller testDevices modules, EMMs, or physical disks) that you want to test.
Page 362: Start Physical Disk Reconstruction
Parameter Description ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value. Start Physical Disk Reconstruction Description This command starts reconstructing a physical disk. Syntax start physicalDisk [enclosureID,slotID] reconstruct Parameters Parameter Description...
Page 363: Start Remote Replication (Legacy) Synchronization
Start Remote Replication (Legacy) Synchronization Description NOTE: This command valid only with Fibre Channel storage arrays. This command starts Remote Replication (legacy) synchronization. Syntax start remoteReplication primary [”virtualDiskName”] synchronize Parameters Parameter Description The name of the primary virtual disk for which you primary want to start synchronization.
Page 364: Start Snapshot Rollback
Start Snapshot Rollback Description This command starts a rollback operation for one or more snapshot virtual disks. The content of the base virtual disk changes immediately to match the content of the selected snapshot virtual disk at that point in time. The base virtual disk immediately becomes available for read/write requests after the rollback operation has successfully completed.
Page 365: Start Ssd Cache Performance Modeling
Parameter Parameter Description The name of the snapshot image. The name of a snapImage snapshot image is comprised of two parts: • The name of the snapshot group. • An identifier for the snapshot image in the snapshot group. The identifier for the snapshot image can be one of these: •...
Page 366: Start Storage Array Blink
• Run the stop ssdCache performanceModeling command. • Retrieve the performance modeling data using PowerVault MD Storage Manager. Performance modeling ends, but no data is available when one of the following conditions occurs: • You reboot the RAID controller module.
Page 367 [diagnosticType = (fileSystem | mirror | contentCheck)] [controller[(0 | 1)]] Parameters Parameter Description This parameter specifies the location of the sourceLocation database. • disk indicates that data comes directly from the database on the physical disk. • onboard indicates that data comes from the RPA memory location The default location is disk.
Page 368: Start Storage Array Iscsi Refresh
Notes This command runs a consistency check against a configuration database. All database records are checked. Error data is written to a file in the data folder on disk automatically. You do not need to specify an output file. NOTE: Executing a consistency check with the diagnosticType parameter set to a value other than filesystem, and with the sourceLocation parameter set to onboard, can cause the operation to run for a long time.
Page 369: Start Virtual Disk Initialization
NOTE: If you used the set storageArray isnsIPv4ConfigurationMethod command to set the configuration but did not set the configuration to DHCP, running the start storageArray isnsServerRefresh returns an error. Start Virtual Disk Initialization Description This command starts the formatting of a virtual disk in a storage array. NOTE: Initializing a virtual disk is a long-running operation that you cannot stop.
Page 370: Stop Consistency Group Snapshot Rollback
Stop Consistency Group Snapshot Rollback Description This command stops a rollback operation to the member base virtual disks in a snapshot consistency group that was initiated by the start rollback cgSnap command. NOTE: Canceling a consistency group snapshot rollback operation leaves the base virtual disk in an indeterminate state with potentially invalid or inconsistent data.
Page 371: Stop Consistency Group Snapshot Virtual Disk
Stop Consistency Group Snapshot Virtual Disk Description This command stops the copy-on-write operation for creating a consistency group snapshot virtual disk. To restart the copy-on-write operation use the resume cgSnapVirtualDisk command. NOTE: This command does not delete a consistency group snapshot virtual disk. To delete a consistency group snapshot virtual disk use the delete cgSnapVirtualDisk command.
Page 372: Stop Disk Pool Locate
Stop Disk Pool Locate Description This command turns off the indicator lights on the physical disks that were turned on by the start diskPool locate command. Syntax stop diskPool locate Stop Enclosure Blink Description This command turns off the indicator LED on the enclosure that was turned on by the start enclosure blink command.
Page 373: Stop Physical Disk Blink
Stop Physical Disk Blink Description This command turns off the indicator light on the physical disk that was turned on by the start physicalDisk blink command. Syntax stop physicalDisk blink Parameters None. Stop Physical Disk Channel Blink Description This command turns off the indicator lights on the expansion enclosures that were turned on by the start physicalDiskChannel blink command.
Page 374: Stop Snapshot Group Image
NOTE: Use the start physicalDiskChannel faultDiagnostics command and the save physicalDiskChannel faultDiagnostics command with the stop physicalDiskChannel faultDiagnostics command. These commands are needed to start the diagnostic test and save diagnostic test results to a file. You can also stop the start physicalDiskChannel faultDiagnostics command at any time by pressing <Ctrl><C>.
Page 375: Stop Snapshot (Legacy)
Parameters Parameter Description The alphanumeric identifier (including - and _) of snapGroup the snapshot group for which you want to stop pending snapshot images. Enclose the snapshot group identifier in square brackets ([ []). The alphanumeric identifier (including - and _) of consistencyGroup the snapshot consistency group for which you want to stop pending snapshot images.
Page 376: Stop Snapshot (Legacy) Rollback
the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk. For example, if you have a base virtual disk with a name of Engineering Data, the snapshot (legacy) virtual disk can have a name of Engineering Data-S1, and the snapshot (legacy) repository virtual disk can have a name of EngineeringData- R1.
Page 377: Stop Snapshot Rollback
Parameter Description Enter the names of the virtual disks using these rules: • Enclose all of the names in square brackets ([ ]). • Separate each of the names with a space. If the virtual disk names have special characters or numbers, enter the names using these rules: •...
Page 378: Stop Snapshot Virtual Disk
Syntax stop snapImage [snapImageName] rollback Parameter Parameter Description The name of the snapshot image for which you snapImage want to stop a rollback operation. The name of a snapshot image is comprised of two parts: • The name of the snapshot group. •...
Page 379: Stop Ssd Cache Performance Modeling
Syntax stop snapVirtualDisk ["snapVirtualDiskName"] Parameter Parameter Description The alphanumeric identifier (including - and _) of snapVirtualDisk the snapshot virtual disk that you want to stop. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]).
Page 380 Notes This command returns the performance modeling information similar to this example. The size of your monitor determines how the information wraps and will affect how the information appears. SSD Cache Name: my_cache Start time: 4/18/12 2:38:26 PM IST Stop time: 4/18/12 2:38:45 PM IST Duration : 00:00:19 SSD Cache Performance Modeling Data (Response Time): SSD Reads...
Page 381: Stop Storage Array Blink
1489 GB 1675 GB 1862 GB * = Current SSD cache physical capacity. Stop Storage Array Blink Description This command turns off the indicator lights on the storage array that were turned on by the start storageArray blink command. Syntax stop storageArray blink Parameters None.
Page 382: Stop Storage Array Iscsi Session
Stop Storage Array iSCSI Session Description This command forces the termination of an iSCSI session. Syntax stop storageArray iscsiSession [sessionNumber] Parameters Parameter Description The identifier number of the iSCSI session. Enclose sessioNumber the identifier number of the iSCSI session in square brackets ([ ]).
Page 383: Suspend Remote Replication
Parameters Parameter Description Name of the target virtual disk for which to stop a target virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks ("...
Page 384: Suspend Remote Replication Group
NOTE: If the writeConsistency parameter is set to TRUE, the virtual disks must be in a write- consistency group (or groups). This command suspends all write-consistency groups that contain the virtual disks. For example, if virtual disks A, B, and C are in a write-consistency group and they have remote counterparts A’, B’, and C’, the command: suspend remoteReplication virtualDisk [“A”] writeConsistency=TRUE...
Page 385: Test Remote Replication Group Connectivity
Syntax suspend ssdCache [ssdCacheName] Parameter Parameter Description The alphanumeric identifier (including - and _) of ssdCache the SSD cache that you want to suspend. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks ("...
Page 386: Validate Storage Array Security Key
Parameter Description path. The connectivity test sends an inter-RAID controller module message between the storage arrays, and then validates that the corresponding remote replication group on the remote storage array exists. It also validates that the virtual disk members of the remote replication group on the remote system match the virtual disk members of the remote replication group on the local system.
Page 387 Additional Information Your pass phrase must meet these criteria: • The pass phrase must be between eight and 32 characters long. • The pass phrase must contain at least one uppercase letter. • The pass phrase must contain at least one lowercase letter. •...
Page 389: Sample Script Files
Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array. Create a script file in two ways: •...
Page 390: Configuration Script Example 2
the script file; however, the size of this page causes the command text to wrap. You might want to include blank lines in your script files to separate blocks of commands or make a comment more outstanding. You can do this by entering two forward slashes (//), which causes the script engine to treat the line as a comment.
Page 391 create virtualDisk raidLevel=5 userLabel="2" physicalDisks=[0,1 0,6 1,7 1,3 2,3 2,6] owner=1 segmentSize=16 capacity=2GB; show "Setting additional attributes for virtual disk 7"; //Configuration settings that cannot be set during virtual disk creation set virtualDisk["7"] mediaScanEnabled=false; set virtualDisk["7"] consistencyCheckEnabled=false; set virtualDisk["7"] modificationPriority=high; The command in this example, like the create virtualDisk command in the previous example, creates a new virtual disk.
Page 393: Cli Command Updates
CLI Command Updates This chapter reflects new and updated commands that are available for use with Dell's PowerVault Modular Disk Series of storage arrays. NOTE: Not all commands are necessarily valid with all storage arrays - some commands are specific to certain platforms.
Page 394 • Delete Consistency Group Snapshot Virtual Disk • Delete Remote Replication Group • Delete Snapshot Group • Delete Snapshot Image • Delete Snapshot Virtual Disk • Delete Snapshot (Legacy) Virtual Disk • Delete SSD Cache • Enable or Disable SSD Cache for a Virtual Disk •...
Page 395: Updated Commands
• Set Virtual Disk Attributes For A Disk Pool • Set Virtual Disk Mapping • Show Consistency Group Snapshot Image • Show Remote Replication Group • Show Remote Replication Group Synchronization Progress • Show Snapshot Group • Show Snapshot Image •...
Page 396 • Delete Virtual Disk On A Disk Pool • Resume Snapshot (Legacy) Rollback • Set Snapshot (Legacy) Virtual Disk • Set Virtual Disk Copy • Show Virtual Disk • Stop Snapshot (Legacy)

This manual is also suitable for:

Powervault series

Dell PowerVault Manual

1 About the Command Line Interface

2 About the Script Commands

3 Configuring a Storage Array

4 Using the Snapshot Feature

5 Using the Snapshot (Legacy) Feature

6 Using the Virtual Disk Copy Feature

7 Using the Remote Replication Premium Feature

8 Using the Remote Replication (Legacy) Premium Feature

9 Maintaining a Storage Array

10 Script Commands

11 Commands Listed Alphabetically

Quick Links

Related Manuals for Dell PowerVault

Summary of Contents for Dell PowerVault