Page 1 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 . c o m...
Page 2 Reproduction in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell, the DELL logo, and PowerVault are trademarks of Dell Inc.; Microsoft, Internet Explorer, and Windows are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other countries.
Page 3: Table Of Contents
Contents About the Command Line Interface ..How to Use the Command Line Interface ..Usage Notes ....CLI Commands .
Page 4 Configuring a Storage Array ..Configuring a Storage Array ....Determining What is on Your Storage Array .
Page 5 Changing Snapshot Virtual Disk Settings ..Stopping and Deleting a Snapshot Virtual Disk ..Re-creating the Snapshot Virtual Disk ..Preparing Host Servers to Re-create a Snapshot Virtual Disk .
Page 6 Maintaining a Storage Array ..Routine Maintenance ....Running a Media Scan ....Running a Consistency Check .
Page 7 Script Commands ....Command Formatting Rules ....Commands Listed by Function .
Page 8 Create RAID Virtual Disk (Automatic Physical Disk Select) ..... Create RAID Virtual Disk (Free Capacity Base Select) ....Create RAID Virtual Disk (Manual Physical Disk Select) .
Page 9 Reset Storage Array SAS PHY Baseline ..Reset Storage Array Virtual Disk Distribution . . . Revive Disk Group ....Revive Physical Disk .
Page 10 Set Storage Array iSNS Server Listening Port ......Set Storage Array iSNS Server Refresh ..Set Storage Array Time .
Page 11 Start Enclosure Blink ....Start iSCSI DHCP Refresh ... . . Start Physical Disk Blink .
Page 12 Contents...
Page 13: About The Command Line Interface
For additional information, see the hardware and software manuals that shipped with your system. NOTE: Always check for updates on support.dell.com and read the updates first because they often supersede information in other documents. NOTE: CLI commands do not have interactive warnings for destructive commands.
Page 14: How To Use The Command Line Interface
You can use the command line interface to perform the following functions: • Directly access the script engine and run commands in interactive mode or using a script file. • Create script command batch files to be run on multiple storage arrays when you need to install the same configuration on different storage arrays.
Page 15: Usage Notes
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...
Page 16: Cli Commands
CLI Commands This section lists the CLI commands you can use to perform the following functions: • Identify storage arrays. • Set passwords. • Add storage arrays. • Specify communication parameters. • Enter individual script configuration commands. • Specify a file containing script configuration commands. The following are general forms of the CLI commands, showing the parameters and terminals used in each command.
Page 17 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...
Page 18: Command Line Parameters
Command Line Parameters Table 1-2. Command Line Parameters Parameter Definition host-name-or-IP-address Specify either the host name or the Internet Protocol (IP) address of an in-band managed storage array (IPv4 or iPv6) or an out-of-band managed storage array (IPv4 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.
Page 19 Table 1-2. Command Line Parameters (continued) Parameter Definition Use to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command by using a semicolon (;). You cannot place more than one -c parameter on the same command line.
Page 20 Table 1-2. Command Line Parameters (continued) Parameter Definition 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: •...
Page 21 Table 1-2. Command Line Parameters (continued) Parameter Definition Use to specify the name of the storage array on which to run the script commands. This name is optional when you use host-name-or-IP-address; however, if you are using the in-band method for managing the storage array, you must use the -n parameter if more than one storage array is connected to the host at the specified address.
Page 22 Table 1-2. Command Line Parameters (continued) Parameter Definition 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.
Page 23 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.) This parameter suppresses the following messages: • Performance syntax check •...
Page 24: Formatting Considerations
Formatting Considerations Quotation marks (" ") used as part of a name or label require special ® consideration when you run the CLI and script commands on a Microsoft ® Windows operating system. The following explains the use of quotation marks in names while running CLI and script commands on Windows.
Page 25: Exit Status
When the CLI encounters either type of error, it writes information describing the error directly to the command line and sets a return code. Depending on the return code, the CLI might also write additional information about which parameter caused the error. The CLI also writes information about what command syntax was expected to help you identify any syntax errors you might have entered.
Page 26 Table 1-3. Exit Status (continued) Status Value Meaning The storage array name was not in the configuration file. A management class does not exist for the storage array. A storage array was not found in the configuration file. An internal error occurred. Invalid script syntax was found.
Page 27: Usage Examples
Usage Examples The following examples show how to enter CLI commands on a command line. The examples show the syntax, form, and, in some examples, script commands. Examples are shown for both Windows and Linux operating systems. The usage for the -c parameter varies depending on your operating system.
Page 28 physicalDiskCount[3] raidLevel=5 capacity=10 GB userLabel="Finance"; show storageArray healthStatus;’ This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example. The -e parameter runs the file without checking syntax. Executing an SMcli command without checking syntax enables the file to run more quickly;...
Page 29: About The Script Commands
About the Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or run a file of script commands.
Page 30: Script Command Structure
Table 2-1. Configuration and Management Operations (continued) Operation Activities General storage array Resetting a configuration to defaults, labeling, configuration checking the health status, setting the time of day, clearing the Major Event Log, and setting the media scan rate NVSRAM configuration Downloading and modifying the user configuration region at the bit and byte level, displaying nonvolatile static random access memory (NVSRAM) values...
Page 31 • 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 (<...
Page 32: Script Command Synopsis
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).
Page 33 Table 2-3. General Form of the Script Commands (continued) Command Syntax Description deactivate object Removes the environment for an operation. {statement-data} delete object Deletes a previously created object. diagnose object Runs a test and displays the results. {statement-data} disable object Prevents a feature from operating.
Page 34: Recurring Syntax Elements
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.
Page 35 Table 2-4. Recurring Syntax Elements (continued) Recurring Syntax Syntax Value create-raid-virtual disk-attribute-value-pair capacity=capacity-spec | owner=(0 | 1) | segmentSize=integer-literal RAID controller module-enclosureId (0–99) slot-id (0–31) port-id (0–127) physical disk-spec enclosureID, slotID physical disk-spec-list physical disk-spec {physical disk-spec} enclosure-id-list enclosureID {enclosureID} hex-literal 0x hexadecimal-literal virtual disk-group-number...
Page 36 Table 2-4. Recurring Syntax Elements (continued) Recurring Syntax Syntax Value iscsi-host-port-options IPV4Address=ipv4-address | IPV6LocalAddress=ipv6-address | IPV6RoutableAddress=ipv6-address | IPV6RouterAddress=ipv6-address | enableIPV4= boolean | enableIPV6=boolean | enableIPV4Vlan=boolean | enableIPV6Vlan=boolean | enableIPV6Priority=boolean | enableIPV6Priority=boolean | IPV4ConfigurationMethod=(static | dhcp) | IPV6ConfigurationMethod=(static | auto) | IPV4GatewayIP= ipv4-address | IPV6HopLimit=integer | IPV6NdDetectDuplicateAddress=...
Page 37 Table 2-4. Recurring Syntax Elements (continued) Recurring Syntax Syntax Value instance-based-repository-spec repositoryRAIDLevel=repository-raid- level repositoryPhysicalDisks=(physical disk- spec-list) [enclosureLossProtect=boolean] repositoryDiskGroup=virtual-disk- group-number [freeCapacityArea=integer-literal] Specify repositoryRAIDLevel with repositoryPhysicalDisks. Do not specify RAID level or physical disks with a disk group. Do not set enclosureLossProtect when specifying a disk group.
Page 38 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).(0–255) ipv6-address (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFF) autoconfigure-vols-attr-value-list autoconfigure-vols-attr-value-pair {autoconfigure-vols-attr-value-pair} autoconfigure-vols-attr-value-pair physicalDiskType=physical disk-type| raidLevel=raid-level |...
Page 39 Table 2-4. Recurring Syntax Elements (continued) Recurring Syntax Syntax Value create-virtual-disk-copy-attr-value-list create-virtual-disk-copy-attr-value-pair {create-virtual-disk-copy-attr-value-pair} create-virtual-disk-copy-attr-value-pair copyPriority=highest | high | medium | low | lowest | targetReadOnlyEnabled=boolean recover-raid-virtual-disk-attr-value-list recover-raid-virtual-disk-attr-value-pair {recover-raid-virtual-disk-attr-value-pair} recover-raid-virtual-disk-attr-value-pair owner=(0 | 1) Table 2-5. Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values IPV4Priority...
Page 40: Usage Guidelines
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.
Page 41: Adding Comments To A Script File
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, will return an error, but will not return an error). 10GB 10 GB Adding Comments to a Script File...
Page 42 About the Script Commands...
Page 43: Configuring A Storage Array
Configuring a Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts and terminology.
Page 44: Configuring A Storage Array
command. On Windows, you must enclose the name between two backslashes (\) in addition to other delimiters. For example, the following name is used in a command that runs under Windows: [\"Engineering\"] For a Linux system when used in a script file, the name appears as: ["Engineering"] Configuring a Storage Array When you configure a storage array, you can maximize data availability by...
Page 45 The show storageArray command returns the following general information about the components and properties of the storage array: • A detailed profile of the components and features in the storage array • The battery age • The default host type (which is the current host type) •...
Page 46 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.
Page 47: Saving A Configuration To A File
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"...
Page 48: Using The Create Virtual Disk Command
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.
Page 49 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.
Page 50 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.
Page 51 Example of Creating Virtual Disks with Software-Assigned Physical Disks client>smcli 123.45.67.89 -c "create virtualDisk physicalDiskCount=3 raidLevel=5 userLabel= \"Engineering_1"\ capacity=20 GB owner=0 segmentSize=64;" The command in this example creates the same virtual disk as the previous create virtualDisk command, however, in this case the user does not know which physical disks are assigned to this disk group.
Page 52 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.
Page 53: Using The Auto Configure Command
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. When you use the autoConfigure storageArray command, define the following parameters: •...
Page 54 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.
Page 55: Modifying Your Configuration
For optimal performance in a multi-user database or file system storage environment, set the segment size to minimize the number of physical disks needed to satisfy an I/O request. Using a single physical disk for a single request leaves other physical disks available to simultaneously service other requests.
Page 56: Setting The Storage Array Password
• Storage array host type • Global hot spares NOTE: Before modifying your configuration, save a copy of your current configuration to a file (see "Saving a Configuration to a File" on page 47). If you have problems with your modifications, you can use the information in the file to restore your previous configuration.
Page 57: Setting The Raid Controller Module Clocks
By default, all alert configuration settings are None. The following example shows how to set the mail server IP and the sender address configurations for SMTP alerts: SMcli -m 123.45.67.89 -F MyStorageArrayEvent@MyCompany.com 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.89 -I eventOnly...
Page 58: Setting Modification Priority
The defaultHostType parameter defines how the RAID controller modules communicate with the operating system on undefined hosts connected to the storage array. This parameter defines the host type only for storage array data I/O activities; it does not define the host type for the management station. The operating system can be Windows or Linux.
Page 59: Assigning Global Hot Spares
• Initialization • Changing segment size • Defragmentation of a disk group • Adding free capacity to a disk group • Changing the RAID level of a disk group The lowest priority rate favors system performance, but the modification operation takes longer. The highest priority rate favors the modification operation, but the system performance might be degraded.
Page 60 You can assign or unassign global hot spares by using the set physicalDisk command. To use this command, you must perform these steps: 1 Identify the location of the physical disks by enclosure ID and slot ID. 2 Set the hotSpare parameter to TRUE to enable the hot spare or FALSE to disable an existing hot spare.
Page 61: Using The Snapshot Feature
NOTE: If you ordered Premium Features for the Snapshot Virtual Disks, you received a Premium Features Activation card shipped in the same box as your Dell ™ PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature.
Page 62 • Map the snapshot virtual disk and make it accessible to any host on a storage area network. You can make snapshot data available to secondary hosts for read and write access by mapping the snapshot to the hosts. • Create up to four snapshots per virtual disk.
Page 63: Using Host Servers To Create An Initial Snapshot Virtual Disk
This can result in data loss on the source virtual disk or an inaccessible snapshot. For details on mapping the snapshot virtual disk to the secondary node, refer to the Dell PowerEdge™ Cluster SE600W Systems Installation and Troubleshooting Guide on support.dell.com NOTE: You can create concurrent snapshots of a source virtual disk on both the source disk group and on another disk group.
Page 64: Enabling The Snapshot Virtual Disk Feature
• 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.
Page 65: Preparing Host Servers To Create An Initial 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. ®...
Page 66: Creating The Initial Snapshot Virtual Disk
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. The following syntax is the general form of the command to create a snapshot virtual disk: create snapshotVirtualDisk sourceVirtualDisk=...
Page 67: Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks
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.89 -c "create snapshotVirtualDisk sourceVirtualDisk=...
Page 68 " 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.89 -c "create snapshotVirtualDisk sourceVirtualDisk=...
Page 69: Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks
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.
Page 70: User-Defined Parameters
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...
Page 71 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.
Page 72: Names Of Snapshot Virtual Disks And Repository Virtual Disks
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 previous examples, the names for the snapshot virtual disk and repository virtual disk are defined by the user.
Page 73: Changing Snapshot Virtual Disk Settings
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.
Page 74: Stopping And Deleting A Snapshot Virtual Disk
When you change the warning threshold percent and repository full policy, you can apply the changes to one or several snapshot virtual disks. The following example uses the set (snapshot) virtualDisk command to change these properties on more than one snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisks [\"Mars_Spirit_4-1\"...
Page 75: Re-Creating The Snapshot Virtual Disk
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: •...
Page 76: Re-Creating A Snapshot Virtual Disk
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.
Page 77: Using The Virtual Disk Copy Feature
Manual. NOTE: If you ordered Premium Features for Virtual Disk Copy, you received a Premium Features Activation card shipped in the same box as your Dell ™ PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature.
Page 78: Creating A Virtual Disk Copy
Table 5-1 lists the Virtual Disk Copy commands and briefly describes what the commands do. Table 5-1. Virtual Disk Copy Commands Command Description create virtualDiskCopy Creates a virtual disk copy and starts the virtual disk copy operation. disable storageArray Turns off the current virtual disk copy operation. feature=virtualDiskCopy enable storageArray feature Activates the Virtual Disk Copy feature.
Page 79: Enabling The Virtual Disk Copy Feature
The following steps show the general process for creating a virtual disk copy: 1 Enable the Virtual Disk Copy feature. 2 Determine candidates for a virtual disk copy. 3 Create the target virtual disk and source virtual disk for a virtual disk copy. Enabling the Virtual Disk Copy Feature The first step in creating a virtual disk copy is to make sure the feature is enabled on the storage array.
Page 80: Preparing Host Servers To Create A Virtual Disk Copy
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...
Page 81: Copying The 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= "...
Page 82: Viewing Virtual Disk Copy Properties
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"...
Page 83: Changing Virtual Disk Copy Settings
The following example shows a command that returns information about a virtual disk used for a virtual disk copy: client>smcli 123.45.67.89 -c "show virtualDiskCopy source [\"Jaba_Hut\"];" The command in the preceding example requests information about the source virtual disk Jaba_Hut. If you want information about all virtual disks, use the allVirtualDisks parameter.
Page 84: Recopying A Virtual Disk
to the target virtual disk after the virtual disk copy is created. Maintain the read-only status when the following conditions apply: • You are using the target virtual disk for backup purposes • You are copying data from one disk group to a larger disk group for greater accessibility •...
Page 85: Preparing Host Servers To Recopy A Virtual Disk
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.
Page 86: Recopying The Virtual Disk
3 Remove the drive letter(s) of the source and (if mounted) virtual disk in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the virtual disk. If this is not done, the copy operation will report that it has completed successfully, but the copied data will not be updated properly.
Page 87: Stopping A Virtual Disk Copy
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"...
Page 88: Interaction With Other Features
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:...
Page 89: Snapshot Virtual Disks
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.
Page 90 Using the Virtual Disk Copy Feature...
Page 91: Maintaining A Storage Array
Maintaining a Storage Array Maintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all hosts. This chapter provides descriptions of command line interface (CLI) and script commands that you can use to perform storage array maintenance.
Page 92 scan is performed as a background operation and scans all data and consistency information in defined user virtual disks. A media scan runs on all virtual disks in the storage array with the following conditions: • An Optimal status • No modification operations in progress •...
Page 93: Running A Consistency Check
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 ...
Page 94: Resetting A Raid Controller Module
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.
Page 95: Synchronizing Raid Controller Module Clocks
To determine which virtual disks have reservations, run the following command: show (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNamen ]) reservations To clear persistent virtual disk reservations, run the following command: clear (allVirtualDisks | virtualDisk[ virtualDiskName ] | virtualDisks [ virtualDiskName1 "...
Page 96: Monitoring Performance
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.
Page 97: Changing Raid Levels
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.
Page 98: Defragmenting A Disk Group
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"...
Page 99: Diagnosing A Raid Controller Module
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 •...
Page 100: Recovery Operations
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.
Page 101: Changing Raid Controller Module Ownership
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’...
Page 102: Reconstructing A Physical Disk
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.
Page 103: Redistributing Virtual Disks
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.
Page 104 Maintaining a Storage Array...
Page 105: Script Commands
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. •...
Page 106: Command Formatting Rules
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. •...
Page 107 • 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.
Page 108: Commands Listed By Function
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.
Page 109: Host Topology Commands
"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"...
Page 110: Physical Disk Commands
"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"...
Page 111: Raid Controller Module Commands
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"...
Page 112 "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"...
Page 113: Virtual Disk Commands
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"...
Page 114: Commands Listed Alphabetically
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...
Page 115 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.
Page 116: Autoconfigure Storage Array Hot Spares
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.
Page 117: Check Disk Consistency
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...
Page 118: Clear Physical Disk Channel Statistics
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.
Page 119: Clear Storage Array Firmware Pending Area
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.
Page 120: Create Host
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.
Page 121: Create Host Group
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\";"...
Page 122: Create Iscsi Initiator
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 ("...
Page 123: Create Raid Virtual Disk (Automatic Physical Disk Select)
Parameters Parameter Description The default identifier of the iSCSI initiator. iscsiName The name that you want to use for the iSCSI initiator. Enclose userLabel the name in double quotation marks (“ ”). The name of the host in which the iSCSI initiator is installed. host The password that you want to use to authenticate a peer chapSecret...
Page 124 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.
Page 125 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.
Page 126: Create Raid Virtual Disk (Free Capacity Base Select)
Create RAID Virtual Disk (Free Capacity Base Select) This command creates a virtual disk in the free space of a disk group. Syntax create virtualDisk diskGroup= diskGroupNumber userLabel=" virtualDiskName " [freeCapacityArea= freeCapacityIndexNumber capacity= virtualDiskCapacity owner=(0 | 1) segmentSize= segmentSizeValue ] Parameters Parameter Description...
Page 127 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.
Page 128: Create Raid Virtual Disk (Manual Physical Disk Select)
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.
Page 129 [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.
Page 130 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.
Page 131: Create Snapshot Virtual Disk
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.
Page 132 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= "...
Page 133 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.
Page 134 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.
Page 135: Create Virtual Disk Copy
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 –...
Page 136 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.
Page 137: Delete Disk Group
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.
Page 138: Delete Host
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 ("...
Page 139: Delete Host Port
Delete Host Port This command deletes an HBA host port identification. The identification is a software value that represents the physical HBA host port to the RAID controller module. By deleting the identification, the RAID controller module no longer recognizes instructions and data from the HBA host port. Syntax delete hostPort [ hostPortName ] Parameters...
Page 140: Delete Virtual Disk
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\"];"...
Page 141: Diagnose Raid Controller Module
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 ("...
Page 142 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.
Page 143 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.
Page 144: Disable Storage Array Feature
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.
Page 145: Download Physical Disk Firmware
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...
Page 146: Download Storage Array Firmware/Nvsram
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.
Page 147: Download Storage Array Nvsram
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.
Page 148: Download Storage Array Physical Disk Firmware
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.
Page 149: Enable Raid Controller Module
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.
Page 150: Recopy Virtual Disk Copy
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.
Page 151: Recover Raid Virtual Disk
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 ("...
Page 152 offset= offsetValue raidLevel=(0 | 1 | 5) segmentSize= segmentSizeValue [owner=(0 | 1)] Parameters Parameter Description physicalDisk or Specifies the physical disks to assign to the virtual disk physicalDisks that you want to create. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk.
Page 153: Re-Create Snapshot
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.
Page 154 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 ("...
Page 155: Remove Virtual Disk Copy
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. NOTE: If no optional parameters are specified, the recreate snapshot command will process the specified snapshot virtual disks as a batch, provided a validation...
Page 156: Remove Virtual Disk Lun Mapping
Remove Virtual Disk LUN Mapping This command removes the logical unit number (LUN) mapping. Syntax remove (allVirtualDisks | virtualDisk [" virtualDiskName "] | virtualDisks [" virtualDiskName1" ... "virtualDiskNamen" ] | accessVirtualDisk) lunMapping (host=" hostName " | hostGroup= " hostGroupName ") Parameters Parameter Description...
Page 157: Repair Virtual Disk Consistency
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.
Page 158: Reset Storage Array Battery Install Date
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.
Page 159: Reset Storagearray Sasphybaseline
Parameters None. NOTE: This command resets the baseline to 0 for both RAID controller modules in the storage array. The purpose of resetting both of the RAID controller module baselines is to help ensure that the counts are synchronized between the RAID controller modules.
Page 160: Revive Disk Group
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.
Page 161: Save Enclosure Log Data
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.
Page 162: Save Raid Controller Module Nvsram
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...
Page 163: Save Storage Array Events
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.
Page 164: Save Storage Array Iscsi Statistics
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.
Page 165: Save Storage Array Performance Statistics
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.
Page 166: Save Storage Array State Capture
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="...
Page 167 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...
Page 168 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.
Page 169: Set Disk Group
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.1 enableIPV4;"...
Page 170: Set Enclosure Attribute
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.
Page 171: Set Enclosure Identification
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.
Page 172 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 (“...
Page 173: Set Host Group
Host Group Parameter Host Has Individual Virtual Host Does Not Have Individual Disk-to-LUN Mappings Virtual Disk-to-LUN Mappings none The host is removed from The host is removed from the the host group as an present host group and is independent partition and is placed under the default placed under the root node.
Page 174: Set Host Port
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.
Page 175: Set Iscsi Initiator
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.
Page 176: Set Iscsi Target Properties
-c "set iscsiInitiator <\"iqn.1991- 05.com.microsoft:svctag-70wnh91\"> userLabel= \"29000\";" -c "show iscsiInitiator[\"pe29000\"] iscsiSessions;" -c "show iscsiInitiator <\"iqn.1991- 05.com.microsoft:svctag-70wnh91\"> iscsiSessions;" Set iSCSI Target Properties This command defines properties for an iSCSI target. Syntax set iscsiTarget authenticationMethod = (none | chap) | chapSecret = password | isnsRegistration = (TRUE | FALSE) | targetAlias = user-label Parameters...
Page 177: Set Physical Disk Channel Status
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.1984- 05.com.dell:powervault. 6001372000f5f0e600000000463b9292\"> authenticationMethod = none;" -c "set iscsiTarget [\"iscsi2900\"] targetAlias = \"iscsi2902\";"...
Page 178: Set Physical Disk Hot Spare
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.
Page 179: Set Session
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.
Page 180: Set Snapshot Virtual Disk
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.
Page 181 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.
Page 182: Set Storage Array
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.
Page 183 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.
Page 184: Set Storage Array Enclosure Positions
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.
Page 185: Set Storage Array Isns Server Ipv4 Address
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.
Page 186: Set Storage Array Isns Server Ipv6 Address
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.
Page 187: Set Storage Array Isns Server Listening Port
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.
Page 188: Set Storagearray Isnsserverrefresh
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.
Page 189: Set Virtual Disk
Syntax set iscsiTarget unnamedDiscoverySession = (TRUE | FALSE) Parameter Parameter Description This parameter turns on or turns off unnamedDiscoverySession 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.
Page 190 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.
Page 191 Parameters Parameter Description allVirtualDisks Specifies the properties for all virtual disks in the storage array. virtualDisk or virtualDisks Specifies the name of the virtual disk for which to (name) define properties. You can enter more than one virtual disk name if you use the virtualDisks parameter. You must put quotation marks ("...
Page 192 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.
Page 193 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"...
Page 194: Set Virtual Disk Copy
Set Virtual Disk Copy This command defines the properties for a virtual disk copy pair. Syntax set virtualDiskCopy target [ targetName ] [source [ sourceName ]] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE) Parameters Parameter Description target Specifies the name of the target virtual disk for which...
Page 195: Show Disk Group
Syntax show iscsiInitiator iscsiSessions [ iscsiInitiatorName | iscsiTargetName ] Parameters Parameter Description iscsiInitiatorName The name of the iSCSI initiator for which you want to Enclose the obtain session information. iSCSI initiator name in square brackets ([ ]). iscsiTargetName The name of the iSCSI target for which you want to obtain Enclose the name in session information.
Page 196: Show Host Ports
Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number. Show Host Ports For all HBA host ports connected to a storage array, this command returns the following information: •...
Page 197 – Product ID – Firmware level • Physical disk channel information: – Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long.
Page 198: Show Physical Disk Channel Statistics
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.
Page 199: Show Physical Disk Download Progress
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.
Page 200: Show Raid Controller Module
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 •...
Page 201: Show Raid Controller Module Nvsram
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.
Page 202: Show Storage Array
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.
Page 203 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.
Page 204: Show Storage Array Autoconfigure
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.
Page 205 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.
Page 206: Show Storage Array Host Topology
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.
Page 207: Show Storage Array Pending Topology
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.
Page 208: Show String
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...
Page 209: Show Virtual Disk
Parameters None. Example -c "show storageArray unconfiguredIscsiInitiators;" Show Virtual Disk For the virtual disks in a storage array, this command returns the following information: • Number of virtual disks • Name • Status • Capacity • RAID level • Disk group where the virtual disk is located •...
Page 210: Show Virtual Disk Action Progress
• 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.
Page 211: Show Virtual Disk Copy
Parameters Parameter Description virtualDisk Name of the virtual disk running the long-running operation. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets.
Page 212: Show Virtual Disk Copy Source Candidates
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.
Page 213: Show Virtual Disk Reservations
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 Name of the specific virtual disk for which you are retrieving virtualDisks performance statistics.
Page 214: Start Disk Group Blink
Parameters Parameter Description allVirtualDisks Returns reservation information about all virtual disks in the storage array. virtualDisk or Name of the specific virtual disk for which you are retrieving virtualDisks reservation information. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name.
Page 215: Start Enclosure Blink
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...
Page 216: Start Physical Disk Blink
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...
Page 217: Start Physical Disk Reconstruction
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.
Page 218: Stop Disk Group Blink
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.
Page 219: Stop Physical Disk Blink
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.
Page 220: Stop Storage Array Blink
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.
Page 221 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 ("...
Page 222 Script Commands...
Page 223: Sample Script Files
Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array.
Page 224 //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";...
Page 225 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.
Page 226: Configuration Script Example 2
Configuration Script Example 2 This example creates a new virtual disk using the create virtualDisk command with user-defined physical disks in the storage array. Show "Create RAID 5 Virtual Disk 2 on existing Disk Group 2"; //This command creates the disk group and the initial virtual disk on that group.
Page 227 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... enclosureIDn,slotIDn) [capacity= virtualDiskCapacity | owner=(0 | 1) | segmentSize= segmentSizeValue ] [enclosureLossProtect=(TRUE | FALSE)] Sample Script Files...
Page 228 Sample Script Files...
Page 229: Index
Index commands, 16 activate storage array usage examples, 27 firmware, 114 clocks, RAID controller module, adding comments to a script, 41 synchronizing, 95 assigning global hot spares, 59 collecting physical disk data, 98 autoconfigure storage array, 114 command formatting rules, 106 autoconfigure storage array hot command line interface, how to spares, 116...
Page 230 configure (continued) delete (continued) create RAID virtual disk, manual Snapshot Virtual Disk, 74-75 physical disk select, 128 virtual disk, 140 storage array, 44 delete iSCSI initiator, 139 storage partitioning, 88 detailed error reporting, 24 copying determining virtual disk, 81 Virtual Disk Copy candidates, 79 create what is on your storage array, 44 host, 120...
Page 231 enclosure commands, 108 enclosure loss protection, 52 initializing physical disk, 101 exit status, 25 virtual disk, 102 interaction with other features, 88 ISCSI formatting considerations, 24 recurring syntax values, 39 iSCSI commands, 109 host create host, 120 delete host, 138 show storage array host locating physical disks, 95 topology, 206...
Page 232 physical disk recover RAID virtual disk, 151 commands, 110 recovery operations, 100 download firmware, 145 re-create Snapshot, 153 initializing, 101 re-creating locating, 95 snapshot virtual disk, 76 reconstructing, 102 reviving, 160 recurring syntax elements, 34 set commands, 177-179 redistributing virtual disk, 103 set state, 178 redundancy check, running, 93 show commands, 196-199...
Page 233 set (continued) running media scan, 91 Snapshot Virtual Disk, 180 redundancy check, 93 storage array, 182 storage array enclosure positions, 184 storage array time, 188 virtual disk, 189 save Virtual Disk Copy, 194 configuration to a file, 47 set controller, 166 enclosure log data, 161 physical disk log, 161 set host, 171...
Page 234 show SMcli commands, 16 disk group, 195 snapshot host ports, 196 commands, 111 physical disk, 196 names, 72 physical disk channel virtual disks, 89 statistics, 198 Snapshot Virtual Disk physical disk download creating, 64-72 progress, 199 deleting, 76 RAID controller module, 200 enabling, 64 RAID controller module restarting, 75...
Page 235 50 start blink, 217 creating with user-assigned stop blink, 220 physical disks, 48 storage partitioning, 88 initializing, 102 recopy, 86 support.dell.com, 13 recopying, 84 synchronizing RAID controller redistributing, 103 module clocks, 95 repair consistency, 157 syntax elements set, 189...
Page 236 Index...

This manual is also suitable for:

Powervault modular disk storage manager

Dell PowerVault MD3000i Cli Manual

1 About the Command Line Interface

2 About the Script Commands

3 Configuring a Storage Array

4 Using the Snapshot Feature

5 Using the Virtual Disk Copy Feature

6 Maintaining a Storage Array

7 Script Commands

Sample Script Files

Index

Quick Links

Related Manuals for Dell PowerVault MD3000i

Summary of Contents for Dell PowerVault MD3000i