Dell PowerVault MD 34XX/38XX Series Storage Arrays CLI Guide
Notes, cautions, and warnings NOTE: A NOTE indicates important information that helps you make better use of your computer. 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. © 2016 Dell Inc. All rights reserved. This product is protected by U.S. and international copyright and intellectual property laws.
Contents 1 CLI Command Updates...................................................................................... 16 New Commands..................................................................................................................................16 Updated Commands........................................................................................................................... 16 2 About The Command Line Interface...............................................................
5 Using The Snapshot Feature.............................................................................53 Before Using Snapshot CLI Commands.............................................................................................53 Snapshot Images And Groups............................................................................................................ 53 Snapshot Groups And Snapshot Consistency Groups......................................................................
Names Of Snapshot Virtual Disks And Repository Virtual Disks.................................................. 76 Changing Snapshot Virtual Disk Settings........................................................................................... 76 Stopping And Deleting A Snapshot Virtual Disk................................................................................. 77 Re-creating The Snapshot Virtual Disk ........................................................................................
Adding Secondary Virtual Disk To Remote Replication Group.........................................................94 Suspending A Remote Replication Group......................................................................................... 94 Deleting A Remote Replication Group...............................................................................................95 Removing A Virtual Disk Or Repository Virtual Disk From A Remote Replication Group................
Synchronizing RAID Controller Module Clocks......................................................................... 115 Locating Physical Disks................................................................................................................115 Performance Tuning..........................................................................................................................115 Monitoring Performance......................................................................................
Virtual Disk Copy Commands..................................................................................................... 133 12 Commands Listed Alphabetically................................................................ 134 Activate Remote Replication Feature............................................................................................... 134 Activate Storage Array Firmware.......................................................................................................
Create RAID Virtual Disk (Manual Physical Disk Select)...................................................................180 Create RAID Virtual Disk On A Disk Pool......................................................................................... 184 Create Read-Only Snapshot Virtual Disk......................................................................................... 186 Create Remote Replication.................................................................................................
Enable Disk Pool Security................................................................................................................. 232 Enable or Disable ODX..................................................................................................................... 232 Enable Or Disable SSD Cache For A Virtual Disk............................................................................. 233 Enable or Disable VAAI............................................................................
Resume Snapshot (Legacy) Rollback................................................................................................271 Resume Snapshot Virtual Disk.......................................................................................................... 271 Resume SSD Cache...........................................................................................................................273 Revive Disk Group................................................................................
Set Physical Disk Channel Status..................................................................................................... 304 Set Physical Disk Hot Spare..............................................................................................................305 Set Physical Disk State......................................................................................................................306 Set RAID Controller Module..............................................................
Show Physical Disk Download Progress..........................................................................................356 Show RAID Controller Module......................................................................................................... 357 Show RAID Controller Module NVSRAM......................................................................................... 358 Show Remote Replication Group........................................................................................
Start Input Output RAID Controller Module (IOC) Dump............................................................... 392 Start iSCSI DHCP Refresh................................................................................................................. 392 Start Physical Disk Blink.................................................................................................................... 393 Start Physical Disk Channel Blink.......................................................................
Test Remote Replication Group Connectivity................................................................................. 418 Test SNMP Trap Destination.............................................................................................................419 Unregister SNMP Community..........................................................................................................420 Unregister SNMP Trap Destination..............................................................................
CLI Command Updates 1 This chapter reflects new and updated commands that are available for use with the Dell PowerVault MD 34XX/38XX Series storage arrays. NOTE: Not all commands are valid with all storage arrays. Some commands are specific to certain platforms. 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.
About The Command Line Interface 2 This guide is intended for system administrators, developers, and engineers who need to use the command line interface (CLI) tool and its associated commands and script files. Selected CLI commands perform functions that can also be accessed from the Modular Disk (MD) Storage Manager, which is the graphical user interface (GUI) to the storage array.
How To Use The Command Line Interface Using the CLI commands, you can access the script engine, specify which storage array receives the script commands, and set operation environment parameters. 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.
• Set passwords • Add storage arrays • Specify communication parameters • Enter individual script configuration commands • Specify a file containing script configuration commands The following are general forms of the CLI commands, showing the parameters and terminals used in each command. The table below lists definitions for the parameters shown in the CLI commands. Table 1.
[-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.
Parameter Definition -c 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. -d Use to display the contents of the script configuration file. -e Use to disable syntax checking when executing the current CLI command.
Parameter Definition -h Use with the -a and -x parameters to specify the host name that is running the SNMP agent to which the storage array is connected. -I Use to specify the type of information to be included in the e-mail alert notifications. The following are valid information arguments: • • • eventOnly— Only event information is included in the e-mail. profile— Event and array profile information is included in the e-mail.
Parameter Definition • -q The storage array password is specified by using the -c parameter and the set session password=password command. Use to specify how frequently to include additional profile or support bundle information in the e-mail alert notifications. An e-mail alert notification that contains at least the basic event information is always generated for every critical event. If you set the-I parameter to eventOnly, the only valid argument for -q is everyEvent.
Parameter Definition -v Use with the -d parameter to display the current global status of the known devices in the storage array configuration file. (The configuration file lists all of the devices in a storage array configuration and the relationship between the devices. Use the configuration file to reconstruct a storage array). -X (uppercase) Use to delete a storage array from the configuration file.
• The CLI automatically saves the error data by writing the data to a file with a standard name. • The CLI does not have any provisions to avoid overwriting an existing version of the file containing error data.
Status Value Meaning 14 The RAID controller module was unable to communicate with the storage array. 15 A duplicate argument was entered. 16 An execution error occurred. 17 A host was not at the specified address. 18 The World Wide Identifier (WWID) was not in the configuration file. 19 The WWID was not at the address. 20 An unknown IP address was specified. 21 The event monitor configuration file was corrupted. 22 The storage array was unable to communicate with the event monitor.
Windows: SMcli -n "Payroll_Array" -c "set storageArray userLabel=\"Finance_Array\";" Linux: SMcli -n ‘Payroll_Array’ -c ‘set storageArray userLabel="Finance_Array";’ This example shows how to delete an existing virtual disk and create a new virtual disk on a storage array. The existing virtual disk name is Stocks_<_Bonds. The new virtual disk name is Finance. The RAID controller module host names are finance1 and finance2. The storage array is protected and requires the password TestArray.
About The Script Commands 3 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. When entering an individual script command, include it as part of a CLI command. When running a file of script commands, include the file name as part of a CLI command.
Operation Activities Firmware management Downloading RAID controller module, enclosure management module (EMM), and physical disk firmware Script Command Structure All script commands have the following structure: command operand-data {statement-data} where, command identifies the action to be performed, operand-data represents the storage array component to configure or manage (such as a RAID controller module, physical disk, or disk group), and statement-data is what you want to do to the component (s
Object Type Identifier host User label hostChannel Host channel identifier hostGroup User label hostPort User label snapVirtualDiskName Virtual disk user label snapshot Virtual disk user label snapGroup A snapshot group contains a sequence of snapshot images of an associated base virtual disk. A snapshot group has a repository virtual disk that is used to save data for all of the snapshot images that are part of the snapshot group.
Command Syntax Description check object {statement‑data} Starts a synchronous operation to report on errors in the object. clear object {statement‑data} Discards the contents of some attribute of an object. This is a destructive operation that cannot be reversed. create object {statement‑data} Creates an object of the specified type. deactivate object {statement‑data} Removes the environment for an operation. delete object Deletes a previously created object.
Command Syntax Description stop object {statement‑data} Stops an asynchronous operation. suspend object {statement‑data} Suspends an operation. You can then restart the suspended operation, and it continues from the point at which it was suspended. Recurring Syntax Elements Recurring syntax elements are a general category of variables and parameters you can use in one or more script commands.
Recurring Syntax Syntax Value physical disk-channel-identifier-list physical disk-channel-identifier {physical diskchannel-identifier} host-channel-identifier (01 | 02 | 11 | 12) physical disk-type (Serial Attached SCSI [SAS]) feature-identifier (snapshot | virtualDiskCopy) repository-spec instance-based-repository-spec | count-basedrepository-spec ethernet-port-options IPV4Address=ipv4-address| IPV4ConfigurationMethod=[(static | dhcp)] | IPV4GatewayIP=ipv4-address| IPV4SubnetMask=ipv4-address|
Recurring Syntax Syntax Value IPV4SubnetMask=ipv4-address | IPV4VlanID=integer | IPV6VlanID=integer | maxFramePayload=integer | tcpListeningPort=tcp-port-id| 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. It is represented by eight 16-bit hexadecimal blocks separated by colons. You may drop leading zeros, and use a double colon to represent consecutive blocks of zeroes.
Recurring Syntax Syntax Value [physicalDiskType=physical disk-type] [enclosureLossProtect=boolean] WWID string-literal For hostPort identifiers this is a 16-digit hex number without any colon delimiters. nvsram-offset hexadecimal-literal host-type string-literal | integer-literal nvsram-byte-setting nvsram-value (0x hexadecimal | integer-literal) nvsram-bit-setting nvsram-mask, nvsram-value (0x hexadecimal, 0x hexadecimal | integer-literal) ipv4-address (0–255).(0–255).(0–255).
Recurring Syntax Syntax Value NOTE: The virtualDisksPerGroupCount parameter is the number of equal capacity virtual disks per disk group.
For enclosure loss protection to work, your configuration must adhere to the following guidelines: Table 9. CLI and Script Commands for Version 11.25 Level Criteria for Enclosure Loss Protection Minimum Number of Enclosures Required Disk Pool The disk pool contains no more 6 than two physical disks in a single enclosure. RAID Level 6 The virtual disk group contains no more than two physical disks in a single enclosure.
drawerLossProtect parameter are not set to the same value, the storage array returns an error message and a storage array configuration will not be created. To determine if a free capacity area exists, run the show diskGroup command. The default physical disk is SAS. The physicalDiskType parameter is not required if only one type of physical disks is in the storage array. If you use the physicalDiskType parameter, you also must use the hotSpareCount parameter and the virtualDiskGroupWidth parameter.
NOTE: When all the required hardware and the I/O interface is DA-capable, you can set the dataAssurance parameter to enabled and then use DA with certain operations. For example, you can create a virtual disk group that includes DA-capable physical disks, and then create a virtual disk within that disk group that is DA-enabled. Other operations that use a DA-enabled disk have options to support the DA feature.
Configuring A Storage Array 4 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. Before configuring the storage array, become familiar with the concepts of physical disks, disk groups, virtual disks, host groups, hosts, and RAID controller modules.
access data is affected by the disk group RAID level and the segment size settings. Data protection is determined by the RAID level, hardware redundancy (such as global hot spares), and software redundancy (such as the Snapshot feature).
save the output to a file. To save the output to a file, enter the command as shown in the following example: client>smcli 123.45.67.89 -c "show storageArray profile;" -o c:\folder\storageArrayprofile.txt In this example, the name folder is the folder in which you choose to place the profile file, and storageArrayprofile.txt is the name of the file. You can choose any folder and any file name.
Saving A Configuration To A File CAUTION: When you write information to a file, the script engine does not check to determine if the file name already exists. If you choose the name of a file that already exists, the script engine writes over the information in the file without warning. After you have created a new configuration or if you want to copy an existing configuration for use on other storage arrays, you can save the configuration to a file.
The userLabel parameter is the name to give to the virtual disk. The virtual disk name can be any combination of alphanumeric characters, hyphens, and underscores. The maximum length of the virtual disk name is 30 characters. Spaces are not allowed. You must put quotation marks (" ") around the virtual disk name. The physicalDisks parameter is a list of the physical disks that you want to use for the disk group. Enter the enclosure ID and slot ID of each physical disk that you want to use.
(SAS)] [capacity=virtualDiskCapacity | owner=(0 | 1) | segmentSize=segmentSizeValue] [enclosureLossProtect=(TRUE | FALSE)]) NOTE: The physicalDiskType, capacity, owner, segmentSize, and enclosureLossProtect parameters are optional. You can use one or all of the optional parameters as needed to help define your configuration. You do not, however, need to use any optional parameters. This command is similar to the previous create virtualDisk command, which allows the user to assign the physical disks.
Enclosure Loss Protection The enclosureLossProtect parameter is a boolean switch that turns enclosure loss protection on or off. To work properly, each physical disk in a virtual disk group must be in a separate enclosure. Enclosure loss protection is set under the following conditions: • • You assign the physical disks. The RAID controller module assigns the physical disks. The following table shows possible results for the enclosureLossProtect parameter.
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.
Example Of The Auto Configuration Command client>smcli 123.45.67.89 -c "autoConfigure storageArray physicalDiskType=SAS raidLevel=5 diskGroupWidth=8 diskGroupCount=3 virtualDisksPerGroupCount=4 hotSpareCount=2 segmentSize=8;" 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.
characters. You must put quotation marks (" ") around the password. The following example shows how to use the set storageArray command to define a password: client>smcli 123.45.67.89 -c "set storageArray password=\"1a2b3c4d5e"\;" Setting Up SMTP And SNMP Alerts The storage array can be set up to send automatic e-mail alert messages to specified email addresses when specific events occur.
array. The only time you might need to use this parameter is if you need to change how the storage array behaves relative to the hosts. Before you can define the default host type, you need to determine what host types are connected to the storage array. To return information about host types connected to the storage array, you can use the show storageArray command with the defaultHostType parameter or hostTypeTable parameter.
Assigning Global Hot Spares Hot spare physical disks can replace any failed physical disk in the storage array. The hot spare must be the same type of physical disk as the physical disk that failed and must have capacity greater than or equal to any physical disk that can fail. If a hot spare is smaller than a failed physical disk, the hot spare cannot be used to rebuild the data from the failed physical disk. Hot spares are available only for RAID levels 1 or 5.
You can configure the MD storage management software to notify only the event levels that you specify. For example, you can configure alert notifications only for Critical and Warning events. 1. Open the Configure Alerts dialog by performing one of these actions: a. Select a storage array in the Devices tab in the EMW. b. Select Edit → Configure Alerts. The Configure Alerts dialog is displayed. Go to step 3. c. Select Configure Alerts in the Setup tab in the EMW. Go to step 2. 2.
Using The Snapshot Feature 5 The following types of virtual disk snapshot premium features are supported on the MD storage array: • • Snapshot Virtual Disks using multiple point-in-time (PiT) groups Snapshot Virtual Disks (Legacy) using a separate repository for each snapshot NOTE: This section describes the Snapshot Virtual Disk using PiT groups. If you are using the Snapshot Virtual Disk (Legacy) premium feature, see Using The Snapshot (Legacy) Feature.
Only the following can be included in a snapshot image: • Standard virtual disks • Thin provisioned virtual disks • Consistency groups Snapshot Groups And Snapshot Consistency Groups The Snapshot Virtual Disk premium feature supports two types of snapshot groups: • Snapshot groups • Consistency groups Snapshot Groups The purpose of a snapshot group is to create a sequence of snapshot images on a given base virtual disk without impacting performance.
• Consistency groups can be created initially with or without member virtual disks. • Snapshot images can be created for a consistency group to enable consistent snapshot images between all member virtual disks. • Consistency groups can be rolled back. • A virtual disk can belong to multiple consistency groups. • Only standard virtual disks and thin virtual disks can be included in a consistency group.
Creating Snapshot Images Guidelines before creating a snapshot image: • If you attempt to create a snapshot image on a snapshot group and that snapshot group has reached its maximum number of snapshot images. The failBaseWrites or purgeSnapImages parameters used with the create snapGroup command allows you to choose to either fail the write attempt or automatically purge a specified number of older snapshot images.
retainCount=numberOfSnapImages | ignoreSnapVirtualDisk=(TRUE | FALSE) | snapImageID=OLDEST) Creating A Consistency Group Snapshot Virtual Disk Creating a snapshot virtual disk of a consistency group creates a viewable virtual disk of specific images in the consistency group. A consistency group snapshot virtual disk can be made up of a single base virtual disk or multiple base virtual disks from the consistency group.
Create a consistency group snapshot virtual disk that has a repository full limit set to 60 percent on a snapshot consistency group named snapCG1 with these three members cgm1, cgm2, and cgm3, with the following command: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageID="snapCG1:oldest" repositoryFullLimit=60; Create a read/write consistency group snapshot virtual disk with automatic repository selection on a snapshot consistency group named snapCG1 with members cgm1, cgm2, and cgm3, wit
• The repository’s reserve space for reuse within the consistency group is released. • Any member virtual disk associated with the deleted snapshot image(s) is moved to a Stopped state. • The member snapshot virtual disks associated with the deleted snapshot image(s) is deleted.
To start a rollback for a snapshot group named snapGroup1: start snapImage ["snapGroup1"] rollback You can specify a snapshot image rollback for a specific snapshot image in a snapshot group named 12345: stop snapImage ["snapGroup1:12345"] rollback; To stop a rollback operation for the most recent snapshot image in a snapshot group that has the name snapGroup1: stop snapImage ["snapGroup1:newest"] rollback; The repository virtual disk associated with the snapshot image continues to track any new changes bet
Deleting A Snapshot Group CAUTION: All of the data in the snapshot group is lost as soon as you run this command. This command deletes an entire snapshot group and, if specified, the associated repository virtual disks. delete snapGroup ["snapGroupName"] deleteRepositoryMembers=TRUE; In the example, the repository virtual disks were preserved . By default, all member virtual disks in the repository virtual disk are retained as unused, unmapped standard virtual disks.
Deleting A Consistency Group This command deletes a snapshot consistency group. You can either delete both the consistency group and the repository virtual disks contained by the consistency group, or you can delete only the consistency group and leave the repository virtual disks contained in the consistency group intact.
autoDeleteLimit allows you to configure each snapshot group to perform automatic deletion of its snapshot images to keep the total number of snapshot images in the snapshot group at or below a maximum number of images. When the number of snapshot images in the snapshot group is at the maximum limit, the autoDeleteLimit parameter automatically deletes snapshot images whenever a new snapshot image is created in the snapshot group.
The removeCGMemberVirtualDisk parameter is the name of the member virtual disk that you want to remove; deleteRepositoryMembers determines whether the command removes all the repository members from the consistency group.
preReadConsistencyCheck=(TRUE | FALSE) readCacheEnabled=(TRUE | FALSE) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) Syntax Applicable To Only One Virtual Disk set (virtualDisk ["virtualDiskName"] | virtualDisk ) addCapacity=virtualDiskCapacity [addPhysicalDisks=(enclosureID1,drawerID1,slotID1 ...
• Capacity for rollback processing, which is 1/5000th of the capacity of the base virtual disk. If you are creating a new repository virtual disk when you run this command, you must enter the name of a disk group or disk pool from which you want the repository virtual disk. Optionally, you can also define the capacity of the repository virtual disk. The following capacity values are supported: • • • A percentage ( integer value) representing an amount of the base virtual disk capacity.
• standalone snapshot virtual disk • snapshot virtual disk that is a member of a consistency group If the snapshot virtual disk is not in a Failed state, the firmware displays an error message and does not run this command. revive snapVirtualDisk ["snapVirtualDiskName"] NOTE: This command for a snapshot virtual disk used in online virtual disk copy.
Using The Snapshot (Legacy) Feature 6 The following types of virtual disk snapshot premium features are supported on the MD storage array: • Snapshot Virtual Disks using multiple point-in-time (PiT) groups • Snapshot Virtual Disks (Legacy) using a separate repository for each snapshot NOTE: This section describes the Snapshot Virtual Disk (legacy) premium feature. If you are using the Snapshot Virtual Disk using PiT groups, see the Using The Snapshot Feature section.
The following table lists the components that comprise a snapshot virtual disk and briefly describes what they do. Table 11.
• You must satisfy the requirements of your host operating system for creating snapshot virtual disks. Failure to meet the requirements of your host operating system results in an inaccurate point-in-time image of the source virtual disk or the target virtual disk in a virtual disk copy.
Preparing Host Servers To Create An Initial Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the source virtual disk. Close all applications, including Windows Internet Explorer, to make sure all I/O activity has stopped.
NOTE: Use one or all of the optional parameters as needed to help define your configuration. You do not need to use any optional parameters. See step 1 through step 4 in the preceding section, Preparing Host Servers To Create An Initial Snapshot Virtual Disk. The following example shows a command in which users assign the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\" repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5);" The comm
NOTE: Use one or all of the optional parameters as needed to define your configuration. It is not necessary to use any optional parameters. The following example is a command in which software assigns the physical disks: client>smcli 123.45.67.89 -c "create snapshotVirtualDisk sourceVirtualDisk= \"Mars_Spirit_4\" repositoryDiskGroup=2 freeCapacityArea=2;" The command in this example creates a new snapshot repository virtual disk in disk group 2. The source virtual disk is Mars_Spirit_4.
The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=3; User-Defined Parameters Parameters for the create snapshotVirtualDisk command enable you to define the snapshot virtual disk to suit the requirements of your storage array. The following table lists the parameters and descriptions of Snapshot Virtual Disk. Table 13.
Parameter Description warningThresholdPercent Specifies how full to allow the snapshot repository virtual disk to get before sending a warning that the snapshot repository virtual disk is close to capacity. The warning value is a percentage of the total capacity of the snapshot repository virtual disk. The default value is 50, which represents 50 percent of total capacity. (Change this value using the set snapshotVirtualDisk command.
The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel="Mars_Spirit_4_snap1" repositoryUserLabel="Mars_Spirit_4_rep1" warningThresholdPercent=75 repositoryPercentOfSource=40 repositoryFullPolicy=failSnapShot; NOTE: In the previous examples, the names for the snapshot virtual disk and repository virtual disk are defined by the user.
The following example shows the command to change the name of a snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisk [\"Mars_Spirit_4-1\"] userLabel=\"Mars_Odyssey_3-2\";" The following example is the script file version of the command: set virtualDisk ["Mars_Spirit_4-1"] userLabel= "Mars_Odyssey_3-2"; When you change the warning threshold percent and repository full policy, you can apply the changes to one or several snapshot virtual disks.
Preparing Host Servers To Re-create A Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and snapshot virtual disk to ensure that you capture an accurate point-in-time image of the source virtual disk. Close all applications, including Windows Internet Explorer, to make sure all I/O activity has stopped.
Using The Virtual Disk Copy Feature 7 This chapter describes how the Virtual Disk Copy feature works, lists the script commands for Virtual Disk Copy, and explains how to use the commands to create and run Virtual Disk Copy. Additional information about Virtual Disk Copy and related definitions is available in the Deployment Guide and the Administrator's Guide.
In either type of virtual disk copy, the target virtual disk is locked and cannot be accessed while the copy operation is in place. After completion of the virtual disk copy of a snapshot (legacy), the legacy snapshot is disabled. After completion of the virtual disk copy using a snapshot image, the snapshot image is deleted and the snapshot virtual disk is disabled. NOTE: You can have a maximum of eight virtual disk copies in progress at one time.
Creating A Virtual Disk Copy Before creating a virtual disk copy, ensure that a suitable target virtual disk exists on the storage array, or create a new target virtual disk specifically for the virtual disk copy. The target virtual disk must have a capacity equal to or greater than the source virtual disk. You can have a maximum of eight virtual disk copies in progress at one time.
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. Close all applications, including Windows Internet Explorer, to make sure all I/O activity has stopped.
– In Linux, mount the 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 shows a command that returns information about a virtual disk used for a virtual disk copy: client>smcli 123.45.67.89 -c "show virtualDiskCopy source [\"Jaba_Hut\"];" The command in the preceding example requests information about the source virtual disk Jaba_Hut. If you want information about all virtual disks, use the allVirtualDisks parameter. You can also request information about a specific target virtual disk.
The following example shows how to change parameters using the set virtualDiskCopy command: client>smcli 123.45.67.89 -c "set virtualDiskcopy target [\"Obi_1\"] copyPriority=highest targetreadonlyenabled=false;" The following example is the script file version of the command: set virtualDiskcopy target ["Obi_1"] copyPriority= highest targetreadonlyenabled=false; Recopying A Virtual Disk CAUTION: The recopy virtualDiskCopy command overwrites existing data on the target virtual disk and makes the target virt
NOTE: If your operating system requires additional instructions, you can find those instructions in your operating system documentation. After your server has been prepared, see Recopying The Virtual Disk to recopy the virtual disk. Recopying The Virtual Disk After first preparing the host server(s) as specified in the preceding procedure, use the following examples to make a virtual disk copy.
Removing Copy Pairs The remove virtualDiskCopy command enables you to remove a virtual disk copy pair from the storage array configuration. All virtual disk copy information for the source virtual disk and target virtual disk is removed from the storage array configuration. The data on the source virtual disk or target virtual disk is not deleted. Removing a virtual disk copy from the storage array configuration also removes the read-only attribute for the target virtual disk.
Using The Remote Replication Premium Feature 8 The following types of Remote Replication premium features are supported on the MD storage array: Remote Replication Standard asynchronous replication using point-in-time images to batch the resynchronization between the local and remote site. This type of replication is supported on either Fibre Channel or iSCSI storage arrays (both local and remote arrays must have the same data protocol).
primary (local) and secondary (remote) virtual disk pairs, called replicated pairs, write operations to the primary virtual disk of the pair are tracked by the RAID controller firmware and captured in a point-intime image and transferred to the secondary virtual disk in the pair. Remote Replication groups allow you to manage synchronization of both virtual disks to create a consistent data set across local and remote storage arrays.
In this case, the remote write operation cannot be completed to the secondary virtual disk, and the primary virtual disk and the secondary virtual disk are no longer correctly replicated. The primary RAID controller module transitions the replicated pair into an Unsynchronized state and sends an I/O completion to the primary host. The primary host can continue to write to the primary virtual disk, but remote writes do not take place.
Remote Replication Group After your Remote Replication premium feature is activated on both local and remote storage arrays, you must create Remote Replication groups on the local storage array. A replication group contains at least one replicated virtual disk pair, one on the local storage and one on the remote storage array, that share data synchronization settings. Multiple replicated pairs can reside in a replication group, but each pair can only be a member of one Remote Replication group.
– The first port that successfully establishes an iSCSI connection is used for all subsequent communication with that remote storage array. If that connection subsequently fails, a new session is attempted using any available ports. Primary And Secondary Virtual Disks Before you create any replication relationships, virtual disks must exist at both the primary site and the secondary site. The virtual disk that resides on the local storage array is the primary virtual disk.
The create asyncRemoteReplicationGroup command creates a new, empty remote replication group on both the local storage array and the remote storage array. Each replicated pair you add to the remote replication group share the same synchronization settings, primary and secondary role, and write mode. This command must be run on the local storage array.
• warningThresholdPercent The following parameters allow you to change (or force) the primary/secondary role of a replication group, or whether or not to perform a synchronization before changing primary/secondary roles. • role • force • nosync You can apply the changes to one or several remote replicated pairs by using this command. Use the primary virtual disk name to identify the remote replicated pairs for which you are changing the properties.
reduce any performance impact to the host application that might occur while any changed data on the primary virtual disk is copied to the secondary virtual disk. When a replication relationship is in a suspended state, the primary virtual disk does not make any attempt to contact the secondary virtual disk. Any writes to the primary virtual disk are persistently logged in the replication repository virtual disks.
Disabling The Remote Replication Premium Feature You disable the Remote Replication premium feature to prevent the new replication relationship from being created. When you disable the Remote Replication premium feature, the premium feature is in a Disabled/Active state. In this state, you can maintain and manage previously existing replication relationships; however, you cannot create new relationships.
Command Description remove asyncRemoteReplicationGroup incompleteRemoteReplication Removes an orphaned replicated pair virtual disk. reset storageArray arvmStats reset storageArray iscsiIpAddress Resets IP address for the remote storage array to re-establish connection with the local storage array or resets synchronization statistics for member virtual disks to relative 0.
Using The Remote Replication (Legacy) Premium Feature 9 The Remote Replication (legacy) 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.
The RAID controller module owner of the primary virtual disk initiates remote writes to the secondary virtual disk to keep the data on the two virtual disks synchronized. The secondary virtual disk maintains a replication (or copy) of the data on its associated primary virtual disk. The RAID controller module owner of the secondary virtual disk receives remote writes from the RAID controller module owner of the primary virtual disk but will not accept host write requests.
Data Replication The RAID controller modules manage data replication between the primary virtual disk and the secondary virtual disk. This process is transparent to host machines and applications. This section describes how data is replicated between the storage arrays that are participating in Remote Replication (legacy). This section also describes the actions taken by the RAID controller module owner of the primary virtual disk if a link interruption occurs between storage arrays.
If one replication relationship in the group becomes unsynchronized, all of the replication relationships in the group become unsynchronized. Any write activity to the remote, secondary storage arrays is prevented to protect the consistency of the remote data set.
blocks of data that have changed on the primary virtual disk during the link interruption are copied to the secondary virtual disk. CAUTION: Possible loss of data access – Any communication disruptions between the primary storage array and the secondary storage array while resynchronization is underway could result in a mix of new data and old data on the secondary virtual disk. This condition would render the data unusable in a disaster recovery situation.
Enabling The Remote Replication (Legacy) Premium Feature The first step in creating a remote replication is to make sure that the Remote Replication (legacy) premium feature is enabled on both storage arrays. Because Remote Replication (legacy) is a premium feature, you need a feature key file to enable the premium feature.
• You define the number of physical disks, but not specific physical disks, for the replication repository virtual disk. Activating The Remote Replication (Legacy) Premium Feature With User-Assigned Physical Disks Activating the Remote Replication (legacy) 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.
The command in this example creates a new replication repository virtual disk in disk group 2 using the second free capacity area.
World Wide Identifier (WWID) of the storage array on which the secondary virtual disk resides. The primary virtual disk name, the secondary virtual disk name, and the remote storage array name (or WWID) are the minimum information that you need to provide. Using this command, you can also define synchronization priority, write order, and write mode.
• The synchronization priority • The write order • The write mode You can apply the changes to one or several remote replicated pairs by using this command. Use the primary virtual disk name to identify the remote replicated pairs for which you are changing the properties. This example shows how to use the set remoteReplication command: c:\...\smX\client>smcli 123.45.67.88 123.45.67.
This example shows how to use the command in a script file: suspend remoteReplication virtualDisk Jan_04_Account writeConsistency=false; The replication relationship remains suspended until you use the resume remoteReplication command to restart synchronization activities. This command restarts data transfers between a primary virtual disk and a secondary virtual disk in a replication relationship after the replication has been suspended or unsynchronized.
CAUTION: Possible loss of data access – Deleting a primary virtual disk or a secondary virtual disk permanently removes the data from the storage array. Disabling The Remote Replication (Legacy) Premium Feature You disable the Remote Replication (legacy) premium feature to prevent the new replication relationship from being created. When you disable the Remote Replication (legacy) premium feature, the premium feature is in a Disabled/Active state.
was created. Snapshot repository virtual disks cannot be selected as a source virtual disk or target virtual disk in a virtual disk copy. The virtual disk for which the point-in-time image is created is the source virtual disk and must be a standard virtual disk in the storage array. You can select snapshot virtual disks as the source virtual disk for a virtual disk copy.
Virtual Disk Expansion A Virtual Disk Expansion (VDE) is a modification operation that increases the capacity of a standard virtual disk or a snapshot repository virtual disk. The increase in capacity is achieved by using the free capacity that is available in the disk group of the standard virtual disk or the snapshot repository virtual disk.
Maintaining A Storage Array 10 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.
Reconstructed media error The physical disk could not read the requested data on its first attempt or on any subsequent retries. The data is reconstructed from the redundant copy, rewritten to the drive, verified, and the error is reported to the MEL. Recovered media error The physical disk could not read the requested data on its first attempt. The result of this action is that the data is rewritten to the physical disk and verified. The error is reported to the MEL.
RAID 1 virtual disks The data is compared between the replicated physical disks, and data inconsistencies are repaired. RAID 0 virtual disks No redundancy exists. NOTE: Do not run consistency checking commands on RAID 0 virtual disks. Before attempting a consistency check, you must enable consistency checking using the set virtualDisk command.
Removing Persistent Reservations Persistent reservations preserve virtual disk registrations and prevent hosts, other than the host defined for the virtual disk, from accessing the virtual disk. You must remove persistent reservations before you perform the following changes to your configuration: • Change or delete logical unit number (LUN) mappings on a virtual disk holding a reservation. • Delete virtual disk groups or virtual disks that have any reservations.
Type of Information Description Virtual Disk A list of the virtual disk names.
values for the segment size. Using a single physical disk for a single request leaves other disks available to simultaneously service other requests. If the virtual disk is in a single-user large I/O environment, performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size.
For a consistency group snapshot virtual disk: set cgSnapVirtualDisk ["cgSnapshotVirtualDisk"] ssdCacheEnabled=TRUE When you turn off SSD caching for a virtual disk, cache contents is purged. You can turn on SSD caching for only one virtual disk per command. Creating SSD Cache To create ssdCache command SSD read cache: create ssdCache userLabel="ssdCacheName" physicalDisks=(enclosureID1,drawerID1,slotID1 ...
The modeling process runs in the background until you run the stop command. The file parameter is optional. If used, it will write modeling results to the file you specify. stop ssdCache [ssdCacheName] performanceModeling file="filename" Output is displayed directly on your screen, unless the file parameter is used. You can also access modeling results using MD Storage Manager.
physical disk-side channel out onto the loop and back again. Enough data is transferred to determine error conditions on the channel. If the test fails on any channel, this status is saved so that it can be returned if all other tests pass. The write test initiates a write command as it would be sent over an I/O data path to the diagnostics region on a specified physical disk. This diagnostics region is then read and compared to a specific data pattern.
If you take a RAID controller module offline, the second RAID controller module in the pair takes over. Disk groups and their associated virtual disks that were assigned to the offline RAID controller module are automatically reassigned to the remaining RAID controller module. CAUTION: Place a RAID controller module in Service mode only under the direction of Technical Support. Use Service mode when you want to perform an operation, such as replacing a RAID controller module.
Reconstructing A Physical Disk If two or more physical disks in a disk group have failed, the virtual disk shows a status of Failed. All of the virtual disks in the disk group are no longer operating. To return the disk group to an Optimal status, you must replace the failed physical disks. After replacing the physical disks, reconstruct the data on physical disks. The reconstructed data is the data as it would appear on the failed physical disks.
Script Commands 11 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. This chapter describes the script commands used to configure, monitor, and maintain a storage array.
• The script commands are not case sensitive. Type the commands in lowercase, uppercase, or mixed case. (In the following command descriptions, mixed case is used as an aid to reading the command names and understanding the purpose of the command.) • You must enter spaces in the commands as they are shown in the command descriptions.
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. On Microsoft Windows, you must put a backslash (\) before and after the name in addition to other delimiters. For example, the following name is used in a command running under a Windows operating system: [\"Engineering"\] For Linu
Show Disk Group Import Dependencies Start Disk Group Blink Start Disk Group Defragment Start Disk Group Export Start Disk Group Import Stop Disk Group Blink Enclosure Commands Download Enclosure Management Module Firmware Save Enclosure Log Data Set Enclosure Attribute Set Enclosure Identification Start Enclosure Blink Stop Enclosure Blink Host Topology Commands Create Host Create Host Group Create Host Port Create iSCSI Initiator Delete Host Delete Host Group Delete Host Port Delete iSCSI Initiator Set H
Set iSCSI Target Properties Show Host Ports iSCSI Commands Create iSCSI Initiator Delete iSCSI Initiator Reset Storage Array iSCSI Baseline Save Storage Array iSCSI Statistics Set iSCSI Initiator Set iSCSI Target Properties Show Current iSCSI Sessions Show Storage Array Negotiation Defaults Start iSCSI DHCP Refresh Stop Storage Array iSCSI Session Physical Disk Commands Clear Physical Disk Port Statistics Download Physical Disk Firmware Replace Physical Disk Revive Physical Disk Save Physical Disk Channel
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 Clear Physical Disk Port Statistics Diagnose RAID Controller Module Enable RAID Controller Module Data Tra
Remote Replication Commands Activate Remote Replication Add Virtual Disk to Remote Replication Group Cancel Remote Replication Group Role Reversal Check Remote Replication Group Consistency Check Remote Replication Status Create Remote Replication Check Storage Array Connectivity Clear Remote Replication Fault Deactivate Remote Replication Deactivate Remote Replication (Legacy) Delete Remote Replication Group Diagnose RAID Controller Module iSCSI Host Cable Establish Remote Replicated Pair Re-Create Remote
Show Remote Replication Virtual Disk Candidates Show Remote Replication Virtual Disk Synchronization Progress Start Remote Replication Synchronization Start Snapshot Rollback Suspend Remote Replication Suspend Remote Replication Group Test Remote Replication Group Connectivity Session Command Set Session Show String Command Show String Snapshot Commands Create Snapshot Group Create Snapshot Image Create Snapshot Virtual Disk Re-Create Snapshot Set Snapshot Virtual Disk Stop Snapshot SSD Cache Commands A
Resume SSD Cache Show SSD Cache Show SSD Cache Statistics Start SSD Cache Performance Modeling Stop SSD Cache Performance Modeling Suspend SSD Cache Storage Array Commands Activate Storage Array Firmware Autoconfigure Storage Array Autoconfigure Storage Array Hot Spares Clear Storage Array Configuration Clear Storage Array Event Log Clear Storage Array Firmware Pending Area Scheduling Snapshots Disable Storage Array Feature Download Storage Array Firmware/NVSRAM Enable RAID Controller Module Data Transfer
Save Storage Array SAS PHY Counts 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 Set Storage Array Time Set Storage Array Unnamed Discovery Session Show Storage Array Show Storage
Virtual Disk Commands Check Virtual Disk Consistency Clear Virtual Disk Reservations Clear Virtual Disk Unreadable Sectors Create RAID Virtual Disk (Automatic Physical Disk Select) Create RAID Virtual Disk (Free Capacity Base Select) Create RAID Virtual Disk (Manual Physical Disk Select) Delete Virtual Disk Remove Virtual Disk LUN Mapping Repair Virtual Disk Consistency Set Virtual Disk Show Virtual Disk Show Virtual Disk Action Progress Show Virtual Disk Performance Statistics Show Virtual Disk Reservation
Commands Listed Alphabetically 12 Following are the script commands listed alphabetically. Activate Remote Replication Feature NOTE: This command is used to activate both Remote Replication and Remote Replication (Legacy). Description This command creates the replication repository virtual disks and activates the Remote Replication and Remote Replication (legacy) premium features.
[drawerLossProtect=(TRUE | FALSE)] [dataAssurance=(none | enabled)] Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 0, 1, 5, or 6. repositoryPhysicalDisks The physical disks for the replication repository virtual disk. For dense expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you assign to the replication repository virtual disk.
Parameter Description disk. To enforce enclosure loss protection, set this parameter to TRUE. The default value is FALSE. drawerLossProtect The setting to enforce drawer loss protection when you create the replication repository virtual disk. To enforce drawer loss protection, set this parameter to TRUE. The default value is FALSE.
set the enclosureLossProtect parameter to FALSE, the storage array performs operations, but the disk group that you create might not have enclosure loss protection. When the RAID controller module firmware assigns the physical disks, if you set the enclosureLossProtect parameter to TRUE, the storage array returns an error if the RAID controller module firmware cannot provide physical disks that result in the new disk group having enclosure loss protection.
Syntax For Use When Creating A New Repository Virtual Disk In A Disk Group set consistencyGroup ["consistencyGroupName"] addCGMemberVirtualDisk="baseVirtualDiskName" repositoryVirtualDisk=("diskGroupName" capacity=capacityValue(KB|MB|GB|TB| bytes)) Syntax For Use When Creating A New Repository Virtual Disk In A Disk Pool set consistencyGroup ["consistencyGroupName"] addCGMemberVirtualDisk="baseVirtualDiskName" repositoryVirtualDisk=("diskPoolName" capacity=capacityValue(KB|MB|GB|TB|bytes)) Parameters Para
operations on each of the base virtual disks. In the context of this command, the term member means a base virtual disk for snapshot operations. You can manipulate snapshot images associated with members of a consistency group through batch-style operations, while maintaining consistency across the snapshot images. Each member virtual disk must have a corresponding repository virtual disk.
Syntax set ssdCache [ssdCacheName] addPhysicalDisks=(enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn) Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache to which you want to add SSDs. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets.
Parameters Parameter Description virtualDisk The name of the primary virtual disk that you want to add to the remote replication group. Enclose the virtual disk name in double quotation marks (" "). asyncRemoteReplicationGroup The name of the remote replication group that will contain the member virtual disk that you want to add. Enclose the remote replication group name in double quotation marks (" "). remotePassword This parameter is optional.
Parameter Description Enclose the name of the new repository virtual disk in parenthesis ( ). Autoconfigure Storage Array Description This command automatically configures a storage array. Before entering the autoConfigure storageArray command, run the show storageArray autoConfiguration command. The show storageArray autoConfiguration command returns configuration information in the form of a list of valid physical disk types, RAID levels, virtual disk information, and hot spare information.
Parameter Description 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. 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.
Parameter Description secure drives to use. The values you can use are fips and sed. NOTE: The controller firmware does not support a mix of SED and FIPS drives within disk groups or disk pools. Example command autoConfigure storageArray securityType=capable securePhysicalDisks=fips; dataAssurance The setting to specify that a disk group, and the virtual disks within the disk group, has data assurance protection to make sure that the data maintains its integrity.
Parameters Table 17. Parameter Description drive The location of the drive that you want to use for a hot spare. For dense expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for the drive. For non-dense expansion enclosures, specify the enclosure ID value and the slot ID value for the drive. Enclosure ID values are 0 to 99. Drawer ID values are 0 to 4 . Slot ID values are 0 to 59.
Blink SSD Cache Description The start locate command identifies the Solid State Disks (SSDs) that are being used in the SSD cache by turning on the indicator lights for the SSDs. The stop locate command turns off the indicator lights on the SSDs.
Change SSD Cache Application Type Description This command changes the application type associated with the SSD cache. The application type can be web server, database, or multimedia. Changing the application type changes the block size, sub block size, populate on read threshold, and populate on write threshold for the virtual disks underlying the SSD cache.
Parameter Description primary virtual disk or the secondary virtual disk of a remote replication pair. Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" "). timeout The time interval within which the software can return the remote replication virtual disk status. The timeout value is in minutes.
Check Repository Consistency Description This command applies to a number of objects that have underlying repository virtual disks. The command produces a report based on analysis of the data in the repository.
Parameter Description \logs \repoConsistency.txt". This parameter must appear last, after any of the optional parameters. Check Storage Array Connectivity Description This command verifies that the local storage array and the remote storage array have a communication path and displays the connection details between the local and remote storage array. Before creating a remote replication group, you should check whether the local storage array and the remote storage array can communicate with each other.
Channel is checked. If the local storage array does not support iSCSI or Fibre Channel, an error message is displayed and the operation aborted. Check Virtual Disk Consistency Description This command checks a virtual disk for consistency and media errors, and writes the results of the check to a file.
NOTE: The starting logical block address and the ending logical block address are useful for very large single-virtual disk LUNs. Running a virtual disk consistency check on a very large single-virtual disk LUN can take a long time. By defining the beginning address and ending address of the data blocks, you can reduce the time that a virtual disk consistency check takes to complete. For a large virtual disk, you can set the priority to high without affecting the I/O.
Parameters Parameter Description all Use this parameter if you want to clear all remote replication faults from all remote replication groups and on all remote replication group member virtual disks. asyncRemoteReplicationGroup The name of the remote replication group from which you want to clear the remote replication fault. Enclose the remote replication group name in square brackets ([ ]).
Clear Storage Array Configuration Description Use this command to: • Clear the entire storage array configuration, and return it back to the initial installation state. • Clear the configuration except for security information and identification information. • Clear disk group configuration information and virtual disk configuration information only. CAUTION: As soon as you run this command, the existing storage array is deleted.
Parameters None Notes When you retrieve a controller health image from the RAID controller module cache to a host, a flag is set on the RAID controller module to indicate that the controller health image does not need to be retrieved. This setting persists for 48 hours. If a new controller health image occurs during that period, the new controller health image is saved to the RAID controller module cache and overwrites any previous controller health image data in the cache.
Parameters None. Clear Storage Array Recovery Mode Description This command forces a storage array to exit recovery mode. Syntax clear storageArray recoveryMode Notes Recovery mode is entered during start-of-day operations when the system configuration is cleared and a valid on-board backup is available. This mode is exited by either restoring the system configuration from a backup location, or by clearing the existing on-board backups.
NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. Clear Virtual Disk Unreadable Sectors Description This command clears the unreadable sector information from one or more virtual disks.
Parameters Parameter Description enable Enable automatic collection of support bundles when a critical MEL event is detected. disable Disable automatic collection of support bundles where the feature was previously enabled. all Apply the command to all storage arrays detected from the host. storageArrayName Apply the command to the named storage array. data Store the data generated by the command at the location specified by the directorypath.
Description This command creates a new, empty consistency group that can contain snapshot groups. You must add the snapshot groups using the set consistencyGroup addCGMember command.
Parameter Description • • • • • startTime scheduleInterval endDate timesPerDay timeZone See the Notes section for information explaining how to use these options. rollBackPriority Determines whether system resources should be allocated to the rollback operation at the expense of system performance. A value of high indicates that the rollback operation is prioritized over all other host I/O. A value of low indicates that the rollback operation should be performed with minimal impact to host I/O.
Create Consistency Group Snapshot Image Description This command creates a new snapshot image for each base virtual disk that is a member of a snapshot consistency group. Syntax create cgSnapImage consistencyGroup="consistencyGroupName" Parameter Parameter Description consistencyGroup The name of the consistency group for which you are creating snapshot images. Enclose the consistency group name in double quotation marks (" ").
members=(baseVirtualDisk:repositoryVirtualDisk...
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. If you do not specify the repositoryVolType or readOnly parameters, the MD storage management software selects the repositories for the consistency group snapshot virtual disk. If the disk group or disk pool where the base virtual disk resides does not have enough space, this command fails.
Syntax create mapping cgSnapVirtualDisk="snapVirtualDiskName" (host="hostName" | hostGroup=("hostGroupName" | defaultGroup)) Parameters Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk for which you want to create a logical mapping. Enclose the consistency group snapshot virtual disk name in double quotation marks (" "). host The name of a host to which you want to create a logical mapping. Enclose the host name in double quotation marks (" ").
enclosureLossProtect=(TRUE | FALSE) drawerLossProtect=(TRUE | FALSE) securityType=(none | capable | enabled)] [dataAssurance=(none | enabled)] Parameters Parameter Description physicalDisks The physical disks that you want to assign to the disk group that you want to create. Specify the enclosure ID value and the slot ID value for each physical disk that you assign to the disk group. Enclosure ID values are 0 to 99. Drawer ID values are 0 to 4. Slot ID values are 0 to 31.
Parameter Description owner, the RAID controller module firmware determines the owner. cacheReadPrefetch The setting to turn on or turn off cache read prefetch. To turn off cache read prefetch, set this parameter to FALSE. To turn on cache read prefetch, set this parameter to TRUE. segmentSize The amount of data (in KB) 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.
The cacheReadPrefetch command lets the RAID controller module copy additional data blocks into cache while the RAID controller module reads and copies data blocks that are requested by the host from the physical disks into cache. This action increases the chance that a future request for data can be fulfilled from cache. CacheReadPrefetch is important for multimedia applications that use sequential data transfers.
• start secureErase (physicalDisk | physicalDisks) • enable diskGroup [diskGroupName] security Secure-capable drives can be either SED drives or Federal Information Processing Standard (FIPS) drives. Use the securePhysicalDisks parameter to specify the type of secure physical disks to use. The values you can use are fips and sed. Enclosure Loss Protection and Drawer Loss Protection For enclosure loss protection to work, each physical disk in a disk group must be in a separate enclosure.
[criticalThreshold=(criticalThresholdValue|default)] [criticalPriority=(highest|high|medium|low|lowest)] [backgroundPriority=(highest|high|medium|low|lowest)] [degradedPriority=(highest|high|medium|low|lowest)] [securityType=(none|capable|enabled)] [physicalDiskMediaType=(hdd | ssd | allMedia | unknown)] [securePhysicalDisks=(fips | sed )] [dataAssurance=(none|enabled)] Parameter Description physicalDisks The physical disks that you want to assign to the disk pool that you want to create.
Parameter Description If you set this to default, the warning alert threshold value is determined by the RAID controller module firmware. criticalThreshold The percentage of storage capacity at which you receive a critical alert that the disk pool is nearing full. Use integer values. For example, a value of 70 means 70 percent. For best operation, the value for this parameter must be greater than the value for the warningThreshold parameter. Valid values are from 0 to 100.
Parameter Description • enabled—The virtual disk candidates have security enabled. The default value is none. securephysicalDisks The type of secure drives to use in the virtual disk group. These settings are valid: • • fips — To use FIPS compliant drives only. sed — To use SED compliant drives only. NOTE: At this time, the controller firmware does not support mixed FIPS and SED drives within disk groups or disk pools. CAUTION: Use this parameter along with the securityType parameter.
Parameter Description NOTE: This option is only valid for enablement if the drives, the controller, and the host bus adapter are all DA-capable. Security Type The securityType parameter is valid for physical disks that are capable of self-encrypting disk (SED). With SED, the RAID controller module firmware can create a key and activate the physical disk security feature.
Parameters Parameter Description userLabel The name that you want to give the host that you are creating. Enclose the host name in double quotation marks (“ ”). hostGroup The name of the host group in which you want to create a new host. Enclose the host group name in double quotation marks (“ ”). (If a host group does not exist, you can create a new host group by using the create hostGroup command.) The defaultGroup option is the host group that contains the host to which the virtual disk is mapped.
Syntax create hostPort identifier="wwid" userLabel="portLabel" 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. You must put quotation marks (" ") around the host name.
Parameters Parameter Description iscsiName The default identifier of the iSCSI initiator. userLabel The name that you want to use for the iSCSI initiator. Enclose the name in double quotation marks (" "). host The name of the host in which the iSCSI initiator is installed. chapSecret The password that you want to use to authenticate a peer connection. NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection.
Parameter Description NOTE: The physicalDiskCount parameter enables you to choose the number of physical disks to use in the disk group. You do not need to specify the physical disks by enclosure ID and slot ID. The RAID controller modules choose the specific physical disks to use for the disk group. diskGroupUserLabel The alphanumeric identifier (including – and _) that you want to give the new disk group. Enclose the disk group identifier in double quotes (" ").
Parameter Description information about the enclosureLossProtect parameter, see Enclosure Loss Protection. drawerLossProtect The setting to enforce drawer loss protection when you create the replication repository disk group. To enforce drawer loss protection, set this parameter to TRUE. The default value is FALSE. dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases. The default value is TRUE.
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)] [dataAssurance=(none | enabled)] Parameters Parameter Description diskGroup Sequence number of the disk group in which to create the new virtual disk
Parameter Description NOTE: Add a space 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. If you do not specify the capacity unit, bytes is used as the default unit. owner RAID controller module that owns the virtual disk. Valid RAID controller module identifier values are 0 and 1.
Parameter Description • • • none—The disk group and virtual disks are not secure. capable—The disk group and virtual disks are capable of having security set, but security has not been enabled. enabled—The disk group and virtual disks have security enabled. For information about securityType, see Security Type. dataAssurance The setting to specify that a disk pool has data assurance protection to make sure that the data maintains its integrity.
[dssPreAllocate=(TRUE | FALSE)] [securityType=(none | capable | enabled)] [securePhysicalDisks=(fips | sed)] [dataAssurance=(none | enabled)] Parameters Parameter Description physicalDisks Specifies the physical disks to assign to the created virtual disk. Specify the enclosure ID and slot ID for each unassigned physical disk to assign to the virtual disk. Enclosure ID values are 0 to 99. Drawer ID values are 0 to 4. Slot ID values are 0 to 31.
Parameter Description capacity Size of the virtual disk that you are adding to the storage array. Size is defined in units of bytes, KB, MB, GB, or TB. NOTE: If you do not specify a capacity, all physical disk capacity available in the disk group is used. If you do not specify capacity units, bytes are used as the default. A space must be added between the last digit and the size (MB, GB, or KB) for values greater than 9. owner RAID controller module that owns the virtual disk.
Parameter Description securityType The setting to specify the security level when creating the disk groups and all associated virtual disks. • • • none—The disk group and virtual disks are not secure. capable—The disk group and virtual disks are capable of having security set, but security has not been enabled. enabled—The disk group and virtual disks have security enabled. For information about securityType, see Security Type. The type of secure drives to use in the disk group.
Parameter Description enclosureLossProtect The setting to enforce enclosure loss protection when you create the repository. To enforce enclosure loss protection, set this parameter to TRUE. The default value is FALSE. Create RAID Virtual Disk On A Disk Pool Description This command creates a new RAID virtual disk on an existing disk pool.
Parameter Description The default option is none. warningThreshold Valid values are from 1 to 100. The default value is determined by the RAID controller module firmware. Setting this parameter to 100 disables warning alerts. repositoryExpansionPolicy Valid values are automatic and manual. cacheReadPrefetch The setting to turn on or turn off cache read prefetch. To turn off cache read prefetch, set this parameter to FALSE. To turn on cache read prefetch, set this parameter to TRUE.
Parameter Description type of secure physical disks to use. The values you can use are fips and sed. NOTE: The controller firmware does not support a mix of SED and FIPS drives within disk groups or disk pools.
Parameters Parameter Description userLabel The name that you want to give to a snapshot virtual disk. Enclose the snapshot virtual disk name in double quotation marks (" "). snapImageID The alphanumeric identifier of a snapshot image that you want to add to the new snapshot virtual disk. The identifier of a snapshot image is comprised of two parts: • • The name of the snapshot group. An identifier for the snapshot image in the snapshot group.
Create Remote Replication NOTE: This command is valid only with Fibre Channel storage arrays. Description This command creates both the primary virtual disk and the secondary virtual disk for a remote replication pair. This command also sets the write mode (Synchronous or Asynchronous) and the synchronization priority.
Parameter Description autoResync The settings for automatic resynchronization between the primary virtual disks and the secondary virtual disks of a remote replication pair. This parameter has these values: • • enabled—Automatic resynchronization is turned on. You do not need to do anything further to resynchronize the primary virtual disk and the secondary virtual disk. disabled—Automatic resynchronization is turned off.
Create Remote Replication Group Description This command creates a new, empty remote replication group on both the local storage array and the remote storage array. A remote replication group is a container that can house several replicated pairs so that they can be managed as one entity. You create a remote replication group to define the synchronization settings for all replicated pairs within the group.
Parameter Description The remote storage array must have the same connection type as the local storage array. remoteStorageArrayNameWwn The World Wide Identifier (WWID) of the remote storage array on which you are replicating the remote replication group. You can use the WWID instead of the storage array name to identify the storage array. Enclose the WWID in angle brackets (< >). The remote storage array must have the same connection type as the local storage array.
Parameter Description percentage. Define the threshold by percentage (%) of the capacity remaining. autoResync The settings for automatic resynchronization between the primary virtual disks and the secondary virtual disks of a remote replicated pair within a remote replication group. This parameter has these values: • • enabled—Automatic resynchronization is turned on. You do not need to do anything further to resynchronize the primary virtual disk and the secondary virtual disk.
[capacity=capacityValue]))] [repositoryFullPolicy=(failBaseWrites | purgeSnapImages)] [rollbackPriority=(highest | high | medium | low | lowest)] [repositoryFullLimit=percentValue] [autoDeleteLimit=numberOfSnapImages]| [enableSchedule=(TRUE | FALSE)] [schedule (immediate | snapshotSchedule)] Parameters Parameter Description userLabel The alphanumeric identifier (including - and _) that you want to give the new snapshot group. Enclose the snapshot group identifier in double quotation marks (" ").
Parameter Description selected to purge the snapshot images for the repository full policy. The default value is 32. Notes Each snapshot group user label must be unique. You can use any combination of alphanumeric characters, underscore (_), hyphen(-), and pound (#) for the user label. User labels can have a maximum of 30 characters. To create a snapshot group, you must have an associated repository virtual disk in which you store the snapshot images.
Failed The snapshot group has encountered a problem that has made all snapshot images in the snapshot group unusable. For example, certain types of repository virtual disk failures can cause a Failed state. To recover from a Failed state use the revive snapGroup command. Create Snapshot Image Description This command creates a new snapshot image in one or more existing snapshot groups.
Create Snapshot (Legacy) Virtual Disk Description This command creates a snapshot virtual disk. When you use this command, you can define the snapshot virtual disk in one of three ways: • User-defined physical disks • User-defined disk group • User-defined number of physical disks for the snapshot virtual disk If you choose to define a number of physical disks, the RAID controller module firmware chooses which physical disks to use for the snapshot (legacy) virtual disk.
[enableSchedule=(TRUE | FALSE)] [schedule=(immediate | snapshotSchedule)] Parameters Parameter Description baseVirtualDisk The name of the base virtual disk from which you want to take a snapshot (legacy). Enclose the base virtual disk name in double quotation marks (" "). repositoryRAIDLevel Use this parameter when you create a new disk group. The RAID level for the snapshot (legacy) repository disk group. Valid values are 0,1, 5, or 6.
Parameter Description enclosureLossProtect The setting to enforce enclosure loss protection when you create the snapshot (legacy) repository virtual disk. To enforce enclosure loss protection, set this parameter to TRUE. The default setting is FALSE. physicalMediaType 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.
Parameter Description repository is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 50. repositoryPercentOfSource The size of the snapshot (legacy) repository virtual disk as a percentage of the source virtual disk. Use integer values. For example, a value of 40 means 40 percent. The default value is 20. repositoryUserLabel The name to give to the snapshot (legacy) repository virtual disk.
You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. One technique for naming the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk is to add a hyphenated suffix to the original base virtual disk name. The suffix distinguishes between the snapshot (legacy) virtual disk and the snapshot (legacy) repository virtual disk.
startDate A specific date on which you want to create a snapshot (legacy) virtual disk and perform a copy-on-write operation. The format for entering the date is MM:DD:YY. If you do not provide a start date, the current date is used. An example of this option is startDate=06:27:11. scheduleDay A day of the week on which you want to create a snapshot (legacy) virtual disk and perform a copy-on-write operation.
To remove a schedule, use the delete virtualDisk command with the schedule parameter. The delete virtualDisk command with the schedule parameter deletes only the schedule, not the snapshot (legacy) virtual disk. Create Snapshot Virtual Disk Description This command creates a snapshot virtual disk for snapshot images of a base virtual disk.
Parameter Description where xxxx represents a four digit numerical value. Enclose the snapshot virtual disk name in double quotation marks (" "). repositoryFullLimit The percentage of repository capacity at which you receive a warning that the snapshot repository virtual disk is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 75. Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names.
Parameters Parameter Description userLabel The alphanumeric identifier (including - and _) that you want to name the new SSD cache. Enclose the identifier in double quotation marks (" "). You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the identifier. Identifiers can have a maximum of 30 characters. physicalDisks The physical disks that you want to use to create the SSD cache.
Only virtual disks created using hard disk physical disks can use the SSD cache. You cannot enable SSD cache on snapshot (legacy) virtual disks or snapshot images. If all of the SSDs in the SSD cache are data assurance (DA)-capable and the DA premium feature is enabled, DA is automatically enabled for the SSD cache and cannot be disabled. In addition, you cannot add non-DA capable SSDs to a DA-enabled SSD cache.
Additional Information To use this command successfully, you need to have enough SES drives to create atleast one disk group. The RAID controller module firmware creates a lock that restricts access to the SES drives. SES drives have a state called Security Capable. When you create a security key, the state is set to Security Enabled, which restricts access to all SES drives that exist within the storage array. You can have a storage array configuration with more than one set of encrypted disk groups.
NOTE: You can have a maximum of eight virtual disk copies in progress at one time. If you try to create more than eight virtual disk copies at one time, the RAID controller modules return a status of Pending until one of the virtual disk copies that is in progress finishes and returns a status of Complete.
Parameter Description copyPriority Specifies the priority that a virtual disk copy has relative to host I/O activity. Valid entries are highest, high, medium, low, or lowest. NOTE: CopyPriority defines the amount of system resources used to copy the data between the source virtual disk and target virtual disk of a virtual disk-copy pair.
Delete Consistency Group Description This command deletes a snapshot consistency group in two ways: • You can delete both the consistency group and the repository virtual disks contained by the consistency group. • You can delete only the consistency group and leave the repository virtual disks that are contained by the consistency group intact.
Parameter Parameter Description consistencyGroup The name of the consistency group from which you want to delete the snapshot images. Enclose the consistency group name in double quotation marks (" "). deleteCount The number of snapshot images that you want to delete from the consistency group. Use integer values. This parameter deletes the oldest snapshot image first and continues to delete the oldest snapshot images until reaching the number that you enter.
Syntax delete cgSnapVirtualDisk ["snapVirtualDiskName"] [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk that you want to delete. Enclose the name of the consistency group snapshot virtual disk in double quotation marks (" ") inside square brackets ([ ]). deleteRepositoryMembers The parameter to save or delete the member virtual disks. To save the member virtual disks, set this parameter to TRUE.
Parameter Parameter Description diskPoolName The alphanumeric identifier of the disk pool (including – and _) that you want to delete. Enclose the disk pool name in square brackets ([ ]). If the disk pool name has special characters, you also must enclose the host group name in double quotation marks (" "). Notes If the disk pool contains virtual disks, the virtual disks are deleted along with the disk pool. Delete Host Description This command deletes a host.
Parameter Parameter Description hostGroup Name of the host group to delete. You must put brackets ([ ]) around the host group name. If the name of the host group has special characters, you must also put quotation marks (" ") around the host group name. NOTE: A host group is an optional topological element that is a collection of hosts that share access to the same virtual disks. The host group is a logical entity. Delete Host Port Description This command deletes an HBA host port identification.
Delete iSCSI Initiator Description This command deletes a specific iSCSI initiator object. Syntax delete iscsiInitiator (["iSCSI-ID "| "name"]) Parameters Parameters Description iSCSI-ID The identifier of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). name The name of the iSCSI initiator that you want to delete. Enclose the name in double quotation marks (" "). Example -c "delete iscsiInitiator [\"job29002\"];" Delete Snapshot Group CAUTION: Possible
Parameter Description virtual disks, set this parameter to TRUE. The default value is FALSE. Notes You can delete a snapshot group if it is empty or if it contains snapshot images. All of the snapshot images in the snapshot group are deleted along with the snapshot group. If any existing snapshot image within the snapshot group has an associated view, each view is stopped and detached from the snapshot image. When you delete a snapshot group the associated repository virtual disk is also deleted.
Parameter Description snapshot images until reaching the number that you enter. If the number that you enter is greater than the actual number of all of the snapshot images in the snapshot group, all of the snapshot images will be deleted. The snapshot group is left empty. retainCount The number of snapshot images that you want to keep in the snapshot group. Use integer values. This parameter keeps the most recent snapshot images in the snapshot group and deletes older snapshot images.
Delete Snapshot (Legacy) Virtual Disk Description This command deletes one or more snapshot (legacy) virtual disks or snapshot (legacy) repository virtual disks. You can also use this command to remove schedules for creating snapshots (legacy). CAUTION: Possible damage to the storage array configuration – All of the data in the virtual disk is lost as soon as you run this command. Syntax delete (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...
Parameters Parameter Description snapVirtualDisk The name of the snapshot virtual disk that you want to delete. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]). deleteRepositoryMembers The parameter to save or delete the repository members. To save the repository members, set this parameter to FALSE. To delete the repository members, set this parameter to TRUE. The default value is TRUE.
Delete SSD Cache Description This command deletes the SSD cache. All data in the SSD cache is purged. Syntax delete ssdCache [ssdCacheName] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to delete. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets.
Parameter Description virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. removeDiskGroup Deleting the last virtual disk in a disk group does not delete the disk group. You can have a standalone disk group (minus any virtual disks). To remove the standalone disk group, set this parameter to TRUE. To keep standalone disk groups intact, set this parameter to FALSE. schedule Deletes only the schedule.
Parameter Description force Use this parameter to force the immediate deletion of a virtual disk even if the RAID controller modules are performing other operations. To immediately force the deletion of a virtual disk, set this parameter to TRUE. To wait until the RAID controller modules have finished performing other operations, do not use this parameter or set this parameter to FALSE.
Parameters Parameter Description controller RAID controller module on which to run the diagnostic tests. 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. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify a RAID controller module, the MD storage management software returns a syntax error.
This command runs diagnostic tests on the copper cables between the iSCSI Host interface cards and a RAID controller module. You can run diagnostics on a selected port or all ports. The ports must be able to support the cable diagnostics.
– When the cable status is OK, the approximate lengths of the cable pairs are returned. The lengths of the cable pairs are shown as a range (L1-L2), which are the shortest and the longest lengths of the cable pairs. – If the cable status is Open or Short, the approximate distance to the failure in the cable pairs. If there is one failure, the length is reported for that cable pair. If there is more than one failure, the information returned is both the shortest and longest lengths to the failures.
Syntax disable storageArray (featurePack | feature=featureAttributeList) The featureAttributeList can be one or more of these attribute values. If you enter more than one attribute value, separate the values with a space.
Additional Information If you specify the remoteReplication parameter, this command disables the Remote Replication premium feature and takes away the structure of the replication repository virtual disk. If you disable the High Performance Tier feature, all of the included features are disabled.
Download Enclosure Management Module Firmware Description This command downloads firmware for the enclosure management module. Syntax download (allEnclosures | enclosure [enclosureID]) firmware file="filename" Parameters Parameter Description enclosure Identifies the enclosure to which to load new firmware. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value.
You can use this command to test the firmware on one physical disk before installing the firmware on all of the physical disks in a storage array. (Use the Download Storage Array Physical Disk Firmware command to 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.
Parameters Parameter Description NVSRAM Specifies that you want to download a file with NVSRAM values when you download a firmware file. You must not put brackets around this parameter. Include a comma after the term firmware. file File path and name of the file that contains the firmware. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the file name. NVSRAM-filename File path and name of the file that contains the NVSRAM values.
Additional Information When you run this command, you can download more than one firmware image file to the physical disks in a storage array. The number of firmware image files that you can download depends on the storage array. The MD storage management software returns an error if you try to download more firmware image files than the storage array can accept. You can schedule downloads for multiple physical disks at the same time, including multiple physical disks in a redundant disk group.
Parameter Description fails, you can bypass the failure by using this parameter when running the command. Before any download, the RAID controller module checks the event log to determine if an event has occurred that might prevent the new NVSRAM from successfully downloading. If such an event has occurred, the RAID controller module normally does not download new NVSRAM. This parameter forces the RAID controller module to download new NVSRAM. The default value is FALSE.
Enable Disk Pool Security Description This command converts a non-secure disk pool to a secure disk pool. Syntax enable diskPool [diskPoolName] security Parameter 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.
NOTE: ODX provides a way to transfer data without using buffered read and buffered write operations and does not require direct host involvement with the data transfer operation. When ODX is not enabled, data is read from the source storage to the host, and then written to the target storage from the host. With ODX enabled, the data transfer operations are directly managed by the storage infrastructure. The data is moved directly from the source storage to the target storage without going through the host.
run VAAI, or if VAAI is causing issues with the storage array. The only storage array that is affected is the storage array on which the command is run. Syntax set storageArray vaaiEnabled=(TRUE | FALSE) Parameter Parameter Description vaaiEnabled The setting to turn on or turn off VAAI. To turn on VAAI set this parameter to TRUE. To turn off VAAI set this parameter to FALSE. The default setting is that VAAI is turned on.
Syntax enable storageArray (featurePack | feature) file=”filename” Parameter Parameter Description file File path and file name of a valid feature key file. Valid file names for feature key files must end with a .key extension. You must put quotation marks (" ") around the file path and file name. Additional Information A feature pack is a predefined set of premium features, such as Storage Partitioning and Remote Replication. These premium features are combined for the convenience of the users.
Parameter Description secondary virtual disk. Enclose the virtual disk name in double quotation marks (" "). asyncRemoteReplicationGroup The name of an existing remote replication group that you want to use to contain the remote replicated pair. Enclose the remote replication group name in double quotation marks (" "). primaryVirtualDisk The name of an existing virtual disk on the local storage array that you want to use for the primary virtual disk.
Parameter Parameter Description addPhysicalDisks The setting to add new physical disks to the virtual disk. For dense expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for the physical disk. For non-dense expansion enclosures, specify the enclosure ID value and the slot ID value for the physical disk. Enclosure ID values are 0 to 99. Drawer ID values are 0 to 4. Slot ID values are 0 to 31.
Parameter Description 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. validator The alphanumeric security code required to restore a storage array to an existing configuration. Use the save storageArray dbmValidator command to generate the required validation information XML file.
Modify Disk Pool Description This command adds capacity to a disk pool or changes the RAID controller module ownership for the entire disk pool. These two operations are mutually exclusive. Syntax set diskPool [diskPoolName] (addPhysicalDisks=[enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn] | addCapacity=(diskPoolCapacity)) [owner=(0 | 1)] Parameters Parameter Description addDrives Identifies multiple physical disks to add to the disk pool.
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 Parameter Description target Name of the target virtual disk for which to reinitiate a virtual disk copy operation.
Parameter Description reinitiate a virtual disk copy without a snapshot, set this parameter to offline. Recover disabled drive ports Description This command is used to tell the controller that corrective action has been taken to recover from a miswire condition. The controller will re-enable any SAS ports that were disabled when a mis-wire was detected.
Parameters Parameter Description physicalDisk or physicalDisks The physical disks that you want to assign to the disk group that will contain the virtual disk that you want to recover. For dense expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you assign to the virtual disk. For non-dense expansion enclosures, specify the enclosure ID value and the slot ID value for each physical disk that you assign to the virtual disk.
segmentSize The amount of data (in KB) that the RAID controller module writes on a single physical disk in a disk group before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. dssPreallocate The setting to turn on or turn off allocating virtual disk storage capacity for future segment size changes. To turn on allocation, set this parameter to TRUE. To turn off allocation, set this parameter to FALSE. SSID The storage array subsystem identifier of a virtual disk.
NOTE: The MD storage management software collects recovery profiles of the monitored storage arrays and saves the profiles on a storage management station. The physicalDisk parameter supports both dense expansion enclosures and non-dense expansion enclosures. A dense expansion enclosure has drawers that hold the physical disks. The drawers slide out of the expansion enclosure to provide access to the physical disks. A non-dense expansion enclosure does not have drawers.
If the virtual disk is in an environment where a single user is transferring large units of data (such as multimedia), performance is maximized when a single data transfer request is serviced with a single data stripe. (A data stripe is the segment size that is multiplied by the number of physical disks in the disk group that are used for data transfers.) In this case, multiple physical disks are used for the same request, but each physical disk is accessed only once.
enclosureIDN,drawerIDN,slotIDN) [enclosureLossProtect=(TRUE | FALSE)] [dataAssurance=(none | enabled)] User-Defined Disk Group recreate storageArray replicationRepository repositoryDiskGroup=diskGroupName [freeCapacityArea=freeCapacityIndexNumber] User-Defined Number of Drives recreate storageArray replicationRepository repositoryRAIDLevel=(1 | 5 | 6) repositoryPhysicalDiskCount=numberOfPhysicalDisks [physicalDiskType=(SAS)] [enclosureLossProtect=(TRUE | FALSE)] [dataAssurance=(none | enabled)] Parameters
Parameter Description disk. To enforce enclosure loss protection, set this parameter to TRUE. The default value is FALSE. physicalDiskType The type of physical disk that you want to use for the replication repository virtual disk. You cannot mix physical disk types. You must use this parameter when you have more than one type of physical disk in your storage array. Valid physical disk types are : • dataAssurance SAS If you do not specify a physical disk type, the command defaults to SAS.
storage array performs the operation even if it means that the replication repository virtual disk might not have enclosure loss protection. Re-Create Snapshot Description This command starts a new copy-on-write operation by using an existing snapshot virtual disk. You can re-create a single snapshot virtual disk or recreate multiple virtual disks.
Parameter Description the source virtual disk (failSourceWrites) or fail writes to the snapshot virtual disk (failSnapShot). The default value is failSnapShot. NOTE: If repositoryFullPolicy is not specified, the previously set value is used. Additional Information NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters.
NOTE: Dell is discontinuing support of the VSS and VDS hardware providers. See the Dell MD Series Storage Arrays Information Update for details on the deprecation. For supported software, refer to the Supported Management Software section of the Dell™ PowerVault™ MD Series Support Matrix at Dell.com/powervaultmanuals. Reduce Disk Pool Capacity Description This command reduces the capacity of the disk pool by logically removing the physical disks from the pool.
physical disks and the data that existed on them is redistributed across the remaining physical disks in the disk pool. The capacity of the disk pool is decreased by the capacity of the physical disks that you remove. Removing physical disks from a disk pool is always carried out as a background task and the virtual disks remain fully accessible during this operation. The progress of the removal operation is reported as part of the long running operations status.
Syntax create snmpTrapDestination trapReceiverIP=ipAddress communityName="communityName" [sendAuthenticationFailureTraps=(TRUE | FALSE)] Parameters Parameter Description trapReceiverIP The IP address of the SNMP manager to which you want to send trap messages. communityName The name of the SNMP community for which you want to send trap messages. sendAuthenticationFailureTraps This parameter turns on or turns off sending authentication failure messages to an SNMP manager.
Parameter Description • • must be an unused repository virtual disk with the name in the proper form. If the newly specified repository virtual disk is on a different disk pool, the thin virtual disk will change ownership to that pool. The old repository virtual disk will be deleted by default. diskPoolUserLabel Use this parameter to allocate a new repository virtual disk with the specified capacity. retainRepositoryMember If this parameter is set to TRUE, the old repository is retained.
Parameter Description name in double quotation marks (" ") inside square brackets. incompleteAsyncRemoteReplication The name of the orphaned virtual disk that you want to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" "). Remove Member Virtual Disk From Consistency Group Description This command removes a member virtual disk from a an existing snapshot consistency group.
Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache from which you want to remove SSDs. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets. removePhysicalDisks The physical disks that you want to remove from the SSD cache.
Parameter Description name. Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" "). Remove Virtual Disk Copy Description This command removes a virtual disk copy pair. Syntax remove virtualDiskCopy target [targetName] [source [sourceName]] copyType=(online | offline) Parameters Parameter Description target Name of the target virtual disk to remove.
Syntax remove virtualDisk ["virtualDiskName"] asyncRemoteReplicationGroup="asyncRemoteReplicationGroupName" [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter Description virtualDisk The name of the specific virtual disk that you want to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" ") inside square brackets ([ ]).
Parameter Description 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 MD storage management software is no longer able to manage the storage array through the in-band agent. host Name of the host to which the virtual disk is mapped. You must put quotation marks (" ") around the host name.
Syntax set ssdCache [old_ssdCacheName] userLabel="new_ssdCacheName" Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to rename. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets. userLabel The new name for the SSD cache.
Parameter Description verbose Captures progress details, such as percent complete, and shows the progress detail information as virtual disk consistency is being repaired. To capture progress details, set this parameter to TRUE. To prevent capturing progress details, set this parameter to FALSE.
Parameter Description failPhysicalDisk This parameter causes the physical disk that you are replacing to be failed after the data has been copied to the replacement physical disk. This parameter can be used only when the copyPhysicalDisk parameter is used. Reset iSCSI IP Address Description This command resets the IP address for the remote storage array to re-establish connection with the local storage array.
Reset Physical Disk This command power cycles a physical disk in a disk group or a disk pool to aid in the recovery of a physical disk that is exhibiting inconsistent or non-optimal behavior. By power cycling a physical disk, some errors that cause inconsistent or non-optimal behavior can be cleared. This avoids replacing a physical disk when it is experiencing only a transient, non-fatal error, and the physical disk can remain operational.
NOTE: The physicalDisk parameter supports both dense expansion enclosures and non-dense expansion enclosures. A dense expansion enclosure has drawers that hold the physical disks. The drawers slide out of the expansion enclosure to provide access to the physical disks. A non-dense expansion enclosure does not have drawers. For a dense expansion enclosure, you must specify the identifier (ID) of the expansion enclosure, the ID of the drawer, and the ID of the slot in which a physical disk resides.
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.
Parameter Description sampleType This parameter is optional. The default value for sampleType is all. • • • • all—Data for all three sample types are reset. mostRecent—Statistics are reset for the most recent 50 resynchronization samples. longestSyncTime—Statistics are reset for the most recent 20 longest resynchronization samples. errors—Statistics are reset for the most recent 20 failed resynchronization samples. Notes Statistics are reset for replicated virtual disks in the Primary role.
Parameter Description enclosure. Use the controller parameter only for RAID controller modules with batteries. NOTE: If you do not specify a RAID controller module, the age is reset for the storage array battery or both RAID controller module batteries. If you specify a RAID controller module, then the age for only that RAID controller module battery is reset. Reset Storage Array iSCSI Baseline Description This command resets the iSCSI baseline for the storage array to 0.
Parameters None. Reset Storage Array Virtual Disk Distribution Description This command reassigns (moves) all virtual disks to their preferred RAID controller module. Syntax reset storageArray virtualDiskDistribution Parameters None. CAUTION: Ensure that the multipath driver is running before you use this command, or the virtual disk is not accessible. NOTE: Under certain host operating system environments, you might be required to reconfigure the multipath host physical disk.
Parameter Description • An identifier for the snapshot image in the consistency group. The identifier for the snapshot image can be one of these: • An integer value that is the sequence number of the snapshot in the consistency group. • NEWEST - Use this option when you want to show the latest snapshot image created in the consistency group. • OLDEST - Use this option when you want to show the earliest snapshot image created in the consistency group.
Parameter Description characters, the primary virtual disk 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. For the virtual disks to be separate, set this parameter to FALSE.
Resume Snapshot Image Rollback Description This command resumes a rollback operation that has entered a paused state. A rollback operation can enter a paused state due to processing errors, which causes a Needs Attention condition for the storage array. If the rollback operation cannot be resumed, the selected snapshot virtual disk reverts to a paused state, and the Needs Attention condition is displayed. NOTE: You cannot use this command for snapshot images involved in online virtual disk copy.
For example, if you want to restart a rollback operation for snapshot image 12345 in a snapshot group that has the name snapgroup1, you would use this command: resume snapImage ["snapgroup1:12345"] rollback; Resume Snapshot (Legacy) Rollback Description NOTE: With firmware version 7.83, the order of the terms in the syntax is changed to be consistent with other commands. Replace the deprecated command syntax with the new command syntax.
Parameters Parameter Description snapVirtualDisk The name of the specific snapshot virtual disk for which you want to resume a rollback operation. Enclose the snapshot virtual disk identifier in square brackets ([ ]). If the snapshot virtual disk identifier has special characters, you must also enclose the snapshot virtual disk identifier in double quotation marks (" "). snapImage The name of the snapshot image for which you want to resume snapshot virtual disk operations.
Resume SSD Cache Description This command restarts the caching for all virtual disks using the SSD cache that was temporarily stopped with the suspend ssdCache command. Syntax resume ssdCache [ssdCacheName] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to resume. Enclose the identifier in square brackets ([ ]).
Revive Disk Pool Description 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. Do not try to revive a disk pool unless you are supervised by your Technical Support representative. Syntax revive diskPool [diskPoolName] Parameter Parameter Description diskPool The alphanumeric identifier (including - and _) of the disk pool that you want to revive.
Revive Snapshot Group Description This command forces the specified snapshot group to the Optimal state. If the snapshot group is not in a Failed state, the firmware displays an error message and does not run this command. Syntax revive snapGroup [snapGroupName] Parameter Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group that you want to set to the Optimal state. Enclose the snapshot group identifier in square brackets ([ ]).
Save Enclosure Log Data Description This command saves the enclosure log sense data to a file. Log sense data is maintained by the environmental cards for each enclosure. Not all of the environmental cards contain log sense data. Syntax save allEnclosures logFile="filename" Parameter Parameter Description logFile Name of the file to which to save the log sense data. You must put quotation marks (" ") around the file name.
NOTE: This command retrieves from both RAID controller modules the IOC dump log data and the IOC dump metadata. Using a 7zip file format, the retrieved data is archived and compressed into a single file with a file name of your choice. The 7zip archive file contains the following: filename+”IOCLog”+[A|B].gz – the IOC logs retrieved from RAID controller module 0 or RAID controller module 1 if available filename+”IOCLogInfo”+[A|B].
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. You must put brackets ([ ]) around the RAID controller module identifier. file Name of the file in which to save the values. You must put quotation marks (" ") around the file name.
Parameter Description group name has special characters, you also must enclose the remote replication group name in double quotation marks (" ") inside square brackets. If the remote replication group name consists only of numbers, such as "1002," you also must enclose the remote replication group name in double quotation marks (" ") inside square brackets. file The file path and the file name to which you want to save the synchronization statistics. Enclose the file name in double quotation marks (" ").
Notes Statistics are captured for replicated virtual disks in the Primary role.
Parameter Description prevent saving the global settings, set this parameter to FALSE. The default value is TRUE. virtualDiskConfigAndSettings Saves the virtual disk configuration settings and all of the global settings to the file. To save the virtual disk configuration and global settings, set this parameter to TRUE. To prevent saving the virtual disk configuration and global settings, set this parameter to FALSE. The default value is TRUE. hostTopology Saves the host topology to the file.
Syntax save storageArray dbmDatabase file="fileName" [sourceLocation=(disk | onboard) | controller [(0|1)] | contentType= all)] Parameters Parameter Description sourceLocation This parameter specifies the location from which to obtain backup database information. • • disk indicates that data comes directly from the database on the physical disk cache indicates that data comes from the RPA memory location The default location is disk.
Save Storage Array DBM Validator Information File Description This command saves the database management (DBM) validation information for a storage array in an XML file. Support personnel can use this XML file to generate a validator string (a security code). The validator string must be included in the load storageArray dbmDatabase command when restoring a storage array back to a pre-existing configuration.
nnnnnnnnnn Save Storage Array Events Description This command saves events from the Major Event Log (MEL) to a file. Any or all of the following events can be saved: • Critical events—Errors occurring on the storage array that needs to be addressed immediately. Loss of data access may occur if the error is not immediately corrected.
Parameter Description the last event entered) are saved to the file. Use integer values. forceSave When set to TRUE, force saves all critical events to a file. Default value is FALSE. Save Storage Array iSCSI Statistics Description This command saves the iSCSI performance of the storage array to a file.
Save Storage Array Performance Statistics Description This command saves the performance statistics to a file. Before you use this command, issue the set session performanceMonitorInterval and set session performanceMonitorIterations commands to specify how often statistics are collected. Syntax save storageArray performanceStats file="filename" Parameters Parameter Description file Specifies name of the file to which to save the performance statistics.
Save Storage Array State Capture Description This command saves the state capture to a file. Syntax save storageArray stateCapture file="filename" Parameters Parameter Description file Name of the file to which to save the state capture. You must put quotation marks (" ") around the file name. Save Storage Array Support Data Description This command saves the storage array support-related information to a file.
Parameters Parameter Description file The path and the file name where support-related data for the storage array is saved. Enclose the file path and the file name in double quotation marks (" "). For example, file="C:\Program Files\CLI \logs\supdat.zip". This command does not automatically append a file extension to the saved file. A file extension must be specified when entering the file name.
Parameter Description data Store the data generated by the command at the location specified by the pathName. Scheduling Snapshots NOTE: This command is applicable to both the Snapshot and the Snapshot (Legacy) premium feature. Description 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.
Parameter Description maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180. endDate Specific date to stop creating a snapshot virtual disk and end the copy-on-write operations. The format is 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-onwrite operation from ending.
Syntax set consistencyGroup ["consistencyGroupName"] [userLabel="consistencyGroupName"] [repositoryFullPolicy=(failBaseWrites | purgeSnapImages)] [repositoryFullLimit=percentValue] [autoDeleteLimit=numberOfSnapImages] [rollbackPriority=(lowest | low | medium | high | highest)] Parameters Parameter Description consistencyGroupName The name of the consistency group for which you are setting properties. Enclose the consistency group name in double quotation marks (" ") inside square brackets ([ ]).
Syntax set cgSnapVirtualDisk [consistencyGroupName] userLabel="snapVirtual DiskName" Parameters Parameter Description cgSnapVirtualDisk The name of the consistency group virtual disk that you want to rename. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]). userLabel The new name that you want to give to the snapshot virtual disk in the consistency group. Enclose the new snapshot virtual disk name in double quotation marks (" ").
Parameters 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. Slot ID values are 0 to 31. You must put parentheses around the enclosure ID values and the slot ID values. raidLevel The RAID level for the disk group. Valid values are 0, 1, 5, or 6.
operation, stripe size, and whether replication is enabled may result in less memory being available to complete the DCE operation. In such a scenario, try each of the options below and retry the operation: • Create the required disk group size using other unassigned physical disks. • Delete the current disk group and then recreate the disk group with the desired number of physical disks. • Reduce the segment size being used and then retry the operation.
Parameters Parameter Description diskPools The list of diskPoolNames identifies multiple physical disk pool which have their parameters reset by the command. allDiskPools This parameter specifies that all physical disk pools have their parameters reset by the command. reservePhysicalDiskCount This value is specified in terms of the number of physical disks to reserve in the disk pool for physical disk failures or physical disk removals.
Set Enclosure Attribute Description This command sets user-defined attributes for an enclosure. Syntax set enclosure [enclosureID] (chassisName | assetTag)= "userID" Parameters Parameter Description enclosureID Identifies a specific enclosure for which to set the attribute. Enclosure ID values are 0 to 99. You must put brackets ([ ]) around the enclosure ID value. chassisName Chassis name or number to give the new enclosure.
Parameters 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. id Specifies the value for the RAID enclosure or expansion enclosure ID. Valid values are 0 through 99. You do not need to put parentheses around the enclosure ID value.
Parameters Parameter eventType Description This parameter is the integer value for the event. Enter the event value in a hexadecimal format, for example, 0x280D. Always begin the hexadecimal value with 0x to indicate that it is in hexadecimal format. If you do not use 0x, the value will be interpreted as a decimal and converted to a hexadecimal value, before applying the block or unblock command. This can cause an incorrect event to be blocked or unblocked.
Parameter Description Enclose the enclosure ID value, the drawer ID value, and the slot ID value in square brackets ([ ]). securityID The security ID of the physical disk to erase, in string form. This string can have a maximum of 32 characters. The form of the security ID will vary by manufacturer. NOTE: To find the security ID, remove the physical disk and read the security ID on the canister label.
Parameters Parameter Description physicalDisk or physicalDisks The enclosure and the slot where the physical disk resides. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. Enclose the enclosure ID values and the slot ID values in square brackets ([ ]). allPhysicalDisks Selects all the physical disks. Set Host Description This command assigns a host to a host group or moves a host to a different host group.
Parameter Description available host type identifiers. If the host type has special characters, enclose it in double quotation marks (" "). Host Group Parameter Host Has Individual Virtual Disk- Host Does Not Have Individual to-LUN Mappings Virtual Disk-to-LUN Mappings hostGroupName The host is removed from the present host group and is placed under the new host group defined by hostGroupName.
Parameter Description For example, the identifier number for host channel 2 on RAID controller module 0 would be [0,2]. preferredID The port identifier for the specified host port. Port ID values are 0 to 127. Set Host Group Description This command renames a host group. Syntax set hostGroup [hostGroupName] userLabel="newHostGroupName" Parameters Parameter Description hostGroup Name of the host group to rename. You must put brackets ([ ]) around the host group name.
Parameters Parameter Description hostPort The name of the HBA host port for which you want to change the host type, or for which you want to create a new name. Enclose the HBA host port name in square brackets ([ ]). If the HBA host port label has special characters, enclose the HBA host port label in double quotation marks (" "). host The name of the host to which the HBA host port is connected. Enclose the host name in double quotation marks (" ").
Parameter Description chapSecret The password that you want to use to authenticate a peer connection. NOTE: Challenge Handshake Authentication Protocol (CHAP) is a protocol that authenticates the peer of a connection. CHAP is based upon the peers sharing a “secret.” A secret is a security key that is similar to a password. NOTE: Use the chapSecret parameter only for initiators requiring mutual authentication. Set iSCSI Target Properties Description This command defines properties for an iSCSI target.
Syntax set physicalDiskChannel [(1 | 2)] status=(optimal | degraded) Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to set the status. Valid physical disk channel values are 1 or 2. You must put brackets ([ ]) around the physical disk channel number. status Condition of the channel. You can set the channel status to optimal or degraded. NOTE: Use the optimal parameter to move a degraded channel back to the Optimal state.
Set Physical Disk State Description This command sets a physical disk to the Failed state. To return a physical disk to the Optimal state, use the revive physicalDisk command. Optionally, you can copy the data from the physical disk before you fail it. Syntax set physicalDisk [enclosureID,drawerID,slotID] operationalState=failed [copyPhysicalDisk] Parameters Parameter Description physicalDisk or physicalDisks The enclosure and the slot where the physical disk resides. Enclosure ID values are 0 to 99.
Parameters Parameter Description controller The RAID controller module for which you want to define properties. Valid RAID controller module identifiers are 0 or 1, where 0 is the RAID controller module in the top slot, and 1 is the RAID controller module in the bottom slot. Enclose the identifier for the RAID controller module in square brackets ([ ]). If you do not specify a RAID controller module, the firmware for the RAID controller returns a syntax error.
Parameter Description The values that support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, the subnet mask address, the IPv4 priority, and the IPv6 priority. rloginEnabled The setting for whether the remote login feature is turned on or turned off. To turn on the remote login feature, set this parameter to TRUE. To turn off the remote login feature, set this parameter to FALSE.
Options for the Ethernet Port Parameter IPv6NdRetransmitTime=[0-65535] | IPv6NdTimeOut=[0-65535] | IPv4Priority=[0-7] | 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)] Notes When you use this command, you can specify one or more parameters. You need not to use all the parameters.
• The tcpListeningPort option is 3260. Set RAID controller NTP settings Description The set controller NTPServers command sets the NTP settings for the controller so the RAID controller can automatically synchronize the clocks with an external host using SNTP (Simple Network Time Protocol). When this feature is enabled, the RAID controller periodically queries the configured NTP server, then uses the results to update its internal time-of-day clock.
Parameter Description NOTE: Surround the NTP server name with quotes, as shown in the Examples section. Address “DomainName"|IPv4Address|IPv6Address NOTE: If a domain name is specified, a DNS server must also be configured to allow the controller to resolve the server IP address. Examples set controller[0] NTPServers=disabled; set controller[0] NTPServers=auto; set controller[0] NTPServers=("0.pool.ntp.org" "1.us.pool.ntp.org"); set controller[1] NTPServers=(192.168.1.105 "1.us.pool.ntp.
Parameter Description repositoryFullLimit The percentage of repository virtual disk capacity at which you receive a warning that the snapshot image repository virtual disk is nearing full. Use integer values. For example, a value of 70 means 70 percent. The default value is 75. Notes The repository virtual disk name is automatically created by the MD storage management software and the firmware when you create a new snapshot group.
Parameter Description If the virtual disk names have special characters or consist only of numbers, enter the names using these rules: • Enclose all names in square brackets ([ ]). • Enclose each names in double quotation marks (" "). • Separate each names with a space. role The setting for the local virtual disk to act as the primary virtual disk or the secondary virtual disk. To define the virtual disk as the primary virtual disk, set this parameter to primary.
Notes When you use this command, you can specify one or more optional parameters. 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. If you select the highest priority level, the data synchronization uses the most system resources to perform the full synchronization, which decreases the performance for host data transfers.
Parameter Description must enclose the virtual disk name in double quotation marks (" ") inside square brackets. syncInterval Specify the length of time between automatically sending updates of modified data from the local storage array to the remote storage array. You can specify the length of time in minutes, hours, or days.
Parameter Description run the resume remoteReplicationGroup command. virtualDisk The name of the specific virtual disk that you want to modify in the remote replication group. Enclose the virtual disk name in double quotation marks (" "). repositoryVirtualDisk The name of the repository virtual disk for which you want to increase capacity. An available standard virtual disk is added to the repository virtual disk to increase the capacity of the repository virtual disk.
Parameter Description define the remote replication group as the primary role, set this parameter to primary. To define the remote replication group as the secondary role, set this parameter to secondary. force The role reversal is forced if the communications link between the storage arrays is down and promotion or demotion on the local side results in a dual-primary condition or a dual-secondary condition. To force a role reversal, set this parameter to TRUE. The default value is FALSE.
Set Session Description This command defines how you want the current script engine session to run. Syntax set session errorAction=(stop | continue) password=”storageArrayPassword” performanceMonitorInterval=intervalValue performanceMonitorIterations=iterationValue Parameters Parameter Description errorAction How the session responds if an error is encountered during processing. You can choose to stop the session if an error is encountered, or you can continue the session after encountering an error.
Set Snapshot Group Attributes Description This command defines the properties for a snapshot group. Syntax set snapGroup ["snapGroupName"] (userLabel="snapGroupName" | repositoryFullPolicy=(failBaseWrites | purgeSnapImages) | repositoryFullLimit=percentValue |autoDeleteLimit=numberOfSnapImages | rollbackPriority=(lowest | low | medium | high | highest)) Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group for which you are setting properties.
Parameter Description lowest. A value of high indicates that the rollback operation is prioritized over all other host I/O. A value of lowest indicates that the rollback operation should be performed with minimal impact to host I/O. Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. When you use this command, you can specify one or more of the parameters.
Set Snapshot Group Repository Virtual Disk Capacity Description This command increases or decreases the capacity of a snapshot group repository virtual disk.
Syntax set snapGroup ["snapGroupName"] enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule) Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group for which you are setting properties. Enclose the snapshot group name in double quotation marks (" ") inside of square brackets ([ ]). enableSchedule Use this parameter to turn on or to turn off the ability to schedule a snapshot operation.
warningThresholdPercent=percentValue repositoryFullPolicy=(failSourceWrites | failSnapshot) enableSchedule=(TRUE | FALSE) | schedule=(immediate | snapshotSchedule) rollbackPriority=(0 | 1 | 2 | 3 | 4) Parameters Parameter Description virtualDisk or virtualDisks The name of the specific snapshot virtual disk for which you want to define properties. (You can enter more than one virtual disk name if you use the virtualDisks parameter).
Parameter Description rollbackPriority Determines whether system resources must be allocated to the rollback operation at the expense of system performance. A value of 0 indicates that the rollback operation is prioritized over all other host I/O. A value of 4 indicates that the rollback operation must be performed with minimal impact to the host I/O. Notes When you use this command, you can specify one or more of the optional parameters.
Parameter Description scheduleInterval Amount of time, in minutes that defines a minimum between two copy-on-write operations. It is possible for you to create a schedule in which you have overlapping copy-on-write operations because of the duration of a copy operation. You can ensure that copy-on-write operations maintain a correct interval by using this option. The maximum value for the scheduleInterval option is 1440 minutes. For example: scheduleInterval=180.
NOTE: If you also use the scheduleInterval option, the firmware chooses between the timesPerDay option and the scheduleInterval option by selecting the lowest value of the two options. The firmware calculates an integer value for the scheduleInterval option by dividing 1440 by the scheduleInterval option value that you set. For example, 1440/180 = 8. The firmware then compares the timesPerDay integer value with the calculated scheduleInterval integer value and uses the smaller value.
Set Snapshot Virtual Disk Repository Virtual Disk Capacity Description This command defines the capacity the you can set for a snapshot virtual disk repository virtual disk.
Description The means of registering the iSCSI target on the iSNS server. Set the parameter to TRUE to list an iSCSI target. When you set this parameter to TRUE you must also use these parameters for IPV4 configurations: • isnsIPV4ConfigurationMethod • isnsIPV4Address When you set this parameter to TRUE you must also use these parameters for IPV6 configurations: • isnsIPV6Address Optionally, you can also use the isnsListeningPort parameter to define the port monitor and manage traffic to the server.
Parameter Description failoverAlertDelay The failover alert delay time in minutes. The valid values for the delay time are 0 to 60 minutes. The default value is 5. mediaScanRate The number of days over which the media scan runs. Valid values are disabled, which turns off the media scan, or 1 day to 30 days, where 1 day is the fastest scan rate, and 30 days is the slowest scan rate. A value other than disabled or 1 to 30 does not allow the media scan to function.
configurations, this parameter includes all the virtual disks that are owned by both RAID controller modules within the storage array. Cache Flush Start and Cache Flush Stop When you define values to start a cache flush, a value that is too low increases the chance that data needed for a host read is not in the cache. A low value also increases the number of physical disk writes that are necessary to maintain the cache level, which increases system overhead and decreases performance.
Syntax set storageArray enclosurePositions=(controller | enclosureID... enclosureIDn) 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. Enclose the list of enclosure ID values in parentheses.
Parameter Parameter Description icmpPingResponse This parameter turns on or turns off Echo Request messages. Set the parameter to TRUE to turn on Echo Request messages. Set the parameter to FALSE to turn off Echo Request messages. Set Storage Array iSNS Server IPv4 Address Description This command sets the configuration method and address for an IPv4 Internet Storage Name Service (iSNS).
Set Storage Array iSNS Server Listening Port Description This command sets the iSNS server listening port. Syntax set storageArray isnsListeningPort=listeningPortIPAddress Parameter Parameter Description isnsListeningPort The IP address that you want to use for the iSNS server listening port. The range of values for the listening port is 49152 to 65535. The default value is 3205.
Parameter Description up to seven days after the next scheduled learn cycle. day Valid values for the day parameter include the days of the week. Setting the day causes the next learn cycle to be scheduled on the specified day, after the currently scheduled learn cycle. time The time in 24-hour format; for example 8:00 a.m. is entered as 08:00. Nine o’clock p.m. is entered as 21:00, and 9:30 p.m. is entered as 21:30. NOTE: You can set the learn cycle to occur only once during a seven-day period.
Parameters None. Additional Information Security-capable physical disks have hardware to accelerate cryptographic processing and each has a unique physical disk key. A security-capable physical disk behaves like any other physical disk until it is added to a secured disk group. When a security-capable physical disk is added to a secured disk group, it becomes security-enabled.
Parameter Description turn on unnamed discovery sessions. Set the parameter to FALSE to turn off unnamed discovery sessions. NOTE: Discovery is the process where initiators determine the targets that are available. Discovery occurs at power-on/initialization and also if the bus topology changes, for example, if an extra device is added. NOTE: An unnamed discovery session is a discovery session that is established without specifying a target ID in the login request.
Parameter Description NOTE: The maximum capacity is 250 GB. repositoryMaxCapacity Set the maximum capacity of the repository virtual disk. The value must not be smaller that the physical capacity of the repository virtual disk. If the new value results in a reduction in capacity to a level below the warning threshold, the command will produce an error. repositoryExpansionPolicy Set the expansion policy to automatic or manual.
CAUTION: Enabling Write Cache on a virtual disk generally improves performance for applications with significant Write content (unless the application features a continuous string of Writes. However, Write Cache does introduce some risk of data loss in the unlikely event of a RAID controller module failure. Syntax Applicable To Only One Virtual Disk set (virtualDisk [“virtualDiskName”] | virtualDisk ) addCapacity=virtualDiskCapacity [addPhysicalDisks=(enclosureID1,slotID1 enclosureID2,slotID2 ...
Parameter Description this parameter to TRUE. To turn off caching without batteries, set this parameter to FALSE. 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 replication cache.
Parameter Description values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID values and the slot ID values. Use with the addCapacity parameter if you must specify additional physical disks to accommodate the new size. consistencyCheckEnabled Turns consistency checking during a media scan on or off. To turn consistency checking on, set to TRUE. To turn consistency checking off, set to FALSE.
Parameter Description hostGroup Specifies the name of the host group to which the virtual disk is mapped. You must put quotation marks (" ") around the host group name. NOTE: When using this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters. NOTE: You can apply the addCapacity, segmentSize, userLabel, and logicalUnitNumber parameters to only one virtual disk at a time.
Parameters Parameter Description allVirtualDisks The properties for all virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you want to define properties. (You can enter more than one virtual disk name if you use the virtualDisks parameter.) Enclose the virtual disk name in double quotation marks (" ") inside of square brackets ([ ]). virtualDisk The World Wide Identifier (WWID) of the virtual disk for which you are setting properties.
Parameter Description cacheFlushModifier The maximum amount of time that data for the virtual disk stays in cache before the data is flushed to physical storage. Valid values are listed in the Notes section. cacheReadPrefetch The setting to turn on or turn off cache read prefetch. To turn off cache read prefetch, set this parameter to FALSE. To turn on cache read prefetch, set this parameter to TRUE. cacheWithoutBatteryEnabled The setting to turn on or turn off caching without batteries.
Parameter Description TRUE. To turn off the write cache, set this parameter to FALSE. segmentSize The amount of data (in KB) 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 userLabel The new name that you want to give an existing virtual disk. Enclose the new virtual disk name in double quotation marks (" ").
Add Capacity, Add Physical Disks, And Segment Size Setting the addCapacity parameter, the addPhysicalDisks parameter, or the segmentSize parameter starts a long-running operation that you cannot stop. These long-running operations are performed in the background and do not prevent you from running other commands. To show the progress of long-running operations, use the show virtualDisk actionProgress command. Cache Flush Modifier Valid values for the cache flush modifier are listed in the following table.
Modification Priority Modification priority defines the amount of system resources that are used when modifying virtual disk properties. If you select the highest priority level, the virtual disk modification uses the most system resources, which decreases the performance for host data transfers.
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. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the target virtual disk name. source Specifies the name of the source virtual disk for which to define properties. You must put brackets ([ ]) around the source virtual disk name.
For mapping Legacy snapshot and any virtual disk: set (virtualDisk ["virtualDiskName"] | virtualDisk | accessVirtualDisk) logicalUnitNumber=LUN (host="hostName" | hostGroup=("hostGroupName" | defaultGroup) Parameters Parameter Description virtualDisk The name of the specific virtual disk for which you want to define mapping. Enclose the virtual disk name in double quotation marks (" ") inside of square brackets ([ ]).
Show Blocked Events Description This command returns a list of events that are currently blocked by the set blockEventAlert command. The events in this list are the events that will not send any notifications that you have configured using the alert terminals and parameters; that is, the email, syslog, and trap notifications. The output has one line for each event that is blocked, listing the type of event in a hexadecimal format followed by a description of the event.
Parameter Description • • NEWEST - Use this option when you want to show the latest snapshot image created in the consistency group. OLDEST - Use this option when you want to show the earliest snapshot image created in the consistency group. Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]). You can enter more than one snapshot name or sequence number. Enclose all of the snapshot names in one set of double quotation marks (" ") inside square brackets ([ ]).
Syntax When running from the command line, use: show iscsiInitiator [\“initiatorName\”] iscsiSessions show iscsiTarget [\“targetName\”] iscsiSessions When running from a script file, use: show iscsiInitiator [“initiatorName”] iscsiSessions show iscsiTarget [“targetName”] iscsiSessions Parameters Parameter Description initiatorName The name of the iSCSI initiator for which session information is desired. Enclose the iSCSI initiator name in double quotation marks (“ ”).
NOTE: You can use the free capacity area value when you create a virtual disk based on the free capacity of a disk group. For a description of how to use the free capacity value, see the create virtualDisk command on Create RAID Virtual Disk (Free Capacity Base Select). Syntax show diskGroup [diskGroupNumber] Parameter Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number.
Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number. cancelImport The setting to spin the physical disks back down after the disk group dependencies have been read. To spin down the physical disks, set this parameter to TRUE. To let the physical disks stay spinning, set this parameter to FALSE.
Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example.
| (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID1,slotID1 enclosureID2,slotID2... enclosureIDn,slotIDn]) summary Parameters Parameter Description allPhysicalDisks Returns information about all physical disks in the storage array. NOTE: To determine information about the type and location of all physical disks in the storage array, use the allPhysicalDisks parameter. driveMediaType retrieve information.
Show Physical Disk Channel Statistics Description This command shows cumulative physical disk channel data transfer and error information. If the RAID controller module has automatically degraded a channel, this command also shows interval statistics. When using this command, you can display information about one specific physical disk channel, several physical disk channels, or all physical disk channels.
Status Definition Successful Downloads completed without errors. Not Attempted Downloads did not start. Partial Download Downloads are in progress. Failed Downloads completed with errors.
Show RAID Controller Module NVSRAM Description This command returns a list of the NVSRAM byte values for the specified host type. If you do not enter the optional parameters, this command returns a list of all NVSRAM byte values. Syntax show (allControllers | controller [(0 | 1)]) NVSRAM [hostType=( hostTypeIndexLabel | host="hostName")] Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array.
Syntax show (allAsyncRemoteReplicationGroups | asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"]) [summary] Parameters Parameter Description allAsyncRemoteReplicationGroups Use this parameter if you want to display the properties for all remote replication groups. asyncRemoteReplicationGroup Use this parameter to display the properties for a remote replication group. Enclose the remote replication group name in square brackets ([ ]).
Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to check the synchronization progress. Enclose the remote replication group name in square brackets ([ ]). If the remote replication group name has special characters, you also must enclose the remote replication group name in double quotation marks (" ") inside square brackets.
Show Remote Replication Virtual Disk Synchronization Progress NOTE: This command valid only with Fibre Channel storage arrays. Description This command returns the progress of data synchronization between the primary virtual disk and the secondary virtual disk in a Remote Replication configuration. This command shows the progress as a percentage of data synchronization that has been completed. Syntax show remoteReplication (localVirtualDisk [“virtualDiskName”] | localVirtualDisks [“virtualDiskName1” ...
Parameters Parameter Description allSnmpCommunities This parameter returns information about all of the SNMP communities in the storage array. communityName The name of the SNMP community for which you want to retrieve information. Enclose the SNMP community name in double quotation marks (" "). snmpCommunities The names of several SNMP communities for which you want to retrieve information.
Show SNMP MIB II System Group Variables Description This command returns information about the Simple Network Management Protocol (SNMP) system variables. The system variables are maintained in a Management Information Base II (MIB-II) database. Syntax show snmpSystemVariables Parameters None. Notes This command returns SNMP system variables information similar to this example. SYSTEM VARIABLES Sys Name: NONE Sys Contact: NONE Sys Location: NONE Minimum Firmware Level 8.
Parameter Description If you enter more than one snapshot group name, separate each name with a space. Enclose all of the snapshot group names in only one set of double quotation marks (" "). summary The parameter to return a concise list of information about the snapshot groups. schedule The parameter to return a concise list of information about the schedules for the snapshot group copy operations.
Auto-delete Snapshot images: Disabled Snapshot image schedule: Not Applicable Show Snapshot Image Description This command returns information about the snapshot images that a user had previously created. Syntax For Showing A Specific Snapshot Image show (snapImage ["snapImageName"] | snapImages ["snapImageName1 ... snapImageNamen"] | allSnapImages]) [summary] Parameters Parameter Description snapImage or snapImages The name of the snapshot image.
Notes The name of a snapshot image has two parts separated by a colon (:): • The identifier of the snapshot group. • The identifier of the snapshot image.
Notes This command returns snapshot virtual disk information as shown in this example: SNAPSHOT Virtual Disk(SNAPSHOT-IMAGE BASED) SUMMARY SUMMARY Total Snapshot virtual disks: 1 Most Recent Snapshot virtual disk: Day month date hh:mm:ss yyyy Status: 1 Optimal, 0 Non Optimal Name Type Status Capacity Associated Base Virtual Disk 2_SV_0001 Standard Optimal 3.
Notes This command returns the SSD cache information similar to this example. SSD Cache name: my_cache Status: Optimal Type: Read Only I/O characteristic type: File System Maximum capacity allowed: 1,862.645 GB Current capacity: 557.792 GB Additional capacity allowed 1,304.852 GB Physical disk capacities: All 278.
Parameter Description brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets. controller Each RAID controller module stores SSD cache metadata for the virtual disks that it owns. Therefore, the SSD cache statistics are maintained and displayed per RAID controller module.
Cache Allocation (%) The amount of SSD cache storage that is allocated, expressed as a percentage of the SSD cache storage that is available to this RAID controller module. Derived from allocated bytes / available bytes. Cache Allocation percentage normally shows as 100%. If this number is less than 100%, it means either the cache has not been warmed or the SSD cache capacity is larger than all the data being accessed.
hit blocks, it is possible that a different I/O characteristic type (file system, database, or web server) could improve the performance. Misses Number of host reads where none of the blocks were in the SSD cache. This is an SSD cache miss where the reads were satisfied from the base virtual disk. Misses - Blocks Number of blocks in Misses. Populate Actions (Host Reads) Number of host reads where data was copied from the base virtual.
The available bytes, allocated bytes, and user data bytes are used to compute the Cache Allocation % and the Cache Utilization %. Show Storage Array NOTE: With firmware version 8.10 the cacheFlushStop parameter is deprecated and will be removed in a future release of storage management software. Description This command returns configuration information about the storage array. The parameters return lists of values for the components and features in the storage array.
Parameter Description NOTE: The previous command syntax is for a host running Windows. The actual syntax varies depending on your operating system. autoSupportConfig The parameter to return information about the current state of the operation to automatically collect support data.
Parameter Description • Time remaining NOTE: When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. Show Storage Array Auto Configure Description This command shows the default autoconfiguration that the storage array creates if you issue the autoConfigure storageArray command. To determine whether the storage array can support specific properties, enter the parameter for the properties when you issue this 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 desired in the storage array. Use integer values. For information about hot spares, see Assigning Global Hot Spares.
Show Storage Array Controller Health Image Description This command show details of the controller health image on the RAID controller module cache, if a controller health image is available. Syntax show storageArray controllerHealthImage Parameters None. Show Storage Array DBM Database Description This command retrieves and shows metadata for the on-board backup locations of a storage array. When there are multiple backup locations, metadata is shown for each location.
NOTE: This command returns the host topology information similar to this example.
Syntax show storageArray lunMappings (host ["hostName"] | hostgroup ["hostGroupName"]) Parameters Parameter Description host Name of a specific host for which to see the LUN mappings. You must put quotation marks (" ") and brackets ([ ]) around the host name. The host name and quotation marks must be inside the brackets. hostGroup Name of a specific host group for which to see the LUN mappings. You must put quotation marks (" ") and brackets ([ ]) around the host group name.
Syntax show storageArray odxsetting Parameters None. NOTE: This command returns the ODX and VAAI information similar to this example. Windows ODX Setting Status odxEnabled True | False | Inconsistent | Unknown vaaiEnabled True | False | Inconsistent | Unknown Show Storage Array Power Information Description This command returns information about the amount of power consumed by the entire storage array and each enclosure in the storage array.
Parameters None. Show Storage Array Unreadable Sectors Description This command returns a table of the addresses of all of the sectors in the storage array that cannot be read.
Show Thin Virtual Disk Description This command returns the expansion history or the consumed capacity for the specified thin virtual disk or virtual disks. Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN]) (consumedCapacity | (expansionHistory [file=fileName])) Parameters Parameter Description allVirtualDisks The setting to return information about all of the virtual disks in the storage array.
MM/DD/YYYY HH:MM:SS Manual|Automatic NNNNNNNN bytes NNNNNNNN bytes With the consumedCapacity parameter, the command returns information similar to the example shown below. Virtual Disk Physical Capacity Consumned Capacity Quota % Prov. Consumed virtualDiskNam e 500.000 GB 230.000 GB 700.
Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ...virtualDiskNameN]) summary Parameters Parameter Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you are retrieving information. You can enter more than one virtual disk name. Enclose the virtual disk name in square brackets ([ ]).
Parameters Parameter Description virtualDisk Name of the virtual disk running the long‑running operation. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Copy Description This command returns information about virtual disk copy operations.
Show Virtual Disk Copy Source Candidates Description 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 Virtual Disk Name: engineering Capacity: 4.
Show Virtual Disk Performance Statistics Description This command returns information about the performance of the virtual disks in a storage array. Syntax show (allVirtualDisks | virtualDisk [virtualDiskName] virtualDisks [virtualDiskName1... virtualDiskNameN]) performanceStats Parameters Parameter Description allvirtualDisks The setting to return performance statistics about all of the virtual disks in the storage array.
Start Configuration Database Diagnostic Description This command starts a diagnostic test to validate the configuration database in the RAID controller module firmware. Syntax start storageArray configDbDiagnostic Parameters None. Notes Upon completion of the diagnostic test, the RAID controller module firmware returns one of these results: • Diagnosis completed without errors. No ZIP file created. • Diagnosis completed with errors. Refer to the ZIP file created at: ...\Install_dir\data\FirmwareUpgrad
the consistency group snapshot virtual disk. The base virtual disks immediately becomes available for read/write requests after the rollback operation has successfully completed. To stop a snapshot consistency group rollback operation, use the stop rollback command for consistency groups.
Start Disk Group Blink Description This command identifies the physical disks that are logically grouped together to form the specified disk group by blinking the indicator LEDs on the physical disks. (Use the stop diskGroup blink command to turn off the indicator LEDs on the physical disks.) Syntax start diskGroup [diskGroupNumber] blink Parameters Parameter Description diskGroup Number of the disk group to identify. You must put brackets ([ ]) around the disk group number.
Syntax start diskGroup [diskGroupName] export Parameters Parameter Description diskGroup Number of the disk group to defragment. You must put brackets ([ ]) around the disk group number. 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.
NOTE: Higher-level virtual disks that are specifically related to premium features (Snapshot, Remote Virtual Disk Replication, Virtual Disk Copy, mapping, and persistent reservations) are removed as part of the import operation. You must run the show diskGroup importDependencies command before you run the start diskGroup import command. Start Disk Pool Locate Description This command initiates a location operation on all of the physical disks that comprise the specified disk pool.
Start Input Output RAID Controller Module (IOC) Dump Description This command produces a dump of the IOC log of data transmissions between a host and a RAID controller module. RAID Controller Modules are identified as "0" or "1". Each RAID controller module can have up to four host channels, each channel is uniquely identified by a number from 1 through 4.
Parameters Parameter Description controller The identifier letter of the RAID controller module that has the iSCSI host ports. Valid RAID controller module identifier values are 0 or 1, where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1. iscsi-host-port The identifier of the port on the storage array on which you want to refresh the DHCP parameters. Enclose the iSCSI host port name in square brackets ([ ]).
Syntax start physicalDiskChannel [(1 | 2)] blink Parameters Parameter Description physicalDiskChannel The identifier number of the physical disk channel that you want to locate. Valid values for the identifier number are 1 or 2. Enclose the identifier number in square brackets ([ ]). Start Physical Disk Initialize Description This command starts physical disk initialization. CAUTION: As soon as you enter this command, all user data is erased.
Parameter Description ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value. Start Remote Replication Synchronization Description This command starts Remote Replication synchronization. Syntax start asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] synchronize [deleteRecoveryPointIfNecessary] Parameter Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to start synchronization.
Start SED Secure Physical Disk Erase Description This command erases all of the data from one or more self-encrypting disk (SED) physical disks so that they can be reused as SED physical disks. Run this command only when the SED physical disks are no longer part of a secure disk group, or when the security key is unknown.
Parameters Parameter Description virtualDisk or Names the specific snapshot virtual disk or snapshot virtual disks for which you want to start a rollback operation. Enclose the snapshot virtual disk name in square brackets ([ ]). If the snapshot virtual disk name has special characters, you must also enclose the snapshot virtual disk name in double quotation marks (" "). virtualDisks Start Snapshot Image Rollback Description This command starts a rollback operation for a set of snapshot images.
Parameter Description Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]).
• Retrieve the performance modeling data using PowerVault MD Storage Manager. Performance modeling ends, but no data is available when one of the following conditions occurs: • You reboot the RAID controller module. • You make any changes to the SSD cache configuration. • The state of the SSD cache changes. Start Storage Array Blink Description This command identifies a storage array by turning on the indicator LED for the storage array.
Parameter Description fileSystem This option checks the structural integrity of the database. replication • • contentCheck When the sourceLocation parameter is set to disk, the peer RAID controller module initiates a block check. When the sourceLocation parameter is set to cache, the peer RAID controller module initiates a record check. This option performs a deep analysis of each record's contents. The default value is fileSystem.
• Saves a ZIP file containing raw binary data The RAID controller module firmware saves the ZIP file to this location:...\Install_dir\data \FirmwareUpgradeReports\timestamp_buildNo.zip You can use the binary data to help determine the cause of the problem, or you can send the file containing the binary data to a Technical Support representative. To stop the database configuration diagnostic test, use the stop storageArray configDbDiagnostic command.
Parameters Parameter Description virtualDisk Name of the virtual disk for which to start the formatting. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name.
Parameters Parameter Description consistencyGroupName The name of the consistency group for which you want to stop a rollback operation. Enclose the name of the consistency group in double quotation marks (" ") inside square brackets ([ ]). When the memberVirtualDiskSet parameter is not used, the rollback process applies to all member virtual disks of the consistency group.
Parameter Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk that you want to stop creating. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]) The name of the consistency group snapshot virtual disk that you want to delete. Enclose the consistency group snapshot virtual disk name in square brackets ([ ]).
Syntax stop enclosure blink Parameters None. Stop Pending Snapshot Images On Consistency Group Description This command stops all of the pending snapshot images that are to be created on a snapshot consistency group. If the snapshot consistency group does not have any pending snapshot images, the MD storage management software displays an error message and does not run the command.
Syntax stop physicalDiskChannel blink Parameters None. Stop Physical Disk Replace Description This command stops a data copy operation that was started by either a set physicalDisk command or a replace physicalDisk command with the copyPhysicalDisk user input. Syntax stop physicalDisk replace ([enclosureID,drawerID,slotID] | <"wwID">) Parameters Parameter Description physicalDisk The location of the physical disk that is being copied before you replace it.
Stop Snapshot Group Image Description This command cancels a pending snapshot image copy-on-write operation on a snapshot image group. If the snapshot image group does not have any pending snapshot images, this command returns an error message.
Parameter Description pending snapshot images. Enclose the snapshot group identifier in square brackets ([ []). consistencyGroup The alphanumeric identifier (including - and _) of the snapshot consistency group for which you want to stop pending snapshot images. Enclose the snapshot group identifier in square brackets ([ []). Stop Snapshot (Legacy) Description This command stops a copy-on-write operation. Syntax stop snapshot (virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1...
If you do not choose a name for either the snapshot (legacy) virtual disk or the snapshot (legacy) repository virtual disk, the MD storage management software creates a default name by using the base virtual disk name. An example of the snapshot (legacy) virtual disk name that the RAID controller modules might create is, if the base virtual disk name is aaa and does not have a snapshot (legacy) virtual disk, the default snapshot (legacy) virtual disk name is aaa-1.
Parameter Description If the virtual disk names have special characters or numbers, enter the names using these rules: • Enclose all names in square brackets ([ ]). • Enclose each name in double quotation marks (" "). • Separate each name with a space. Stop Snapshot Rollback Description This command stops a snapshot rollback operation that was initiated by the start rollback virtual disk command.
Parameter Parameter Description snapImage The name of the snapshot image for which you want to stop a rollback operation. The name of a snapshot image is comprised of two parts: • • The name of the snapshot group. An identifier for the snapshot image in the snapshot group. The identifier for the snapshot image can be one of these: • • • An integer value that is the sequence number of the snapshot in the snapshot group.
Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk that you want to stop. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]). Stop SSD Cache Performance Modeling Description This command stops the performance modeling operation and displays the performance modeling data for the SSD cache.
Notes This command returns the performance modeling information similar to this example. The size of your monitor determines how the information wraps and will affect how the information appears. SSD Cache Name: my_cache Start time: 4/18/12 2:38:26 PM IST Stop time: 4/18/12 2:38:45 PM IST Duration : 00:00:19 SSD Cache Performance Modeling Data (Response Time): SSD Reads HDD Reads HDD Writes Cache Capacity Overall Response Time Avg. Response Time % of I/Os Avg. Response Time % of I/Os Avg.
1489 GB 0 % 1675 GB 0 % 1862 GB 0 % * = Current SSD cache physical capacity. Stop Storage Array Blink Description This command turns off the indicator lights on the storage array that were turned on by the start storageArray blink command. Syntax stop storageArray blink Parameters None.
Stop Storage Array iSCSI Session Description This command forces the termination of an iSCSI session. Syntax stop storageArray iscsiSession [sessionNumber] Parameters Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session in square brackets ([ ]).
Parameters Parameter Description target Name of the target virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the target virtual disk name. If the target virtual disk name has special characters, you must also put quotation marks (" ") around the target virtual disk name. source Name of the source virtual disk for which to stop a virtual disk copy operation. You must put brackets ([ ]) around the source virtual disk name.
NOTE: If the writeConsistency parameter is set to TRUE, the virtual disks must be in a writeconsistency 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”] writeConsistency=TRUE suspends A-A’, B-B’, and C-C’.
Syntax suspend ssdCache [ssdCacheName] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to suspend. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the identifier in double quotation marks (" ") inside square brackets. Notes To restart caching, use the resume ssdCache command.
Parameter Description • • • path. The connectivity test sends an inter-RAID controller module message between the storage arrays, and then validates that the corresponding remote replication group on the remote storage array exists. It also validates that the virtual disk members of the remote replication group on the remote system match the virtual disk members of the remote replication group on the local system.
Unregister SNMP Community Description This command deletes an existing Simple Network Management Protocol (SNMP) community that you previously created and registered using the create snmpCommunity command. Deleting an SNMP community effectively unregisters the community. Any trap destinations associated with that community are also removed. Syntax delete snmpCommunity communityName="snmpCommunityName" Parameters Parameter Description communityName The name of the SNMP community that you want to delete.
Syntax set snmpCommunity communityName="snmpCommunityName" newCommunityName="newSnmpCommunityName" Parameters Parameter Description communityName The name of the existing SNMP community that you want to rename. Enclose the SNMP community name in double quotation marks (" "). newCommunityName The new name that you want to give to the SNMP community. Enclose the SNMP community name in double quotation marks (" ").
Parameter Description sysLocation The physical location of the system, such as "3rd flr". Enclose the SNMP system location in square brackets([ ]). Update SNMP Trap Destination Description This command turns on or turns off sending authentication failure messages for an SNMP trap destination. Failure occurs when the SNMP agent received a message from an SNMP manager, but the message contained an invalid community name.
Parameters Parameter Description file The file path and the file name to which you want to save the security key. For example, file="C:\Program Files\CLI\sup\seckey.slk" NOTE: You must add a file extension of .slk to the end of the file name. passPhrase A character string that encrypts the security key so that you can store the security key in an external file. Additional Information Your pass phrase must meet these criteria: • The pass phrase must be between eight and 32 characters long.
Sample Script Files 13 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.
set virtualDisk["7"] mediaScanEnabled=false; set virtualDisk["7"] consistencyCheckEnabled=false; set virtualDisk["7"] modificationPriority=high; This example shows blank lines between the lines beginning with Show, Create, //Note, and create. The blank lines are included in this example only for clarity. Each command is actually written on one line in the script file; however, the size of this page causes the command text to wrap.
Configuration Script Example 2 This example creates a new virtual disk using the create virtualDisk command with user-defined physical disks in the storage array. Show "Create RAID 5 Virtual Disk 2 on existing Disk Group 2"; //This command creates the disk group and the initial virtual disk on that group.