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 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 Re-creating the Snapshot Virtual Disk . . . . . . 75 Preparing Host Servers to Re-create a Snapshot Virtual Disk . . . . . . . . . . . . . . . 75 . . . . . . . . 76 Stopping and Deleting a Snapshot Virtual Disk Re-creating a Snapshot Virtual Disk 5 73 Using the Virtual Disk Copy Feature Creating a Virtual Disk Copy . . . . 77 . . . . . . . . . . . . . . 78 Enabling the Virtual Disk Copy Feature . . . . . . . . . . 79 . .
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 . . . . . . . . . . . . . . . 108 Commands Listed by Function . . . . . . . . . . . . . 109 . . . . . . . . . . . . . . . . . . 109 Host Topology Commands iSCSI Commands Physical Disk Commands . . . . . . . . . . . . . . Session Command 110 . . . . . . . . 111 . . .
Create RAID Virtual Disk (Automatic Physical Disk Select) . . . . . . . . . . . . . . . . . . Create RAID Virtual Disk (Free Capacity Base Select) . . . . . . . . . . . . . . . . . 123 . . . . . . 126 Create RAID Virtual Disk (Manual Physical Disk Select) . . . . . . . . . . . . . . . . . Create Snapshot Virtual Disk . 128 131 . . . . . . . . . . . . . . 135 . . . . . . . . . . . . . . . . . 137 . . . . . . . . . . . . . . . . . . . . .
Reset Storage Array SAS PHY Baseline . . . . . . . . . 159 . . . . . . . . . . . . . . . . . 160 Reset Storage Array Virtual Disk Distribution Revive Disk Group 159 Revive Physical Disk . . . . . . . . . . . . . . . . Save Physical Disk Log . 160 . . . . . . . . . . . . . 161 . . . . . . . . . . . . . . 161 Save Enclosure Log Data . . . . . 162 . . . . . . . . . 162 . . . . . . . . . . . . 163 Save RAID Controller Module NVSRAM .
Set Storage Array iSNS Server Listening Port . . . . . . . . . . . . . . . . . . . . . . . . . 187 . . . . . . 188 . . . . . . . . . . . . . . 188 Set Storage Array iSNS Server Refresh Set Storage Array Time . . . . . . . . . . 188 . . . . . . . . . . . . . . . . . . . 189 Set Unnamed Discovery Session Set Virtual Disk Set Virtual Disk Copy . . . . . . . . . . . . . . . . 194 Show Disk Group . . . . . . . . . . . . . . . . . . 195 Show Host Ports . . . . . . . . . . . . . . . . . .
Start Enclosure Blink . . . . . . . . . . . . . . 215 . . . . . . . . . . . . . . 216 Start iSCSI DHCP Refresh Start Physical Disk Blink Start Physical Disk Initialize Start Storage Array Blink . . . . . . . . 217 . . . . . . . . . . . . . 217 Start Virtual Disk Initialization . . . . . . . . . . . 217 . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . 218 . . . . . . . . . . . . . . . . . 218 Stop Disk Group Blink Stop Enclosure Blink . . . . . . . . . . . . . . 219 .
Contents
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 204) • show controller NVSRAM ("Show RAID Controller Module NVSRAM" on page 201) • show storageArray unreadableSectors ("Show Storage Array Unreadable Sectors" on page 207) • show virtualDiskCopy sourceCandidates ("Show Virtual Disk Copy Source Candidates" on page 212) • 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 189). 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.
"Set Enclosure Attribute" on page 170 "Set Enclosure Identification" on page 171 "Start Enclosure Blink" on page 215 "Stop Enclosure Blink" on page 218 Host Topology Commands "Create Host" on page 120 "Create Host Group" on page 121 "Create Host Port" on page 121 "Delete Host" on page 138 "Delete Host Group" on page 138 "Delete Host Port" on page 139 "Set Host" on page 171 "Set Host Group" on page 173 "Set Host Port" on page 174 "Show Host Ports" on page 196 iSCSI Commands "iSCSI Commands" on page 109 "De
"Set Storage Array iSNS Server IPv4 Address" on page 185 "Set Storage Array iSNS Server IPv6 Address" on page 186 "Set Storage Array iSNS Server Refresh" on page 188 "Set Unnamed Discovery Session" on page 188 "Show Current iSCSI Sessions" on page 194 "Show Storage Array Negotiation Defaults" on page 206 "Show Unconfigured iSCSI Initiators" on page 208 "Start iSCSI DHCP Refresh" on page 215 "Stop iSCSI Session" on page 218 Physical Disk Commands "Clear Physical Disk Channel Statistics" on page 118 "Downloa
RAID Controller Module Commands "Diagnose RAID Controller Module" on page 141 "Enable RAID Controller Module" on page 149 "Reset RAID Controller Module" on page 157 "Save RAID Controller Module NVSRAM" on page 162 "Set Controller" on page 166 "Show RAID Controller Module" on page 200 "Show RAID Controller Module NVSRAM" on page 201 Session Command "Set Session" on page 179 Show String Command "Show String" on page 208 Snapshot Commands "Create Snapshot Virtual Disk" on page 131 "Re-create Snapshot" on pa
"Download Storage Array Firmware/NVSRAM" on page 146 "Download Storage Array Physical Disk Firmware" on page 148 "Download Storage Array NVSRAM" on page 147 "Enable Storage Array Feature Key" on page 149 "Reset Storage Array Battery Install Date" on page 158 "Reset Storage Array Virtual Disk Distribution" on page 159 "Save Storage Array Configuration" on page 162 "Save Storage Array Events" on page 163 "Save Storage Array Performance Statistics" on page 165 "Save Storage Array SAS PHY Counts" on page 165 "S
Virtual Disk Commands "Check Disk Consistency" on page 117 "Clear Virtual Disk Reservations" on page 119 "Create RAID Virtual Disk (Automatic Physical Disk Select)" on page 123 "Create RAID Virtual Disk (Free Capacity Base Select)" on page 126 "Create RAID Virtual Disk (Manual Physical Disk Select)" on page 128 "Delete Virtual Disk" on page 140 "Recover RAID Virtual Disk" on page 151 "Remove Virtual Disk LUN Mapping" on page 156 "Repair Virtual Disk Consistency" on page 157 "Set Virtual Disk" on page 189 "S
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" ... "hostNamen") Parameters Parameter Description allHosts Selects all hosts identified by show storageArray pendingTopology.
physical disk types, RAID levels, virtual disk information, and hot spare information. (This list corresponds to the parameters for the autoConfigure storageArray command.) The RAID controller modules audit the storage array and then determine the highest RAID level that the storage array can support and the most efficient virtual disk definition for the RAID level. If the configuration described by the returned list is acceptable, enter the autoConfigure storageArray command without any parameters.
Parameter Description 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. virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group. Use integer values. hotSpareCount Number of hot spares in the storage array. Use integer values.
Check Disk Consistency This command checks a virtual disk for consistency and media errors, and writes the results of the check to a file. Syntax check virtualDisk [virtualDiskName] consistency [consistencyErrorFile=filename] [mediaErrorFile= filename] [priority=(highest | high | medium | low | lowest)] [verbose=(TRUE|FALSE)] Parameters Parameter Description virtualDisk Name of the specific virtual disk to check consistency. You must put brackets ([ ]) around the virtual disk name.
Clear Physical Disk Channel Statistics This command resets the statistics for all physical disk channels. Syntax clear allPhysicalDiskChannels stats Parameters None. Clear Storage Array Configuration This command clears the entire configuration from the RAID controller modules in a storage array. Information that defines all disk groups, virtual disks, and hot spares is deleted. Use this command to create a new configuration on a storage array that already has a configuration defined.
Clear Storage Array Firmware Pending Area This command deletes a previously downloaded firmware image or nonvolatile static random access memory (NVSRAM) values from the pending area buffer. NOTICE: As soon as you run this command, the contents of the existing pending area in the storage array are deleted. Syntax clear storageArray firmwarePendingArea Parameters None. Clear Virtual Disk Reservations This command clears persistent virtual disk reservations.
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Create Host This command creates a new host. 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.
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. Example -c create host userLabel= \"job2900\";" Create Host Group This command creates a new host group.
Syntax create hostPort identifier="wwid" userLabel= "portLabel" host="hostName" Parameters Parameter Description identifier WWID of the HBA host port. You must put quotation marks (" ") around the WWID. userLabel Name to give the new HBA host port. You must put quotation marks (" ") around the port label. host Name of the host for which you are defining an HBA host port. You must put quotation marks (" ") around the host name.
Parameters Parameter Description iscsiName The default identifier of the iSCSI initiator. userLabel The name that you want to use for the iSCSI initiator. Enclose the name in double quotation marks (“ ”). host The name of the host in which the iSCSI initiator is installed. chapSecret The password that you want to use to authenticate a peer connection. NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection.
Parameters Parameter Description physicalDiskCount Number of unassigned physical disks to use in the disk group. NOTE: The physicalDiskCount parameter enables you to choose the number of physical disks to use in the disk group. You do not need to specify the physical disks by enclosure ID and slot ID. The RAID controller modules choose the specific physical disks to use for the disk group. raidLevel RAID level of the disk group that contains the virtual disk. Valid values are 0, 1, or 5.
Parameter Description owner 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. 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.
Create RAID Virtual Disk (Free Capacity Base Select) This command creates a virtual disk in the free space of a disk group. Syntax create virtualDisk diskGroup=diskGroupNumber userLabel="virtualDiskName" [freeCapacityArea= freeCapacityIndexNumber capacity= virtualDiskCapacity owner=(0 | 1) segmentSize= segmentSizeValue] Parameters Parameter Description diskGroup Sequence number of the disk group in which to create the new virtual disk.
Parameter Description freeCapacityArea Index number of the free space in an existing disk group to use to create the new virtual disk. Free capacity is defined as the free capacity between existing virtual disks in a disk group. For example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity.
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 repositoryPhysicalDiskCount= numberOfPhysicalDisks physicalDiskType=(SAS | SATA) userLabel= "sna
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.
offset=offsetValue raidLevel=(0 | 1 | 5) segmentSize=segmentSizeValue [owner=(0 | 1)] Parameters Parameter Description physicalDisk or physicalDisks Specifies the physical disks to assign to the virtual disk that you want to create. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and the slot ID value.
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. For information about the owner parameter, see "Creating Virtual Disks with User-Assigned Physical Disks" on page 48.
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. userLabel Name of the snapshot virtual disk. You must put quotation marks (" ") around the snapshot virtual disk name.
Snapshot will process the specified snapshot virtual disks as a batch, provided a validation check of all of the virtual disks runs successfully. If successful, the snapshots start the re-creation process and all of the affected virtual disks (snapshot, source, and repository) are quiesced until the process is complete.
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.
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. If one RAID controller module resets but the second RAID controller module does not reset, the host is informed that the RAID controller modules are out of synchronization.
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. Revive Disk Group This command forces the specified disk group and associated failed physical disks to the Optimal state.
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.
Save RAID Controller Module NVSRAM This command saves a copy of the RAID controller module NVSRAM values to a file. This command saves all regions. Syntax save controller [(0 | 1)] NVSRAM file="filename" 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.
Parameter Description allConfig Saves all of the configuration values to the file. (If you choose this parameter, all of the configuration parameters are set to TRUE.) globalSettings Saves the global settings to the file. To save the global settings, set this parameter to TRUE. To prevent saving the global settings, set this parameter to FALSE. The default value is TRUE. virtualDiskConfigAndSe Saves the virtual disk configuration settings and all of the global settings to the file.
Parameters Parameter Description allEvents | criticalEvents Specifies whether to save all events (allEvents) or only the critical events (criticalEvents). file Name of the file to which to save the events. You must put quotation marks (" ") around the file name. 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.
Parameter Description file The name of the file to which you want to save the performance statistics. Enclose the file name in double quotation marks (“ ”). NOTE: If you have not reset the iSCSI baseline statistics since the RAID controller module start-of-day, the time at the start-of-day is the default baseline time. NOTE: This command does not automatically append a file extension to the new file. You must specify the file extension when you enter the file name.
Parameters Parameter Description file Name of the file to which to save the storage array SAS PHY counters. You must put quotation marks (" ") around the file name. 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.
Syntax set controller [(0 | 1)] availability=(online | offline | serviceMode) | bootp | ethernetPort [1] = ethernet-port-options globalNVSRAMByte [nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | hostNVSRAMByte [hostType, nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | iscsiHostPort [(1 | 2)] = iscsi-host-port-options rloginEnabled=(TRUE | FALSE) | serviceAllowedIndicator=(on | off) Parameters Parameter Description controller This parameter is the RAID controller module for which you want
Parameter Description globalNVSRAMByte This parameter modifies a portion of the RAID controller module NVSRAM. Specify the region to be modified using the starting byte offset within the region, and the size and value of the new data to be stored into NVSRAM. hostNVSRAMByte This parameter updates the NVSRAM for the host specific region. Specifies the host index for the specific host, the starting offset within the region, the number of bytes, and the values to be written.
Examples -c "set controller [0] iscsiHostPort[0] IPV6LocalAddress= FE80:0000:0000:0000:0214:22FF:FEFF:EFA9 enableIPV6= TRUE;" -c "set controller [0] iscsiHostPort[0] IPV6ConfigurationMethod=auto enableIPV6=TRUE;" -c "set controller [0] availability=online;" -c "set controller [0] ethernetPort[1] IPV4Address=192.168.0.101;" -c "set controller [0] iscsiHostPort[1] IPV4SubnetMask=255.255.255.0 enableIPV4;" -c "set controller [0] iscsiHostPort[1] IPV4GatewayIP=192.168.0.
Parameter Description owner RAID controller module that owns the disk group. 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. availability Sets the disk group online or offline. NOTE: When using this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters.
Parameter Description assetTag Asset tag name or number to give the new enclosure. Asset tags can be any combination of alphanumeric characters with a maximum length of ten characters. Alphabetical characters can be uppercase or lowercase. You can also use the underscore character (_) and the hyphen (-) character. You cannot use spaces in an asset tag name. You must put quotation marks (" ") around the asset tag name.
Syntax set host [hostName] hostGroup=(“hostGroupName” | none | defaultGroup) userLabel=“newHostName” hostType=(hostTypeIndexLabel | hostTypeIndexNumber) 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.
Host Group Parameter Host Has Individual Virtual Disk-to-LUN Mappings Host Does Not Have Individual Virtual Disk-to-LUN Mappings none The host is removed from the host group as an independent partition and is placed under the root node. The host is removed from the present host group and is placed under the default group. defaultGroup The command fails. The host is removed from the present host group and is placed under the default group.
Parameters Parameter Description hostGroup Name of the host group to rename. You must put brackets ([ ]) around the host group name. If the host group name has special characters, you must also put quotation marks (" ") around the host group name. userLabel New name for the host group. 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.
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 iSCSI Initiator This command sets the attributes for an iSCSI initiator.
-c "set iscsiInitiator <\"iqn.199105.com.microsoft:svctag-70wnh91\"> userLabel= \"29000\";" -c "show iscsiInitiator[\"pe29000\"] iscsiSessions;" -c "show iscsiInitiator <\"iqn.199105.com.microsoft:svctag-70wnh91\"> iscsiSessions;" Set iSCSI Target Properties This command defines properties for an iSCSI target.
NOTE: The targetAlias is a descriptive name that you can give to the target to help make it easier to identify. You can use any combination of alphanumeric characters, hyphens, and underscores for the targetAlias. The targetAlias can have a maximum of 30 characters. Examples -c "set iscsiTarget <\"iqn.198405.com.dell:powervault. 6001372000f5f0e600000000463b9292\"> authenticationMethod = none;" -c "set iscsiTarget [\"iscsi2900\"] targetAlias = \"iscsi2902\";" -c "set iscsiTarget <\"iqn.198405.com.
Parameter Description status Condition of the channel. You can set the channel status to optimal or degraded. NOTE: Use the optimal parameter to move a degraded channel back to the Optimal state. Use the degraded parameter if the channel is experiencing problems, and the storage array requires additional time for data transfers. Set Physical Disk Hot Spare This command assigns or unassigns one or more physical disks as a hot spare.
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. Set Session This command defines how you want the current script engine session to run.
Parameter Description performanceMonitorInterval Specifies how frequently to gather performance data. Enter an integer value for the polling interval, in seconds, for which you want to capture data. The range of values is 3 to 3600 seconds. The default value is 5 seconds. NOTE: The polling interval you specify remains in effect until you end the session. After you end the session, the polling interval returns to the default values. performanceMonitorIterations Specifies the number of samples to capture.
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. The snapshot virtual disk name and quotation marks must be inside the brackets. userLabel New name to give to a snapshot virtual disk.
Set Storage Array This command defines the properties of the storage array. Syntax set storageArray cacheBlockSize= cacheBlockSizeValue defaultHostType= ("hostTypeName" | hostTypeIdentifier) failoverAlertDelay=delayValue | mediaScanRate=(disabled | 1-30) | password="password" | userLabel="storageArrayName" Parameters Parameter Description cacheBlockSize Specifies the cache block size used by the RAID controller module for managing the cache.
Parameter Description defaultHostType Specifies the default host type of any unconfigured HBA host port to which the RAID controller modules are connected. To generate a list of valid host types for the storage array, enter the show storageArray hostTypeTable command. Host types can be identified by a name or numerical index. You must put quotation marks (" ") around the host type name. Do not put quotation marks around the host type numerical identifier.
NOTE: When using this command, you can specify one or more of the optional parameters. You do not, however, need to use all of the parameters. Set Storage Array Enclosure Positions This command defines the position of the enclosures in a storage array. You must include all enclosures in the storage array when you enter this command. Syntax set storageArray enclosurePositions=(enclosure-idlist) Parameters Parameter Description enclosurePositions List of enclosure IDs.
Parameter Parameter Description icmpPingResponse This parameter turns on or turns off Echo Request messages. Set the parameter to TRUE to turn on Echo Request messages. Set the parameter to FALSE to turn off Echo Request messages. NOTE: The Internet Control Message Protocol (ICMP) is used by operating systems in a network to send error messages, such as a requested service is not available or that a host or router could not be reached.
Parameters Parameter Description isnsIPV4Configuration Method The method that you want to use to define the iSNS server configuration. You can enter the IP address for the IPv4 iSNS servers by selecting static. For IPv4, you can choose to have a Dynamic Host Configuration Protocol (DHCP) server select the iSNS server IP address by entering dhcp. To enable DCHP, you must set the isnsIPV4Address IP address to 0.0.0.0. isnsIPV4Address The IP address that you want to use for the iSNS server.
Parameter Parameter Description isnsIPV6Address IPv6address you want to use for the iSNS server NOTE: The iSNS protocol facilitates the automated discovery, management, and configuration of iSCSI and Fibre Channel devices on a TCP/IP network. The iSNS protocol provides intelligent storage discovery and management services comparable to those found in Fibre Channel networks, allowing a commodity IP network to function in a similar capacity as a storage area network.
Set Storage Array iSNS Server Refresh This command refreshes the network address information for the iSNS server. This command is valid for only IPv4. Syntax set storageArray isnsServerRefresh Parameters None. NOTE: If the DHCP server is not operating at full capability, or if the DHCP server is unresponsive, the refresh operation can take between two and three minutes to complete. NOTE: The set storageArray isnsServerRefresh command returns an error if you did not set the configuration method to DHCP.
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. NOTE: Discovery is the process where initiators determine the targets that are available.
low | lowest)owner=(0 | 1) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) NOTE: Enabling Write Cache on a virtual disk generally improves performance for applications with significant Write content (unless the application features a continuous string of Writes. However, Write Cache does introduce some risk of data loss in the unlikely event of a controller failure.
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.
Parameters Parameter Description allPhysicalDisks Returns information about all physical disks in the storage array. NOTE: To determine information about the type and location of all physical disks in the storage array, use the allPhysicalDisks parameter. physicalDiskType Specifies the type of physical disk for which to retrieve information. Valid physical disk types are SAS or SATA.
Syntax show (physicalDiskChannel [(1 | 2 )] | physicalDiskChannels [(1 | 2 ) ... (1n | 2n )] | allPhysicalDiskChannels) stats Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to display information. Valid physical disk channel values are 1 or 2. You must put brackets ([ ]) around the physical disk channel values.
Show RAID Controller Module For each RAID controller module in a storage array, this command returns the following information: • Status (Online, Offline) • Current firmware and NVSRAM configuration • Pending firmware and NVSRAM configuration configurations (if any) • Board ID • Product ID • Product revision • Serial number • Date of manufacture • Date and time to which the RAID controller module is set • Associated virtual disks (including preferred owner) • Ethernet port • Physical
Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. controller Returns information about a specific RAID controller module in the storage array. Valid RAID controller module 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.
Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. controller Returns information about a specific RAID controller module in the storage array. Valid RAID controller module 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.
Parameters Parameter Description profile Displays all properties of the logical and physical components that comprise the storage array. The information returned takes several screens to display. NOTE: The profile parameter returns detailed information about the storage array. The information covers several screens on a display. You might need to increase the size of your display buffer to see all the information.
Parameter Description 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. NOTE: When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery.
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, or 5.
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 (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen] performanceStats 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.
Parameters Parameter Description allVirtualDisks Returns reservation information about all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which you are retrieving reservation information. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name.
Parameters Parameter Description diskGroup Number of the disk group to defragment. You must put brackets ([ ]) around the disk group number. Start Enclosure Blink This command identifies an enclosure by turning on the indicator LED. (Use the stop enclosure blink command to turn off the indicator LED for the enclosure.) Syntax start enclosure [enclosureID] blink Parameters Parameter Description enclosure Identifies the enclosure to blink. Enclosure ID values are 0 to 99.
NOTE: This operation ends the iSCSI connections for the portal and brings down the portal temporarily. Start Physical Disk Blink This command identifies a physical disk by turning on the indicator LED on the physical disk. (Use the stop physicalDisk blink command to turn off the indicator LED on the physical disk.) Syntax start physicalDisk [enclosureID,slotID] blink Parameters Parameter Description physicalDisk Identifies the enclosure and slot where the physical disk resides.
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.
Parameters Parameter Description virtualDisk Name of the virtual disk for which to start the formatting. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Stop 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.
Parameter Parameter Description integer The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]). Stop Physical Disk Blink This command turns off the indicator LED on the physical disk that were turned on by the start physicalDisk blink command. Syntax stop physicalDisk blink Parameters None. Stop Snapshot This command stops a copy-on-write operation. Syntax stop snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ..
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.
Script Commands
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) 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, 114 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, manual physical disk select, 128 storage array, 44 storage partitioning, 88 copying virtual disk, 81 create host, 120 host group, 121 host port, 121 Snapshot Virtual Disk, 63-72 Snapshot virtual disk, 131 virtual disk, 48-52 Virtual Disk Copy, 78, 135 create iSCSI initiator, 122 create RAID virtual disk automatic physical disk select, 123 free capacity base select, 126 manual physical disk select, 128 creating snapshot virtual disk, 66 Virtual Disk Copy, 79 D
enclosure commands, 108 I enclosure loss protection, 52 initializing physical disk, 101 virtual disk, 102 exit status, 25 F formatting considerations, 24 H host create host, 120 delete host, 138 show storage array host topology, 206 topology commands, 109 interaction with other features, 88 ISCSI recurring syntax values, 39 iSCSI commands, 109 L locating physical disks, 95 host group create host group, 121 delete host group, 138 set host group, 173 M host port create host port, 121 delete host po
physical disk commands, 110 download firmware, 145 initializing, 101 locating, 95 reconstructing, 102 reviving, 160 set commands, 177-179 set state, 178 show commands, 196-199 start, 216-217 stop blink, 219 R RAID controller module changing ownership, 101 clocks, synchronizing, 95 commands, 111 diagnosing, 99, 141 enable RAID controller module, 149 enabling RAID controller module data, 94 reset, 94, 157 saving NVSRAM values, 162 setting operational mode, 100 show, 200 RAID level, changing, 97 reconstructin
running media scan, 91 redundancy check, 93 S save configuration to a file, 47 enclosure log data, 161 physical disk log, 161 storage array, 162-166 set (continued) Snapshot Virtual Disk, 180 storage array, 182 storage array enclosure positions, 184 storage array time, 188 virtual disk, 189 Virtual Disk Copy, 194 set controller, 166 set host, 171 set host port, 174 save storage array iSCSI statistics, 164 set iSCSI initiator, 175 saving RAID controller module NVSRAM values, 162 set storage array ICMP
show disk group, 195 host ports, 196 physical disk, 196 physical disk channel statistics, 198 physical disk download progress, 199 RAID controller module, 200 RAID controller module NVSRAM, 201 storage array autoconfigure, 204 storage array command, 202 storage array host topology, 206 storage array LUN mappings, 206 storage array unreadable sectors, 207 string, 111, 208 unconfigured iSCSI initiators, 208 virtual disk, 209 virtual disk action progress, 210 Virtual Disk Copy, 211 Virtual Disk Copy source can
stop iSCSI session, 218 U storage array accept pending topology, 114 commands, 111 disable, 144 download commands, 146-149 save commands, 162-166 set commands, 182-188 show commands, 202-208 show host topology, 206 show LUN mappings, 206 show pending topology, 207 show unreadable sectors, 207 start blink, 217 stop blink, 220 user-defined parameters, 70 storage partitioning, 88 support.dell.
Index
