Page 1 Dell PowerVault Modular Disk Storage Arrays CLI Guide...
Page 2: Notes And Cautions
© 2010–2011 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell™, the DELL logo, and PowerVault™ are trademarks of Dell Inc. ® ®...
Page 3: Table Of Contents
Contents About the Command Line Interface ..How to Use the Command Line Interface ..Usage Notes ....CLI Commands .
Page 4 Determining What is on Your Storage Array ..Saving a Configuration to a File ... Using the Create Virtual Disk Command ..Using the Auto Configure Command .
Page 5 Re-creating the Snapshot Virtual Disk ..Preparing Host Servers to Re-create a Snapshot Virtual Disk ....Re-creating a Snapshot Virtual Disk .
Page 6 Replication Repository Virtual Disks ..Replication Relationships ....Data Replication ....Link Interruptions or Secondary Virtual Disk Errors .
Page 7 Maintaining a Storage Array ..Routine Maintenance ....Running a Media Scan ....Running a Consistency Check .
Page 8 Script Commands ....Command Formatting Rules ....Firmware Compatibility Levels .
Page 9 Create Disk Group ....Create Host ..... Create Host Group .
Page 10 Enable RAID Controller Module Data Transfer ....Enable Storage Array Feature ..Recopy Virtual Disk Copy ... . . Re-create Remote Replication Repository Virtual Disk .
Page 11 Set Disk Group Forced State ... . Set Enclosure Attribute ....Set Enclosure Identification ... . Set Foreign Physical Disk to Native .
Page 12 Show Current iSCSI Sessions ..Show Disk Group ....Show Disk Group Export Dependencies ..Show Disk Group Import Dependencies .
Page 13 Show Virtual Disk Reservations ..Start Configuration Database Diagnostic ..Start Disk Group Blink ....Start Disk Group Defragment .
Page 14 A Sample Script Files ....Configuration Script Example 1 ... . Configuration Script Example 2 .
Page 15: About The Command Line Interface
For additional information, see the hardware and software manuals that shipped with your system. NOTE: Always check for updates on support.dell.com and read the updates first because they often supersede information in other documents. NOTE: CLI commands do not have interactive warnings for destructive commands.
Page 16: How To Use The Command Line Interface
You can use the command line interface to perform the following functions: • Directly access the script engine and run commands in interactive mode or using a script file. • Create script command batch files to be run on multiple storage arrays when you need to install the same configuration on different storage arrays.
Page 17: Usage Notes
The following syntax is the general form of a CLI command: SMcli storageArray parameters script-commands; where, SMcli invokes the command line interface storageArray is the host name or IP address of the storage array parameters are the CLI parameters that define the environment and purpose of the command script-commands are the commands or name of the script file containing the script commands...
Page 18: Cli Commands
CLI Commands This section lists the CLI commands you can use to perform the following functions: • Identify storage arrays • Set passwords • Add storage arrays • Specify communication parameters • Enter individual script configuration commands • Specify a file containing script configuration commands The following are general forms of the CLI commands, showing the parameters and terminals used in each command.
Page 19 SMcli (-n storage-array-name | -w WWID) [-c "command; {command2};"] [-o outputfile][-p password][-e][-S] SMcli (-n storage-array-name | -w WWID) [-f scriptfile] [-o outputfile] [-p password] [-e] [-S] SMcli (-n storage-array-name | -w WWID) [-o outputfile][-p password][-e][-S] SMcli -a email:email-address [host-name-or-IP-address1 [host-name-or-IP-address2]] [-n storage-array-name | -w WWID | -h host-name | -r (host_sa | direct_sa)] [-I information-to-include][-q frequency][-S]...
Page 20: Command Line Parameters
Command Line Parameters Table 1-2. Command Line Parameters Parameter Definition host-name-or-IP-address Specify either the host name or the Internet Protocol (IP) address of an in-band managed storage array (IPv4 or IPv6) or an out-of-band managed storage array (IPv4 or IPv6). •...
Page 21 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command by using a semicolon (;). You cannot place more than one -c parameter on the same command line.
Page 22 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify an ASCII file that contains e-mail sender contact information to include in all e-mail alert notifications. The CLI assumes the ASCII file is text only, without delimiters or any expected format. A typical file contains the following information: •...
Page 23 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify the name of the storage array on which to run the script commands. This name is optional when you use host-name-or-IP-address; however, if you are using the in-band method for managing the storage array, you must use the -n parameter if more than one storage array is connected to the host at the specified address.
Page 24 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify how frequently to include additional profile or support bundle information in the e-mail alert notifications. An e-mail alert notification that contains at least the basic event information is always generated for every critical event.
Page 25 (continued) Table 1-2. Command Line Parameters Parameter Definition -S (uppercase) Use to suppress the informational messages describing command progress that appear when running script commands. (Suppressing informational messages is also called silent mode.) This parameter suppresses the following messages: • Performance syntax check •...
Page 26: Formatting Considerations
Formatting Considerations Quotation marks (" ") used as part of a name or label require special consideration when you run the CLI and script commands on a Microsoft Windows operating system. The following explains the use of quotation marks in names while running CLI and script commands on Windows. When quotation marks ("...
Page 27: Exit Status
When the CLI encounters either type of error, it writes information describing the error directly to the command line and sets a return code. Depending on the return code, the CLI might also write additional information about which parameter caused the error. The CLI also writes information about what command syntax was expected to help you identify any syntax errors you might have entered.
Page 28 (continued) Table 1-3. Exit Status Status Value Meaning The storage array name was not in the configuration file. A management class does not exist for the storage array. A storage array was not found in the configuration file. An internal error occurred. Invalid script syntax was found.
Page 29: Usage Examples
Usage Examples The following examples show how to enter CLI commands on a command line. The examples show the syntax, form, and, in some examples, script commands. Examples are shown for both Windows and Linux operating systems. The usage for the -c parameter varies depending on your operating system.
Page 30 physicalDiskCount[3] raidLevel=5 capacity=10 GB userLabel="Finance"; show storageArray healthStatus;’ This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example. The -e parameter runs the file without checking syntax. Executing an SMcli command without checking syntax enables the file to run more quickly;...
Page 31: About The Script Commands
About the Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or run a file of script commands.
Page 32: Script Command Structure
(continued) Table 2-1. Configuration and Management Operations Operation Activities General storage array Resetting a configuration to defaults, labeling, configuration checking the health status, setting the time of day, clearing the Major Event Log, and setting the media scan rate NVSRAM configuration Downloading and modifying the user configuration region at the bit and byte level, displaying nonvolatile static random access memory (NVSRAM) values...
Page 33 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. Use an object type when the command is not referencing a specific object.
Page 34: Script Command Synopsis
Statement data is in the form of attribute=value (such as raidLevel=5), an attribute name (such as batteryInstallDate), or an operation name (such as consistencyCheck). Script Command Synopsis Because you can use the script commands to define and manage the different aspects of a storage array (such as host topology, physical disk configuration, RAID controller module configuration, virtual disk definitions, and disk group definitions), the actual number of commands is extensive.
Page 35 (continued) Table 2-3. General Form of the Script Commands Command Syntax Description download object Transfers data to the storage array or hardware {statement-data} associated with the storage array. enable object Allows a feature to operate. {statement-data} recopy object Restarts a virtual disk copy operation by using an {statement-data} existing virtual disk copy pair.
Page 36: Recurring Syntax Elements
Recurring Syntax Elements Recurring syntax elements are a general category of variables and parameters you can use in one or more script commands. The recurring syntax is used in the general definitions of the script commands that are listed in "Script Commands"...
Page 37 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value filename string-literal error-action (stop | continue) physical disk-channel-identifier (1 | 2) physical disk-channel-identifier-list physical disk-channel-identifier {physical disk-channel-identifier} host-channel-identifier (01 | 02 | 11 | 12) physical disk-type (Serial Attached SCSI [SAS] | Serial Advanced Technology Attachment [SATA]) feature-identifier...
Page 38 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value iscsi-host-port-options IPV4Address=ipv4-address | IPV6LocalAddress=ipv6-address | IPV6RoutableAddress=ipv6-address | IPV6RouterAddress=ipv6-address | enableIPV4= boolean | enableIPV6=boolean | enableIPV4Vlan=boolean | enableIPV6Vlan=boolean | enableIPV6Priority=boolean | enableIPV6Priority=boolean | IPV4ConfigurationMethod=(static | dhcp) | IPV6ConfigurationMethod=(static | auto) | IPV4GatewayIP= ipv4-address | IPV6HopLimit=integer | IPV6NdDetectDuplicateAddress=...
Page 39 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value instance-based-repository-spec repositoryRAIDLevel=repository-raid- level repositoryPhysicalDisks=(physical disk- spec-list) [enclosureLossProtect=boolean] repositoryDiskGroup=virtual-disk- group-number [freeCapacityArea=integer-literal] Specify repositoryRAIDLevel with repositoryPhysicalDisks. Do not specify RAID level or physical disks with a disk group. Do not set enclosureLossProtect when specifying a disk group.
Page 40 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value nvsram-offset hexadecimal-literal host-type string-literal | integer-literal nvsram-byte-setting nvsram-value (0x hexadecimal | integer-literal) nvsram-bit-setting nvsram-mask, nvsram-value (0x hexadecimal, 0x hexadecimal | integer-literal) ipv4-address (0–255).(0–255).(0–255).(0–255) ipv6-address (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFF) autoconfigure-vols-attr-value-list autoconfigure-vols-attr-value-pair {autoconfigure-vols-attr-value-pair} autoconfigure-vols-attr-value-pair physicalDiskType=physical disk-type| raidLevel=raid-level |...
Page 41 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value create-virtual-disk-copy-attr-value-list create-virtual-disk-copy-attr-value-pair {create-virtual-disk-copy-attr-value-pair} create-virtual-disk-copy-attr-value-pair copyPriority=highest | high | medium | low | lowest | targetReadOnlyEnabled=boolean recover-raid-virtual-disk-attr-value-list recover-raid-virtual-disk-attr-value-pair {recover-raid-virtual-disk-attr-value-pair} recover-raid-virtual-disk-attr-value-pair owner=(0 | 1) Table 2-5. Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values IPV4Priority...
Page 42: Usage Guidelines
(continued) Table 2-5. Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values maxFramePayload 1500 NOTE: The maxFramePayload parameter is shared between IPv4 and IPv6. The payload portion of a standard Ethernet frame is set at 1500 bytes, and a jumbo Ethernet frame is set at 9000 bytes.
Page 43: Adding Comments To A Script File
NOTE: capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its unit of measure. (For example, returns an error, but does not return an error). 10 GB 10 GB Adding Comments to a Script File...
Page 44 About the Script Commands...
Page 45: Configuring A Storage Array
Configuring a Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts and terminology.
Page 46: Configuring A Storage Array
command. On Windows, you must enclose the name between two backslashes (\) in addition to other delimiters. For example, the following name is used in a command that runs under Windows: [\"Engineering\"] For a Linux system when used in a script file, the name appears as: ["Engineering"] Configuring a Storage Array When you configure a storage array, you can maximize data availability by...
Page 47 The show storageArray command returns the following general information about the components and properties of the storage array: • A detailed profile of the components and features in the storage array • The battery age • The default host type (which is the current host type) •...
Page 48 CAUTION: When you write information to a file, the script engine does not check to determine if the file name already exists. If you choose the name of a file that already exists, the script engine writes over the information in the file without warning.
Page 49: Saving A Configuration To A File
• show controller NVSRAM ("Show RAID Controller Module NVSRAM" on page 278) • show storageArray unreadableSectors ("Show Storage Array Unreadable Sectors" on page 286) • show virtualDiskCopy sourceCandidates ("Show Virtual Disk Copy Source Candidates" on page 290) • show virtualDiskCopy targetCandidates ("Show Virtual Disk Copy Target Candidates"...
Page 50: Using The Create Virtual Disk Command
client>smcli 123.45.67.89 -c "save storageArray configuration file= \"c:\folder\storageArrayconfig1.scr\";" In this example, the name folder is the folder in which you choose to place the configuration file, and storageArrayconfig1.scr is the name of the file. Choose any folder and any file name. MD Storage Manager uses the file extension .scr when it creates the configuration file.
Page 51 The userLabel parameter is the name to give to the virtual disk. The virtual disk name can be any combination of alphanumeric characters, hyphens, and underscores. The maximum length of the virtual disk name is 30 characters. Spaces are not allowed. You must put quotation marks (" ") around the virtual disk name.
Page 52 Because only 20 GB are assigned to the virtual disk, 199 GB remain available for other virtual disks that you can later add to this disk group. The segment size for each virtual disk is 64 KB. Hot spares have not been created for this new disk group.
Page 53 Example of Creating Virtual Disks with Software-Assigned Physical Disks client>smcli 123.45.67.89 -c "create virtualDisk physicalDiskCount=3 raidLevel=5 userLabel= \"Engineering_1"\ capacity=20 GB owner=0 segmentSize=64;" The command in this example creates the same virtual disk as the previous create virtualDisk command, however, in this case the user does not know which physical disks are assigned to this disk group.
Page 54: Using The Auto Configure Command
Enclosure Loss Protection The enclosureLossProtect parameter is a boolean switch that turns enclosure loss protection on or off. To work properly, each physical disk in a virtual disk group must be in a separate enclosure. Enclosure loss protection is set under the following conditions: •...
Page 55 • Number of physical disks in a disk group • Number of disk groups • Number of virtual disks in each disk group • Number of hot spares • Size of each segment on the physical disks After defining these parameters, the MD Storage Manager automatically creates the disk groups, virtual disks, and hot spares.
Page 56 When you use the autoConfigure storageArray command without specifying the number of disk groups, the firmware determines how many virtual disks and disk groups to create. The firmware creates one disk group and one virtual disk up to the maximum number that the storage array can support. When you specify the number of disk groups, the firmware creates only that number of disk groups.
Page 57: Modifying Your Configuration
For optimal performance in a multi-user database or file system storage environment, set the segment size to minimize the number of physical disks needed to satisfy an I/O request. Using a single physical disk for a single request leaves other physical disks available to simultaneously service other requests.
Page 58: Setting The Storage Array Password
• Storage array host type • Global hot spares NOTE: Before modifying your configuration, save a copy of your current configuration to a file (see "Saving a Configuration to a File" on page 49). If you have problems with your modifications, you can use the information in the file to restore your previous configuration.
Page 59: Setting The Raid Controller Module Clocks
By default, all alert configuration settings are None. The following example shows how to set the mail server IP and the sender address configurations for SMTP alerts: SMcli -m 123.45.67.89 -F [email protected] SMcli -m MyCompany.com -F [email protected] An example of a command to set the email alert destination and specify that only event information is to be sent is: SMcli -a email:[email protected] 123.45.67.89 -I eventOnly...
Page 60: Setting Modification Priority
The defaultHostType parameter defines how the RAID controller modules communicate with the operating system on undefined hosts connected to the storage array. This parameter defines the host type only for storage array data I/O activities; it does not define the host type for the management station. The operating system can be Windows or Linux.
Page 61: Assigning Global Hot Spares
• Initialization • Changing segment size • Defragmentation of a disk group • Adding free capacity to a disk group • Changing the RAID level of a disk group The lowest priority rate favors system performance, but the modification operation takes longer. The highest priority rate favors the modification operation, but the system performance might be degraded.
Page 62 You can assign or unassign global hot spares by using the set physicalDisk command. To use this command, you must perform these steps: 1 Identify the location of the physical disks by enclosure ID and slot ID. 2 Set the hotSpare parameter to TRUE to enable the hot spare or FALSE to disable an existing hot spare.
Page 63: Using The Snapshot Feature
Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature. For more information, see "Premium Feature —...
Page 64 • Map the snapshot virtual disk and make it accessible to any host on a storage area network. You can make snapshot data available to secondary hosts for read and write access by mapping the snapshot to the hosts. • Create up to four snapshots per virtual disk.
Page 65: Using Host Servers To Create An Initial Snapshot Virtual Disk
For details on mapping the snapshot virtual disk to the secondary node, see the PowerVault MD3200 and MD3220 Storage Arrays With Microsoft Windows Server Failover Clusters or Dell PowerVault MD3200i and MD3220i Storage Arrays With Microsoft Windows Server Failover Clusters at support.dell.com/manuals.
Page 66: Creating A Snapshot Virtual Disk
Creating a Snapshot Virtual Disk The create snapshotVirtualDisk command provides three methods for defining the physical disks for your snapshot repository virtual disk: • Define each physical disk for the snapshot repository virtual disk by enclosure ID and slot ID. •...
Page 67: Enabling The Snapshot Virtual Disk Feature
Enabling the Snapshot Virtual Disk Feature The first step in creating a snapshot virtual disk is to make sure the feature is enabled on the storage array. You need a feature key to enable the feature. The command for enabling the feature key file is: enable storageArray feature file="filename"...
Page 68: Creating The Initial Snapshot Virtual Disk
3 Remove the drive letter(s) of the source in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the Snapshot. If this is not done, the snapshot operation reports that it has completed successfully, but the snapshot data is not updated properly.
Page 69 See step 1 through step 4 in the preceding section, "Preparing Host Servers to Create an Initial Snapshot Virtual Disk" on page 67. The following example shows a command in which users assign the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\"...
Page 70: Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks
Creating a Snapshot Virtual Disk with Software-Assigned Physical Disks This version of the create snapshotVirtualDisk command lets you choose an existing disk group in which to place the snapshot repository virtual disk. The storage management software determines which physical disks to use. You can also define how much space to assign to the repository virtual disk.
Page 71: Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks
Define the capacity of a snapshot repository virtual disk as any percentage of the size of the source virtual disk. A value of 20 percent is a good compromise between size and speed. In the previous example, the size of the snapshot repository is set to 4 GB.
Page 72: User-Defined Parameters
The command in this example creates a new snapshot repository virtual disk that consists of three physical disks. The three physical disks comprise a new disk group with a RAID level of 5. This command also takes a snapshot of the source virtual disk, which starts the copy-on-write operation.
Page 73 (continued) Table 4-3. Snapshot Virtual Disk Parameters Parameter Description userLabel Specifies the name to give to the snapshot virtual disk. If you do not choose a name for the snapshot virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the source virtual disk name is Mars_Spirit_4 and it does not have a snapshot virtual disk, the default snapshot virtual disk name is Mars_Spirit_4-1.
Page 74: Names Of Snapshot Virtual Disks And Repository Virtual Disks
The following example of the create snapshotVirtualDisk command includes user-defined parameters: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel=\"Mars_Spirit_4_snap1\" repositoryUserLabel=\"Mars_Spirit_4_rep1\" warningThresholdPercent=75 repositoryPercentOfSource=40 repositoryFullPolicy=failSnapShot;" The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4"...
Page 75: Changing Snapshot Virtual Disk Settings
name Engineering Data, the snapshot virtual disk can have a name Engineering Data-S1. The repository virtual disk can have a name of Engineering Data-R1. If you do not choose a unique name for either the snapshot virtual disk or repository virtual disk, the RAID controller modules create a default name by using the name of the source virtual disk.
Page 76: Stopping And Deleting A Snapshot Virtual Disk
The following example is the script file version of the command: set virtualDisk ["Mars_Spirit_4-1"] userLabel= "Mars_Odyssey_3-2"; When you change the warning threshold percent and repository full policy, you can apply the changes to one or several snapshot virtual disks. The following example uses the set (snapshot) virtualDisk command to change these properties on more than one snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisks...
Page 77: Re-Creating The Snapshot Virtual Disk
When you stop the copy-on-write operations for a specific snapshot virtual disk, only that snapshot virtual disk is disabled. All other snapshot virtual disks remain in operation. Re-creating the Snapshot Virtual Disk To restart a copy-on-write operation, use the recreate snapshot virtualDisk command.
Page 78: Re-Creating A Snapshot Virtual Disk
SMrepassist -f and press . See "SMrepassist Utility" in the Owner’s Manual for more information. 3 Remove the drive letter(s) of the source and (if mounted) snapshot virtual disk in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the Snapshot.
Page 79: Using The Virtual Disk Copy Feature
If you ordered Premium Features for Virtual Disk Copy, you received a Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature.
Page 80: Creating A Virtual Disk Copy
Table 5-1 lists the Virtual Disk Copy commands and briefly describes what the commands do. Table 5-1. Virtual Disk Copy Commands Command Description create virtualDiskCopy Creates a virtual disk copy and starts the virtual disk copy operation. disable storageArray Turns off the current virtual disk copy operation. feature=virtualDiskCopy enable storageArray feature Activates the Virtual Disk Copy feature.
Page 81: Enabling The Virtual Disk Copy Feature
The following steps show the general process for creating a virtual disk copy: 1 Enable the Virtual Disk Copy feature. 2 Determine candidates for a virtual disk copy. 3 Create the target virtual disk and source virtual disk for a virtual disk copy. Enabling the Virtual Disk Copy Feature The first step in creating a virtual disk copy is to make sure the feature is enabled on the storage array.
Page 82: Creating A Virtual Disk Copy
Creating a Virtual Disk Copy CAUTION: A virtual disk copy overwrites data on the target virtual disk. Ensure that you no longer need the data or have backed up the data on the target virtual disk before starting a virtual disk copy. When you create a virtual disk copy, you must define which virtual disks to use for the source virtual disk and target virtual disks.
Page 83: Copying The Virtual Disk
3 Remove the drive letter(s) of the source and (if mounted) virtual disk in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the virtual disk. If this is not done, the copy operation reports that it has completed successfully, but the copied data is not updated properly.
Page 84: Viewing Virtual Disk Copy Properties
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\" copyPriority=medium targetreadonlyenabled=true" The command in this example copies the data from the source virtual disk named Jaba_Hut to the target virtual disk named Obi_1. Setting the copy priority to medium provides a compromise between the following storage array operations: •...
Page 85: Changing Virtual Disk Copy Settings
• The completion timestamp • The virtual disk copy priority • The read-only attribute setting for the target virtual disk • The source virtual disk World Wide Identifier (WWID) or the target virtual disk WWID A virtual disk can be a source virtual disk for one virtual disk copy and a target virtual disk for another virtual disk copy.
Page 86 Copy priority has five relative settings, which range from highest to lowest. The highest priority supports the virtual disk copy, but I/O activity might be affected. The lowest priority supports I/O activity, but the virtual disk copy takes longer. You can change the copy priority at three different times in the operation: •...
Page 87: Recopying 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 virtualDiskcopy target ["Obi_1"] copyPriority= highest targetreadonlyenabled=false; Recopying a Virtual Disk CAUTION: The recopy virtualDiskCopy command overwrites existing data on the...
Page 88: Recopying The Virtual Disk
NOTE: Removing the drive letter of the associated virtual disk(s) in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the drive for the virtual disk copy. Before creating a new virtual disk copy for an existing copy pair, both the server and the associated virtual disk you are recopying have to be in the proper state.
Page 89: Stopping A Virtual Disk Copy
NOTE: Use one or all of the optional parameters as needed to help define your configuration. It is not necessary to use any optional parameters. Refer to steps 1 through 4 in the preceding section, "Preparing Host Servers to Recopy a Virtual Disk" on page 87. The following example shows a command that changes the copy priority: client>smcli 123.45.67.89 -c "recopy virtualDiskCopy target [\"Obi_1\"] copyPriority=...
Page 90: Removing Copy Pairs
client>smcli 123.45.67.89 -c "stop virtualDiskCopy target [\"Obi_1\"];" The following example is the script file version of the command: stop virtualDiskCopy target ["Obi_1"]; 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.
Page 91: Storage Partitioning
When running the Virtual Disk Copy feature with other features, you must take the requirements of other features into consideration to ensure you set up a stable storage array configuration. You can also run the Virtual Disk Copy feature while running Dynamic Virtual Disk Expansion. Storage Partitioning Storage partitioning enables hosts to share access to virtual disks in a storage array.
Page 92 Creating a snapshot virtual disk automatically creates a snapshot repository virtual disk. The snapshot repository virtual disk stores information about the data that has changed since the snapshot virtual disk was created. Snapshot repository virtual disks cannot be selected as a source virtual disk or target virtual disk in a virtual disk copy.
Page 93: Using The Remote Replication
Using the Remote Replication Premium Feature The Remote Replication premium feature provides for online, real-time replication of data between storage arrays over a remote distance. In the event of a disaster or a catastrophic failure on one storage array, you can promote the second storage array to take over responsibility for computing services.
Page 94: How Remote Replication Works
How Remote Replication Works When you create a remote replicated pair, the remote replicated pair consists of a primary virtual disk on a local storage array and a secondary virtual disk on a storage array at another site. A standard virtual disk might only be included in one replicated virtual disk pair.
Page 95: Replication Relationships
When you activate the Remote Replication premium feature on the storage array, you create two replication repository virtual disks, one for each RAID controller module in the storage array. An individual replication repository virtual disk is not needed for each remote replication. When you create the replication repository virtual disks, you specify the location of the virtual disks.
Page 96 between the storage arrays that are participating in Remote Replication. This section also describes the actions taken by the RAID controller module owner of the primary virtual disk if a link interruption occurs between storage arrays. Write Modes When the RAID controller module owner of the primary virtual disk receives a write request from a host, the RAID controller module first logs information about the write to a replication repository virtual disk, and then writes the data to the primary virtual disk.
Page 97: Link Interruptions Or Secondary Virtual Disk Errors
When using Asynchronous write mode, write requests are not guaranteed to be completed in the same order on the secondary virtual disk as they are on the primary virtual disk. If the order of write requests is not retained, data on the secondary virtual disk might become inconsistent with the data on the primary virtual disk.
Page 98: Resynchronization
the secondary virtual disk. After the resynchronization starts, the replicated pair transitions from an Unsynchronized status to a Synchronization in Progress status. The primary RAID controller module also marks the replicated pair as unsynchronized when a virtual disk error on the secondary side prevents the remote write from completing.
Page 99: Creating A Remote Replicated Pair
CAUTION: Possible loss of data access – Any communication disruptions between the primary storage array and the secondary storage array while resynchronization is underway could result in a mix of new data and old data on the secondary virtual disk. This condition would render the data unusable in a disaster recovery situation.
Page 100: Performance Considerations
Performance Considerations Keep these performance considerations in mind when you create replication relationships: • The RAID controller module owner of a primary virtual disk performs a full synchronization in the background while processing local I/O writes to the primary virtual disk and associated remote writes to the secondary virtual disk.
Page 101: Enabling The Remote Replication Premium Feature
Enabling the Remote Replication Premium Feature The first step in creating a remote replication is to make sure that the Remote Replication premium feature is enabled on both storage arrays. Because Remote Replication is a premium feature, you need a feature key file to enable the premium feature.
Page 102 The RAID level that you choose for the replication repository virtual disk has these constraints: • RAID Level 0 – You cannot use RAID Level 0. • RAID Level 1 – The number of physical disks must be an even number. If you select an odd number of physical disks, the RAID controller module firmware returns an error.
Page 103 repositoryPhysicalDisks=(enclosureID1,slotID1 ... enclosureIDn,slotIDn) enclosureLossProtect=(TRUE | FALSE) This example shows a command in which you assign the physical disks: c:\...\smX\client>smcli 123.45.67.88 123.45.67.89 -c “activate storageArray feature=remoteReplication repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5);” The command in this example creates a new replication repository virtual disk consisting of five physical disks that form a new disk group.
Page 104 This example shows a command in which the software assigns the physical disks: c:\...\smX\client>smcli 123.45.67.88 123.45.67.89 -c “activate storageArray feature=remoteReplication repositoryDiskGroup=2 freeCapacityArea=2;” 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;...
Page 105: Determining Candidates For A Remote Replicated Pair
The command in this example creates a new replication repository virtual disk by using five software-selected physical disks for the replication repository virtual disk. The replication repository virtual disk has RAID Level 5. The type of physical disk for the replication repository virtual disk is SAS. This example shows how to use the command in a script file: activate storageArray feature=remoteReplication repositoryRAIDLevel=5 repositoryCount=5...
Page 106 the secondary virtual disk name, and the remote storage array name (or WWID) are the minimum information that you need to provide. Using this command, you can also define synchronization priority, write order, and write mode. The command takes this form: create remoteReplication primary= “primaryVirtualDiskName”...
Page 107: Changing Remote Replication Settings
Setting the write mode to synchronous and the synchronization priority to highest means that host write requests are written to the primary virtual disk and then immediately copied to the secondary virtual disk. These actions help to make sure that the data on the secondary virtual disk is as accurate a copy of the data on the primary virtual disk as possible.
Page 108: Suspending And Resuming A Replication Relationship
-c “set remoteReplication localVirtualDisk [Jan_04_Account] syncPriority=medium writeOrder=notpreserved writeMode=asynchronous;” This example shows how to use the command in a script file: set remoteReplication localVirtualDisk [Jan_04_Account] syncPriority=medium writeOrder=notpreserved writeMode=asynchronous; Suspending and Resuming a Replication Relationship Use the suspend remoteReplication command to stop data transfer between a primary virtual disk and a secondary virtual disk in a replication relationship without disabling the replication relationship.
Page 109 NOTE: If you suspend a remote replication that is set up in the Write consistency mode, you suspend all remote replicated pairs within the group. You can then resume replication operations for any of the individual remote replicated pairs that are in the group.
Page 110: Removing A Replication Relationship
Removing a Replication Relationship Use the remove remoteReplication command to remove the link between a primary virtual disk and a secondary virtual disk. (Removing a replication relationship is similar to deleting a replication relationship.) Removing the link between a primary virtual disk and a secondary virtual disk does not affect any of the existing data on either virtual disk.
Page 111: Disabling The Remote Replication Premium Feature
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 maintain and manage previously existing replication relationships;...
Page 112: Snapshot Virtual Disks
Snapshot Virtual Disks A snapshot is a point-in-time image of a virtual disk. Typically, it is created so that an application, such as a backup application, can access the snapshot virtual disk and read the data while the base virtual disk stays online and is accessible to hosts.
Page 113: Storage Partitioning
Storage Partitioning Storage Partitioning is a feature that allows hosts to share access to virtual disks in a storage array. You create a storage partition when you define any of these logical components in a storage array: • A host •...
Page 114 Using the Remote Replication Premium Feature...
Page 115: Maintaining A Storage Array
Maintaining a Storage Array Maintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all hosts. This chapter provides descriptions of command line interface (CLI) and script commands that you can use to perform storage array maintenance.
Page 116 A media scan runs on all virtual disks in the storage array with the following conditions: • An Optimal status • No modification operations in progress • Media scan enabled • Errors detected during a scan of a user virtual disk are reported to the MEL and handled as: –...
Page 117: Running A Consistency Check
The set virtualDisk command enables a media scan for the virtual disk. The following syntax is the general form of the command: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen] | virtualDisk ) mediaScanEnabled=(TRUE | FALSE) The set storageArray command defines how frequently a media scan is run on a storage array.
Page 118: Resetting A Raid Controller Module
Resetting a RAID Controller Module CAUTION: When you reset a RAID controller module, the RAID controller module is not available for I/O operations until the reset is complete. If a host is using virtual disks owned by the RAID controller module being reset, the I/O directed to the RAID controller module is rejected.
Page 119: Synchronizing Raid Controller Module Clocks
To determine which virtual disks have reservations, run the following command: show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) reservations To clear persistent virtual disk reservations, run the following command: clear (allVirtualDisks | virtualDisk[virtualDiskName] | virtualDisks [virtualDiskName1" ... "virtualDiskNameN]) reservations Synchronizing RAID Controller Module Clocks To synchronize the clocks on both RAID controller modules in a storage array...
Page 120: Performance Tuning
Performance Tuning Over time, as a storage array exchanges data between the hosts and physical disks, its performance can degrade. Monitor the performance of a storage array and make adjustments to the storage array operational settings to improve performance. Monitoring Performance Monitor the performance of a storage array by using the save storageArray performanceStats command.
Page 121: Changing Raid Levels
(continued) Table 7-1. Storage Array Performance Information Type of Information Description Current IO/second Current number of I/Os per second (current means the number of I/Os per second since the last time the polling interval elapsed, causing an update to occur) Maximum IO/second Highest number of I/Os achieved in the current I/O-per-second statistic block The general form of the command is:...
Page 122: Defragmenting A Disk Group
request leaves other disks available to simultaneously service other requests. If the virtual disk is in a single-user large I/O environment, performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | ) segmentSize=segmentSizeValue...
Page 123: Troubleshooting And Diagnostics
Troubleshooting and Diagnostics If a storage array exhibits abnormal operation or failures, you can use the commands described in this section to determine the cause of the problems. Collecting Physical Disk Data To gather information about all the physical disks in a storage array, run the save allPhysicalDisks command.
Page 124: Recovery Operations
For best results, run all three tests at initial installation. Also, run the tests any time you make changes to the storage array or to components connected to the storage array (such as hubs, switches, and host adapters). A custom data pattern file called diagnosticsDataPattern.dpf is included on the Utility directory of the installation CD.
Page 125 Placing a RAID controller module online sets it to the Optimal state and makes it active and available for I/O operations. Placing a RAID controller module offline makes it unavailable for I/O operations and moves its disk groups to the other RAID controller module if failover protection is enabled. Taking a RAID controller module offline can seriously impact data integrity and storage array operation.
Page 126: Changing Raid Controller Module Ownership
Changing RAID Controller Module Ownership You can change which RAID controller module owns a virtual disk by using the set virtualDisk command. The following syntax is the general form of the command: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...
Page 127: Reconstructing A Physical Disk
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.
Page 128: Redistributing Virtual Disks
Redistributing Virtual Disks Redistributing virtual disks returns the virtual disks to their preferred RAID controller module owners. The preferred RAID controller module ownership of a virtual disk or disk group is the RAID controller module of an active- active pair that is designated to own the virtual disks. The preferred owner for a virtual disk is initially designated when the virtual disk is created.
Page 129: Script Commands
Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the current configuration so that you can reinstall it if the changes do not work.
Page 130: Command Formatting Rules
CAUTION: Commands entered using the command line interface (CLI) are capable of damaging a configuration and causing loss of data if not used properly. Command operations are performed as soon as you run the commands. Some commands can immediately delete configurations or data. Before using the command line interface, make sure you have backed up all data, and save the current configuration so that you can reinstall it if the changes you make do not work.
Page 131 To use the raidLevel parameter to set a RAID level of 5, enter: raidLevel=5 • When you specify physical disk locations by using enclosure ID values and slot ID values, separate the ID values with a comma. If you enter more than one set of ID values, separate each set of values by a space.
Page 132: Firmware Compatibility Levels
On Microsoft Windows, you must put a backslash (\) before and after the name in addition to other delimiters. For example, the following name is used in a command running under a Windows operating system: [\"Engineering"\] For Linux, and when used in a script file, the name appears as the following: ["Engineering"] When you enter the World Wide Identifier (WWID) of an HBA host...
Page 133: Enclosure Commands
"Show Disk Group Export Dependencies" on page 270 "Show Disk Group Import Dependencies" on page 271 "Start Disk Group Blink" on page 294 "Start Disk Group Defragment" on page 294 "Start Disk Group Export" on page 295 "Start Disk Group Import" on page 296 "Stop Disk Group Blink"...
Page 134: Iscsi Commands
"Set Host Port" on page 236 "Set iSCSI Initiator" on page 237 "Set iSCSI Target Properties" on page 238 "Show Host Ports" on page 272 iSCSI Commands "Create iSCSI Initiator" on page 162 "Delete iSCSI Initiator" on page 189 "Reset Storage Array iSCSI Baseline" on page 216 "Save Storage Array iSCSI Statistics"...
Page 135: Raid Controller Module Commands
"Set Physical Disk Channel Status" on page 239 "Set Physical Disk State" on page 241 "Show Physical Disk" on page 272 "Show Physical Disk Channel Statistics" on page 275 "Show Physical Disk Download Progress" on page 276 "Start Physical Disk Blink" on page 298 "Start Physical Disk Initialize"...
Page 136: Remote Replication Commands
"Show RAID Controller Module NVSRAM" on page 278 "Start Physical Disk Channel Blink" on page 298 "Start Physical Disk Channel Fault Isolation Diagnostics" on page 299 "Stop Physical Disk Channel Blink" on page 305 "Stop Physical Disk Channel Fault Isolation Diagnostics" on page 305 Remote Replication Commands "Activate Remote Replication Feature"...
Page 137: Snapshot Commands
Snapshot Commands "Create Snapshot Virtual Disk" on page 175 "Re-create Snapshot" on page 206 "Set Snapshot Virtual Disk" on page 250 "Stop Snapshot" on page 306 Storage Array Commands "Activate Storage Array Firmware" on page 144 "Autoconfigure Storage Array" on page 144 "Autoconfigure Storage Array Hot Spares"...
Page 138 "Save Storage Array SAS PHY Counts" on page 225 "Save Storage Array State Capture" on page 226 "Save Storage Array Support Data" on page 226 "Set Storage Array" on page 251 "Set Storage Array Enclosure Positions" on page 256 "Set Storage Array ICMP Response" on page 257 "Set Storage Array iSNS Server IPv4 Address"...
Page 139: Virtual Disk Commands
Virtual Disk Commands "Check Virtual Disk Consistency" on page 148 "Clear Virtual Disk Reservations" on page 152 "Clear Virtual Disk Unreadable Sectors" on page 153 "Create RAID Virtual Disk (Automatic Physical Disk Select)" on page 162 "Create RAID Virtual Disk (Free Capacity Base Select)" on page 166 "Create RAID Virtual Disk (Manual Physical Disk Select)"...
Page 140: Commands Listed Alphabetically
Commands Listed Alphabetically Following are the script commands listed alphabetically. Activate Remote Replication Feature NOTE: This command valid only with Fibre Channel storage arrays. This command creates the replication repository virtual disk and activates the Remote Replication premium feature. When using this command, the replication repository virtual disk can be defined in one of three ways: •...
Page 141 User-Defined Number of Physical Disks activate storageArray feature=remoteReplication repositoryRAIDLevel=(1 | 5 | 6) repositoryPhysicalDiskCount=numberOfPhysicalDisks repositoryDiskGroupUserLabel=[diskGroupName] physicalDiskMediaType=(HDD | SSD | unknown | allMedia) physicalDiskType=(SAS) [enclosureLossProtect=(TRUE | FALSE)] Parameters Parameter Description The RAID level for the replication repositoryRAIDLevel repository virtual disk. Valid values are 1, 5, or 6.
Page 142 The name of the replication repository repositoryDiskGroup disk group where the replication repository virtual disk is located. (To determine the names of the disk groups in your storage array, run the show storageArray profile command.) The type of physical disk media that you physicalDiskMediaType want to use for the replication repository disk group.
Page 143 The index number of the free space in an freeCapacityArea existing disk group that you want to use to create the replication repository virtual disk. Free capacity is defined as the free capacity between existing virtual disks in a disk group. For example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity.
Page 144: Activate Storagearray Firmware
When you assign the physical disks, if you set the enclosureLossProtect parameter to TRUE and have selected more than one physical disk from any one enclosure, the storage array returns an error. If you set the enclosureLossProtect parameter to FALSE, the storage array performs operations, but the disk group that you create might not have enclosure loss protection.
Page 145 single parameter or all of the parameters to meet your configuration requirements. After entering the autoConfigure storageArray command, the RAID controller modules set up the storage array using either the default parameters or those you selected. Syntax autoConfigure storageArray physicalDiskType=(SAS) raidLevel=(0 | 1 | 5 | 6) diskGroupWidth=numberOfPhysicalDisks diskGroupCount=numberOfDiskGroups...
Page 146 Parameter Description hotSpareCount Number of hot spares in the storage array. Use integer values. For information about hot spares, see "Assigning Global Hot Spares" on page 61 segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk.
Page 147: Autoconfigure Storagearray Hotspares
Autoconfigure Storage Array Hot Spares This command automatically defines and configures the hot spares in a storage array. You can run this command at any time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters None.
Page 148: Check Virtual Disk Consistency
The time interval within which the software can return the timeout remote replication virtual disk status. The timeout value is in minutes. NOTE: This command waits until the status becomes Optimal or the timeout interval expires. Use this command when you run the Asynchronous Remote Replication utility.
Page 149: Clear Physical Disk Port Statistics
Parameter Description Specifies the priority that the consistency check priority has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. The starting logical block address. Use integer startingLBA values. The ending logical block address. Use integer endingLBA values.
Page 150: Clear Storagearray Configuration
Clear Storage Array Configuration Use this command to: • Clear the entire storage array configuration, and return it back to the initial installation state. • Clear the configuration except for security information and identification information. • Clear disk group configuration information and virtual disk configuration information only.
Page 151: Clear Storagearray Eventlog
Clear Storage Array Event Log This command clears the Major Event Log (MEL) for the storage array by deleting the data in the MEL buffer. CAUTION: As soon as you run this command, the existing MEL in the storage array is deleted. Syntax clear storageArray eventLog Parameters...
Page 152: Clear Virtual Disk Reservations
Clear Virtual Disk Reservations This command clears persist e nt vi r t ual disk reservations. Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) reservations Parameters Parameter Description Clears reservations on all virtual disks in allVirtualDisks the storage array. Name of the specific virtual disk for which virtualDisk virtualDisks...
Page 153: Clear Virtual Disk Unreadable Sectors
Clear Virtual Disk Unreadable Sectors This command clears the unreadable sector information from one or more virtual disks. Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) unreadableSectors Parameters Parameter Description Clears unreadable sector information from all of the allVirtualDisks virtual disks in the storage array.
Page 154: Create Diskgroup
Create Disk Group This command creates either a free-capacity disk group or a disk group with one virtual disk when you enter a set of assigned physical disks. Syntax create diskGroup physicalDisks=(enclosureID1,slotID1 enclosureID2,slotID2... enclosureIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6) userLabel=”diskGroupName”...
Page 155 Parameter Description The type of physical disk media that you want to use driveMediaType for the disk group. Valid physical disk media consists • HDD — Use this option when you have hard physical disks in the expansion enclosure. • SSD — Use this option when you have solid state physical disks in the expansion enclosure.
Page 156 Parameter Description The setting to turn on or turn off cache read cacheReadPrefetch prefetch. To turn off cache read prefetch, set this parameter to FALSE. To turn on cache read prefetch, set this parameter to TRUE. The amount of data (in KB) that the RAID segmentSize controller module writes on a single physical disk in a virtual disk before writing data on the next...
Page 157 disks into cache. This action increases the chance that a future request for data can be fulfilled from cache. Cache read prefetch is important for multimedia applications that use sequential data transfers. The configuration settings for the storage array that you use determine the number of additional data blocks that the RAID controller module reads into cache.
Page 158 Security Type The securityType parameter is valid for physical disks that are capable of self- encrypting disk (SED). With SED, the RAID controller module firmware can create a key and activate the physical disk security feature. The physical disk security feature encrypts data as the data is written to the physical disk and decrypts the data as the data is read from the physical disk.
Page 159: Create Host
Create Host 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 in the default group. Syntax create host userLabel=”hostName” [hostGroup=(“hostGroupName” | defaultGroup)] [hostType=(hostTypeIndexLabel | hostTypeIndexNumber)] Parameters Parameter...
Page 160: Create Host Group
Create Host Group This command creates a new host group. Syntax create hostGroup userLabel="hostGroupName" Parameter Parameter Description Name to give the host group that you are userLabel creating. You must put quotation marks (" ") around the host group name. Create Host Port This command creates a new HBA host port identification.
Page 161 Parameter Description Name of the host for which you are host defining an HBA host port. You must put quotation marks (" ") around the host name. NOTE: An HBA host port is a physical connection on a host adapter that resides within a host system.
Page 162: Create Iscsi Initiator
Create iSCSI Initiator This command creates a new iSCSI initiator object. Syntax create iscsiInitiator iscsiName = "iSCSI-ID" userLabel = "name" host = "host-name" [chapSecret = securityKey] Parameters Parameter Description The default identifier of the iSCSI initiator. iscsiName The name that you want to use for the iSCSI initiator. Enclose userLabel the name in double quotation marks ("...
Page 163 capacity=virtualDiskCapacity owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia) enclosureLossProtect=(TRUE | FALSE) dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description Number of unassigned physical disks to physicalDiskCount use in the disk group. NOTE: physicalDiskCount parameter enables you to choose the number of...
Page 164 Parameter Description The size of the virtual disk that you are capacity adding to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB. NOTE: A space must be added between the last digit and the size (bytes, KB, MB, or GB) for values greater than 9.
Page 165 Parameter Description Specifies that enclosure loss protection is enclosureLossProtect enforced when creating the disk group. To enforce enclosure loss protection, set this parameter to TRUE. The default setting is FALSE. For information about the enclosureLossProtect parameter, see "Enclosure Loss Protection" on page 54. The setting to make sure that reserve dssPreAllocate capacity is allocated for future segment...
Page 166: Create Raid Virtual Disk (Free Capacity Base Select)
Create RAID Virtual Disk (Free Capacity Base Select) This command creates a virtual disk in the free space of a disk group. Syntax create virtualDisk diskGroup=[diskGroupName] userLabel=”virtualDiskName” [freeCapacityArea=freeCapacityIndexNumber capacity=virtualDiskCapacity owner=(0 | 1)cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia)] [dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters...
Page 167 Parameter Description Index number of the free space in an freeCapacityArea existing disk group to use to create the new virtual disk. Free capacity is defined as the free capacity between existing virtual disks in a disk group. For example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity.
Page 168 Parameter Description The setting to turn on or turn off cache cacheReadPrefetch read prefetch. To turn on cache read prefetch, set this parameter to TRUE. To turn off cache read prefetch, set this parameter to FALSE. Amount of data (in kilobytes) that the segmentSize RAID controller module writes on a single physical disk in a virtual disk before...
Page 169: Create Raid Virtual Disk (Manual Physical Disk Select)
Create RAID Virtual Disk (Manual Physical Disk Select) This command creates a new disk group and virtual disk, and enables you to specify the physical disks for the virtual disk. NOTE: You cannot use mixed physical disk types in the same disk group and virtual disk.
Page 170 Parameter Description RAID level of the disk group that contains the virtual raidLevel disk. Valid values are 0, 1, 5, or 6. NOTE: raidLevel If you set the parameter to RAID 1, the RAID controller module firmware takes the list of physical disks and pairs them using the following algorithm: Data physical disk =...
Page 171 Parameter Description RAID controller module that owns the virtual disk. owner Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure.
Page 172 Parameter Description The setting to make sure that reserve capacity is dssPreAllocate allocated for future segment size increases. The default value is TRUE. The setting to specify the security level when creating securityType the disk groups and all associated virtual disks. •...
Page 173: Create Remote Replication
Create Remote Replication NOTE: This command valid only with Fibre Channel storage arrays. This command creates both the primary virtual disk and the secondary virtual disk for a remote replication pair. This command also sets the write mode (Synchronous or Asynchronous) and the synchronization priority. Syntax create remoteReplication primary= ”primaryVirtualDiskName”...
Page 174 The password for the remote storage array. Use this remotePassword parameter when the remote storage array is password protected. Enclose the password in double quotation marks (“ ”). The priority that full synchronization has relative to syncPriority host I/O activity. Valid values are highest, high, medium, low, or lowest.
Page 175: Create Snapshotvirtualdisk
Passwords are stored on each storage array in a management domain. If a password was not previously set, a password is not needed. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (A storage array password can be defined by using the set storageArray command.) Synchronization priority defines the amount of system resources that are used to synchronize the data between the primary virtual disk and the secondary...
Page 176 repositoryPhysicalDisks=(enclosureID1,slotID1 enclosureID2,slotID2... enclosureIDn,slotIDn)) [repositoryDiskGroupUserLabel= ”repositoryDiskGroupName” enclosureLossProtect=(TRUE | FALSE) freeCapacityArea=freeCapacityIndexNumber userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName” repositoryFullPolicy=(failSourceWrites | failSnapshot)] Syntax (User-Defined Number of Physical Disks) create snapshotVirtualDisk sourceVirtualDisk=”sourceVirtualDiskName” repositoryRAIDLevel=(1 | 5 | 6) repositoryDriveCount=numberOfPhysicalDisks [repositoryDiskGroupUserLabel= ”repositoryDiskGroupName” driveMediaType=(HDD | SSD | unknown | allMedia)] physicalDiskType=(SAS) enclosureLossProtect=(TRUE | FALSE) userLabel=”snapshotVirtualDiskName”...
Page 177 physicalDiskMediaType=(HDD | SSD | unknown | allMedia)] physicalDiskType=(SAS) enclosureLossProtect=(TRUE | FALSE) userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName” repositoryFullPolicy=(failSourceWrites | failSnapshot)] Syntax (Existing Repository Disk Group) create snapshotVirtualDisk sourceVirtualDisk=”sourceVirtualDiskName” [repositoryDiskGroup=”repositoryDiskGroupName” repositoryUserLabel=”repositoryName” freeCapacityArea=freeCapacityIndexNumber userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryFullPolicy=(failSourceWrites | failSnapshot)] Script Commands...
Page 178 Parameters Parameter Description Name of the source virtual disk from sourceVirtualDisk which to take a snapshot. You must put quotation marks (" ") around the source virtual disk name. RAID level for the repository virtual disk. repositoryRAIDLevel Valid values are 0, 1, 5, or 6. Specifies the physical disks to assign to repositoryPhysicalDisks the repository.
Page 179 Parameter Description The type of physical disk media that you driveMediaType want to use for the disk group. Valid physical disk media consists of: • HDD — Use this option when you have hard physical disks in the expansion enclosure. •...
Page 180 Parameter Description The index number of the free space in an freeCapacityArea existing disk group to use to create the snapshot repository virtual disk. Free capacity is defined as the free capacity between existing virtual disks in a disk group. For example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity.
Page 181: Create Storagearray Securitykey
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. NOTE: One technique for naming the snapshot virtual disk and the repository virtual disk is to add a hyphenated suffix to the original name of the source virtual...
Page 182 Parameters Parameter Description A character string that you can read that is a keyIdentifier wrapper around a security key. A character string that encrypts the security key passPhrase so that you can store the security key in an external file. The file path and the file name to which you file want to save the security key.
Page 183: Create Virtual Disk Copy
– Punctuation – Symbols • You can leave out this parameter. 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.
Page 184 Syntax create virtualDiskCopy source=”sourceName” target=”targetName” [copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] Parameters Parameter Description Name of an existing virtual disk to use as source the source virtual disk. You must put quotation marks (" ") around the source virtual disk name.
Page 185: Deactivate Remote Replication
Parameter Description Specifies the priority that a virtual disk copyPriority copy has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. NOTE: CopyPriority defines the amount of system resources used to copy the data between the source virtual disk and target virtual disk of a virtual disk-copy pair.
Page 186: Delete Disk Group
Delete Disk Group This command deletes an entire disk group and its associated virtual disks. CAUTION: All data in the disk group is lost as soon as you run this command. Syntax delete diskGroup [diskGroupNumber] Parameter Parameter Description Number of the disk group to delete. You diskGroup must put brackets ([ ]) around the disk group number.
Page 187 Syntax delete hostGroup [hostGroupName] Parameter Parameter Description Name of the host group to delete. You hostGroup must put brackets ([ ]) around the host group name. If the name of the host group has special characters, you must also put quotation marks (" ") around the host group name.
Page 188: Delete Host Port
Delete Host Port This command deletes an HBA host port identification. The identification is a software value that represents the physical HBA host port to the RAID controller module. By deleting the identification, the RAID controller module no longer recognizes instructions and data from the HBA host port. Syntax delete hostPort [hostPortName] Parameter...
Page 189: Delete Iscsi Initiator
Delete iSCSI Initiator This command deletes a specific iSCSI initiator object. Syntax delete iscsiInitiator (["iSCSI-ID "| "name"]) Parameters Parameters Description The identifier of the iSCSI initiator that you want to delete. Enclose iSCSI-ID the name in double quotation marks (" "). The name of the iSCSI initiator that you want to delete.
Page 190: Diagnose Raid Controller Module
Parameters Parameter Description Deletes all virtual disks in a storage array. allVirtualDisks NOTE: allVirtualDisks Using the parameter deletes virtual disks until all are removed or until an error is encountered. If an error is encountered, this command does not attempt to delete the remaining virtual disks.
Page 191 Syntax diagnose controller [(0 | 1)] loopbackPhysicalDiskChannel=(allchannels | (1 | testID=(1 | 2 | 3) [patternFile=”filename”] Parameters Parameter Description RAID controller module on which to run controller the diagnostic tests. Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure.
Page 192 Parameter Description Identifier for the diagnostic test to run. testID The identifier and corresponding tests are: 1 — Reads the test 2 — Write test 3 — Data loop-back test NOTE: When you run a data loop-back test, you can optionally specify a file that contains a data pattern.
Page 193: Diagnose Remotereplication
Diagnose Remote Replication NOTE: This command valid only with Fibre Channel storage arrays. This command tests the connection between the specified primary virtual disks and the replication virtual disks on a storage array with the Remote Replication premium feature enabled. Syntax diagnose remoteReplication (primary [primaryVirtualDiskName] |...
Page 194: Download Enclosure Management Module Firmware
remoteReplication32 | remoteReplication64 | remoteReplication128 | virtualDiskCopy | goldKey | mixedPhysicalDiskTypes | highPerformanceTier | SSDSupport] Parameters None. Additional Information If you specify the remoteReplication parameter, this command disables the Remote Replication premium feature and takes away the structure of the replication repository virtual disk.
Page 195: Download Physical Disk Firmware
Parameters Parameter Description Identifies the enclosure to which to load enclosure new firmware. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. You can use the following parameters: allEnclosures • The parameter, which downloads new firmware to all of the EMMs in the storage array...
Page 196 3 Do not make any configuration changes to the storage array while downloading the physical disk firmware. Attempting to make a configuration change can cause the firmware download to fail and make the selected physical disks unusable. You can use this command to test the firmware on one physical disk before installing the firmware on all of the physical disks in a storage array.
Page 197: Download Storage Array Firmware/Nvsram
Download Storage Array Firmware/NVSRAM 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 [, NVSRAM ] file="filename"...
Page 198: Download Storage Array Physical Disk Firmware
Parameter Description Specifies that you are loading firmware downgrade that is a previous version. The default value is FALSE. Set downgrade to TRUE if you want to download an earlier version of firmware. Activates the firmware and NVSRAM activateNow images. The default value is TRUE. If you set activateNow to FALSE, you must use the activate storageArray firmware command to activate the firmware and...
Page 199: Download Storage Array Nvsram
You can schedule downloads for multiple physical disks at the same time, including multiple physical disks in a redundant disk group. Each firmware image file contains information about the physical disk types on which the firmware image runs. The specified firmware images can be downloaded only to a compatible physical disk.
Page 200 Syntax enable diskGroup [diskGroupName] security Parameter Parameter Description The alphanumeric identifier (including - diskGroup and _) of the disk group that you want to place in the Security Enabled state. Enclose the disk group identifier in square brackets ([ ]). Additional Information To successfully run this command, the following conditions must be met: All physical disks in the disk group must be self-encrypting disk (SED)
Page 201: Enable Raid Controller Module Data Transfer
Enable RAID Controller Module Data Transfer This command revives a RAID controller module that quiesces while running diagnostics. Syntax enable controller [(0 | 1)] dataTransfer Parameter Parameter Description RAID controller module that you want to controller revive. Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module on the left and 1 is the RAID controller module on the right...
Page 202: Recopy Virtual Disk Copy
Additional Information A feature pack is a predefined set of premium features, such as Storage Partitioning and Remote Replication. These premium features are combined for the convenience of the users. A premium feature is an additional application to enhance the capabilities of a storage array.
Page 203 Parameters Parameter Description Name of the target virtual disk for which to target reinitiate a virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the target virtual disk name.
Page 204: Re-Create Remote Replication Repository Virtual Disk
Re-create Remote Replication Repository Virtual Disk NOTE: This command valid only with Fibre Channel storage arrays. This command creates a new Remote Replication repository virtual disk (also called a replication repository virtual disk) by using the parameters defined for a previous replication repository virtual disk. The underlying requirement is that you have previously created a replication repository virtual disk.
Page 205 Parameters Parameter Description The RAID level for the replication repositoryRAIDLevel repository virtual disk. Valid values are 1, 5, or 6. The physical disks for the replication repositoryPhysicalDisks repository virtual disk. Specify the enclosure ID and slot ID for each physical disk that you assign to the replication repository virtual disk.
Page 206: Re-Create Snapshot
Notes If a value is entered for the repository storage space that is too small for the replication repository virtual disks, the RAID controller module firmware returns an error message that indicates the amount of space needed for the replication repository virtual disks. The command does not try to change the replication repository virtual disk.
Page 207 Syntax recreate snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) [userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryFullPolicy (failSourceWrites | failSnapshot)] Parameters Parameter Description Name of the specific virtual disk for which to start a virtualDisk or fresh copy-on-write operation. You can enter more virtualDisks than one virtual disk name.
Page 208 Additional Information 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. You can recreate a single Snapshot virtual disk or multiple Snapshot virtual disks with optional parameters: •...
Page 209: Remove Remotereplication
NOTE: If no optional parameters are specified, the recreate snapshot command processes the specified snapshot virtual disks as a batch, provided a validation check of all of the virtual disks runs successfully. If successful, the snapshots start the re-creation process and all of the affected virtual disks (snapshot, source, and repository) are quiesced until the process is complete.
Page 210: Remove Virtual Disk Copy
Parameter Description localVirtualDisk The name of the primary virtual disk (the virtual disk on the local storage array) that you want to remove. You can enter more than one virtual disk name. Enclose the virtual localVirtualDisks 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 ("...
Page 211: Remove Virtual Disk Lun Mapping
Remove Virtual Disk LUN Mapping This command removes the logical unit number (LUN) mapping. Syntax remove (allVirtualDisks | virtualDisk ["virtualDiskName"] | virtualDisks ["virtualDiskName1" ... "virtualDiskNamen"] | accessVirtualDisk) lunMapping (host="hostName" | hostGroup= "hostGroupName") Parameters Parameter Description Removes the LUN mapping from all virtual disks. allVirtualDisks Name of the specific virtual disk to remove from the virtualDisk or...
Page 212: Repair Virtual Disk Consistency
NOTE: host hostGroup You must use the parameters when specifying a host nonaccess virtual disk or an access virtual disk. The script engine ignores the hostGroup allVirtualDisks virtualDisks parameters when you use the parameters. Repair Virtual Disk Consistency This command repairs the consistency errors on a virtual disk. Syntax repair virtualDisk [virtualDiskName] consistency consistencyErrorFile="filename"...
Page 213: Replace Physicaldisk
Replace Physical Disk This command redefines the composition of a disk group by replacing a physical disk that is in the disk group with either: • An unassigned physical disk • A fully integrated hot spare physical disk Syntax replace physicalDisk ([enclosureID,slotID] | ) replacementPhysicalDisk=enclosureID,slotID Parameters...
Page 214: Reset Raid Controller Module
Reset RAID Controller Module This command resets a RAID controller module. NOTE: When you reset a RAID controller module, the RAID controller module is not available for I/O operations until the reset is complete. If a host is using virtual disks owned by the RAID controller module being reset, the I/O directed to the RAID controller module is rejected.
Page 215: Reset Storage Array Battery Install Date
Reset Storage Array Battery Install Date This command resets the age of the batteries in a storage array to zero days. You can reset the batteries for an entire storage array or just the battery for a specific RAID controller module or in a specific battery pack. Syntax reset storageArray batteryInstallDate controller= (0 | 1)
Page 216: Reset Storage Array Iscsi Baseline
Reset Storage Array iSCSI Baseline This command resets the iSCSI baseline for the storage array to 0. Syntax reset storageArray iscsiStatsBaseline Parameters None. NOTE: This command resets the baseline to 0 for both RAID controller modules in the storage array. The purpose of resetting both of the RAID controller module baselines is to help ensure that the counts are synchronized between the RAID controller modules.
Page 217: Reset Storagearray Virtualdiskdistribution
Reset Storage Array Virtual Disk Distribution 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 use this command, or the virtual disk is not accessible. NOTE: Under certain host operating system environments, you might be required to reconfigure the multipath host physical disk.
Page 218: Revive Disk Group
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-consistency group, set this parameter to . For the virtual disks to be separate, TRUE set this parameter to FALSE.
Page 219: Revive Physical Disk
Revive Physical Disk This command forces the specified physical disk to the optimal state. CAUTION: Correct use of this command depends on the data configuration on all physical disks in the disk group. Never attempt to revive a physical disk unless supervised by a Technical Support representative.
Page 220: Save Physical Disk Channel Fault Isolation Diagnostic Status
Save Physical Disk Channel Fault Isolation Diagnostic Status This command saves the physical disk channel fault isolation diagnostic data that is returned from the start physical disk channel fault isolation diagnostics command. You can save the diagnostic data to a file as standard text or as XML.
Page 221: Save Physical Disk Log
Save Physical Disk Log This command saves the log sense data to a file. Log sense data is maintained by the storage array for each physical disk. Syntax save allPhysicalDisks logFile="filename" Parameter Parameter Description Name of the file to which to write the log sense data. You logFile must put quotation marks ("...
Page 222: Save Storage Array Configuration
Save Storage Array Configuration This command creates a script file that you can use to create the current storage array virtual disk configuration. Syntax save storageArray configuration file="filename" [(allConfig | globalSettings=(TRUE | FALSE) virtualDiskConfigAndSettings=(TRUE | FALSE) hostTopology=(TRUE | FALSE) lunMappings=(TRUE | FALSE))] Parameters Parameter Description...
Page 223: Save Storage Array Events
Parameter Description Saves the LUN mapping to the file. To save the LUN lunMappings mapping, set this parameter to TRUE. To prevent saving the LUN mapping, set this parameter to FALSE. The default value is FALSE. NOTE: When you use this command, you can specify any combination of the parameters for global setting, virtual disk configuration setting, host topology, or allConfig LUN mapping.
Page 224: Save Storage Array Iscsi Statistics
Save Storage Array iSCSI Statistics This command saves the iSCSI performance of the storage array to a file. The following statistics are saved to the file: • Statistics related to the physical Ethernet port • Statistics related to the TCP protocol •...
Page 225: Save Storage Array Performance Statistics
Save Storage Array Performance Statistics This command saves the performance statistics to a file. Before you use this command, issue the set session performanceMonitorInterval and set session performanceMonitorIterations commands to specify how often statistics are collected. Syntax save storageArray performanceStats file="filename" Parameter Parameter Description...
Page 226: Save Storage Array State Capture
Save Storage Array State Capture This command saves the state capture to a file. Syntax save storageArray stateCapture file="filename" Parameter Parameter Description Name of the file to which to save the state capture. You file must put quotation marks (" ") around the file name. Save Storage Array Support Data This command saves the storage array support-related information to a file.
Page 227: Set Disk Group
Parameter Parameter Description Name of the file to which to save the storage array file support-related data. You must put quotation marks (" ") around the file name. Set Disk Group This command defines the properties for a disk group. Syntax set diskGroup [diskGroupName] addPhysicalDisks=(enclosureID1,slotID1...
Page 228: Set Disk Group Forced State
NOTE: For configurations with more than 32 virtual disks, it is recommended you quiesce host I/O operations when executing this command. Set Disk Group Forced State This command moves a disk group into a Forced state. Use this command if the start diskGroup import command does not move the disk group to an Imported state or if the import operation does not work because of hardware errors.
Page 229: Set Enclosure Attribute
Set Enclosure Attribute This command sets user-defined attributes for an enclosure. Syntax set enclosure [enclosureID] (chassisName | assetTag)= "userID" Parameters Script Commands...
Page 230: Set Enclosure Identification
Parameter Description enclosureID Identifies a specific enclosure for which to set the attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. chassisName Chassis name or number to give the new enclosure. Chassis names can be any combination of alphanumeric characters with a maximum length of 32 characters.
Page 231: Set Foreign Physical Disk To Native
Set Foreign Physical Disk to Native A physical disk is considered to be native when it is a part of a storage array disk group. A physical disk is considered to be foreign when it does not belong to a storage array disk group or when it fails to be imported with the physical disks of a disk group that are transferred to a new storage array.
Page 232: Set Host
Set Host 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 does not have individual mappings.
Page 233 Host Group Parameter Host Has Individual Virtual Host Does Not Have Individual Disk-to-LUN Mappings Virtual Disk-to-LUN Mappings hostGroupName The host is removed from The host is removed from the the present host group and is present host group and is placed under the new host placed under the new host group defined by...
Page 234: Set Host Channel
Set Host Channel This command defines the loop ID for the host channel. Syntax set hostChannel [hostChannelNumber] preferredID=portID Parameters Parameter Description The identifier number of the host channel for hostChannel which you want to set the loop ID. The host channel identifier number is constructed by combining the controller number and the host channel number.
Page 235: Set Host Group
Set Host Group This command renames a host group. Syntax set hostGroup [hostGroupName] userLabel="newHostGroupName" Parameters Parameter Description Name of the host group to rename. You must put hostGroup brackets ([ ]) around the host group name. If the host group name has special characters, you must also put quotation marks ("...
Page 236: Set Host Port
Set Host Port This command changes the host type for an HBA host port. You can also change an HBA host port label with this command. Syntax set hostPort [portLabel] host=“hostName” userLabel=“newPortLabel” Parameters Parameter Description The name of the HBA host port for which you want to change the hostPort host type, or for which you want to create a new name.
Page 237: Set Iscsiinitiator
Set iSCSI Initiator This command sets the attributes for an iSCSI initiator. Syntax set iscsiInitiator ([“iscsiID“]| userLabel=”newName” | host=”newHostName” | chapSecret=”newSecurityKey”) Parameters Parameter Description The name of the iSCSI initiator for which you want to set attributes. iscsiID The new name that you want to use for the iSCSI initiator. userLabel The name of the new host to which the HBA host port is connected.
Page 238: Set Iscsi Target Properties
Set iSCSI Target Properties This command defines properties for an iSCSI target. Syntax set iscsiTarget [“iscsiID”] (authenticationMethod=(none | chap) | chapSecret=”securityKey” | targetAlias=”userLabel”) Parameters Parameter Description The iSCSI target for which you want to iSCSIID set properties. Enclose the name in double quotation marks (“...
Page 239: Set Physical Disk Channel Status
Set Physical Disk Channel Status This command defines how the physical disk channel performs. Syntax set physicalDiskChannel [(1 | 2 )] status=(optimal | degraded) 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.
Page 240: Set Physical Disk Hot Spare
Set Physical Disk Hot Spare This command assigns or unassigns one or more physical disks as a hot spare. Syntax set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID1,slotID1 enclosureID2, slotID2 ... enclosureIDn,slotIDn]) hotSpare=(TRUE | FALSE) Parameters Parameter Description The enclosure and the slot where the physical physicalDisk or disk resides.
Page 241: Set Physical Disk State
Set Physical Disk State This command sets a physical disk to the Failed state. (To return a physical disk to the optimal state, use the revive physicalDisk command.) Syntax set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID1,slotID1 enclosureID2, slotID2 ... enclosureIDn,slotIDn]) operationalState=failed Parameter Parameter Description...
Page 242 iscsiHostPortOptions rloginEnabled=(TRUE | FALSE) | serviceAllowedIndicator=(on | off) Parameters Parameter Description The RAID controller module for which you want to controller define properties. Valid identifiers for the RAID controller module are 0 or 1, where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1.
Page 243 Parameter Description The IP address of IPv6 router that connects two or IPv6RouterAddress more logical subnets. The address format for the IPv6 router is (0–FFFF):(0–FFFF):(0–FFFF):(0– FFFF): (0–FFFF):(0–FFFF):(0–FFFF):(0– FFFF). The values that support this parameter are listed in iscsiHostPort the Syntax Element Statement Data table that follows.
Page 244 Syntax Element Statement Data Options for the Ethernet Port Parameter enableIPv4=(TRUE | FALSE) | enableIPv6=(TRUE | FALSE) | IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0- FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) | IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0- FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0- FFFF) | IPv4Address=(0-255).(0-255).(0-255).(0-255) | IPv4ConfigurationMethod=[(static | dhcp)] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) duplexMode=(TRUE | FALSE) | portSpeed=[(autoNegotiate | 10 | 100 | 1000)] IPv4Address=(0-255).(0-255).(0-255).(0-255) | IPv6LocalAddress=(0-FFFF):(0-FFFF):(0- FFFF):(0FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-...
Page 245 Options for the Ethernet Port Parameter IPv6Priority=[0-7] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) IPv4VlanId=[1-4094] | IPv6VlanId=[1-4094] | maxFramePayload=[frameSize] | tcpListeningPort=[3260, 49152-65536] | portSpeed=[(autoNegotiate | 100 | 1000)] Additional Information When you use this command, you can specify one or more of the parameters. You do not need to use all of the parameters. Setting the availability parameter to serviceMode causes the alternate RAID controller module to take ownership of all of the virtual disks.
Page 246: Set Remotereplication
The portSpeed option is expressed as megabits per second (Mb/s). The following values are the default values for the iscsiHostOptions: • The IPv6HopLimit option is 64. • The IPv6NdReachableTime option is 30000 milliseconds. • The IPv6NdRetransmitTime option is 1000 milliseconds. •...
Page 247 Parameters Parameter Description The name of the primary virtual disk for which you want localVirtualDisk to define properties. You can enter more than one primary virtual disk name. Enclose the primary virtual localVirtualDisks disk name in square brackets ([ ]). If the primary virtual disk name has special characters, enclose the primary virtual disk name in double quotation marks (“...
Page 248 writeOrder This parameter defines write order for data transmission between the primary virtual disk and the secondary virtual disk. Valid values are preserved notPreserved This parameter defines how the primary virtual disk writeMode writes to the secondary virtual disk. Valid values are synchronous asynchronous Notes...
Page 249: Set Session
Set Session This command defines how you want the current script engine session to run. Syntax set session errorAction=(stop | continue) password=”storageArrayPassword” performanceMonitorInterval=intervalValue performanceMonitorIterations=iterationValue Parameters Parameter Description How the session responds if an error is errorAction encountered during processing. You can choose to stop the session if an error is encountered, or you can continue the session after encountering an error.
Page 250: Set Snapshot Virtual Disk
Additional Information When you use this command, you can specify one or more of the optional parameters. Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of alphanumeric characters with a maximum of 30 characters.
Page 251: Set Storage Array
Parameter Description The percentage of repository capacity at which warningThresholdPerce you receive a warning that the snapshot repository is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 50. How you want snapshot processing to continue if repositoryFullPolicy the snapshot repository virtual disk is full.
Page 252 Parameters Parameter Description The setting for the audible alarm. This parameter alarm has these values: • enable—The audible alarm is turned on and sounds if a fault occurs. • disable—The audible alarm is turned off and does not sound if a fault occurs. •...
Page 253 Parameter Description The default host type of any unconfigured host defaultHostType port to which the RAID controller modules are connected. To generate a list of valid host types for the storage array, run the show storageArray hostTypeTable command. Host types are identified by a name or a numerical index.
Page 254 and state information is returned in the form of an object graph. The object graph contains all relevant logical and physical objects and their associated state information for the storage array. The set storageArray autoSupportConfig command collects configuration and state information in this way: •...
Page 255 Cache Flush Start and Cache Flush Stop When you define values to start a cache flush, a value that is too low increases the chance that data needed for a host read is not in the cache. A low value also increases the number of physical disk writes that are necessary to maintain the cache level, which increases system overhead and decreases performance.
Page 256: Set Storagearray Enclosurepositions
Set Storage Array Enclosure Positions This command defines the position of the enclosures in a storage array. You must include all of the enclosures in the storage array when you enter this command. Syntax set storageArray enclosurePositions=(controller | enclosureID... enclosureIDn) Parameter Parameter Description...
Page 257: Set Storage Array Icmp Response
Set Storage Array ICMP Response This command returns the default values for negotiable settings for sessions and connections, which represent the starting point for the storage array for negotiations. Syntax set storageArray icmpPingResponse=(TRUE | FALSE) Parameter Parameter Description This parameter turns on or turns off Echo Request icmpPingResponse messages.
Page 258: Set Storage Array Isns Server Ipv6 Address
Set Storage Array iSNS Server IPv6 Address This command sets the IPv6 address for the iSNS server. Syntax set storageArray isnsIPv6Address=ipAddress Parameter Parameter Description The IPv6 address that you want to use for the iSNS isnsIPv6Address server. Set Storage Array iSNS Server Listening Port This command sets the iSNS server listening port.
Page 259: Set Storage Array Learn Cycle
Set Storage Array Learn Cycle This command sets the learn cycle for the battery backup unit. The learn cycle enables the MD storage management software to predict the remaining battery life. Learn cycles run at set intervals and store the results for software analysis.
Page 260: Set Storage Array Redundancy Mode
Set Storage Array Redundancy Mode This command sets the redundancy mode of the storage array to either simplex or duplex. Syntax set storageArray redundancyMode=(simplex | duplex) Parameter Parameter Description Use simplex mode when you have a single RAID redundancyMode controller module. Use duplex mode when you have two RAID controller modules Set Storage Array Security Key Use this command to set the security key that is used throughout the storage...
Page 261: Set Storagearray Time
Whenever a security-enabled physical disk is powered on, it requires the correct security key from the RAID controller module before it can read or write data. So, a security-enabled physical disk uses two keys: the physical disk key that encrypts and decrypts the data and the security key that authorizes the encryption and decryption processes.
Page 262: Set Storagearray Unnameddiscoverysession
Set Storage Array Unnamed Discovery Session This command enables the storage array to participate in unnamed discovery sessions. Syntax set storageArray unnamedDiscoverySession=(TRUE | FALSE) Parameter Parameter Description unnamedDiscoverySession This parameter turns on or turns off unnamed discovery sessions. Set the parameter to TRUE to turn on unnamed discovery sessions.
Page 263 virtualDisk ) cacheFlushModifier=cacheFlushModifierValue cacheWithoutBatteryEnabled=(TRUE | FALSE)\ mediaScanEnabled=(TRUE | FALSE) mirrorCacheEnabled=(TRUE | FALSE) modificationPriority=(highest | high | medium | low | lowest) owner=(0 | 1) readCacheEnabled=(TRUE | FALSE) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) CAUTION: Write Cache Enabling on a virtual disk generally improves performance for applications with significant Write content (unless the Write Cache application features a continuous string of Writes.
Page 264 Parameters Parameter Description Specifies the properties for all virtual disks in allVirtualDisks the storage array. Specifies the name of the virtual disk for virtualDisk or which to define properties. You can enter virtualDisks (name) more than one virtual disk name if you use the virtualDisks parameter.
Page 265 Parameter Description The priority for virtual disk modifications modificationPriority while the storage array is operational. Valid values are highest, high, medium, low, or lowest. The RAID controller module that owns the owner virtual disk. Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1.
Page 266 Parameter Description Adds new physical disks to the virtual disk. addPhysicalDisks 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. You must put brackets ([ ]) around the enclosure ID values and the slot ID values.
Page 267 Parameter Description Specifies the logical unit number for the accessVirtualDisk access virtual disk. The logical unit number is the only property that you can set for the access virtual disk. NOTE: accessVirtualDisk If you specify the parameter, the only property that you can set is logicalUnitNumber Defines specific virtual disk-to-LUN mappings logicalUnitNumber...
Page 268: Set Virtual Disk Copy
Set Virtual Disk Copy This command defines the properties for a virtual disk copy pair. Syntax set virtualDiskCopy target [targetName] [source [sourceName]] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE) Parameters Parameter Description Specifies the name of the target virtual disk for which target to define properties.
Page 269: Show Current Iscsi Sessions
Show Current iSCSI Sessions This command displays information about an iSCSI session for either an iSCSI initiator or iSCSI target. 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...
Page 270: Show Disk Group
Show Disk Group This command returns the following information about a disk group: • Status (online or offline) • Physical disk type (SAS) • Enclosure loss protection (yes or no) • Current owner (RAID controller module 0 or RAID controller module 1) •...
Page 271: Show Disk Group Import Dependencies
Parameter Parameter Description Number of the disk group for which to display diskGroup information. You must put brackets ([ ]) around the disk group number. Show Disk Group Import Dependencies This command shows a list of dependencies for the physical disks in a disk group that you want to move from one storage array to a second storage array.
Page 272: Show Host Ports
Show Host Ports For all HBA host ports connected to a storage array, this command returns the following information: • HBA host port identifier • HBA host port name • HBA host type Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example.
Page 273 – Capacity – Data transfer rate – Product ID – Firmware level • Physical disk channel information: – Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long.
Page 274 Parameters Parameter Description Returns information about all physical disks in allPhysicalDisks the storage array. NOTE: To determine information about the type and location of all physical disks in the storage allPhysicalDisks array, use the parameter. retrieve information. Valid physical disk media driveMediaType are these: •...
Page 275: Show Physical Disk Channel Statistics
Show Physical Disk Channel Statistics 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 information about one specific physical disk channel, several physical disk channels, or all physical disk channels.
Page 276: Show Physical Disk Download Progress
Show Physical Disk Download Progress This command returns the status of firmware downloads for the physical disks targeted by the download physicalDisk firmware or download storageArray physicalDiskFirmware commands. Syntax show allPhysicalDisks downloadProgress Parameters None. NOTE: When all firmware downloads have successfully completed, this command Successful returns a status.
Page 277 • Date and time to which the RAID controller module is set • Associated virtual disks (including preferred owner) • Ethernet port • Physical disk interface Syntax show (allControllers | controller [(0 | 1)]) [summary] Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array.
Page 278: Show Raid Controller Module Nvsram
Show RAID Controller Module NVSRAM 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=(hostTypeIndexLabel | host= "hostName")] Parameters...
Page 279: Show Remote Replication Virtual Disk Candidates
Show Remote Replication Virtual Disk Candidates NOTE: This command valid only with Fibre Channel storage arrays. This command returns information about the candidate virtual disks on a remote storage array that can be used as secondary virtual disks in a Remote Replication configuration.
Page 280: Show Remote Replication Virtual Disk Synchronization Progress
Show Remote Replication Virtual Disk Synchronization Progress NOTE: This command valid only with Fibre Channel storage arrays. This command returns the progress of data synchronization between the primary virtual disk and the secondary virtual disk in a Remote Replication configuration. This command shows the progress as a percentage of data synchronization that has been completed.
Page 281 Parameters Parameter Description Displays all properties of the logical and physical profile components that comprise the storage array. The information returned takes several screens to display. NOTE: The profile parameter returns detailed information about the storage array. The information covers several screens on a display. You might need to increase the size of your display buffer to see all the information.
Page 282: Show Storage Array Auto Configure
Parameter Description Displays the health, logical properties, and healthStatus physical component properties of the storage array. Displays a table of all host types known to the hostTypeTable RAID controller module. Each row in the table displays a host type index and the platform the index represents.
Page 283 Syntax show storageArray autoConfiguration [physicalDiskType=(SAS) raidLevel=(0 | 1 | 5 | 6) diskGroupWidth=numberOfPhysicalDisks diskGroupCount=numberOfDiskGroups virtualDisksPerGroupCount= numberOfVirtualDisksPerGroup hotSpareCount=numberOfHotspares segmentSize=segmentSizeValue cacheReadPrefetch=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description Type of physical disk to use for the storage array. Valid physicalDiskType physical disk type is SAS.
Page 284: Show Storagearray Hosttopology
Parameter Description Amount of data (in kilobytes) that the RAID controller segmentSize module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure Command"...
Page 285: Show Storage Array Lun Mappings
Show Storage Array LUN Mappings This command returns information from the storage array profile about the storage array LUN mappings. If you run this command with no parameters, this command returns all LUN mappings. Syntax show storageArray lunMappings [host ["hostName"] | hostgroup ["hostGroupName"]] Parameters Parameter...
Page 286: Show Storagearray Unconfigurediscsiinitiators
Show Storage Array Unconfigured iSCSI Initiators This command returns a list of initiators that have been detected by the storage array but are not yet configured into the storage array topology. Syntax show storageArray unconfiguredIscsiInitiators Parameters None. Show Storage Array Unreadable Sectors This command returns a table of the addresses of all of the sectors in the storage array that cannot be read.
Page 287: Show String
Show String This command shows a string of text from a script file. This command is similar to the echo command in MS-DOS and UNIX. Syntax show “textString” Parameters None. NOTE: You must enclose the string in double quotation marks (“ ”). Show Virtual Disk For the virtual disks in a storage array, this command returns the following information:...
Page 288 – The write cache without batteries status (enabled or disabled) – The write cache with mirroring status (enabled or disabled) – The flush write cache after time – The cache read prefetch setting (TRUE or FALSE) – The enable background media scan status (enabled or disabled) –...
Page 289: Show Virtual Disk Action Progress
Show Virtual Disk Action Progress For a long-running operation that is currently running on a virtual disk, this command returns information about the virtual disk action and amount of the long-running operation completed. The completed amount of the long- running operation is shown as a percentage (for example, 25 means that 25 percent of the long-running operation is completed).
Page 290: Show Virtualdiskcopy Sourcecandidates
Syntax show virtualDiskCopy (allVirtualDisks | source ["sourceName"] | target ["targetName"]) Parameters Parameter Description allVirtualDisks Returns information about virtual disk copy operations for all virtual disk copy pairs. Name of the source virtual disk about which to retrieve source information. You must put quotation marks (" ") and brackets ([ ]) around the source virtual disk name.
Page 291: Show Virtual Disk Copy Target Candidates
Virtual Disk Name: engineering Capacity: 4.0 GB Disk Group: 2 Show Virtual Disk Copy Target Candidates This command returns information about the candidate virtual disks that you can use as the target for a virtual disk copy operation. Syntax show virtualDiskCopy source ["sourceName"] targetCandidates Parameters Parameter...
Page 292: Show Virtual Disk Reservations
Parameters Parameter Description allvirtualDisks The setting to return performance statistics about all of the virtual disks in the storage array. Name of the source virtual disk for which you are trying to virtualDisk or find a candidate target virtual disk. You must put quotation virtualDisks marks ("...
Page 293: Start Configuration Database Diagnostic
Start Configuration Database Diagnostic This command starts a diagnostic test to validate the configuration database in the controller firmware. Syntax Start storageArray configDbDiagnostic Parameters None. Notes Upon completion of the diagnostic test, the controller firmware returns one of these results: •...
Page 294: Start Disk Group Blink
In addition, the database configuration diagnostic test can be started using the storage management software GUI but cannot be stopped using the storage management software GUI. If you want to stop a running diagnostic test, you must use the stop storageArray configDbDiagnostic command.
Page 295: Start Disk Group Export
Start Disk Group Export This command moves a disk group into an Exported state. Then you can remove the physical disks that comprise the disk group and reinstall the physical disks in a different storage array. NOTE: Within the disk group, you cannot move virtual disks that are associated with the premium features from one storage array to another storage array.
Page 296: Start Disk Group Import
Start Disk Group Import This command moves a disk group into a Complete state to make a newly introduced disk group available to its new storage array. The disk group must be in an Exported state or a Forced state before you run this command. Upon successfully running the command, the disk group is operational.
Page 297: Start Enclosure Blink
Start Enclosure Blink This command identifies an enclosure by turning on the indicator LED. (Use the stop enclosure blink command to turn off the indicator LED for the enclosure.) Syntax start enclosure [enclosureID] blink Parameter Parameter Description Identifies the enclosure to blink. Enclosure ID enclosure values are 0 to 99.
Page 298: Start Physical Disk Blink
Start Physical Disk Blink This command blinks a physical disk by turning on an indicator light on the physical disk. Run the stop physicalDisk blink command to turn off the indicator light on the physical disk. Syntax start physicalDisk [enclosureID,slotID] blink Parameter Parameter Description...
Page 299: Start Physical Disk Channel Fault Isolation Diagnostics
Start Physical Disk Channel Fault Isolation Diagnostics This command runs the physical disk channel fault isolation diagnostics and stores the results. Syntax start physicalDiskChannel [(1 | 2 )] controller [(0 | 1)] faultDiagnostics testDevices=[(all | controller=(0 | 1) | emms=[enclosureID1 (left | right), enclosureID2 (left | right)...
Page 300: Start Physical Disk Initialize
Parameter Description The hexadecimal data pattern you want to use to run patternNumber the test. This number can be any hexadecimal number between 0000 to FFFF. The number of errors that you want to accept before maxErrorCount terminating the test. The number of times that you want to repeat the test.
Page 301: Start Physical Disk Reconstruction
Start Physical Disk Reconstruction This command starts reconstructing a physical disk. Syntax start physicalDisk [enclosureID,slotID] reconstruct Parameters Parameter Description Identifies the enclosure and slot where the physical disk resides. physicalDisk Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value.
Page 302: Start Remote Replication Synchronization
Parameters Parameter Description Identifies the enclosure and slot where the physical disk resides. physicalDisk Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot physicalDisks ID value.
Page 303: Start Storage Array Iscsi Refresh
Start Storage Array iSCSI Refresh This command initiates a refresh of the network address information for the iSNS server. If the DHCP server is marginal or unresponsive, the refresh operation can take from 2 to 3 minutes to complete. NOTE: This command is for IPv4 only.
Page 304: Stop Configuration Database Diagnostic
Stop Configuration Database Diagnostic This command stops the diagnostic test to validate the configuration database in the controller firmware that was started by the start storageArray configDbDiagnostic command. Syntax Stop storageArray configDbDiagnostic Parameters None. NOTE: The controller firmware returns a confirmation that the diagnostic test was cancelled.
Page 305: Stop Physicaldisk Blink
Stop Physical Disk Blink This command turns off the indicator light on the physical disk that was turned on by the start physicalDisk blink command. Syntax stop physicalDisk blink Parameters None. Stop Physical Disk Channel Blink This command turns off the indicator lights on the expansion enclosures that were turned on by the start physicalDiskChannel blink command.
Page 306: Stop Snapshot
Stop Snapshot This command stops a copy-on-write operation. Syntax stop snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) Parameter Parameter Description Name of the virtual disk for which to start the formatting. You virtualDisk must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put virtualDisks quotation marks ("...
Page 307: Stop Storage Array Iscsi Session
Stop Storage Array iSCSI Session This command forces the termination of an iSCSI session Syntax stop storageArray iscsiSession [sessionNumber] Parameter Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]). Stop Storage Array Physical Disk Firmware Download This command stops a firmware download to the physical disks in a storage array that was started with the download storageArray physicalDiskFirmware...
Page 308: Suspend Remote Replication
Parameters Parameter Description Name of the target virtual disk for which to stop a virtual disk copy target operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks ("...
Page 309 This parameter defines whether the virtual disks writeConsistency identified in this command are in a write- consistency group or are separate. For the virtual disks in the same write-consistency group, set this parameter to TRUE. For the virtual disks that are separate, set this parameter to FALSE.
Page 310: Validate Storage Array Security Key
Validate Storage Array Security Key This command validates the security key for a storage array that has self- encrypting disk physical disks to make sure that the security key is not corrupt. Syntax validate storageArray securityKey file="fileName" passPhrase="passPhraseString" Parameters Parameter Description The file path and the file name to which you want to save the file...
Page 311 Script Commands...
Page 312 Script Commands...
Page 313: A Sample Script Files
Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array.
Page 314: Configuration Script Example 1
Configuration Script Example 1 This example creates a new virtual disk using the create virtualDisk command in the free space of a disk group. Show "Create RAID 5 Virtual Disk 7 on existing Disk Group 1"; //Create virtual disk on a disk group created by the create virtual disk command //Note: For disk groups that use all available capacity, the last virtual disk on the disk group...
Page 315 The first line of text is the show string command. This command displays text bounded by quotation marks (" ") on a monitor screen when the script file runs. In this example, the text Create RAID 5 Virtual Disk 7 on existing Disk Group 1 serves as a title describing the expected results of running this script file.
Page 316: Configuration Script Example 2
The set virtualDisk command parameters are shown on separate lines. You do not need to use separate lines for each parameter. You can enter more than one parameter with the set virtualDisk command by leaving a space between the parameters. By using separate lines, however, you can more clearly see what parameters you are setting and the values to which you are setting the parameters.
Page 317 The command in this example, like the create virtualDisk command in the previous example, creates a new virtual disk. The significant difference between these two examples is that this example shows how you can define specific physical disks to include in the virtual disk. To find out what physical disks are available in a storage array, run the show storageArray profile command.
Page 318 Sample Script Files...
Page 319: B Cli Command Updates
CLI Command Updates This chapter reflects new and updated commands that are available for use with Dell's PowerVault Modular Disk Series of storage arrays. NOTE: Not all commands are necessarily valid with all storage arrays - some commands are specific to certain platforms.
Page 320: Updated Commands
Updated Commands The syntax of the following commands has been modified, updated, or enhanced since the last release of this document. Note that not all commands are necessarily valid with all storage arrays - some commands are specific to certain platforms. •...
Page 321: Index
Index commands, 18 usage examples, 29 activate storage array clocks, RAID controller module, firmware, 144 synchronizing, 119 adding comments to a script, 43 collecting physical disk data, 123 assigning global hot spares, 61 command formatting rules, 130 autoconfigure storage array, 144 command line interface, how to autoconfigure storage array hot use, 16...
Page 322 create RAID virtual disk, manual Snapshot Virtual Disk, 76-77 physical disk select, 169 virtual disk, 189 storage array, 46 detailed error reporting, 26 storage partitioning, 91 determining copying Virtual Disk Copy candidates, 81 virtual disk, 83 what is on your storage array, 46 create diagnosing RAID controller disk group, 154...
Page 323 enclosure assigning global hot spares, 61 set physical disk hot spare, 262 commands, 133 enclosure loss protection, 54 how to use the command line interface, 16 enclosure management module firmware download, 194 exit status, 27 initializing physical disk, 126 virtual disk, 127 interaction with other foreign physical disk features, 90...
Page 324 recopy virtual disk, 88, 202 partitioning, storage, 91 recopying virtual disk, 87 performance tuning, 120 recovery operations, 124 persistent reservations, re-creating removing, 118 snapshot virtual disk, 78 physical disk recurring syntax elements, 36 commands, 134 download firmware, 195 redistributing virtual disk, 128 initializing, 126 redundancy check, running, 117 locating, 119...
Page 325 physical disk, 219 foreign physical disk to native, 231 routine maintenance, 115 host group, 235 running physical disk channel status, 239 media scan, 115 physical disk hot spare, 262 redundancy check, 117 virtual disk, 262 Virtual Disk Copy, 268 set controller, 227 set disk group, 227 save set enclosure attribute, 229...
Page 326 193 creating, 68 re-creating, 78 storage partitioning, 91 start support.dell.com, 15 disk group blink, 294 synchronizing RAID controller disk group defragment, 294 module clocks, 119 enclosure blink, 297 syntax elements physical disk initialize, 300...
Page 327 troubleshooting storage array, 123 user-defined parameters, 72 virtual disk check consistency, 148 commands, 139 copying, 83 creating in an existing disk group, 53 creating with software-assigned physical disks, 52 creating with user-assigned physical disks, 50 initializing, 127 recopy, 88 recopy virtual disk, 202 recopying, 87 redistributing, 128 repair consistency, 212...
Page 328 Index...

This manual is also suitable for:

Powervault md3600f

Dell PowerVault MD3620f Command Line Interface Manual

1 About the Command Line Interface

2 About the Script Commands

3 Configuring a Storage Array

4 Using the Snapshot Feature

5 Using the Virtual Disk Copy Feature

6 Using the Remote Replication

7 Maintaining a Storage Array

8 Script Commands

A Sample Script Files

B CLI Command Updates

Index

Quick Links

Related Manuals for Dell PowerVault MD3620f

Summary of Contents for Dell PowerVault MD3620f