Dell PowerVault Modular Disk Storage Arrays CLI Guide
Notes, Cautions, and Warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. 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.
Contents 1 About The Command Line Interface.................................................................. 15 How To Use The Command Line Interface....................................................................................... 16 Usage Notes...................................................................................................................................16 CLI Commands..................................................................................................................
Snapshot Consistency Groups......................................................................................................52 Understanding Snapshot Repositories............................................................................................... 53 Snapshot Consistency Group Repositories..................................................................................53 Consistency Groups And Remote Replication.................................................................................
6 Using The Virtual Disk Copy Feature................................................................. 77 About Virtual Disk Copy...................................................................................................................... 77 Virtual Disk Copy Types.......................................................................................................................77 Creating A Virtual Disk Copy........................................................................................
Interaction With Other Premium Features.........................................................................................95 Standard Remote Replication Commands........................................................................................ 95 8 Using The Remote Replication (Legacy) Premium Feature......................... 97 How Remote Replication (Legacy) Works..........................................................................................97 Replication Repository Virtual Disks..
Defragmenting A Disk Group...................................................................................................... 116 Using SSD Cache............................................................................................................................... 116 Enabling SSD Cache For A Virtual Disk....................................................................................... 116 Creating SSD Cache.....................................................................................
Add Physical Disks To SSD Cache.................................................................................................... 138 Add Virtual Disk To Remote Replication Group...............................................................................139 Autoconfigure Storage Array............................................................................................................ 140 Autoconfigure Storage Array Hot Spares.......................................................................
Create Snapshot (Legacy) Virtual Disk..............................................................................................187 Create Snapshot Virtual Disk............................................................................................................ 192 Create SSD Cache.............................................................................................................................194 Create Storage Array Security Key..........................................................
Modify Disk Pool............................................................................................................................... 227 Recopy Virtual Disk Copy................................................................................................................. 228 Re-Create Remote Replication Repository Virtual Disk..................................................................229 Re-Create Snapshot..................................................................................
Save Storage Array DBM Database.................................................................................................. 260 Save Storage Array DBM Validator Information File........................................................................ 262 Save Storage Array Events................................................................................................................ 263 Save Storage Array iSCSI Statistics...........................................................................
Set Storage Array ICMP Response................................................................................................... 305 Set Storage Array iSNS Server IPv4 Address.................................................................................... 305 Set Storage Array iSNS Server IPv6 Address.................................................................................... 306 Set Storage Array iSNS Server Listening Port.......................................................................
Show Storage Array Unconfigured iSCSI Initiators..........................................................................347 Show Storage Array Unreadable Sectors......................................................................................... 347 Show String....................................................................................................................................... 348 Show Thin Virtual Disk..................................................................................
Stop Physical Disk Blink.................................................................................................................... 373 Stop Physical Disk Channel Blink..................................................................................................... 373 Stop Physical Disk Channel Fault Isolation Diagnostics.................................................................. 373 Stop Snapshot Group Image...............................................................................
About The Command Line Interface 1 This guide is intended for system administrators, developers, and engineers who need to use the command line interface (CLI) tool and its associated commands and script files. Selected CLI commands perform functions that can also be accessed from the Modular Disk (MD) Storage Manager, which is the graphical user interface (GUI) to the storage array.
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 • Storage array identifier • Parameters • Script commands The following syntax is the general form of a CLI command: SMcli storageArray parameters script-commands; where, SMcli invokes the command line interface.
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 a|b pipe symbol indicating alternative ("a" or "b") italicized-words terminals [...] (square brackets) zero or one occurrence {...} (curly brackets) zero or more occurrences <...
[-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.
Parameter Definition -c 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. -d Use to display the contents of the script configuration file. -e Use to disable syntax checking when executing the current CLI command.
Parameter Definition -h 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. -I Use to specify the type of information to be included in the e-mail alert notifications. The following are valid information arguments: • • • eventOnly— Only event information is included in the e-mail. profile— Event and array profile information is included in the e-mail.
Parameter Definition • • -q 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. An e-mail alert notification that contains at least the basic event information is always generated for every critical event.
Parameter Definition -s (lowercase) Use with the -d parameter to display the alert settings in the configuration file. -v 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. Use the configuration file to reconstruct a storage array). -X (uppercase) Use to delete a storage array from the configuration file.
• 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. • The CLI does not have any provisions to avoid overwriting an existing version of the file containing error data.
Status Value Meaning 13 Invalid script syntax was found. 14 The RAID controller module was unable to communicate with the storage array. 15 A duplicate argument was entered. 16 An execution error occurred. 17 A host was not at the specified address. 18 The World Wide Identifier (WWID) was not in the configuration file. 19 The WWID was not at the address. 20 An unknown IP address was specified. 21 The event monitor configuration file was corrupted.
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. The storage array is protected and requires the password TestArray.
About The Script Commands 2 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. When entering an individual script command, include it as part of a CLI command. When running a file of script commands, include the file name as part of a CLI command.
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).
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.
Command Syntax Description diagnose object {statement‑data} Runs a test and displays the results. disable object {statement‑data} Prevents a feature from operating. download object {statement‑data} Transfers data to the storage array or hardware associated with the storage array. enable object {statement‑data} Allows a feature to operate. recopy object {statement‑data} Restarts a virtual disk copy operation by using an existing virtual disk copy pair.
Table 7.
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=in
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. If you set enclosureLossProtect=FALSE, the storage array performs operations, but the disk group you create might not have enclosure loss protection.
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. NOTE: The virtualDisksPerGroupCount parameter is the number of equal capacity virtual disks per disk group.
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. tcpListeningPort (tcp-port-id) 3260, or 49,152 to 65,536 The default value is 3260.
• 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; • Use the show statement to embed comments in a script file that you want to display while the script file is running. Enclose the text you want to display in quotation marks (" ").
Configuring A Storage Array 3 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. Before configuring the storage array, become familiar with the concepts of physical disks, disk groups, virtual disks, host groups, hosts, and RAID controller modules.
• 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.
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;" The summary information is also returned as the first section of information when you use the profile parameter.
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.
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. See Using The Auto Configure Command. The enclosureLossProtect parameter turns on or turns off enclosure loss protection for the disk group.
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.
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.
• 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. • The segmentSize parameter defines the amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk.
• 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. Setting The Storage Array Password The set storageArray command enables you to define a password for a storage array.
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. An example of the command is: client>smcli 123.45.67.
• 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 ...
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).
3. 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. 4. Fill in the information for the selected tab and click OK. The dialog box closes, and the Enterprise Management Window appears. An email alert is sent to the specified email address when an error occurs on the storage arrays or hosts that you selected.
Using The Snapshot Feature 4 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. If you are using the Snapshot Virtual Disk (Legacy) premium feature, see Using The Snapshot (Legacy) Feature.
• 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.
• • • • • 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. A base virtual disk can reside on either a disk group or disk pool.
• 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.
• 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.
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.
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.
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.
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. You must add the snapshot groups using the set consistencyGroup addCGMember command.
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. The default action is to delete the images.
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. To add a new member virtual disk, the consistency group must fewer than the maximum number of virtual disks allowed in your configuration.
• 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. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk.
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.
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. CAUTION: Possible loss of data access—Correct use of this command depends on the data configuration on the physical disks in the disk group.
Using The Snapshot (Legacy) Feature 5 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 (legacy) premium feature. If you are using the Snapshot Virtual Disk using PiT groups, see Using The Snapshot Feature.
Table 9. Snapshot Virtual Disk Components Component Description Source virtual disk Standard virtual disk from which the snapshot is created Snapshot virtual disk Point-in-time image of a standard virtual disk Snapshot repository virtual disk Virtual disk that contains snapshot metadata and copy-on-write data for a particular snapshot virtual disk The following table lists the snapshot virtual disk commands and brief descriptions of what the commands do. Table 10.
• 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.
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. Close all applications, including Windows Internet Explorer, to make sure all I/O activity has stopped.
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. The following example shows a command in which users assign the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVolume= \"Mars_Spirit_4\" repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5);" The command i
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\" repositoryDiskGroup=2 freeCapacityArea=2;" The command in this example creates a new snapshot repository virtual disk in disk group 2. The source virtual disk is Mars_Spirit_4.
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 physicalDiskType Specifies the type of physical disk to use for the snapshot repository virtual disk. The type must be specified as Serial Attached SCSI (SAS).
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.) repositoryPercentOfSource Specifies the size of the snapshot repository virtual disk as a percentage of the source virtual disk size. The default value is 20, which represents 20 percent of the source virtual disk size.
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.
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\" \"Mars_Spirit_4-2\" \"Mars_Spirit_4-3\"] warningThresholdPercent=50 repositoryFullPolicy=failSourceWrites;" The following example is the script file version of the comma
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.
Using The Virtual Disk Copy Feature 6 This chapter describes how the Virtual Disk Copy feature works, lists the script commands for Virtual Disk Copy, and explains how to use the commands to create and run Virtual Disk Copy. Additional information about Virtual Disk Copy and related definitions is available in the online help, the Deployment Guide, the MD Storage Manager online help, and the Administrator's Guide.
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.
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. The following steps show the general process for creating a virtual disk copy: 1. Enable the Virtual Disk Copy feature. 2. Determine candidates for a virtual disk copy. 3. Create the target virtual disk and source virtual disk for a virtual disk copy.
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. To ensure that the host server is properly prepared to create a virtual disk copy, you can either use an application to carry out this task, or you can perform the following steps: 1.
The command in this example copies the data from the source virtual disk named Jaba_Hut to the target virtual disk named Obi_1.
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. The highest priority supports the virtual disk copy, but I/O activity might be affected.
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.
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.
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 virtualDiskCopy target [\"Obi_1\"];" The following example is the script file version of the
Using The Remote Replication Premium Feature 7 The following types of Remote Replication premium features are supported on the MD storage array: Remote Replication Standard asynchronous replication using point-in-time images to batch the 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).
primary virtual disk of the pair are tracked by the RAID controller firmware and captured in a point-intime 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. Point-in-time images on the primary virtual disk and the secondary virtual disk can be resynchronized in a batch approach that increases replication throughput.
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.
• 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. Virtual disks added to the group on the remote storage array serve the secondary role.
• The secondary virtual disk must be of equal or greater size than the primary virtual disk. • The RAID level of the secondary virtual disk does not have to be the same as the primary virtual disk. Setting Up Remote Replication Setting up Remote Replication between local and remote storage arrays consists of the following: • Enabling Remote Replication (on both storage arrays) • Activating the Remote Replication premium feature on both the local and remote storage arrays.
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.
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=(d
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.
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.
Using The Remote Replication (Legacy) Premium Feature 8 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.
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. Hosts then are able to read from and write to the newly promoted virtual disk, and business operations can continue.
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.
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.
3. Determine candidates for a remote replicated pair. 4. 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.
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. You can re-enter the command using the value from the error message for the repository storage space value.
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.
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. This command returns a list of the virtual disks that you can use when creating a remote replication. The command takes this form: c:\...\smX\client>smcli 123.
data on the primary virtual disk as possible. The highest synchronization priority does, however, use more system resources, which can reduce system performance.
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. This example shows the suspend remoteReplication command: c:\...\smX\client>smcli 123.45.67.88 123.45.67.
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. Deleting a virtual disk in a replication relationship removes the replication relationship and completely deletes the virtual disk from the storage array.
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. CAUTION: Before using the source virtual disk of a snapshot virtual disk as your target, you must disable all snapshot virtual disks associated with the source virtual disk.
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. Virtual Disk Expansion A Virtual Disk Expansion (VDE) is a modification operation that increases the capacity of a standard virtual disk or a snapshot repository virtual disk.
Maintaining A Storage Array 9 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.
Recovered media error The physical disk could not read the requested data on its first attempt. 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 mismatches Consistency errors are found, and a media error is forced on the block stripe so that it is found when the physical disk is scanned again. If consistency is repaired, this forced media error is removed.
RAID 0 virtual disks No redundancy exists. 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 ...
• 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 ...
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 than requiring an actual read from a physical disk Current KB/second Curren
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] | ) 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. You can identify the virtual disk by name or World Wide Identifier (WWID) (see Set Virtual Disk).
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: • • • A storage array can have only one SSD cache.
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.
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.
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.
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. The initialization process cannot be cancelled once it has begun.
Script Commands 10 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. This chapter describes the script commands used to configure, monitor, and maintain a storage array.
• 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. • Parentheses shown in the command syntax enclose specific choices for a parameter. That is, if you want to use the parameter, you must use one of the values shown in the parentheses.
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. In other uses, you must put angle brackets (< >) around the WWID.
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 iSCSI Commands Create iSCSI Initiator Delete iSCSI Initiator Reset Storage Array iSCSI Baseline Save Storage Array iSCSI Statistics Set iSCSI Initiator Set iSCSI Target Properties Show
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 Stop Physical Disk Blink Stop physical disk channel blink Stop Physical Disk Channel Fault Isolation Diagnosti
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 Reset Remote Replication Group Statistics
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 Start SSD Cache Performance Modeling Stop SSD Cache Performance Modeling Suspend SSD Cache Storage Array Commands Activate Storage Array Firmware Autoconfigure Storage Array Autoconfigure Storage Array Hot Spares Clea
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 Show Storage Array Show Storage Array Auto Configure Show Storage Array Host Topology Show Storage Array LUN Mappings Show Storage
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 131
Commands Listed Alphabetically 11 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.
Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 0, 1, 5, or 6. repositoryPhysicalDisks The physical disks for the replication repository 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.
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.
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. When you create a new repository virtual disk, you identify an existing disk group or an existing disk pool where you want the repository virtual disk.
Parameter Description If the specified virtual disk is an existing repository virtual disk or an existing snapshot virtual disk, the command fails. repositoryVirtualDisk This parameter performs two functions: • • capacity In an existing consistency group that has a repository virtual disk, this parameter identifies the repository virtual disk. When creating a new repository virtual disk this parameter identifies either a disk group or disk pool in which to create the new repository virtual disk.
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.
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. 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.
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. Optionally, you also can define the capacity of the repository virtual disk.
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. raidLevel RAID level of the disk group that contains the physical disks in the storage array.
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 None.
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 asyncRemoteReplicationGroup The name of the remote replication group for which you want to cancel the pending role reversal operation. Enclose the remote replication group name in square brackets ([ ]).
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.
Parameters Parameter Description asyncRemoteReplicationGroup The alphanumeric identifier (including - and _) of the remote replication group on which to run a consistency check. Enclose the remote replication group identifier in square brackets ([ ]). localVirtualDisk Specifies the alphanumeric identifier of a local virtual disk that participates in the replication relationship. You can specify a local virtual disk that is either the source or the destination on a replication relationship.
Parameter Description check. Enclose the snapshot group identifier in square brackets ([ ]). snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk on which to run a consistency check. Enclose the snapshot virtual disk identifier in square brackets ([ ]). virtualDisk The alphanumeric identifier (including - and _) of the thin virtual disk on which to run a consistency check. Enclose the virtual disk identifier in square brackets ([ ]).
Parameters Parameter Description remoteStorageArrayName The name for the remote storage array for which you are checking connectivity. Enclose the storage array name in double quotation marks (" "). remoteStorageArrayNameWwid The World Wide Identifier (WWID) of the storage array for which you are checking connectivity. You can use the WWID instead of the storage array name to identify the storage array. Enclose the WWID in angle brackets (< >).
Parameter Description special characters, you must also put quotation marks (" ") around the virtual disk name. consistencyErrorFile Name of the file in which to save the consistency error information. You must put quotation marks (" ") around the file name. mediaErrorFile Name of the file in which to save the media error information. You must put quotation marks (" ") around the file name. priority Specifies the priority that the consistency check has relative to host I/O activity.
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. These type of faults must be reviewed, but do not require any changes to the 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," you also must enclose the virtual disk name in double quotation marks (" ") inside square brackets.
Parameter Description information returns the storage array to its initial state. diskGroups The setting to remove the virtual disk configuration 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. You must remove and re-add the storage array to resume communication with the host.
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. Syntax clear storageArray firmwarePendingArea Parameters None. Clear Storage Array Recovery Mode Description This command forces a storage array to exit recovery mode.
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. You must put brackets ([ ]) around the virtual disk name.
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 arrays when a critical Major Event Log (MEL) event is detected.
Parameter Parameter Description baseVirtualDisk The alphanumeric identifier (including - and _) of 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. Description This command creates a new, empty consistency group that can contain snapshot groups.
Parameter Description selected to purge the snapshot images for a repository full policy. The default value is 32. enableSchedule Whether the ability to schedule a snapshot 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. schedule Use this parameter to schedule a snapshot operation.
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. This is not considered an error condition.
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. When you create a snapshot virtual disk of a consistency group, you are creating a virtual disk with contents that you can view.
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. repositoryFullLimit The percentage of repository capacity at which the consistency group snapshot repository virtual disk is nearing full. Use integer values. For example, a value of 70 means 70 percent. readOnly The setting to determine whether you can write to the snapshot virtual disk or only read from the snapshot virtual disk.
• 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 cgSn
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...
Parameter Description physicalDiskType The type of physical disk that you want to use in the virtual disk. You cannot mix physical disk types. The valid physical disk type is SAS. You must specify a physical disk type. capacity The size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB.
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. This action increases the chance that a future request for data can be fulfilled from cache.
• 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.
Parameters Parameter Description physicalDisks The physical disks you want to assign to the disk 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. physicalDiskType Physical disk type value is sas. Enclose the physical disk type values in parentheses.
Parameter Description • enabled—The virtual disk candidates have security enabled. The default value is none. physicalDiskMediaType You must use this parameter when you have more than one type of physical disk media in your storage array. Valid physical disk media are: • • • • hdd—Use this option when you have hard disk drives. ssd—Use this option when you have solid state disks. unknown—Use this option if you are not sure what types of physical disk media are in the expansion enclosure.
[hostType=(hostTypeIndexLabel | hostTypeIndexNumber)] Parameters Parameter Description userLabel The name that you want to give the host that you are creating. Enclose the host name in double quotation marks (“ ”). hostGroup The name of the host group in which you want to create a new host. Enclose the host group name in double quotation marks (“ ”). (If a host group does not exist, you can create a new host group by using the create hostGroup command.
Syntax create hostPort identifier="wwid" userLabel="portLabel" host="hostName" interfaceType=SAS Parameters Parameter Description identifier WWID of the HBA host port. You must put quotation marks (" ") around the WWID. userLabel Name to give the new HBA host port. You must put quotation marks (" ") around the port label. host Name of the host for which you are defining an HBA host port. You must put quotation marks (" ") around the host name.
Parameters Parameter Description iscsiName The default identifier of the iSCSI initiator. userLabel The name that you want to use for the iSCSI initiator. Enclose the name in double quotation marks (" "). host The name of the host in which the iSCSI initiator is installed. chapSecret The password that you want to use to authenticate a peer connection. NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection.
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. diskGroupUserLabel The alphanumeric identifier (including – and _) that you want to give the new disk group. Enclose the disk group identifier in double quotes (" ").
Parameter Description information about the enclosureLossProtect parameter, see Enclosure Loss Protection. drawerLossProtect The setting to enforce drawer loss protection when you create the replication repository disk group. To enforce drawer loss protection, set this parameter to TRUE. The default value is FALSE. dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases. The default value is TRUE.
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. freeCapacityArea Index number of the free space in an existing disk group to use to create the new virtual disk.
Parameter Description cacheReadPrefetch The setting to turn on or turn off cache read prefetch. To turn on cache read prefetch, set this parameter to TRUE. To turn off cache read prefetch, set this parameter to FALSE. segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512.
Syntax create virtualDisk physicalDisks (enclosureID1,drawerID1,slotID1 enclosureID2,slotID2...
Parameter Description userLabel Name that you want to give the new virtual disk. 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. Names can have a maximum of 30 characters. capacity Size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB.
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. dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases. The default value is TRUE. securityType The setting to specify the security level when creating the disk groups and all associated virtual disks.
Parameter Description Size is defined in units of MB, GB, or TB. The following are examples of the syntax: • • capacity=500MB capacity=2GB thinProvisioned This parameter enables thin provisioning for the new virtual disk. To use thin provisioning, set this parameter to TRUE. For no thin provisioning, set this parameter to FALSE. owner The RAID controller module that owns the 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.
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 (:): • The name of the snapshot group. • The identifier of the snapshot image.
Parameter Description remoteStorageArrayName The name of the remote storage array. Enclose the remote storage array name in double quotation marks (“ ”). remoteStorageArrayWwn The World Wide Identifier (WWID) of the remote storage array. Enclose the WWID in double quotation marks (“ ”). remotePassword The password for the remote storage array. Use this parameter when the remote storage array is password protected. Enclose the password in double quotation marks (“ ”).
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.
Parameter Description replication group name in double quotation marks (" "). The name must be unique on the local and remote storage arrays. remoteStorageArrayName The name for the remote storage array on which you are replicating the remote replication group. Enclose the storage array name in double quotation marks (" "). The remote storage array must have the same connection type as the local storage array.
Parameter Description NOTE: You must set the Recovery Point Threshold to be twice as large as the synchronization interval threshold. warningThresholdPercent Specify the length of time to wait until a warning is triggered when the capacity of a replication repository virtual disk reaches the defined percentage. Define the threshold by percentage (%) of the capacity remaining.
repository virtual disk that is used to save data for all of the snapshot images that are part of the snapshot group.
Parameter Description repositoryFullLimit The percentage of repository capacity at which 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. autoDeleteLimit The maximum number of snapshot images that you want to automatically delete if you have selected to purge the snapshot images for the repository full policy. The default value is 32.
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. For example, certain types of repository virtual disk failures can cause a Failed state. To recover from a Failed state use the revive snapGroup command.
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.
enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule)] Parameters Parameter Description baseVirtualDisk The name of the base virtual disk from which you want to take a snapshot (legacy). Enclose the base virtual disk name in double quotation marks (" "). repositoryRAIDLevel Use this parameter when you create a new disk group. The RAID level for the snapshot (legacy) repository disk group. Valid values are 1, 5, or 6.
Parameter Description virtual disk. To enforce enclosure loss protection, set this parameter to TRUE. The default setting is FALSE. physicalMediaType The type of physical disk media that you want to use for the disk group. Valid physical disk media consists of: • • • • HDD—Use this option when you have hard physical disks in the expansion enclosure. SSD—Use this option when you have solid state physical disks in the expansion enclosure.
Parameter Description repositoryPercentOfSource The size of the snapshot (legacy) repository virtual 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. repositoryUserLabel The name to give to the snapshot (legacy) repository virtual disk. Enclose the snapshot (legacy) repository virtual disk name in double quotation marks (" ").
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.
startTime The time of a day you want to create a snapshot (legacy) virtual disk and start performing a copy-on-write operation. The format for entering 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. scheduleInte rval Amount of time, in minutes, that defines a minimum between two copy-on-write operations.
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 userLabel The alphanumeric identifier (including - and _) that you want to give to a snapshot virtual disk. Enclose the snapshot virtual disk name in double quotation marks (" ").
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 (:): • The name of the snapshot group. • The identifier of the snapshot image.
Parameter Description (#) for the identifier. Identifiers can have a maximum of 30 characters. physicalDisks The physical disks that you want to use to create 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. For low-capacity expansion enclosures, specify the enclosure ID value and the slot ID value for each physical disk that you assign to the SSD cache.
file=fileName | commitSecurityKey=(TRUE | FALSE) Parameters Parameter Description keyIdentifier A character string that you can read that is a wrapper around a security key. passPhrase A character string that encrypts the security key so that you can store the security key in an external file. file The file path and the file name to which you want to save the security key. For example, file="C:\Program Files\CLI\sup\seckey.slk" NOTE: You must add a file extension of .slk to the end of the file name.
• 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. • The pass phrase must contain at least one non-alphanumeric character, for example, < > @ +. If your pass phrase does not meet these criteria, you receive an error message and you must retry the command.
Parameters Parameter Description source Name of an existing virtual disk to use as the 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. 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.
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.
Parameter Description characters, you must enclose the snapshot consistency group name in double quotation marks (" "). deleteRepositoryMembers The setting to delete on or retain the repository virtual disks. To delete the repository virtual disks, set this parameter to TRUE. To retain the repository virtual disks, set this parameter to FALSE. The default setting is FALSE. Delete Consistency Group Snapshot Image Description This command deletes the snapshot images in a consistency group.
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.
Syntax delete diskGroup [diskGroupNumber] Parameter Parameter Description diskGroup Number of the disk group to delete. You must put brackets ([ ]) around the disk group number. Delete Disk Pool Description This command deletes a disk pool. Syntax delete diskPool [diskPoolName] Parameter Parameter Description diskPoolName The alphanumeric identifier of the disk pool (including – and _) that you want to delete. Enclose the disk pool name in square brackets ([ ]).
Parameter Parameter Description host Name of the host to delete. You must put brackets ([ ]) 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. Delete Host Group Description This command deletes a host group. CAUTION: This command deletes all of the host definitions in the host group.
Syntax delete hostPort [hostPortName] Parameter Parameter Description hostPort Name of the HBA host port to delete. You must put 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. An HBA host port provides a host access to the virtual disks in a storage array. If the host bus adapter has only one physical connection (one host port), the terms HBA host port and host bus adapter are synonymous.
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) Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group that you want to delete.
(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 (" "). If you enter more than one snapshot group name, enclose each of the snapshot group names in double quotation marks (" ").
Parameter Description snapImageID The snapImageID parameter accepts only the 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.
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 snapVirtualDisk The name of the snapshot virtual disk that you want to delete.
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 (" "). schedule Deletes the schedule for a specific snapshot virtual disk. Only the schedule is deleted, the snapshot virtual disk remains.
Syntax delete (allVirtualDisks | virtualDisk [virtualDiskName] |virtualDisks [virtualDiskName1... virtualDiskNameN]) removeDiskGroup=(TRUE | FALSE) Parameters Parameter Description allVirtualDisks Deletes all virtual disks in a storage array. 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.
Parameters Parameter Description allVirtualDisks This parameter deletes all of the virtual disks on a 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 ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" ").
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.
Parameter Description NOTE: When you run a data loop-back test, you can optionally specify a file that contains a data pattern. If you do not specify a file, the RAID controller module firmware provides a default pattern. patternFile File path and file name of the file that contains a data pattern to use as test data. Enclose the path and file name with quotation marks (" ").
Parameter Description testID Specifies the identifier for the diagnostic test you 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. • The date and time the test was run. • RAID Controller Module • Status: – OK: All of the pairs of cables are good and do not have any faults. – Open: One or more of the four pairs of cables are open.
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 ([ ]). If the primary virtual disk name has special characters, the primary virtual disk name must also be enclosed in double quotation marks (“ ”). Disable Storage Array Feature Description This command disables a storage array feature.
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. It cannot be run in the MD Storage Manager script editor. Syntax supportBundle schedule show Parameters None.
Parameter Description • file 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. File path and file name of the file that contains the firmware image. You must put quotation marks (" ") around the firmware image file path and file name.
Parameters Parameter Description physicalDisk Physical disk to which to download the firmware 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. filename File path and file name of the file that contains the firmware image. You must put quotation marks (" ") around the firmware image file path and file name.
Parameter Description downgrade to TRUE if you want to download an earlier version of firmware. activateNow Activates the firmware and NVSRAM images. The 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. Download Storage Array Physical Disk Firmware Description This command downloads firmware images to all of the physical disks in the storage array.
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 (" "). For example: file="C:\Program Files\CLI\dnld \afrm.dlp" Valid file names have a .dlp extension.
Parameter Parameter Description diskGroup The alphanumeric identifier (including - and _) of 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: • All physical disks in the disk group must be self-encrypting disk (SED) physical disks. • The Physical Disk Security premium feature must be enabled.
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.
Parameter Parameter Description controller RAID controller module that you want to revive. 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. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify a RAID controller module, the storage management software returns a syntax error.
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.
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. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk. The syntax for virtual disk mapping is listed separately.
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. To obtain a validator, use the save storageArray dbmValidator command to generate an XML file that contains validator information.
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.
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.
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. targetReadOnlyEnabled Specifies whether the target virtual disk is write enabled or read only.
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 repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 1, 5, or 6.
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. The command can be re-entered using the value from the error message for the repository storage space value.
Parameter Description virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. userLabel Name of the snapshot virtual disk. You must put quotation marks (" ") around the snapshot virtual disk name. If you enter more than one snapshot virtual disk name, this command fails. warningThresholdPercent Percentage of repository capacity at which you receive a warning that the repository is nearing full. Use integer values.
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.
Parameter Description • The old repository virtual disk will be deleted by default. diskPoolUserLabel Use this parameter to allocate a new repository virtual disk with the specified capacity. retainRepositoryMember If this parameter is set to TRUE, the old repository is retained. By default, the old repository is deleted. This parameter is ignored if the existing repository is reused.
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 Description consistencyGroupName The name of the consistency group from which you want to remove a member.
Parameter Description the identifier in double quotation marks (" ") inside square brackets. removePhysicalDisks The physical disks that you want to remove from 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. For low-capacity expansion enclosures, specify the enclosure ID value and the slot ID value for each SSD that you want to remove. Enclosure ID values are 0 to 99.
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 target Name of the target virtual disk to remove. 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 (" ") around the target virtual disk name.
Parameters Parameter Description virtualDisk The name of the specific virtual disk that you want to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" ") inside square brackets ([ ]). asyncRemoteReplicationGroup The name of the remote replication group that contains the member virtual disk that you want to remove. Enclose the remote replication group name in double quotation marks (" ").
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 inband agent. host Name of the host to which the virtual disk is mapped. You must put quotation marks (" ") around the host name.
Rename SSD Cache Description This command changes the name of the SSD cache. Syntax set ssdCache [old_ssdCacheName] userLabel="new_ssdCacheName" Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of 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 (" ") inside square brackets.
Parameter Description special characters, you must also put quotation marks (" ") around the virtual disk name. consistencyErrorFile Name of the file that contains the consistency error information you use to repair the errors. You must put quotation marks (" ") around the file name. verbose Captures progress details, such as percent complete, and shows the progress detail information as virtual disk consistency is being repaired. To capture progress details, set this parameter to TRUE.
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. You can use this command to notify the local storage array that the iSCSI IP address of the remote storage array have changed and need to be updated.
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.
Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for 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 (" ") inside square brackets.
• 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. Syntax reset storageArray batteryInstallDate controller=(0 | 1) Parameter Parameter Description controller Specifies the RAID controller module that contains the battery for which to reset the age.
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. NOTE: The reset storageArray SASPHYBaseline command clears error counts for all devices except the physical disks. After running this command, the .
Syntax resume cgSnapVirtualDisk ["snapVirtualDiskName"] cgSnapImage="snapImageName" Parameters Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot 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 (" ") inside square brackets ([ ]). cgSnapImage The name of the snapshot image in a consistency group that you are restarting.
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 primary or primaries The name of the primary virtual disk for which you want to resume operation. More than one primary virtual disk name can be entered.
Syntax resume asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] [deleteRecoveryPointIfNecessary] Parameter Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to start synchronization. Enclose the remote replication group name in double quotation marks (" ") inside square brackets ([ ]").
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. Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]).
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.
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"]; To resume snapshot virtual disk operations for the most recent snapshot image in a snapshot group that has the name sna
Syntax revive diskGroup [diskGroupNumber] Parameter Parameter Description diskGroup Number of the disk group to be set to the optimal 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.
Parameter Parameter Description physicalDisk Identifies the enclosure and slot where, the 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. Revive Snapshot Group Description This command forces the specified snapshot group to the Optimal state. If the snapshot group is not in a Failed state, the firmware displays an error message and does not run this command.
Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of 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. Log sense data is maintained by the environmental cards for each enclosure. Not all of the environmental cards contain log sense data.
Parameter Description Valid values for the identifier number are 1 or 2. Enclose the identifier number in square brackets ([ ]). file The name of the file in which you are storing the results of the fault isolation diagnostics test on the drive channel. Enclose the name in double quotation marks (" "). NOTE: A file extension is not automatically appended to the saved file. You must specify the applicable format suffix for the file. If you specify a file extension of .
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. file Name of the file in which to save the values. You must put quotation marks (" ") around the file name. Save Remote Replication Group Statistics Description This command saves to a file the synchronization statistics for one or more member virtual disks in a remote replication group.
Parameter Description the remote replication group name in double quotation marks (" ") inside square brackets. file The file path and the file name to which you want to save the synchronization statistics. Enclose the file name in double quotation marks (" "). For example: file="C:\Program Files\CLI\logs \iscsistat.csv" This command does not automatically append a file extension to the saved file. You can use any file name, but you must use the .csv extension. virtualDisk This parameter is optional.
• 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.
Parameter Description prevent saving the host topology, set this parameter to FALSE. The default value is FALSE. lunMappings Saves the LUN mapping to the file. To save the LUN mapping, set this parameter to TRUE. To prevent saving the LUN mapping, set this parameter to FALSE. The default value is FALSE. NOTE: When you use this command, you can specify any combination of the parameters for global setting, virtual disk configuration setting, host topology, or LUN mapping.
Parameters Parameter Description sourceLocation This parameter specifies the location from which 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. controller This parameter specifies the controller from which data will be exclusively retrieved, if sourceLocation is set to onboard.
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.
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. • Warning events—Errors occurring on the storage array resulting in degraded performance or reduced ability to recover from additional errors.
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.
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 file Specifies name of the file to which to save the performance statistics.
Save Storage Array State Capture Description This command saves the state capture to a file. Syntax save storageArray stateCapture file="filename" Parameters Parameter Description file Name of the file to which to save the state capture. You must put quotation marks (" ") around the file name. Save Storage Array Support Data Description This command saves the storage array support-related information to a file.
Parameters Parameter Description file The path and the file name where support-related 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. A file extension must be specified when entering the file name. force Forces collection of support data when there is a failure in securing a lock on controller operations.
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. When you enable scheduling, you use the schedule parameter to define when you want the snapshots to occur.
Parameter Description endDate Specific date to stop creating a snapshot virtual disk and end the copy-on-write operations. The format is MM:DD:YY, where MM is the month, DD the day and YY the year. For example: endDate=11:26:11. noEndDate Use this option to prevent a scheduled copy-onwrite operation from ending. If you later decide to end the copy-on-write operations, you must reenter the create snapshotVirtualDisk command and specify an end date.
autoDeleteLimit=numberOfSnapImages| rollbackPriority=(lowest | low | medium | high | highest)] Parameters Parameter Description consistencyGroupName The name of the consistency group for which you are setting properties. Enclose the consistency group name in double quotation marks (" ") inside square brackets ([ ]). userLabel The new name that you want to give to the snapshot consistency group. Enclose the new consistency group name in double quotation marks (" ").
Parameters Parameter Description cgSnapVirtualDisk The name of the consistency group virtual disk that you want to rename. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]). userLabel The new name that you want to give to the snapshot virtual disk in the consistency group. Enclose the new snapshot virtual disk name in double quotation marks (" ").
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. NOTE: When using this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters.
Syntax set diskGroup [diskGroupName] forcedState Parameters Parameter Description diskGroup Sequence number of the disk group for which to 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. The CLI provides three commands that let you move the physical disks. The commands are start diskGroup export, start diskGroup import, and set diskGroup forcedState.
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. criticalPriority This parameter governs the priority for critical reconstruction activities on the disk pool. backgroundPriority This parameter governs the priority for background task activities on the disk pool.
Parameters Parameter Description enclosureID Identifies a specific enclosure for which to set the attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. chassisName Chassis name or number to give the new enclosure. Chassis names can be any combination of alphanumeric characters with a maximum length of 32 characters. Alphabetical characters can be uppercase or lowercase. You can also use the underscore character (_) and the hyphen (‑) character.
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. The latter failure creates an incomplete disk group on the new storage array.
Parameters Parameter Description host The name of the host that you want to assign to a 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 (" "). hostGroup The host group to which you want to assign the host. (The following table defines how the command runs if the host does or does not have individual virtual disk-to-LUN mappings.) Enclose the host group name in double quotation marks (" ").
Set Host Channel Description This command defines the loop ID for the host channel. Syntax set hostChannel [hostChannelNumber] preferredID=portID Parameters Parameter Description hostChannel The identifier number of the host channel for 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. Enclose the host channel identifier number in square brackets ([ ]).
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. You can also change an HBA host port label with this command.
host=”newHostName” | chapSecret=”newSecurityKey”) Parameters Parameter Description iscsiID The name of the iSCSI initiator for which you want to set attributes. userLabel The new name that you want to use for the iSCSI initiator. host The name of the new host to which the HBA host port is connected. Enclose the host name in double quotation marks (" "). chapSecret The password that you want to use to authenticate a peer connection.
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.
Parameters Parameter Description physicalDisk or physicalDisks The enclosure and the slot where the physical disk 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 ([ ]). hotSpare The setting to assign the physical disk as the hot spare. To assign the physical disk as the hot spare, set this parameter to TRUE. To remove a hot spare assignment from a physical disk, set this parameter to FALSE.
nvsramBitSetting)] [IPv4GatewayIP=ipAddress] [IPv6RouterAddress=ipv6Address] [iscsiHostPort [(0 | 1 | 2 | 3)] iscsiHostPortOptions] [rloginEnabled=(TRUE | FALSE)] [serviceAllowedIndicator=(on | off)] Parameters Parameter Description controller The controller for which you want to define 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. Enclose the identifier for the controller in square brackets ([ ]).
Parameter Description subnet mask address, the IPv4 priority, and the IPv6 priority. rloginEnabled The setting for whether the remote login feature is 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. serviceAllowedIndicator The setting for whether the Service Action Allowed indicator light is turned on or turned off. To turn on the Service Action Allowed indicator light, set this parameter to on.
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. Setting the availability parameter to serviceMode causes the alternate controller to take ownership of all of the virtual disks.
Syntax set snapVirtualDisk ["snapImageVirtualDiskName"] convertReadOnlyToReadWrite [repositoryVirtualDisk="repos_xxxx" | repositoryFullLimit=percentValue] Parameters Parameter Description snapVirtual Disk The name of the snapshot virtual disk that you want to change from read-only to read/write. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside of square brackets ([ ]). repositoryVirtualDisk The name of the repository virtual disk has the snapshot image.
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 (" ") inside square brackets. localVirtualDisks The names of several local virtual disks for which you want to define properties.
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 condition. To force a role reversal, set this parameter to TRUE.
Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group that you 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. If the virtual disk name consists only of numbers, such as "1002," you also must enclose the virtual disk name in double quotation marks (" ") inside square brackets.
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. disabled—Automatic resynchronization is turned off. To resynchronize the primary virtual disk and the secondary virtual disk, you must run the resume remoteReplicationGroup command.
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 ( ). role Use this parameter to promote the remote replication group to a primary role or demote the remote replication group to a secondary role. To define the remote replication group as the primary role, set this parameter to primary.
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 errorAction How the session responds if an error is 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.
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 snapGroup The alphanumeric identifier (including - and _) of the snapshot group for which you are setting properties.
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. Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters.
Set Snapshot Group Repository Virtual Disk Capacity Description This command increases or decreases the capacity of a snapshot group repository virtual disk.
Syntax set snapGroup ["snapGroupName"] enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule) Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group for which you are setting properties. Enclose the snapshot group name in double quotation marks (" ") inside of square brackets ([ ]). enableSchedule Use this parameter to turn on or to turn off the ability to schedule a snapshot operation.
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).
Parameter Description rollbackPriority Determines whether system resources must be allocated to the rollback operation at the expense of system performance. A value of 0 indicates that the rollback operation is prioritized over all other host I/O. A value of 4 indicates that the rollback operation must be performed with minimal impact to the host I/O. Notes When you use this command, you can specify one or more of the optional parameters.
Parameter Description scheduleInterval Amount of time, in minutes that defines a minimum between two copy-on-write operations. It is possible for you to create a schedule in which you have overlapping copy-on-write operations because of the duration of a copy operation. You can ensure that copy-on-write operations maintain a correct interval by using this option. The maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180.
NOTE: If you also use the scheduleInterval option, the firmware chooses between the timesPerDay option and the scheduleInterval option by selecting the lowest value of the two options. The firmware calculates an integer value for the scheduleInterval option by dividing 1440 by the scheduleInterval option value that you set. For example, 1440/180 = 8. The firmware then compares the timesPerDay integer value with the calculated scheduleInterval integer value and uses the smaller value.
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 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 cacheBlockSize The cache block size that is used by the RAID controller module for managing the cache.
Parameter Description userRole Defines the user role for the password. The user 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. If you do not use the userRoleparameter, the storage array uses any password that you define as the administrator password.
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. For best protection, the password must meet these criteria: • • • • • The password must be between eight and 30 characters long. The password must contain at least one uppercase letter.
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. If the number of enclosures in the list does not match the total number of enclosures in the storage array, an error message is shown.
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 isnsIPv6Address The IPv6 address that you want to use for the iSNS server. Set Storage Array iSNS Server Listening Port Description This command sets the iSNS server listening port.
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.
Parameter Parameter Description redundancyMode Use simplex mode when you have a single RAID 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.
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 unnamedDiscoverySession This parameter turns on or turns off unnamed discovery sessions. Set the parameter to TRUE to turn on unnamed discovery sessions. Set the parameter to FALSE to turn off unnamed discovery sessions.
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 ([ ]). virtualDisk The World Wide Identifier (WWID) of the virtual disk for which you are setting properties.
Set Virtual Disk Description This command defines the properties for a virtual disk. You can use most of the parameters to define properties for one or more virtual disks, however, some of the parameters define properties for only one virtual disk at a time. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk. The syntax for virtual disk mapping is listed separately.
Parameters Parameter Description allVirtualDisks Specifies the properties for all virtual disks in the storage array. virtualDisk or virtualDisks (name) Specifies the name of the virtual disk for which to define properties. You can enter more than one virtual disk name if you use the virtualDisks parameter. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets.
Parameter Description readCacheEnabled The setting to turn on or turn off the read cache. To turn on the read cache, set this parameter to TRUE. To turn off the read cache, set this parameter to FALSE. writeCacheEnabled The setting to turn on or turn off the write cache. To turn on the write cache, set this parameter to TRUE. To turn off the write cache, set this parameter to FALSE. cacheReadPrefetch The setting to turn on or turn off cache read prefetch.
Parameter Description preReadRedundancyCheck The setting to check the consistency of RAID redundancy data on the stripes during read operations. Do not use this operation for nonredundant virtual disks, for example RAID Level 0. To check redundancy consistency, set this parameter to TRUE. For no stripe checking, set this parameter to FALSE. accessVirtualDisk Specifies the logical unit number for the access virtual disk.
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. Syntax set (allVirtualDisks | virtualDisk ["virtualDiskName"] | virtualDisks ["virtualDiskName1" ...
Parameter Description addPhysicalDisks The setting to add new physical disks to the virtual 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 lowcapacity expansion enclosures, specify the enclosure ID value and the slot ID value for the physical disk. Enclosure ID values are 0 to 99. Drawer ID values are 1 to 5. Slot ID values are 0 to 31.
Parameter Description preReadConsistencyCheck The setting to turn on or turn off preread 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. To turn off preread consistency checking, set this parameter to FALSE.
Cache Flush Modifier Valid values for the cache flush modifier are listed in the following table. Value Description Immediate Data is flushed as soon as it is placed into the cache. 250 Data is flushed after 250 ms. 500 Data is flushed after 500 ms. 750 Data is flushed after 750 ms. 1 Data is flushed after 1 s. 1500 Data is flushed after 1500 ms. 2 Data is flushed after 2 s. 5 Data is flushed after 5 s. 10 Data is flushed after 10 s. 20 Data is flushed after 20 s.
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. Cache read prefetch is important for multimedia applications that use sequential data transfers.
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. source Specifies the name of the source virtual disk for which to define properties. You must put brackets ([ ]) around the source virtual disk name. If the source virtual disk name has special characters, you must also put quotation marks (" ") around the source virtual disk name.
Parameters Parameter Description virtualDisk The name of the specific virtual disk for which you 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. You can use the WWID instead of the virtual disk name to identify the virtual disk. Enclose the WWID in angle brackets (< >). accessVirtualDisk The logical unit number for the virtual disk.
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: • • The name of the consistency group. An identifier for the snapshot image in the consistency group.
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"]; To show the snapshot images in several snapshot consistency groups that has the names snapCGroup1, snapCGroup2, and snapCGroup3, you would use this command: sho
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.
Parameter Parameter Description diskGroup Number of the disk group for which to display 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.
Parameter Parameter Description diskPool The alphanumberic identifier of the disk pool (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: • HBA host port identifier • HBA host port name • HBA host type Syntax show allHostPorts Parameters None.
– 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. The physical disk information is also returned when you issue the show storageArray profile command.
Parameter Description physicalDiskType The type of physical disk for which you want to retrieve information. The valid physical disk type is SAS. physicalDisk or physicalDisks Identifies the enclosure and slot where the physical disk resides. You can enter enclosure IDs and slot IDs for one or several physical disks. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put parentheses around the enclosure ID values and the slot ID values.
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. If any firmware downloads fail, this command shows the firmware download status of each targeted physical disk.
Syntax show (allControllers | controller [(0 | 1)]) [summary] Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. controller Returns information about a specific RAID 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 enclosure.
Parameter Description hostTypeTable command to generate a list of available host type identifiers. host Specifies the name of the host connected to the 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.
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.
Syntax show remoteReplication candidates primary= ”virtualDiskName” remoteStorageArrayName=storageArrayName Parameters Parameter Description primary The name of the local virtual disk that you want for the primary virtual disk in the remote-replicated pair. Enclose the primary virtual disk name in double quotation marks (“ ”). remoteStorageArrayName The remote storage array that contains possible virtual disks for a secondary virtual disk.
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 allSnapGroups The parameter to return information about all of the snapshot groups in the storage array. snapGroup or snapGroups The name of the specific snapshot group for which you are retrieving information.
Total Repository Capacity Available Repository Capacity Snapshot Image Limit Snapshot Images Scheduled 10.318 GB 10.318 GB (100%) 0 0 No 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.
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. Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]). You can enter more than one snapshot name or sequence number. Enclose all of the snapshot names in one set of double quotation marks (" ") inside square brackets ([ ]).
Parameters Parameter Description allSnapVirtualDisks The parameter to return information about all of 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. Enclose the snapshot virtual disk name in square brackets ([ ]). When you enter more than one snapshot virtual disk identifier, separate the identifiers with a space.
Syntax show ssdCache [ssdCacheName] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of 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 (" ") inside square brackets. Notes This command returns the SSD cache information similar to this example.
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 ssdCache The alphanumeric identifier (including - and _) of the SSD cache for which you want to get information. Enclose the identifier in square brackets ([ ]).
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.
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. Partial Hits Blocks Number of blocks in Partial Hits. Partial cache hits and partial cache hit blocks result from an operation that has only a portion of its data in the SSD cache.
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 %. Show Storage Array Description This command returns configuration information about the storage array.
Parameter Description NOTE: The previous command syntax is for a host running Windows. The actual syntax varies depending on your operating system. autoSupportConfig The parameter to return information about the current state of the operation to automatically collect support data.
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. To determine whether the storage array can support specific properties, enter the parameter for the properties when you issue this command.
Parameter Description virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group. Use integer values. hotSpareCount Number of hot spares desired in the storage array. Use integer values. For information about hot spares, see Assigning Global Hot Spares. segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512.
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.
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.
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. Syntax show “textString” Parameters None. NOTE: You must enclose the string in double quotation marks (“ ”).
Parameter Description name has special characters, you also must enclose the virtual disk name in double quotation marks (" "). consumedCapacity The setting to return a concise list of information about the consumed capacity of the thin virtual disks. expansionHistory The setting to return a concise list of information about the expansion history of the thin virtual disks. file The file parameter specifies a file to log the output of the expansionHistory parameter.
• 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) – The write cache status (enabled or disabled) – The write cache without batteries status (enabled or disabled) – The write cache with mirroring status (enabled or disabled) – The flush write cache after time – The cache read prefetch setting (TRUE or FALSE) – The
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: Next Run Time: Start Date: End Date: | "No End Date" End Date: Days of Week: , , …. Times for snapshot recreate:
Syntax show virtualDiskCopy (allVirtualDisks | source ["sourceName"] | target ["targetName"]) Parameters Parameter Description allVirtualDisks Returns information about virtual disk copy operations for all virtual disk copy pairs. source Name of the source virtual disk about which to retrieve information. You must put quotation marks (" ") and brackets ([ ]) around the source virtual disk name. The source virtual disk name and quotation marks must be inside the brackets.
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 source Name of the source virtual disk for which you are trying to find a candidate target virtual disk. You must put quotation marks (" ") and brackets ([ ]) around the source virtual disk name.
Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1... virtualDiskNameN] reservations Parameters Parameter Description allVirtualDisks Returns reservation information about all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which you are retrieving reservation information. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name.
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.
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"); Start Disk Group Blink Description This command identifies the physical disks tha
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. Syntax start diskGroup [diskGroupName] export Parameters Parameter Description diskGroup Number of the disk group to defragment.
Parameters Parameter Description diskGroup Number of the disk group to defragment. You 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. You must run the show diskGroup importDependencies command before you run the start diskGroup import command.
Start iSCSI DHCP Refresh Syntax start controller [(0 | 1)] iscsiHostPort [(1 | 2 | 3 | 4)] dhcpRefresh Parameters Parameter Description controller The identifier letter of the RAID controller module 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. iscsi-host-port The identifier of the port on the storage array on which you want to refresh the DHCP parameters.
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.
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. testDevices The identifiers of the devices (RAID controller modules, EMMs, or physical disks) that you want to test. You can specify all or enter the specific identifiers for the devices that you want to diagnose. dataPattern The method of repeatability that you want to test.
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 physicalDisk Identifies the enclosure and slot where the physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31.
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 primary The name of the primary virtual disk for which you want to start synchronization. Enclose the primary virtual disk name in double quotation marks (“ ”) inside square brackets ([ ]).
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. To stop a snapshot rollback operation, use the stop rollback virtual disk command.
Parameter Parameter Description snapImage The name of the snapshot image. The name of a 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: • • • An integer value that is the sequence number of the snapshot in the snapshot group. NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group.
Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to locate. 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 (" ") inside square brackets.
[diagnosticType = (fileSystem | mirror | contentCheck)] [controller[(0 | 1)]] Parameters Parameter Description sourceLocation This parameter specifies the location of the 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. diagnosticType The level of diagnostic testing that you want to run on the database.
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. This can have adverse effects on host I/O processing.
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.
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. The related consistency group snapshot virtual disk becomes disabled and unusable.
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.
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. Syntax stop enclosure blink Parameters None.
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. Syntax stop physicalDiskChannel blink Parameters None.
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 .
Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group for which you want to stop pending snapshot images. Enclose the snapshot group identifier in square brackets ([ []). consistencyGroup The alphanumeric identifier (including - and _) of the snapshot consistency group for which you want to stop pending snapshot images. Enclose the snapshot group identifier in square brackets ([ []).
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.
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: • Enclose all of the names in square brackets ([ ]). • Enclose each of the names in double quotation marks (" "). • Separate each of the names with a space.
Syntax stop snapImage [snapImageName] rollback Parameter Parameter Description snapImage The name of the snapshot image for which you want to stop a rollback operation. The name of a 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: • • • An integer value that is the sequence number of the snapshot in the snapshot group.
Syntax stop snapVirtualDisk ["snapVirtualDiskName"] Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk that you want to stop. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]). Stop SSD Cache Performance Modeling Description This command stops the performance modeling operation and displays the performance modeling data for the SSD cache.
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 HDD Reads HDD Writes Cache Capacity Overall Response Time Avg. Response Time % of I/Os Avg. Response Time % of I/Os Avg.
1489 GB 0 % 1675 GB 0 % 1862 GB 0 % * = 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.
Stop Storage Array iSCSI Session Description This command forces the termination of an iSCSI session. Syntax stop storageArray iscsiSession [sessionNumber] Parameters Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]).
Parameters Parameter Description target Name of the target virtual disk for which to stop a 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 (" ") around the target virtual disk name. source Name of the source virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the source virtual disk name.
NOTE: If the writeConsistency parameter is set to TRUE, the virtual disks must be in a writeconsistency 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 suspends A-A’, B-B’, and C-C’.
Syntax suspend ssdCache [ssdCacheName] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of 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 (" ") inside square brackets. Notes To restart caching, use the resume ssdCache command.
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.
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. • The pass phrase must contain at least one number. • The pass phrase must contain at least one non-alphanumeric character, for example, < > @ +. NOTE: If your pass phrase does not meet these criteria, you receive an error message.
Sample Script Files 12 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.
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. The first line of text is the show string command. This command displays text bounded by quotation marks (" ") on a monitor screen when the script file runs.
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 dis
CLI Command Updates 13 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. 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.
• 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 • Establish Remote Replicated Pair • Modify Disk Pool • Reinitialize Thin Virtual Disk • Remove Incomplete Remote Replicated Pair from Remote Replication Group • Remove Member Virtual Disk From Consistency Group • R
• 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 • Show Snapshot Virtual Disks • Show SSD Cache • Show SSD Cache Statistics • Show Storage Array Core Dump • Show Storage Array DBM Database • Show Storage Array Host Topology • Show Thin Virtual Disk • Start Consistency Group Snapshot Ro
• 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) 396
