Dell™ PowerVault™ Modular Disk Storage Manager CLI Guide w w w. d e l l . c o m | s u p p o r t . d e l l .
Notes and Notices NOTE: A NOTE indicates important information that helps you make better use of your computer. NOTICE: A NOTICE indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. ____________________ Information in this document is subject to change without notice. © 2008 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden.
Contents 1 About the Command Line Interface . . . . 13 . . . . . . . . 14 . . . . . . . . . . . . . . . . . . . . 15 How to Use the Command Line Interface Usage Notes CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 . . . . . . . . . . . . . . . 24 . . . . . . . . . . . . . . . . 24 . . . . . . . . . . . . . . . . . . . . . . . . 25 Command Line Parameters Formatting Considerations Detailed Error Reporting Exit Status Usage Examples . 2 16 . . . . . . . .
3 Configuring a Storage Array Configuring a Storage Array . . . . . . . . . . . 43 . . . . . . . . . . . . . . 44 . . . . 44 . . . . . . . . . . 47 Determining What is on Your Storage Array Saving a Configuration to a File . . . . . . 48 . . . . . . . . 53 . . . . . . . . . . . . . . 55 Using the Create Virtual Disk Command Using the Auto Configure Command Modifying Your Configuration . . . . . . . 56 . . . . . . . . 56 Setting the Storage Array Password .
Changing Snapshot Virtual Disk Settings . . . . . . . . . . . 74 . . . . . . 75 Stopping and Deleting a Snapshot Virtual Disk Re-creating the Snapshot Virtual Disk Preparing Host Servers to Re-create a Snapshot Virtual Disk . . . . . . . . . . . . . . . . . . . . Re-creating a Snapshot Virtual Disk 5 . 75 . . . . . . . . 76 Using the Virtual Disk Copy Feature Creating a Virtual Disk Copy . . . . 77 . . . . . . . . . . . . . . 78 Enabling the Virtual Disk Copy Feature . . . . . .
Maintaining a Storage Array . Routine Maintenance . . . . . . . . . 91 . . . . . . . . . . . . . . . . . . 91 Running a Media Scan . . . . . . . . . . . . . . . Running a Consistency Check . . . . . . . . . . . Resetting a RAID Controller Module . . . . . . . . Enabling RAID Controller Module Data Transfer . . . . . . . . . . . . . . . . . Resetting Battery Age 94 94 . . . . . . . . 94 . . . . . . 95 . . . . . . . . . . . . . . 95 . . . . . . . . . . . . . . . . . . .
Script Commands . . . . . . . . . . . . . . . . . Command Formatting Rules 105 . . . . . . . . . . . . . . . 106 . . . . . . . . . . . . . 108 Disk Group Commands . . . . . . . . . . . . . . . 108 Enclosure Commands . . . . . . . . . . . . . . . 109 Commands Listed by Function . . . . . . . . . . . . . 109 . . . . . . . . . . . . . . . . . . 109 Host Topology Commands iSCSI Commands Physical Disk Commands . . . . . . . . . . . . . . Session Command 110 . . . . . . . . 111 . . .
Create iSCSI Initiator . . . . . . . . . . . . . . . . Create RAID Virtual Disk (Automatic Physical Disk Select) . . . . . . . . . . . . . . . . . . Create RAID Virtual Disk (Free Capacity Base Select) . . . . . . . . . . . . . . . . . 126 . . . . . . 128 Create RAID Virtual Disk (Manual Physical Disk Select) . . . . . . . . . . . . . . . . . 133 137 . . . . . . . . . . . . . . . . . 139 . . . . . . . . . . . . . . . . . . . . . 140 Delete Disk Group . . . . . . . . . . . . . . . . . 140 . .
Reset Storage Array Battery Install Date Reset Storage Array iSCSI Baseline . . . . . 161 . . . . . . . . 162 Reset Storage Array SAS PHY Baseline . . . . . . . . . 162 . . . . . . . . . . . . . . . . . 163 Reset Storage Array Virtual Disk Distribution Revive Disk Group Revive Physical Disk . . . . . . . . . . . . . . . . Save Enclosure Log Data . . . . . . . . . . . . . Save Physical Disk Channel Fault Isolation Diagnostic Status . . . . . . . . . . . . . Syntax 163 164 . . . . 164 . . .
Set RAID Controller Module Syntax . . . . . . . . . . . . 183 . . . . . . . . . . . . . . . . . . . . . . . 183 . . . . . . . . . . 185 . . . . . . . . . . . . . . . 187 . . . . . . . . . . . . . . . . . . . . . 188 Syntax Element Statement Data Additional Information Set Session . . . . . . . . . . . . . 189 . . . . . . . . . . . . . . . . . 191 Set Snapshot Virtual Disk Set Storage Array . . . . . . 192 . . . . . . . .
Show String . . . . . . . . . . . . . . . . . . . . . . . . . . . . 216 . . . . . . . . . . . . . . . . . 217 Show Unconfigured iSCSI Initiators Show Virtual Disk 216 . . . . . . . . 218 . . . . . . . . . . . . . . 219 Show Virtual Disk Action Progress Show Virtual Disk Copy Show Virtual Disk Copy Source Candidates . . . . 220 Show Virtual Disk Copy Target Candidates . . . . 220 Show Disk Group Import Dependencies . . . . . . 220 Show Virtual Disk Performance Statistics . . . . .
Stop Storage Array Physical Disk Firmware Download . . . . . . . . . . . . . . . . . . Stop Virtual Disk Copy A Sample Script Files Index 12 . . . . 231 . . . . . . . . . . . . . . . 231 . . . . . . . . . . . . . . . . Configuration Script Example 1 . . . . . . . . . . . . . 233 Configuration Script Example 2 . . . . . . . . . . . . . 236 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
About the Command Line Interface This guide is intended for system administrators, developers, and engineers who need to use the command line interface (CLI) tool and its associated commands and script files. Selected CLI commands perform functions that you can also access from the Modular Disk (MD) Storage Manager, which is the graphical user interface (GUI) to the storage array. See the User’s Guide, which describes the Storage Manager software that is used to create and manage multiple storage arrays.
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. • Run script commands on a storage array directly connected to a host, a storage array connected to a host by an Ethernet, or a combination of both.
The following syntax is the general form of a CLI command: SMcli storageArray parameters script-commands; SMcli Invokes the command line interface storageArray Host name or IP address of the storage array parameters CLI parameters that define the environment and purpose for the command script-commands One or more script commands or the name of a script file containing script commands The script commands are the storage array configuration 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. Table 1-1 lists definitions for the parameters shown in the CLI commands.
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] SMcli -x email:email-address
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 only). • If you manage a storage array by using a host connected directly to the storage array (in-band storage management), you must use the -n parameter if more than one storage array is connected to the host.
Table 1-2. Command Line Parameters (continued) Parameter Definition -c Use to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command by using a semicolon (;). You cannot place more than one -c parameter on the same command line. You can include more than one script command after the -c parameter. -d Use to display the contents of the script configuration file. -e Use to disable syntax checking when executing the current CLI command.
Table 1-2. Command Line Parameters (continued) Parameter Definition -g Use to specify an ASCII file that contains email sender contact information to include in all email alert notifications. The CLI assumes the ASCII file is text only, without delimiters or any expected format. A typical file contains the following information: • Name • Title • Company • Phone • Pager NOTE: You can use any file name that your operating system supports. You must not use userdata.txt.
Table 1-2. Command Line Parameters (continued) Parameter Definition -n 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.
Table 1-2. Command Line Parameters (continued) Parameter Definition -q Use to specify how frequently to include additional profile or support bundle information in the email alert notifications. An email alert notification that contains at least the basic event information is always generated for every critical event. If you set the -I parameter to eventOnly, the only valid argument for -q is everyEvent.
Table 1-2. Command Line Parameters (continued) 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.
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 (" ") are part of an argument, you must insert a backslash (\) before each quotation mark character unless you are in interactive mode.
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.
Table 1-3. Exit Status (continued) Status Value Meaning 8 The storage array name was not in the configuration file. 10 A management class does not exist for the storage array. 11 A storage array was not found in the configuration file. 12 An internal error occurred. 13 Invalid script syntax was found. 14 The RAID controller module was unable to communicate with the storage array. 15 A duplicate argument was entered. 16 An execution error occurred.
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. On Windows operating systems, put quotation marks (" ") around the script command following the -c parameter.
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; however, the SMcli command may not execute correctly if the syntax is incorrect. SMcli -n Example -f scriptfile.
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. When entering an individual script command, include it as part of a CLI command. When running a file of script commands, include the file name as part of a CLI command.
Table 2-1.
• Brackets • A list of identifiers 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. The all parameter means all objects of the specified type in the storage array (for example, allVirtualDisks).
Table 2-2. Object Types and Identifiers (continued) Object Type Identifier virtualDiskCopy Target virtual disk and, optionally, the source virtual disk user labels diskGroup Virtual disk group number 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).
Table 2-3. General Form of the Script Commands (continued) Command Syntax Description deactivate object {statement-data} Removes the environment for an operation. delete object Deletes a previously created object. diagnose object {statement-data} Runs a test and displays the results. disable object {statement-data} Prevents a feature from operating. download object {statement-data} Transfers data to the storage array or hardware associated with the storage array.
Table 2-3. General Form of the Script Commands (continued) Command Syntax Description show object {statement-data} Displays information about the object. start object {statement-data} Starts an asynchronous operation. You can stop some operations after they have started. You can query the progress of some operations. stop object {statement-data} Stops an asynchronous operation. suspend object {statement-data} Suspends an operation.
Table 2-4.
Table 2-4.
Table 2-4. Recurring Syntax Elements (continued) Recurring Syntax Syntax Value instance-based-repository-spec repositoryRAIDLevel=repository-raidlevel repositoryPhysicalDisks=(physical diskspec-list) [enclosureLossProtect=boolean] repositoryDiskGroup=virtual-diskgroup-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.
Table 2-4. Recurring Syntax Elements (continued) 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).
Table 2-4.
Table 2-5. Range of Values for Recurring Syntax Elements (continued) 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. When using jumbo frames, make sure that all of the devices contained in the network path can handle the larger frame size.
NOTE: The 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, 10GB will return an error, but 10 GB will not return an error). Adding Comments to a Script File You can add comments to a script file in three ways. 1 The script engine interprets as a comment any text typed after two forward slashes (/ /) until an end-of-line character is reached.
About the Script Commands
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. Before configuring the storage array, become familiar with the concepts of physical disks, disk groups, virtual disks, host groups, hosts, and RAID controller modules.
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 ensuring that data is quickly accessible while maintaining the highest level of data protection possible.
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) • Other available host types • The hot spare locations • The identifiers for enabled features • The logical and physical component profiles • The time to which both RAID controller modules are set • The RAID controlle
NOTICE: 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. When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. To return a brief list of the storage array features and components, use the summary parameter.
The following commands also return information about a storage array: • show storageArray autoConfigure ("Show Storage Array Autoconfigure" on page 212) • show controller NVSRAM ("Show RAID Controller Module NVSRAM" on page 209) • show storageArray unreadableSectors ("Show Storage Array Unreadable Sectors" on page 215) • show virtualDiskCopy sourceCandidates ("Show Virtual Disk Copy Source Candidates" on page 220) • show virtualDiskCopy targetCandidates ("Show Virtual Disk Copy Target Candidates" o
You can choose to save the entire configuration or specific configuration features. The command for setting this parameter value looks like the following example: client>smcli 123.45.67.89 -c "save storageArray configuration file= \"c:\folder\\storageArrayconfig1.scr\";" In this example, the name folder is the folder in which you choose to place the configuration file, and storageArrayconfig1.scr is the name of the file. Choose any folder and any file name. MD Storage Manager uses the file extension .
NOTE: The capacity, owner, segmentSize, and enclosureLossProtect parameters are optional. You can use one or all of the optional parameters as needed to help define your configuration. You do not, however, need to use any optional parameters. 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.
The command in this example automatically creates a new disk group and a virtual disk with the name Engineering_1. The disk group will have a RAID level of 5 (RAID 5). The command uses three physical disks to construct the disk group. The virtual disk created has a capacity of 20 GB. If each physical disk has a capacity of 73 GB, the total capacity of the disk group is 219 GB.
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.
The userLabel, capacity, owner, and segmentSize parameters are the same as in the previous versions of the create virtualDisk 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: • You assign the physical disks.
Using the Auto Configure Command The autoConfigure storageArray command creates the disk groups on a storage array, the virtual disks in the disk groups, and the hot spares for the storage array.
NOTE: All parameters are optional. You can use one or all of the parameters as needed to define your configuration. 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.
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.
• 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 47). If you have problems with your modifications, you can use the information in the file to restore your previous configuration. Setting the Storage Array Password The set storageArray command enables you to define a password for a storage array.
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 MyStorageArrayEvent@MyCompany.com or SMcli -m MyCompany.com -F MyStorageArrayEvent@MyCompany.com 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:MyCompanySupport@MyCompany.com 123.45.67.
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. For example, if you set the defaultHostType to Linux, the RAID controller module communicates with any undefined host if the undefined host is running Linux.
• 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. The set virtualDisk command enables you to define the modification priority for a virtual disk.
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. The following syntax is the general form of the command: set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID0,slotID0 ...
Using the Snapshot Feature This chapter describes how the Snapshot feature works, lists the snapshot script commands, and explains how to use the commands to create snapshot virtual disks. Additional information about the Snapshot feature and related definitions is available in the online help, the Installation Guide, the MD Storage Manager User’s Guide, and the Owner’s Manual. The Snapshot feature creates a snapshot virtual disk that you can use as a backup of your data.
• 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. NOTE: The maximum number of snapshot virtual disks is one-half of the total number of virtual disks supported by the RAID controller module. • Increase the capacity of a snapshot virtual disk.
Using Host Servers to Create an Initial Snapshot Virtual Disk NOTICE: Before using the Snapshot Virtual Disks Premium Feature in a Microsoft® Windows® clustered configuration, you must first map the snapshot virtual disk to the cluster node that owns the source virtual disk. This ensures that the cluster nodes correctly recognize the snapshot virtual disk.
• Define the number of physical disks, but not specific physical disks, for the repository virtual disk. When using the create snapshotVirtualDisk command to create a snapshot virtual disk, the standard virtual disk name for the source virtual disk is the minimum information required. When you provide only the standard virtual disk name, the storage management software provides default values for the other required property parameters for a snapshot virtual disk.
Preparing Host Servers to Create an Initial Snapshot Virtual Disk NOTICE: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the source virtual disk. Close all applications, including Windows Internet Explorer®, to make sure all I/O activity has stopped.
After your server has been prepared, see "Creating the Initial Snapshot Virtual Disk" on page 66. Creating the Initial Snapshot Virtual Disk After first preparing the host server(s) as specified in the preceding procedure, use the following examples to make a virtual disk snapshot.
Refer to steps 1 through 4 in the preceding section, "Preparing Host Servers to Create an Initial Snapshot Virtual Disk" on page 65. The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5); A minimal version of this command might look like the following example: client>smcli 123.45.67.
"snapshotVirtualDiskName" warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel="repositoryName" repositoryFullPolicy=(failSourceWrites | failSnapShot)] [enclosureLossProtect=(TRUE | FALSE)] NOTE: Use one or all of the optional parameters as needed to define your configuration. It is not necessary to use any optional parameters. The following example is a command in which software assigns the physical disks: client>smcli 123.45.67.
Creating a Snapshot Virtual Disk by Specifying a Number of Physical Disks With this version of the create snapshotVirtualDisk command, you must specify the number of physical disks and the RAID level for the snapshot repository virtual disk. This version of the create snapshotVirtualDisk command creates a new disk group.
User-Defined Parameters Parameters for the create snapshotVirtualDisk command enable you to define the snapshot virtual disk to suit the requirements of your storage array. Table 4-2 lists the parameters and descriptions of what the parameters do. Table 4-2. Snapshot Virtual Disk Parameters Parameter Description physicalDiskType Specifies the type of physical disk to use for the snapshot repository virtual disk.
Table 4-2. Snapshot Virtual Disk Parameters (continued) Parameter Description repositoryUserLabel Specifies the name to give to the snapshot repository virtual disk. If you do not choose a name for the snapshot repository virtual disk, the RAID controller modules create a default name using the source virtual disk name.
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" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel="Mars_Spirit_4_snap1" repositoryUserLabel="Mars_Spirit_4_rep1" warningThresholdPercent=75 repositoryPercentOfSource=40 repositoryFullPolicy=failSnapShot; NOTE: In the
default name is aaa-1. If the source virtual disk already has n – 1 number of snapshot virtual disks, then the default name is aaa-n. Similarly, if the name of the source virtual disk is aaa and it does not have a repository virtual disk, then the default repository virtual disk name is aaa-R1. If the source virtual disk already has n – 1 number of repository virtual disks, then the default name is aaa-Rn.
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.
Re-creating the Snapshot Virtual Disk To restart a copy-on-write operation, use the recreate snapshot virtualDisk command. This command starts a fresh copy-on-write operation using an existing snapshot virtual disk. When you restart a snapshot virtual disk, the snapshot virtual disk must have either an Optimal or a Disabled state. The following conditions then occur: • All copy-on-write data previously on the snapshot repository virtual disk is deleted.
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. If this is not done, the snapshot operation will report that it has completed successfully, but the snapshot data will not be updated properly. 4 Follow any additional instructions for your operating system. Failure to follow these additional instructions can create unusable snapshot virtual disks.
Using the Virtual Disk Copy Feature This chapter describes how the Virtual Disk Copy feature works, lists the script commands for Virtual Disk Copy, and explains how to use the commands to create and run Virtual Disk Copy. Additional information about Virtual Disk Copy and related definitions is available in the online help, the Installation Guide, the MD Storage Manager User’s Guide, and the Owner’s Manual.
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 feature=virtualDiskCopy Turns off the current virtual disk copy operation. enable storageArray feature Activates 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. You need a feature key to enable the feature.
also define the copy priority and choose whether you want the target virtual disk to be write enabled or read only after the data is copied from the source virtual disk. Preparing Host Servers to Create a Virtual Disk Copy NOTICE: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk (and, if applicable, the target disk) to ensure that you capture an accurate point-in-time image of the source virtual disk.
Copying the Virtual Disk After first preparing the host server(s) as specified in the preceding procedure, use the following examples to make a virtual disk copy. The following syntax is the general form of the command: create virtualDiskCopy source="sourceName" target= "targetName" [copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] NOTE: Use one or both of the optional parameters as needed to help define your configuration.
Setting the targetReadOnlyEnabled parameter to TRUE means that write requests cannot be made to the target virtual disk. This setting also ensures that the data on the target virtual disk remains unaltered. Refer to steps 1 through 4 in the preceding section, "Preparing Host Servers to Create a Virtual Disk Copy" on page 80.
The following example shows a command that returns information about a virtual disk used for a virtual disk copy: client>smcli 123.45.67.89 -c "show virtualDiskCopy source [\"Jaba_Hut\"];" The command in the preceding example requests information about the source virtual disk Jaba_Hut. If you want information about all virtual disks, use the allVirtualDisks parameter. You can also request information about a specific target virtual disk.
to the target virtual disk after the virtual disk copy is created.
Using the recopy virtualDiskCopy command, you can create a new virtual disk copy for a previously defined copy pair that has a status of Stopped, Failed, or Completed. Use the recopy virtualDiskCopy command to create backups of the target virtual disk, then copy the backup to tape for off-site storage. When using the recopy virtualDiskCopy command to make a backup, you cannot write to source while the recopy is running. The recopy might take a long time.
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 will report that it has completed successfully, but the copied data will not be updated properly. 4 Follow any additional instructions for your operating system. Failure to follow these additional instructions can create unusable virtual disk copies.
this command, you are copying the data from the source virtual disk to the target virtual disk. You are making this copy because the data on the source virtual disk changed since the previous copy was made. Refer to steps 1 through 4 in the preceding section, "Preparing Host Servers to Recopy a Virtual Disk" on page 85.
NOTICE: If the virtual disk copy has a status of In Progress, you must stop the virtual disk copy before you can remove the virtual disk copy pair from the storage array configuration. The following syntax is the general form of the command: remove virtualDiskCopy target [targetName] [source [sourceName]] The following example shows a command to remove a virtual disk copy pair: client>smcli 123.45.67.
After you create a virtual disk copy, the target virtual disk automatically becomes read-only to hosts to ensure that the data is preserved. Hosts that have been mapped to a target virtual disk do not have write access to the virtual disk, and any attempt to write to the read-only target virtual disk results in a host I/O error. If you want hosts to have write access to the data on the target virtual disk, use the set virtualDiskCopy command to disable the read-only attribute for the target virtual disk.
Using the Virtual Disk Copy Feature
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.
scan is performed as a background operation and scans all data and consistency information in defined user virtual disks.
The script command set provides two commands to define media scan properties: • set virtualDisks • set storageArray 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.
Resetting a RAID Controller Module NOTICE: When you reset a RAID controller module, the RAID controller module is not available for I/O operations until the reset is complete. If a host is using virtual disks owned by the RAID controller module being reset, the I/O directed to the RAID controller module is rejected. Before resetting the RAID controller module, ensure that a multipath driver is installed on all hosts using these virtual disks.
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" ...
Monitoring Performance Monitor the performance of a storage array by using the save storageArray performanceStats command. This command saves performance information to a file that you can review to determine how well the storage array is running. Table 6-1 lists the performance information saved to the file. Table 6-1.
The general form of the command is: save storageArray performanceStats file="filename" where file is the name of the file in which you want to save the performance statistics. You can use any file name your operating system can support. The default file type is .csv. The performance information is saved as a comma-delimited file.
where segmentSizeValue is the new segment size you want to set. Valid segment size values are 8, 16, 32, 64, 128, 256, and 512. You can identify the virtual disk by name or World Wide Identifier (WWID) (see "Set Virtual Disk" on page 198). Defragmenting a Disk Group When you defragment a disk group, you consolidate the free capacity in the disk group into one contiguous area. Defragmentation does not change the way in which the data is stored on the virtual disks.
Diagnosing a RAID Controller Module The diagnose controller command’s testID parameter takes the following options, which you can use to verify that a RAID controller module is functioning correctly: • 1— Reads the test • 2— Performs a data loop-back test • 3— Writes the test The read test initiates a read command as it would be sent over an I/O data path. The read test compares data with a known, specific data pattern, checking for data integrity and errors.
The test results contain a generic, overall status message and a set of specific test results. Each test result contains the following information: • Test (read/write/data loopback) • Port (read/write) • Level (internal/external) • Status (pass/fail) Events are written to the MEL when diagnostics are started and when testing is completed. These events help you to evaluate whether diagnostics testing was successful or failed and the reason for the failure.
Use Service mode when you want to perform an operation, such as replacing a RAID controller module. Placing a RAID controller module in Service mode makes it unavailable for I/O operations. Placing a RAID controller module in Service mode also moves the disk groups from the RAID controller module to the second RAID controller module without affecting the disk groups’ preferred path. Moving disk groups might significantly reduce performance.
virtual disk and disk group. To be able to reuse the physical disks to create a new disk group and virtual disk, you must erase all old information from the physical disks by initializing the physical disk. When you initialize a physical disk, all old disk group and virtual disk information is erased, and the physical disk is returned to an unassigned state. Returning a physical disk to an unassigned state adds unconfigured capacity to a storage array.
The initialization process cannot be cancelled once it has begun. This option cannot be used if any modification operations are in progress on the virtual disk or disk group. To initialize a virtual disk, run the following command: start virtualDisk [virtualDiskName] initialize where virtualDiskName is the identifier for the virtual disk. Redistributing Virtual Disks Redistributing virtual disks returns the virtual disks to their preferred RAID controller module owners.
Maintaining a Storage Array
Script Commands This chapter describes the script commands used to configure, monitor, and maintain a storage array. This chapter is organized in four sections: • "Command Formatting Rules" on page 106 lists general formatting rules that apply to the command syntax.
Command Formatting Rules This section describes the general rules for formatting a script command and how the command syntax is presented in the following command descriptions. Syntax unique to a specific command is explained in the notes at the end of each command description. • The script commands are not case sensitive. Type the commands in lowercase, uppercase, or mixed case.
• 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. Put parentheses around the set of values. For example: (0,0 0,1 0,2 0,3 1,0 1,1 1,2 1,3) • Italicized terms in the command indicate a value or information that you need to provide.
following name is used in a command running under a Windows operating system: [\"Engineering"\] For Linux, and when used in a script file, the name appears as the following: ["Engineering"] When you enter the World Wide Identifier (WWID) of an HBA host port, some usages require quotation marks around the WWID. In other uses, you must put angle brackets (< >) around the WWID. The description of the WWID parameter tells you if you must put quotation marks or angle brackets around the WWID.
Enclosure Commands "Download Enclosure Management Module Firmware" on page 146 "Save Enclosure Log Data" on page 164 "Set Enclosure Attribute" on page 174 "Set Enclosure Identification" on page 175 "Start Enclosure Blink" on page 223 "Stop Enclosure Blink" on page 229 Host Topology Commands "Create Host" on page 122 "Create Host Group" on page 123 "Create Host Port" on page 124 "Delete Host" on page 140 "Delete Host Group" on page 140 "Delete Host Port" on page 141 "Set Host" on page 176 "Set Host Group" o
"Set iSCSI Initiator" on page 179 "Set iSCSI Target Properties" on page 180 "Set Storage Array ICMP Response" on page 193 "Set Storage Array iSNS Server IPv4 Address" on page 194 "Set Storage Array iSNS Server IPv6 Address" on page 195 "Set Storage Array iSNS Server Refresh" on page 196 "Set Unnamed Discovery Session" on page 198 "Show Current iSCSI Sessions" on page 203 "Show Storage Array Negotiation Defaults" on page 214 "Show Unconfigured iSCSI Initiators" on page 216 "Start iSCSI DHCP Refresh" on page
"Start Physical Disk Blink" on page 226 "Start Physical Disk Initialize" on page 226 "Start Physical Disk Reconstruction" on page 227 "Stop Physical Disk Blink" on page 229 "Stop Physical Disk Channel Fault Isolation Diagnostics" on page 230 RAID Controller Module Commands "Diagnose RAID Controller Module" on page 143 "Enable RAID Controller Module" on page 151 "Reset RAID Controller Module" on page 160 "Save RAID Controller Module NVSRAM" on page 165 "Set Controller" on page 170 "Set RAID Controller Modul
"Autoconfigure Storage Array Hot Spares" on page 116 "Clear Storage Array Configuration" on page 118 "Clear Storage Array Event Log" on page 119 "Clear Storage Array Firmware Pending Area" on page 119 "Disable Storage Array Feature" on page 146 "Download Storage Array Firmware/NVSRAM" on page 148 "Download Storage Array Physical Disk Firmware" on page 150 "Download Storage Array NVSRAM" on page 149 "Enable Storage Array Feature Key" on page 151 "Reset Storage Array Battery Install Date" on page 161 "Reset S
"Start Storage Array Blink" on page 227 "Stop Storage Array Blink" on page 231 "Stop Storage Array Physical Disk Firmware Download" on page 231 Virtual Disk Commands "Check Disk Consistency" on page 117 "Clear Virtual Disk Reservations" on page 120 "Create RAID Virtual Disk (Automatic Physical Disk Select)" on page 126 "Create RAID Virtual Disk (Free Capacity Base Select)" on page 128 "Create RAID Virtual Disk (Manual Physical Disk Select)" on page 130 "Delete Virtual Disk" on page 142 "Recover RAID Virtua
"Show Virtual Disk Copy Target Candidates" on page 220 "Stop Virtual Disk Copy" on page 231 Commands Listed Alphabetically Following are the script commands listed alphabetically. Accept Storage Array Pending Topology This command configures all or part of the pending host topology discovered by the show storageArray pendingTopology command. Syntax accept storageArray pendingTopology (allHosts | host "hostName" | hosts ("hostName1" ...
Autoconfigure Storage Array This command automatically configures a storage array. Before entering the autoConfigure storageArray command, enter the show storageArray autoConfiguration command. The show storageArray autoConfiguration command returns configuration information in the form of a list of valid physical disk types, RAID levels, virtual disk information, and hot spare information. (This list corresponds to the parameters for the autoConfigure storageArray command.
Parameter Description raidLevel RAID level of the disk group that contains the physical disks in the storage array. Valid RAID levels are 0, 1, 5 or 6. diskGroupWidth Number of physical disks in a disk group in the storage array. For information about the number of physical disks that you can use in a disk group, see "Enclosure Loss Protection" on page 52. diskGroupCount Number of disk groups in the storage array. Use integer values.
NOTE: When you run the autoconfigure storageArray hotSpares command, the RAID controller module firmware determines the number of hot spares to create based on the total number and type of physical disks in the storage array. Check Disk Consistency This command checks a virtual disk for consistency and media errors, and writes the results of the check to a file.
Parameter Description priority Specifies the priority that the consistency check has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. verbose Captures progress details, such as percent complete, and shows the information while virtual disk consistency is being repaired. To capture progress details, set this parameter to TRUE. To prevent capturing progress details, set this parameter to FALSE.
Syntax clear storageArray configuration (all | volumeGroups) Parameters If you do not enter a parameter, this command removes all configuration information for the storage array, except for the information related to security and identification. Parameter Description all The setting to remove the entire configuration of the storage array, including security and identity information. Removing all configuration information returns the storage array to its initial state.
Syntax clear storageArray firmwarePendingArea Parameters None. Clear Virtual Disk Reservations This command clears persistent virtual disk reservations. Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen]) reservations Parameters Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which to clear reservations.
Syntax create diskGroup physicalDisks=(trayID1,slotID1 ... trayIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6) userlabel=userlabel [enclosureLossProtect=(true | false)] Parameters Parameter Description userLabel The name that you want to use for the new disk group. Enclose the name in double quotation marks (" "). physicalDisks The physical disks that you want to assign to the virtual disk that you want to create. Specify the tray ID and slot ID for each physical disk that you assign to the virtual disk.
Enclosure Loss Protection For enclosure loss protection to work, each physical disk in a disk group must be in a separate enclosure. If you set the enclosureLossProtect parameter to true and have selected more than one physical disk from any one enclosure, the storage array returns an error. 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.
Parameter Description hostGroup Name of the host group in which to create a new host. You must put quotation marks (" ") around the host group name. (If a host group does not exist, you can create a new host group by using the create hostGroup command.) NOTE: A host group is an optional topological element defined to designate a collection of hosts that share access to the same virtual disks. The host group is a logical entity.
Parameters Parameter Description userLabel Name to give the host group that you are creating. You must put quotation marks (" ") around the host group name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation.
Parameter Description host Name of the host for which you are 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. An HBA host port provides host access to the virtual disks in a storage array.
NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a “secret.” A secret is a security key that is similar to a password. Use chapSecret only for initiators requiring mutual authentication. Create RAID Virtual Disk (Automatic Physical Disk Select) This command creates a disk group across the storage array physical disks, and a new virtual disk in the disk group.
Parameter Description physicalDiskType Specifies the type of physical disk to use in the virtual disk. You cannot mix physical disk types in the virtual disk. Valid physical disk types are SAS or SATA. capacity The size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, kilobytes, megabytes, or gigabytes. NOTE: A space must be added between the last digit and the size (MB, GB, or KB) for values greater than 9.
Parameter Description segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure Command" on page 53. enclosureLossProtect Specifies that enclosure loss protection is enforced when creating the disk group.
Parameter Description userLabel Name for the new virtual disk. You must put quotation marks (" ") around the new virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation.
Parameter Description owner RAID controller module that owns the virtual disk. 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. If you do not specify an owner, the RAID controller module firmware determines the owner. NOTE: The owner parameter defines which RAID controller module owns the virtual disk.
[capacity=virtualDiskCapacity owner=(0 | 1) segmentSize=segmentSizeValue enclosureLossProtect=(TRUE | FALSE)] Parameters Parameter Description physicalDisks Specifies the physical disks to assign to the created virtual disk. Specify the enclosure ID and slot ID for each unassigned physical disk to assign to the virtual disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put parentheses around the enclosure ID values and the slot ID values.
Parameter Description capacity Size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, kilobytes, megabytes, gigabytes, or terabytes. NOTE: If you do not specify a capacity, all physical disk capacity available in the disk group is used. If you do not specify capacity units, bytes are used as the default. A space must be added between the last digit and the size (MB, GB, or KB) for values greater than 9.
Create Snapshot Virtual Disk This command creates a snapshot virtual disk. When you use this command, you can define the snapshot virtual disk in one of three ways: • User-defined physical disks • User-defined disk group • User-defined number of physical disks for the snapshot virtual disk If you choose to define a number of physical disks, the RAID controller module firmware chooses which physical disks to use for the snapshot virtual disk.
freeCapacityIndexNumber userLabel= "snapshotVirtualDiskName" warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel="repositoryName" repositoryFullPolicy=(failSourceWrites | failSnapShot) enclosureLossProtect=(TRUE | FALSE)] Syntax (User-Defined Number of Physical Disks) create snapshotVirtualDisk sourceVirtualDisk= "sourceVirtualDiskName" [repositoryRAIDLevel= 0 | 1 | 5 | 6 repositoryPhysicalDiskCount= numberOfPhysicalDisks physicalDiskType=(SAS | SATA) userLabel=
Parameter Description repositoryPhysicalDiskCount Number of unassigned physical disks to use for the repository virtual disk. physicalDiskType Type of physical disks to use for the repository virtual disk. Valid physical disk types are SAS or SATA. repositoryDiskGroup Sequence number of the disk group where the repository virtual disk is located. freeCapacityArea The index number of the free space in an existing disk group to use to create the snapshot repository virtual disk.
Parameter Description repositoryPercentOfSource The size of the repository virtual disk as a percentage of the source virtual disk. Use integer values. For example, a value of 40 means 40 percent. The default value is 20. repositoryUserLabel The name to give to the repository virtual disk. You must put quotation marks (" ") around the repository virtual disk name. repositoryFullPolicy Specifies how snapshot processing continues if the repository is full.
NOTE: If you do not choose a name for the either the snapshot virtual disk or repository 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 aaa and does not have a snapshot virtual disk, the default snapshot virtual disk name is aaa – 1. If the source virtual disk already has n – 1 number of snapshot virtual disks, the default name is aaa – n.
Parameters Parameter Description source Name of an existing virtual disk to use as the source virtual disk. You must put quotation marks (" ") around the source virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation.
Parameter Description copyPriority Specifies the priority that a virtual disk 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.
Delete Host This command deletes a host. Syntax delete host [hostName] Parameters Parameter Description host Name of the host to delete. You must put brackets ([ ]) around the host name. If the host name has special characters, you must also put quotation marks (" ") around the host name. NOTE: A host is a system that is attached to the storage array and accesses the virtual disks on the storage array through its HBA host ports. Delete Host Group This command deletes a host group.
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] Parameters Parameter Description hostPort Name of the HBA host port to delete. You must put brackets ([ ]) around the name of the HBA host port.
Parameters Parameters Description iSCSI-ID The identifier of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). name The name of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). Example -c "delete iscsiInitiator [\"job29002\"];" Delete Virtual Disk This command deletes one or more standard virtual disks or snapshot and snapshot repository virtual disks.
Parameter Description virtualDisk or virtualDisks Name of the virtual disk to delete. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Diagnose RAID Controller Module This command runs diagnostic tests on the RAID controller module.
Parameters Parameter Description controller RAID controller module on which to run 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. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify a RAID controller module, the storage management software returns a syntax error.
Parameter Description testID Identifier for the diagnostic test to run. The identifier and corresponding tests are: 1 — Reads the test 2 — Performs a data loop-back test 3 — Writes the test discreteLines — Discrete lines diagnostic test NOTE: Discrete lines are control and status lines connected between two RAID controller modules in a RAID controller.
Parameter Description patternFile Name of a file that contains a data pattern to use as test data. You must put quotation marks (" ") around the data pattern file name. Disable Storage Array Feature This command disables a storage array feature. Issue the show storageArray command to display a list of the feature identifiers for all enabled features in the storage array. Syntax disable storageArray feature=(snapshot | virtualDiskCopy) Parameters None.
Parameters Parameter Description enclosure Identifies the enclosure to which to load new firmware. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. NOTE: You can use the following parameters: (1) the allEnclosures parameter, which downloads new firmware to all of the EMMs in the storage array, and (2) the enclosure parameter, which downloads new firmware to a specific EMM.
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. (Use the download storageArray physicalDiskFirmware command to download firmware on all of the physical disks in the storage array.) This command blocks all I/O activity until the download finishes or fails. The download returns one of the following statuses: Successful, Unsuccessful With Reason, or Never Attempted With Reason.
Parameters Parameter Description NVSRAM Specifies that you want to download a file with NVSRAM values when you download a firmware file. You must not put brackets around this parameter. Include a comma after the term firmware. file File path and name of the file that contains the firmware. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the file name. NVSRAM-filename File path and name of the file that contains the NVSRAM values.
Parameters Parameter Description file File path and name of the file that contains the NVSRAM values. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the file name. Download Storage Array Physical Disk Firmware This command downloads firmware images to all physical disks in the storage array. Syntax download storageArray physicalDiskFirmware file= "filename" [file="filename2"...
NOTE: The download storageArray physicalDiskFirmware command blocks all I/O activity until a download attempt has been made for each candidate physical disk or you issue the stop storageArray downloadPhysicalDiskFirmware command. When the download storageArray physicalDiskFirmware command finishes downloading the firmware image, each candidate physical disk is displayed showing the download status for each physical disk.
Parameters Parameter Description file File path and file name of a valid feature key file. Valid file names for feature key files must end with a .key extension. You must put quotation marks (" ") around the file path and file name. Recopy Virtual Disk Copy This command reinitiates a virtual disk copy operation by using an existing virtual disk copy pair. NOTE: Refer to "Preparing Host Servers to Recopy a Virtual Disk" on page 85.
Parameters Parameter Description target Name of the target virtual disk for which to 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. source Name of the source virtual disk for which to reinitiate a virtual disk copy operation. You must put brackets ([ ]) around the source virtual disk name.
diskGroup=diskGroupNumber) [newVolumeGroup= VolumeGroupName] userLabel=”virtualDiskName” capacity= virtualDiskCapacity offset=offsetValue raidLevel=(0 | 1 | 5 | 6) segmentSize=segmentSizeValue [owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE)] Parameters Parameter Description physicalDisk or physicalDisks Specifies the physical disks to assign to the virtual disk that you want to create. Specify the tray ID and slot ID for each physical disk that you assign to the virtual disk. Tray ID values are 0 to 99.
Parameter Description owner RAID controller module that owns the 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. If you do not specify an owner, the RAID controller module firmware determines the owner. For information about the owner parameter, see "Creating Virtual Disks with User-Assigned Physical Disks" on page 48. cacheReadPrefetch The setting to turn on or turn off cacheReadPrefetch.
group that are used for data transfers). In this case, multiple physical disks are used for the same request, but each physical disk is accessed only once. For optimal performance in a multiuser database or file system storage environment, set your segment size to minimize the number of physical disks that are required to satisfy a data transfer request.
warningThresholdPercent=percentValue repositoryFullPolicy=(failSourceWrites | failSnapShot)] Parameters Parameter Description virtualDisk or virtualDisks Name of the specific virtual disk for which to start a fresh copy-on-write operation. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name.
NOTE: If the warningThresholdPercent parameter or the repositoryFullPolicy parameter is not specified, the previously set values are used. If you use the optional parameters, the re-create Snapshot will process each snapshot virtual disk separately. If the same userLabel (name) is specified for more than one virtual disk, the command fails.
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 allVirtualDisks Removes the LUN mapping from all virtual disks. virtualDisk or virtualDisks Name of the specific virtual disk to remove from the LUN mapping.
Repair Virtual Disk Consistency This command repairs the consistency errors on a virtual disk. Syntax repair virtualDisk [virtualDiskName] consistency consistencyErrorFile=filename [verbose=(TRUE | FALSE)] Parameters Parameter Description virtualDisk Name of the specific virtual disk for which to repair consistency. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name.
Parameters Parameter Description controller RAID controller module to reset. 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. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify an owner, the RAID controller module firmware returns a syntax error.
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.
Syntax reset storageArray virtualDiskDistribution Parameters None. NOTICE: Ensure that the multipath driver is running before you use this command, or the virtual disk will not be accessible. NOTE: Under certain host operating system environments, you might be required to reconfigure the multipath host physical disk. You might also need to make operating system modifications to recognize the new I/O path to the virtual disks.
Syntax revive physicalDisk [enclosureID,slotID] Parameters Parameter Description physicalDisk Identifies the enclosure and slot where the physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and the slot ID value. Save Enclosure Log Data This command saves the log data maintained by the EMM in all enclosures in a storage array to a file.
Parameters Parameter Description file The name of the file in which you are storing the results of the fault isolation diagnostics test on the drive channel. Enclose the name in double quotation marks (" "). NOTE: A file extension is not automatically appended to the saved file. You must specify the applicable format suffix for the file. If you specify a file extension of .txt, then the output will be in a text file format. If you specify a file extension of .
Parameters Parameter Description controller RAID controller module with the NVSRAM values to save. 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. You must put brackets ([ ]) around the RAID controller module identifier. file Name of the file in which to save the values. You must put quotation marks (" ") around the file name.
Parameter Description virtualDiskConfigAndSe Saves the virtual disk configuration settings and all of the global settings to the file. To save the virtual disk ttings configuration and global settings, set this parameter to TRUE. To prevent saving the virtual disk configuration and global settings, set this parameter to FALSE. The default value is TRUE. hostTopology Saves the host topology to the file. To save the host topology, set this parameter to TRUE.
Parameter Description count Specifies the number of events or critical events to save to a file. If you do not enter a value for the count, all events or critical events are saved to the file. If you enter a value for the count, only that number of events or critical events (starting with the last event entered) are saved to the file. Use integer values. Save Storage Array iSCSI Statistics This command saves the storage array iSCSI performance statistics to a file.
Example -c "save storageArray iscsiStatistics [raw] file = \"testfile\";" 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.
Save Storage Array State Capture This command saves the state capture to a file. Syntax save storageArray stateCapture file="filename" Parameters Parameter Description file Name of the file to which to save the state capture. You must put quotation marks (" ") around the file name. Save Storage Array Support Data This command saves the storage array support-related information to a file.
(nvsramByteSetting | nvsramBitSetting) | iscsiHostPort [(1 | 2)] = iscsi-host-port-options rloginEnabled=(TRUE | FALSE) Parameters Parameter Description controller This parameter is the RAID controller module for which you want to define properties. Valid identifiers for the RAID controller module 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 RAID enclosure.
Parameter Description rloginEnabled This parameter defines whether the remote login feature is turned on or turned off. To turn on the remote login feature, set this parameter to TRUE. To turn off the remote login feature, set this parameter to FALSE. NOTE: When you use this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters.
The default value for theIPv6NdRetransmitTime parameter is 1000 milliseconds. The default value for the IPv6NdTimeOut parameter is 30000 milliseconds. The default port value for the tcpListeningPort parameter is 3260.
Parameters Parameter Description diskGroup Sequence number of the disk group for which to set properties. You must put brackets ([ ]) around the disk group number. addPhysicalDisks Identifies the physical disk by tray and slot location to include in the disk group. Tray ID values are 0 to 99. Slot ID values are 0 to 31. You must put parentheses around the tray ID values and the slot ID values. raidLevel RAID level for the disk group. Valid values are 0, 1, 5, or 6.
Parameters Parameter Description enclosure Identifies a specific enclosure for which to set the attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. chassisName Chassis name or number to give the new enclosure. Chassis names can be any combination of alphanumeric characters with a maximum length of 32 characters. Alphabetical characters can be uppercase or lowercase. You can also use the underscore character (_) and the hyphen (-) character.
Set Foreign Physical Disk to Native This command incorporates foreign physical disks that have not been imported into the storage array configuration through normal means. This operation is for emergency recovery use only. Use this statement only when one or more physical disks were added after the configuration adoption process completed. NOTICE: Using this command for purposes other than what is stated above might result in data corruption or data loss without notification.
Parameters Parameter Description host The name of the host that you want to assign to a host group. Enclose the host name in square brackets ([ ]). If the host name has special characters, you must also enclose the host name in double quotation marks (" "). hostGroup The host group to which you want to assign the host. (The following table defines how the command runs if the host does or does not have individual virtual disk-to-LUN mappings.) Enclose the host group name in double quotation marks (" ").
NOTE: When you use this command, you can specify one or more of the optional parameters. You do not, however, need to use all of the parameters. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation.
Set Host Port This command changes the host type for an HBA host port. You can also change an HBA host port label with this command. Syntax set hostPort [portLabel] host=“hostName” userLabel=“newPortLabel” Parameters Parameter Description hostPort The name of the HBA host port for which you want to change the host type, or for which you want to create a new name. Enclose the HBA host port name in square brackets ([ ]).
Parameters Parameter Description iscsiName The name of the iSCSI initiator for which you want to set attributes. userLabel The new name that you want to use for the iSCSI initiator. host The name of the new host to which the HBA host port is connected. Enclose the host name in double quotation marks (" "). chapSecret The password that you want to use to authenticate a peer connection.
Syntax set iscsiTarget authenticationMethod = (none | chap) | chapSecret = password | isnsRegistration = (TRUE | FALSE) | targetAlias = user-label Parameters Parameter Description authenticationMethod The means of authenticating your iSCSI session. chapSecret The password that you want to use to authenticate a peer connection. isnsRegistration The means of listing the iSCSI target on the iSNS server. Set the parameter to TRUE to list it. targetAlias The name that you want to use for the target.
-c "set iscsiTarget <\"iqn.198405.com.dell:powervault. 6001372000f5f0e600000000463b9292\"> targetAlias = \"iscsi2902\";" 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.
Parameters Parameter Description physicalDisk or physicalDisks Identifies the enclosure and slot where the physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID values and the slot ID values. hotSpare Assigns the physical disk as the hot spare. To assign the physical disk as the hot spare, set this parameter to TRUE. To remove a hot spare assignment from a physical disk, set this parameter to FALSE.
globalNVSRAMByte [nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | hostNVSRAMByte [hostType, nvsramOffset]=(nvsramByteSetting | nvsramBitSetting) | iscsiHostPort [(1 | 2)]=iscsiHostPortOptions rloginEnabled=(TRUE | FALSE) | serviceAllowedIndicator=(on | off) Parameters Parameter Description controller The RAID controller module for which you want to define properties.
Parameter Description iscsiHostPort The values that support this parameter are listed in "Syntax Element Statement Data" on page 185. Many settings are possible, including setting the IP address, the gateway address, the subnet mask address, the IPv4 priority, and the IPv6 priority. rloginEnabled The setting for whether the remote login feature is turned on or turned off. To turn on the remote login feature, set this parameter to TRUE. To turn off the remote login feature, set this parameter to FALSE.
IPv4GatewayIP=(0-255).(0-255).(0-255).(0-255) | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) | duplexMode=(TRUE | FALSE) | portSpeed=[(autoNegotiate | 10 | 100 | 1000)] iscsiHostPort Options The following options are available for the iscsiHostPort parameter. IPv4Address=(0-255).(0-255).(0-255).
IPv6NdDetectDuplicateAddress=[0-256] | IPv6NdReachableTime=[0-65535] | IPv6NdRetransmitTime=[0-65535] | IPv6NdTimeOut=[0-65535] | IPv4Priority=[0-7] | IPv6Priority=[0-7] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) | IPv4VlanId=[1-4094] | IPv6VlanId=[1-4094] | maxFramePayload=[frameSize] | tcpListeningPort=[3260, 49152-65536] | 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.
The portSpeed parameter is expressed as megabits per second (Mb/s). The IPv6 address space is 128 bits. It is represented by eight 16-bit hexadecimal blocks separated by colons. You may drop leading zeros, and you may use a double colon to represent consecutive blocks of zeroes. The default value for the IPv6HopLimit parameter is 64. The default value for the IPv6NdReachableTime parameter is 30000 milliseconds. The default value for the IPv6NdRetransmitTime parameter is 1000 milliseconds.
Parameter Description password Specifies the password for the storage array. You must put quotation marks (" ") around the password. NOTE: Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (You can define a storage array password by using the set storageArray command.
"snapshotVirtualDiskName" warningThresholdPercent=percentValue repositoryFullPolicy=(failSourceWrites | failSnapShot) Parameters Parameter Description virtualDisk or virtualDisks Name of the specific snapshot virtual disk for which to define properties. (You can enter more than one snapshot virtual disk name by using the virtualDisks parameter). You must put quotation marks (" ") and brackets ([ ]) around the snapshot virtual disk name.
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Set Storage Array This command defines the properties of the storage array.
Parameter Description failoverAlertDelay Specifies the failover alert delay time in minutes. The valid delay time range is 0 to 60 minutes. The default value is 5 minutes. mediaScanRate Specifies the number of days over which the media scan runs. Valid values are: 0, which disables media scan, or 1 to 30, where 1 is the fastest scan rate, and 30 is the slowest.
Parameters Parameter Description enclosurePositions List of enclosure IDs. The sequence of the module IDs in the list define the positions for the RAID enclosure and expansion enclosures in a storage array. Valid values are 0 to 99. Separate the enclosure ID values with a space, and put parentheses around the list of enclosure IDs. NOTE: This command defines the position of an enclosure in a storage array by the position of the enclosure ID in the enclosurePositions list.
ICMP Echo Request messages and receives Echo Response messages to determine if a host is reachable and how long packets take to get to and from that host. Example -c "set storageArray icmpPingResponse = TRUE;" Set Storage Array iSNS Server IPv4 Address This command sets the configuration method and address for an IPv4 Internet Storage Name Service (iSNS).
NOTE: The DHCP server passes configuration parameters, such as network addresses, to IP nodes. DHCP enables a client to acquire all of the IP configuration parameters that it needs to operate. DHCP enables you to automatically allocate reusable network addresses. Example -c "set storageArray isnsIPV4ConfigurationMethod = static isnsIPV4Address = 192.168.0.1;" Set Storage Array iSNS Server IPv6 Address This command sets the address for an IPv6 Internet Storage Name Service (iSNS).
Parameter Parameter Description isnsListeningPort The IP address that you want to use for the iSNS server listening port. The range of values for the listening port is 49152 to 65535. The default value is 3205. NOTE: A listening port resides on the database server and is responsible for listening (monitoring) for incoming client connection requests and managing the traffic to the server NOTE: When a client requests a network session with a server, a listener receives the actual request.
Set Storage Array Learn Cycle This command sets the learn cycle for the battery backup unit, which enables the MD Storage Manager Software to predict the remaining battery life. Learn cycles run at set intervals, and they store the results for software analysis. Syntax set storageArray learnCycleDate (daysToNextLearnCycle=integer-literal | day= string-literal) time=HH:MM Parameters Parameter Description daysToNextLearnCycle Valid values are 0 through 7, where 0 is immediately and 7 is in seven days.
Syntax set storageArray time Parameters None. Set Unnamed Discovery Session This command enables the storage array to participate in unnamed discovery sessions. Syntax set iscsiTarget 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 an unnamed discovery sessions. Set the parameter to FALSE to turn off an unnamed discovery sessions.
The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk. The syntax for virtual disk mapping is listed separately. Syntax Applicable to One or More Virtual Disks set (allVirtualDisks | virtualDisk ["virtualDiskName"] | virtualDisks ["virtualDiskName1" ...
Parameters Parameter Description allVirtualDisks Specifies the properties for all virtual disks in the storage array. virtualDisk or virtualDisks (name) Specifies the name of the virtual disk for which to define properties. You can enter more than one virtual disk name if you use the virtualDisks parameter. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets.
Parameter Description owner Specifies the RAID controller module that owns the virtual disk. 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. Use only if you want to change the virtual disk owner. writeCacheEnabled Turns the write cache on or off. To turn on the write cache, set this parameter to TRUE.
Parameter Description segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure Command" on page 53. userLabel Specifies the new name to give an existing virtual disk. You must put quotation marks (" ") around the new virtual disk name.
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 target Specifies the name of the target virtual disk for which to define properties. You must put brackets ([ ]) around the target virtual disk name.
Syntax show iscsiInitiator iscsiSessions [iscsiInitiatorName | iscsiTargetName] Parameters Parameter Description iscsiInitiatorName The name of the iSCSI initiator for which you want to obtain session information. Enclose the iSCSI initiator name in square brackets ([ ]). iscsiTargetName The name of the iSCSI target for which you want to obtain session information. Enclose the iSCSI target name in square brackets ([ ]).
Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number. 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.
• – Product ID – Firmware level Physical disk channel information: – Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long. The physical disk information is also returned when you issue the show storageArray profile command.
Parameter Description physicalDisk or physicalDisks Identifies the enclosure and slot where the physical disk resides. You can enter enclosure IDs and slot IDs for one or several physical disks. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put parentheses around the enclosure ID values and the slot ID values. summary Returns the status, capacity, data rate, product ID, and firmware version for the specified physical disks.
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 returns a Successful status. If any firmware downloads fail, this command shows the firmware download status of each targeted physical disk.
• 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. controller Returns information about a specific RAID controller module in the storage array.
Syntax show (allControllers | controller [(0 | 1)]) NVSRAM [hostType=(hostTypeIndexLabel | host= "hostName")] Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. controller Returns information about a specific RAID controller module in the storage array.
Syntax show storageArray profile batteryAge connections defaultHostType healthStatus hostTypeTable hotSpareCoverage features time virtualDiskDistribution summary Parameters Parameter Description profile Displays all properties of the logical and physical components that comprise the storage array. The information returned takes several screens to display. NOTE: The profile parameter returns detailed information about the storage array. The information covers several screens on a display.
Parameter Description features Displays a list of the feature identifiers for all enabled features in the storage array. time Displays the current time to which both RAID controller modules in the storage array are set. virtualDiskDistrib Displays the current RAID controller module owner for each ution virtual disk in the storage array. summary Returns a concise list of information about the storage array configuration.
Parameters Parameter Description physicalDiskType Type of physical disk to use for the storage array. Valid physical disk types are SAS or SATA. The physicalDiskType parameter is not required if only one type of physical disk is in the storage array. This parameter is not required if only one type of physical disk is in the storage array. raidLevel RAID level of the disk group that contains the physical disks in the storage array. Valid RAID levels are 0, 1, 5 or 6.
Show Storage Array Host Topology This command returns storage partition topology, host type labels, and host type index for the host storage array. Syntax show storageArray hostTopology Parameters None. 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 iscsiNegotiationDefaults Parameters None. NOTE: Information returned includes RAID controller module default settings (settings that are the starting point for negotiation), and the current active settings. Example -c "show storageArray iscsiNegotiationDefaults;" Show Storage Array Pending Topology This command identifies the hosts and host groups that the storage management software discovered.
6 Physical disk location Enclosure t, slot s 7 Physical disk-relative logical block address Hex format (0x nnnnnnnn) 8 Failure Type The data is sorted first by virtual disk user label and second by the logical block address (LBA). Each entry in the table corresponds to a single sector. Syntax show storageArray unreadableSectors Parameters None. Show String This command shows a string of text from a script file. This command is similar to the echo command in the MS DOS and Linux operating systems.
Parameters None.
• Snapshot repository virtual disks • Snapshot virtual disks • Copies Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen]) [summary] Parameters Parameter Description allVirtualDisks Returns information about all virtual disks in the storage array. virtualDisk or virtualDisks Specifies the name of the specific virtual disk from which to retrieve information. You can enter more than one virtual disk name.
Parameters Parameter Description virtualDisk Name of the virtual disk running the long-running operation. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Copy This command returns information about virtual disk copy operations.
Parameter Description target Name of the target virtual disk about which to retrieve information. You must put quotation marks (" ") and brackets ([ ]) around the target virtual disk name. The target virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Copy Source Candidates This command returns information about the candidate virtual disks that you can use as the source for a virtual disk copy operation. Syntax show virtualDiskCopy sourceCandidates Parameters None.
Syntax show diskGroup [diskGroupNumber] importDependencies [cancelImport=(TRUE | FALSE)] Parameters Parameter Description diskGroup The number of the disk group for which you want to show information. Enclose the disk group number in square brackets ([ ]) cancelImport The setting to spin the physical disks back down after the disk group dependencies have been read. To spin down the physical disks, set this parameter to TRUE. To let the physical disks stay spinning, set this parameter to FALSE.
Parameters Parameter Description allVirtualDisks Returns performance statistics for all of the virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which you are retrieving performance statistics. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name.
Start Disk Group Blink This command identifies the physical disks that are logically grouped together to form the specified disk group by blinking the indicator LEDs on the physical disks. (Use the stop diskGroup blink command to turn off the indicator LEDs on the physical disks.) Syntax start diskGroup [diskGroupNumber] blink Parameter Parameter Description diskGroup Number of the disk group to identify. You must put brackets ([ ]) around the disk group number.
Syntax start enclosure [enclosureID] blink Parameter Parameter Description enclosure Identifies the enclosure to blink. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. Start iSCSI DHCP Refresh This command initiates a refresh of the DHCP parameters for the iSCSI interface. If the configuration method for the interface is not set to DHCP, the procedure returns an error.
faultDiagnostics {testDevices=[all | controller=(0 | 1) | emms=[trayID1 (left | right), ... trayIDn (left | right)] | physicalDisks=[trayID1, slotID1, ... , trayIDn, slotIDn]] | dataPattern=(fixed | pseudoRandom) | patternNumber=[(0xhexadecimal | integerLiteral)] | maxErrorCount=integer | testIterations=integer | timeout=timeInterval} Parameters Parameter Description controller The identifier letter of the RAID controller module that you want to test.
NOTE: Use the save physicalDiskChannel faultDiagnostics command and the stop physicalDiskChannel faultDiagnostics command in association with the start physicalDiskChannel faultDiagnostics command. These commands are needed to save the diagnostic test results to a file and to stop the diagnostic test. NOTE: You can stop this command at any time by pressing Ctrl+C. Start Physical Disk Blink This command identifies a physical disk by turning on the indicator LED on the physical disk.
Start Physical Disk Reconstruction This command starts reconstructing a physical disk. Syntax start physicalDisk [enclosureID,slotID] reconstruct Parameters Parameter Description physicalDisk Identifies the enclosure and slot where the physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value.
The export command prepares a disk group so that it can be moved from one enclosure to another. The disk group is in the Exported state and is unavailable for use once the command has been successfully run. 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.
Stop Disk Group Blink This command turns off the indicator LED on the physical disk that were turned on by the start diskGroup blink command. Syntax stop diskGroup blink Parameters None. Stop Enclosure Blink This command turns off the indicator LED on the enclosure that were turned on by the start enclosure blink command. Syntax stop enclosure blink Parameters None.
Syntax stop physicalDisk blink Parameters None. Stop Physical Disk Channel Fault Isolation Diagnostics This command stops the physical disk channel fault isolation diagnostics, which stops the start physicalDiskChannel fault isolation diagnostics command before it completes. See the "Start Physical Disk Channel Fault Isolation Diagnostics" on page 224. Syntax stop physicalDiskChannel faultDiagnostics Parameters None. Stop Snapshot This command stops a copy-on-write operation.
Stop Storage Array Blink This command turns off the indicator LED on the storage array that were turned on by the start storageArray blink command. Syntax stop storageArray blink Parameters None. Example -c "stop storageArray iscsiSession [5];" 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 command.
Parameters Parameter Description target Name of the target virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the target virtual disk name. source Name of the source virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the source virtual disk name.
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.
//Note: For disk groups that use all available capacity, the last virtual disk on the disk group is created using all remaining capacity by omitting the capacity=virtualDiskCapacity parameter create virtualDisk diskGroup=1 raidLevel=5 userLabel="7" owner=0 segmentSize=16 capacity=2GB; show "Setting additional attributes for virtualDisk 7"; //Configuration settings that cannot be set during virtualDisk creation set virtualDisk["7"] mediaScanEnabled=false; set virtualDisk["7"] consistencyCheckEnabled= false;
The command in this example creates a new virtual disk in disk group 1. The virtual disk has a redundant array of independent disks (RAID) level of 5. The virtual disk name (user label) is 7. (Note the quotation marks around the 7. The quotation marks indicate that the information in the marks is a label.) The new virtual disk is assigned to the RAID controller module in slot 0 in the RAID enclosure. The segment size is set to 16.
Configuration Script Example 2 This example creates a new virtual disk using the create virtualDisk command with user-defined physical disks in the storage array. Show "Create RAID 5 Virtual Disk 2 on existing Disk Group 2"; //This command creates the disk group and the initial virtual disk on that group.
The following syntax is the general form of the create virtualDisk command shown in the previous example: create virtualDisk raidLevel=(0 | 1 | 5 | 6) userLabel="virtualDiskName" physicalDisks= (enclosureID0,slotID0...
Sample Script Files
Index A activate storage array firmware, 114 adding comments to a script, 41 assigning global hot spares, 59 autoconfigure storage array, 115 autoconfigure storage array hot spares, 116 CLI commands, 16 usage examples, 27 clocks, RAID controller module, synchronizing, 95 collecting physical disk data, 98 command formatting rules, 106 command line interface, how to use, 14 command line parameters, 18 C changing RAID controller module ownership, 101 RAID level, 97 segment size, 97 Snapshot Virtual Disk sett
configure (continued) create RAID virtual disk, free capacity base select, 128 create RAID virtual disk, manual physical disk select, 130 storage array, 44 storage partitioning, 88 copying virtual disk, 81 create disk group, 120 host, 122 host group, 123 host port, 124 iSCSI initiator, 125 Snapshot Virtual Disk, 63-72 Snapshot virtual disk, 133 virtual disk, 48-52 Virtual Disk Copy, 78, 137 create RAID virtual disk automatic physical disk select, 126 free capacity base select, 128 manual physical disk selec
E enable RAID controller module, 151 storage array feature key, 151 Virtual Disk Copy, 64, 79 enclosure commands, 109 enclosure loss protection, 52 enclosure management module firmware download, 146 host port create host port, 124 delete host port, 141 set, 179 show host ports, 205 hot spare assigning global hot spares, 59 set physical disk hot spare, 182 how to use the command line interface, 14 exit status, 25 I F initializing physical disk, 101 virtual disk, 102 foreign physical disk set to native,
M media scan, running, 91 modifying configuration, 55 monitoring performance, 96 P partitioning, storage, 88 performance tuning, 95 persistent reservations, removing, 94 physical disk commands, 110 download firmware, 147 initializing, 101 locating, 95 reconstructing, 102 reviving, 163 set commands, 182-183 set state, 183 show commands, 205-208 start, 226-227 stop blink, 229 RAID controller module (continued) enabling RAID controller module data, 94 reset, 94, 160 saving NVSRAM values, 165 set, 183 setting
repair virtual disk consistency, 160 reset RAID controller module, 160 storage array battery install date, 161 storage array virtual disk distribution, 162 reset a RAID controller module, 94 reset storage array iSCSI baseline, 162 reset storage array SAS PHY baseline, 162 save (continued) storage array SAS PHY Counts, 169 storage array state capture, 170 storage array support data, 170 save storage array iSCSI statistics, 168 saving RAID controller module NVSRAM values, 165 script command structure, 30 syn
set disk group, 173 set enclosure attribute, 174 set host, 176 set host port, 179 set iSCSI initiator, 179 set iSCSI target properties, 180 set storage array ICMP response, 193 set storage array iSNS server IPv4 address, 194-195 set storage array iSNS server IPv6 address, 195 set storage array iSNS server listening port, 195 set storage array iSNS server refresh, 196 set storage array learn cycle, 197 set storage array time, 197 set unnamed discovery session, 198 setting controller clocks, 57 modification p
SMcli commands, 16 snapshot commands, 111 names, 72 virtual disks, 89 Snapshot Virtual Disk creating, 64-72 deleting, 76 enabling, 64 restarting, 75 stopping, 74-75 snapshot virtual disk creating, 66 re-creating, 76 start disk group blink, 223 disk group defragment, 223 enclosure blink, 223 physical disk blink, 226 physical disk initialize, 226 physical disk reconstruction, 227 storage array blink, 227 virtual disk initialization, 228 start disk group import, 227 Start Disk Group Import/Export, 227 start iS
T troubleshooting storage array, 98 U user-defined parameters, 70 V virtual disk check consistency, 117 commands, 113 copying, 81 creating in an existing disk group, 51 creating with software-assigned physical disks, 50 creating with user-assigned physical disks, 48 initializing, 102 246 Index virtual disk (continued) recopy, 86 recopy virtual disk, 152 recopying, 84 redistributing, 103 repair consistency, 160 set, 198 show commands, 217-222 Virtual Disk Copy command, 113 show, 219 stop, 231 viewing pr
