Dell PowerVault MD3000i Command Line Interface Guide
Dell PowerVault MD3000i Manual
 |
View all Dell PowerVault MD3000i manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell PowerVault MD3000i manual content summary:
- Dell PowerVault MD3000i | Command Line Interface Guide - Page 1
Dell™ PowerVault™ Modular Disk Storage Manager CLI Guide www.dell.com | support.dell.com - Dell PowerVault MD3000i | Command Line Interface Guide - Page 2
to hardware or loss of data and tells you how to avoid the problem. Information in this document is subject to change without notice. © 2008 Dell Inc. permission of Dell Inc. is strictly forbidden. Trademarks used in this text: Dell, the DELL logo, and PowerVault are trademarks of Dell Inc.; - Dell PowerVault MD3000i | Command Line Interface Guide - Page 3
Contents 1 About the Command Line Interface . . . . 13 How to Use the Command Line Interface 14 Usage Notes 15 CLI Commands 16 Command Line Parameters 18 Formatting Considerations 24 Detailed Error Reporting 24 Exit Status 25 Usage Examples 27 2 About the Script Commands 29 Script Command - Dell PowerVault MD3000i | Command Line Interface Guide - Page 4
the Storage Array Password 56 Setting Up SMTP and SNMP Alerts 56 Setting the RAID Controller Module Clocks . . . . 57 Setting the Storage Array Host Type 57 Setting Modification Priority 58 Assigning Global Hot Spares 59 4 Using the Snapshot Feature 61 Using Host Servers to Create an Initial - Dell PowerVault MD3000i | Command Line Interface Guide - Page 5
Servers to Recopy a Virtual Disk 85 Recopying the Virtual Disk 86 Stopping a Virtual Disk Copy 87 Removing Copy Pairs 87 Interaction with Other Features 88 Storage Partitioning 88 Snapshot Virtual Disks 89 Contents 5 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 6
a Storage Array 91 Routine Maintenance 91 Running a Media Scan 91 Running a Consistency Check 93 Resetting a RAID Controller Module 94 Enabling RAID Controller Module Data Transfer 94 Resetting Battery Age 94 Removing Persistent Reservations 94 Synchronizing RAID Controller Module - Dell PowerVault MD3000i | Command Line Interface Guide - Page 7
Group Commands 108 Enclosure Commands 108 Host Topology Commands 109 iSCSI Commands 109 Physical Disk Commands 110 RAID Controller Module Commands 111 Session Command 111 Show String Command 111 Snapshot Commands 111 Storage Array Commands 111 Virtual Disk Commands 113 Virtual Disk Copy - Dell PowerVault MD3000i | Command Line Interface Guide - Page 8
Copy 150 Recover RAID Virtual Disk 151 Re-create Snapshot 153 Remove Virtual Disk Copy 155 Remove Virtual Disk LUN Mapping 156 Repair Virtual Disk Consistency 157 Reset RAID Controller Module 157 Reset Storage Array Battery Install Date . . . . . 158 Reset Storage Array iSCSI Baseline 158 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 9
159 Reset Storage Array Virtual Disk Distribution . . . 159 Revive Disk Group 160 Revive Physical Disk 160 Save Enclosure Log Data 161 Save Physical Disk Log 161 Save RAID Controller Module NVSRAM 162 Save Storage Array Configuration 162 Save Storage Array Events 163 Save Storage Array iSCSI - Dell PowerVault MD3000i | Command Line Interface Guide - Page 10
Show RAID Controller Module 200 Show RAID Controller Module NVSRAM . . . . . 201 Show Storage Array 202 Show Storage Array Autoconfigure 204 Show Storage Array Host Topology 206 Show Storage Array LUN Mappings 206 Show Storage Array Negotiation Defaults . . . . . 206 Show Storage Array Pending - Dell PowerVault MD3000i | Command Line Interface Guide - Page 11
217 Start Storage Array Blink 217 Start Virtual Disk Initialization 217 Stop Disk Group Blink 218 Stop Enclosure Blink 218 Stop iSCSI Session 218 Stop Physical Disk Blink 219 Stop Snapshot 219 Stop Storage Array Blink 220 Stop Storage Array Physical Disk Firmware Download 220 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 12
12 Contents - Dell PowerVault MD3000i | Command Line Interface Guide - Page 13
to the storage array. See the User's Guide, which describes the Storage Manager software that is used to create and manage multiple storage arrays. For additional information, see the hardware and software manuals that shipped with your system. NOTE: Always check for updates on support.dell.com and - Dell PowerVault MD3000i | Command Line Interface Guide - Page 14
remove storage arrays from the management domain. • Perform automatic discovery of all storage arrays attached to the local subnet. • Add or delete Simple Network Management Protocol (SNMP) trap destinations and email alert notifications. • Specify the mail server and sender email address or Simple - Dell PowerVault MD3000i | Command Line Interface Guide - Page 15
the command line interface storageArray Host name or IP address of the storage array parameters CLI parameters that define the environment and command is installed under the client directory of the selected path during a management station install of the MD Storage Manager software. NOTE: The - Dell PowerVault MD3000i | Command Line Interface Guide - Page 16
-name-or-IP-address [host-name-or-IPaddress] [-c "command; {command2};"] [-n storage-array-name | -w WWID] [-o outputfile][-p password][-e][-S] SMcli host-name-or-IP-address [host-name-or-IP-address] [-f scriptfile] [-n storage-array-name | -w WWID] [-o outputfile] [-p password] [-e] [-S] 16 About - Dell PowerVault MD3000i | Command Line Interface Guide - Page 17
][-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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 18
specify the host-name-or-IP-address of the redundant array of independent disks (RAID) controller modules. • If you have previously configured a storage array in the graphical user interface (GUI) of the MD Storage Manager, you can specify the storage array by its user-supplied name by using the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 19
syntax checking when executing the current CLI command. Use to specify the email address from which all alerts will be sent. Use to specify a file name containing script commands intended to run on the specified storage array. This parameter is similar to the -c parameter in that both are intended - Dell PowerVault MD3000i | Command Line Interface Guide - Page 20
and support bundle information is included in the email. NOTE: You can enter only one information argument each time you execute the command. If you want all of the information, you must run the command three times. Use with the -d parameter to display the IP address of the known storage arrays. Use - Dell PowerVault MD3000i | Command Line Interface Guide - Page 21
must use the -n parameter if more than one storage array is connected to the host at the specified address. The storage array name is required when host-name-or-IP-address is not used; however, the name of the storage array configured for use in the MD Storage Manager GUI (that is, listed in the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 22
every 24 hours. Use with the -a or -x parameter to specify the name of a management station. The name of a management station can be either direct_sa (out-of-band storage array) or host_sa (in-band storage arrays [host-agent]). The -r parameter enables you to set or change the alert notifications - Dell PowerVault MD3000i | Command Line Interface Guide - Page 23
and the relationship between the devices. Use the configuration file to reconstruct a storage array.) Use to remove an SNMP trap destination or an email address alert destination. The community is the SNMP community name for the trap, and the host is the IP address or DNS host name of the system to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 24
string literal) within a script command. For example, you cannot enter the following string to set the storage array name to "Finance"Array: -c "set storageArray userLabel= \"\"Finance\"Array\";" On a Linux operating system, the delimiters around names or labels are single quotation marks (' '). The - Dell PowerVault MD3000i | Command Line Interface Guide - Page 25
which by default is the "client/data" directory under the main installation directory in storage array is not at the specified address. Addresses specify different storage arrays. A storage array name does not exist for the host agent connected. The storage array name was not at the specified address - Dell PowerVault MD3000i | Command Line Interface Guide - Page 26
The WWID was not at the address. An unknown IP address was specified. The event monitor configuration file was corrupted. The storage array was unable to communicate with the event monitor. The RAID controller module was unable to write alert settings. The wrong management station was specified. The - Dell PowerVault MD3000i | Command Line Interface Guide - Page 27
create a new virtual disk on a storage array. The existing virtual disk name is Stocks_ - Dell PowerVault MD3000i | Command Line Interface Guide - Page 28
example shows how to display all storage arrays that are currently discovered in the current configuration. The command in this example returns the host name of each storage array. SMcli -d If you want to know the IP address of each storage array in the configuration, add the -i parameter to the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 29
• Passes the commands to the storage array At the storage array, the redundant array of independent disks (RAID) controller modules in the storage array runs the script commands. The script engine and script commands support the storage array configuration and management operations listed in Table - Dell PowerVault MD3000i | Command Line Interface Guide - Page 30
configuration region at the bit and byte level, displaying nonvolatile static random access memory (NVSRAM) values Retrieving the enclosure profile display data Setting the battery installation date Downloading RAID controller module, enclosure management module (EMM), and physical disk firmware - Dell PowerVault MD3000i | Command Line Interface Guide - Page 31
replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Use an object type when the command is not referencing a specific object. The all parameter means all objects of the specified type in the storage array Object Type controller physicalDisk physicalDiskChannel host - Dell PowerVault MD3000i | Command Line Interface Guide - Page 32
Identifier Target virtual disk and, optionally, the source virtual disk user labels Virtual disk group number Statement data is in the form define and manage the different aspects of a storage array (such as host topology, physical disk configuration, RAID controller module configuration, virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 33
object {statement-data} Transfers data to the storage array or hardware associated with the storage array. enable object {statement-data} Allows a feature errors found by the check command. reset object {statement-data} Returns the hardware or object to an initial state. resume object Starts a - Dell PowerVault MD3000i | Command Line Interface Guide - Page 34
that you can use with the syntax. Table 2-4. Recurring Syntax Elements Recurring Syntax raid-level snapshot-repository-raid-level capacity-spec segment-size-spec boolean user-label user-label-list create-raid-vol-attr-value-list Syntax Value (0 | 1 | 5) (1 | 5) integer-literal [KB | MB | GB | TB - Dell PowerVault MD3000i | Command Line Interface Guide - Page 35
-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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 36
iscsi-host-port-options Syntax Value IPV4Address=ipv4-address | IPV6LocalAddress=ipv6-address | IPV6RoutableAddress=ipv6-address | IPV6RouterAddress=ipv6-address parameter to TRUE to ensure that the specific IPV4 or IPV6 setting is applied. NOTE: The IPV6 address space is 128 bits. It is represented - Dell PowerVault MD3000i | Command Line Interface Guide - Page 37
repository-spec count-based-repository-spec WWID repositoryRAIDLevel with repositoryPhysicalDisks. Do not specify RAID level or physical disks with a from any one enclosure, the storage array returns an error. If you set enclosureLossProtect=FALSE, the storage array performs operations, but the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 38
=raid-level | diskGroupWidth=integer-literal | diskGroupCount=integer-literal | virtualDisksPerGroupCount=integerliteral| hotSpareCount=integer-literal | segmentSize=segment-size-spec NOTE: The physicalDiskType parameter is not required if only one type of physical disk is in the storage array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 39
-virtual-disk-copy-attr-value-pair recover-raid-virtual-disk-attr-value-list recover-raid-virtual-disk-attr-value-pair Syntax Value create 255 (default value is 64) 0 to 256 0 to 65535 (default value is 30000 milliseconds) 0 to 65535 (default value is 1000 milliseconds) 0 to 65535 (default value is - Dell PowerVault MD3000i | Command Line Interface Guide - Page 40
The default value user label exactly as it is defined, or the CLI and script commands will fail. 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 41
occurs when a comment is placed at the end of a script and you did not press the Enter key. // Deletes the existing configuration. clear storageArray Configuration; 2 The script engine interprets any text typed between / * and * / as a comment. If the script engine does not find both a beginning and - Dell PowerVault MD3000i | Command Line Interface Guide - Page 42
42 About the Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 43
host groups, hosts, and RAID controller modules. Additional information about configuring a storage array and related definitions is in the online help, the Installation Guide, the MD Storage Manager User's Guide, and the Owner's Manual. Configuring a RAID storage array requires caution and planning - Dell PowerVault MD3000i | Command Line Interface Guide - Page 44
level and the segment size settings. Data protection is determined by the RAID level, hardware redundancy (such as global hot spares), and software redundancy (such as the Snapshot feature). In general, you configure a storage array by defining the following entities: • A disk group and associated - Dell PowerVault MD3000i | Command Line Interface Guide - Page 45
features in the storage array • The battery age • The default host type (which is the current host type) • Other available host types • The hot spare locations • The identifiers for enabled features • The logical and physical component profiles • The time to which both RAID controller modules are - Dell PowerVault MD3000i | Command Line Interface Guide - Page 46
the specific components of a storage array. controller ("RAID Controller Module Commands" on page 111) • show physicalDisks ("Show Physical Disk" on page 196) • show physicalDiskchannels stats ("Show Physical Disk Channel Statistics" on page 198) • show storageArray hostTopology ("Show Storage Array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 47
also return information about a storage array: • show storageArray autoConfigure ("Show Storage Array Autoconfigure" on page 204) • show controller NVSRAM ("Show RAID Controller Module NVSRAM" on page 201) • show storageArray unreadableSectors ("Show Storage Array Unreadable Sectors" on page 207 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 48
group to a virtual disk. Creating Virtual Disks with User-Assigned Physical Disks When you create a new virtual disk and assign the physical disks to use, the MD Storage Manager software creates a new disk group. The RAID controller module firmware assigns a disk group number to the new disk group - Dell PowerVault MD3000i | Command Line Interface Guide - Page 49
RAID controller module, the RAID controller module firmware determines the owner of the virtual disk. The segmentSize parameter is the same as described for the autoConfigure storageArray command. See "Using the Auto Configure , but 10 GB will not return an error). Configuring a Storage Array 49 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 50
have a RAID level of 5 (RAID 5). The Storage Manager software then chooses the physical disks on which the virtual disk is created. The RAID controller module firmware your configuration. You which allows the user to assign the Storage Manager assigns the physical disks as opposed to when a user - Dell PowerVault MD3000i | Command Line Interface Guide - Page 51
Disks with Software-Assigned Physical the previous create virtualDisk command, however, in this case the user does not know which physical disks are assigned to this If you do not know the disk group numbers on the storage array, you can use the show allVirtualDisks summary command. This command - Dell PowerVault MD3000i | Command Line Interface Guide - Page 52
have enclosure returns an error. loss protection. The RAID controller module firmware assigns the physical disks. The storage array posts an The storage array performs the error if the RAID controller operation even if it means that module firmware cannot the disk group might not have provide - Dell PowerVault MD3000i | Command Line Interface Guide - Page 53
automatically creates the disk groups, virtual disks, and hot spares. The RAID controller modules assign disk group and virtual disk numbers as they are created. After MD Storage Manager creates the initial configuration, you can use the set virtualDisk command to define virtual disk labels. Before - Dell PowerVault MD3000i | Command Line Interface Guide - Page 54
storage array can support. When you specify the number of disk groups, the firmware creates RAID controller module returns a list of valid values. If the virtual disk is for a single user with large I/O requests (such as multimedia), performance is maximized when a single I/O request can be serviced - Dell PowerVault MD3000i | Command Line Interface Guide - Page 55
set commands to modify a storage array configuration. This section explains how to modify the following properties: • Storage array password • Simple Mail Transport Protocol (SMTP) and Simple Network Management Protocol (SNMP) alerts • RAID controller module clocks Configuring a Storage Array 55 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 56
run all of the script commands. A password protects the storage array from any command that the RAID controller modules consider destructive. A destructive command is any command that can change the state of the storage array, such as virtual disk creation, reset, delete, rename, or change. If you - Dell PowerVault MD3000i | Command Line Interface Guide - Page 57
host log files. The RAID controller modules remain available during synchronization. An example of the command is: client>smcli 123.45.67.89 -c "set storageArray time;" Setting the Storage Array Host Type The set storageArray command enables you to define the default host type. The following syntax - Dell PowerVault MD3000i | Command Line Interface Guide - Page 58
RAID controller modules communicate with the operating system on undefined hosts connected to the storage array. This parameter defines the host type only for storage array data I/O activities; it does not define the host type for the management how to define a specific default host type: client> - Dell PowerVault MD3000i | Command Line Interface Guide - Page 59
• Initialization • Changing segment size • Defragmentation of a disk group • Adding free capacity to a disk group • Changing the RAID level of a . Assigning Global Hot Spares Hot spare physical disks can replace any failed physical disk in the storage array. The hot spare must be the same type of - Dell PowerVault MD3000i | Command Line Interface Guide - Page 60
the list. Separate the enclosure ID and slot ID of a physical disk by a comma. Separate each enclosure ID and slot ID pair by a space. 60 Configuring a Storage Array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 61
, the Installation Guide, the MD Storage Manager User's Guide, and the Owner's Manual. The 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 - Snapshot Virtual Disks" in the User's Guide - Dell PowerVault MD3000i | Command Line Interface Guide - Page 62
virtual disk and make it accessible to any host on a storage area network. You can make snapshot data available to secondary snapshot virtual disks is one-half of the total number of virtual disks supported by the RAID controller module. • Increase the capacity of a snapshot virtual disk. Table 4-1 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 63
Initial Snapshot Virtual Disk NOTICE: Before using the Snapshot Virtual Disks Premium Feature in a Microsoft® Windows® clustered configuration, you must first map the snapshot virtual disk to the cluster Dell PowerEdge™ Cluster SE600W Systems Installation and Troubleshooting Guide on support.dell. - Dell PowerVault MD3000i | Command Line Interface Guide - Page 64
not specific virtual disk name, the storage management software provides default values for the other storage array configuration. When you choose the physical disks for your snapshot virtual disk, you automatically create a new disk group. You can specify which physical disks to use and the RAID - Dell PowerVault MD3000i | Command Line Interface Guide - Page 65
an Initial Snapshot User's Guide for more information. 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 additional instructions for your operating system. Failure to follow these additional instructions can - Dell PowerVault MD3000i | Command Line Interface Guide - Page 66
the optional parameters as needed to help define your configuration. You do not, however, need to use an Initial Snapshot Virtual Disk" on page 65. The following example shows a command in which users a new disk group. The new disk group has a RAID level of 5. This command also takes a snapshot of - Dell PowerVault MD3000i | Command Line Interface Guide - Page 67
to Create an Initial Snapshot Virtual Disk" storage management software determines which physical disks to use. You can also define how much space to assign to the repository virtual disk. Because you are using an existing disk group, the RAID level for the snapshot virtual disk defaults to the RAID - Dell PowerVault MD3000i | Command Line Interface Guide - Page 68
)] NOTE: Use one or all of the optional parameters as needed to define your configuration. It is not necessary to use any optional parameters. The following example is a command in which software assigns the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 69
RAID level for the snapshot repository virtual disk. This version of the create snapshotVirtualDisk command creates a new disk group. You must have physical disks in the storage array configuration. It is not necessary to use any optional parameters. The following example is a command in which users - Dell PowerVault MD3000i | Command Line Interface Guide - Page 70
repository virtual disk. Free storage space is defined in units of bytes, kilobytes, megabytes, or gigabytes. 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 71
do not choose a name for the snapshot repository virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the The default value is failSnapShot. The following example of the create snapshotVirtualDisk command includes user-defined - Dell PowerVault MD3000i | Command Line Interface Guide - Page 72
user. If you do not choose to create names for the snapshot virtual disks or the repository virtual disks, the RAID controller modules provide default line. Make sure that you use unique names or the RAID controller module firmware returns an error. One technique for naming the snapshot virtual disk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 73
aaa-Rn. In the examples from the previous section, the user-defined name of the snapshot virtual disk was Mars_Spirit_4_snap1. The user-defined name of the repository virtual disk was Mars_Spirit_4_rep1. The default name provided by the RAID controller module for the snapshot virtual disk would be - Dell PowerVault MD3000i | Command Line Interface Guide - Page 74
starts running. As long as a snapshot virtual disk is enabled, storage array performance is affected by the copy-on-write operations to the associated snapshot -3"]; When you stop the copy-on-write operations for a specific snapshot virtual disk, only that snapshot virtual disk is disabled. - Dell PowerVault MD3000i | Command Line Interface Guide - Page 75
NOTE: Removing the drive letter of the associated virtual disk in Windows or unmounting the virtual drive in Linux will help to guarantee a stable copy of the drive for the Snapshot. and press . See "SMrepassist Utility" in the User's Guide for more information. Using the Snapshot Feature 75 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 76
Linux to help guarantee a stable copy of the drive for the Snapshot. If this is not done, the snapshot operation will report that it has completed successfully, but the snapshot data will not be updated properly. 4 Follow any additional instructions for your operating system. Failure to follow these - Dell PowerVault MD3000i | Command Line Interface Guide - Page 77
the online help, the Installation Guide, the MD Storage Manager User's Guide, and the Owner's Manual. NOTE: If you ordered Premium Features for Virtual Disk Copy, you received a Premium Features Activation card shipped in the same box as your Dell PowerVault™ MD storage array. Follow the directions - Dell PowerVault MD3000i | Command Line Interface Guide - Page 78
the Virtual Disk Copy feature. recopy virtualDiskCopy Re-initiates a virtual disk copy operation by using an existing ensure that a suitable target virtual disk exists on the storage array, or create a new target virtual disk specifically for the virtual disk copy. The target virtual disk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 79
. Enabling the Virtual Disk Copy Feature The first step in creating a virtual disk copy is to make sure the feature is enabled on the storage array. You need a feature key to enable the feature. To enable the feature key file, use the command: enable storageArray feature file="filename" where the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 80
and press . See "SMrepassist Utility" in the User's Guide for more information. 3 Remove the drive letter(s) of the source and (if mounted) virtual disk 4 Follow any additional instructions for your operating system. Failure to follow these additional instructions can create unusable virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 81
optional parameters as needed to help define your configuration. It is not necessary to use any optional setting write permission. - In Windows, assign a drive letter to the virtual disk. - In Linux medium provides a compromise between the following storage array operations: • The speed with which - Dell PowerVault MD3000i | Command Line Interface Guide - Page 82
Setting the targetReadOnlyEnabled parameter to TRUE means that write requests cannot be made to the target virtual disk. This setting also ensures that the data on the target virtual disk remains unaltered. Refer to steps 1 through 4 in the preceding section, "Preparing Host Servers to Create a - Dell PowerVault MD3000i | Command Line Interface Guide - Page 83
the allVirtualDisks parameter. You can also request information about a specific target virtual disk. The following example is the script file to lowest. The highest priority supports the virtual disk copy, but I/O activity might be affected. The lowest priority supports I/O activity, but the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 84
to the target virtual disk. You can use the set virtualDiskCopy command to reset the read/write permission for the target virtual disk. NOTE: If you Use one or both of the parameters as needed to help define your configuration. It is not necessary to use either parameter. The following example shows - Dell PowerVault MD3000i | Command Line Interface Guide - Page 85
Reset the copy priority for the recopy operation by using the recopy virtualDiskCopy command. The higher priorities allocate storage array resources to the virtual disk copy at the expense of storage array Utility" in the User's Guide for more information. Using the Virtual Disk Copy Feature 85 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 86
drive for the virtual disk. If this is not done, the copy operation will report that it has completed successfully, but the copied data will not be updated properly. 4 Follow any additional instructions optional parameters as needed to help define your configuration. It is not necessary to use any - Dell PowerVault MD3000i | Command Line Interface Guide - Page 87
of the command: stop virtualDiskCopy target ["Obi_1"]; Removing Copy Pairs The remove virtualDiskCopy command enables you to remove a virtual disk copy pair from the storage array configuration. All virtual disk copy information for the source virtual disk and target virtual disk is removed from the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 88
of In Progress, you must stop the virtual disk copy before you can remove the virtual disk copy pair from the storage array configuration. The following syntax is the general form of the command: remove virtualDiskCopy target [targetName] [source [sourceName]] The following example shows a command - Dell PowerVault MD3000i | Command Line Interface Guide - Page 89
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. The Snapshot Virtual Disk feature can be used with the Virtual Disk Copy feature to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 90
90 Using the Virtual Disk Copy Feature - Dell PowerVault MD3000i | Command Line Interface Guide - Page 91
use to perform storage array maintenance. The commands are organized into four sections: • Routine maintenance • Performance tuning • Troubleshooting and diagnostics • to ensure that the storage array is running as well as possible or to detect conditions before they become problems. Running a Media - Dell PowerVault MD3000i | Command Line Interface Guide - Page 92
consistency information in defined user virtual disks. A media scan runs on all virtual disks in the storage array with the following conditions: retries. The data is reconstructed from the redundant copy, rewritten to the drive, verified, and the error is reported to the MEL. - Recovered media - Dell PowerVault MD3000i | Command Line Interface Guide - Page 93
storageArray command defines how frequently a media scan is run on a storage array. The following syntax is the general form of the command: depends on the redundant array of independent disks (RAID) levels: • RAID 5 virtual disks - Consistency is checked and repaired. • RAID 1 virtual disks - The - Dell PowerVault MD3000i | Command Line Interface Guide - Page 94
, run the following command: enable controller [(0 | 1)] dataTransfer Resetting Battery Age After replacing the batteries in the storage array, you must reset the age of the battery, either for an entire storage array or one battery in a specific RAID controller module. To reset the age to zero days - Dell PowerVault MD3000i | Command Line Interface Guide - Page 95
To synchronize the clocks on both RAID controller modules in a storage array with the host clock, run the following command: set storageArray time Locating Physical Disks At times, you might need to locate a specific physical disk. In very large storage array configurations, this can sometimes be - Dell PowerVault MD3000i | Command Line Interface Guide - Page 96
that you can review to determine how well the storage array is running. Table 6-1 lists the performance information saved to the file. Table 6-1. Storage Array Performance Information Type of Information Description Devices Devices are: • RAID Controller Modules - The RAID controller module in - Dell PowerVault MD3000i | Command Line Interface Guide - Page 97
your operating system can support. The default file type is .csv serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | ) segmentSize=segmentSizeValue Maintaining a Storage Array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 98
a disk group starts a long-running operation. Troubleshooting and Diagnostics If a storage array exhibits abnormal operation or failures, you can use the cause of the problems. Collecting Physical Disk Data To gather information about all the physical disks in a storage array, run the save - Dell PowerVault MD3000i | Command Line Interface Guide - Page 99
the RAID controller module is considered to be in error, and it is failed and placed offline. 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 100
involve replacing failed RAID controller modules and physical disks, restoring data, and restoring the storage array to operation. Setting RAID Controller Module Operational Mode A RAID controller module has three operational modes: • Online • Offline • Service NOTICE: Placing a RAID controller - Dell PowerVault MD3000i | Command Line Interface Guide - Page 101
is required on all hosts and is the only supported configuration. If the multipath driver is not installed, the virtual disks will not be accessible. Before you place a RAID controller module in Service mode, ensure that a multipath driver is installed on all hosts using these virtual disks. To - Dell PowerVault MD3000i | Command Line Interface Guide - Page 102
storage array. You can use this capacity to create additional disk groups and virtual disks. To initialize Optimal status, you must replace the failed physical disks. After replacing the physical disks, reconstruct a RAID 1 or 5 disk group. Initializing a Virtual Disk NOTICE: When you initialize a - Dell PowerVault MD3000i | Command Line Interface Guide - Page 103
is designated to own the virtual disks. The preferred owner for a virtual disk is initially designated when the virtual disk is created. If the preferred RAID controller module is being replaced or undergoing a firmware download, ownership of the virtual disks is automatically shifted to the second - Dell PowerVault MD3000i | Command Line Interface Guide - Page 104
104 Maintaining a Storage Array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 105
the commands by functional activity: - Disk group - Enclosure - Host topology - Physical disk - Redundant array of independent disks (RAID) controller module - Session - Show string - Snapshot - Storage array - Virtual disk - Virtual disk copy • "Commands Listed Alphabetically" on page 114 lists the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 106
you must put brackets around a parameter value. • Parentheses shown in the command syntax enclose specific choices for a parameter. That is, if you want to use the parameter, you must =(0 | 1 | 5) To use the raidLevel parameter to set a RAID level of 5, enter: raidLevel=5 106 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 107
components: - Storage arrays - Host groups RAID controller module firmware returns an error. 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 108
organized into groups related to physical, logical, and operational features of the storage array. Disk Group Commands "Delete Disk Group" on page 137 "Revive Disk Commands "Download Enclosure Management Module Firmware" on page 144 "Save Enclosure Log Data" on page 161 108 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 109
Host Port" on page 174 "Show Host Ports" on page 196 iSCSI Commands "iSCSI Commands" on page 109 "Delete iSCSI Initiator" on page 139 "Reset Storage Array iSCSI Baseline" on page 158 "Save Storage Array iSCSI Statistics" on page 164 "Set Controller" on page 166 "Set Host" on page 171 "Set Host Port - Dell PowerVault MD3000i | Command Line Interface Guide - Page 110
185 "Set Storage Array iSNS Server IPv6 Address" on page 186 "Set Storage Array iSNS Server Refresh" on page 188 "Set Unnamed Discovery Session" on page 188 "Show Current iSCSI Sessions" on page 194 "Show Storage Array Negotiation Defaults" on page 206 "Show Unconfigured iSCSI Initiators" on page - Dell PowerVault MD3000i | Command Line Interface Guide - Page 111
Commands "Diagnose RAID Controller Module" on page 141 "Enable RAID Controller Module" on page 149 "Reset RAID Controller Module" on page 157 "Save RAID Controller Module NVSRAM" on page 162 "Set Controller" on page 166 "Show RAID Controller Module" on page 200 "Show RAID Controller Module NVSRAM - Dell PowerVault MD3000i | Command Line Interface Guide - Page 112
"Download Storage Array Firmware/NVSRAM" on page 146 "Download Storage Array Physical Disk Firmware" on page 148 "Download Storage Array NVSRAM" on page 147 "Enable Storage Array Feature Key" on page 149 "Reset Storage Array Battery Install Date" on page 158 "Reset Storage Array Virtual Disk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 113
RAID Virtual Disk (Automatic Physical Disk Select)" on page 123 "Create RAID Virtual Disk (Free Capacity Base Select)" on page 126 "Create RAID Virtual Disk (Manual Show Virtual Disk Reservations" on page 213 "Start Virtual Disk Initialization" on page 217 Virtual Disk Copy Commands "Create Virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 114
Storage Array Firmware This command activates firmware previously downloaded to the pending configuration area in the RAID controller modules in the storage array. Syntax activate storageArray firmware Parameters None Autoconfigure Storage Array This command automatically configures a storage - Dell PowerVault MD3000i | Command Line Interface Guide - Page 115
for the autoConfigure storageArray command.) The RAID controller modules audit the storage array and then determine the highest RAID level that the storage array can support and the most efficient virtual disk definition for the RAID level. If the configuration described by the returned list is - Dell PowerVault MD3000i | Command Line Interface Guide - Page 116
time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters None. NOTE: When you run the autoconfigure storageArray hotSpares command, the RAID controller module firmware determines the number of hot spares to create based on - Dell PowerVault MD3000i | Command Line Interface Guide - Page 117
| high | medium | low | lowest)] [verbose=(TRUE|FALSE)] Parameters Parameter virtualDisk consistencyErrorFile mediaErrorFile priority verbose Description Name of the specific virtual disk to check consistency. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has - Dell PowerVault MD3000i | Command Line Interface Guide - Page 118
Statistics This command resets the statistics for all physical disk channels. Syntax clear allPhysicalDiskChannels stats Parameters None. Clear Storage Array Configuration This command clears the entire configuration from the RAID controller modules in a storage array. Information that defines - Dell PowerVault MD3000i | Command Line Interface Guide - Page 119
... virtualDiskNamen]) reservations Parameters Parameter allVirtualDisks virtualDisk or virtualDisks Description Clears reservations on all virtual disks in the storage array. Name of the specific virtual disk for which to clear reservations. You can enter more than one virtual disk name. You - Dell PowerVault MD3000i | Command Line Interface Guide - Page 120
, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Create Host This command creates a new host. NOTE: A host is a system that is attached to the storage array and accesses the virtual disks on the storage array through its HBA host ports. You can define specific - Dell PowerVault MD3000i | Command Line Interface Guide - Page 121
30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to software value that represents the physical HBA host port to the RAID controller module. Without the host port identification, the RAID controller module cannot receive instructions - Dell PowerVault MD3000i | Command Line Interface Guide - Page 122
host access to the virtual disks in a storage array. If the host bus adapter has only one replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Create iSCSI Initiator This command creates a new iSCSI initiator object. Syntax create iscsiInitiator iscsiName = iSCSI - Dell PowerVault MD3000i | Command Line Interface Guide - Page 123
is similar to a password. Use chapSecret only for initiators requiring mutual authentication. Create RAID Virtual Disk (Automatic Physical Disk Select) This command creates a disk group across the storage array physical disks, and a new virtual disk in the disk group. The RAID controller modules in - Dell PowerVault MD3000i | Command Line Interface Guide - Page 124
enclosure ID and slot ID. The RAID controller modules choose the specific physical disks to use for the disk group. RAID level of the disk group that contains . The size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, kilobytes, megabytes, or gigabytes - Dell PowerVault MD3000i | Command Line Interface Guide - Page 125
module firmware determines the owner. NOTE: The owner parameter defines which RAID controller module owns the virtual disk. If you do not specify a capacity, all of the available physical disk capacity in the disk group is used. If you do not specify capacity units, bytes are used as the default - Dell PowerVault MD3000i | Command Line Interface Guide - Page 126
Create RAID Virtual Disk 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 If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome - Dell PowerVault MD3000i | Command Line Interface Guide - Page 127
area exists. Size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, kilobytes, megabytes, or gigabytes. NOTE If you do not specify capacity units, bytes are used as the default units. A space must be added between the last digit and the size (MB - Dell PowerVault MD3000i | Command Line Interface Guide - Page 128
controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure Command" on page 53. Create RAID Virtual Disk (Manual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 129
1, or 5. NOTE: If you set the raidLevel parameter to RAID 1, the RAID controller module firmware takes the list of physical disks and pairs them using the following characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this - Dell PowerVault MD3000i | Command Line Interface Guide - Page 130
the virtual disk that you are adding to the storage array. Size is defined in units of bytes, RAID controller module firmware determines the owner. NOTE: The owner parameter defines which RAID controller module owns the virtual disk. The preferred owner of a virtual disk is the RAID controller - Dell PowerVault MD3000i | Command Line Interface Guide - Page 131
group • User-defined number of physical disks for the snapshot virtual disk If you choose to define a number of physical disks, the RAID controller module firmware chooses which physical disks to use for the snapshot virtual disk. NOTE: Refer to "Preparing Host Servers to Create an Initial Snapshot - Dell PowerVault MD3000i | Command Line Interface Guide - Page 132
enclosureLossProtect=(TRUE | FALSE)] Syntax (User-Defined Number of Physical Disks) create which to take a snapshot. You must put quotation marks (" ") around the source virtual disk name. RAID level for the repository virtual disk. Valid values are 0, 1, or 5. Specifies the physical disks to assign - Dell PowerVault MD3000i | Command Line Interface Guide - Page 133
repository capacity at which you receive a warning that the repository is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 50. Script Commands 133 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 134
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 disk. You must maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this - Dell PowerVault MD3000i | Command Line Interface Guide - Page 135
the snapshot virtual disk or repository virtual disk, the RAID controller modules create a default name using the source virtual disk name. For example, if the source virtual disk name is aaa and does not have a snapshot virtual disk, the default snapshot virtual disk name is aaa - 1. If the source - Dell PowerVault MD3000i | Command Line Interface Guide - Page 136
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. Name of an existing virtual disk to use as the target virtual disk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 137
virtual disk copy has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. NOTE: CopyPriority defines the amount of system resources used to copy the data between the source virtual disk and target virtual disk of a virtual disk-copy pair. If you select the highest - Dell PowerVault MD3000i | Command Line Interface Guide - Page 138
, you must also put quotation marks (" ") around the host name. NOTE: A host is a system that is attached to the storage array and accesses the virtual disks on the storage array through its HBA host ports. Delete Host Group This command deletes a host group. NOTICE: This command deletes all of the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 139
disks in a storage array. If the host bus adapter has only one physical connection (one host port), the terms HBA host port and host bus adapter are synonymous. Example -c "delete host [\"job2900\"];" Delete iSCSI Initiator This command deletes a specific iSCSI initiator object. Syntax delete - Dell PowerVault MD3000i | Command Line Interface Guide - Page 140
delete. Enclose the name in double quotation marks (" "). The name of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). allVirtualDisks Description Deletes all virtual disks in a storage array. NOTE: Using the allVirtualDisks parameter deletes virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 141
If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Diagnose RAID Controller Module This command runs diagnostic tests on the RAID controller module. The testID parameter takes the following options, which you can use to verify that - Dell PowerVault MD3000i | Command Line Interface Guide - Page 142
module identifier. If you do not specify a RAID controller module, the storage management software returns a syntax error. Physical disk channel on which to run the diagnostic tests. You can choose to run the diagnostics on all channels or select a specific channel on which to run diagnostics. Valid - Dell PowerVault MD3000i | Command Line Interface Guide - Page 143
module. The discrete line test automatically runs after each power cycle or RAID controller module reset. You can run the discrete lines diagnostic test after you have replaced a component that failed the initial discrete lines diagnostic test. When the test runs successfully, the following - Dell PowerVault MD3000i | Command Line Interface Guide - Page 144
for all enabled features in the storage array. Syntax disable storageArray feature=(snapshot | virtualDiskCopy) Parameters None. Download Enclosure Management Module Firmware This command downloads firmware for the enclosure management module (EMM). Syntax download (allEnclosures | enclosure - Dell PowerVault MD3000i | Command Line Interface Guide - Page 145
use the following parameters: (1) the allEnclosures parameter, which downloads new firmware to all of the EMMs in the storage array, and (2) the enclosure parameter, which downloads new firmware to a specific EMM. If you need to download new firmware to more than one EMM, but not all EMMs, you must - Dell PowerVault MD3000i | Command Line Interface Guide - Page 146
image. You must put quotation marks (" ") around the firmware image file path and file name. Download Storage Array Firmware/NVSRAM This command downloads firmware and, optionally, NVSRAM values for the RAID controller module in the storage array. If you want to download only NVSRAM values, use - Dell PowerVault MD3000i | Command Line Interface Guide - Page 147
. The default value is TRUE. If you set activateNow to FALSE, you must use the activate storageArray firmware command to activate the firmware and NVSRAM values at a later time. Download Storage Array NVSRAM This command downloads NVSRAM values for the storage array RAID controller module. Syntax - Dell PowerVault MD3000i | Command Line Interface Guide - Page 148
image file to the physical disks in a storage array. The number of firmware image files you can download depends on the storage array. The storage management software returns an error if you attempt to download more firmware image files than the storage array can accept. NOTE: You can schedule - Dell PowerVault MD3000i | Command Line Interface Guide - Page 149
rear of the enclosure. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify a RAID controller module, the storage management software returns a syntax error. Enable Storage Array Feature Key This command enables a feature using a feature key file. Syntax - Dell PowerVault MD3000i | Command Line Interface Guide - Page 150
Explorer, to make sure all I/O activity has stopped. NOTE: Removing the drive letter of the associated virtual disk(s) in Windows or unmounting the vitual drive in Linux will help to guarantee a stable copy of the drive for the virtual copy. Syntax recopy virtualDiskCopy target [targetName] [source - Dell PowerVault MD3000i | Command Line Interface Guide - Page 151
defines the amount of system resources used to copy the data 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 152
are adding to the storage array. Size is defined in RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure - Dell PowerVault MD3000i | Command Line Interface Guide - Page 153
the RAID controller module firmware determines the owner. For information about the owner parameter, see "Creating Virtual Disks with User-Assigned drive letter of the associated virtual disk in Windows or unmounting the virtual drive in Linux will help to guarantee a stable copy of the drive - Dell PowerVault MD3000i | Command Line Interface Guide - Page 154
Description Name of the specific virtual disk for which fail writes to the snapshot virtual disk (failSnapShot). The default value is failSnapShot. NOTE: If repositoryFullPolicy is not If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets - Dell PowerVault MD3000i | Command Line Interface Guide - Page 155
the affected virtual disks (snapshot, source, and repository) are quiesced until the process is complete. NOTE: The Microsoft Virtual Shadow Copy Service (VSS) provider allows the recreation of multiple snapshots simultaneously. Remove Virtual Disk Copy This command removes a virtual disk copy pair - Dell PowerVault MD3000i | Command Line Interface Guide - Page 156
mapping from all virtual disks. Name of the specific virtual disk to remove from the LUN mapping. storage array. If you remove an access virtual disk mapping for a storage array from a host that has an agent running on it, the storage management software is no longer able to manage the storage array - Dell PowerVault MD3000i | Command Line Interface Guide - Page 157
of the specific virtual disk RAID controller module being reset, the I/O directed to the RAID controller module is rejected. Before resetting the RAID controller module, either verify that the virtual disks owned by the RAID controller module are not in use or ensure a multipath driver is installed - Dell PowerVault MD3000i | Command Line Interface Guide - Page 158
RAID controller module firmware returns a syntax error. Reset Storage Array Battery Install Date This command resets the age of the batteries in a storage array to zero days. You can reset the batteries for an entire storage array or the battery in a specific RAID controller module. Syntax reset - Dell PowerVault MD3000i | Command Line Interface Guide - Page 159
0 for both RAID controller modules in the storage array. The purpose of resetting both of the RAID controller module baselines is to help ensure that the counts are synchronized between the RAID controller modules. If one RAID controller module resets but the second RAID controller module does not - Dell PowerVault MD3000i | Command Line Interface Guide - Page 160
group must be installed before you attempt to run this command. NOTICE: Correct use of this command depends on the data configuration on all of the physical disks in the disk group. Never attempt to revive a physical disk unless supervised by a Customer or Technical Support - Dell PowerVault MD3000i | Command Line Interface Guide - Page 161
ID value and the slot ID value. Save Enclosure Log Data This command saves the log data maintained by the EMM in all enclosures in a storage array to a file. Syntax save allEnclosures logFile="filename" Parameters Parameter logFile Description Name of the file to which to save the EMM log data - Dell PowerVault MD3000i | Command Line Interface Guide - Page 162
rear of the enclosure. You must put brackets ([ ]) around the RAID controller module identifier. Name of the file in which to save the values. You must put quotation marks (" ") around the file name. Save Storage Array Configuration This command creates a script file to use to create the current - Dell PowerVault MD3000i | Command Line Interface Guide - Page 163
To prevent saving the host topology, set this parameter to FALSE. The default value is FALSE. lunMappings Saves the LUN mapping to the file. To parameters are optional; you do not have to enter any parameters. Save Storage Array Events This command saves events from the Major Event Log (MEL) to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 164
storage array iSCSI performance statistics to a file. The following statistics are saved to the file: • Statistics related to the physical Ethernet port • Statistics related to the TCP protocol • Statistics related to the IP the RAID controller modules were reset to zero using the reset storageArray - Dell PowerVault MD3000i | Command Line Interface Guide - Page 165
If you have not reset the iSCSI baseline statistics since the RAID controller module start-of-day, the time at the start-of-day is the default baseline time. NOTE: (" ") around the file name. Save Storage Array SAS PHY Counts This command saves the storage array SAS PHY counters to a file. Syntax - Dell PowerVault MD3000i | Command Line Interface Guide - Page 166
file="filename" Parameters Parameter file Description Name of the file to which to save the storage array support-related data. You must put quotation marks (" ") around the file name. Set Controller This command defines the attributes for the RAID controller modules. 166 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 167
the firmware for the RAID controller module returns a syntax error. This parameter sets the mode for the RAID controller module to online, offline, or service (serviceMode). This parameter causes a RAID controller module to find a BOOTP server. The BOOTP server then assigns an IP address to the RAID - Dell PowerVault MD3000i | Command Line Interface Guide - Page 168
module to take ownership of all virtual disks. The specified RAID controller module no longer has any virtual disks and refuses to take ownership of any more virtual disks. Service mode is persistent across reset and power cycles until the availability parameter is set to online. NOTE: Use - Dell PowerVault MD3000i | Command Line Interface Guide - Page 169
controller [0] iscsiHostPort[0] IPV6ConfigurationMethod=auto enableIPV6=TRUE;" -c "set controller [0] availability=online;" -c "set controller [0] ethernetPort[1] IPV4Address=192.168.0.101;" -c "set controller raidLevel RAID level for the disk group. Valid values are 0, 1, or 5. Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 170
Parameter owner availability Description RAID controller module that owns the disk group. Valid RAID controller module identifiers are 0 or 1, where 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure. Sets the disk - Dell PowerVault MD3000i | Command Line Interface Guide - Page 171
. Set Enclosure Identification This command sets the ID of an enclosure in a storage array. Syntax set enclosure ["Service Tag"] id=enclosureID Parameters Parameter enclosure id Description Service tag of the RAID enclosure or the expansion enclosure for which you are setting the enclosure ID - Dell PowerVault MD3000i | Command Line Interface Guide - Page 172
Syntax set host [hostName] hostGroup=("hostGroupName" | none | defaultGroup) userLabel="newHostName" hostType=(hostTypeIndexLabel | hostTypeIndexNumber) Parameters Parameter host hostGroup userLabel hostType Description The name of the host that you want to assign to a host group. Enclose the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 173
present host group and is independent partition and is placed under the default placed under the root node. group. defaultGroup The command fails. The maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this - Dell PowerVault MD3000i | Command Line Interface Guide - Page 174
characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Set Host Port This command changes the host type for an HBA host - Dell PowerVault MD3000i | Command Line Interface Guide - Page 175
. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Set iSCSI Initiator This command sets the attributes for an iSCSI initiator. Syntax set iscsiInitiator iscsiName = new-iSCSI-ID | userLabel = new-name | host = new-host - Dell PowerVault MD3000i | Command Line Interface Guide - Page 176
iSCSI target. Syntax set iscsiTarget authenticationMethod = (none | chap) | chapSecret = password | isnsRegistration = (TRUE | FALSE) | targetAlias = user is a security key that is similar to a password. NOTE: Use chapSecret only for initiators requiring mutual authentication. 176 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 177
targetAlias. The targetAlias can have a maximum of 30 characters. Examples -c "set iscsiTarget authenticationMethod = none;" -c "set iscsiTarget [\"iscsi2900\"] targetAlias = \"iscsi2902\";" -c "set iscsiTarget - Dell PowerVault MD3000i | Command Line Interface Guide - Page 178
the optimal parameter to move a degraded channel back to the Optimal state. Use the degraded parameter if the channel is experiencing problems, and the storage array requires additional time for data transfers. Set Physical Disk Hot Spare This command assigns or unassigns one or more physical disks - Dell PowerVault MD3000i | Command Line Interface Guide - Page 179
the continue value.) Specifies the password for the storage array. You must put quotation marks (" ") around the password. NOTE: Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of - Dell PowerVault MD3000i | Command Line Interface Guide - Page 180
an integer value for the polling interval, in seconds, for which you want to capture data. The range of values is 3 to 3600 seconds. The default value is 5 seconds. NOTE: The polling interval you specify remains in effect until you end the session. After you end the session, the polling interval - Dell PowerVault MD3000i | Command Line Interface Guide - Page 181
Description Name of the specific snapshot virtual disk for which values. For example, a value of 70 means 70 percent. The default value is 50. NOTE: You can set this parameter for both exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 182
| mediaScanRate=(disabled | 1-30) | password="password" | userLabel="storageArrayName" Parameters Parameter cacheBlockSize Description Specifies the cache block size used by the RAID controller module for managing the cache. Valid values are 4 (4 KB) or 16 (16 KB), the default value is 4. NOTE - Dell PowerVault MD3000i | Command Line Interface Guide - Page 183
Parameter defaultHostType failoverAlertDelay mediaScanRate password userLabel Description Specifies the default host type of any unconfigured HBA host port to which the RAID controller modules are connected. To generate a list of valid host types for the storage array, enter the show storageArray - Dell PowerVault MD3000i | Command Line Interface Guide - Page 184
The enclosurePositions sequence (1 84 12) places the RAID enclosure in the second position, expansion enclosure 1 in the first position, and expansion enclosure 12 in the third position. Set Storage Array ICMP Response This command returns the default values for negotiable settings for sessions and - Dell PowerVault MD3000i | Command Line Interface Guide - Page 185
NOTE: The Internet Control Message Protocol (ICMP) is used by operating systems in a network to send error messages, such as a requested service is not available or Storage Array iSNS Server IPv4 Address This command sets the configuration method and address for an IPv4 Internet Storage Name Service - Dell PowerVault MD3000i | Command Line Interface Guide - Page 186
automatically allocate reusable network addresses. Example -c "set storageArray isnsIPV4ConfigurationMethod = static isnsIPV4Address = 192.168.0.1;" Set Storage Array iSNS Server IPv6 Address This command sets the address for an IPv6 Internet Storage Name Service (iSNS). Syntax set storageArray - Dell PowerVault MD3000i | Command Line Interface Guide - Page 187
Channel fabric services, and manage both iSCSI and Fibre Channel devices. Set Storage Array iSNS Server Listening Port This command sets the iSNS server listening port. Syntax set storageArray isnsListeningPort = integer Parameter Parameter isnsListeningPort Description The IP address that you - Dell PowerVault MD3000i | Command Line Interface Guide - Page 188
Set Storage Array iSNS Server Refresh This command refreshes the network address information for the iSNS server. This command is valid ;" 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 189
. Set the parameter to FALSE to turn off an unnamed discovery sessions. NOTE: Discovery is the process where initiators determine the targets that are available. Discovery occurs at power-on/initialization and also if the bus topology changes, for example, if an extra device is added. NOTE: An - Dell PowerVault MD3000i | Command Line Interface Guide - Page 190
string of Writes. However, Write Cache does introduce some risk of data loss in the unlikely event of a controller failure. Syntax Applicable to Only One Virtual Disk Set (virtualDisk ["virtualDiskname"] | virtualDisk ) addCapacity=virtualDiskcapacity [addPhysicalDisks=(enclosureID0,slotID0 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 191
. If media scan is disabled at the storage array level, this parameter has no effect. Turns the mirror cache on or off. The default setting is TRUE. To turn the mirror cache off, set this parameter to FALSE. NOTE: Data loss can occur if a RAID controller module fails when cache mirroring is set to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 192
on cache read prefetch, set this parameter to TRUE. The default value is TRUE. Increases storage size (capacity) of the virtual disk for which you are . The default units are bytes. Virtual Disk capacity expansion increases the size of the logical unit that is exposed by the RAID controller. Refer - Dell PowerVault MD3000i | Command Line Interface Guide - Page 193
RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see "Using the Auto Configure logicalUnitNumber. Defines specific virtual disk-to - Dell PowerVault MD3000i | Command Line Interface Guide - Page 194
using this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters. Show Current iSCSI Sessions This command returns information about an - Dell PowerVault MD3000i | Command Line Interface Guide - Page 195
iSCSI initiator or the iSCSI target that you named. 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 196
display information. You must put brackets ([ ]) around the disk group number. Show Host Ports For all HBA host ports connected to a storage array, this command returns the following information: • HBA host port identifier • HBA host port name • HBA host type Syntax show allHostPorts Parameters - Dell PowerVault MD3000i | Command Line Interface Guide - Page 197
- Product ID - Firmware level • Physical disk channel information: - Enclosure location and slot location - Preferred channel - Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long. The physical - Dell PowerVault MD3000i | Command Line Interface Guide - Page 198
storage array firmware version for the specified physical disks. NOTE: To determine the type of physical disk in a specific 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 199
values. Show Physical Disk Download Progress This command returns the status of firmware downloads for the physical disks targeted by the download physicalDisk firmware or download storageArray physicalDiskFirmware commands. Syntax show allPhysicalDisks downloadProgress Parameters None. NOTE - Dell PowerVault MD3000i | Command Line Interface Guide - Page 200
For each RAID controller module in a storage array, this command returns the following information: • Status (Online, Offline) • Current firmware and NVSRAM configuration • Pending firmware and NVSRAM configuration configurations (if any) • Board ID • Product ID • Product revision • Serial number - Dell PowerVault MD3000i | Command Line Interface Guide - Page 201
information about both RAID controller modules in the storage array. Returns information about a specific RAID controller module in the storage array. Valid RAID controller module identifiers are 0 or 1, where 0 is the RAID controller module on the left and 1 is the RAID controller module on the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 202
information about both RAID controller modules in the storage array. Returns information about a specific RAID controller module in the storage array. Valid RAID controller module identifiers are 0 or 1, where 0 is the RAID controller module on the left and 1 is the RAID controller module on the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 203
the drive channel connections. defaultHostType Displays the default host type and host type index. healthStatus Displays the health, logical properties, and physical component properties of the storage array. hostTypeTable Displays a table of all host types known to the RAID controller module - Dell PowerVault MD3000i | Command Line Interface Guide - Page 204
candidates are not available, this command returns candidates for RAID 1 or RAID 0. When you specify auto-configuration properties, the RAID controller modules validate that the firmware can support the properties. Syntax show storageArray autoConfiguration [physicalDiskType=(SAS | SATA) raidLevel - Dell PowerVault MD3000i | Command Line Interface Guide - Page 205
values. hotSpareCount Number of hot spares desired in the storage array. Use integer values. For information about hot spares, see "Assigning Global Hot Spares" on page 59. segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 206
(" ") and brackets ([ ]) around the host group name.The host group name and quotation marks must be inside the brackets. Show Storage Array Negotiation Defaults This statement returns information about connection-level settings that are subject to initiator-target negotiation. 206 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 207
RAID controller module default settings (settings that are the starting point for negotiation), and the current active settings. Example -c "show storageArray iscsiNegotiationDefaults;" Show Storage Array Pending Topology This command identifies the hosts and host groups that the storage management - Dell PowerVault MD3000i | Command Line Interface Guide - Page 208
Type The data is sorted first by virtual disk user label and second by the logical block address (LBA). Each entry in the table corresponds to 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 209
in a storage array, this command returns the following information: • Number of virtual disks • Name • Status • Capacity • RAID level • , disabled) - Write cache status (enabled, disabled) - Write cache without batteries status (enabled, disabled) - Flush write cache after time - Enable background - Dell PowerVault MD3000i | Command Line Interface Guide - Page 210
[summary] Parameters Parameter allVirtualDisks virtualDisk or virtualDisks summary Description Returns information about all virtual disks in the storage array. Specifies the name of the specific virtual disk from which to retrieve information. You can enter more than one virtual disk name. You - Dell PowerVault MD3000i | Command Line Interface Guide - Page 211
attribute setting of the target virtual disk You can retrieve information about a specific virtual disk copy pair or all virtual disk copy pairs in the storage array. Syntax show virtualDiskCopy (allVirtualDisks | source ["sourceName"] | target ["targetName"]) Parameters Parameter Description - Dell PowerVault MD3000i | Command Line Interface Guide - Page 212
and quotation marks must be inside the brackets. Show Virtual Disk Performance Statistics This command returns information about the performance of the virtual disks in a storage array. 212 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 213
Parameters Parameter allVirtualDisks virtualDisk or virtualDisks Description Returns performance statistics for all of the virtual disks in the storage array. Name of the specific virtual disk for which you are retrieving performance statistics. You can enter more than one virtual disk name - Dell PowerVault MD3000i | Command Line Interface Guide - Page 214
Parameters Parameter allVirtualDisks virtualDisk or virtualDisks Description Returns reservation information about all virtual disks in the storage array. Name of the specific virtual disk for which you are retrieving reservation information. You can enter more than one virtual disk name. You must - Dell PowerVault MD3000i | Command Line Interface Guide - Page 215
ID value. Start iSCSI DHCP Refresh This command initiates a refresh of the DHCP parameters for the iSCSI interface. If the configuration method for the interface [iscsi-host-port] dhcpRefresh Parameter Parameter iscsi-host-port Description The identifier of the port on the storage array on - Dell PowerVault MD3000i | Command Line Interface Guide - Page 216
NOTE: This operation ends the iSCSI connections for the portal and brings down the portal temporarily. Start Initialize This command starts physical disk initialization. NOTICE: As soon as you enter this command, all user data is destroyed. Syntax start physicalDisk [enclosureID,slotID] initialize - Dell PowerVault MD3000i | Command Line Interface Guide - Page 217
.) Syntax start storageArray blink Parameters None. Example -c "start storageArray blink ;" 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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 218
turns off the indicator LED on the enclosure that were turned on by the start enclosure blink command. Syntax stop enclosure blink Parameters None. Stop iSCSI Session This command forces the termination of an iSCSI session Syntax stop storageArray iscsiSession [integer] 218 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 219
integer Description The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]). Stop ] Parameters Parameter Description virtualDisk or virtualDisks Name of the specific virtual disk for which to stop a copyon-write operation - Dell PowerVault MD3000i | Command Line Interface Guide - Page 220
storageArray blink Parameters None. Example -c "stop storageArray iscsiSession [5];" Stop Storage Array Physical Disk Firmware Download This command stops a firmware download to the physical disks in a storage array that was started with the download storageArray physicalDiskFirmware command. This - Dell PowerVault MD3000i | Command Line Interface Guide - Page 221
Parameters Parameter target source Description Name of the target virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the - Dell PowerVault MD3000i | Command Line Interface Guide - Page 222
222 Script Commands - Dell PowerVault MD3000i | Command Line Interface Guide - Page 223
storage array to other storage arrays. You can also use this file to restore an existing configuration that has become corrupted. You can also copy an existing file to serve as a pattern from which you create a new script file by modifying portions of the original file. The default "Create RAID 5 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 224
show "Setting additional attributes for virtualDisk 7"; //Configuration settings that cannot be set during virtualDisk creation on a monitor screen when the script file runs. In this example, the text Create RAID 5 Virtual Disk 7 on existing Disk Group 1 serves as a title describing the expected - Dell PowerVault MD3000i | Command Line Interface Guide - Page 225
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 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 226
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 define specific physical disks to include in the virtual disk. To find out what physical disks are available in a storage array, run - Dell PowerVault MD3000i | Command Line Interface Guide - Page 227
The following syntax is the general form of the create virtualDisk command shown in the previous example: create virtualDisk raidLevel=(0 | 1 | 5) userLabel="virtualDiskName" physicalDisks= (enclosureID0,slotID0... enclosureIDn,slotIDn) [capacity=virtualDiskCapacity | owner=(0 | 1) | segmentSize= - Dell PowerVault MD3000i | Command Line Interface Guide - Page 228
228 Sample Script Files - Dell PowerVault MD3000i | Command Line Interface Guide - Page 229
, 117 clear physical disk channel statistics, 118 storage array configuration, 118 storage array event log, 118 storage array firmware pending, 119 virtual disk reservations, 119 CLI commands, 16 usage examples, 27 clocks, RAID controller module, synchronizing, 95 collecting physical disk data - Dell PowerVault MD3000i | Command Line Interface Guide - Page 230
show, 195 stop blink, 218 download enclosure management module firmware, 144 physical disk firmware, 145 storage array firmware NVSRAM, 146 storage array NVSRAM, 147 storage array physical disk firmware, 148 E enable RAID controller module, 149 storage array feature key, 149 Virtual Disk Copy, 64 - Dell PowerVault MD3000i | Command Line Interface Guide - Page 231
, 120 delete host, 138 show storage array host topology, 206 topology commands, initializing physical disk, 101 virtual disk, 102 interaction with other features, 88 ISCSI recurring syntax values, 39 iSCSI commands, 109 L locating physical disks, 95 M media scan, running, 91 modifying configuration - Dell PowerVault MD3000i | Command Line Interface Guide - Page 232
disk LUN mapping, 156 repair virtual disk consistency, 157 reset RAID controller module, 157 storage array SAS PHY counters, 158 storage array virtual disk distribution, 159 reset a RAID controller module, 94 reset storage array iSCSI baseline, 158 restarting a Snapshot Virtual Disk, 74-75 revive - Dell PowerVault MD3000i | Command Line Interface Guide - Page 233
address, 186-187 set storage array iSNS server listening port, 186 set storage array iSNS server refresh, 188 set unnamed discovery session, 188 setting controller clocks, 57 modification priority, 58 RAID controller module operational mode, 100 storage array host type, 57 storage array password - Dell PowerVault MD3000i | Command Line Interface Guide - Page 234
progress, 199 RAID controller module, 200 RAID controller module NVSRAM, 201 storage array autoconfigure, 204 storage array command, 202 storage array host topology, 206 storage array LUN mappings, 206 storage array unreadable sectors, 207 string, 111, 208 unconfigured iSCSI initiators, 208 virtual - Dell PowerVault MD3000i | Command Line Interface Guide - Page 235
, 88 support.dell.com, 13 synchronizing RAID controller module clocks, 95 syntax elements ISCSI values, 39 T troubleshooting storage array, 98 U user-defined parameters, 70 V virtual disk check consistency, 117 commands, 113 copying, 81 creating in an existing disk group, 51 creating with software - Dell PowerVault MD3000i | Command Line Interface Guide - Page 236
236 Index
-
1 -
2 -
3 -
4 -
5 -
6 -
7 -
8
-
9
-
10
-
11
-
12
-
13
-
14
-
15
-
16
-
17
-
18
-
19
-
20
-
21
-
22
-
23
-
24
-
25
-
26
-
27
-
28
-
29
-
30
-
31
-
32
-
33
-
34
-
35
-
36
-
37
-
38
-
39
-
40
-
41
-
42
-
43
-
44
-
45
-
46
-
47
-
48
-
49
-
50
-
51
-
52
-
53
-
54
-
55
-
56
-
57
-
58
-
59
-
60
-
61
-
62
-
63
-
64
-
65
-
66
-
67
-
68
-
69
-
70
-
71
-
72
-
73
-
74
-
75
-
76
-
77
-
78
-
79
-
80
-
81
-
82
-
83
-
84
-
85
-
86
-
87
-
88
-
89
-
90
-
91
-
92
-
93
-
94
-
95
-
96
-
97
-
98
-
99
-
100
-
101
-
102
-
103
-
104
-
105
-
106
-
107
-
108
-
109
-
110
-
111
-
112
-
113
-
114
-
115
-
116
-
117
-
118
-
119
-
120
-
121
-
122
-
123
-
124
-
125
-
126
-
127
-
128
-
129
-
130
-
131
-
132
-
133
-
134
-
135
-
136
-
137
-
138
-
139
-
140
-
141
-
142
-
143
-
144
-
145
-
146
-
147
-
148
-
149
-
150
-
151
-
152
-
153
-
154
-
155
-
156
-
157
-
158
-
159
-
160
-
161
-
162
-
163
-
164
-
165
-
166
-
167
-
168
-
169
-
170
-
171
-
172
-
173
-
174
-
175
-
176
-
177
-
178
-
179
-
180
-
181
-
182
-
183
-
184
-
185
-
186
-
187
-
188
-
189
-
190
-
191
-
192
-
193
-
194
-
195
-
196
-
197
-
198
-
199
-
200
-
201
-
202
-
203
-
204
-
205
-
206
-
207
-
208
-
209
-
210
-
211
-
212
-
213
-
214
-
215
-
216
-
217
-
218
-
219
-
220
-
221
-
222
-
223
-
224
-
225
-
226
-
227
-
228
-
229
-
230
-
231
-
232
-
233
-
234
-
235
-
236
 |
 |
www.dell.com | support.dell.com
Dell™ PowerVault™ Modular Disk
Storage Manager CLI Guide