Download Print this page

Dell PowerVault MD3220 Cli Manual

Powervault modular disk storag arrays
Hide thumbs

Advertisement

Dell PowerVault Modular Disk
Storage Arrays
CLI Guide

Advertisement

loading

  Related Manuals for Dell PowerVault MD3220

  Summary of Contents for Dell PowerVault MD3220

  • Page 1 Dell PowerVault Modular Disk Storage Arrays CLI Guide...
  • Page 2: Notes And Cautions

    © 2010-2011 Dell Inc. All rights reserved. Reproduction of these materials in any manner whatsoever without the written permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell™, the DELL logo, and PowerVault™ are trademarks of Dell Inc. ® ®...
  • Page 3: Table Of Contents

    Contents About the Command Line Interface ..How to Use the Command Line Interface ..Usage Notes ....CLI Commands .
  • Page 4 Determining What is on Your Storage Array ..Saving a Configuration to a File ... Using the Create Virtual Disk Command ..Using the Auto Configure Command .
  • Page 5 Re-creating the Snapshot Virtual Disk ..Preparing Host Servers to Re-create a Snapshot Virtual Disk ....Re-creating a Snapshot Virtual Disk .
  • Page 6 Running a Media Scan ....Running a Consistency Check ... Resetting a RAID Controller Module ..Enabling RAID Controller Module Data Transfer .
  • Page 7: Create Raid Virtual Disk

    Firmware Compatability Levels ... . . Commands Listed by Function ....Disk Group Commands ....Enclosure Commands .
  • Page 8 Create RAID Virtual Disk (Free Capacity Base Select) ....Create RAID Virtual Disk (Manual Physical Disk Select) ....Create Snapshot Virtual Disk .
  • Page 9 Reset Storage Array Battery Install Date ..Reset Storage Array iSCSI Baseline ..Reset Storage Array SAS PHY Baseline ..Reset Storage Array Virtual Disk Distribution .
  • Page 10 Set Session ....Set Snapshot Virtual Disk ... . . Set Storage Array .
  • Page 11 Show Storage Array Unconfigured iSCSI Initiators ....Show Storage Array Unreadable Sectors ..Show String ..... Show Virtual Disk .
  • Page 12 Stop Physical Disk Channel Fault Isolation Diagnostics ....Stop Snapshot ....Stop Storage Array Blink .
  • 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; where, SMcli invokes the command line interface storageArray is the host name or IP address of the storage array parameters are the CLI parameters that define the environment and purpose of the command script-commands are the commands or name of the script file containing the script commands...
  • Page 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 [host-name-or-IP-address2]] [-n storage-array-name | -w WWID | -h host-name | -r (host_sa | direct_sa)] [-I information-to-include][-q frequency][-S]...
  • Page 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 or IPv6). •...
  • Page 19 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to indicate that you are entering one or more script commands to run on the specified storage array. Terminate each command by using a semicolon (;). You cannot place more than one -c parameter on the same command line.
  • Page 20 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify an ASCII file that contains e-mail sender contact information to include in all e-mail alert notifications. The CLI assumes the ASCII file is text only, without delimiters or any expected format. A typical file contains the following information: •...
  • Page 21 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify the name of the storage array on which to run the script commands. This name is optional when you use host-name-or-IP-address; however, if you are using the in-band method for managing the storage array, you must use the -n parameter if more than one storage array is connected to the host at the specified address.
  • Page 22 (continued) Table 1-2. Command Line Parameters Parameter Definition Use to specify how frequently to include additional profile or support bundle information in the e-mail alert notifications. An e-mail alert notification that contains at least the basic event information is always generated for every critical event.
  • Page 23 (continued) Table 1-2. Command Line Parameters Parameter Definition -S (uppercase) Use to suppress the informational messages describing command progress that appear when running script commands. (Suppressing informational messages is also called silent mode.) This parameter suppresses the following messages: • Performance syntax check •...
  • Page 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. When quotation marks ("...
  • 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 (continued) Table 1-3. Exit Status Status Value Meaning The storage array name was not in the configuration file. A management class does not exist for the storage array. A storage array was not found in the configuration file. An internal error occurred. Invalid script syntax was found.
  • Page 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. On Windows operating systems, put quotation marks ("...
  • 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

    (continued) Table 2-1. Configuration and Management Operations Operation Activities General storage array Resetting a configuration to defaults, labeling, configuration checking the health status, setting the time of day, clearing the Major Event Log, and setting the media scan rate NVSRAM configuration Downloading and modifying the user configuration region at the bit and byte level, displaying nonvolatile static random access memory (NVSRAM) values...
  • Page 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

    (continued) Table 2-2. Object Types and Identifiers 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 (continued) Table 2-3. General Form of the Script Commands 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

    (continued) Table 2-3. General Form of the Script Commands 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: Physical Disk Select)

    (continued) Table 2-4. Recurring Syntax Elements 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 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value iscsi-host-port-options IPV4Address=ipv4-address | IPV6LocalAddress=ipv6-address | IPV6RoutableAddress=ipv6-address | IPV6RouterAddress=ipv6-address | enableIPV4= boolean | enableIPV6=boolean | enableIPV4Vlan=boolean | enableIPV6Vlan=boolean | enableIPV6Priority=boolean | enableIPV6Priority=boolean | IPV4ConfigurationMethod=(static | dhcp) | IPV6ConfigurationMethod=(static | auto) | IPV4GatewayIP= ipv4-address | IPV6HopLimit=integer | IPV6NdDetectDuplicateAddress=...
  • Page 37 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value instance-based-repository-spec repositoryRAIDLevel=repository-raid- level repositoryPhysicalDisks=(physical disk- spec-list) [enclosureLossProtect=boolean] repositoryDiskGroup=virtual-disk- group-number [freeCapacityArea=integer-literal] Specify repositoryRAIDLevel with repositoryPhysicalDisks. Do not specify RAID level or physical disks with a disk group. Do not set enclosureLossProtect when specifying a disk group.
  • Page 38 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value nvsram-offset hexadecimal-literal host-type string-literal | integer-literal nvsram-byte-setting nvsram-value (0x hexadecimal | integer-literal) nvsram-bit-setting nvsram-mask, nvsram-value (0x hexadecimal, 0x hexadecimal | integer-literal) ipv4-address (0–255).(0–255).(0–255).(0–255) ipv6-address (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFFF):(0-FFFF): (0-FFFF):(0-FFF) autoconfigure-vols-attr-value-list autoconfigure-vols-attr-value-pair {autoconfigure-vols-attr-value-pair} autoconfigure-vols-attr-value-pair physicalDiskType=physical disk-type| raidLevel=raid-level |...
  • Page 39 (continued) Table 2-4. Recurring Syntax Elements Recurring Syntax Syntax Value create-virtual-disk-copy-attr-value-list create-virtual-disk-copy-attr-value-pair {create-virtual-disk-copy-attr-value-pair} create-virtual-disk-copy-attr-value-pair copyPriority=highest | high | medium | low | lowest | targetReadOnlyEnabled=boolean recover-raid-virtual-disk-attr-value-list recover-raid-virtual-disk-attr-value-pair {recover-raid-virtual-disk-attr-value-pair} recover-raid-virtual-disk-attr-value-pair owner=(0 | 1) Table 2-5. Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values IPV4Priority...
  • Page 40: Usage Guidelines

    (continued) Table 2-5. Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values maxFramePayload 1500 NOTE: The maxFramePayload parameter is shared between IPv4 and IPv6. The payload portion of a standard Ethernet frame is set at 1500 bytes, and a jumbo Ethernet frame is set at 9000 bytes.
  • Page 41: Adding Comments To A Script File

    NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. NOTE: capacity parameter returns an error if you specify a value greater than...
  • 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 CAUTION: When you write information to a file, the script engine does not check to determine if the file name already exists. If you choose the name of a file that already exists, the script engine writes over the information in the file without warning.
  • Page 47: Saving A Configuration To A File

    The following commands also return information about a storage array: • show storageArray autoConfigure ("Show Storage Array Auto Configure" on page 235) • show controller NVSRAM ("Show RAID Controller Module NVSRAM" on page 232) • show storageArray unreadableSectors ("Show Storage Array Unreadable Sectors"...
  • Page 48: Using The Create Virtual Disk Command

    save storageArray configuration file="filename" [(allconfig | globalSettings=(TRUE | FALSE)) | virtualDiskConfigAndSettings=(TRUE | FALSE) | hostTopology=(TRUE | FALSE) | lunMappings=(TRUE | FALSE)] 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=...
  • Page 49 "virtualDiskName" [capacity=virtualDiskCapacity owner=(0 | 1) segmentSize=segmentSizeValue] [enclosureLossProtect=(TRUE | FALSE)] NOTE: capacity owner segmentSize enclosureLossProtect , and 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.
  • Page 50 Example of Creating Virtual Disks with User-Assigned Physical Disks client>smcli 123.45.67.89 -c "create virtualDisk physicalDisks=(0,0 0,1 0,2) raidLevel=5 userLabel= \"Engineering_1\" capacity=20 GB owner=0;" NOTE: capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its unit of measure. (For example, returns an error, but does not return an error).
  • Page 51 group. You do not need to enter a list of physical disks. All other parameters are the same. Enclosure loss protection is performed differently when MD Storage Manager assigns the physical disks as opposed to when a user assigns the physical disks. (For an explanation of the difference, see "Enclosure Loss Protection"...
  • Page 52 The freeCapacityArea parameter defines the free capacity area to use for the virtual disk. If a disk group has several free capacity areas, you can use this parameter to identify which free capacity area to use for virtual disk creation. You do not have to assign the entire capacity of the physical disks to the virtual disk.
  • 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. After you have finished creating the disk groups and virtual disks by using the autoConfigure storageArray command, you can further define the properties of the virtual disks in a configuration using the set virtualDisk command.
  • Page 56: Setting The Storage Array Password

    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

    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 The following example shows how to set the SNMP trap alert configuration. In this example, the trap destination is 123.45.67.891.
  • Page 58: Setting Modification Priority

    defaultHostType to Linux, the RAID controller module communicates with any undefined host if the undefined host is running Linux. Typically, you need to change the host type only when you are setting up the storage array. The only time you might need to use this parameter is if you need to change how the storage array behaves relative to the hosts.
  • Page 59: Assigning Global Hot Spares

    • 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.
  • Page 60 The following syntax is the general form of the command: set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID0,slotID0 ... enclosureIDn,slotIDn] hotSpare=(TRUE | FALSE) The following example shows how to use this command to set hot spare physical disks: client>smcli 123.45.67.89 -c "set physicalDisks [0,2 0,3] hotSpare=TRUE;"...
  • Page 61: Using The Snapshot Feature

    Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature. For more information, see "Premium Feature —...
  • Page 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

    For details on mapping the snapshot virtual disk to the secondary node, see the PowerVault MD3200 and MD3220 Storage Arrays With Microsoft Windows Server Failover Clusters or Dell PowerVault MD3200i and MD3220i Storage Arrays With Microsoft Windows Server Failover Clusters at support.dell.com/manuals.
  • Page 64: Creating A Snapshot Virtual Disk

    Creating a Snapshot Virtual Disk The create snapshotVirtualDisk command provides three methods for defining the physical disks for your snapshot repository virtual disk: • Define each physical disk for the snapshot repository virtual disk by enclosure ID and slot ID. •...
  • Page 65: Enabling The Snapshot Virtual Disk Feature

    Enabling the Snapshot Virtual Disk Feature The first step in creating a snapshot virtual disk is to make sure the feature is enabled on the storage array. You need a feature key to enable the feature. The command for enabling the feature key file is: enable storageArray feature file="filename"...
  • Page 66: Creating The Initial Snapshot Virtual Disk

    3 Remove the drive letter(s) of the source in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the Snapshot. If this is not done, the snapshot operation reports that it has completed successfully, but the snapshot data is not updated properly.
  • Page 67 See step 1 through step 4 in the preceding section, "Preparing Host Servers to Create an Initial Snapshot Virtual Disk" on page 65. The following example shows a command in which users assign the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\"...
  • Page 68: Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks

    Creating a Snapshot Virtual Disk with Software-Assigned Physical Disks This version of the create snapshotVirtualDisk command lets you choose an existing disk group in which to place the snapshot repository virtual disk. The storage management software determines which physical disks to use. You can also define how much space to assign to the repository virtual disk.
  • Page 69: Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks

    Define the capacity of a snapshot repository virtual disk as any percentage of the size of the source virtual disk. A value of 20 percent is a good compromise between size and speed. In the previous example, the size of the snapshot repository is set to 4 GB.
  • Page 70: User-Defined Parameters

    The command in this example creates a new snapshot repository virtual disk that consists of three physical disks. The three physical disks comprise a new disk group with a RAID level of 5. This command also takes a snapshot of the source virtual disk, which starts the copy-on-write operation.
  • Page 71 (continued) Table 4-3. Snapshot Virtual Disk Parameters Parameter Description userLabel Specifies the name to give to the snapshot virtual disk. If you do not choose a name for the snapshot virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the source virtual disk name is Mars_Spirit_4 and it does not have a snapshot virtual disk, the default snapshot virtual disk name is Mars_Spirit_4-1.
  • Page 72: Names Of Snapshot Virtual Disks And Repository Virtual Disks

    The following example of the create snapshotVirtualDisk command includes user-defined parameters: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel=\"Mars_Spirit_4_snap1\" repositoryUserLabel=\"Mars_Spirit_4_rep1\" warningThresholdPercent=75 repositoryPercentOfSource=40 repositoryFullPolicy=failSnapShot;" The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4"...
  • Page 73: Changing Snapshot Virtual Disk Settings

    name Engineering Data, the snapshot virtual disk can have a name Engineering Data-S1. The repository virtual disk can have a name of Engineering Data-R1. If you do not choose a unique name for either the snapshot virtual disk or repository virtual disk, the RAID controller modules create a default name by using the name of the source virtual disk.
  • Page 74: Stopping And Deleting A Snapshot Virtual Disk

    The following example is the script file version of the command: set virtualDisk ["Mars_Spirit_4-1"] userLabel= "Mars_Odyssey_3-2"; When you change the warning threshold percent and repository full policy, you can apply the changes to one or several snapshot virtual disks. The following example uses the set (snapshot) virtualDisk command to change these properties on more than one snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisks...
  • Page 75: Re-Creating The Snapshot Virtual Disk

    When you stop the copy-on-write operations for a specific snapshot virtual disk, only that snapshot virtual disk is disabled. All other snapshot virtual disks remain in operation. Re-creating the Snapshot Virtual Disk To restart a copy-on-write operation, use the recreate snapshot virtualDisk command.
  • Page 76: Re-Creating A Snapshot Virtual Disk

    SMrepassist -f <filename-identifier> and press <Enter>. See "SMrepassist Utility" in the Owner’s Manual for more information. 3 Remove the drive letter(s) of the source and (if mounted) snapshot virtual disk in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the Snapshot.
  • Page 77: Using The Virtual Disk Copy Feature

    If you ordered Premium Features for Virtual Disk Copy, you received a Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array. Follow the directions on the card to obtain a key file and to enable the feature.
  • Page 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: Creating A Virtual Disk Copy

    Creating a Virtual Disk Copy CAUTION: A virtual disk copy overwrites data on the target virtual disk. Ensure that you no longer need the data or have backed up the data on the target virtual disk before starting a virtual disk copy. When you create a virtual disk copy, you must define which virtual disks to use for the source virtual disk and target virtual disks.
  • Page 81: Copying The Virtual Disk

    3 Remove the drive letter(s) of the source and (if mounted) virtual disk in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the virtual disk. If this is not done, the copy operation reports that it has completed successfully, but the copied data is not updated properly.
  • Page 82: Viewing Virtual Disk Copy Properties

    The create virtualDiskCopy command might look like the following example: client>smcli 123.45.67.89 -c "create virtualDiskcopy source=\"Jaba_Hut\" target= \"Obi_1\" copyPriority=medium targetreadonlyenabled=true" The command in this example copies the data from the source virtual disk named Jaba_Hut to the target virtual disk named Obi_1. Setting the copy priority to medium provides a compromise between the following storage array operations: •...
  • Page 83: Changing Virtual Disk Copy Settings

    • The completion timestamp • The virtual disk copy priority • The read-only attribute setting for the target virtual disk • The source virtual disk World Wide Identifier (WWID) or the target virtual disk WWID A virtual disk can be a source virtual disk for one virtual disk copy and a target virtual disk for another virtual disk copy.
  • Page 84 • Before the virtual disk copy begins • While the virtual disk copy has a status of In Progress • After the virtual disk copy has completed re-creating a virtual disk copy using the recopy virtualDiskCopy command When you create a virtual disk copy pair and after the original virtual disk copy has completed, the target virtual disk is automatically defined as read- only to the hosts.
  • Page 85: Recopying A Virtual Disk

    The following example is the script file version of the command: set virtualDiskcopy target ["Obi_1"] copyPriority= highest targetreadonlyenabled=false; Recopying a Virtual Disk CAUTION: The recopy virtualDiskCopy command overwrites existing data on the target virtual disk and makes the target virtual disk read-only to hosts. The recopy virtualDiskCopy command fails all snapshot virtual disks associated with the target virtual disk, if any exist.
  • Page 86: Recopying The Virtual Disk

    1 Stop all I/O activity to the source and target virtual disk. 2 Using your Windows system, flush the cache to both the source and the target virtual disk (if mounted). At the host prompt, type SMrepassist -f <filename-identifier> and press <Enter>. See "SMrepassist Utility" in the Owner’s Manual for more information.
  • Page 87: Stopping A Virtual Disk Copy

    The command in this example copies data from the source virtual disk associated with the target virtual disk Obi_1 to the target virtual disk again. The copy priority is set to the highest value to complete the virtual disk copy as quickly as possible.
  • Page 88: Removing Copy Pairs

    Removing Copy Pairs The remove virtualDiskCopy command enables you to remove a virtual disk copy pair from the storage array configuration. All virtual disk copy information for the source virtual disk and target virtual disk is removed from the storage array configuration. The data on the source virtual disk or target virtual disk is not deleted.
  • Page 89: Storage Partitioning

    Storage Partitioning Storage partitioning enables hosts to share access to virtual disks in a storage array. You create a storage partition when you define the following storage array assignments: • A host • A host group • Virtual disk-to-logical unit number (LUN) mapping The virtual disk-to-LUN mapping enables you to define which host group or host has access to a particular virtual disk in the storage array.
  • Page 90 You can select snapshot virtual disks as the source virtual disk for a virtual disk copy. Selecting a snapshot virtual disk is a good use of this feature, because it enables complete backups without significant impact to the storage array I/O. However, some I/O processing resources are lost to the copy operation.
  • 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 • Media scan enabled • Errors detected during a scan of a user virtual disk are reported to the MEL and handled as: – Unrecovered media error — The physical disk could not read the requested data on its first attempt or on any subsequent retries. For virtual disks with redundancy protection, the data could not be reconstructed from the redundant copy.
  • Page 93: Running A Consistency Check

    set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen] | virtualDisk <wwid>) mediaScanEnabled=(TRUE | FALSE) The set storageArray command defines how frequently a media scan is run on a storage array. The following syntax is the general form of the command: set storageArray mediaScanRate=(disabled | 1-30) Running a Consistency Check...
  • Page 94: Resetting A Raid Controller Module

    Resetting a RAID Controller Module CAUTION: When you reset a RAID controller module, the RAID controller module is not available for I/O operations until the reset is complete. If a host is using virtual disks owned by the RAID controller module being reset, the I/O directed to the RAID controller module is rejected.
  • Page 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" ... "virtualDiskNamen]) reservations Synchronizing RAID Controller Module Clocks To synchronize the clocks on both RAID controller modules in a storage array...
  • Page 96: Performance Tuning

    Performance Tuning Over time, as a storage array exchanges data between the hosts and physical disks, its performance can degrade. Monitor the performance of a storage array and make adjustments to the storage array operational settings to improve performance. Monitoring Performance Monitor the performance of a storage array by using the save storageArray performanceStats command.
  • Page 97: Changing Raid Levels

    (continued) Table 6-1. Storage Array Performance Information Type of Information Description Current IO/second Current number of I/Os per second (current means the number of I/Os per second since the last time the polling interval elapsed, causing an update to occur) Maximum IO/second Highest number of I/Os achieved in the current I/O-per-second statistic block The general form of the command is:...
  • Page 98: Defragmenting A Disk Group

    request leaves other disks available to simultaneously service other requests. If the virtual disk is in a single-user large I/O environment, performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | <wwid>) segmentSize=segmentSizeValue...
  • Page 99: Troubleshooting And Diagnostics

    Troubleshooting and Diagnostics If a storage array exhibits abnormal operation or failures, you can use the commands described in this section to determine the cause of the problems. Collecting Physical Disk Data To gather information about all the physical disks in a storage array, run the save allPhysicalDisks command.
  • Page 100: Recovery Operations

    For best results, run all three tests at initial installation. Also, run the tests any time you make changes to the storage array or to components connected to the storage array (such as hubs, switches, and host adapters). A custom data pattern file called diagnosticsDataPattern.dpf is included on the Utility directory of the installation CD.
  • Page 101 Placing a RAID controller module online sets it to the Optimal state and makes it active and available for I/O operations. Placing a RAID controller module offline makes it unavailable for I/O operations and moves its disk groups to the other RAID controller module if failover protection is enabled. Taking a RAID controller module offline can seriously impact data integrity and storage array operation.
  • Page 102: Changing Raid Controller Module Ownership

    Changing RAID Controller Module Ownership You can change which RAID controller module owns a virtual disk by using the set virtualDisk command. The following syntax is the general form of the command: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...
  • Page 103: Initializing A Virtual Disk

    To reconstruct a physical disk, run the following command: start physicalDisk [enclosureID,slotID] reconstruct where, enclosureID and slotID are the identifiers for the physical disk. NOTE: You can use this command only when the physical disk is assigned to a RAID 1, 5, or 6 disk group. Initializing a Virtual Disk CAUTION: When you initialize a virtual disk, all data on the virtual disk and all...
  • Page 104 To redistribute virtual disks to their preferred RAID controller modules, run the following command: reset storageArray virtualDiskDistribution NOTE: You cannot run this command if all virtual disks are currently owned by their preferred RAID controller module or if the storage array does not have defined virtual disks.
  • Page 105: Script Commands

    Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the current configuration so that you can reinstall it if the changes do not work.
  • Page 106: Command Formatting Rules

    CAUTION: Commands entered using the command line interface (CLI) are capable of damaging a configuration and causing loss of data if not used properly. Command operations are performed as soon as you run the commands. Some commands can immediately delete configurations or data. Before using the command line interface, make sure you have backed up all data, and save the current configuration so that you can reinstall it if the changes you make do not work.
  • Page 107 To use the raidLevel parameter to set a RAID level of 5, enter: raidLevel=5 • When you specify physical disk locations by using enclosure ID values and slot ID values, separate the ID values with a comma. If you enter more than one set of ID values, separate each set of values by a space.
  • Page 108: Firmware Compatability Levels

    On Microsoft Windows, you must put a backslash (\) before and after the name in addition to other delimiters. For example, the following name is used in a command running under a Windows operating system: [\"Engineering"\] For Linux, and when used in a script file, the name appears as the following: ["Engineering"] When you enter the World Wide Identifier (WWID) of an HBA host...
  • Page 109: Enclosure Commands

    "Show Disk Group Export Dependencies" on page 225 "Show Disk Group Import Dependencies" on page 226 "Start Disk Group Blink" on page 247 "Start Disk Group Defragment" on page 247 "Start Disk Group Export" on page 248 "Start Disk Group Import" on page 249 "Stop Disk Group Blink"...
  • Page 110: Iscsi Commands

    "Set Host Port" on page 194 "Set iSCSI Initiator" on page 195 "Set iSCSI Target Properties" on page 197 "Show Host Ports" on page 227 iSCSI Commands "Create iSCSI Initiator" on page 131 "Delete iSCSI Initiator" on page 154 "Reset Storage Array iSCSI Baseline" on page 178 "Save Storage Array iSCSI Statistics"...
  • Page 111: Raid Controller Module Commands

    "Set Physical Disk Channel Status" on page 198 "Set Physical Disk State" on page 199 "Show Physical Disk" on page 227 "Show Physical Disk Channel Statistics" on page 230 "Show Physical Disk Download Progress" on page 230 "Start Physical Disk Blink" on page 251 "Start Physical Disk Initialize"...
  • Page 112: Session Command

    "Show RAID Controller Module NVSRAM" on page 232 "Start Physical Disk Channel Blink" on page 251 "Start Physical Disk Channel Fault Isolation Diagnostics" on page 252 "Stop Physical Disk Channel Blink" on page 257 "Stop Physical Disk Channel Fault Isolation Diagnostics" on page 258 Session Command "Set Session"...
  • Page 113 "Enable Storage Array Feature" on page 165 "Reset Storage Array Battery Install Date" on page 177 "Reset Storage Array Battery Install Date" on page 177 "Reset Storage Array SAS PHY Baseline" on page 179 "Reset Storage Array Virtual Disk Distribution" on page 179 "Save Storage Array Configuration"...
  • Page 114: Virtual Disk Commands

    "Show Storage Array Negotiation Defaults" on page 238 "Show Storage Array Unconfigured iSCSI Initiators" on page 239 "Show Storage Array Unreadable Sectors" on page 239 "Start Storage Array Blink" on page 255 "Start Storage Array iSCSI Refresh" on page 255 "Stop Storage Array Blink"...
  • Page 115: Virtual Disk Copy Commands

    Virtual Disk Copy Commands "Create Virtual Disk Copy" on page 149 "Recopy Virtual Disk Copy" on page 166 "Remove Virtual Disk Copy" on page 173 "Set Virtual Disk Copy" on page 223 "Show Virtual Disk Copy" on page 242 "Show Virtual Disk Copy Source Candidates" on page 243 "Show Virtual Disk Copy Target Candidates"...
  • Page 116 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.
  • Page 117 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. Number of disk groups in the storage array. Use diskGroupCount integer values.
  • Page 118: Autoconfigure Storage Array Hot Spares

    Autoconfigure Storage Array Hot Spares This command automatically defines and configures the hot spares in a storage array. You can run this command at any time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters None.
  • Page 119 Parameters Parameter Description Name of the specific virtual disk to check virtualDisk 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. Name of the file in which to save the consistency consistencyErrorFile error information.
  • Page 120: Clear Physical Disk Port Statistics

    Clear Physical Disk Port Statistics This command resets the statistics for all physical disk ports. Syntax clear allPhysicalDiskChannels stats Parameters None. Clear Storage Array Configuration Use this command to: • Clear the entire storage array configuration, and return it back to the initial installation state.
  • Page 121: Clear Storage Array Event Log

    Parameter Description The setting to remove the virtual disk volumeGroups configuration and the disk group configuration. The rest of the configuration stays intact. NOTE: When you run this command, the storage array becomes unresponsive, and all script processing is cancelled. You must remove and re-add the storage array to resume communication with the host.
  • Page 122: Clear Virtual Disk Reservations

    Clear Virtual Disk Reservations This command clears persistent virtual disk reservations. Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNamen]) reservations Parameters Parameter Description Clears reservations on all virtual disks in allVirtualDisks the storage array. Name of the specific virtual disk for which virtualDisk virtualDisks to clear reservations.
  • Page 123: Create Disk Group

    Parameters Parameter Description Clears unreadable sector information from all of the allVirtualDisks virtual disks in the storage array. The name of the specific virtual disk for which you virtualDisk want to clear unreadable sector information. You can virtualDisks enter more than one virtual disk name. Enclose the virtual disk name in square brackets ([ ]).
  • Page 124 Parameters Parameter Description The physical disks that you want to assign to the physicalDisks disk group that you want to create. Specify the enclosure ID value and the slot ID value for each physical disk that you assign to the disk group. Enclosure ID values are 0 to 99.
  • Page 125 Parameter Description The size of the virtual disk that you are adding to capacity the storage array. Size is defined in units of bytes, KB, MB, GB, or TB. The following examples show the syntax: capacity=500 bytes capacity=2 GB NOTE: A space must be added between the last digit and the size (bytes, KB, MB, or GB) for values greater than 9.If you do not specify a capacity, all the available...
  • Page 126 Parameter Description The setting to enforce enclosure loss protection enclosureLossProtect when you create the disk group. To enforce enclosure loss protection, set this parameter to TRUE. The default value is FALSE. The setting to specify the security level when securityType creating the disk groups and all associated virtual disks.
  • Page 127 Segment Size The size of a segment determines how many data blocks that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Each data block stores 512 bytes of data.
  • Page 128: Create Host

    • start secureErase (physicalDisk | physicalDisks) • enable diskGroup [diskGroupName] security Enclosure Loss Protection For enclosure loss protection to work, each physical disk in a disk group must be in a separate enclosure. If you set the enclosureLossProtect parameter to true and have selected more than one physical disk from any one enclosure, the storage array returns an error.
  • Page 129: Create Host Group

    Parameter Description The index label or the index number that identifies hostType the host type. Use the show storageArray command to generate a list of hostTypeTable available host type identifiers. If the host type has special characters, enclose the host type in double quotation marks (“...
  • Page 130 Syntax create hostPort identifier="wwid" userLabel="portLabel" host="hostName" interfaceType=SAS Parameters Parameter Description WWID of the HBA host port. You must identifier put quotation marks (" ") around the WWID. Name to give the new HBA host port. You userLabel must put quotation marks (" ") around the port label.
  • Page 131: Create Iscsi Initiator

    Create iSCSI Initiator This command creates a new iSCSI initiator object. Syntax create iscsiInitiator iscsiName = "iSCSI-ID" userLabel = "name" host = "host-name" [chapSecret = securityKey] Parameters Parameter Description The default identifier of the iSCSI initiator. iscsiName The name that you want to use for the iSCSI initiator. Enclose userLabel the name in double quotation marks ("...
  • Page 132 capacity=virtualDiskCapacity owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia) enclosureLossProtect=(TRUE | FALSE) dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description Number of unassigned physical disks to physicalDiskCount use in the disk group. NOTE: physicalDiskCount parameter enables you to choose the number of...
  • Page 133 Parameter Description The size of the virtual disk that you are capacity adding to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB. NOTE: A space must be added between the last digit and the size (bytes, KB, MB, or GB) for values greater than 9.
  • Page 134 Parameter Description Specifies that enclosure loss protection is enclosureLossProtect enforced when creating the disk group. To enforce enclosure loss protection, set this parameter to TRUE. The default setting is FALSE. For information about the enclosureLossProtect parameter, see "Enclosure Loss Protection" on page 52. The setting to make sure that reserve dssPreAllocate capacity is allocated for future segment...
  • Page 135 Parameters Parameter Description Sequence number of the disk group in diskGroup which to create the new virtual disk. (To determine the sequence numbers of the disk groups in your storage array, enter the show storageArray Profile command.) Name for the new virtual disk. You must userLabel put quotation marks ("...
  • Page 136 Parameter Description Size of the virtual disk that you are adding capacity to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB. NOTE: Add a space between the last digit and the size (bytes, KB, MB, or GB) for values greater than 9.
  • Page 137: Create Raid Virtual Disk (Manual Physical Disk Select)

    Parameter Description The settings for both the usageHint cacheReadPrefetch parameter and the segmentSize parameter should be the default values. The default values are based on the typical I/O usage pattern of the application that is using the virtual disk. Valid values are fileSystem, dataBase, or multiMedia.
  • Page 138 raidLevel=(0 | 1 | 5 | 6) userLabel=”virtualDiskName” [capacity=virtualDiskCapacity owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia) enclosureLossProtect=(TRUE | FALSE) dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description Specifies the physical disks to assign to the created physicalDisks virtual disk.
  • Page 139 Parameter Description RAID level of the disk group that contains the virtual raidLevel disk. Valid values are 0, 1, 5, or 6. NOTE: raidLevel If you set the parameter to RAID 1, the RAID controller module firmware takes the list of physical disks and pairs them using the following algorithm: Data physical disk =...
  • Page 140 Parameter Description RAID controller module that owns the virtual disk. owner Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure.
  • Page 141: Create Snapshot Virtual Disk

    Parameter Description The setting to make sure that reserve capacity is dssPreAllocate allocated for future segment size increases. The default value is TRUE. The setting to specify the security level when creating securityType the disk groups and all associated virtual disks. •...
  • Page 142 freeCapacityArea=freeCapacityIndexNumber userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName” repositoryFullPolicy=(failSourceWrites | failSnapshot)] Syntax (User-Defined Number of Physical Disks) create snapshotVirtualDisk sourceVirtualDisk=”sourceVirtualDiskName” repositoryRAIDLevel=(1 | 3 | 5 | 6) repositoryDriveCount=numberOfPhysicalDisks [repositoryVolumeGroupUserLabel= ”repositoryDiskGroupName” driveMediaType=(HDD | SSD | unknown | allMedia)] physicalDiskType=(SAS) enclosureLossProtect=(TRUE | FALSE) userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName”...
  • Page 143 repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName” repositoryFullPolicy=(failSourceWrites | failSnapshot)] Syntax (Existing Repository Disk Group) create snapshotVirtualDisk sourceVirtualDisk=”sourceVirtualDiskName” [repositoryDiskGroup=”repositoryDiskGroupName” repositoryUserLabel=”repositoryName” freeCapacityArea=freeCapacityIndexNumber userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryFullPolicy=(failSourceWrites | failSnapshot)] Parameters Parameter Description Name of the source virtual disk from sourceVirtualDisk which to take a snapshot. You must put quotation marks ("...
  • Page 144 Parameter Description repositoryVolumeGroupUserLabel Use this parameter when you create a new disk group. The name of a new disk group to be used for the repository virtual disk. Enclose the repository disk group name in double quotation marks (“ ”). Sequence number of the disk group where repositoryDiskGroup the repository virtual disk is located.
  • Page 145 Parameter Description The type of physical disks that you want physicalDiskType to use for the snapshot repository virtual disk. The valid physical disk type is SAS. You must specify a physical disk type. Use this parameter only when you use the repositoryDriveCount parameter.
  • Page 146 Parameter Description The size of the repository virtual disk as a repositoryPercentOfSource percentage of the source virtual disk. Use integer values. For example, a value of 40 means 40 percent. The default value is 20. The name to give to the repository virtual repositoryUserLabel disk.
  • Page 147: Create Storage Array Security Key

    Create Storage Array Security Key This command creates a new security key for a storage array that has Self Encrypting Disk (SED) physical disks. This command also sets the security definitions and sets the state to Security Enabled. NOTE: Before you create a storage array security key, you must set the password for the storage array.
  • Page 148 Additional Information To use this command successfully, you need to have enough SES drives to create atleast one volume group. The controller firmware creates a lock that restricts access to the SES drives. SES drives have a state called Security Capable.
  • Page 149: Create Virtual Disk Copy

    Create Virtual Disk Copy This command creates a virtual disk copy and starts the virtual disk copy operation. CAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and (if applicable, the target disk) to ensure that you capture an accurate point-in-time image of the source virtual disk.
  • Page 150 Parameters Parameter Description Name of an existing virtual disk to use as source the source virtual disk. You must put quotation marks (" ") around the source virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names.
  • Page 151: Delete Disk Group

    Parameter Description Specifies the priority that a virtual disk copyPriority copy has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. NOTE: CopyPriority defines the amount of system resources used to copy the data between the source virtual disk and target virtual disk of a virtual disk-copy pair.
  • Page 152: Delete Host

    Delete Host This command deletes a host. Syntax delete host [hostName] Parameter Parameter Description Name of the host to delete. You must put brackets ([ ]) around the host host name. If the host name has special characters, you must also put quotation marks ("...
  • Page 153: Delete Host Port

    Delete Host Port This command deletes an HBA host port identification. The identification is a software value that represents the physical HBA host port to the RAID controller module. By deleting the identification, the RAID controller module no longer recognizes instructions and data from the HBA host port. Syntax delete hostPort [hostPortName] Parameter...
  • Page 154: Delete Iscsi Initiator

    Delete iSCSI Initiator This command deletes a specific iSCSI initiator object. Syntax delete iscsiInitiator (["iSCSI-ID "| "name"]) Parameters Parameters Description The identifier of the iSCSI initiator that you want to delete. Enclose iSCSI-ID the name in double quotation marks (" "). The name of the iSCSI initiator that you want to delete.
  • Page 155: Diagnose Raid Controller Module

    Parameters Parameter Description Deletes all virtual disks in a storage array. allVirtualDisks NOTE: allVirtualDisks Using the parameter deletes virtual disks until all are removed or until an error is encountered. If an error is encountered, this command does not attempt to delete the remaining virtual disks.
  • Page 156 Syntax diagnose controller [(0 | 1)] loopbackPhysicalDiskChannel=(allchannels | (1 | testID=(1 | 2 | 3) [patternFile=”filename”] Parameters Parameter Description RAID controller module on which to run controller the diagnostic tests. Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure.
  • Page 157: Disable Storage Array Feature

    Parameter Description Identifier for the diagnostic test to run. testID The identifier and corresponding tests are: 1 — Reads the test 2 — Write test 3 — Data loop-back test NOTE: When you run a data loop-back test, you can optionally specify a file that contains a data pattern.
  • Page 158: Download Enclosure Management Module Firmware

    Additional Information If you specify the remoteMirror parameter, this command disables the Remote Virtual Disk Mirroring premium feature and takes away the structure of the mirror repository virtual disk. To use the High Performance Tier premium feature, you must configure a storage array as: •...
  • Page 159 Parameters Parameter Description Identifies the enclosure to which to load enclosure new firmware. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. You can use the following parameters: allEnclosures • The parameter, which downloads new firmware to all of the EMMs in the storage array...
  • Page 160: Download Physical Disk Firmware

    Download Physical Disk Firmware This command downloads a firmware image to a physical disk. CAUTION: Downloading physical disk firmware incorrectly can result in damage to the physical disks or loss of data. Before attempting to download physical disk firmware, you must take the following precautions: 1 Stop all I/O activity to the storage array before downloading the firmware image.
  • Page 161: Download Storage Array Firmware/Nvsram

    Parameters Parameter Description Physical disk to which to download the physicalDisk firmware image. Specify the enclosure ID and slot ID for the physical 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 slot ID value.
  • Page 162: Download Storage Array Physical Disk Frimware

    Parameter Description File path and name of the file that NVSRAM-filename contains the NVSRAM values. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the NVSRAM file name. You must include a comma after the firmware file name.
  • Page 163: Download Storage Array Nvsram

    Additional Information When you run this command, you can download more than one firmware image file to the physical disks in a storage array. The number of firmware image files that you can download depends on the storage array. The MD storage management software returns an error if you try to download more firmware image files than the storage array can accept.
  • Page 164: Enable Disk Group Security

    Parameter Parameter Description File path and name of the file that file contains the NVSRAM values. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the file name. Enable Disk Group Security This command converts a non-secure disk group to a secure disk group.
  • Page 165: Enable Raid Controller Module Data Transfer

    The RAID controller module firmware creates a lock that restricts access to the SED physical disks. SED physical disks have a state called Security Capable. When you create a security key, the state is set to Security Enabled, which restricts access to all SED physical disks that exist within the storage array.
  • Page 166: Recopy Virtual Disk Copy

    Parameter Parameter Description File path and file name of a valid feature file 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. Additional Information A feature pack is a predefined set of premium features, such as Storage Partitioning and Remote Virtual Disk Mirroring.
  • Page 167 Syntax recopy virtualDiskCopy target [targetName] [source [sourceName]] [copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] Parameters Parameter Description Name of the target virtual disk for which to target reinitiate a virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name.
  • Page 168: Recover Raid Virtual Disk

    Recover RAID Virtual Disk This command creates a RAID virtual disk with the given properties without initializing any of the user data areas on the disks. Parameter values are derived from the Recovery Profile data file for the storage array. NOTE: This command can be run only from the command line.
  • Page 169 Parameter Description The name of the disk group in which you want to diskGroup create the new virtual disk. (To determine the names of the disk groups in your storage array, run the show command.) storageArray profile Name to give the new virtual disk. Enclose the new newDiskGroup virtual disk name in double quotation marks ("...
  • Page 170: Re-Create Snapshot

    Parameter Description The storage array subsystem identifier of a virtual disk. SSID RAID controller module that owns the virtual disk. owner Valid RAID controller module identifiers are 0 or 1, where, 0 is the RAID controller module in Slot 0 and 1 is the RAID controller module in Slot 1.
  • Page 171 Syntax recreate snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) [userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryFullPolicy (failSourceWrites | failSnapshot)] Parameters Parameter Description Name of the specific virtual disk for which to start a virtualDisk or fresh copy-on-write operation. You can enter more virtualDisks than one virtual disk name.
  • Page 172 Additional Information NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. You can recreate a single Snapshot virtual disk or multiple Snapshot virtual disks with optional parameters: •...
  • Page 173: Remove Virtual Disk Copy

    NOTE: If no optional parameters are specified, the recreate snapshot command processes the specified snapshot virtual disks as a batch, provided a validation check of all of the virtual disks runs successfully. If successful, the snapshots start the re-creation process and all of the affected virtual disks (snapshot, source, and repository) are quiesced until the process is complete.
  • Page 174: Repair Virtual Disk Consistency

    Parameters Parameter Description Removes the LUN mapping from all virtual disks. allVirtualDisks Name of the specific virtual disk to remove from the virtualDisk or LUN mapping. You can enter more than one virtual disk virtualDisks name. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name.
  • Page 175: Replace Physical Disk

    Parameters Parameter Description Name of the specific virtual disk for which to repair virtualDisk 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.
  • Page 176: Reset Raid Controller Module

    Parameters Parameter Description Specifies the physical disks to assign to physicalDisk the virtual disk that you want to create. Specify the tray ID and slot ID for each physical disk that you assign to the virtual disk. Tray ID values are 0 to 99. Slot ID values are 0 to 31.
  • Page 177: Reset Storage Array Battery Install Date

    Parameter Parameter Description RAID controller module to reset. Valid RAID controller 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 178: Reset Storage Array Iscsi Baseline

    Parameters Parameter Description Specifies the RAID controller module that contains the battery controller for which to reset the age. 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 179: Reset Storage Array Sas Phy Baseline

    Reset Storage Array SAS PHY Baseline This command resets the SAS physical layer (PHY) baseline for all SAS devices in a storage array. Syntax reset storageArray SASPHYBaseline Parameters None. Reset Storage Array Virtual Disk Distribution This command reassigns (moves) all virtual disks to their preferred RAID controller module.
  • Page 180: Revive Physical Disk

    Parameter Parameter Description Number of the disk group to be set to the optimal state. You diskGroup must put brackets ([ ]) around the disk group number. Revive Physical Disk This command forces the specified physical disk to the optimal state. CAUTION: Correct use of this command depends on the data configuration on all physical disks in the disk group.
  • Page 181: Save Physical Disk Channel Fault Isolation Diagnostic Status

    Save Physical Disk Channel Fault Isolation Diagnostic Status This command saves the physical disk channel fault isolation diagnostic data that is returned from the start physical disk channel fault isolation diagnostics command. You can save the diagnostic data to a file as standard text or as XML.
  • Page 182: Save Raid Controller Module Nvsram

    Parameter Parameter Description Name of the file to which to write the log sense data. You logFile must put quotation marks (" ") around the file name. Save RAID Controller Module NVSRAM This command saves a copy of the RAID controller module NVSRAM values to a file.
  • Page 183 Parameters Parameter Description Name of the file that contains the configuration values. file You must put quotation marks (" ") around the file name. Saves all of the configuration values to the file. (If you allConfig choose this parameter, all of the configuration parameters are set to TRUE.) Saves the global settings to the file.
  • Page 184: Save Storage Array Events

    Save Storage Array Events This command saves events from the Major Event Log (MEL) to a file. You can save either all the events or only the critical events. Syntax save storageArray (allEvents | criticalEvents) file="filename" [count=numberOfEvents] Parameters Parameter Description Name of the file to which to save the events.
  • Page 185: Save Storage Array Performance Statistics

    Parameters Parameter Description This parameter defines that the statistics collected are all statistics from the RAID controller module start-of-day. Enclose the parameter in square brackets ([ ]). This parameter defines that the statistics collected are all baseline statistics from the time the RAID controller modules were reset to zero using the reset storageArray iscsiStatsBaseline command.
  • Page 186: Save Storage Array Sas Phy Counts

    Save Storage Array SAS PHY Counts This command saves the storage array SAS PHY counters to a file. Syntax save storageArray SASPHYCounts file="filename" Parameter Parameter Description Name of the file to which to save the storage array SAS file PHY counters. You must put quotation marks (" ") around the file name.
  • Page 187: Set Disk Group

    • The persistent registration information and the persistent reservation information • Detailed information about the current status of the storage array • The diagnostic data for the physical disk • A recovery profile for the storage array • The unreadable sectors that are detected on the storage array •...
  • Page 188: Set Disk Group Forced State

    Parameter Description Identifies the physical disk by tray and slot location to include in addPhysical the disk group. Tray ID values are 0 to 99. Slot ID values are 0 Disks to 31. You must put parentheses around the tray ID values and the slot ID values.
  • Page 189: Set Enclosure Attribute

    Set Enclosure Attribute This command sets user-defined attributes for an enclosure. Syntax set enclosure [enclosureID] (chassisName | assetTag)= "userID" Parameters Parameter Description enclosureID Identifies a specific enclosure for which to set the attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value.
  • Page 190: Set Foreign Physical Disk To Native

    Parameters Parameter Description Service tag of the RAID enclosure or the enclosure expansion enclosure for which you are setting the enclosure ID. You must put quotation marks (" ") around the Service Tag. Specifies the value for the RAID enclosure or expansion enclosure ID.
  • Page 191: Set Host

    Parameters Parameter Description The tray and the slot where the physical disk physicalDisk or resides. Tray ID values are 0 to 99. Slot ID values physicalDisks are 0 to 31. Enclose the tray ID values and the slot ID values in square brackets ([ ]). Selects all the physical disks.
  • Page 192: Set Host Channel

    Parameter Description The new host name. Enclose the host name in double quotation userLabel marks (" "). The index label or number of the host type for the HBA host port. hostType Use the show storageArray hostTypeTable command to generate a list of available host type identifiers.
  • Page 193 Syntax set hostChannel [hostChannelNumber] preferredID=portID Parameters Parameter Description The identifier number of the host channel for hostChannel which you want to set the loop ID. The host channel identifier number is constructed by combining the controller number and the host channel number. Enclose the host channel identifier number in square brackets ([ ]).
  • Page 194: Set Host Group

    Set Host Group This command renames a host group. Syntax set hostGroup [hostGroupName] userLabel="newHostGroupName" Parameters Parameter Description Name of the host group to rename. You must put hostGroup brackets ([ ]) around the host group name. If the host group name has special characters, you must also put quotation marks ("...
  • Page 195: Set Iscsi Initiator

    Parameters Parameter Description The name of the HBA host port for which you want to change the hostPort host type, or for which you want to create a new name. Enclose the HBA host port name in square brackets ([ ]). If the HBA host port label has special characters, enclose the HBA host port label in double quotation marks ("...
  • Page 196 Parameter Description The password that you want to use to authenticate a peer connection. chapSecret NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a “secret.” A secret is a security key that is similar to a password. NOTE: chapSecret Use the...
  • Page 197: Set Iscsi Target Properties

    Set iSCSI Target Properties This command defines properties for an iSCSI target. Syntax set iscsiTarget [“iscsiID”] authenticationMethod=(none | chap) | chapSecret=”securityKey” | targetAlias=”userLabel” Parameters Parameter Description The iSCSI target for which you want to iSCSIID set properties. Enclose the name in double quotation marks (“...
  • Page 198: Set Physical Disk Channel Status

    Set Physical Disk Channel Status This command defines how the physical disk channel performs. Syntax set physicalDiskChannel [(1 | 2 )] status=(optimal | degraded) Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to set the status. Valid physical disk channel values are 1 or 2.
  • Page 199: Set Physical Disk State

    Parameters Parameter Description The tray and the slot where the physical disk physicalDisk or resides. Tray ID values are 0 to 99. Slot ID values physicalDisks are 0 to 31. Enclose the tray ID values and the slot ID values in square brackets ([ ]). The setting to assign the physical disk as the hot hotSpare spare.
  • Page 200: Set Raid Controller Module

    Set RAID Controller Module This command defines the attributes for the RAID controller modules. Syntax set controller [(0 | 1)] availability=(online | offline | serviceMode) | ethernetPort [(1 | 2)]=ethernetPortOptions | globalNVSRAMByte [nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | hostNVSRAMByte [hostType, nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | IPv4GatewayIP=ipAddress |...
  • Page 201 Parameter Description The attributes (options) for the management ethernetPort Ethernet ports. The entries to support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, and the subnet mask address. A portion of the RAID controller module NVSRAM.
  • Page 202 Syntax Element Statement Data Options for the Ethernet Port Parameter enableIPv4=(TRUE | FALSE) | enableIPv6=(TRUE | FALSE) | IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0- FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) | IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0- FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0- FFFF) | IPv4Address=(0-255).(0-255).(0-255).(0-255) | IPv4ConfigurationMethod=[(static | dhcp)] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) duplexMode=(TRUE | FALSE) | portSpeed=[(autoNegotiate | 10 | 100 | 1000)] IPv4Address=(0-255).(0-255).(0-255).(0-255) | IPv6LocalAddress=(0-FFFF):(0-FFFF):(0- FFFF):(0FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-...
  • Page 203 Options for the Ethernet Port Parameter IPv6Priority=[0-7] | IPv4SubnetMask=(0-255).(0-255).(0-255).(0-255) IPv4VlanId=[1-4094] | IPv6VlanId=[1-4094] | maxFramePayload=[frameSize] | tcpListeningPort=[3260, 49152-65536] | portSpeed=[(autonNegotiate | 100 | 1000) Additional Information When you use this command, you can specify one or more of the parameters. You do not need to use all of the parameters. Setting the availability parameter to serviceMode causes the alternate RAID controller module to take ownership of all of the virtual disks.
  • Page 204: Set Session

    The portSpeed option is expressed as megabits per second (Mb/s). The following values are the default values for the iscsiHostOptions: • The IPv6HopLimit option is 64. • The IPv6NdReachableTime option is 30000 milliseconds. • The IPv6NdRetransmitTime option is 1000 milliseconds. •...
  • Page 205: Set Snapshot Virtual Disk

    Parameter Description The frequency of gathering performance performanceMonitorInterval data. Enter an integer value for the polling interval, in seconds, for which you want to capture data. The range of values is 3 to 3600 seconds. The default value is 5 seconds. performanceMonitorIterations The number of samples to capture.
  • Page 206 Parameters Parameter Description The name of the specific snapshot virtual disk for virtualDisk or which you want to define properties. (You can virtualDisks enter more than one virtual disk name if you use the virtualDisks parameter). Enclose the snapshot virtual disk name in double quotation marks (“...
  • Page 207: Set Storage Array

    Set Storage Array This command defines the properties of the storage array. Syntax set storageArray (alarm=(enable | disable | mute) autoSupportConfig (enable | disable) | cacheBlockSize=cacheBlockSizeValue | cacheFlushStart=cacheFlushStartSize | cacheFlushStop=cacheFlushStopSize | defaultHostType=(“hostTypeName” | hostTypeIdentifier) failoverAlertDelay=delayValue | mediaScanRate=(disabled | 1-30) | password=”password”...
  • Page 208 Parameter Description The setting for automatically collecting support autoSupportConfig data each time the firmware detects a critical MEL event. This parameter has these values: • enable—Turns on the collection of support data • disable—Turns off the collection of support data The cache block size that is used by the RAID cacheBlockSize controller module for managing the cache.
  • Page 209 Parameter Description The password for the storage array. Enclose the password password in double quotation marks (“ ”). The name for the storage array. Enclose the storage userLabel array name in double quotation marks (“ ”). The method to register the iSCSI target with the isnsRegistration iSNS server.
  • Page 210 You can run the set storageArray autoSupportConfig command on more than one storage array. Cache Block Size When you define cache block sizes, use the 4-KB cache block size for storage arrays that require I/O streams that are typically small and random. Use the 8- KB cache block size when the majority of your I/O streams are larger than 4 KB but smaller than 8 KB.
  • Page 211: Set Storage Array Enclosure Positions

    Media Scan Rate Media scan runs on all of the virtual disks in the storage array that have optimal status, do not have modification operations in progress, and have the mediaScanRate parameter enabled. Use the set virtualDisk command to enable or disable the mediaScanRate parameter. NOTE: If you are using self encrypting disk physical disks in your storage array, you must use these criteria for your storage array password.
  • Page 212: Set Storage Array Icmp Response

    Additional Information This command defines the position of an enclosure in a storage array by the position of the enclosure ID in the enclosurePositions list. For example, if you have a RAI enclosure with an ID set to 84 and expansion enclosures with IDs set to 1, 12, and 50, the enclosurePositions sequence (84 1 12 50) places the RAID enclosure in the first position, expansion enclosure 1 in the second position, expansion enclosure 12 in the third position, and expansion...
  • Page 213: Set Storage Array Isns Server Ipv4 Address

    Set Storage Array iSNS Server IPv4 Address This command sets the configuration method and address for an IPv4 Internet Storage Name Service (iSNS). Syntax set storageArray isnsIPv4ConfigurationMethod= [static | dhcp] isnsIPv4Address=ipAddress Parameter Parameter Description The IP address that you want to use for the iSNS server. isnsIPv4Address Use this parameter with the static value for IPv4 configurations.
  • Page 214: Set Storage Array Isns Server Listening Port

    Set Storage Array iSNS Server Listening Port This command sets the iSNS server listening port. Syntax set storageArray isnsListeningPort= listeningPortIPAddress Parameter Parameter Description The IP address that you want to use for the iSNS server isnsListeningPort listening port. The range of values for the listening port is 49152 to 65535.
  • Page 215: Set Storage Array Redundancy Mode

    Parameters Parameter Description daysToNextLearnCycle Valid values are 0 through 7, where, 0 is immediately and 7 is in seven days. The daysToNextLearnCycle parameter takes place up to seven days after the next scheduled learn cycle. Valid values for the day parameter include the days of the week.
  • Page 216: Set Storage Array Security Key

    Set Storage Array Security Key Use this command to set the security key that is used throughout the storage array to implement the Physical Disk Security premium feature. When any security-capable physical disk in the storage array is assigned to a secured disk group, that physical disk is security-enabled using the security key.
  • Page 217: Set Storage Array Time

    Set Storage Array Time This command sets the clocks on both RAID controller modules in a storage array by synchronizing the RAID controller module clocks with the clock of the host from which you run this command. Syntax set storageArray time Parameters None.
  • Page 218: Set Virtual Disk

    Set Virtual Disk This command defines the properties for a virtual disk. You can use most of the parameters to define properties for one or more virtual disks, however, some of the parameters define properties for only one virtual disk at a time. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk.
  • Page 219 segmentSize=segmentSizeValue userLabel=virtualDiskName preReadRedundancyCheck=(TRUE | FALSE) Syntax Applicable to Virtual Disk Mapping set (virtualDisk [“virtualDiskName”] | virtualDisk <wwID> | accessVirtualDisk) logicalUnitNumber=LUN (host=”hostName” | hostGroup=(“hostGroupName” | defaultGroup) Parameters Parameter Description Specifies the properties for all virtual disks in allVirtualDisks the storage array. Specifies the name of the virtual disk for virtualDisk or which to define properties.
  • Page 220 Parameter Description cacheWithoutBatteryEnabled The setting to turn on or turn off caching without batteries. To turn on caching without batteries, set this parameter to TRUE. To turn off caching without batteries, set this parameter to FALSE. The setting to turn on or turn off media scan mediaScanEnabled for the virtual disk.
  • Page 221 Parameter Description The setting to turn on or turn off cache read cacheReadPrefetch prefetch. To turn off cache read prefetch, set this parameter to FALSE. To turn on cache read prefetch, set this parameter to TRUE. The setting to increase the storage size addCapacity (capacity) of the virtual disk for which you are defining properties.
  • Page 222 Parameter Description The setting to check the consistency of RAID preReadRedundancyCheck redundancy data on the stripes during read operations. Do not use this operation for nonredundant virtual disks, for example RAID Level 0. To check redundancy consistency, set this parameter to TRUE. For no stripe checking, set this parameter to FALSE.
  • Page 223: Set Virtual Disk Copy

    Set Virtual Disk Copy This command defines the properties for a virtual disk copy pair. Syntax set virtualDiskCopy target [targetName] [source [sourceName]] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE) Parameters Parameter Description Specifies the name of the target virtual disk for which target to define properties.
  • Page 224: Show Current Iscsi Sessions

    Show Current iSCSI Sessions This command displays information about an iSCSI session for either an iSCSI initiator or iSCSI target. Syntax When running from the command line, use: show iscsiInitiator [\“initiatorName\”] iscsiSessions show iscsiTarget [\“targetName\”] iscsiSessions When running from a script file, use: show iscsiInitiator [“initiatorName”] iscsiSessions show iscsiTarget [“targetName”] iscsiSessions...
  • Page 225: Show Disk Group

    Show Disk Group This command returns the following information about a disk group: • Status (online or offline) • Physical disk type (SAS or SATA) • Enclosure loss protection (yes or no) • Current owner (RAID controller module 0 or RAID controller module 1) •...
  • Page 226: Show Disk Group Import Dependencies

    Parameter Parameter Description Number of the disk group for which to display diskGroup information. You must put brackets ([ ]) around the disk group number. Show Disk Group Import Dependencies This command shows a list of dependencies for the physical disks in a disk group that you want to move from one storage array to a second storage array.
  • Page 227: Show Host Ports

    Show Host Ports For all HBA host ports connected to a storage array, this command returns the following information: • HBA host port identifier • HBA host port name • HBA host type Syntax show allHostPorts Parameters None. Additional Information This command returns SAS HBA host port information similar to this example.
  • Page 228 – Status – Capacity – Data transfer rate – Product ID – Firmware level • Physical disk channel information: – Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long.
  • Page 229 Parameters Parameter Description Returns information about all physical disks in allPhysicalDisks the storage array. NOTE: To determine information about the type and location of all physical disks in the storage allPhysicalDisks array, use the parameter. retrieve information. Valid physical disk media driveMediaType are these: •...
  • Page 230: Show Physical Disk Channel Statistics

    Show Physical Disk Channel Statistics This command shows cumulative physical disk channel data transfer and error information. If the RAID controller module has automatically degraded a channel, this command also shows interval statistics. When using this command, you can display information about one specific physical disk channel, several physical disk channels, or all physical disk channels.
  • Page 231: Show Raid Controller Module

    NOTE: When all firmware downloads have successfully completed, this command Successful returns a status. If any firmware downloads fail, this command shows the firmware download status of each targeted physical disk. This command returns the status values shown in the following table. Status Definition Successful...
  • Page 232: Show Raid Controller Module Nvsram

    Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. Returns information about a specific RAID controller module in controller 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 233: Show Storage Array

    Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array. Returns information about a specific RAID controller module in controller 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 234 Parameters Parameter Description Displays all properties of the logical and physical profile components that comprise the storage array. The information returned takes several screens to display. NOTE: 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 235: Show Storage Array Auto Configure

    Parameter Description Displays the health, logical properties, and healthStatus physical component properties of the storage array. Displays a table of all host types known to the hostTypeTable RAID controller module. Each row in the table displays a host type index and the platform the index represents.
  • Page 236 Syntax show storageArray autoConfiguration [physicalDiskType=(SAS | SATA) raidLevel=(0 | 1 | 5 | 6) diskGroupWidth=numberOfPhysicalDisks diskGroupCount=numberOfDiskGroups virtualDisksPerGroupCount=hotSpareCount= numberOfHotspares segmentSize=segmentSizeValue cacheReadPrefetch=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description Type of physical disk to use for the storage array. Valid physicalDiskType physical disk types are SAS or SATA.
  • Page 237: Show Storage Array Host Topology

    Parameter Description Amount of data (in kilobytes) that the RAID controller segmentSize module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure Command"...
  • Page 238: Show Storage Array Lun Mappings

    Show Storage Array LUN Mappings This command returns information from the storage array profile about the storage array LUN mappings. If you run this command with no parameters, this command returns all LUN mappings. Syntax show storageArray lunMappings [host ["hostName"] | hostgroup ["hostGroupName"]] Parameters Parameter...
  • Page 239: Iscsi Initiators

    Show Storage Array Unconfigured iSCSI Initiators This command returns a list of initiators that have been detected by the storage array but are not yet configured into the storage array topology. Syntax show storageArray unconfiguredIscsiInitiators Parameters None. Show Storage Array Unreadable Sectors This command returns a table of the addresses of all of the sectors in the storage array that cannot be read.
  • Page 240: Show String

    Show String This command shows a string of text from a script file. This command is similar to the echo command in MS-DOS and UNIX. Syntax show “textString” Parameters None. NOTE: You must enclose the string in double quotation marks (“ ”). Show Virtual Disk For the virtual disks in a storage array, this command returns the following information:...
  • Page 241 – The write cache without batteries status (enabled or disabled) – The write cache with mirroring status (enabled or disabled) – The flush write cache after time – The cache read prefetch setting (TRUE or FALSE) – The enable background media scan status (enabled or disabled) –...
  • Page 242: Show Virtual Disk Action Progress

    Show Virtual Disk Action Progress For a long-running operation that is currently running on a virtual disk, this command returns information about the virtual disk action and amount of the long-running operation completed. The completed amount of the long- running operation is shown as a percentage (for example, 25 means that 25 percent of the long-running operation is completed).
  • Page 243: Show Virtual Disk Copy Source Candidates

    Syntax show virtualDiskCopy (allVirtualDisks | source ["sourceName"] | target ["targetName"]) Parameters Parameter Description allVirtualDisks Returns information about virtual disk copy operations for all virtual disk copy pairs. Name of the source virtual disk about which to retrieve source information. You must put quotation marks (" ") and brackets ([ ]) around the source virtual disk name.
  • Page 244: Show Virtual Disk Copy Target Candidates

    Virtual Disk Name: engineering Capacity: 4.0 GB Disk Group: 2 Show Virtual Disk Copy Target Candidates This command returns information about the candidate virtual disks that you can use as the target for a virtual disk copy operation. Syntax show virtualDiskCopy source ["sourceName"] targetCandidates Parameters Parameter...
  • Page 245: Show Virtual Disk Reservations

    Parameters Parameter Description allvirtualDisks The setting to return performance statistics about all of the virtual disks in the storage array. Name of the source virtual disk for which you are trying to virtualDisk or find a candidate target virtual disk. You must put quotation virtualDisks marks ("...
  • Page 246: Start Configuration Database Diagnostic

    Start Configuration Database Diagnostic This command starts a diagnostic test to validate the configuration database in the controller firmware. Syntax Start storageArray configDbDiagnostic Parameters None. Notes Upon completion of the diagnostic test, the controller firmware returns one of these results: •...
  • Page 247: Start Disk Group Blink

    In addition, the database configuration diagnostic test can be started using the storage management software GUI but cannot be stopped using the storage management software GUI. If you want to stop a running diagnostic test, you must use the stop storageArray configDbDiagnostic command.
  • Page 248: Start Disk Group Export

    Start Disk Group Export This command moves a disk group into an Exported state. Then you can remove the physical disks that comprise the disk group and reinstall the physical disks in a different storage array. NOTE: Within the disk group, you cannot move virtual disks that are associated with the premium features from one storage array to another storage array.
  • Page 249: Start Disk Group Import

    Start Disk Group Import This command moves a disk group into a Complete state to make a newly introduced disk group available to its new storage array. The disk group must be in an Exported state or a Forced state before you run this command. Upon successfully running the command, the disk group is operational.
  • Page 250: Start Iscsi Dhcp Refresh

    Parameter Parameter Description Identifies the enclosure to blink. Enclosure ID enclosure values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. Start iSCSI DHCP Refresh This command initiates a refresh of the DHCP parameters for the iSCSI interface.
  • Page 251: Start Physical Disk Blink

    Start Physical Disk Blink This command blinks a physical disk by turning on an indicator light on the physical disk. Run the stop physicalDisk blink command to turn off the indicator light on the physical disk. Syntax start physicalDisk [enclosureID,slotID] blink Parameter Parameter Description...
  • Page 252: Start Physical Disk Channel Fault Isolation Diagnostics

    Start Physical Disk Channel Fault Isolation Diagnostics This command runs the physical disk channel fault isolation diagnostics and stores the results. Syntax start physicalDiskChannel [(1 | 2 )] controller [(0 | 1)] faultDiagnostics testDevices=[(all | controller=(0 | 1) | emms=[enclosureID1 (left | right), enclosureID2 (left | right)...
  • Page 253: Start Physical Disk Initialize

    Parameter Description The hexadecimal data pattern you want to use to run patternNumber the test. This number can be any hexadecimal number between 0000 to FFFF. The number of errors that you want to accept before maxErrorCount terminating the test. The number of times that you want to repeat the test.
  • Page 254: Start Physical Disk Reconstruction

    Start Physical Disk Reconstruction This command starts reconstructing a physical disk. Syntax start physicalDisk [enclosureID,slotID] reconstruct Parameters Parameter Description Identifies the enclosure and slot where the physical disk resides. physicalDisk Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value.
  • Page 255: Start Storage Array Blink

    Parameters Parameter Description Identifies the enclosure and slot where the physical disk resides. physicalDisk Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot physicalDisks ID value.
  • Page 256: Start Virtual Disk Initialization

    Start Virtual Disk Initialization This command starts the formatting of a virtual disk in a storage array. NOTE: Initializing a virtual disk is a long-running operation that you cannot stop. Syntax start virtualDisk [virtualDiskName] initialize Parameter Parameter Description Name of the virtual disk for which to start the formatting. You virtualDisk must put brackets ([ ]) around the virtual disk name.
  • Page 257: Stop Disk Group Blink

    Stop Disk Group Blink This command turns off the indicator LED on the physical disk that was turned on by the start diskGroup blink command. Syntax stop diskGroup blink Parameters None. Stop Enclosure Blink This command turns off the indicator LED on the enclosure that was turned on by the start enclosure blink command.
  • Page 258: Isolation Diagnostics

    Syntax stop physicalDiskChannel blink Parameters None. Stop Physical Disk Channel Fault Isolation Diagnostics This command stops the physical disk port fault isolation diagnostics, which stops the start physicalDisk channel fault isolation diagnostics command before it completes. Syntax stop physicalDiskChannel faultDiagnostics Parameters None.
  • Page 259: Stop Snapshot

    Stop Snapshot This command stops a copy-on-write operation. Syntax stop snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) Parameter Parameter Description Name of the virtual disk for which to start the formatting. You virtualDisk must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put virtualDisks quotation marks ("...
  • Page 260: Stop Storage Array Physical Disk Firmware Download

    Parameter Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]). Stop Storage Array Physical Disk Firmware Download This command stops a firmware download to the physical disks in a storage array that was started with the download storageArray physicalDiskFirmware command.
  • Page 261: Validate Storage Array Security Key

    Parameters Parameter Description Name of the target virtual disk for which to stop a virtual disk copy target operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks ("...
  • Page 262 Additional Information Your pass phrase must meet these criteria: • The pass phrase must be between eight and 32 characters long. • The pass phrase must contain at least one uppercase letter. • The pass phrase must contain at least one lowercase letter. •...
  • Page 263 Script Commands...
  • Page 264: 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 265 //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 266 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 267: 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 268 The following syntax is the general form of the create virtualDisk command shown in the previous example: create virtualDisk raidLevel=(0 | 1 | 5 | 6) userLabel="virtualDiskName" physicalDisks= (enclosureID0,slotID0... enclosureIDn,slotIDn) [capacity=virtualDiskCapacity | owner=(0 | 1) | segmentSize=segmentSizeValue] [enclosureLossProtect=(TRUE | FALSE)] Sample Script Files...
  • Page 269 Sample Script Files...
  • Page 270: Updated Commands

    CLI Command Updates This chapter lists out the difference in commands that are used in the PowerVault MD3200 Series and the PowerVault MD3600i Series storage arrays. CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands.
  • Page 271 CLI Command Updates...
  • Page 272: Index

    Index commands, 16 usage examples, 27 activate storage array clocks, RAID controller module, firmware, 115 synchronizing, 95 adding comments to a script, 41 collecting physical disk data, 99 assigning global hot spares, 59 command formatting rules, 106 autoconfigure storage array, 115 command line interface, how to autoconfigure storage array hot use, 14...
  • Page 273 create RAID virtual disk, manual Snapshot Virtual Disk, 74-75 physical disk select, 137 virtual disk, 154 storage array, 44 detailed error reporting, 24 storage partitioning, 89 determining copying Virtual Disk Copy candidates, 79 virtual disk, 81 what is on your storage array, 44 create diagnosing RAID controller disk group, 123...
  • Page 274 enclosure assigning global hot spares, 59 set physical disk hot spare, 218 commands, 109 enclosure loss protection, 52 how to use the command line interface, 14 enclosure management module firmware download, 158 exit status, 25 initializing physical disk, 102 virtual disk, 103 interaction with other foreign physical disk features, 88...
  • Page 275 reconstructing a physical disk, 102 partitioning, storage, 89 recopy performance tuning, 96 virtual disk, 86, 166 persistent reservations, recopying virtual disk, 85 removing, 94 recover physical disk RAID Virtual Disk, 168 commands, 110 RAID virtual disk, 168 download firmware, 160 recovery operations, 100 initializing, 102 locating, 95...
  • Page 276 reset storage array SAS PHY usage guidelines, 40 baseline, 179 segment size, changing, 97 restarting a Snapshot Virtual session command, 112 Disk, 74-75 Set, 187 revive disk group, 179 enclosure id, 189 physical disk, 180 foreign physical disk to routine maintenance, 91 native, 190 running host group, 194...
  • Page 277 physical disk channel start statistics, 230 disk group blink, 247 physical disk download disk group defragment, 247 progress, 230 enclosure blink, 249 RAID controller module, 231 physical disk initialize, 253 RAID controller module physical disk reconstruction, 254 NVSRAM, 232 storage array blink, 255 storage array autoconfigure, 235 virtual disk initialization, 256 storage array command, 233...
  • Page 278 13 Virtual Disk Copy command, 115 synchronizing RAID controller show, 242 module clocks, 95 stop, 260 syntax elements viewing properties, 82 ISCSI values, 39 virtual disk copy remove, 173 troubleshooting storage array, 99 user-defined parameters, 70 virtual disk check consistency, 118...
  • Page 279 Index...