Contents Notes, Cautions, and Warnings....................2 1 About The Command Line Interface..................11 ......................11 How To Use The Command Line Interface ..............................12 Usage Notes ..............................12 CLI Commands ..........................14 Command Line Parameters ............................18 Formatting Considerations ............................18 Detailed Error Reporting ................................19 Exit Status ..............................20 Usage Examples 2 About The Script Commands....................23 .............................23...
Page 4
..........................46 Creating A Snapshot Virtual Disk ....................47 Enabling The Snapshot Virtual Disk Feature ............47 Creating A Snapshot Virtual Disk With User-Assigned Physical Disks ..............47 Preparing Host Servers To Create An Initial Snapshot Virtual Disk ......................48 Creating The Initial Snapshot Virtual Disk ............49 Creating A Snapshot Virtual Disk With Software-Assigned Physical Disks ..........49...
Page 5
..................71 Enabling The Remote Replication Premium Feature ..................71 Activating The Remote Replication Premium Feature ..................73 Determining Candidates For A Remote Replicated Pair ........................73 Creating A Remote Replicated Pair ........................74 Changing Remote Replication Settings ..................75 Suspending And Resuming A Replication Relationship ........................75 Removing A Replication Relationship .................76...
Page 6
8 Script Commands........................89 ............................89 Command Formatting Rules ..........................91 Firmware Compatibility Levels ..........................91 Commands Listed By Function .............................91 Disk Group Commands ............................91 Enclosure Commands ..........................91 Host Topology Commands ..............................92 iSCSI Commands ..........................92 Physical Disk Commands ........................93 RAID Controller Module Commands ........................93 Remote Replication Commands ............................94 Session Command...
Page 7
................116 Create RAID Virtual Disk (Manual Physical Disk Select) ......................119 Create RAID Virtual Disk On A Disk Pool ..........................120 Create Remote Replication .........................122 Create Snapshot Virtual Disk ............................126 Scheduling Snapshots ........................127 Create Storage Array Security Key ..........................129 Create Virtual Disk Copy ........................130 Deactivate Remote Replication ............................130...
Page 8
............................152 Replace Physical Disk ........................153 Reset RAID Controller Module .......................154 Reset Storage Array Battery Install Date ......................154 Reset Storage Array iSCSI Baseline ......................155 Reset Storage Array SAS PHY Baseline ....................155 Reset Storage Array Virtual Disk Distribution ..........................155 Resume Remote Replication ..........................156 Resume Snapshot Rollback ............................156...
Page 9
..........................180 Set Snapshot Virtual Disk ............................181 Set Storage Array ......................183 Set Storage Array Enclosure Positions ........................184 Set Storage Array ICMP Response ....................184 Set Storage Array iSNS Server IPv4 Address ....................185 Set Storage Array iSNS Server IPv6 Address ....................185 Set Storage Array iSNS Server Listening Port ........................185 Set Storage Array Learn Cycle ......................186...
Page 10
......................207 Start Configuration Database Diagnostic ............................208 Start Disk Group Blink .........................208 Start Disk Group Defragment ..........................208 Start Disk Group Export ..........................209 Start Disk Group Import ............................209 Start Disk Pool Locate ............................209 Start Enclosure Blink ..........................210 Start iSCSI DHCP Refresh ..........................210 Start Physical Disk Blink ........................211 Start Physical Disk Channel Blink...
The command line interface gives you direct access to a script engine utility in the Dell PowerVault Modular Disk Storage Manager software (MD Storage Manager). The script engine reads the commands, or runs a script file, from the command line and performs the operations instructed by the commands.
A CLI command consists of the following elements: • The term SMcli • Storage array identifier • Parameters • Script commands 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 13
Table 1. Command Name Conventions Parameter Definition pipe symbol indicating alternative ("a" or "b") italicized-words terminals [...] (square brackets) zero or one occurrence {...} (curly brackets) zero or more occurrences <...> (angle brackets) occurrence exceeds maximum limit of 30 characters (a|b|c) choose only one of the alternatives bold...
Page 15
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. You can include more than one script command after the -c parameter.
Page 16
Parameter Definition • eventOnly— Only event information is included in the e-mail. • profile— Event and array profile information is included in the e-mail. • supportBundle— Event and support bundle information is included in the e-mail. NOTE: You can enter only one information argument each time you execute the command.
Page 17
Parameter Definition everyEvent. If you set the-I parameter to either profile or supportBundle, this information is included with the e-mails with the frequency specified by the-q parameter. Valid frequency arguments are: • everyEvent— Information is returned with every e-mail alert notification. •...
Parameter Definition array configuration and the relationship between the devices. Use the configuration file to reconstruct a storage array). -x (lowercase) Use to remove an SNMP trap destination or an e-mail 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 which you want the trap sent.
When an exception occurs while executing a command, the CLI automatically saves the error information to a file named excprpt.txt. The CLI attempts to place excprpt.txt in the directory specified by the system property devmgr.datadir, which by default is the "client/data" directory under the main installation directory in Windows and the /var/opt/SM directory in Linux.
Status Value Meaning The wrong management station was specified. The command was not available. The device was not in the configuration file. An error occurred while updating the configuration file. An unknown host error occurred. The sender contact information file was not found. The sender contact information file could not be read.
Page 21
This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example. The parameter runs the file without checking syntax. Executing an SMcli command without checking syntax enables the file to run more quickly; however, the SMcli command may not execute correctly if the syntax is incorrect. SMcli -n Example -f scriptfile.scr -e This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example.
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 24
command identifies the action to be performed, operand-data represents the storage array component to where, statement-data is what you configure or manage (such as a RAID controller module, physical disk, or disk group), and want to do to the component (such as, specifying the RAID level or availability of a disk group). The general form of the syntax for operand-data is as follows: (object-type | allobject-types | [qualifier] (object-type [identifier] {object-type...
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). Script Command Synopsis Because you can use the script commands to define and manage the different aspects of a storage array (such as host topology, physical disk configuration, RAID controller module configuration, virtual disk definitions, and disk group definitions), the actual number of commands is extensive.
Command Syntax Description object resume Starts a suspended operation. The operation begins where it left off when suspended. object revive Forces the object from the Failed to the Optimal state. Use only as part of an error recovery procedure. object { statement‑data } save Writes information about the object to a file.
Page 28
Recurring Syntax Syntax Value integer | IPV4VlanID= integer | IPV6VlanID= integer | maxFramePayload= tcp-port-id | tcpListeningPort= NOTE: You must set the enableIPV4 parameter or the enableIPV6 parameter to TRUE to ensure that the specific IPV4 or IPV6 setting is applied. NOTE: The IPV6 address space is 128 bits.
Page 29
Recurring Syntax Syntax Value 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-pair autoconfigure-vols-attr-value-list autoconfigure-vols-attr-value-pair } autoconfigure-vols-attr-value-pair physicalDiskType=physical disk-type| raidLevel=raid-level | diskGroupWidth=integer-literal | diskGroupCount=integer-literal | integerliteral | virtualDisksPerGroupCount= hotSpareCount= integer-literal | segment-size-spec segmentSize= NOTE: The physicalDiskType parameter is not required if only one type of physical disk is in the...
Recurring Syntax Syntax Values IPV6HopLimit 0 to 255 (default value is 64) IPV6NdDetectDuplicateAddress 0 to 256 IPV6NdReachableTime 0 to 65535 (default value is 30000 milliseconds) IPV6RetransmitTime 0 to 65535 (default value is 1000 milliseconds) IPV6NDTimeOut 0 to 65535 (default value is 3000 milliseconds) maxFramePayload 1500 NOTE: The maxFramePayload parameter is shared...
Page 31
comment, an error message is displayed, and the script operation is terminated. This error commonly occurs when a comment is placed at the end of a script and you have not pressed <Enter>. // Deletes the existing configuration. clear storageArray Configuration; •...
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.
Determining What Is On Your Storage Array Even when you create a configuration on a previously unconfigured storage array, you still need to determine the hardware and software features that must be included with the storage array. When you configure a storage array with an existing configuration, you must ensure that your new configuration does not inadvertently alter the existing configuration, unless you are reconfiguring the entire storage array.
profile command, but is constrained to the specific component. (The following commands are not complete commands. For information about a command, see the referenced section next to the command.) • show controller (RAID Controller Module Commands) • show physicalDisks (Show Physical Disk) •...
Using The Create Virtual Disk Command The create virtualDisk command enables you to create new virtual disks in the storage array in three ways: • Create a new virtual disk while simultaneously creating a new disk group to which you assign the physical disks. •...
Page 37
The command in this example automatically creates a new disk group and a virtual disk with the name Engineering_1. The disk group has a RAID level of 5 (RAID 5). The command uses three physical disks to construct the disk group. The virtual disk created has a capacity of 20 GB.
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. Assign any unused space to another virtual disk at another time.
Page 39
values that MD Storage Manager uses to create a storage array. Change any of the parameter values by entering new values for the parameters when you run the autoConfigure storageArray command. If you are satisfied with the parameter values that the show storageArray autoConfiguration command returns, run the autoConfigure storageArray command without new parameter values.
The command in this example creates a storage array configuration that uses SAS physical disks set to RAID level 5. Three disk groups are created. Each disk group consists of eight physical disks configured into four virtual disks. The storage array has two hot spares, and segment size for each virtual disk is 8 KB. Modifying Your Configuration After creating your initial configuration, modify the properties of the configuration to ensure that it meets your requirements for data storage.
By default, all alert configuration settings are None. The following example shows how to set the mail server IP and the sender address configurations for SMTP alerts: SMcli -m 123.45.67.892 -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.
Setting Modification Priority Modification priority defines how much processing time is allocated for virtual disk modification operations. Time allocated for virtual disk modification operations affects system performance. Increases in virtual disk modification priority can reduce read/write performance. Operations affected by modification priority include: •...
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;" Enter the enclosure ID and slot ID of each physical disk that you want to use. You must put brackets ([ ]) around the list. Separate the enclosure ID and slot ID of a physical disk by a comma.
Page 44
Open the Configure Alerts dialog box by performing one of these actions: a) Select a storage array in the Devices tab, and then select Edit → Configure Alerts. The Configure Alerts dialog box appears. Go to step 4. b) On the Setup tab, select Edit → Configure Alerts. Go to step 2. Select one of the following radio buttons to specify an alert level: a) All storage arrays –...
NOTE: If you ordered Premium Features for the Snapshot Virtual Disks, you would have 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. For more information, see Premium Feature — Snapshot Owner’s Manual .
This can result in data loss on the source virtual disk or an inaccessible snapshot. For details on mapping the snapshot virtual disk to the secondary node, see the Dell PowerVault MD3200 and Dell PowerVault MD3200i and MD3220 Storage Arrays With Microsoft Windows Server Failover Clusters or MD3220i Storage Arrays With Microsoft Windows Server Failover Clusters at support.dell.com/manuals.
NOTE: In some cases, depending on the host operating system and any virtual disk manager software in use, the software prevents you from mapping the same host to both a source virtual disk and its associated snapshot virtual disk. An error message appears in the command line when the utility cannot distinguish between the following: •...
NOTE: Verify that the virtual disk has a status of Optimal or Disabled by clicking the Summary tab and then clicking the Disk Groups & Virtual Disks link. Follow any additional instructions for your operating system. Failure to follow these additional instructions can create unusable snapshot virtual disks.
The command in this example creates a new snapshot for the source virtual disk Mars_Spirit_4. The repository virtual disk is created in the same disk group as the source virtual disk, which means that the repository virtual disk has the same RAID level as the source virtual disk.
command creates a new disk group. You must have physical disks in the storage array that are not assigned to a disk group for this command to work: create snapshotVirtualDisk sourceVirtualDisk= "sourceVirtualDiskName" [repositoryRAIDLevel=(0 | 1 | 5 | 6) repositoryPhysicalDiskCount= numberOfPhysicalDisks physicalDiskType=(SAS) userLabel="snapshotVirtualDiskName"...
Page 51
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.
Parameter Description • scheduleInterval • endDate • noEndDate • timesPerDay • timeZone 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;"enableSchedule=TRUE schedule= (immediate | snapshotSchedule)] The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk=...
controller module for the snapshot virtual disk would be Mars_Spirit_4-1. The default name provided by the RAID controller module for the repository virtual disk would be Mars_Spirit_4-R1. Changing Snapshot Virtual Disk Settings The set (snapshot) virtualDisk command enables you to change the property settings for a snapshot virtual disk.
Re-creating The Snapshot Virtual Disk To restart a copy-on-write operation, use the recreate snapshot virtualDisk command. This command starts a fresh copy-on-write operation using an existing snapshot virtual disk. When you restart a snapshot virtual disk, the snapshot virtual disk must have either an Optimal or a Disabled state. The following conditions then occur: •...
Page 55
Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Re-create A Snapshot Virtual Disk. The following example is the script file version of the command: recreate snapshot virtualDisks ["Mars_Spirit_4-2" "Mars_Spirit_4-3"]; If you do not intend to use a snapshot virtual disk again, you can delete the snapshot virtual disk using the delete virtualDisk command.
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 on the card to obtain a Owner’s key file and to enable the feature.
Command Description show virtualDiskCopy sourceCandidates Returns information about the candidate virtual disks that you can use as the source for a virtual disk copy operation. show virtualDiskCopy targetCandidates Returns information about the candidate virtual disks that you can use as the target for a virtual disk copy operation. stop virtualDiskCopy Stops a virtual disk copy operation.
the copy priority and choose whether you want the target virtual disk to be write enabled or read only after the data is copied from the source virtual disk. Preparing Host Servers To Create A Virtual Disk Copy 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.
See step 1 to step 4 in Preparing Host Servers To Create A Virtual Disk Copy. 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.
The following example is the script file version of the command: show virtualDiskCopy source ["Jaba_Hut"]; Changing Virtual Disk Copy Settings The set virtualDiskCopy command enables you to change the property settings for a virtual disk copy pair. Using this command, you can change the following items: •...
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. Using the recopy virtualDiskCopy command, you can create a new virtual disk copy for a previously defined copy pair that has a status of Stopped, Failed, or Completed.
The following syntax is the general form of the command: recopy virtualDiskCopy target [targetName] [source [sourceName] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] NOTE: Use one or all of the optional parameters as needed to help define your configuration. It is not necessary to use any optional parameters.
The following example shows a command to remove a virtual disk copy pair: client>smcli 123.45.67.89 -c "remove virtualDiskCopy target [\"Obi_1\"];" The following example is the script file version of the command: remove virtualDiskCopy target ["Obi_1"]; Interaction With Other Features You can run the Virtual Disk Copy feature while running the following features: •...
Page 65
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.
Using The Remote Replication Premium Feature The Remote Replication premium feature provides for online, real-time replication of data between storage arrays over a remote distance. In the event of a disaster or a catastrophic failure on one storage array, you can promote the second storage array to take over responsibility for computing services.
Replication Repository Virtual Disks A replication repository virtual disk is a special virtual disk in the storage array that is created as a resource for the RAID controller module owner of the primary virtual disk in a remote replicated pair. The RAID controller module stores replication information on this virtual disk, including information about remote writes that are not yet complete.
host write requests are written to the primary virtual disk and then copied to the secondary virtual disk. After the host write request has been written to the primary virtual disk and the data has been successfully copied to the secondary virtual disk, the RAID controller module removes the log record on the replication repository virtual disk.
owner of the primary virtual disk receives a write request from a host, the RAID controller module first logs information about the write to a replication repository virtual disk. The RAID controller module then writes the data to the primary virtual disk.
– A full synchronization at the high synchronization priority level takes approximately twice as long as a full synchronization at the highest synchronization priority level. • When the replicated virtual disk pair is in a Synchronization in Progress state, all host write data is copied to the remote system.
Page 72
Activating the Remote Replication Premium Feature with User-Assigned Physical Disks Activating the Remote Replication premium feature by assigning the physical disks provides flexibility in defining your configuration by letting you choose from the available physical disks in your storage array. Choosing the physical disks for your remote replication automatically creates a new disk group.
creates a new disk group. For this command to work, you must have physical disks in the storage array that are not assigned to a disk group. activate storageArray feature=remoteReplication repositoryRAIDLevel=(1 | 5 | 6) repositoryPhysicalDiskCount=numberOfPhysicalDisks [physicalDiskType=(SAS)] [enclosureLossProtect=(TRUE | FALSE)] This example shows a command in which you specify the number of physical disks: c:\...\smX\client>smcli 123.45.67.88 123.45.67.89 -c “activate storageArray feature=remoteReplication...
writeOrder=(preserved | notPreserved) writeMode=(synchronous | asynchronous) NOTE: You can use the optional parameters as needed to help define your configuration. This example shows the create remoteReplication command: c:\...\smX\client>smcli 123.45.67.88 123.45.67.89 -c “create remoteReplication primary= \”Jan_04_Account\” secondary=\”Jan_04_Account_B\” remoteStorageArrayName=\”Tabor\” remotePassword=\”jdw2ga05\” syncPriority=highest writeMode=synchronous;” The command in this example creates a remote replication in which the primary virtual disk is named Jan_04_Account on the local storage array.
This example shows how to use the command in a script file: set remoteReplication localVirtualDisk [Jan_04_Account] syncPriority=medium writeOrder=notpreserved writeMode=asynchronous; Suspending And Resuming A Replication Relationship Use the suspend remoteReplication command to stop data transfer between a primary virtual disk and a secondary virtual disk in a replication relationship without disabling the replication relationship.
between a primary virtual disk and a secondary virtual disk does not affect any of the existing data on either virtual disk. The link between the virtual disks is removed, but the primary virtual disk still continues normal I/O operations. Later, you can establish the replication relationship between the two virtual disks and resume normal replication operations.
In addition to running with the premium features, you can also run the Remote Replication premium feature while running Storage Partitioning and Virtual Disk Expansion (VDE). Snapshot Virtual Disks A snapshot virtual disk is a point-in-time image of a virtual disk. It is typically created so that an application, such as a backup, can access the snapshot virtual disk and read the data while the source virtual disk remains online and accessible to hosts.
After you create a virtual disk copy, the target virtual disk automatically becomes read‑only to hosts to ensure that the data is preserved. Hosts that have been mapped to a target virtual disk do not have write access to the virtual disk, and any attempt to write to the read-only target virtual disk results in a host I/O error.
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.
media error is removed. The result of this action is that the first ten consistency mismatches found on a virtual disk are reported to the MEL. – Unfixable error — The data could not be read and consistency information could not be used to regenerate it.
Enabling RAID Controller Module Data Transfer At times, a RAID controller module might become quiescent while running diagnostics. If this occurs, the RAID controller module might become unresponsive. To revive a RAID controller module, run the following command: enable controller [(0 | 1)] dataTransfer Resetting Battery Age NOTE: A smart battery module does not require the battery age to be reset.
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.
Changing RAID Levels When creating a disk group, define the RAID level for the virtual disks in that group. You can later change the RAID level to improve performance or provide more secure protection for your data. To change the RAID level, run the following command: set diskGroup [diskGroupNumber] raidLevel=(0|1|5|6) where, diskGroupNumber is the number of the disk group for which to change the RAID level.
Collecting Physical Disk Data To gather information about all the physical disks in a storage array, run the save allPhysicalDisks command. This command collects sense data from all the physical disks in a storage array and saves the data to a file. The sense data consists of statistical information maintained by each of the physical disks in the storage array.
Setting RAID Controller Module Operational Mode A RAID controller module has three operational modes: • Online • Offline • Service CAUTION: Placing a RAID controller module offline can cause loss of data. 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.
When you initialize a physical disk, all old disk group and virtual disk information is erased, and the physical disk is returned to an unassigned state. Returning a physical disk to an unassigned state adds unconfigured capacity to a storage array. You can use this capacity to create additional disk groups and virtual disks. To initialize a physical disk, run the following command: start physicalDisk [enclosureID,slotID] initialize enclosureID and slotID are the identifiers for the physical disk.
Page 87
Under some host operating systems, you must reconfigure the multipath host driver. You might also need to make operating system modifications to recognize the new I/O path to the virtual disk.
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 90
– As part of the command syntax – To indicate which parameters are optional The description of each parameter tells you when 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 use one of the values shown in the parentheses.
When you enter the World Wide Identifier (WWID) of an HBA host port, some usages require quotation marks around the WWID. In other uses, you must put angle brackets (< >) around the WWID. The description of the WWID parameter tells you if you must put quotation marks or angle brackets around the WWID. •...
Create Host Group Create Host Port Create iSCSI Initiator Delete Host Delete Host Group Delete Host Port Delete iSCSI Initiator Set Host Set Host Group Set Host Channel Set Host Port Set iSCSI Initiator Set iSCSI Target Properties Show Host Ports iSCSI Commands Create iSCSI Initiator Delete iSCSI Initiator...
Show Physical Disk Channel Statistics Show Physical Disk Download Progress Start Physical Disk Blink Start Physical Disk Initialize Start Physical Disk Channel Blink Start Physical Disk Channel Fault Isolation Diagnostics Start Physical Disk Reconstruction Start Remote Replication Synchronization Stop Physical Disk Blink Stop physical disk channel blink Stop Physical Disk Channel Fault Isolation Diagnostics RAID Controller Module Commands...
Show Remote Replication Virtual Disk Candidates Show Remote Replication Virtual Disk Synchronization Progress Start Snapshot Rollback Suspend Remote Replication Session Command Set Session Show String Command Show String Snapshot Commands Create Snapshot Virtual Disk Re-Create Snapshot Set Snapshot Virtual Disk Stop Snapshot Storage Array Commands Activate Storage Array Firmware...
Save Storage Array State Capture Save Storage Array Support Data Set Storage Array Set Storage Array Enclosure Positions Set Storage Array ICMP Response Set Storage Array iSNS Server IPv4 Address Set Storage Array iSNS Server IPv6 Address Set Storage Array iSNS Server Listening Port Set Storage Array Learn Cycle Set Storage Array Redundancy Mode Set Storage Array Security Key...
Start Virtual Disk Initialization Virtual Disk Copy Commands Create Virtual Disk Copy Recopy Virtual Disk Copy Remove Virtual Disk Copy Set Virtual Disk Copy Show Virtual Disk Copy Show Virtual Disk Copy Source Candidates Show Virtual Disk Copy Target Candidates Stop Virtual Disk Copy Commands Listed Alphabetically Following are the script commands listed alphabetically.
Page 97
physicalDiskMediaType=(HDD | SSD | unknown | allMedia) physicalDiskType=(SAS) [enclosureLossProtect=(TRUE | FALSE)] [drawerLossProtect=(TRUE | FALSE)] Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 1, 5, or 6. repositoryPhysicalDisks The physical disk for the replication repository virtual disk. For high capacity physical disk enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you assign to the...
Page 98
Parameter Description repository virtual disk. Free capacity is defined as the free capacity between existing virtual disks in a disk group. For example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity.
Activate 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 array. Before entering the autoConfigure storageArray command, run the show storageArray autoConfiguration command.
Parameter Description diskGroupCount Number of disk groups in the storage array. Use integer values. virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group. Use integer values. hotSpareCount Number of hot spares in the storage array. Use integer values. For information about hot spares, see Assigning Global Hot Spares.
This command returns the status of a remote replication virtual disk. Use this command to determine when the status of the remote replication virtual disk becomes Optimal. Syntax check remoteReplication localVirtualDisk [virtualDiskName] optimalStatus timeout=timeoutValue Parameters Parameter Description The name of any remote replication virtual disk. The localVirtualDisk remote replication virtual disk can be the primary virtual disk or the secondary virtual disk of a remote replication...
Parameter Description startingLBA The starting logical block address. Use integer values. endingLBA The ending logical block address. Use integer values. verbose Captures progress details, such as percent complete, and shows the information while virtual disk consistency is being repaired. To capture progress details, set this parameter to TRUE.
Parameter Description The setting to remove the entire configuration of the storage array, including security and identity information. Removing all configuration information returns the storage array to its initial state. diskGroups The setting to remove the virtual disk configuration and the disk group configuration.
CAUTION: As soon as you run this command, the contents of the existing pending area in the storage array are deleted. Syntax clear storageArray firmwarePendingArea Parameters None. Clear Storage Array Recovery Mode This command forces a storage array to exit recovery mode. Syntax clear storageArray recoveryMode Notes...
Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) unreadableSectors Parameters Parameter Description allVirtualDisks Clears unreadable sector information from all of the virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you want to clear unreadable sector information.
Page 107
Parameter Description 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 physical disk capacity in the disk group is used.
Page 108
cacheReadPrefetch parameter or the segmentSize parameter. If you do not You do not need to enter a value for the usageHint parameter with fileSystem as the default enter a value, the RAID controller module firmware uses the usageHint parameter and a value for the cacheReadPrefetch parameter or a value for the value.
Create Disk Pool This command creates a new disk pool based on the specified parameters. You can create the disk pool by entering either a list of physical disks or a type of physical disk that you want to use for the disk pool. NOTE: If you enter a list of physical disks, ensure that all of the physical disks have the same capacity.
Page 110
Parameter Description criticalPriority The default value is highest. backgroundPriority The default value is low. securityType The setting to specify the security level when creating the disk pool. All virtual disk candidates for the disk pool have the specified security type. These settings are valid: •...
Create Host This command creates a new host.If you do not specify a host group in which to create the new host, the new host is created in the default group. Syntax create host userLabel=”hostName” [hostGroup=(“hostGroupName” | defaultGroup)] [hostType=(hostTypeIndexLabel | hostTypeIndexNumber)] Parameters Parameter...
host="hostName" interfaceType=SAS Parameters Parameter Description identifier WWID of the HBA host port. You must put quotation marks (" ") around the WWID. userLabel Name to give the new HBA host port. You must put quotation marks (" ") around the port label. host Name of the host for which you are defining an HBA host port.
NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a “secret.” A secret is a security key that is similar to a password. Use chapSecret only for initiators requiring mutual authentication. Create RAID Virtual Disk (Automatic Physical Disk Select) This command creates a disk group across the storage array physical disks, and a new virtual disk in the disk group.
Parameter Description 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 physical disk capacity in the disk group is used.
Page 115
Syntax create virtualDisk diskGroup=[diskGroupName] userLabel=”virtualDiskName” [freeCapacityArea=freeCapacityIndexNumber capacity=virtualDiskCapacity owner=(0 | 1)cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia)] [dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description diskGroup Sequence number of the disk group in which to create the new virtual disk.
Parameter Description top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure. If you do not specify an owner, the RAID controller module firmware determines the owner. NOTE: The owner parameter defines which RAID controller module owns the virtual disk.
Page 117
NOTE: You cannot use mixed physical disk types in the same disk group and virtual disk. This command fails if you specify different types of physical disks for the RAID virtual disk. Syntax create virtualDisk physicalDisks (enclosureID1,drawerID1,slotID1 enclosureID2,slotID2... enclosureIDn,drawerIDn,slotIDn) [diskGroupUserLabel=[diskGroupName]] raidLevel=(0 | 1 | 5 | 6) userLabel=”virtualDiskName”...
Page 118
Parameter Description userLabel Name that you want to give the new virtual disk. You must put quotation marks (" ") around the new virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed.
Parameter Description dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases. The default value is TRUE. securityType The setting to specify the security level when creating the disk groups and all associated virtual disks. •...
Parameter Description the RAID controller module firmware determines the owner. mapping This parameter enables you to map the virtual disk to a host. If you want to map later, set this parameter to none. If you want to map the virtual disk now, set this parameter to default, and the virtual disk is mapped to all hosts that have access to the storage pool.
Page 121
Parameter Description primary The name of an existing virtual disk on the local storage array that you want to use for the primary virtual disk. Enclose the primary virtual disk name in double quotation marks (“ ”). secondary The name of an existing virtual disk on the remote storage array that you want to use for the secondary virtual disk.
Passwords are stored on each storage array in a management domain. If a password was not previously set, a password is not needed. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (A storage array password can be defined by using the set storageArray command.) Synchronization priority defines the amount of system resources that are used to synchronize the data between the primary virtual disk and the secondary virtual disk of a replication relationship.
Page 123
userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryUserLabel=”repositoryName” repositoryFullPolicy=(failSourceWrites | failSnapshot) |enableSchedule=(TRUE | FALSE)|schedule=(immediate | snapshotSchedule) Syntax (Existing Repository Disk Group) create snapshotVirtualDisk sourceVirtualDisk=”sourceVirtualDiskName” [repositoryDiskGroup=”repositoryDiskGroupName” repositoryUserLabel=”repositoryName” freeCapacityArea=freeCapacityIndexNumber userLabel=”snapshotVirtualDiskName” warningThresholdPercent=percentValue repositoryPercentOfSource=percentValue repositoryFullPolicy=(failSourceWrites | failSnapshot)] |enableSchedule=(TRUE | FALSE)|schedule=(immediate | snapshotSchedule) Parameters Parameter Description sourceVirtualDisk Name of the source virtual disk from which to take a snapshot.
Page 124
Parameter Description enclosureLossProtect parameter, see Enclosure Loss Protection driveMediaType The type of physical disk media that you want to use for the disk group. Valid physical disk media consists of: • HDD—Use this option when you have hard physical disks in the expansion enclosure. •...
Page 125
Parameter Description repositoryUserLabel The name to give to the repository virtual disk. You must put quotation marks (" ") around the repository virtual disk name. repositoryFullPolicy Specifies how snapshot processing continues if the repository is full. You can choose to fail writes to the source virtual disk (failSourceWrites) or fail the snapshot virtual disk (failSnapShot).
Scheduling Snapshots You can use the enableSchedule and the schedule parameters to schedule automatic snapshots. Automatic snapshots can be scheduled daily, weekly, or monthly (by day or by date). The enableSchedule parameter turns on or off the ability to schedule snapshots. When you enable scheduling, you use the schedule parameter to define when you want the snapshots to occur.
Parameter Description snapshotVirtualDisk command and specify an end date. timesPerDay Number of times you want the snapshot schedule to run in a day. For example, timesPerDay=4. timeZone Specifies the time zone to use for the scheduling operations, using one of the following values: •...
Page 128
Parameter Description keyIdentifier A character string that you can read that is a wrapper around a security key. passPhrase A character string that encrypts the security key so that you can store the security key in an external file. file The file path and the file name to which you want to save the security key.
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.
Parameter Description 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 (<...
CAUTION: All data in the disk group is lost as soon as you run this command. Syntax delete diskGroup [diskGroupNumber] Parameter Parameter Description Number of the disk group to delete. You must put brackets diskGroup ([ ]) around the disk group number. Delete Disk Pool This command deletes a disk pool.
CAUTION: This command deletes all of the host definitions in the host group. Syntax delete hostGroup [hostGroupName] Parameter Parameter Description Name of the host group to delete. You must put brackets hostGroup ([ ]) around the host group name. If the name of the host group has special characters, you must also put quotation marks ("...
Parameters Description The identifier of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). iSCSI-ID The name of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). name Example -c "delete iscsiInitiator [\"job29002\"];"...
Parameter Description NOTE: Using the allVirtualDisks 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. virtualDisk or virtualDisks Name of the virtual disk to delete. You can enter more than one virtual disk name.
Parameter Description standalone disk groups intact, set this parameter to FALSE. retainRepositoryMembers When you delete a virtual disk, the associated repository virtual disk is deleted by default. However, when the retainRepositoryMembers is set to TRUE, the repository virtual disk is retained. For normal virtual disks, this parameter has no effect.
Parameter Description select a specific channel on which to run diagnostics. Valid physical disk channel values are 1 or 2. NOTE: When you run a data loopback test, you can optionally specify a file that contains a data pattern. If you do not specify a file, the firmware provides a default pattern.
Parameter Description iSCSI host ports or run it on a specific iSCSI host. Valid values for the specific iSCSI host port identifiers are 0 or 1. Enclose the iSCSI host port identifier in square brackets ([ ]). testID Specifies the identifier for the diagnostic test you want to run.
Parameters Parameter Description primary or primaries The name of the primary virtual disk of the remote replication pair to be tested. More than one primary virtual disk name can be entered. Enclose the primary virtual disk names in square brackets ([ ]). If the primary virtual disk name has special characters, the primary virtual disk name must also be enclosed in double quotation marks (“...
NOTE: This command must be run from the command line. It cannot be run in the MD Storage Manager script editor. Syntax supportBundle schedule show Parameters None. Download Enclosure Management Module Firmware This command downloads firmware for the enclosure management module. Syntax download (allEnclosures | enclosure [enclosureID]) firmware file="filename"...
download firmware on all of the physical disks in the storage array. See Download Storage Array Physical Disk Firmware.) This command blocks all I/O activity until the download finishes or fails. The download returns one of the following statuses: • Successful •...
Parameter Description NVSRAM-filename File path and name of the file that contains the NVSRAM values. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the NVSRAM file name. You must include a comma after the firmware file name.
Download Storage Array NVSRAM This command downloads NVSRAM values for the storage array RAID controller module. Syntax download storageArray NVSRAM file="filename" Parameter Parameter Description File path and name of the file that contains the NVSRAM file values. Valid file names must end with a .dlp extension. You must put quotation marks ("...
Parameter Description diskPool The alphanumeric identifier (including - and _) of the disk pool that you want to place in the Security Enabled state. Enclose the disk pool identifier in square brackets ([ ]). Notes All of the physical disks that comprise the disk pool must be security capable. Enable RAID Controller Module Data Transfer This command revives a RAID controller module that quiesces while running diagnostics.
Increase Virtual Disk Capacity On A Disk Pool This command defines the properties for a virtual disk. You can use most parameters to define properties for one or more virtual disks. You also can use some parameters to define properties for only one virtual disk. The syntax definitions are separated to show which parameters apply to several virtual disks and which apply to only one virtual disk.
Parameter Description file The file path and the file name of the DBM database you want to upload. Enclose the file name in double quotation marks (" "). For example: file="C:\Array Backups \DBMbackup_03302010.dbm". This command does not automatically append a file extension to the saved file. You must specify a file extension when entering the file name.
NOTE: Removing the drive letter of the associated virtual disk(s) in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the drive for the virtual copy. Syntax recopy virtualDiskCopy target [targetName] [source [sourceName]] [copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE)] copyType=(online | offline) Parameters...
Page 147
This command creates a new Remote Replication repository virtual disk (also called a replication repository virtual disk) by using the parameters defined for a previous replication repository virtual disk. The underlying requirement is that you have previously created a replication repository virtual disk. When using this command, the replication repository virtual disk can be defined in one of three ways: •...
Parameter Description freeCapacityArea=2 Run the show diskGroup command to determine if a free capacity area exists. repositoryPhysicalDiskCount The number of unassigned physical disks that you want to use for the replication repository virtual disk. enclosureLossProtect The setting to enforce enclosure loss protection when you create the replication repository virtual disk.
Page 149
Parameter Description virtualDisk or virtualDisks Name of the specific virtual disk for which to start a fresh copy-on-write operation. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks ("...
• During snapshot re-creation, all affected virtual disks (snapshots, base, and repository) are appropriately quiesced and I/O operations are resumed to all affected virtual disks after all snapshots have been successfully re-created. NOTE: If the warningThresholdPercent parameter or the repositoryFullPolicy parameter is not specified, the previously set values are used.
Parameter Description has special characters, you also must enclose the virtual disk name in double quotation marks (" "). Remove Virtual Disk Copy This command removes a virtual disk copy pair. Syntax remove virtualDiskCopy target [targetName] [source [sourceName]] copyType=(online | offline) Parameters Parameter Description...
Parameter Description accessVirtualDisk Removes the access virtual disk. CAUTION: The host agent uses the access virtual disks to communicate in-band with a 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 through the in-band agent.
• An unassigned physical disk • A fully integrated hot spare physical disk Syntax replace physicalDisk ([enclosureID,slotID] | <wwID>) replacementPhysicalDisk=enclosureID,slotID Parameters Parameter Description physicalDisk Specifies the physical disks to assign to the virtual disk that you want to create. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk.
Additional Information The RAID controller module that receives the reset RAID controller module command resets the RAID controller module specified. For example, if the reset RAID controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 0, then RAID controller module 0 reboots itself by doing a soft reboot. If the reset RAID controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 1, then RAID controller module 0 holds RAID controller module 1 in reset and then releases RAID controller module 1 from reset, which is a hard reboot.
Reset Storage Array SAS PHY Baseline This command resets the SAS physical layer (SAS PHY) baseline for all devices except physical disks, and removes the list of errors from the .csv file. The .csv file is generated by running the save storageArray SASPHYCounts command.
Parameter Description name must also be enclosed in double quotation marks (“ ”). writeConsistency The setting to identify the virtual disks in this command that are in a write-consistency group or are separate. For the virtual disks to be in the same write-consistency group, set this parameter to TRUE.
Parameter Description Number of the disk group to be set to the optimal state. diskGroup You must put brackets ([ ]) around the disk group number. Revive Disk Pool This command forces a disk pool and its associated physical disks to the Optimal state. CAUTION: Correct use of this command depends on the data configuration on all of the physical disks in the disk pool.
Parameter Description logFile Name of the file to which to save the log sense data. You must put quotation marks (" ") around the file name. 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.
Parameters Parameter Description controller RAID controller module with the NVSRAM values to save. Valid RAID controller module identifier values are 0 and 1. The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure.
Parameter Description the LUN mapping, set this parameter to FALSE. The default value is FALSE. NOTE: When you use this command, you can specify any combination of the parameters for global setting, virtual disk configuration setting, host topology, or LUN mapping. To enter all settings, use the allConfig parameter. The parameters are optional;...
Parameter Description (starting with the last event entered) are saved to the file. Use integer values. When set to TRUE, force saves all critical events to a file. forceSave Default value is FALSE. Save Storage Array iSCSI Statistics This command saves the iSCSI performance of the storage array to a file. The following statistics are saved to the file: •...
Parameter Description file Specifies name of the file to which to save the performance statistics. You must put quotation marks (" ") around the file name. Save Storage Array SAS PHY Counts This command saves the storage array SAS physical layer (SAS PHY) counters to a file. To reset the SAS PHY counters, run the Reset Storage Array SAS PHY Baseline command.
• A recovery profile for the storage array • The unreadable sectors that are detected on the storage array • The state capture data • An inventory of the versions of the firmware running on the RAID controller modules, the physical disks, and the RAID controller modules Syntax save storageArray supportData file="filename"...
Parameter Description storageArrayName Apply the command to the named storage array. data Store the data generated by the command at the location pathName . specified by the Scheduling Snapshots You can use the enableSchedule and the schedule parameters to schedule automatic snapshots. Automatic snapshots can be scheduled daily, weekly, or monthly (by day or by date).
Parameter Description MM:DD:YY, where MM is the month, DD the day and YY the year. For example: endDate=11:26:11. noEndDate Use this option to prevent a scheduled copy-on-write operation from ending. If you later decide to end the copy- on-write operations, you must re-enter the create snapshotVirtualDisk command and specify an end date.
Page 166
Parameter Description diskGroup Sequence number of the disk group for which to set properties. You must put brackets ([ ]) around the disk group number. addPhysicalDisks Identifies the physical disk by enclosure and slot location to include in the disk group. Enclosure ID values are 0 to 99.
Set Disk Group Forced State This command moves a disk group into a Forced state. Use this command if the start diskGroup import command does not move the disk group to an Imported state or if the import operation does not work because of hardware errors.
Parameter Description percent. For best operation, the value for this parameter must be less than the value for the criticalThreshold parameter. Setting this parameter to 0 disables warning alerts. criticalPriority This parameter governs the priority for critical reconstruction activities on the disk pool. backgroundPriority This parameter governs the priority for background task activities on the disk pool.
Parameter Description enclosure Service tag of the RAID enclosure or the 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.
Parameter Description host The name of the host that you want to assign to a host group. Enclose the host name in square brackets ([ ]). If the host name has special characters, you must also enclose the host name in double quotation marks (" "). hostGroup The host group to which you want to assign the host.
Parameter Description hostChannel The identifier number of the host channel for 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 ([ ]).
Parameter Description characters, enclose the HBA host port label in double quotation marks (" "). host The name of the host to which the HBA host port is connected. Enclose the host name in double quotation marks (" "). userLabel The new name that you want to give to the HBA host port.
Syntax set iscsiTarget [“iscsiID”] (authenticationMethod=(none | chap) | chapSecret=”securityKey” | targetAlias=”userLabel”) Parameters Parameter Description iSCSIID The iSCSI target for which you want to set properties. Enclose the name in double quotation marks (“ ”). You must also enclose the iscsiID in either square brackets ([ ]) or angle brackets (<...
Parameter Description NOTE: Use the optimal parameter to move a degraded channel back to the Optimal state. Use the degraded parameter if the channel is experiencing problems, and the storage array requires additional time for data transfers. Set Physical Disk Hot Spare This command assigns or unassigns one or more physical disks as a hot spare.
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 176
Parameter Description IPv6RouterAddress The IP address of IPv6 router that connects two or more logical subnets. The address format for the IPv6 router is (0– FFFF):(0–FFFF):(0–FFFF):(0– FFFF): (0–FFFF):(0–FFFF):(0–FFFF): (0– FFFF). iscsiHostPort The values that support this parameter are listed in the Syntax Element Statement Data table that follows.
Options for the Ethernet Port Parameter enableIPv6Priority=(TRUE | FALSE) | IPv4ConfigurationMethod=(static | dhcp) | IPv6ConfigurationMethod=(static | auto) | IPv4GatewayIP=(TRUE | FALSE) | 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=[(autoNegotiate | 1 | 10)] Additional Information When you use this command, you can specify one or more of the parameters.
Page 178
virtualDiskNameN]) role=(primary | secondary) [force=(TRUE | FALSE)] syncPriority=(highest | high | medium | low | lowest) autoResync=(enabled | disabled) writeOrder=(preserved | notPreserved) writeMode=(synchronous | asynchronous) Parameters Parameter Description localVirtualDisk or localVirtualDisks The name of the primary virtual disk for which you want to define properties.
Parameter Description writeMode This parameter defines how the primary virtual disk writes to the secondary virtual disk. Valid values are synchronous or asynchronous. Notes When using this command, one or more of the optional parameters can be specified. Synchronization priority defines the amount of system resources that are used to synchronize the data between the primary virtual disks and the secondary virtual disks of a replication relationship.
Additional Information When you use this command, you can specify one or more of the optional parameters. Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (You can define a storage array password by using the set storageArray command.) The polling interval and the number of iterations that you specify remain in effect until you end the session.
Parameter Description schedule Use this parameter to schedule a snapshot operation, with the following options: • immediate • startDate • scheduleDay • startTime • scheduleInterval • endDate • noEndDate • timesPerDay • timeZone For more information, see Scheduling Snapshots. rollbackPriority Determines whether system resources must be allocated to the rollback operation at the expense of system performance.
Page 182
Parameter Description • enable—Turns on the collection of support data • disable—Turns off the collection of support data cacheBlockSize The cache block size that is used by the RAID controller module for managing the cache. Valid values are 4 (4 KB), 8 (8 KB), 16 (16 KB), or 32 (32 KB).
• Automatic collection of the configuration and state information occurs every 72 hours. The configuration and state information is saved to the storage array zip archive file. The archive file has a time stamp that is used to manage the archive files. •...
Parameter Parameter Description enclosurePostions A list of all of the enclosure IDs. The sequence of the enclosure IDs in the list defines the positions for the RAID enclosure and the expansion enclosures in a storage array. Valid values are 0 to 99. Enter the enclosure ID values separated by a space.
Parameter Description isnsIPv4Address The IP address that you want to use for the iSNS server. Use this parameter with the static value for IPv4 configurations. If you choose to have a DHCP server set the IP address for an IPv4 Internet iSNS server, you must set the isnsIPv4Address parameter to 0.0.0.0.
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.
Whenever a security-enabled physical disk is powered on, it requires the correct security key from the RAID controller module before it can read or write data. So, a security-enabled physical disk uses two keys: the physical disk key that encrypts and decrypts the data and the security key that authorizes the encryption and decryption processes. The set storageArray securityKey command commits the security key to all of the RAID controller modules and security-enabled physical disks in the storage array.
Page 188
virtualDisk <wwID>) cacheFlushModifier=cacheFlushModifierValue cacheWithoutBatteryEnabled=(TRUE | FALSE)\ mediaScanEnabled=(TRUE | FALSE) mirrorCacheEnabled=(TRUE | FALSE) modificationPriority=(highest | high | medium | low | lowest) owner=(0 | 1) readCacheEnabled=(TRUE | FALSE) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) Write Cache on a virtual disk generally improves performance for applications with significant CAUTION: Enabling Write Cache does introduce Write content (unless the application features a continuous string of Writes.
Page 189
Parameter Description mediaScanEnabled The setting to turn on or turn off media scan for the virtual disk. To turn on media scan, set this parameter to TRUE. To turn off media scan, set this parameter to FALSE. (If media scan is disabled at the storage array level, this parameter has no effect.) mirrorCacheEnabled The setting to turn on or turn off the mirror cache.
Parameter Description segmentSize Amount of data (in kilobytes) that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see Using The Auto Configure Command.
Syntax set virtualDiskCopy target [targetName] [source [sourceName]] copyPriority=(highest | high | medium | low | lowest) targetReadOnlyEnabled=(TRUE | FALSE) copyType=(online | offline) Parameters Parameter Description target Specifies the name of the target virtual disk for which to define properties. You must put brackets ([ ]) around the target virtual disk name.
Parameter Description initiatorName The name of the iSCSI initiator for which session information is desired. Enclose the iSCSI initiator name in double quotation marks (“ ”). The name and quotation marks must also be enclosed in either square brackets ([ ]) or angle brackets (<...
Parameter Parameter Description Number of the disk group for which to display information. diskGroup 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.
Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example. HOST PORT IDENTIFIER HOST PORT NAME HOST TYPE 12:34:56:54:33:22:22:22 Jupiter1 Solaris 12:34:56:78:98:98:88:88 Pluto 1 Windows 2000/Server 2003 Clustered 54:32:12:34:34:55:65:66 Undefined Undefined Show Physical Disk For each physical disk in the storage array, this command returns the following information: •...
Parameter Description allPhysicalDisks Returns information about all physical disks in the storage array. NOTE: To determine information about the type and location of all physical disks in the storage array, use the allPhysicalDisks parameter. driveMediaType retrieve information. Valid physical disk media are these: •...
Parameter Description physicalDiskChannel Identifier number of the physical disk port for which to display information. Valid physical disk port values are 1 or 2. You must put brackets ([ ]) around the physical disk channel values. physicalDiskChannels Identifier number of the physical disk ports for which to display information.
• Ethernet port • Physical disk interface Syntax show (allControllers | controller [(0 | 1)]) [summary] Parameters Parameter Description Returns information about both RAID controller modules in allControllers the storage array. Returns information about a specific RAID controller controller module in the storage array. Valid RAID controller module identifier values are 0 and 1.
NOTE: Use the show controller NVSRAM command to display parts or all of the NVSRAM before using the set controller command to change NVSRAM values. Show Remote Replication Virtual Disk Candidates NOTE: This command valid only with Fibre Channel storage arrays. This command returns information about the candidate virtual disks on a remote storage array that can be used as secondary virtual disks in a Remote Replication configuration.
Show Storage Array This command returns configuration information about the storage array. The parameters return lists of values for the components and features in the storage array. You can enter the command with a single parameter or more than one parameter.
Parameter Description 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. Each row in the table displays a host type index and the platform the index represents. hotSpareCoverage Displays information about which virtual disks of the storage array have hot spare coverage and which virtual...
numberOfVirtualDisksPerGroup 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 type is SAS. This parameter is not required if only one type of physical disk is in the storage array. RAID level of the disk group that contains the physical raidLevel disks in the storage array.
Syntax show storageArray hostTopology Parameters None. Show Storage Array LUN Mappings This command returns information from the storage array profile about the storage array LUN mappings. If you run this command with no parameters, this command returns all LUN mappings. Syntax show storageArray lunMappings [host ["hostName"] hostgroup ["hostGroupName"]]...
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. The table is organized with column headings for the following information: • Virtual disk user label •...
Page 204
– The physical disk type (SAS) – Enclosure loss protection – The preferred owner – The current owner – The segment size – The modification priority – The read cache status (enabled or disabled) – The write cache status (enabled or disabled) –...
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). Syntax show virtualDisk ["virtualDiskName"] actionProgress Parameters...
Show Virtual Disk Copy Source Candidates This command returns information about the candidate virtual disks that you can use as the source for a virtual disk copy operation. Syntax show virtualDiskCopy sourceCandidates Parameters None. Additional Information This command returns virtual disk copy source information as shown in this example. Virtual Disk Name: finance Capacity: 4.0 GB Disk Group: 1...
Parameter Description name. The source virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Reservations This command returns information about the virtual disks that have persistent reservations. Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] virtualDisks [virtualDiskName1... virtualDiskNameN] reservations Parameters Parameter Description...
To stop the database configuration diagnostic test, use the stop storageArray configDbDiagnostic command. 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.
Additional Information When this command is successful, you can run the start diskGroup import command to finish moving the disk group to a Complete state, which makes the disk group available to the new storage array. If this command is unsuccessful because hardware problems prevented the completion of the export, use the set diskGroup forceState command.
Syntax start enclosure [enclosureID] blink Parameter Parameter Description enclosure Identifies the enclosure to blink. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. Start iSCSI DHCP Refresh Syntax start controller [(0 | 1)] iscsiHostPort [(1 | 2 | 3 | 4)] dhcpRefresh Parameters Parameter Description...
Start Physical Disk Channel Blink This command identifies the expansion enclosures that are connected to a specific physical disk port by turning on the indicator lights for the expansion enclosure that is connected to the physical disk port. Use the stop physicalDiskChannel blink command to turn off the indicator lights on the expansion enclosure.
Parameter Description patternNumber The hexadecimal data pattern you want to use to run the test. This number can be any hexadecimal number between 0000 to FFFF. maxErrorCount The number of errors that you want to accept before terminating the test. testIterations The number of times that you want to repeat the test.
Start Remote Replication Synchronization NOTE: This command valid only with Fibre Channel storage arrays. This command starts Remote Replication synchronization. Syntax start remoteReplication primary [”virtualDiskName”] synchronize Parameter Parameter Description primary The name of the primary virtual disk for which you want to start synchronization.
The repository virtual disk that is associated with the snapshot continues to track any new changes between the base virtual disk and the snapshot virtual disk that occurs after the rollback operation is completed. Syntax start rollback (virtualDisk [snapshotVirtualDiskName] virtualDisks [snapshotVirtualDiskName1 … snapshotVirtualDiskNameN]) Parameter Parameter Description...
NOTE: This command is for IPv4 only. Syntax start storageArray isnsServerRefresh Parameter None. NOTE: If you used the set storageArray isnsIPv4ConfigurationMethod command to set the configuration but did not set the configuration to DHCP, running the start storageArray isnsServerRefresh returns an error. Start Virtual Disk Initialization This command starts the formatting of a virtual disk in a storage array.
None. Stop Disk Pool Locate This command turns off the indicator lights on the physical disks that were turned on by the start diskPool locate command. Syntax stop diskPool locate Stop Enclosure Blink This command turns off the indicator LED on the enclosure that was turned on by the start enclosure blink command.
NOTE: Use the start physicalDiskChannel faultDiagnostics command and the save physicalDiskChannel faultDiagnostics command with the stop physicalDiskChannel faultDiagnostics command. These commands are needed to start the diagnostic test and save diagnostic test results to a file. You can also stop the start physicalDiskChannel faultDiagnostics command at any time by pressing <Ctrl><C>.
already in progress to a physical disk; however, this command stops all firmware downloads to physical disks that are waiting for the download. Syntax stop storageArray physicalDiskFirmwareDownload Parameters None. Stop Virtual Disk Copy This command stops a virtual disk copy operation. Syntax stop virtualDiskCopy target [targetName] [source [sourceName]] Parameters...
Parameter Description consistency group, set this parameter to TRUE. For the virtual disks that are separate, set this parameter to FALSE. NOTE: If the writeConsistency parameter is set to TRUE, the virtual disks must be in a write-consistency group (or groups). This command suspends all write-consistency groups that contain the virtual disks. For example, if virtual disks A, B, and C are in a write-consistency group and they have remote counterparts A’, B’, and C’, the command: suspend remoteReplication virtualDisk [“A”]...
Page 220
NOTE: If your pass phrase does not meet these criteria, you receive an error message.
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.
The first line of text is the show string command. This command displays text bounded by quotation marks (" ") 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 results of running this script file.
Page 223
set virtualDisk["7"] mediaScanEnabled=false; set virtualDisk["7"] consistencyCheckEnabled=false; set virtualDisk["7"] modificationPriority=high; The command in this example, like the create virtualDisk command in the previous example, creates a new virtual disk. The significant difference between these two examples is that this example shows how you can define specific physical disks to include in the virtual disk.
CLI Command Updates This chapter reflects new and updated commands that are available for use with Dell's PowerVault Modular Disk Series of storage arrays. NOTE: Not all commands are necessarily valid with all storage arrays - some commands are specific to certain platforms.
Page 226
• Create Disk Group • Create RAID Virtual Disk (Automatic Physical Disk Select) • Create RAID Virtual Disk (Manual Physical Disk Select) • Create Snapshot Virtual Disk • Create Virtual Disk Copy • Recopy Virtual Disk Copy • Remove Virtual Disk Copy •...