Dell PowerVault MD3260 Cli Manual

Dell PowerVault MD3260 Cli Manual

Powervault modular disk storage arrays
Hide thumbs Also See for PowerVault MD3260:
Table of Contents
Dell PowerVault Modular Disk Storage Arrays
CLI Guide
Table of Contents
loading

Summary of Contents for Dell PowerVault MD3260

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

    CAUTION: A CAUTION indicates either potential damage to hardware or loss of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2012 Dell Inc. Trademarks used in this text: Dell , the Dell logo, Dell Boomi , Dell Precision , OptiPlex...
  • Page 3: Table Of Contents

    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...
  • Page 11: About The Command Line Interface

    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.
  • Page 12: Usage Notes

    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 14: Command Line Parameters

    [-n storage-array-name | -w WWID | -h host-name | -r (host_sa | direct_sa)] [-S] SMcli -d [-w][-i][-s][-v][-S] SMcli -m host-name-or-IP-address -F email-address [-g contactInfoFile][-S] SMcli -A [host-name-or-IP-address [host-name-or-IP-address]] [-S] SMcli -X (-n storage-array-name | -w WWID | -h host-name) SMcli -? Command Line Parameters Table 2.
  • 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. •...
  • Page 18: Formatting Considerations

    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.
  • Page 19: Exit Status

    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.
  • Page 20: Usage Examples

    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.
  • Page 23: About The Script Commands

    About The Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or run a file of script commands.
  • Page 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...
  • Page 25: Script Command Synopsis

    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.
  • Page 26: Recurring Syntax Elements

    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 27 Recurring Syntax Syntax Value physical disk-spec enclosureID, slotID physical disk-spec { physical disk-spec } physical disk-spec-list enclosureID { enclosureID } enclosure-id-list hex-literal 0x hexadecimal-literal virtual disk-group-number integer-literal filename string-literal error-action (stop | continue) physical disk-channel-identifier (1 | 2) physical disk-channel-identifier { physical disk-channel- physical disk-channel-identifier-list identifier } host-channel-identifier...
  • 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...
  • Page 30: Usage Guidelines

    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 . // Deletes the existing configuration. clear storageArray Configuration; •...
  • Page 33: Configuring A Storage Array

    Configuring A Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts and terminology.
  • Page 34: Determining What Is On Your Storage Array

    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.
  • Page 35: Saving A Configuration To A File

    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) •...
  • Page 36: Using The Create Virtual Disk Command

    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.
  • Page 38: Using The Auto Configure Command

    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.
  • Page 40: Modifying Your Configuration

    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.
  • Page 41: Setting The Raid Controller Module Clocks

    By default, all alert configuration settings are None. The following example shows how to set the mail server IP and the sender address configurations for SMTP alerts: SMcli -m 123.45.67.892 -F [email protected] SMcli -m MyCompany.com -F [email protected] 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:[email protected] 123.45.67.89 -I eventOnly The following example shows how to set the SNMP trap alert configuration.
  • Page 42: Setting Modification Priority

    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: •...
  • Page 43: Selecting The Event Levels For Alert Notifications

    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 –...
  • Page 45: Using The Snapshot Feature

    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 .
  • Page 46: Using Host Servers To Create An Initial Snapshot Virtual Disk

    This can result in data loss on the source virtual disk or an inaccessible snapshot. For details on mapping the snapshot virtual disk to the secondary node, 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.
  • Page 47: Enabling The Snapshot Virtual Disk Feature

    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: •...
  • Page 48: Creating The Initial Snapshot Virtual Disk

    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.
  • Page 49: Creating A Snapshot Virtual Disk With Software-Assigned Physical 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.
  • Page 50: User-Defined Parameters

    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.
  • Page 52: Names Of Snapshot Virtual Disks And Repository Virtual Disks

    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=...
  • Page 53: Changing Snapshot Virtual Disk Settings

    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.
  • Page 54: Re-Creating The Snapshot Virtual Disk

    Re-creating The Snapshot Virtual Disk To restart a copy-on-write operation, use the recreate snapshot virtualDisk command. This command starts a fresh copy-on-write operation using an existing snapshot virtual disk. When you restart a snapshot virtual disk, the snapshot virtual disk must have either an Optimal or a Disabled state. The following conditions then occur: •...
  • Page 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.
  • Page 57: Using The Virtual Disk Copy Feature

    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.
  • Page 58: Creating A Virtual Disk Copy

    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.
  • Page 59: Preparing Host Servers To Create A Virtual Disk Copy

    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.
  • Page 60: Viewing Virtual Disk Copy Properties

    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.
  • Page 61: Changing Virtual Disk Copy Settings

    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: •...
  • Page 62: Recopying A Virtual Disk

    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.
  • Page 63: Stopping A Virtual Disk Copy

    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.
  • Page 64: Interaction With Other Features

    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.
  • Page 67: Using The Remote Replication Premium Feature

    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.
  • Page 68: Replication Repository Virtual Disks

    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.
  • Page 69: Link Interruptions Or Secondary Virtual Disk Errors

    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.
  • Page 70: Creating A Remote Replicated Pair

    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.
  • Page 71: Enabling The Remote Replication Premium Feature

    – 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.
  • Page 73: Determining Candidates For A Remote Replicated Pair

    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...
  • Page 74: Changing Remote Replication Settings

    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.
  • Page 75: Suspending And Resuming A Replication Relationship

    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.
  • Page 76: Deleting A Primary Virtual Disk Or A Secondary Virtual Disk

    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.
  • Page 77: Snapshot Virtual Disks

    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.
  • Page 78: Virtual Disk Expansion

    After you create a virtual disk copy, the target virtual disk automatically becomes read‑only to hosts to ensure that the data is preserved. Hosts that have been mapped to a target virtual disk do not have write access to the virtual disk, and any attempt to write to the read-only target virtual disk results in a host I/O error.
  • Page 79: Maintaining A Storage Array

    Maintaining A Storage Array Maintenance covers a broad spectrum of activities. Its goal is to keep a storage array operational and available to all hosts. This chapter provides descriptions of command line interface (CLI) and script commands that you can use to perform storage array maintenance.
  • Page 80: Running A Consistency Check

    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.
  • Page 81: Enabling Raid Controller Module Data Transfer

    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.
  • Page 82: Performance Tuning

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

    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.
  • Page 84: Collecting Physical Disk Data

    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.
  • Page 85: Setting Raid Controller Module Operational Mode

    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.
  • Page 86: Reconstructing A Physical Disk

    When you initialize a physical disk, all old disk group and virtual disk information is erased, and the physical disk is returned to an unassigned state. Returning a physical disk to an unassigned state adds unconfigured capacity to a storage array. 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.
  • Page 89: Script Commands

    Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the current configuration so that you can reinstall it if the changes do not work.
  • Page 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.
  • Page 91: Firmware Compatibility Levels

    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. •...
  • Page 92: Iscsi Commands

    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...
  • Page 93: Raid Controller Module Commands

    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...
  • Page 94: Session Command

    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...
  • Page 95: Virtual Disk Commands

    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...
  • Page 96: Virtual Disk Copy Commands

    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.
  • Page 99: Activate Storage Array Firmware

    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.
  • Page 100: Autoconfigure Storage Array Hot Spares

    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.
  • Page 101: Check Virtual Disk Consistency

    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...
  • Page 102: Clear Physical Disk Port Statistics

    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.
  • Page 103: Clear Storage Array Core Dump

    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.
  • Page 104: Clear Storage Array Recovery Mode

    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...
  • Page 105: Configure Automatic Support Bundle Collection

    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 106 Syntax create diskGroup physicalDisks=(enclosureID1,drawerID1,slotID1 enclosureID2,slotID2... enclosureIDn,drawerIDn,slotIDn) raidLevel=(0 | 1 | 5 | 6) userLabel=”diskGroupName” [driveMediaType=(HDD | SSD | unknown | allMedia) capacity=virtualDiskCapacity owner=(0 | 1) cacheReadPrefetch=(TRUE | FALSE) segmentSize=segmentSizeValue usageHint=(fileSystem | dataBase | multiMedia) enclosureLossProtect=(TRUE | FALSE) drawerLossProtect=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter...
  • 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.
  • Page 109: Create Disk Pool

    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: •...
  • Page 111: Create Host

    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...
  • Page 112: Create Iscsi Initiator

    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.
  • Page 113: Create Raid Virtual Disk (Automatic Physical Disk Select)

    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.
  • Page 114: Create Raid Virtual Disk (Free Capacity Base Select)

    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.
  • Page 116: Create Raid Virtual Disk (Manual Physical Disk Select)

    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.
  • Page 119: Create Raid Virtual Disk On A Disk Pool

    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. •...
  • Page 120: Create Remote Replication

    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.
  • Page 122: Create Snapshot 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).
  • Page 126: Scheduling Snapshots

    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.
  • Page 127: Create Storage Array Security Key

    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.
  • Page 129: Create Virtual Disk Copy

    Create Virtual Disk Copy This command creates a virtual disk copy and starts the virtual disk copy operation. CAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and (if applicable, the target disk) to ensure that you capture an accurate point-in-time image of the source virtual disk.
  • Page 130: Deactivate Remote Replication

    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 (<...
  • Page 131: Delete Disk Pool

    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.
  • Page 132: Delete Host Port

    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 ("...
  • Page 133: Delete Snapshot Virtual Disk Or Delete Snapshot Virtual Disk Schedule

    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\"];"...
  • Page 134: Delete Virtual Disk On A Disk Pool

    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.
  • Page 135: Diagnose Raid Controller Module

    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.
  • Page 136: Diagnose Raid Controller Module Iscsi Host Cable

    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.
  • Page 137: Diagnose Remote Replication

    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.
  • Page 138: Disable Storage Array Feature

    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 (“...
  • Page 139: Download Enclosure Management Module Firmware

    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"...
  • Page 140: Download Storage Array Firmware/Nvsram

    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 •...
  • Page 141: Download Storage Array Physical Disk Firmware

    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.
  • Page 142: Download Storage Array Nvsram

    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 ("...
  • Page 143: Enable Raid Controller Module Data Transfer

    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.
  • Page 144: Increase Virtual Disk Capacity On A Disk Pool

    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.
  • Page 145: Recopy Virtual Disk Copy

    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.
  • Page 146: Re-Create Remote Replication Repository Virtual Disk

    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: •...
  • Page 148: Re-Create Snapshot

    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 ("...
  • Page 150: Reduce Disk Pool Capacity

    • 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.
  • Page 151: Remove Virtual Disk Copy

    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...
  • Page 152: Repair Virtual Disk Consistency

    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.
  • Page 153: Reset Raid Controller Module

    • An unassigned physical disk • A fully integrated hot spare physical disk Syntax replace physicalDisk ([enclosureID,slotID] | ) 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.
  • Page 154: Reset Storage Array Battery Install Date

    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.
  • Page 155: Reset Storage Array Sas Phy Baseline

    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.
  • Page 156: Resume Snapshot Rollback

    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.
  • Page 157: Revive Disk Pool

    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.
  • Page 158: Save Physical Disk Channel Fault Isolation Diagnostic Status

    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.
  • Page 159: Save Storage Array Configuration

    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.
  • Page 160: Save Storage Array Events

    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;...
  • Page 161: Save Storage Array Iscsi Statistics

    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: •...
  • Page 162: Save Storage Array Sas Phy Counts

    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.
  • Page 163: Schedule Support Bundle Collection Configuration

    • 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"...
  • Page 164: Scheduling Snapshots

    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).
  • Page 165: Set Disk Group

    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.
  • Page 167: Set Disk Group Forced State

    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.
  • Page 168: Set Enclosure Attribute

    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.
  • Page 169: Set Foreign Physical Disk To Native

    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.
  • Page 170: Set Host Channel

    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.
  • Page 171: Set Host Group

    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 ([ ]).
  • Page 172: Set Iscsi Initiator

    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.
  • Page 173: Set Physical Disk Channel Status

    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 (<...
  • Page 174: Set Physical Disk Hot Spare

    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.
  • Page 175: Set Raid Controller Module

    Set RAID Controller Module This command defines the attributes for the RAID controller modules. Syntax set controller [(0 | 1)] availability=(online | offline | serviceMode) | ethernetPort [(1 | 2)]=ethernetPortOptions | globalNVSRAMByte [nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | hostNVSRAMByte [hostType, nvsramOffset]= (nvsramByteSetting | nvsramBitSetting) | IPv4GatewayIP=ipAddress |...
  • Page 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.
  • Page 177: Set Remote Replication

    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.
  • Page 179: Set Session

    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.
  • Page 180: Set Snapshot Virtual Disk

    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.
  • Page 181: Set Storage Array

    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).
  • Page 183: Set Storage Array Enclosure Positions

    • 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. •...
  • Page 184: Set Storage Array Icmp Response

    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.
  • Page 185: Set Storage Array Isns Server Ipv6 Address

    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.
  • Page 186: Set Storage Array Redundancy Mode

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

    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 ) 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.
  • Page 190: Set Virtual Disk Copy

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

    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.
  • Page 192: Show Disk Group

    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 (<...
  • Page 193: Show Disk Group Import Dependencies

    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.
  • Page 194: Show Physical Disk

    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: •...
  • Page 195: Show Physical Disk Channel Statistics

    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: •...
  • Page 196: Show Physical Disk Download Progress

    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.
  • Page 197: Show Raid Controller Module Nvsram

    • 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.
  • Page 198: Show Remote Replication Virtual Disk Candidates

    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.
  • Page 199: Show Storage Array

    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.
  • Page 200: Show Storage Array Auto Configure

    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...
  • Page 201: Show Storage Array Host Topology

    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.
  • Page 202: Show Storage Array Lun Mappings

    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"]]...
  • Page 203: Show Storage Array Unreadable Sectors

    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) –...
  • Page 205: Show Virtual Disk Action Progress

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

    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...
  • Page 207: Show Virtual Disk Reservations

    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...
  • Page 208: Start Disk Group Blink

    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.
  • Page 209: Start Disk Group Import

    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.
  • Page 210: Start Iscsi Dhcp Refresh

    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...
  • Page 211: Start Physical Disk Channel Blink

    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.
  • Page 212: Start Physical Disk Initialize

    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.
  • Page 213: Start Remote Replication Synchronization

    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.
  • Page 214: Stop Snapshot Rollback

    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...
  • Page 215: Start Virtual Disk Initialization

    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.
  • Page 216: Stop Disk Pool Locate

    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.
  • Page 217: Stop Snapshot

    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 .
  • Page 218: Stop Virtual Disk Copy

    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...
  • Page 219: Validate Storage Array Security Key

    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.
  • Page 221: Sample Script Files

    Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array.
  • Page 222: Configuration Script Example 2

    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.
  • Page 225: Cli Command Updates

    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 •...

Table of Contents