Page 3 - Contents
Contents 1 CLI Command Updates...................................................................................... 16 New Commands ..................................................................................................................................16 Updated Commands ....................
Page 16 - CLI Command Updates; New Commands
1 CLI Command Updates This chapter reflects new and updated commands that are available for use with the Dell PowerVault MD 32XX/34XX/36XX/38XX Series storage arrays. NOTE: Not all commands are valid with all storage arrays. Some commands are specific to certain platforms. CAUTION: Script commands a...
Page 18 - About The Command Line Interface
2 About The Command Line Interface 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 (...
Page 19 - How To Use The Command Line Interface; Usage Notes
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• Parameter...
Page 21 - Command Line Parameters
[ host-name-or-IP-address2 ]] [-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...
Page 25 - Formatting Considerations; Detailed Error Reporting
Parameter Definition -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 ...
Page 26 - Exit Status
• 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. For error processing, errors appear as two types: • Parameter or syntax errors you might ...
Page 27 - Usage Examples
Status Value Meaning 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...
Page 29 - About The Script Commands
3 About The Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or ...
Page 30 - Script Command Structure
Operation Activities Firmware management Downloading RAID controller module, enclosure management module (EMM), and physical disk firmware Script Command Structure All script commands have the following structure: command operand-data {statement-data} where, command identifies the action to be perfo...
Page 31 - Script Command Synopsis
Object Type Identifier host User label hostChannel Host channel identifier hostGroup User label hostPort User label snapVirtualDiskName Virtual disk user label snapshot Virtual disk user label snapGroup A snapshot group contains a sequence of snapshot images of an associated base virtual disk. A sna...
Page 33 - Recurring Syntax Elements
Command Syntax Description stop object { statement ‑ data } Stops an asynchronous operation. suspend object { statement ‑ data } Suspends an operation. You can then restart the suspended operation, and it continues from the point at which it was suspended. Recurring Syntax Elements Recurring syntax ...
Page 38 - Usage Guidelines; Adding Comments To A Script File
Usage Guidelines The following list provides guidelines for writing script commands on the command line: • You must end all commands with a semicolon (;).• You can enter more than one command on a line, but you must separate each command with a semicolon (;). • You must separate each base command an...
Page 39 - Configuring A Storage Array
4 Configuring A Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks, and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts...
Page 40 - Determining What Is On Your Storage Array
Configuring A Storage Array When you configure a storage array, you can maximize data availability by ensuring that data is quickly accessible while maintaining the highest level of data protection possible. The speed at which a host can access data is affected by the disk group RAID level and the s...
Page 42 - Saving A Configuration To A File; Using The Create Virtual Disk Command
storage array activities that the commands support. Examples include virtual disk commands, host commands, enclosure commands, and others. Saving A Configuration To A File CAUTION: When you write information to a file, the script engine does not check to determine if the file name already exists. If...
Page 45 - Using The Auto Configure Command
use for virtual disk creation. You do not have to assign the entire capacity of the physical disks to the virtual disk. Assign any unused space to another virtual disk at another time. The userLabel , capacity , owner , and segmentSize parameters are the same as in the previous versions of the creat...
Page 47 - Modifying Your Configuration; Setting The Storage Array Password
After you have finished creating the disk groups and virtual disks by using the autoConfigure storageArray command, you can further define the properties of the virtual disks in a configuration using the set virtualDisk command. (See Modifying Your Configuration.) Example Of The Auto Configuration C...
Page 48 - Setting Up SMTP And SNMP Alerts; Setting The RAID Controller Module Clocks
as virtual disk creation, reset, delete, rename, or change. If you have more than one storage array in a storage configuration, each array has a separate password. Passwords can have a maximum length of 30 characters. You must put quotation marks (" ") around the password. The following exam...
Page 49 - Setting Modification Priority
running Linux. Typically, you need to change the host type only when you are setting up the storage array. The only time you might need to use this parameter is if you need to change how the storage array behaves relative to the hosts. Before you can define the default host type, you need to determi...
Page 50 - Assigning Global Hot Spares; Selecting The Event Levels For Alert Notifications
Assigning Global Hot Spares Hot spare physical disks can replace any failed physical disk in the storage array. The hot spare must be the same type of physical disk as the physical disk that failed and must have capacity greater than or equal to any physical disk that can fail. If a hot spare is sma...
Page 51 - Configuring Alert Notifications
You can configure the MD storage management software to notify only the event levels that you specify. For example, you can configure alert notifications only for Critical and Warning events. 1. Open the Configure Alerts dialog by performing one of these actions: a. Select a storage array in the Dev...
Page 52 - Using The Snapshot Feature; Before Using Snapshot CLI Commands; Snapshot Images And Groups
5 Using The Snapshot Feature The following types of virtual disk snapshot premium features are supported on the MD storage array: • Snapshot Virtual Disks using multiple point-in-time (PiT) groups• Snapshot Virtual Disks (Legacy) using a separate repository for each snapshot NOTE: This section descr...
Page 53 - Snapshot Groups And Snapshot Consistency Groups; Snapshot Groups
Only the following can be included in a snapshot image: • 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 ...
Page 54 - Understanding Snapshot Repositories; Snapshot Consistency Group Repositories; Consistency Groups And Remote Replication
• Consistency groups can be created initially with or without member virtual disks.• Snapshot images can be created for a consistency group to enable consistent snapshot images between all member virtual disks. • Consistency groups can be rolled back.• A virtual disk can belong to multiple consisten...
Page 55 - Creating Snapshot Images; Creating A Snapshot Image
Creating Snapshot Images Guidelines before creating a snapshot image: • If you attempt to create a snapshot image on a snapshot group and that snapshot group has reached its maximum number of snapshot images. The failBaseWrites or purgeSnapImages parameters used with the create snapGroup command all...
Page 56 - Creating A Consistency Group Snapshot Virtual Disk
retainCount= numberOfSnapImages | ignoreSnapVirtualDisk=(TRUE | FALSE) | snapImageID=OLDEST) Creating A Consistency Group Snapshot Virtual Disk Creating a snapshot virtual disk of a consistency group creates a viewable virtual disk of specific images in the consistency group. A consistency group sna...
Page 57 - Creating A Consistency Group Snapshot Image; Disk; Deleting A Consistency Group Snapshot Image
Create a consistency group snapshot virtual disk that has a repository full limit set to 60 percent on a snapshot consistency group named snapCG1 with these three members cgm1 , cgm2 , and cgm3 , with the following command: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageI...
Page 58 - Scheduling Snapshot Images; Starting, Stopping And Resuming A Snapshot Rollback
• The repository’s reserve space for reuse within the consistency group is released.• Any member virtual disk associated with the deleted snapshot image(s) is moved to a Stopped state.• The member snapshot virtual disks associated with the deleted snapshot image(s) is deleted. To delete two snapshot...
Page 59 - Creating A Snapshot Group
To start a rollback for a snapshot group named snapGroup1 : start snapImage ["snapGroup1"] rollback You can specify a snapshot image rollback for a specific snapshot image in a snapshot group named 12345 : stop snapImage ["snapGroup1:12345"] rollback; To stop a rollback operation for...
Page 60 - Deleting A Snapshot Group; Reviving A Snapshot Group; Creating A Consistency Group
Deleting A Snapshot Group CAUTION: All of the data in the snapshot group is lost as soon as you run this command. This command deletes an entire snapshot group and, if specified, the associated repository virtual disks. delete snapGroup [" snapGroupName "] deleteRepositoryMembers=TRUE; In th...
Page 61 - Deleting A Consistency Group; Setting Consistency Group Attributes
Deleting A Consistency Group This command deletes a snapshot consistency group. You can either delete both the consistency group and the repository virtual disks contained by the consistency group, or you can delete only the consistency group and leave the repository virtual disks contained in the c...
Page 62 - Adding A Member Virtual Disk To A Consistency Group; Removing A Member Virtual Disk From A Consistency Group
autoDeleteLimit allows you to configure each snapshot group to perform automatic deletion of its snapshot images to keep the total number of snapshot images in the snapshot group at or below a maximum number of images. When the number of snapshot images in the snapshot group is at the maximum limit,...
Page 63 - Virtual Disk
The removeCGMemberVirtualDisk parameter is the name of the member virtual disk that you want to remove; deleteRepositoryMembers determines whether the command removes all the repository members from the consistency group. To remove a virtual disk names payroll-backup from a consistency group named C...
Page 64 - Setting Snapshot Virtual Disk Repository Virtual Disk Capacity
preReadConsistencyCheck=(TRUE | FALSE) readCacheEnabled=(TRUE | FALSE) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) Syntax Applicable To Only One Virtual Disk set (virtualDisk [" virtualDiskName "] | virtualDisk <wwID>) addCapacity=virtualDiskCapacity [addPhysicalD...
Page 68 - Using Host Servers To Create An Initial Snapshot Virtual
The following table lists the components that comprise a snapshot virtual disk and briefly describes what they do. 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...
Page 69 - Creating A Snapshot Virtual Disk; Enabling The Snapshot Virtual Disk Feature
• You must satisfy the requirements of your host operating system for creating snapshot virtual disks. Failure to meet the requirements of your host operating system results in an inaccurate point-in-time image of the source virtual disk or the target virtual disk in a virtual disk copy. Creating A ...
Page 70 - Creating The Initial Snapshot Virtual Disk
Preparing Host Servers To Create An Initial Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the s...
Page 73 - User-Defined Parameters
The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=3; User-Defined Parameters Parameters for the create snapshotVirtualDisk command enable you to define the snapshot ...
Page 75 - Names Of Snapshot Virtual Disks And Repository Virtual Disks; Changing Snapshot Virtual Disk Settings
The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel="Mars_Spirit_4_snap1" repositoryUserLabel="Mars_Spirit_4_rep1" wa...
Page 76 - Stopping And Deleting A Snapshot Virtual Disk; Re-creating The Snapshot Virtual Disk
The following example shows the command to change the name of a snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisk [\"Mars_Spirit_4-1\"] userLabel=\"Mars_Odyssey_3-2\";" The following example is the script file version of the command: set virtualDisk [...
Page 77 - Preparing Host Servers To Re-create A Snapshot Virtual Disk; Re-creating A Snapshot Virtual Disk
Preparing Host Servers To Re-create A 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 and snapshot virtual disk to ensure that you capture an accurate point-in...
Page 78 - Using The Virtual Disk Copy Feature; About Virtual Disk Copy
7 Using The Virtual Disk Copy Feature 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 a...
Page 80 - Creating A Virtual Disk Copy; Enabling The Virtual Disk Copy Feature; Determining Virtual Disk Copy Candidates
Creating A Virtual Disk Copy Before creating a virtual disk copy, ensure that a suitable target virtual disk exists on the storage array, or create a new target virtual disk specifically for the virtual disk copy. The target virtual disk must have a capacity equal to or greater than the source virtu...
Page 81 - Preparing Host Servers To Create A Virtual Disk Copy; Copying The Virtual Disk
Preparing Host Servers To Create A Virtual Disk Copy 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 imag...
Page 82 - Viewing Virtual Disk Copy Properties
– In Linux, mount the virtual disk. See step 1 to step 4 in Preparing Host Servers To Create A Virtual Disk Copy. The create virtualDiskCopy command might look like the following example: client>smcli 123.45.67.89 -c "create virtualDiskcopy source=\"Jaba_Hut\" target= \"Obi_1\"...
Page 83 - Changing Virtual Disk Copy Settings
The following example shows a command that returns information about a virtual disk used for a virtual disk copy: client>smcli 123.45.67.89 -c "show virtualDiskCopy source [\"Jaba_Hut\"];" The command in the preceding example requests information about the source virtual disk Jaba...
Page 84 - Recopying A Virtual Disk; Preparing Host Servers To Recopy A Virtual Disk
The following example shows how to change parameters using the set virtualDiskCopy command: client>smcli 123.45.67.89 -c "set virtualDiskcopy target [\"Obi_1\"] copyPriority=highest targetreadonlyenabled=false;" The following example is the script file version of the command: set ...
Page 85 - Recopying The Virtual Disk; Stopping A Virtual Disk Copy
NOTE: If your operating system requires additional instructions, you can find those instructions in your operating system documentation. After your server has been prepared, see Recopying The Virtual Disk to recopy the virtual disk. Recopying The Virtual Disk After first preparing the host server(s)...
Page 86 - Removing Copy Pairs; Interaction With Other Features
Removing Copy Pairs The remove virtualDiskCopy command enables you to remove a virtual disk copy pair from the storage array configuration. All virtual disk copy information for the source virtual disk and target virtual disk is removed from the storage array configuration. The data on the source vi...
Page 87 - How Remote Replication Works
8 Using The Remote Replication Premium Feature 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...
Page 89 - Resynchronization
In this case, the remote write operation cannot be completed to the secondary virtual disk, and the primary virtual disk and the secondary virtual disk are no longer correctly replicated. The primary RAID controller module transitions the replicated pair into an Unsynchronized state and sends an I/O...
Page 90 - Remote Replication Group; Previous Users Of Remote Replication (Legacy) Premium
Remote Replication Group After your Remote Replication premium feature is activated on both local and remote storage arrays, you must create Remote Replication groups on the local storage array.A replication group contains at least one replicated virtual disk pair, one on the local storage and one o...
Page 91 - Primary And Secondary Virtual Disks; Activating The Remote Replication Premium Feature; Creating A Remote Replication Group
– The first port that successfully establishes an iSCSI connection is used for all subsequent communication with that remote storage array. If that connection subsequently fails, a new session is attempted using any available ports. Primary And Secondary Virtual Disks Before you create any replicati...
Page 92 - Adding Primary Virtual Disk To Remote Replication Group; Changing Remote Replication Group Settings
The create asyncRemoteReplicationGroup command creates a new, empty remote replication group on both the local storage array and the remote storage array. Each replicated pair you add to the remote replication group share the same synchronization settings, primary and secondary role, and write mode....
Page 93 - Suspending A Remote Replication Group
• warningThresholdPercent The following parameters allow you to change (or force) the primary/secondary role of a replication group, or whether or not to perform a synchronization before changing primary/secondary roles. • role • force • nosync You can apply the changes to one or several remote repl...
Page 94 - Deleting A Remote Replication Group
reduce any performance impact to the host application that might occur while any changed data on the primary virtual disk is copied to the secondary virtual disk.When a replication relationship is in a suspended state, the primary virtual disk does not make any attempt to contact the secondary virtu...
Page 95 - Disabling The Remote Replication Premium Feature; Deactivating The Remote Replication Premium Feature; Interaction With Other Premium Features; Standard Remote Replication Commands
Disabling The Remote Replication Premium Feature You disable the Remote Replication premium feature to prevent the new replication relationship from being created. When you disable the Remote Replication premium feature, the premium feature is in a Disabled/Active state. In this state, you can maint...
Page 97 - Premium Feature
9 Using The Remote Replication (Legacy) Premium Feature The Remote Replication (legacy) premium feature provides for online, real-time replication of data between storage arrays over a remote distance. In the event of a disaster or a catastrophic failure on one storage array, you can promote the sec...
Page 99 - Data Replication
Data Replication The RAID controller modules manage data replication between the primary virtual disk and the secondary virtual disk. This process is transparent to host machines and applications. This section describes how data is replicated between the storage arrays that are participating in Remo...
Page 101 - Creating A Remote Replicated Pair; Performance Considerations
blocks of data that have changed on the primary virtual disk during the link interruption are copied to the secondary virtual disk. CAUTION: Possible loss of data access – Any communication disruptions between the primary storage array and the secondary storage array while resynchronization is under...
Page 102 - Enabling The Remote Replication (Legacy) Premium Feature; Activating The Remote Replication (Legacy) Premium Feature
Enabling The Remote Replication (Legacy) Premium Feature The first step in creating a remote replication is to make sure that the Remote Replication (legacy) premium feature is enabled on both storage arrays. Because Remote Replication (legacy) is a premium feature, you need a feature key file to en...
Page 104 - Determining Candidates For A Remote Replicated Pair
The command in this example creates a new replication repository virtual disk in disk group 2 using the second free capacity area. This example shows how to use the command in a script file: activate storageArray feature=remoteReplication repositoryDiskGroup=2 freeCapacityArea=2; Activating The Remo...
Page 105 - Changing Remote Replication (Legacy) Settings
by the name of the virtual disk. You define the secondary virtual disk by name with either the name or the World Wide Identifier (WWID) of the storage array on which the secondary virtual disk resides. The primary virtual disk name, the secondary virtual disk name, and the remote storage array name ...
Page 106 - Suspending And Resuming A Replication Relationship
• The synchronization priority• The write order• The write mode You can apply the changes to one or several remote replicated pairs by using this command. Use the primary virtual disk name to identify the remote replicated pairs for which you are changing the properties.This example shows how to use...
Page 108 - Deactivating The Remote Replication (Legacy) Premium; Snapshot Virtual Disks
CAUTION: Possible loss of data access – Deleting a primary virtual disk or a secondary virtual disk permanently removes the data from the storage array. Disabling The Remote Replication (Legacy) Premium Feature You disable the Remote Replication (legacy) premium feature to prevent the new replicatio...
Page 109 - Virtual Disk Copy; Storage Partitioning
was created. Snapshot repository virtual disks cannot be selected as a source virtual disk or target virtual disk in a virtual disk copy. The virtual disk for which the point-in-time image is created is the source virtual disk and must be a standard virtual disk in the storage array. You can select ...
Page 110 - Virtual Disk Expansion
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. The increase in capacity is achieved by using the free capacity that is available in the disk group of the standard virtual ...
Page 111 - Maintaining A Storage Array; Routine Maintenance; Running A Media Scan
10 Maintaining A Storage Array Maintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all hosts. This chapter provides descriptions of command line interface (CLI) and script commands that you can use to perform storage array maintenance. ...
Page 112 - Running A Consistency Check With A Media Scan
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 force...
Page 113 - Resetting A RAID Controller Module
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 ...
Page 114 - Synchronizing RAID Controller Module Clocks; Locating Physical Disks; Performance Tuning; Monitoring Performance
• 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]...
Page 115 - Changing RAID Levels
Type of Information Description module pair, regardless if one, both, or neither are selected for monitoring Total I/Os Number of total I/Os performed since the storage array was started Read Percentage Percentage of total I/Os that are read operations (calculate the write percentage by subtracting ...
Page 116 - Defragmenting A Disk Group; Using SSD Cache; Enabling SSD Cache For A Virtual Disk
performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | < wwid >) segmentSize= segmentSizeValue where, segmentSizeValue is the ...
Page 117 - Creating SSD Cache; Adding Physical Disks To Existing SSD Cache; Removing Physical Disks From Existing SSD Cache; SSD Cache Performance Modeling
For a consistency group snapshot virtual disk: set cgSnapVirtualDisk [" cgSnapshotVirtualDisk "] ssdCacheEnabled=TRUE When you turn off SSD caching for a virtual disk, cache contents is purged. You can turn on SSD caching for only one virtual disk per command. Creating SSD Cache To create ss...
Page 118 - Troubleshooting and Diagnostics; Collecting Physical Disk Data
The modeling process runs in the background until you run the stop command. The file parameter is optional. If used, it will write modeling results to the file you specify. stop ssdCache [ ssdCacheName ] performanceModeling file=" filename " Output is displayed directly on your screen, unles...
Page 119 - Recovery Operations; Setting RAID Controller Module Operational Mode
physical disk-side channel out onto the loop and back again. Enough data is transferred to determine error conditions on the channel. If the test fails on any channel, this status is saved so that it can be returned if all other tests pass. The write test initiates a write command as it would be sen...
Page 120 - Changing RAID Controller Module Ownership; Initializing A Physical Disk
If you take a RAID controller module offline, the second RAID controller module in the pair takes over. Disk groups and their associated virtual disks that were assigned to the offline RAID controller module are automatically reassigned to the remaining RAID controller module. CAUTION: Place a RAID ...
Page 121 - Reconstructing A Physical Disk; Initializing A Virtual Disk; Redistributing Virtual Disks
Reconstructing A Physical Disk If two or more physical disks in a disk group have failed, the virtual disk shows a status of Failed. All of the virtual disks in the disk group are no longer operating. To return the disk group to an Optimal status, you must replace the failed physical disks. After re...
Page 122 - Script Commands; Command Formatting Rules
11 Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the curr...
Page 124 - Disk Group Commands
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. On Microsoft ...
Page 127 - RAID Controller Module Commands
Show Physical Disk Download Progress Start Physical Disk Blink Start Physical Disk Initialize Start Physical Disk Channel Blink Start Physical Disk Channel Fault Isolation Diagnostics Start Physical Disk Reconstruction Start Remote Replication Synchronization Stop Physical Disk Blink Stop physical d...
Page 128 - Remote Replication Commands
Remote Replication Commands Activate Remote Replication Add Virtual Disk to Remote Replication Group Cancel Remote Replication Group Role Reversal Check Remote Replication Group Consistency Check Remote Replication Status Create Remote Replication Check Storage Array Connectivity Clear Remote Replic...
Page 130 - Storage Array Commands
Resume SSD Cache Show SSD Cache Show SSD Cache Statistics Start SSD Cache Performance Modeling Stop SSD Cache Performance Modeling Suspend SSD Cache Storage Array Commands Activate Storage Array Firmware Autoconfigure Storage Array Autoconfigure Storage Array Hot Spares Clear Storage Array Configura...
Page 133 - Commands Listed Alphabetically; Activate Remote Replication Feature; Description
12 Commands Listed Alphabetically Following are the script commands listed alphabetically. Activate Remote Replication Feature NOTE: This command is used to activate both Remote Replication and Remote Replication (Legacy). Description This command creates the replication repository virtual disks and...
Page 134 - Parameters
[drawerLossProtect=(TRUE | FALSE)] [dataAssurance=(none | enabled)] 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 d...
Page 135 - Notes
Parameter Description enclosureLossProtect The setting to enforce enclosure loss protection when you create the replication repository virtual disk. To enforce enclosure loss protection, set this parameter to TRUE . The default value is FALSE . drawerLossProtect The setting to enforce drawer loss pr...
Page 136 - Activate Storage Array Firmware; Add Member To Consistency Group
set the enclosureLossProtect parameter to FALSE , the storage array performs operations, but the disk group that you create might not have enclosure loss protection. When the RAID controller module firmware assigns the physical disks, if you set the enclosureLossProtect parameter to TRUE , the stora...
Page 138 - Add Physical Disks To SSD Cache
operations on each of the base virtual disks. In the context of this command, the term member means a base virtual disk for snapshot operations. You can manipulate snapshot images associated with members of a consistency group through batch-style operations, while maintaining consistency across the ...
Page 139 - Add Virtual Disk To Remote Replication Group
Syntax set ssdCache [ ssdCacheName ] addPhysicalDisks=( enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn ) Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache to which you want to add SSDs. Enclose the identifier in square brack...
Page 141 - Autoconfigure Storage Array; Syntax
Parameter Description Enclose the name of the new repository virtual disk in parenthesis ( ). Autoconfigure Storage Array Description This command automatically configures a storage array. Before entering the autoConfigure storageArray command, run the show storageArray autoConfiguration command. Th...
Page 143 - Autoconfigure Storage Array Hot Spares; Blink SSD Cache
Autoconfigure Storage Array Hot Spares Description This command automatically defines and configures the hot spares in a storage array. You can run this command at any time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters ...
Page 144 - Cancel Remote Replication Group Role Reversal; Change SSD Cache Application Type
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 asyncRemoteReplicationG...
Page 145 - Check Remote Replication Status; Check Remote Replication Group Consistency
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 t...
Page 146 - Check Repository Consistency
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 iden...
Page 147 - Check Storage Array Connectivity
Parameter Description 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 virtu...
Page 148 - Check Virtual Disk Consistency
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 yo...
Page 149 - Clear Physical Disk Port Statistics
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 th...
Page 150 - Clear Remote Replication Fault
Clear Remote Replication Fault Description This command clears a remote replication "sticky" fault from one or more remote replication groups and one or more remote replication group member virtual disks. A remote replication group and its member virtual disks can encounter remote replicatio...
Page 151 - Clear Storage Array Configuration
Parameter Description virtualDisk The name of the specific member virtual disk (in a remote replication group) from which you want to 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 encl...
Page 152 - Set Storage Array Core Dump; Clear Storage Array Event Log
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...
Page 153 - Clear Storage Array Firmware Pending Area; Clear Storage Array Recovery Mode; Clear Virtual Disk Reservations
Syntax clear storageArray eventLog 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...
Page 154 - Clear Virtual Disk Unreadable Sectors
Syntax clear (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNameN ]) reservations Parameters Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virt...
Page 155 - Configure Automatic Support Bundle Collection; Convert Snapshot (Legacy) Virtual Disk To Snapshot
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 Aut...
Page 156 - Create Consistency Group
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 Grou...
Page 158 - Create Consistency Group Snapshot Image
An operation on a snapshot image consistency group is treated as a single request, and causes all pending I/O operations to the associated base virtual disk of each member to be drained and suspended before creating the snapshot images. If creation of the snapshot images cannot be completed successf...
Page 159 - Create Consistency Group Snapshot Virtual Disk; Only; Syntax When Setting The Repository Full Limit
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 ...
Page 161 - Create Consistency Group Snapshot Virtual Disk Mapping
• Creating a read-only consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 that has three memebers cgm1, cgm2, and cgm3: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageID="snapCG1:oldest" readOnly; • Creating a consistency group s...
Page 162 - Create Disk Group
A host group is an optional topological element that you can define if you want to designate a collection of hosts that share access to the same virtual disks. The host group is a logical entity. Define a host group only if you have two or more hosts that share access to the same virtual disks. Crea...
Page 164 - Additional Information
Parameter Description • capable —The disk group and virtual disks are capable of having security set, but security has not been enabled. • enabled —The disk group and virtual disks have security enabled. dataAssurance The setting to specify that a disk group, and the virtual disks within the disk gr...
Page 165 - Create Disk Pool
stripe. A data stripe is the segment size that is multiplied by the number of physical disks in the disk group that are used for data transfers. In this case, multiple physical disks are used for the same request, but each physical disk is accessed only once. For optimal performance in a multiuser d...
Page 168 - Security Type
Parameter Description Valid values are highest , high , medium , low , and lowest . The default value is high . dataAssurance The setting to specify that a disk pool has data assurance protection to make sure that the data maintains its integrity. When you use this parameter, only protected physical...
Page 169 - Create Host; Create Host Group
• export storageArray securityKey • import storageArray securityKey • set storageArray securityKey • start secureErase (physicalDisk | physicalDisks) Create Host Description This command creates a new host. If you do not specify a host group in which to create the new host, the new host is created i...
Page 170 - Create Host Port
Parameter Parameter Description userLabel Name to give the host group that you are creating. You must put quotation marks (" ") around the host group name. Create Host Port Description This command creates a new HBA host port identification. The identification is a software value that repres...
Page 171 - Create iSCSI Initiator; Create RAID Virtual Disk (Automatic Physical Disk Select)
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. Create iSCSI ...
Page 174 - Create RAID Virtual Disk (Free Extent Base Select)
Create RAID Virtual Disk (Free Extent Base Select) Description This command creates a virtual disk in the free space of a disk group. Syntax create virtualDisk diskGroup="diskGroupName" userLabel="virtualDiskName" [freeCapacityArea=freeCapacityIndexNumber] [capacity=virtualDiskCapaci...
Page 176 - Create RAID Virtual Disk (Manual Physical Disk Select)
Parameter Description securityType The setting to specify the security level when creating the disk groups and all associated virtual disks.• none —The disk group and virtual disks are not secure. • capable —The disk group and virtual disks are capable of having security set, but security has not be...
Page 179 - Create RAID Virtual Disk On A Disk Pool
Parameter Description securityType The setting to specify the security level when creating the disk groups and all associated virtual disks.• none —The disk group and virtual disks are not secure. • capable —The disk group and virtual disks are capable of having security set, but security has not be...
Page 181 - Create Read-Only Snapshot Virtual Disk
Parameter Description 256 , or 512 . For information about the segmentSize parameter, see Using the Auto Configure Command. usageHint Valid values are multiMedia , database or fileSystem . Create Read-Only Snapshot Virtual Disk Description This command creates a read-only snapshot virtual disk for t...
Page 182 - Create Remote Replication
Parameter Description readOnly This parameter sets the snapshot virtual disk to read-only. This parameter is actually a Boolean; however, in the context of this command, the Boolean value is always TRUE . NOTE: With the readOnly parameter, snapshot virtual disks are not created. Notes You can use an...
Page 184 - Create Remote Replication Group
Notes Names can be any combination of alphanumeric characters, hyphens, and underscores. Names can have a maximum of 30 characters. When the primary virtual disk and the secondary virtual disk are chosen, the secondary virtual disk must be of equal or of a greater size than the primary virtual disk....
Page 187 - Create Snapshot Group
• The local and remote storage arrays must be connected through a Fibre Channel fabric or iSCSI interface. • 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 a alphanumeric char...
Page 189 - Create Snapshot Image
other snapshot image. A snapshot image that is created before another snapshot image is a predecessor relative to that other one. A snapshot 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 snapshot ...
Page 196 - Create Snapshot Virtual Disk
operation. You can ensure that copy-on-write operations maintain a correct interval by using this option. The maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180 . endDate Specific date to stop creating a snapshot (legacy) virtual disk and end the copy-on...
Page 198 - Create SSD Cache
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. The identifier of a snapshot image has two parts separated by a colon (:): • The name of the snapshot group.• The identifier of the snapsh...
Page 199 - Create Storage Array Security Key
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 ph...
Page 201 - Create Virtual Disk Copy
Additional characters are automatically generated and appended to the end of the string that you enter for the key identifier. If you do not enter any string for the keyIdentifier parameter, the key identifier consists of only the characters that are automatically generated. Your pass phrase must me...
Page 203 - Delete Consistency Group
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: ...
Page 204 - Delete Consistency Group Snapshot Image
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 ...
Page 205 - Delete Consistency Group Snapshot Virtual Disk; Delete Disk 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 ...
Page 206 - Delete Disk Pool; Delete Host
CAUTION: All data in the disk group is lost as soon as you run this command. 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 d...
Page 207 - Delete Host Group; Delete Host Port
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 accesse...
Page 208 - Delete iSCSI Initiator
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...
Page 209 - Delete Snapshot Group; Delete Snapshot Image
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 [...
Page 212 - Delete Snapshot Virtual Disk; Delete Snapshot Virtual Disk or Delete Snapshot Virtual
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 "]...
Page 213 - Delete SSD Cache; Delete Virtual Disk
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 al...
Page 214 - Delete Virtual Disk On A Disk Pool
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 vir...
Page 215 - Diagnose RAID Controller Module
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...
Page 217 - Diagnose RAID Controller Module iSCSI Host Cable
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 t...
Page 218 - Diagnose Remote Replication
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...
Page 219 - Disable Storage Array Feature
Parameter Parameter Description primary or primaries The name of the primary virtual disk of the remote replication pair to be tested. More than one primary virtual disk name can be entered. Enclose the primary virtual disk names in square brackets ([ ]). If the primary virtual disk name has special...
Page 220 - Display Automatic Support Bundle Collection
NOTE: The following attribute is for enabling the snapshot (legacy) feature only. • snapshot[2|4|8|16] The form for this attribute value is a combination of the alphabetical term merged with the numerical value, for example, snapshot16 NOTE: The remoteReplication attribute is valid only for firmware...
Page 221 - Display Support Bundle Collection Schedule; Download Enclosure Management Module Firmware
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 Paramete...
Page 222 - Download Physical Disk Firmware
Download Physical Disk Firmware Description This command downloads a firmware image to a physical disk. CAUTION: Downloading physical disk firmware incorrectly can result in damage to the physical disks or loss of data. Before attempting to download physical disk firmware, you must take the followin...
Page 223 - Download Storage Array Firmware/NVSRAM; Download Storage Array Physical Disk Firmware
Download Storage Array Firmware/NVSRAM Description This command downloads firmware and, optionally, NVSRAM values for the RAID controller module in the storage array. If you want to download only NVSRAM values, use the downLoad storageArray NVSRAM command. Syntax download storageArray firmware [, NV...
Page 224 - Download Storage Array NVSRAM
Syntax download storageArray physicalDiskFirmware file= ” filename ” [file=” filename2 ”... file=” filenameN ”] Parameter Parameter Description file File path and name of the file that contains the firmware. Valid file names must end with a .dlp extension. You must put quotation marks (" ") ...
Page 225 - Enable Disk Group Security
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. healthCheckMelOverride T...
Page 226 - Enable Disk Pool Security; Enable or Disable ODX
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.• The storage array security key must be set.• The disk...
Page 227 - Enable Or Disable SSD Cache For A Virtual Disk
Parameter Parameter Description odxEnabled The setting to turn on or turn off ODX. To turn on ODX set this parameter to TRUE . To turn off ODX set this parameter to FALSE . The default setting is that ODX is turned on. NOTE: ODX provides a way to transfer data without using buffered read and buffere...
Page 228 - Enable or Disable VAAI; Enable RAID Controller Module Data Transfer
Notes You can turn the SSD cache on or off for only one virtual disk at a time. When you turn off SSD cache for a virtual disk, the SSD cache for that virtual disk is purged. Enable or Disable VAAI This command turns on or turns off VMware vStorage API Array Architecture (VAAI) for a storage array. ...
Page 229 - Enable Storage Array Feature; Establish Remote Replicated Pair
Parameter Description 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. Enable Storage Array Feature Description This command enables a prem...
Page 230 - Increase Virtual Disk Capacity On A Disk Pool
The two virtual disks comprising a remote replicated pair function as a single entity. Establishing a remote replicated pair allows you to perform actions on the entire replicated pair versus the two individual virtual disks. Syntax establish asyncRemoteReplication virtualDisk=" secondaryVirtual...
Page 231 - Load Storage Array DBM Database
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 contr...
Page 233 - Modify Disk Pool; Recopy Virtual Disk Copy
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. Modify Disk Pool Description This c...
Page 235 - Recover RAID Virtual Disk
Parameter Description copyType Creates a virtual disk copy with or a snapshot which enables you to continue to write to the source virtual disk while creating the virtual disk copy. To reinitiate a virtual disk copy with a snapshot, set this parameter to online . To reinitiate a virtual disk copy wi...
Page 238 - Preallocating Storage Capacity; Segment Size
NOTE: The MD storage management software collects recovery profiles of the monitored storage arrays and saves the profiles on a storage management station. The physicalDisk parameter supports both high-capacity expansion enclosures and low-capacity expansion enclosures. A high-capacity expansion enc...
Page 239 - Reserved Space on Physical Disks; Re-Create Remote Replication Repository Virtual Disk
If the virtual disk is in an environment where a single user is transferring large units of data (such as multimedia), performance is maximized when a single data transfer request is serviced with a single data stripe. (A data stripe is the segment size that is multiplied by the number of physical d...
Page 244 - Reduce Disk Pool Capacity
Reduce Disk Pool Capacity Description This command reduces the capacity of the disk pool by logically removing the physical disks from the pool. This command uses the Dynamic Capacity Reduction (DCR) feature, which enables you to remove selected physical disks from a disk pool and re-use the removed...
Page 245 - Register SNMP Community; Register SNMP Trap Destination
virtual disks remain fully accessible during this operation. The progress of the removal operation is reported as part of the long running operations status. This command fails if there is not enough free capacity on the physical disks that remain in the disk pool to store the data that was on the p...
Page 246 - Reinitialize Thin Virtual Disk
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. communityName The name of the S...
Page 247 - Remove Incomplete Remote Replicated Pair From
Parameter Description must be an unused repository virtual disk with the name in the proper form. • If the newly specified repository virtual disk is on a different disk pool, the thin virtual disk will change ownership to that pool. • The old repository virtual disk will be deleted by default. disk...
Page 248 - Remove Member Virtual Disk From Consistency Group; Remove Physical Disks From SSD Cache
Parameter Description 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 (" "). Remove M...
Page 249 - Remove Remote Replication
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 ide...
Page 250 - Remove Virtual Disk Copy; Remove Virtual Disk From Remote Replication Group
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...
Page 251 - Remove Virtual Disk LUN Mapping
Syntax remove virtualDisk [" virtualDiskName "] asyncRemoteReplicationGroup=" asyncRemoteReplicationGroupName " [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter Description virtualDisk The name of the specific virtual disk that you want to remove from the remote replicat...
Page 252 - Rename A Snapshot Virtual Disk
Parameter Description CAUTION: The host agent uses the access virtual disks to communicate in-band with a storage array. If you remove an access virtual disk mapping for a storage array from a host that has an agent running on it, the storage management software is no longer able to manage the stora...
Page 253 - Rename SSD Cache; Repair Virtual Disk Consistency
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...
Page 254 - Replace Physical Disk
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....
Page 255 - Reset iSCSI IP Address
Parameter Description replacementPhysicalDisk Specifies the physical disks to assign to the virtual disk that you want to create. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk. Enclosure ID values are 0 to 99 . Slot ID values are 0 to 31 . copyPhysic...
Page 256 - Reset Physical Disk
Parameters Parameter Description remoteStorageArrayName The name for the remote storage array for which you are resetting the iSCSI IP address. Enclose the storage array name in double quotation marks (" "). remoteStorageArrayNameWwid The World Wide Identifier (WWID) of the storage array for...
Page 257 - Reset RAID Controller Module
NOTE: The physicalDisk 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-capac...
Page 258 - Reset Remote Replication Group Statistics
Additional Information The RAID controller module that receives the reset RAID controller module command resets the RAID controller module specified. For example, if the reset RAID controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 0, then RAID...
Page 259 - Reset Storage Array Battery Install Date
Parameter Description sampleType This parameter is optional. The default value for sampleType is all . • all —Data for all three sample types are reset. • mostRecent —Statistics are reset for the most recent 50 resynchronization samples. • longestSyncTime —Statistics are reset for the most recent 20...
Page 260 - Reset Storage Array iSCSI Baseline; Reset Storage Array SAS PHY Baseline
Parameter Description enclosure. Use the controller parameter only for RAID controller modules with batteries. NOTE: If you do not specify a RAID controller module, the age is reset for the storage array battery or both RAID controller module batteries. If you specify a RAID controller module, then ...
Page 261 - Reset Storage Array Virtual Disk Distribution; Resume Consistency Group Snapshot Virtual Disk
Parameters None. Reset Storage Array Virtual Disk Distribution Description This command reassigns (moves) all virtual disks to their preferred RAID controller module. Syntax reset storageArray virtualDiskDistribution Parameters None. CAUTION: Ensure that the multipath driver is running before you us...
Page 262 - Resume Remote Replication
Parameter Description • An identifier for the snapshot image in the consistency group. The identifier for the snapshot image can be one of these:• An integer value that is the sequence number of the snapshot in the consistency group. • NEWEST - Use this option when you want to show the latest snapsh...
Page 263 - Resume Remote Replication Group
Parameter Description characters, the primary virtual disk name must also be enclosed in double quotation marks (“ ”). writeConsistency The setting to identify the virtual disks in this command that are in a write-consistency group or are separate. For the virtual disks to be in the same write-consi...
Page 264 - Resume Snapshot Image Rollback
Resume Snapshot Image Rollback Description This command resumes a rollback operation that has entered a paused state. A rollback operation can enter a paused state due to processing errors, which causes a Needs Attention condition for the storage array. If the rollback operation cannot be resumed, t...
Page 265 - Resume Snapshot Virtual Disk
For example, if you want to restart a rollback operation for snapshot image 12345 in a snapshot group that has the name snapgroup1 , you would use this command: resume snapImage ["snapgroup1:12345"] rollback; Resume Snapshot (Legacy) Rollback Description NOTE: With firmware version 7.83 the ...
Page 267 - Resume SSD Cache; Revive Disk Group
Resume SSD Cache Description This command restarts the caching for all virtual disks using the SSD cache that was temporarily stopped with the suspend ssdCache command. Syntax resume ssdCache [ ssdCacheName ] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of...
Page 268 - Revive Disk Pool; Revive Physical Disk
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. Do not try to revive a disk pool unless you are supervised by you...
Page 269 - Revive Snapshot Group; Revive Snapshot Virtual Disk
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. Syntax revive snapGroup [ snapGroupName ] Parameter Parameter Description sna...
Page 270 - Save Enclosure Log Data; Save Input Output RAID Controller Module (IOC) Dump
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. Syntax save allEnclosures logFile=" filename " Parameter Param...
Page 271 - Save Physical Disk Log; Save RAID Controller Module NVSRAM
NOTE: This command retrieves from both RAID controller modules the IOC dump log data and the IOC dump metadata. Using a 7zip file format, the retrieved data is archived and compressed into a single file with a file name of your choice. The 7zip archive file contains the following:filename+”IOCLog”+[...
Page 272 - Save Remote Replication Group Statistics
Parameters Parameter Description controller RAID controller module with the NVSRAM values to save. 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 ...
Page 274 - Save Storage Array Configuration
Notes Statistics are captured for replicated virtual disks in the Primary role. The statistics collected include the following data: • Synchronization start time• Synchronization type (manual or periodic)• Synchronization duration• Number of bytes sent• Maximum write time (for a single write)• Minim...
Page 275 - Save Storage Array Core Dump; Save Storage Array DBM Database
Parameter Description prevent saving the global settings, set this parameter to FALSE . The default value is TRUE . virtualDiskConfigAndSettings Saves the virtual disk configuration settings and all of the global settings to the file. To save the virtual disk configuration and global settings, set t...
Page 277 - Save Storage Array DBM Validator Information File
Parameter Description This command does not automatically append a file extension to the saved file. You must specify a file extension when entering the file name. Notes The data that you save to the host using this command can, if needed, be restored to the RAID controller module. A validator, howe...
Page 278 - Save Storage Array Events
Notes If you are generating the XML information file in order to obtain a validator string, you must run this command while you are connected to the RAID controller module where you intend to restore the database. The following example show the format of the XML file: <?xml version="1.0" ...
Page 279 - Save Storage Array iSCSI Statistics
Parameter Description warningEvents Saves only warning events to a file. infoEvents Saves only informational events to a file. debugEvents Saves only debug events to a file. file Specifies name of the file to which to save the events. You must put quotation marks (" ") around the file name. ...
Page 280 - Save Storage Array Performance Statistics; Save Storage Array SAS PHY Counts
Parameter Description file The name of the file to which you want to save the performance statistics. Enclose the file name in double quotation marks (" "). NOTE: This command does not automatically append a file extension to the new file. You must specify the file extension when you enter t...
Page 281 - Save Storage Array State Capture; Save Storage Array Support Data
Parameters Parameter Description file Specifies the file path and the file name to which you save the SAS PHY counters. Enclose the file path and the file name in double quotation marks (" "). For example: file="C:\Program Files\CLI\logs\sasphy.csv"This command does not automatically...
Page 282 - Schedule Support Bundle Collection Configuration
• The unreadable sectors that are detected on the storage array• The state capture data• An inventory of the versions of the firmware running on the RAID controller modules, the physical disks, and the RAID controller modules Syntax save storageArray supportData file=" filename " [force=(TRU...
Page 285 - Set Consistency Group Attributes
NOTE: If you also use the scheduleInterval option, the lowest value of the timesPerDay option and the scheduleInterval option is used. The value is determined by calculating an integer value for the scheduleInterval option. Divide 1440 by the scheduleInterval option value that you set. For example, ...
Page 286 - Set Consistency Group Snapshot Virtual Disk; Set Disk Group
Parameter Description rollBackPriority The priority for rollback operations for a consistency group while the storage array is operational. Valid values are highest , high , medium , low , or lowest . Set Consistency Group Snapshot Virtual Disk Description This command creates a unique name for a sn...
Page 287 - Troubleshooting
Parameters Parameter Description diskGroup Sequence number of the disk group for which to set properties. You must put brackets ([ ]) around the disk group number. addPhysicalDisks Identifies the physical disk by enclosure and slot location to include in the disk group. Enclosure ID values are 0 to ...
Page 288 - Set Disk Group Forced State; Set Disk Pool
operation, stripe size, and whether replication is enabled may result in less memory being available to complete the DCE operation. In such a scenario, try each of the options below and retry the operation: • Create the required disk group size using other unassigned physical disks.• Delete the curr...
Page 289 - Set Disk Pool Complete
Parameters Parameter Description diskPools The list of diskPoolNames identifies multiple physical disk pool which have their parameters reset by the command. allDiskPools This parameter specifies that all physical disk pools have their parameters reset by the command. reservePhysicalDiskCount This v...
Page 290 - Set Enclosure Attribute; Set Enclosure Identification
Set Enclosure Attribute Description This command sets user-defined attributes for an enclosure. Syntax set enclosure [ enclosureID ] (chassisName | assetTag)= " userID " Parameters Parameter Description enclosureID Identifies a specific enclosure for which to set the attribute. Enclosure ID ...
Page 291 - Set Event Alert Filtering
Parameters Parameter Description enclosure Service tag of the RAID enclosure or the expansion enclosure for which you are setting the enclosure ID. You must put quotation marks (" ") around the Service Tag. id Specifies the value for the RAID enclosure or expansion enclosure ID. Valid values...
Page 292 - Set Foreign Physical Disk to Native
Parameters Parameter Description eventType This parameter is the integer value for the event. Enter the event value in a hexadecimal format, for example, 0x280D. Always begin the hexadecimal value with 0x to indicate that it is in hexadecimal format. If you do not use 0x, the value will be interpret...
Page 293 - Set Host
Set Host Description This command assigns a host to a host group or moves a host to a different host group. You can also create a new host group and assign the host to the new host group with this command. The actions performed by this command depend on whether the host has individual mappings or do...
Page 294 - Set Host Channel
Host Group Parameter Host Has Individual Virtual Disk- to-LUN Mappings Host Does Not Have Individual Virtual Disk-to-LUN Mappings under the new host group defined by hostGroupName . under the new host group defined by hostGroupName . none The host is removed from the host group as an independent par...
Page 295 - Set Host Group; Set Host Port
Set Host Group Description This command renames a host group. Syntax set hostGroup [ hostGroupName ] userLabel=" newHostGroupName " Parameters Parameter Description hostGroup Name of the host group to rename. You must put brackets ([ ]) around the host group name. If the host group name has ...
Page 296 - Set iSCSI Initiator
Parameter Description label has special characters, enclose the HBA host port label in double quotation marks (" "). host The name of the host to which the HBA host port is connected. Enclose the host name in double quotation marks (" "). userLabel The new name that you want to give ...
Page 297 - Set iSCSI Target Properties; Set Physical Disk Channel Status
NOTE: Use the chapSecret parameter only for initiators requiring mutual authentication. Set iSCSI Target Properties Description This command defines properties for an iSCSI target. Syntax set iscsiTarget [“ iscsiID ”] (authenticationMethod=(none | chap) | chapSecret=” securityKey ” | targetAlias=” u...
Page 298 - Set Physical Disk Hot Spare
Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to set the status. Valid physical disk channel values are 1 or 2 . You must put brackets ([ ]) around the physical disk channel number. status Condition of the channel. You can set the chann...
Page 299 - Set Physical Disk State; Set RAID Controller Module
Set Physical Disk State Description This command sets a physical disk to the Failed state. To return a physical disk to the Optimal state, use the revive physicalDisk command. Optionally, you can copy the data from the physical disk before you fail it. Syntax set physicalDisk [enclosureID,drawerID,s...
Page 301 - Syntax Element Statement Data
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 set...
Page 303 - Set Read-Only Snapshot Virtual Disk To A Read/Write; Set Remote Replication
• The tcpListeningPort option is 3260. 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 re...
Page 306 - Set Remote Replication Group
Set Remote Replication Group Description Use this command to change the synchronization settings and warning thresholds that the RAID controller module owner of the primary side of the remote replication group uses when it performs an initial synchronization or resynchronization. Changing the synchr...
Page 309 - Set Session
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. When you use this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters. A remote...
Page 310 - Set Snapshot Group Attributes
Parameter Description performanceMonitorInterval The frequency of gathering performance data. Enter an integer value for the polling interval, in seconds, for which you want to capture data. The range of values is 3 to 3600 seconds. The default value is 5 seconds. performanceMonitorIterations The nu...
Page 311 - Set Snapshot Group Media Scan
Parameter Description repositoryFullPolicy How you want snapshot image processing to continue if the repository virtual disks for the snapshot image group are full. You can choose to fail writes to the base virtual disk ( failBaseWrites ) or delete (purge) the snapshot images ( purgeSnapImages ). Th...
Page 312 - Set Snapshot Group Repository Virtual Disk Capacity; Syntax For Decreasing Capacity
Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group on which you want to run a media scan. Enclose the snapshot group name in double quotation marks (" ") inside of square brackets ([ ]). mediaScanEnabled The setting to turn on or ...
Page 313 - Set Snapshot Group Schedule
Parameter Description virtual disk to increase the capacity of the repository virtual disk.The repository virtual disk name is comprised of two parts:• The term repos • A numerical identifier generated by the MD storage management software and the firmware count The number of repository virtual disk...
Page 317 - Set Snapshot Virtual Disk Media Scan
Parameter Description timeZone Specifies the time zone to use for the scheduling operations, using one of the following values:• GMT±HH:MM —The offset from Greenwich Mean Time (GMT), in hours and minutes. For example, GMT-06:00 must be used to specify Central Standard Time (CST). • Text string —A st...
Page 318 - Set Snapshot Virtual Disk Repository Virtual Disk Capacity
Parameter Description properties. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside of square brackets ([ ]). mediaScanEnabled The setting to turn on or turn off media scan for the snapshot virtual disk. To turn on media scan, set this parameter to TRUE . To...
Page 319 - Set Storage Array
Parameters Description Enclose the snapshot virtual disk name in double quotation marks (" "). count The number of repository virtual disks that you want to remove from the snapshot group. Use integer values. Notes When you use this command, you can specify only one of the parameters. You ca...
Page 322 - Set Storage Array Enclosure Positions
Passwords are stored on each storage array. For best protection, the password must meet these criteria: • The password must be between eight and 30 characters long.• The password must contain at least one uppercase letter.• The password must contain at least one lowercase letter.• The password must ...
Page 323 - Set Storage Array ICMP Response; Set Storage Array iSNS Server IPv4 Address
NOTE: You must include all of the enclosures in the storage array in the list defined by the enclosurePositions parameter. If the number of enclosures in the list does not match the total number of enclosures in the storage array, an error message is shown. Set Storage Array ICMP Response Descriptio...
Page 324 - Set Storage Array iSNS Server IPv6 Address; Set Storage Array iSNS Server Listening Port
Set Storage Array iSNS Server IPv6 Address Description This command sets the IPv6 address for the iSNS server. Syntax set storageArray isnsIPv6Address= ipAddress Parameter Parameter Description isnsIPv6Address The IPv6 address that you want to use for the iSNS server. Set Storage Array iSNS Server L...
Page 325 - Set Storage Array Learn Cycle; Set Storage Array Redundancy Mode
Set Storage Array Learn Cycle Description This command sets the learn cycle for the battery backup unit. The learn cycle enables the MD storage management software to predict the remaining battery life. Learn cycles run at set intervals and store the results for software analysis. Syntax set storage...
Page 326 - Set Storage Array Security Key; Set Storage Array Time
Parameter Parameter Description redundancyMode Use simplex mode when you have a single RAID controller module. Use duplex mode when you have two RAID controller modules Set Storage Array Security Key Description Use this command to set the security key that is used throughout the storage array to im...
Page 327 - Set Storage Array Unnamed Discovery Session; Set Thin Virtual Disk Attributes
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 storageArray unnamedDiscoverySession=(TRUE | FALSE) Parameter Parameter Description unnamedDiscoverySe...
Page 329 - Set Virtual Disk
Set Virtual Disk Description This command defines the properties for a virtual disk. You can use most of the parameters to define properties for one or more virtual disks, however, some of the parameters define properties for only one virtual disk at a time. The syntax definitions are separated to s...
Page 332 - Set Virtual Disk Attributes For A Disk Pool
Parameter Description userLabel Specifies the new name to give an existing virtual disk. You must put quotation marks (" ") around the new virtual disk name. preReadRedundancyCheck The setting to check the consistency of RAID redundancy data on the stripes during read operations. Do not use ...
Page 336 - Cache Flush Modifier; Cache Without Battery Enabled; Modification Priority
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 flushe...
Page 337 - Set Virtual Disk Copy
Cache Read Prefetch The cacheReadPrefetch parameter enables the RAID controller module to copy additional data blocks into cache while the RAID controller module reads and copies data blocks that are requested by the host from the physical disk into cache. This action increases the chance that a fut...
Page 338 - Set Virtual Disk Mapping
Parameters Parameter Description target Specifies the name of the target virtual disk for which to define properties. 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 ta...
Page 340 - Show Blocked Events; Show Consistency Group Snapshot Image
Show Blocked Events Description This command returns a list of events that are currently blocked by the set blockEventAlert command. The events in this list are the events that will not send any notifications that you have configured using the alert terminals and parameters; that is, the email, sysl...
Page 341 - Show Current iSCSI Sessions
Parameter Description • NEWEST - Use this option when you want to show the latest snapshot image created in the consistency group. • OLDEST - Use this option when you want to show the earliest snapshot image created in the consistency group. Enclose the snapshot image name in double quotation marks ...
Page 342 - Show Disk Group
Syntax When running from the command line, use: show iscsiInitiator [\“ initiatorName \”] iscsiSessions show iscsiTarget [\“ targetName \”] iscsiSessions When running from a script file, use: show iscsiInitiator [“ initiatorName ”] iscsiSessions show iscsiTarget [“ targetName ”] iscsiSessions Parame...
Page 343 - Show Disk Group Export Dependencies; Show Disk Group Import Dependencies
NOTE: You can use the free capacity area value when you create a virtual disk based on the free capacity of a disk group. For a description of how to use the free capacity value, see the create virtualDisk command on Create RAID Virtual Disk (Free Capacity Base Select). Syntax show diskGroup [ diskG...
Page 344 - Show Disk Pool; Show Host Ports
Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number. cancelImport The setting to spin the physical disks back down after the disk group dependencies have been read. To spin down the physical di...
Page 345 - Show Physical Disk
Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example. 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:...
Page 347 - Show Physical Disk Channel Statistics; Show Physical Disk Download Progress
Show Physical Disk Channel Statistics Description This command shows cumulative physical disk channel data transfer and error information. If the RAID controller module has automatically degraded a channel, this command also shows interval statistics. When using this command, you can display informa...
Page 348 - Show RAID Controller Module
Status Definition Successful Downloads completed without errors. Not Attempted Downloads did not start. Partial Download Downloads are in progress. Failed Downloads completed with errors. Show RAID Controller Module Description For each RAID controller module in a storage array, this command returns...
Page 349 - Show RAID Controller Module NVSRAM; Show Remote Replication Group
Show RAID Controller Module NVSRAM Description This command returns a list of the NVSRAM byte values for the specified host type. If you do not enter the optional parameters, this command returns a list of all NVSRAM byte values. Syntax show (allControllers | controller [(0 | 1)]) NVSRAM [hostType=(...
Page 350 - Show Remote Replication Group Synchronization
Syntax show (allAsyncRemoteReplicationGroups | asyncRemoteReplicationGroup [" asyncRemoteReplicationGroupName "]) [summary] Parameters Parameter Description allAsyncRemoteReplicationGroups Use this parameter if you want to display the properties for all remote replication groups. asyncRemote...
Page 351 - Show Remote Replication Virtual Disk Candidates
Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to check the synchronization progress. Enclose the remote replication group name in square brackets ([ ]). If the remote replication group name has special characters, you also mu...
Page 352 - Show SNMP Communities
Show Remote Replication Virtual Disk Synchronization Progress NOTE: This command valid only with Fibre Channel storage arrays. Description This command returns the progress of data synchronization between the primary virtual disk and the secondary virtual disk in a Remote Replication configuration. ...
Page 356 - Show Snapshot Image
Auto-delete Snapshot images: Disabled Snapshot image schedule: Not Applicable 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 "] | snap...
Page 357 - Show Snapshot Virtual Disks
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 show snapshot image 12345 in a snapshot group that has the name snapGroup1 , you would use this command: show snapImag...
Page 358 - Show SSD Cache
Notes This command returns snapshot virtual disk information as shown in this example: SNAPSHOT Virtual Disk(SNAPSHOT-IMAGE BASED) SUMMARY SUMMARY Total Snapshot virtual disks: 1 Most Recent Snapshot virtual disk: Day month date hh:mm:ss yyyy Status: 1 Optimal, 0 Non Optimal Name Type Status Capacit...
Page 359 - Show SSD Cache Statistics
Notes This command returns the SSD cache information similar to this example. SSD Cache name: my_cache Status: Optimal Type: Read Only I/O characteristic type: File System Maximum capacity allowed: 1,862.645 GB Current capacity: 557.792 GB Additional capacity allowed 1,304.852 GB Physical disk capac...
Page 363 - Show Storage Array
The available bytes, allocated bytes, and user data bytes are used to compute the Cache Allocation % and the Cache Utilization %. Show Storage Array NOTE: With firmware version 8.10 the cacheFlushStop parameter is deprecated and will be removed in a future release of storage management software. Des...
Page 365 - Show Storage Array Auto Configure
Parameter Description • Time remaining NOTE: When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. Show Storage Array Auto Configure Description This command shows the default autoconfiguration that the storage array cre...
Page 366 - Show Storage Array Core Dump
Parameter Description diskGroupCount Number of disk groups in the storage array. Use integer values. virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group. Use integer values. hotSpareCount Number of hot spares desired in the storage array. Use integer values. For informati...
Page 367 - Show Storage Array DBM Database; Show Storage Array Host Topology
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 Host Top...
Page 368 - Show Storage Array LUN Mappings
NOTE: This command returns the host topology information similar to this example. TOPOLOGY DEFINITIONS DEFAULT GROUP Default type: Windows 2000/Server 2003 Non-Clustered Host Group: scott Host: scott1 Host Port: 28:37:48:55:55:55:55:55 Alias: scott11 Type: Windows 2000/Server 2003 Clustered Host: sc...
Page 369 - Show Storage Array Negotiation Defaults; Show Storage Array ODX Setting
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. The host name an...
Page 370 - Show Storage Array Power Information; Show Storage Array Unconfigured iSCSI Initiators
Syntax show storageArray odxsetting Parameters None. NOTE: This command returns the ODX and VAAI information similar to this example.Windows ODX Setting Status odxEnabled True | False | Inconsistent | Unknown vaaiEnabled True | False | Inconsistent | Unknown Show Storage Array Power Information Desc...
Page 371 - Show Storage Array Unreadable Sectors; Show String
Parameters None. Show Storage Array Unreadable Sectors Description This command returns a table of the addresses of all of the sectors in the storage array that cannot be read. The table is organized with column headings for the following information: • Virtual disk user label• Logical unit number (...
Page 372 - Show Thin Virtual Disk
Show Thin Virtual Disk Description This command returns the expansion history or the consumed capacity for the specified thin virtual disk or virtual disks. Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNameN ]) (consumedCapacity | (e...
Page 373 - Show Virtual Disk
MM/DD/YYYY HH:MM:SS Manual|Automatic NNNNNNNN bytes NNNNNNNN bytes With the consumedCapacity parameter, the command returns information similar to the example shown below. Virtual Disk Physical Capacity Consumned Capacity Quota % Prov. Consumed virtualDiskName 500.000 GB 230.000 GB 700.000 GB 46% Sh...
Page 374 - Show Virtual Disk Action Progress
Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNameN ]) summary Parameters Parameter Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array. virtualDisk or virtualDisks The nam...
Page 375 - Show Virtual Disk Copy
Parameters Parameter Description virtualDisk Name of the virtual disk running the long ‑ running operation. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Copy Descri...
Page 376 - Show Virtual Disk Copy Source Candidates; Show Virtual Disk Copy Target Candidates
Show Virtual Disk Copy Source Candidates Description This command returns information about the candidate virtual disks that you can use as the source for a virtual disk copy operation. Syntax show virtualDiskCopy sourceCandidates Parameters None. Additional Information This command returns virtual ...
Page 377 - Show Virtual Disk Performance Statistics; Show Virtual Disk Reservations
Show Virtual Disk Performance Statistics Description This command returns information about the performance of the virtual disks in a storage array. Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] virtualDisks [ virtualDiskName1... virtualDiskNameN ]) performanceStats Parameters Param...
Page 378 - Start Configuration Database Diagnostic; Start Consistency Group Snapshot Rollback
Start Configuration Database Diagnostic Description This command starts a diagnostic test to validate the configuration database in the RAID controller module firmware. Syntax start storageArray configDbDiagnostic Parameters None. Notes Upon completion of the diagnostic test, the RAID controller mod...
Page 380 - Start Disk Group Blink; Start Disk Group Defragment; Start Disk Group Export
Start Disk Group Blink Description This command identifies the physical disks that are logically grouped together to form the specified disk group by blinking the indicator LEDs on the physical disks. (Use the stop diskGroup blink command to turn off the indicator LEDs on the physical disks.) Syntax...
Page 381 - Start Disk Group Import
Syntax start diskGroup [ diskGroupName ] export Parameters Parameter Description diskGroup Number of the disk group to defragment. You must put brackets ([ ]) around the disk group number. Additional Information When this command is successful, you can run the start diskGroup import command to finis...
Page 382 - Start Disk Pool Locate; Start Enclosure Blink
NOTE: Higher-level virtual disks that are specifically related to premium features (Snapshot, Remote Virtual Disk Replication, Virtual Disk Copy, mapping, and persistent reservations) are removed as part of the import operation. You must run the show diskGroup importDependencies command before you r...
Page 383 - Start Input Output RAID Controller Module (IOC) Dump; Start iSCSI DHCP Refresh
Start Input Output RAID Controller Module (IOC) Dump Description This command produces a dump of the IOC log of data transmissions between a host and a RAID controller module. RAID Controller Modules are identified as "0" or "1". Each RAID controller module can have up to four host c...
Page 384 - Start Physical Disk Blink; Start Physical Disk Channel Blink
Parameters Parameter Description controller The identifier letter of the RAID controller module that has the iSCSI host ports. Valid RAID controller module identifier values are 0 or 1 , where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1. iscsi-host-port ...
Page 385 - Start Physical Disk Initialize; Start Physical Disk Reconstruction
Syntax start physicalDiskChannel [(1 | 2)] blink Parameters Parameter Description physicalDiskChannel The identifier number of the physical disk channel that you want to locate. Valid values for the identifier number are 1 or 2 . Enclose the identifier number in square brackets ([ ]). Start Physical...
Page 386 - Start Remote Replication Synchronization; Start Remote Replication (Legacy) Synchronization
Parameter Description ID values are 0 to 31 . You must put brackets ([ ]) around the enclosure ID value and slot ID value. Start Remote Replication Synchronization Description This command starts Remote Replication synchronization. Syntax start asyncRemoteReplicationGroup [" asyncRemoteReplicati...
Page 387 - Start Secure Physical Disk Erase; Start Snapshot Rollback
Start Secure Physical Disk Erase Description This command erases all of the data from one or more self-encrypting disk (SED) physical disks so that they can be reused as SED physical disks. Run this command only when the SED physical disks are no longer part of a secure disk group, or when the secur...
Page 388 - Start Snapshot Image Rollback
Parameters Parameter Description virtualDisk or virtualDisks Names the specific snapshot virtual disk or snapshot virtual disks for which you want to start a rollback operation. Enclose the snapshot virtual disk name in square brackets ([ ]). If the snapshot virtual disk name has special characters,...
Page 389 - Start SSD Cache Performance Modeling
Parameter Description Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]). 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...
Page 392 - Start Storage Array iSCSI Refresh; Start Virtual Disk Initialization
• Saves a ZIP file containing raw binary data The RAID controller module firmware saves the ZIP file to this location:...\Install_dir\data\FirmwareUpgradeReports\timestamp_buildNo.zip You can use the binary data to help determine the cause of the problem, or you can send the file containing the bina...
Page 393 - Stop Configuration Database Diagnostic
Parameters Parameter Description virtualDisk Name of the virtual disk for which to start the formatting. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Stop Confi...
Page 394 - Stop Consistency Group Snapshot Virtual Disk
Parameters Parameter Description consistencyGroupName The name of the consistency group for which you want to stop a rollback operation. Enclose the name of the consistency group in double quotation marks (" ") inside square brackets ([ ]). When the memberVirtualDiskSet parameter is not used...
Page 395 - Stop Disk Group Blink
Parameter Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk that you want to stop creating. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]) The name of the consistency group snapshot virtual disk that you want to ...
Page 396 - Stop Pending Snapshot Images On Consistency Group; Stop Physical Disk Blink
Syntax stop enclosure blink Parameters None. Stop Pending Snapshot Images On Consistency Group Description This command stops all of the pending snapshot images that are to be created on a snapshot consistency group. If the snapshot consistency group does not have any pending snapshot images, the MD...
Page 397 - Stop Physical Disk Replace
Syntax stop physicalDiskChannel blink Parameters None. Stop Physical Disk Replace Description This command stops a data copy operation that was started by either a set physicalDisk command or a replace physicalDisk command with the copyPhysicalDisk user input. Syntax stop physicalDisk replace ([encl...
Page 398 - Stop Snapshot Group Image; Stop Snapshot Group Pending Snapshot Images
Stop Snapshot Group Image Description This command cancels a pending snapshot image copy-on-write operation on a snapshot image group. If the snapshot image group does not have any pending snapshot images, this command returns an error message. Syntax stop (snapGroup [ snapGroupName ] | consistencyG...
Page 401 - Stop Snapshot Rollback; Stop Snapshot Image Rollback
Parameter Description If the virtual disk names have special characters or numbers, enter the names using these rules:• Enclose all names in square brackets ([ ]).• Enclose each name in double quotation marks (" "). • Separate each name with a space. Stop Snapshot Rollback Description This c...
Page 402 - Stop Snapshot Virtual Disk
Parameter Parameter Description snapImage The name of the snapshot image for which you want to stop a rollback operation. The name of a snapshot image is comprised of two parts:• The name of the snapshot group.• An identifier for the snapshot image in the snapshot group. The identifier for the snaps...
Page 403 - Stop SSD Cache Performance Modeling
Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk that you want to stop. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]). Stop SSD Cache Performance Modeling D...
Page 406 - Stop Storage Array iSCSI Session; Stop Storage Array Physical Disk Firmware Download; Stop Virtual Disk Copy
Stop Storage Array iSCSI Session Description This command forces the termination of an iSCSI session. Syntax stop storageArray iscsiSession [ sessionNumber ] Parameters Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session i...
Page 407 - Suspend Remote Replication
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...
Page 408 - Suspend Remote Replication Group; Suspend SSD Cache
NOTE: If the writeConsistency parameter is set to TRUE , the virtual disks must be in a write- consistency group (or groups). This command suspends all write-consistency groups that contain the virtual disks. For example, if virtual disks A, B, and C are in a write-consistency group and they have re...
Page 409 - Test Remote Replication Group Connectivity
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,...
Page 410 - Test SNMP Trap Destination
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...
Page 411 - Unregister SNMP Community; Unregister SNMP Trap Destination; Update SNMP Community
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 associ...
Page 412 - Update SNMP MIB II System Group Variables
Syntax set snmpCommunity communityName="snmpCommunityName" newCommunityName="newSnmpCommunityName" 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 (" "). ...
Page 413 - Update SNMP Trap Destination; Validate Storage Array Security Key
Parameter Description sysLocation The physical location of the system, such as "3rd flr". Enclose the SNMP system location in square brackets([ ]). Update SNMP Trap Destination Description This command turns on or turns off sending authentication failure messages for an SNMP trap destination...
Page 415 - Sample Script Files; Configuration Script Example 1
13 Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array. Create a script file in two w...
Page 417 - Configuration Script Example 2
Configuration Script Example 2 This example creates a new virtual disk using the create virtualDisk command with user-defined physical disks in the storage array. Show "Create RAID 5 Virtual Disk 2 on existing Disk Group 2"; //This command creates the disk group and the initial virtual disk ...