Dell PowerVault MD 34XX/38XX Series 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. Copyright © 2014 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 CLI Command Updates.......................................................................................... 17 New Commands..................................................................................................................................17 Updated Commands........................................................................................................................... 17 2 About The Command Line Interface.................................................................
Before Using Snapshot CLI Commands.............................................................................................55 Snapshot Images And Groups............................................................................................................ 55 Snapshot Groups And Snapshot Consistency Groups...................................................................... 56 Snapshot Groups............................................................................................................
Stopping And Deleting A Snapshot Virtual Disk................................................................................. 78 Re-creating The Snapshot Virtual Disk ........................................................................................78 Preparing Host Servers To Re-create A Snapshot Virtual Disk....................................................78 Re-creating A Snapshot Virtual Disk.............................................................................................
Deleting A Remote Replication Group...............................................................................................98 Removing A Virtual Disk Or Repository Virtual Disk From A Remote Replication Group................98 Disabling The Remote Replication Premium Feature....................................................................... 98 Deactivating The Remote Replication Premium Feature..................................................................
Performance Tuning..........................................................................................................................118 Monitoring Performance............................................................................................................. 118 Changing RAID Levels................................................................................................................. 119 Changing Segment Size.........................................................................
12 Commands Listed Alphabetically................................................................... 137 Activate Remote Replication Feature............................................................................................... 137 Activate Storage Array Firmware...................................................................................................... 139 Add Member To Consistency Group...............................................................................................
Create Read-Only Snapshot Virtual Disk......................................................................................... 182 Create Remote Replication...............................................................................................................183 Create Remote Replication Group................................................................................................... 185 Create Snapshot Group....................................................................................
Enable RAID Controller Module Data Transfer................................................................................226 Enable Storage Array Feature........................................................................................................... 227 Establish Remote Replicated Pair.....................................................................................................228 Increase Virtual Disk Capacity On A Disk Pool...............................................................
Revive Snapshot Group.....................................................................................................................261 Revive Snapshot Virtual Disk.............................................................................................................261 Save Enclosure Log Data.................................................................................................................. 262 Save Physical Disk Channel Fault Isolation Diagnostic Status...........................
Set Session........................................................................................................................................ 300 Set Snapshot Group Attributes......................................................................................................... 301 Set Snapshot Group Media Scan......................................................................................................302 Set Snapshot Group Repository Virtual Disk Capacity...................................
Show SNMP MIB II System Group Variables....................................................................................344 Show Snapshot Group......................................................................................................................344 Show Snapshot Image......................................................................................................................346 Show Snapshot Virtual Disks............................................................................
Start Snapshot Rollback.................................................................................................................... 375 Start Snapshot Image Rollback.........................................................................................................376 Start SSD Cache Performance Modeling......................................................................................... 377 Start Storage Array Blink...........................................................................
13 Sample Script Files............................................................................................. 403 Configuration Script Example 1....................................................................................................... 403 Configuration Script Example 2.......................................................................................................
CLI Command Updates 1 This chapter reflects new and updated commands that are available for use with the Dell PowerVault MD34XX/MD38XX Series storage arrays. NOTE: Not all commands are 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.
• Activate Remote Replication (Legacy) • Download Storage Array NVSRAM • Resume Remote Replication Group • Resume Snapshot (Legacy) Rollback • Set RAID Controller Module • Set Remote Replication (Legacy) • Set Storage Array • Start Remote Replication Synchronization • Stop Snapshot (Legacy) Rollback 18
About The Command Line Interface 2 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 3 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 4 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.
virtualDiskConfigAndSettings=(TRUE | FALSE) | 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.
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 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 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 6 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.
Creating A Snapshot Virtual Disk The create snapshotVirtualDisk command provides three methods for defining the physical disks for your snapshot repository virtual disk: • Define each physical disk for the snapshot repository virtual disk by enclosure ID and slot ID. • Define a disk group in which the snapshot repository virtual disk resides. Optionally define the capacity of the repository virtual disk.
Preparing Host Servers To Create An Initial Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the source virtual disk. 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.
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.
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 7 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.
Using The Remote Replication Premium Feature 8 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 9 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 10 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 11 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.
Save Enclosure Log Data Set Enclosure Attribute Set Enclosure Identification 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
Save Physical Disk Log Set Virtual Disk Set Foreign Physical Disk to Native 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 phys
Check Remote Replication Group Consistency Check Remote Replication Status Create Remote Replication 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
Re-Create Snapshot Set Snapshot Virtual Disk Stop Snapshot 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 Autoconfigu
Save Storage Array SAS PHY Counts Save Storage Array State Capture Save Storage Array Support Data 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
Show Virtual Disk Reservations Start Virtual Disk Initialization 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 135
Commands Listed Alphabetically 12 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 raidControllerModule 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 • RAID configuration data includes disk groups and associated virtual disks. 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 RAID controller modules 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.
• A critical MEL event indicating the presence of a miswire condition • A “Needs Attention” condition • A Recovery Action indicating the miswire In addition, the RAID controller module reports “Redundancy Loss” information for the physical disks, EMMs, and enclosures for which it has only one access path due to the miswire (for example the bottom two enclosures in a storage array). The Redundancy Loss information is not unique to SAS topologies.
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.
Notes Each disk pool name must be unique. You can use any combination of alphanumeric characters, underscore (_), hyphen(-), and pound (#) for the user label. User labels can have a maximum of 30 characters. You might want to remove selected physical disks from a disk pool if you need to create a separate group or remove unneeded capacity from the storage array.
Register SNMP Trap Destination Description This command creates a new Simple Network Management Protocol (SNMP) trap destination. A trap destination is the SNMP manager that you want to have receive the trap messages. Syntax create snmpTrapDestination trapReceiverIP=ipAddress communityName="communityName" [sendAuthenticationFailureTraps=(TRUE | FALSE)] Parameters Parameter Description trapReceiverIP The IP address of the SNMP manager to which you want to send trap messages.
Parameter Description enclose the virtual disk name in double quotation marks (" "). existingRepositoryLabel Causes the repository virtual disk to be replaced by the candidate virtual disk specified. • • • The value specified is an existing repository virtual disk user label. The virtual disk specified must be an unused repository virtual disk with the name in the proper form.
Parameter Description name in double quotation marks (" "). 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. incompleteAsyncRemoteReplication The name of the orphaned virtual disk that you want to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" ").
Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache from which you want to remove SSDs. 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. removePhysicalDisks The physical disks that you want to remove from the SSD cache.
Parameter Description 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 (" "). 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.
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.
NOTE: This command resets the baseline to 0 for both RAID controller modules in the storage array. The purpose of resetting both of the RAID controller module baselines is to help ensure that the counts are synchronized between the RAID controller modules. If one RAID controller module resets but the second RAID controller module does not reset, the host is informed that the RAID controller modules are out of synchronization. The host is informed by the time stamps that are reported with the statistics.
Resume Consistency Group Snapshot Virtual Disk Description This command restarts a copy-on-write operation for creating a consistency group snapshot virtual disk that you stopped using the stop cgSnapVirtualDisk command. 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.
For example, if you want to restart a copy-on-write operation for snapshot image 12345 which is in snapshot consistency group snapgroup1 in a consistency group snapshot virtual disk that has the name snapVol1, you would use this command: resume cgSnapVirtualDisk ["snapVol1"] cgSnapImage=["snapgroup1:12345"] Resume Remote Replication Description NOTE: This command valid only with Fibre Channel storage arrays. This command resumes a suspended Remote Replication operation.
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. raidControllerModule This parameter specifies the RAID controller module 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.
Parameter Description data Store the data generated by the command at the location specified by the pathName. 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.
Parameter Description maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180. endDate Specific date to stop creating a snapshot virtual disk and end the copy-on-write operations. The format is MM:DD:YY, where MM is the month, DD the day and YY the year. For example: endDate=11:26:11. noEndDate Use this option to prevent a scheduled copy-onwrite operation from ending.
Syntax set consistencyGroup ["consistencyGroupName"] [userLabel="consistencyGroupName" | repositoryFullPolicy=(failBaseWrites | purgeSnapImages)| repositoryFullLimit=percentValue| 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 ([ ]).
Syntax set cgSnapVirtualDisk [consistencyGroupName] userLabel="snapVirtual DiskName" 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 raidLevel The RAID level for the disk group. Valid values are 0, 1, 5, or 6. owner The RAID controller module that owns the disk group. 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. Use this parameter only if you want to change the disk group owner.
not work because of hardware errors. In a Forced state, the disk group can be imported, and you can then identify the hardware errors. 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.
Parameter Description warningThreshold The percentage of disk pool capacity at which you receive a warning alert that the disk pool is nearing 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.
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 Event Alert Filtering Description The set event alert commands manage alert event notification by either disabling a specific critical event alert from being sent, or by enabling notification about a specific critical event alert to be sent. To prevent notification about a specific critical event alert from being sent, you block it. To enable notification about a specific critical event alert to be sent, you unblock it.
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. Description Run this command to add the missing (foreign) physical disks back into their original disk group and to make them part of the new storage array disk group configuration of the new storage array.
Parameter Description 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 (" "). The defaultGroup is the host group that contains the host to which the virtual disk is mapped.
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 RAID controller module number and the host channel number. Enclose the host channel identifier number in square brackets ([ ]). Separate the RAID controller module number from the host channel number with a comma.
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. Syntax set hostPort [portLabel] host=“hostName” userLabel=“newPortLabel” Parameters Parameter Description hostPort The name of the HBA host port for which you want to change the host type, or for which you want to create a new name. Enclose the HBA host port name in square brackets ([ ]).
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.
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 raidControllerModule The RAID controller module for which you want to define properties. Valid RAID controller module identifiers are 0 or 1, where 0 is the RAID controller module in the top slot, and 1 is the RAID controller module in the bottom slot.
Parameter Description The values that support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, the 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.
Options for the Ethernet Port Parameter IPv4Priority=[0-7] | IPv6Priority=[0-7] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) | IPv4VlanId=[1-4094] | 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 parameters. You need not to use all the parameters.
Set Read-Only Snapshot Virtual Disk To A Read/Write Virtual Disk Description This command changes a snapshot virtual disk that is a read-only virtual disk to a snapshot virtual disk that is read/write virtual disk. You can also use this command to define the repository for the read/write virtual disk.
NOTE: Starting with firmware 8.10, some RAID controller modules no longer support the writeOrder parameter and the writeMode parameter. Syntax set remoteReplication (localVirtualDisk [virtualDiskName] | localVirtualDisks [virtualDiskName1 ...
Parameter Description secondary virtual disks of a remote-replicated pair. 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 disks and the secondary virtual disk, you must run the resume remoteReplication command.
Syntax set asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] [syncInterval=integer (minutes | hours | days) warningSyncThreshold=integer (minutes | hours | days) warningRecoveryThreshold=integer (minutes | hours | days) warningThresholdPercent=percentValue userLabel="New_remoteReplicationGroupName" autoResync=(TRUE | FALSE) virtualDisk="virtualDiskName" increaseRepositoryCapacity (repositoryVirtualDisk="repos_xxxx" | repositoryVirtualDisk=(diskGroupName [capacity=capacityValue]) repositoryVirt
Parameter Description warningThresholdPercent Specify the percent value that determines when 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. userLabel The new name that you want to give to the remote replication group. Use this parameter when you want to rename the remote replication group. Enclose the new remote replication group name in double quotation marks (" ").
Parameter Description name of either a 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. If you want to define the capacity you can use these values: • • • An integer value that represents a percentage of the base virtual disk capacity. A decimal fraction value that represents a percentage of the base virtual disk capacity. A specific size for the repository virtual disk.
additional standard virtual disks to it. The composite expandable repository virtual disk capacity then becomes the sum of the capacities of all of the concatenated standard virtual disks. A remote replication group repository virtual disk must satisfy a minimum capacity requirement that is the sum of the following: • 32 MB to support fixed overhead for the remote replication group and for copy-on-write processing.
Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (You can define a storage array password by using the set storageArray command.) The polling interval and the number of iterations that you specify remain in effect until you end the session.
Parameter Description autoDeleteLimit The maximum number of snapshot images that you want to automatically delete if you have selected to purge the snapshot images for a repository full policy. Use integer values. The default value is 32. rollBackPriority Use this parameter to determine whether system resources should be allocated to the rollback operation at the expense of system performance. Valid values are highest, high, medium, low, or lowest.
Parameter Description the storage array level, this parameter has no effect.) consistencyCheckEnabled The setting to turn on or turn off consistency checking during a media scan. To turn on consistency checking, set this parameter to TRUE. To turn off consistency checking, set this parameter to FALSE. Set Snapshot Group Repository Virtual Disk Capacity Description This command increases or decreases the capacity of a snapshot group repository virtual disk.
Set Snapshot Group Schedule Description This command defines the schedule for taking snapshot images for a snapshot group. 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 ([ ]).
Set Snapshot (Legacy) Virtual Disk Description This command defines the properties for a snapshot virtual disk and lets you rename a snapshot virtual disk. Syntax set (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...
Parameter Description schedule Use this parameter to schedule a snapshot operation, with the following options: • • • • • • • • • immediate startDate scheduleDay startTime scheduleInterval endDate noEndDate timesPerDay timeZone For more information, see Scheduling Snapshots. rollbackPriority Determines whether system resources must be allocated to the rollback operation at the expense of system performance. A value of 0 indicates that the rollback operation is prioritized over all other host I/O.
Parameter Description no start date is provided, the current date is used. For example: startDate=06:27:11. scheduleDay Defines a day of the week you want to create a snapshot virtual disk and perform a copy-on-write operation. The values that you can enter are: monday, tuesday, wednesday, thursday, friday, saturday, sunday, and all. For example: scheduleDay=wednesday. startTime Defines time of a day you want to create a snapshot virtual disk and start performing a copyon-write operation.
Parameter Description Chicago" or "Germany/Berlin". Time zone text strings are case sensitive. If you enter an incorrect text string, the default time zone is GMT.
Parameter Description set this parameter to FALSE. (If media scan is disabled at the storage array level, this parameter has no effect.) consistencyCheckEnabled The setting to turn on or turn off consistency checking during a media scan. To turn on consistency checking, set this parameter to TRUE. To turn off consistency checking, set this parameter to FALSE.
Notes When you use this command, you can specify only one of the parameters. You cannot enter more than one parameter when you run this command. Set Storage Array Description This command defines the properties of the storage array.
Parameter Description mediaScanRate The number of days over which the media scan runs. Valid values are disabled, which turns off the media scan, or 1 day to 30 days, where 1 day is the fastest scan rate, and 30 days is the slowest scan rate. A value other than disabled or 1 to 30 does not allow the media scan to function. password The password for the storage array. Enclose the password in double quotation marks (" "). userRole Defines the user role for the password.
When you define values to stop a cache flush, the lower the value, the higher the chance that the data for a host read requires a physical disk read rather than reading from the cache. Default Host Type When you define host types, if Storage Partitioning is enabled, the default host type affects only those virtual disks that are mapped in the default group.
Additional Information This command defines the position of an enclosure in a storage array by the position of the enclosure ID in the enclosurePositions list.
Parameter Parameter Description isnsIPv4Address The IP address that you want to use for the iSNS server. Use this parameter with the static value for IPv4 configurations. If you choose to have a DHCP server set the IP address for an IPv4 Internet iSNS server, you must set the isnsIPv4Address parameter to 0.0.0.0. Set Storage Array iSNS Server IPv6 Address Description This command sets the IPv6 address for the iSNS server.
Additional Information A listening port resides on the database server and is responsible for these activities: • Listening (monitoring) for incoming client connection requests • Managing the traffic to the server When a client requests a network session with a server, a listener receives the actual request. If the client information matches the listener information, then the listener grants a connection to the database server.
Set Storage Array Redundancy Mode Description This command sets the redundancy mode of the storage array to either simplex or duplex. Syntax set storageArray redundancyMode=(simplex | duplex) Parameter Parameter Description redundancyMode Use simplex mode when you have a single RAID controller module.
Set Storage Array Time Description This command sets the clocks on both RAID controller modules in a storage array by synchronizing the RAID controller module clocks with the clock of the host from which you run this command. Syntax set storageArray time Parameters None. Set Storage Array Unnamed Discovery Session Description This command enables the storage array to participate in unnamed discovery sessions.
Syntax set (virtualDisk ["virtualDiskName"] | virtualDisks ["virtualDiskName1" ... "virtualDiskNameN"] | virtualDisk ) [newCapacity=capacityValue | repositoryMaxCapacity=capacityValue| repositoryExpansionPolicy=(automatic|manual)| warningThresholdPercent=integer-literal | addRepositoryCapacity=capacity-spec] Parameters Parameter Description virtualDisk or virtualDisks The name of the specific virtual disk for which you want to define properties.
Notes When you use this command, you can specify one or more of the optional parameters. 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.
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.
The output has one line for each event that is blocked, listing the type of event in a hexadecimal format followed by a description of the event. Following is an example of the output: Executing Script... 0x280D Enclosure Failure 0x282B Enclosure Redundancy Lost Script execution complete. Syntax show blockedEventAlertList Parameters None Show Consistency Group Snapshot Image Description This command shows one snapshot image or several snapshot images that are in one or more snapshot consistency groups.
Parameter Description sequence number. Enclose all of the snapshot names in one set of double quotation marks (" ") inside square brackets ([ ]). Separate each snapshot image name with a white space. allCGSnapImages The setting to return all of the snapshot images from the consistency groups. summary The setting to return a concise list of information about all of the snapshot images in the storage array.
Parameters Parameter Description initiatorName The name of the iSCSI initiator for which session information is desired. Enclose the iSCSI initiator name in double quotation marks (“ ”). The name and quotation marks must also be enclosed in either square brackets ([ ]) or angle brackets (< >). If the name is longer than 30 characters, the angle brackets must be used. targetName The name of the iSCSI target for which session information is desired.
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 Export 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 Description to TRUE. To let the physical disks stay spinning, set this parameter to FALSE. NOTE: This command returns the dependencies of a specific disk group, which must be in an Exported state or a Forced state. If a decision is made to retain the listed dependencies, then the cancelImport parameter can be enforced to spin the physical disks back down. You must run the show diskGroup importDependencies command before you run the start diskGroup import command.
HOST PORT IDENTIFIER HOST PORT NAME HOST TYPE 12:34:56:54:33:22:22:22 Jupiter1 Solaris 12:34:56:78:98:98:88:88 Pluto 1 Windows 2000/Server 2003 Clustered 54:32:12:34:34:55:65:66 Undefined Undefined Show Physical Disk Description For each physical disk in the storage array, this command returns the following information: • The total number of physical disks • The type of physical disk (SAS) • Basic physical disk information: – Enclosure location and slot location – Status – Capacity – Data t
Parameter Description NOTE: To determine information about the type and location of all physical disks in the storage array, use the allPhysicalDisks parameter. driveMediaType retrieve information. Valid physical disk media are these: • • • • • 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.
Syntax show (physicalDiskChannel [(1 | 2)] | physicalDiskChannels [1 2] | allPhysicalDiskChannels) stats Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk port for which to display information. Valid physical disk port values are 1 or 2. You must put brackets ([ ]) around the physical disk channel values. physicalDiskChannels Identifier number of the physical disk ports for which to display information. Valid physical disk port values are 1 or 2.
Show RAID Controller Module Description For each RAID controller module in a storage array, this command returns the following information: • Status (Online, Offline) • Current firmware and NVSRAM configuration • Pending firmware and NVSRAM configuration configurations (if any) • Board ID • Product ID • Product revision • Serial number • Date of manufacture • Date and time to which the RAID controller module is set • Associated virtual disks (including preferred owner) • Ethernet port
Syntax show (allRAIDControllerModules | raidControllerModule [(0 | 1)]) NVSRAM [hostType=( hostTypeIndexLabel | host="hostName")] Parameters Parameter Description allRAIDControllerModules Returns information about both RAID controller modules in the storage array. raidControllerModule Returns information about a specific RAID controller module in the storage array. Valid RAID controller module identifier values are 0 and 1.
Parameters Parameter Description allAsyncRemoteReplicationGroups Use this parameter if you want to display the properties for all remote replication groups. asyncRemoteReplicationGroup Use this parameter to display the properties for a remote replication group. 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.
Parameter Description replication group name has special characters, you also must enclose the remote replication group name in double quotation marks (" ") inside square brackets. If the remote replication group name consists only of numbers, such as "1002," you also must enclose the remote replication group name in double quotation marks (" ") inside square brackets. synchronizationProgress Use this optional parameter to display the periodic synchronization progress of the remote replication group.
Description This command returns the progress of data synchronization between the primary virtual disk and the secondary virtual disk in a Remote Replication configuration. This command shows the progress as a percentage of data synchronization that has been completed. Syntax show remoteReplication (localVirtualDisk [“virtualDiskName”] | localVirtualDisks [“virtualDiskName1” ...
Parameters Parameter Description allSnmpCommunities This parameter returns information about all of the SNMP communities in the storage array. communityName The name of the SNMP community for which you want to retrieve information. Enclose the SNMP community name in double quotation marks (" "). snmpCommunities The names of several SNMP communities for which you want to retrieve information.
Show SNMP MIB II System Group Variables Description This command returns information about the Simple Network Management Protocol (SNMP) system variables. The system variables are maintained in a Management Information Base II (MIB-II) database. Syntax show snmpSystemVariables Parameters None. Notes This command returns SNMP system variables information similar to this example. SYSTEM VARIABLES Sys Name: NONE Sys Contact: NONE Sys Location: NONE Minimum Firmware Level 8.
Parameter Description If you enter more than one snapshot group name, separate each name with a space. Enclose all of the snapshot group names in only one set of double quotation marks (" "). summary The parameter to return a concise list of information about the snapshot groups. schedule The parameter to return a concise list of information about the schedules for the snapshot group copy operations.
Show Snapshot Image Description This command returns information about the snapshot images that a user had previously created. Syntax For Showing A Specific Snapshot Image show (snapImage ["snapImageName"] | snapImages ["snapImageName1 ... snapImageNamen"] | allSnapImages]) [summary] Parameters Parameter Description snapImage or snapImages The name of the snapshot image. The name of a snapshot image is comprised of two parts: • • The name of the snapshot group.
• The identifier of the snapshot image.
Name Type Status Capacity Associated Base Volume 2_SV_0001 Standard Optimal 3.000 GB 2 Snapshot Volume Timestamp Snapshot Image Timestamp Mode 1/23/12 6:44:31 PM IST 1/23/12 6:27:36 PM IST Read Write Total Repository Capacity Available Repository Capacity 1.199 GB 0.125 MB (0%) The size of your monitor determines how the information wraps and will affect how the information appears. Show SSD Cache Description This command displays information about the SSD cache.
Additional capacity allowed 1,304.852 GB Physical disk capacities: All 278.896 GB Data Service (DS) Attributes Security capable: No Secure: No Data Assurance (DA) capable: No Associated physical disks: Enclosure Slot 0 4 0 11 Virtual disks using SSD cache: virtualDisk_test Show SSD Cache Statistics Description This command displays data about the SSD cache usage.
Parameter Description If you do not specify a RAID controller module, the default value is both. The file path and the file name to which you want to save the SSD cache statistics. Additional statistics are available when you save the statistics to a file. file Enclose the file name in double quotation marks (" "). For example: file="C:\Program Files\CLI\logs \statistics.csv".
The reason this number is lower than 100% is that each allocation unit of the SSD cache, the SSD cache cache-block, is divided into smaller units called sub-blocks, which are filled somewhat independently. A higher number is generally better, but performance gains can be significant even with a smaller number. These additional statistics are included when you save the data to a file: Read Blocks Number of blocks in host reads. Write Blocks Number of blocks in host writes.
Populate Actions (Host Writes) - Blocks Number of blocks in Populate Actions (Host Writes). Invalidate Actions Number of times data was invalidated/removed from the SSD cache. A cache invalidate operation is performed for every host write request, every host read request with Forced Unit Access (FUA), every verify request, and in some other circumstances. Recycle Actions Number of times that the SSD cache block has been reused for another base virtual disk and/or a different LBA range.
Parameters Parameter Description profile Displays all properties of the logical and physical components that comprise the storage array. The information returned takes several screens to display. NOTE: The profile parameter returns detailed information about the storage array. The information covers several screens on a display. You might need to increase the size of your display buffer to see all the information.
Parameter Description hotSpareCoverage Displays information about which virtual disks of the storage array have hot spare coverage and which virtual disks do not. features Displays a list of the feature identifiers for all enabled features in the storage array. time Displays the current time to which both RAID controller modules in the storage array are set. virtualDiskDistribution Displays the current RAID controller module owner for each virtual disk in the storage array.
segmentSize=segmentSizeValue cacheReadPrefetch=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description physicalDiskType Type of physical disk to use for the storage array. Valid physical disk type is 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. Valid RAID levels are 0, 1, 5 or 6.
Show Storage Array Core Dump Description This command show details of the core dump on the RAID controller module cache, if a core dump is available. Syntax show storageArray coreDump Parameters None. Show Storage Array DBM Database Description This command retrieves and shows metadata for the on-board backup locations of a storage array. When there are multiple backup locations, metadata is shown for each location. Syntax show storageArray dbmDatabase Parameters None.
Show Storage Array LUN Mappings Description This command returns information from the storage array profile about the storage array LUN mappings. If you run this command with no parameters, this command returns all LUN mappings. Syntax show storageArray lunMappings [host ["hostName"] | hostgroup ["hostGroupName"]] Parameters Parameter Description host Name of a specific host for which to see the LUN mappings. You must put quotation marks (" ") and brackets ([ ]) around the host name.
Show Storage Array Power Information Description This command returns information about the amount of power consumed by the entire storage array and each enclosure in the storage array. Syntax show storageArray powerInfo Parameters None Notes This command returns power consumption information similar to this example.
• Accessible by (host or host group) • Date/time • Virtual disk-relative logical block address (hexadecimal format – 0xnnnnnnnn) • Physical disk location (enclosure t, slot s) • Physical disk-relative logical block address (hexadecimal format – 0xnnnnnnnn) • Failure type 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.
Parameters Parameter Description allVirtualDisks The setting to return information about all of the virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you are retrieving information. 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 (" ").
Show Virtual Disk Description For the virtual disks in a storage array, this command returns the following information: • The number of virtual disks • The name • The status • The capacity • The RAID level • The disk group where the virtual disk is located • 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 disabl
Parameters Parameter Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you are retrieving information. 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 (“ ”).
Show Virtual Disk Copy Description This command returns information about virtual disk copy operations. The following information is returned: • Copy status • Start timestamp • Completion timestamp • Copy priority • Source virtual disk WWID or target virtual disk WWID • Read-only attribute setting of the target virtual disk You can retrieve information about a specific virtual disk copy pair or all virtual disk copy pairs in the storage array.
Parameters None. Additional Information This command returns virtual disk copy source information as shown in this example. Virtual Disk Name: finance Capacity: 4.0 GB Disk Group: 1 Virtual Disk Name: engineering Capacity: 4.0 GB Disk Group: 2 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.
Parameters Parameter Description allvirtualDisks The setting to return performance statistics about all of the virtual disks in the storage array. virtualDisk or virtualDisks 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. The source virtual disk name and quotation marks must be inside the brackets.
Parameters None. Notes Upon completion of the diagnostic test, the RAID controller module firmware returns one of these results: • Diagnosis completed without errors. No ZIP file created. • Diagnosis completed with errors. Refer to the ZIP file created at: ...\Install_dir\data\FirmwareUpgradeReports\timestamp_buildNo.
Parameters Parameter Description consistencyGroupName The name of the consistency group for which you want to start a rollback operation. Enclose the name of the consistency group in double quotation marks (" ") inside square brackets ([ ]). When the memberVirtualDiskSet parameter is not used, the rollback process applies to all member virtual disks of the consistency group. memberVirtualDiskSet The name of one or more member base virtual disks in a consistency group that you want to rollback.
Parameters Parameter Description diskGroup Number of the disk group to identify. You must put brackets ([ ]) around the disk group number. Start Disk Group Defragment Description This command starts a defragment operation on the specified disk group. NOTE: Defragmenting a disk group starts a long‑running operation that you cannot stop. Syntax start diskGroup [diskGroupNumber] defragment Parameters Parameter Description diskGroup Number of the disk group to defragment.
Additional Information When this command is successful, you can run the start diskGroup import command to finish moving the disk group to a Complete state, which makes the disk group available to the new storage array. If this command is unsuccessful because hardware problems prevented the completion of the export, use the set diskGroup forceState command. The set diskGroup forceState command lets you use the start diskGroup import command to import a disk group.
Parameters Parameter Description diskPool The alphanumberic identifier of the disk pool (including – and _) that you want to locate. Enclose the diskPoolName in square brackets ([ ]). Start Enclosure Blink Description This command identifies an enclosure by turning on the indicator LED. (Use the stop enclosure blink command to turn off the indicator LED for the enclosure.) Syntax start enclosure [enclosureID] blink Parameters Parameter Description enclosure Identifies the enclosure to blink.
Start Physical Disk Blink Description This command blinks a physical disk by turning on an indicator light on the physical disk. Run the stop physicalDisk blink command to turn off the indicator light on the physical disk. Syntax start physicalDisk [enclosureID,slotID] blink Parameters Parameter Description physicalDisk The location of the physical disk that you want to find.
Syntax start physicalDiskChannel [(1 | 2)] raidControllerModule [(0 | 1)] faultDiagnostics testDevices=[(all | raidControllerModule=(0 | 1) | emms=[enclosureID1 slotID1, enclosureID2 slotID2... enclosureIDn slotIDn] | physicalDisks= (enclosureID1,slotID1...
NOTE: You can stop this command at any time by pressing . Start Physical Disk Initialize Description This command starts physical disk initialization. CAUTION: As soon as you enter this command, all user data is erased. Syntax start physicalDisk [enclosureID,slotID] initialize 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.
Syntax start asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] synchronize [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 ([ ]").
NOTE: When performing a secure erase operation on all physical disks in an array that contains only SED physical disk type, the physical disks must be erased in two groups using the start secureErase physicalDisks[] command.
Start Snapshot Image Rollback Description This command starts a rollback operation for a set of snapshot images. The content of the base virtual disk changes immediately to match the point-in-time content of the selected snapshot image virtual disk. The base virtual disk immediately becomes available for read/write requests after the rollback operation has successfully completed. To stop a snapshot image rollback operation, use the stop rollback snapImage command.
For example, if you want to start a rollback operation for snapshot image 12345 in a snapshot group that has the name snapGroup1, you would use this command: start snapImage ["snapGroup1:12345"] rollback; To start a rollback operation for the most recent snapshot image in a snapshot group that has the name snapGroup1, you would use this command: start snapImage ["snapGroup1:newest"]rollback; Start SSD Cache Performance Modeling Description This command starts performance modeling for the SSD cache.
Start Storage Array Blink Description This command identifies a storage array by turning on the indicator LED for the storage array. Use the stop storageArray blink command to turn off the indicator LED for the storage array. Syntax start storageArray blink Parameters None. Start Storage Array Configuration Database Diagnostic Description This command runs a consistency check against a configuration database.
Parameter Description • contentCheck parameter is set to disk, the peer RAID controller module initiates a block check. When the sourceLocation parameter is set to cache, the peer RAID controller module initiates a record check. This option performs a deep analysis of each record's contents. The default value is fileSystem. raidControllerModule The RAID controller module that has the database on which you want to run the diagnostic tests.
To stop the database configuration diagnostic test, use the stop storageArray configDbDiagnostic command. In addition, you can start the database configuration diagnostic test through the storage management software GUI; however, you cannot stop the database configuration diagnostic test through the storage management software GUI. If you want to stop a running diagnostic test, you must use the stop storageArray configDbDiagnostic command.
Stop Configuration Database Diagnostic Description This command stops the diagnostic test to validate the configuration database in the RAID controller module firmware that was started by the start storageArray configDbDiagnostic command. Syntax Stop storageArray configDbDiagnostic Parameters None. NOTE: The RAID controller module firmware returns a confirmation that the diagnostic test was cancelled.
Parameter Description a rollback operation. Enclose each member base virtual disk name in double quotation marks (" ") inside parenthesizes (( )). You can enter more than one member virtual disk name. Enclose all of the member virtual disk names in one set of double quotation marks (" ") inside parenthesizes (( )). Separate each member virtual disk name with a white space.
Stop Disk Group Blink Description This command turns off the indicator LED on the physical disk that was turned on by the start diskGroup blink command. Syntax stop diskGroup blink Parameters None. 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 consistencyGroup [consistencyGroupName] pendingSnapImageCreation Parameter Parameter Description consistencyGroupName The name of the consistency group for which you want to stop any pending snapshot operation. Enclose the name of the consistency group in square brackets ([ ]). 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.
Syntax stop physicalDiskChannel faultDiagnostics 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 .
and does not run the command. You can run this command on a snapshot group or a snapshot consistency group. Syntax stop (snapGroup [snapGroupName] | consistencyGroup [snapConsistencyGroupName]) pendingSnapImageCreation 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 ([ []).
Notes Names can be any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#). Names can have a maximum of 30 characters. One technique for naming the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk is to add a hyphenated suffix to the original base virtual disk name. The suffix distinguishes between the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk.
Parameter Description Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters or numbers, you must enclose the virtual disk name in double quotation marks (" ") inside square brackets. virtualDisks The names of several snapshot (legacy) virtual disks for which you want to stop a rollback operation. Enter the namesvirtual disks using these rules: • • Enclose all names in square brackets ([ ]). Separate each name with a space.
Stop Snapshot Image Rollback Description This command stops a snapshot image rollback operation that was initiated by the start snapImage rollback command. NOTE: Canceling a snapshot image rollback operation leaves the base virtual disk in an indeterminate state with potentially invalid or inconsistent data. The related snapshot image virtual disk becomes disabled and unusable.
To stop a rollback operation for the most recent snapshot image in a snapshot group that has the name snapGroup1, you would use this command: stop snapImage ["snapGroup1:newest"] rollback; Stop Snapshot Virtual Disk Description This command stops a snapshot virtual disk operation. Syntax stop snapVirtualDisk ["snapVirtualDiskName"] Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk that you want to stop.
Parameter Description example: file="C:\Program Files\CLI\logs \performance.csv". The default name of the file that contains the performance modeling data is readLinkStatus.csv. You can use any file name, but you must use the .csv extension. 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.
744 GB 0 % 931 GB 0 % 1117 GB 0 % 1303 GB 0 % 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.
If you try to use the stop storageArray configDbDiagnostic command after validation of the storage array configuration is complete, you do not receive any message that the validation has finished. This behavior is expected. 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.
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.
Unregister SNMP Community Description This command deletes an existing Simple Network Management Protocol (SNMP) community that you previously created and registered using the create snmpCommunity command. Deleting an SNMP community effectively unregisters the community. Any trap destinations associated with that community are also removed. Syntax delete snmpCommunity communityName="snmpCommunityName" Parameters Parameter Description communityName The name of the SNMP community that you want to delete.
Parameters Parameter Description communityName The name of the existing SNMP community that you want to rename. Enclose the SNMP community name in double quotation marks (" "). newCommunityName The new name that you want to give to the SNMP community. Enclose the SNMP community name in double quotation marks (" "). Update SNMP MIB II System Group Variables Description This command changes the system variables for the Simple Network Management Protocol (SNMP).
Update SNMP Trap Destination Description This command turns on or turns off sending authentication failure messages for an SNMP trap destination. Failure occurs when the SNMP agent received a message from an SNMP manager, but the message contained an invalid community name.
Parameter Description NOTE: You must add a file extension of .slk to the end of the file name. passPhrase A character string that encrypts the security key so that you can store the security key in an external file. 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.
Sample Script Files 13 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