Dell PowerVault Modular Disk 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. © 2012 Dell Inc.
Contents Notes, Cautions, and Warnings...................................................................................................2 1 About The Command Line Interface......................................................................................15 How To Use The Command Line Interface.............................................................................................................15 Usage Notes..........................................................................................
Snapshot Images And Groups................................................................................................................................49 Snapshot Groups And Snapshot Consistency Groups...........................................................................................50 Snapshot Groups..............................................................................................................................................50 Snapshot Consistency Groups...........................
Re-creating The Snapshot Virtual Disk ...........................................................................................................72 Preparing Host Servers To Re-create A Snapshot Virtual Disk.......................................................................72 Re-creating A Snapshot Virtual Disk................................................................................................................73 6 Using The Virtual Disk Copy Feature...........................................
Removing A Virtual Disk Or Repository Virtual Disk From A Remote Replication Group........................................91 Disabling The Remote Replication Premium Feature.............................................................................................92 Deactivating The Remote Replication Premium Feature........................................................................................92 Interaction With Other Premium Features..............................................................
Monitoring Performance................................................................................................................................110 Changing RAID Levels....................................................................................................................................111 Changing Segment Size.................................................................................................................................111 Defragmenting A Disk Group......................
Activate Remote Replication Feature...................................................................................................................129 Activate Storage Array Firmware.........................................................................................................................132 Add Member To Consistency Group.....................................................................................................................132 Add Physical Disks To SSD Cache...................
Create Remote Replication Group........................................................................................................................176 Create Snapshot Group........................................................................................................................................179 Create Snapshot Image........................................................................................................................................
Establish Remote Replicated Pair.........................................................................................................................218 Increase Virtual Disk Capacity On A Disk Pool.....................................................................................................219 Load Storage Array DBM Database.....................................................................................................................220 Modify Disk Pool.....................................
Save RAID Controller Module NVSRAM...............................................................................................................251 Save Remote Replication Group Statistics...........................................................................................................251 Save Storage Array Configuration........................................................................................................................253 Save Storage Array Core Dump............................
Set Snapshot Virtual Disk Media Scan.................................................................................................................294 Set Snapshot Virtual Disk Repository Virtual Disk Capacity.................................................................................294 Set Storage Array.................................................................................................................................................295 Set Storage Array Enclosure Positions.............
Show Storage Array DBM Database....................................................................................................................338 Show Storage Array Host Topology.....................................................................................................................338 Show Storage Array LUN Mappings....................................................................................................................338 Show Storage Array Negotiation Defaults..................
Stop Disk Group Blink...........................................................................................................................................364 Stop Disk Pool Locate...........................................................................................................................................364 Stop Enclosure Blink.............................................................................................................................................
About The Command Line Interface 1 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.
A CLI command consists of the following elements: • The term SMcli • Storage array identifier • Parameters • Script commands The following syntax is the general form of a CLI command: SMcli storageArray parameters script-commands; where, SMcli invokes the command line interface. storageArray is the host name or IP address of the storage array. parameters are the CLI parameters that define the environment and purpose of the command.
Table 1. Command Name Conventions Parameter Definition a|b pipe symbol indicating alternative ("a" or "b") italicized-words terminals [...] (square brackets) zero or one occurrence {...} (curly brackets) zero or more occurrences <...
[-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 • • • eventOnly— Only event information is included in the e-mail. profile— Event and array profile information is included in the e-mail. supportBundle— Event and support bundle information is included in the e-mail. NOTE: You can enter only one information argument each time you execute the command. If you want all of the information, you must run the command three times. -i Use with the -d parameter to display the IP address of the known storage arrays.
Parameter Definition everyEvent. If you set the-I parameter to either profile or supportBundle, this information is included with the e-mails with the frequency specified by the-q parameter. Valid frequency arguments are: • • • • • • everyEvent— Information is returned with every e-mail alert notification. 2— Information is returned no more than once every two hours. 4— Information is returned no more than once every four hours. 8— Information is returned no more than once every eight hours.
Parameter Definition array configuration and the relationship between the devices. Use the configuration file to reconstruct a storage array). -x (lowercase) Use to remove an SNMP trap destination or an e-mail address alert destination. The community is the SNMP community name for the trap, and the host is the IP address or DNS host name of the system to which you want the trap sent. -? Use this parameter to display usage information about the CLI commands.
When an exception occurs while executing a command, the CLI automatically saves the error information to a file named excprpt.txt. The CLI attempts to place excprpt.txt in the directory specified by the system property devmgr.datadir, which by default is the "client/data" directory under the main installation directory in Windows and the /var/opt/SM directory in Linux. If for any reason the CLI cannot place the file in the devmgr.datadir-specified directory, the CLI saves the excprpt.
Status Value Meaning 24 The wrong management station was specified. 25 The command was not available. 26 The device was not in the configuration file. 27 An error occurred while updating the configuration file. 28 An unknown host error occurred. 29 The sender contact information file was not found. 30 The sender contact information file could not be read. 31 The userdata.txt file exists. 32 An invalid -I value in the e-mail alert notification was specified.
This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example. The -e parameter runs the file without checking syntax. Executing an SMcli command without checking syntax enables the file to run more quickly; however, the SMcli command may not execute correctly if the syntax is incorrect. SMcli -n Example -f scriptfile.scr -e This example shows how to run commands in a script file named scriptfile.scr on a storage array named Example.
About The Script Commands 2 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.
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 (such as, specifying the RAID level or availability of a disk group).
Object Type Identifier enclosure Enclosure ID virtualDisk Virtual disk user label or the World Wide Identifier (WWID) for the virtual disk (set command only) virtualDiskCopy Target virtual disk and, optionally, the source virtual disk user labels diskGroup Virtual disk group number Statement data is in the form of attribute=value (such as raidLevel=5), an attribute name (such as batteryInstallDate), or an operation name (such as consistencyCheck).
Command Syntax Description recover object {statement‑data} Re-creates an object from saved configuration data and the statement attributes (similar to the create command). recreate object {statement‑data} Restarts a snapshot operation using an existing snapshot virtual disk. You can change attributes before the operation is restarted. remove object {statement‑data} Removes a relationship from between objects. repair object {statement‑data} Repairs errors found by the check command.
Recurring Syntax create-raid-vol-attr-value-list Syntax Value create-raid-virtual disk-attribute-valuepair {create-raid-virtual disk-attribute-valuepair} create-raid-virtual disk-attribute-value-pair capacity=capacity-spec | owner=(0 | 1) | segmentSize=integer-literal RAID controller module-enclosureId (0–99) slot-id (0–31) port-id (0–127) physical disk-spec enclosureID, slotID physical disk-spec-list physical disk-spec {physical disk-spec} enclosure-id-list enclosureID {enclosureID} hex-li
Recurring Syntax Syntax Value IPV4GatewayIP= ipv4-address | IPV6HopLimit=integer | IPV6NdDetectDuplicateAddress= integer | IPV6NdReachableTime=integer | IPV6NdRetransmitTime=integer | IPV6NdTimeOut=integer | IPV4Priority=integer | IPV6Priority=integer | 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
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 recover-raid-virtual-disk-attr-value-pair owner=(0 | 1) Table 8.
NOTE: The capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its unit of measure. (For example, 10 GB returns an error, but 9 GB does not return an error). Adding Comments To A Script File You can add comments to a script file in three ways: • The script engine interprets as a comment any text typed after two forward slashes (/ /) until an end‑of‑line character is reached.
Configuring A Storage Array 3 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.
Determining What Is On Your Storage Array Even when you create a configuration on a previously unconfigured storage array, you still need to determine the hardware and software features that must be included with the storage array. When you configure a storage array with an existing configuration, you must ensure that your new configuration does not inadvertently alter the existing configuration, unless you are reconfiguring the entire storage array.
profile command, but is constrained to the specific component. (The following commands are not complete commands. For information about a command, see the referenced section next to the command.
Using The Create Virtual Disk Command The create virtualDisk command enables you to create new virtual disks in the storage array in three ways: • Create a new virtual disk while simultaneously creating a new disk group to which you assign the physical disks. • Create a new virtual disk while simultaneously creating a new disk group to which the MD Storage Manager software assigns the physical disks. • Create a new virtual disk in an existing disk group.
NOTE: The capacity parameter returns an error if you specify a value greater than or equal to 10 without a space separating the numeric value and its unit of measure. (For example, 10 GB returns an error, but 10 GB does not return an error). The command in this example automatically creates a new disk group and a virtual disk with the name Engineering_1. The disk group has a RAID level of 5 (RAID 5). The command uses three physical disks to construct the disk group.
The diskGroup parameter is the number of the disk group in which you want to create a new virtual disk. If you do not know the disk group numbers on the storage array, you can use the show allVirtualDisks summary command. This command displays a list of the virtual disks and the disk groups to which the virtual disks belong. The userLabel parameter is the name you want to give to the virtual disk. The virtual disk name can be any combination of alphanumeric characters, hyphens, and underscores.
• Size of each segment on the physical disks After defining these parameters, the MD Storage Manager automatically creates the disk groups, virtual disks, and hot spares. The RAID controller modules assign disk group and virtual disk numbers as they are created. After MD Storage Manager creates the initial configuration, you can use the set virtualDisk command to define virtual disk labels. Before running the autoConfigure storageArray command, run the show storageArray autoConfigure command.
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.
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. View the current alert configuration settings using the following command: SMcli -d -i -s -w -v -S By default, all alert configuration settings are None. The following example shows how to set the mail server IP and the sender address configurations for SMTP alerts: SMcli -m 123.45.67.892 -F MyStorageArrayEvent@MyCompany.com or SMcli -m MyCompany.
the host types with which the RAID controller modules can communicate; it does not return a list of the hosts. The following examples show how to use the defaultHostType parameter and the hostTypeTable parameter: client>smcli 123.45.67.89 -c "show storageArray defaultHostType;" client>smcli 123.45.67.89 -c "show storageArray hostTypeTable;" The following example shows how to define a specific default host type: client>smcli 123.45.67.
1. Identify the location of the physical disks by enclosure ID and slot ID. 2. Set the hotSpare parameter to TRUE to enable the hot spare or FALSE to disable an existing hot spare. The following syntax is the general form of the command: set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID0,slotID0 ... enclosureIDn,slotIDn] hotSpare=(TRUE | FALSE) The following example shows how to use this command to set hot spare physical disks: client>smcli 123.45.67.
5. Click OK. Configuring Alert Notifications You can use the Configure Alerts dialog box to set up an email alert notification in the event of an error on the network. Alert emails are sent to the specified global mail server and sender email addresses in the event of an error on the selected hosts of storage arrays. You can choose to be alerted to all problems or individual problems. 1.
Using The Snapshot Feature 4 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.
• 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. You can set up a schedule for a snapshot group to automatically create a snapshot image at a specific time in the future or on a regular basis.
• Snapshots created using the Snapshot Virtual Disk (Legacy) premium feature cannot be included in a consistency group. • A base virtual disk can reside on either a disk group or disk pool. Understanding Snapshot Repositories Repositories are system-created virtual disks used to hold write data for snapshots, snapshot groups and consistency groups. During creation of either group or write-enabled snapshot virtual disk, an associated repository is automatically created.
repositoryVirtualDisk="repos_XXXX" [repositoryFullPolicy=(failBaseWrites | purgeSnapImages) | rollbackPriority=(high | highest | medium | low | lowest)| repositoryFullLimit=percentValue | autoDeleteLimit=numberOfSnapImages] • If you attempt to create a snapshot image and either of the two conditions below are present, the creation might fail: – The base virtual disk that contains this snapshot image is a member of a Remote Replication group. – The base virtual disk is currently synchronizing.
Unique command syntax and naming rules apply. The name of a snapshot image has two parts separated by a colon (:): • identifier of the snapshot group • identifier of the snapshot image If you do not specify the repositoryVirtualDiskType or readOnly parameters, the repositories for the consistency group snapshot virtual disk will be selected automatically. If the disk group or disk pool where the base virtual disk resides does not have enough space, the command will fail.
where, consistencyGroup is the name of the consistency group for which you are creating snapshot images. Deleting A Snapshot Virtual Disk Or A Consistency Group Snapshot Virtual Disk You can use the following command to delete a snapshot virtual disk or a consistency group snapshot virtual disk. Optionally, you can also delete the repository members. delete cgSnapVirtualDisk ["snapVirtualDiskName"] [deleteRepositoryMembers=(TRUE | FALSE)]; where, snapVirtualDiskName is the snapshot you want to delete.
• Create Consistency Group Starting, Stopping And Resuming A Snapshot Rollback The command line interface allows you to: • start a rollback operation from multiple snapshot images concurrently • stop a rollback operation • resume a rollback operation When rolling back, the host will have immediate access to the new-rolled-back base virtual disk, but the existing base virtual disk will not allow the host read-write access once the rollback is initiated.
– The base virtual disk is currently in a synchronizing operation. The snapshot image creation completes as soon as the synchronization operation is complete.
This action frees repository capacity so it can be used to satisfy ongoing copy-on-write requirements for the remaining snapshot images. For other values, see Create Consistency Group. 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.
The oldest snapshot images in the snapshot group until the maximum number of images defined with the parameter is met. Deleting snapshot images frees repository capacity so it can be used to satisfy ongoing copy-on-write requirements for the remaining snapshot images. Adding A Member Virtual Disk To A Consistency Group To add a new base virtual disk to an existing consistency group, specify an existing repository virtual disk for the new consistency group member or create a new repository virtual disk.
To remove CGGroup_1, as well as all repository virtual disks: set consistencyGroup ["CGGroup_1"] removeCGMemberVirtualDisk=" payroll_backup" deleteRepositoryMembers=TRUE; Or omit the deleteRepositoryMembers parameter, which invokes the default value of preserving repository virtual disks: set consistencyGroup ["CGGroup_1"] removeCGMemberVirtualDisk=" payroll_backup"; Changing The Pre-read Consistency Check Setting Of An Overall Repository Virtual Disk Use the Pre-Read Consistency Check option to define a s
preReadConsistencyCheck The setting to turn on or turn off preread consistency checking. Turning on preread consistency checking verifies the consistency of RAID redundancy data for the stripes containing the read data. Preread consistency checking is performed on read operations only. To turn on preread consistency checking, set this parameter to TRUE. To turn off preread consistency checking, set this parameter to FALSE.
To decrease capacity, replace increaseRepositoryCapacity with decreaseRepository: set snapVirtualDisk ["snapVirtualDiskName"] decreaseRepositoryCapacity count=numberOfVirtualDisks Setting Snapshot Group Repository Virtual Disk Capacity To increase or decrease capacity of a snapshot group repository virtual disk, use the same basic command syntax as shown previously for the virtual disk repository, except use the set snapGroup command and supply the snapshot group name: set snapGroup ["snapGroupName"] incre
Using The Snapshot (Legacy) 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 (legacy) premium feature. If you are using the Snapshot Virtual Disk using PiT groups, see Using The Snapshot Feature.
Table 9. Snapshot Virtual Disk Components Component Description Source virtual disk Standard virtual disk from which the snapshot is created Snapshot virtual disk Point-in-time image of a standard virtual disk Snapshot repository virtual disk Virtual disk that contains snapshot metadata and copy-onwrite data for a particular snapshot virtual disk The following table lists the snapshot virtual disk commands and brief descriptions of what the commands do. Table 10.
• Define a disk group in which the snapshot repository virtual disk resides. Optionally define the capacity of the repository virtual disk. • Define the number of physical disks, but not specific physical disks, for the repository virtual disk. When using the create snapshotVirtualDisk command to create a snapshot virtual disk, the standard virtual disk name for the source virtual disk is the minimum information required.
1. Stop all I/O activity to the source. 2. Using your Windows system, flush the cache to the source. At the host prompt, type SMrepassist -f and press . See "SMrepassist Utility" in the Owner’s Manual for more information. 3. Remove the drive letter(s) of the source in Windows or unmount the virtual drive(s) in Linux to help guarantee a stable copy of the drive for the Snapshot.
See step 1 through step 4 in the preceding section, Preparing Host Servers To Create An Initial Snapshot Virtual Disk. The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDisks=(1,1 1,2 1,3 1,4 1,5); A minimal version of this command might look like the following example: client>smcli 123.45.67.
The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryDiskGroup=2 freeCapacityArea=2; Creating A Snapshot Virtual Disk By Specifying A Number Of Physical Disks With this version of the create snapshotVirtualDisk command, you must specify the number of physical disks and the RAID level for the snapshot repository virtual disk. This version of the create snapshotVirtualDisk command creates a new disk group.
Table 11. Snapshot Virtual Disk Parameters Parameter Description physicalDiskType Specifies the type of physical disk to use for the snapshot repository virtual disk. The type must be specified as Serial Attached SCSI (SAS). This parameter works only with the count-based repository method of defining a snapshot virtual disk. repositoryDiskGroup Specifies the disk group in which to build the snapshot virtual disk.
Parameter Description fail writes to the source virtual disk (failSourceWrites) or fail writes to the snapshot virtual disk (failSnapShot). The default value is failSnapShot. enableSchedule Turns on or off the ability to schedule a snapshot operation. To turn on snapshot scheduling, set the parameter to TRUE. To turn off snapshot scheduling, set the parameter to FALSE.
in quotation marks. The character string cannot contain a new line. Make sure that you use unique names or the RAID controller module firmware returns an error. One technique for naming the snapshot virtual disk and the repository virtual disk is to add a hyphenated suffix to the original name of the source virtual disk. The suffix distinguishes between the snapshot virtual disk and the repository virtual disk.
virtualDisk command to stop the copy‑on‑write operations. When you stop a snapshot virtual disk, the snapshot virtual disk and the repository virtual disk are still defined for the source virtual disk; only copy-on-write has stopped. The following example stops a snapshot virtual disk: client>smcli 123.45.67.
Re-creating A Snapshot Virtual Disk After first preparing the host server(s) as specified in the preceding procedure, use the following examples to re-create a virtual disk snapshot. Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Re-create A Snapshot Virtual Disk. The following example shows the command to restart a snapshot virtual disk: client>smcli 123.45.67.
Using The Virtual Disk Copy Feature 6 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 online help, the Deployment Guide, the MD Storage Manager online help, and the Administrator's Guide.
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.
1. Enable the Virtual Disk Copy feature. 2. Determine candidates for a virtual disk copy. 3. Create the target virtual disk and source virtual disk for a virtual disk copy. Enabling The Virtual Disk Copy Feature The first step in creating a virtual disk copy is to make sure the feature is enabled on the storage array. You need a feature key to enable the feature.
1. Stop all I/O activity to the source and target virtual disk. 2. Using your Windows system, flush the cache to both the source and the target virtual disk (if mounted). At the host prompt, type SMrepassist -f and press . See "SMrepassist Utility" in the Owner’s Manual for more information. 3.
Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Create A Virtual Disk Copy. The following example is the script file version of the command: create virtualDiskcopy source="Jaba_Hut" target= "Obi_1" copyPriority=medium targetreadonlyenabled=true; After the virtual disk copy operation is completed, the target virtual disk automatically becomes read-only to the hosts. Any write requests to the target virtual disk are rejected, unless you disable the read-only attribute.
• After the virtual disk copy has completed re-creating a virtual disk copy using the recopy virtualDiskCopy command When you create a virtual disk copy pair and after the original virtual disk copy has completed, the target virtual disk is automatically defined as read-only to the hosts. The read-only status of the target virtual disk ensures that the copied data on the target virtual disk is not corrupted by additional writes to the target virtual disk after the virtual disk copy is created.
Preparing Host Servers To Recopy A Virtual Disk 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.
Refer to steps 1 through 4 in the preceding section, Preparing Host Servers To Recopy A Virtual Disk. The following example is the script file version of the command: recopy virtualDiskCopy target ["Obi_1"] copyPriority=highest; Stopping A Virtual Disk Copy The stop virtualDiskCopy command enables you to stop a virtual disk copy that has a status of In Progress, Pending, or Failed.
About Snapshot (Legacy) Premium Features With Virtual Disk Copy • A source virtual disk for a virtual disk copy can be a standard virtual disk or a thin virtual disk (if supported in your firmware version). • A target virtual disk can be a standard virtual disk in a disk group or disk pool, or a snapshot (legacy) base virtual disk if the snapshot (legacy) premium feature is the only snapshot premium feature enabled on your storage array.
7 Using The Remote Replication Premium Feature 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).
completes, the system uses the point-in-time images on the secondary virtual disk to ensure that the data is maintained in a consistent state during subsequent synchronization operations to the secondary virtual disk. Replication Pairs And Replication Repositories Replicated pairs, comprising of a primary and secondary virtual disk, contain identical data copies as a result of data synchronization.
corrected (the secondary virtual disk is placed online or recovered to an Optimal status), then synchronization is required. The replicated pair then transitions to a Synchronization in Progress status. Resynchronization Data replication between the primary virtual disk and the secondary virtual disk in a replication relationship is managed by the RAID controller modules and is transparent to host machines and applications.
Remote Replication Requirements And Restrictions To use the standard Remote Replication premium feature, you must have: • Two storage arrays with write access and both these storage arrays must have sufficient space to replicate data between them. • Each storage must have a dual-controller Fibre Channel or iSCSI configuration (single-controller configurations are not supported).
In this command, asyncReplication is literal and is appended with the activation_key, which is provided by Dell. For example, if your activation key value is 999999: enable storageArray feature file="asyncReplication999999" Activating The Remote Replication Premium Feature Activating the Remote Replication premium feature prepares the storage arrays to create and configure replication relationships.
Changing Remote Replication Group Settings The set asyncRemoteReplicationGroup command lets you change settings for an existing replication group. The following parameters set synchronization and warning threshold values for the replication group. Changing the synchronization settings affects the synchronization operations of all replicated pairs within the remote replication group.
Suspending A Remote Replication Group Use the asyncRemoteReplicationGroup command to stop data transfer between a primary virtual disk and a secondary virtual disk in a replication relationship without disabling the replication relationship. Suspending a replication relationship group lets you control when the data on the primary virtual disk and data on the secondary virtual disk are synchronized.
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 synchronization statistics for member virtual disks to relative 0. show asyncRemoteReplicationGroup synchronizationProgress Shows progress of periodic synchronization of the replication group as a percentage. show asyncRemoteReplicationGroup summary Shows configuration information for one or more replication groups.
8 Using The Remote Replication (Legacy) Premium Feature 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.
In the event of a disaster or a catastrophic failure at the primary site, you can perform a role reversal to promote the secondary virtual disk to a primary role. Hosts then are able to read from and write to the newly promoted virtual disk, and business operations can continue.
Synchronous Write Mode Synchronous write mode provides the highest level security for full data recovery from the secondary storage array in the event of a disaster. Synchronous write mode does reduce host I/O performance. When this write mode is selected, host write requests are written to the primary virtual disk and then copied to the secondary virtual disk.
Resynchronization Data replication between the primary virtual disk and the secondary virtual disk in a replication relationship is managed by the RAID controller modules and is transparent to host machines and applications. When the RAID controller module owner of the primary virtual disk receives a write request from a host, the RAID controller module first logs information about the write to a replication repository virtual disk.
– • • A full synchronization at the lowest synchronization priority level takes approximately eight times as long as a full synchronization at the highest synchronization priority level. – A full synchronization at the low synchronization priority level takes approximately six times as long as a full synchronization at the highest synchronization priority level.
The activate storageArray feature=remoteReplication command provides three methods for defining the physical disks for your replication repository virtual disk: • • • You define each physical disk for the replication repository virtual disk by its enclosure ID and its slot ID. You define a disk group in which the replication repository virtual disk resides. You can optionally define the capacity of the replication repository virtual disk.
This example shows how to use the command in a script file: activate storageArray feature=remoteReplication repositoryDiskGroup=2 freeCapacityArea=2; Activating The Remote Replication (Legacy) Premium Feature By Specifying A Number Of Physical Disks With this version of the activate storageArray feature= remoteReplication command, you must specify the number of physical disks and the RAID level that you want for the replication repository virtual disk. This version of the command creates a new disk group.
The command takes this form: create remoteReplication primary=“primaryVirtualDiskName” secondary=“secondaryVirtualDiskName” (remoteStorageArrayName=“storageArrayName” | remoteStorageArrayWwn=“wwID”) remotePassword=password syncPriority=(highest | high | medium | low | lowest) writeOrder=(preserved | notPreserved) writeMode=(synchronous | asynchronous) NOTE: You can use the optional parameters as needed to help define your configuration. This example shows the create remoteReplication command: c:\...
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: resume remoteReplication virtualDisk Jan_04_Account writeConsistency=false; Removing A Replication Relationship Use the remove remoteReplication command to remove the link between a primary virtual disk and a secondary virtual disk. (Removing a replication relationship is similar to deleting a replication relationship.
Interaction With Other Premium Features You can run the Remote Replication (legacy) premium feature while running these premium features: • Snapshot—both standard Snapshot and Snapshot (legacy) premium features • Virtual Disk Copy When you run the Remote Replication (legacy) premium feature with other premium features, you must consider the requirements of the other premium features to ensure that you set up a stable storage array configuration.
Storage Partitioning Storage partitioning enables hosts to share access to virtual disks in a storage array. You create a storage partition when you define the following storage array assignments: • A host • A host group • Virtual disk-to-logical unit number (LUN) mapping The virtual disk-to-LUN mapping enables you to define which host group or host has access to a particular virtual disk in the storage array.
Maintaining A Storage Array 9 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.
Consistency mismatches Consistency errors are found, and a media error is forced on the block stripe so that it is found when the physical disk is scanned again. If consistency is repaired, this forced media error is removed. The result of this action is that the first ten consistency mismatches found on a virtual disk are reported to the MEL. Unfixable error The data could not be read and consistency information could not be used to regenerate it.
...
To clear persistent virtual disk reservations, run the following command: clear (allVirtualDisks | virtualDisk[virtualDiskName] | virtualDisks [virtualDiskName1" ... "virtualDiskNameN])reservations Synchronizing RAID Controller Module Clocks To synchronize the clocks on both RAID controller modules in a storage array with the host clock, run the following command: set storageArray time Locating Physical Disks At times, you might need to locate a specific physical disk.
Type of Information Description Current KB/second Current transfer rate in kilobytes per second (current means the number of kilobytes per second since the last time the polling interval elapsed, causing an update to occur) Maximum KB/second Highest data transfer value achieved in the current kilobyte-per-second statistic block Current IO/second Current number of I/Os per second (current means the number of I/Os per second since the last time the polling interval elapsed, causing an update to occur)
Defragmenting A Disk Group When you defragment a disk group, you consolidate the free capacity in the disk group into one contiguous area. Defragmentation does not change the way in which the data is stored on the virtual disks. As an example, consider a disk group with five virtual disks.
The ssdCacheName parameter names the cache group. Setting the updateExistingVirtualDisks parameter to TRUE enables SSD caching for all virtual disks in the storage array. The following restrictions apply: • A storage array can have only one SSD cache. • Only virtual disks created using physical disks can use the SSD cache. You cannot enable SSD cache on snapshot (legacy) virtual disks or snapshot images. • SSD caching does not support self-encrypting disks (SEDs).
The following additional SSD cache-related commands are available in this document: • Change SSD Cache Application Type • Blink SSD Cache • Rename SSD Cache • Resume SSD Cache • Show SSD Cache • Suspend SSD Cache Troubleshooting and Diagnostics If a storage array exhibits abnormal operation or failures, you can use the commands described in this section to determine the cause of the problems.
The test results contain a generic, overall status message and a set of specific test results. Each test result contains the following information: • Test (read/write/data loopback) • Port (read/write) • Level (internal/external) • Status (pass/fail) Events are written to the MEL when diagnostics are started and when testing is completed. These events help you to evaluate whether diagnostics testing was successful or failed and the reason for the failure.
Changing RAID Controller Module Ownership You can change which RAID controller module owns a virtual disk by using the set virtualDisk command. The following syntax is the general form of the command: set (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1 ... virtualDiskNameN] | virtualDisk owner=(0 | 1) Initializing A Physical Disk CAUTION: When you initialize a physical disk, all data on the physical disk is lost.
where, virtualDiskName is the identifier for the virtual disk. NOTE: Initializing a thin virtual disk may take an extremely long time. Redistributing Virtual Disks Redistributing virtual disks returns the virtual disks to their preferred RAID controller module owners. The preferred RAID controller module ownership of a virtual disk or disk group is the RAID controller module of an active-active pair that is designated to own the virtual disks.
Script Commands 10 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.
• You must enter spaces in the commands as they are shown in the command descriptions. • Brackets are used in two ways: – As part of the command syntax – To indicate which parameters are optional The description of each parameter tells you when you must put brackets around a parameter value. • Parentheses shown in the command syntax enclose specific choices for a parameter. That is, if you want to use the parameter, you must use one of the values shown in the parentheses.
For Linux, and when used in a script file, the name appears as the following: ["Engineering"] When you enter the World Wide Identifier (WWID) of an HBA host port, some usages require quotation marks around the WWID. In other uses, you must put angle brackets (< >) around the WWID. The description of the WWID parameter tells you if you must put quotation marks or angle brackets around the WWID. • Script commands must end with a semicolon (;).
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 Host Set Host Group Set Host Channel Set Host Port Set iSCSI Initiator Set iSCSI Target Properties Show Host Ports iSCSI Commands Create iSCSI Initiator Delete iSCSI Initiator Reset Storage Array iSCSI Baseline Save Storage Array iSCSI Statistics Set iSCSI Initiator Set iSCSI Target Properties Show Current iSCSI Sessions Show Storage Array Ne
Set Physical Disk Hot Spare Set Physical Disk Channel Status Set Physical Disk State Show Physical Disk Show Physical Disk Channel Statistics Show Physical Disk Download Progress Start Physical Disk Blink Start Physical Disk Initialize Start Physical Disk Channel Blink Start Physical Disk Channel Fault Isolation Diagnostics Start Physical Disk Reconstruction Start Remote Replication Synchronization Stop Physical Disk Blink Stop physical disk channel blink Stop Physical Disk Channel Fault Isolation Diagnosti
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 Replication Repository Virtual Disk Remove Incomplete Remote Replicated Pair from Remote Replication Group Remove Remote Replication Remove Virtual Disk from Remote Replication Group Reset iSCSI IP Address Reset Remote Rep
Re-Create Snapshot Set Snapshot Virtual Disk Stop Snapshot SSD Cache Commands Add Physical Disks to SSD Cache Change SSD Cache Application Type Create SSD Cache Delete SSD Cache Enable or Disable SSD Cache for a Virtual Disk Blink SSD Cache Remove Physical Disks from SSD Cache Rename SSD Cache 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 Autoconfigu
Save Storage Array Performance Statistics 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 Discover
Show Virtual Disk Performance Statistics Show Virtual Disk Reservations Start Virtual Disk Initialization Virtual Disk Copy Commands Create Virtual Disk Copy Recopy Virtual Disk Copy Remove Virtual Disk Copy Set Virtual Disk Copy Show Virtual Disk Copy Show Virtual Disk Copy Source Candidates Show Virtual Disk Copy Target Candidates Stop Virtual Disk Copy 127
Commands Listed Alphabetically 11 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.
Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 1, 5, or 6. repositoryPhysicalDisks The physical disk for the replication repository virtual disk. For high capacity physical disk enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each physical disk that you assign to the replication repository virtual disk.
Parameter Description example, a disk group might have the following areas: virtual disk 1, free capacity, virtual disk 2, free capacity, virtual disk 3, free capacity. To use the free capacity following virtual disk 2, you would specify: freeCapacityArea=2 Run the show diskGroup command to determine if a free capacity area exists. repositoryPhysicalDiskCount The number of unassigned physical disks that you want to use for the replication repository virtual disk.
Activate Storage Array Firmware Description This command activates firmware previously downloaded to the pending configuration area in the RAID controller modules in the storage array. Syntax activate storageArray firmware Parameters None Add Member To Consistency Group Description This command adds a new base virtual disk as a member to a an existing consistency group. You can specify an existing repository virtual disk for the new consistency group member, or create a new repository virtual disk.
Parameters Parameter Description consistencyGroup The name of the consistency group to which you want to add a new member virtual disk. The new member virtual disk is the base virtual disk for snapshot operations. Enclose the consistency group name in double quotation marks (" ") inside square brackets ([ ]). addCGMemberVirtualDisk The name of a base virtual disk that you want to add. Enclose the virtual disk name in square brackets ([ ]).
• You can reuse an existing repository virtual disk if that repository virtual disk is empty and is not related to another member virtual disk. You might want to do this if you want to maintain a particular sequence or relationship for the repository virtual disks. To reuse an existing, empty repository virtual disk you need to know the name of the repository virtual disk. To determine the name of the repository virtual disk, use the show allVirtualDisks summary command.
Parameter Description Enclosure ID values are 0 to 99. Drawer ID values are 0 to 4. Slot ID values are 0 to 31. Enclose the enclosure ID values, the drawer ID values, and the slot ID values in parentheses. Notes The SSD cache can contain any number of SSDs. The maximum size of the SSD cache is 5 TB, but might be less depending on the size of the RAID controller module’s primary cache.
Parameter Description • • Use an existing repository virtual disk name. Create a new repository virtual disk when you run this command. The name of an existing repository virtual disk is comprised of two parts: • • The term repos. A four digit numerical identifier that you assign to the repository virtual disk name. Enclose the name of the existing repository virtual disk in double quotation marks (" ").
Syntax autoConfigure storageArray physicalDiskType=(SAS) raidLevel=(0 | 1 | 5 | 6) diskGroupWidth=numberOfPhysicalDisks diskGroupCount=numberOfDiskGroups virtualDisksPerGroupCount=numberOfVirtualDisksPerGroup hotSpareCount=numberOfHotSpares segmentSize=segmentSizeValue cacheReadPrefetch=(TRUE | FALSE) securityType=(none | capable | enabled)] Parameters Parameter Description physicalDiskType Type of physical disks to use for the storage array. Valid physical disk type is Serial Attached SCSI (SAS).
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.
Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to locate. 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. Cancel Remote Replication Group Role Reversal Description This command cancels a pending role reversal operation between remote replication groups.
Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache for which you want to change the application type. 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. usageHint The values are based on the typical I/O usage pattern of the application that is using the SSD cache.
Check Remote Replication Group Consistency Description This command applies to a remote replication group that has underlying repository virtual disks. The command produces a report based on analysis of the data in the repository.
virtualDiskCopy target[targetName] repositoryConsistency | localVirtualDisk="localVirtualDiskName"] file="filePath" Parameters Parameter Description repositoryConsistency Specifies that the snapshot group, snapshot virtual disk, or virtual disk (depending on which is specified by the corresponding parameter) is checked for consistency. snapGroup The alphanumeric identifier (including - and _) of the snapshot group on which to run a consistency check.
NOTE: Connectivity is tested using all possible channels, and if it is a dual RAID controller module configuration, connectivity is checked from each RAID controller module. It might take up to 20 minutes to check connectivity between two storage arrays. Syntax check storageArray connectivity (remoteStorageArrayName="storageArrayName" | remoteStorageArrayWwid= Parameters Parameter Description remoteStorageArrayName The name for the remote storage array for which you are checking connectivity.
Parameters Parameter Description virtualDisk Name of the specific virtual disk to check consistency. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. consistencyErrorFile Name of the file in which to save the consistency error information. You must put quotation marks (" ") around the file name. mediaErrorFile Name of the file in which to save the media error information.
Clear Remote Replication Fault Description This command clears a remote replication "sticky" fault from one or more remote replication groups and one or more remote replication group member virtual disks. A remote replication group and its member virtual disks can encounter remote replication "sticky" faults, which occur at a single point-in-time but do not impact the functionality of the replications. These type of faults must be reviewed, but do not require any changes to the configuration.
Parameter Description remote replication fault. Enclose the member 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 (" ") inside square brackets. If the virtual disk name consists only of numbers, such as "1002," you also must enclose the virtual disk name in double quotation marks (" ") inside square brackets.
Parameter Description all The setting to remove the entire configuration of the storage array, including security and identity information. Removing all configuration information returns the storage array to its initial state. diskGroups The setting to remove the virtual disk configuration and the disk group configuration. The rest of the configuration stays intact. NOTE: When you run this command, the storage array becomes unresponsive, and all script processing is cancelled.
Syntax clear storageArray eventLog Parameters None. Clear Storage Array Firmware Pending Area Description This command deletes a previously downloaded firmware image or nonvolatile static random access memory (NVSRAM) values from the pending area buffer. CAUTION: As soon as you run this command, the contents of the existing pending area in the storage array are deleted. Syntax clear storageArray firmwarePendingArea Parameters None.
Clear Virtual Disk Reservations Description This command clears persistent virtual disk reservations. Syntax clear (allVirtualDisks | virtualDisk [virtualDiskName] | virtualDisks [virtualDiskName1... virtualDiskNameN]) reservations Parameters Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array. virtualDisk or virtualDisks Name of the specific virtual disk for which to clear reservations. You can enter more than one virtual disk name.
Parameters Parameter Description allVirtualDisks Clears unreadable sector information from all of the virtual disks in the storage array. virtualDisk or virtualDisks The name of the specific virtual disk for which you want to clear unreadable sector information. You can enter more than one virtual disk 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 (“ ”).
Convert Snapshot (Legacy) Virtual Disk To Snapshot Group Description This command migrates a snapshot (legacy) virtual disk to a snapshot group and converts an existing snapshot (legacy) repository virtual disk to a snapshot image repository virtual disk. A maximum of four snapshots (legacy) can be converted to a snapshot group. None of the snapshots (legacy) can be in a disabled state or involved in an in-progress virtual disk copy operation.
Parameters Parameter Description userLabel The name of the new consistency group that you want to create. Enclose the new consistency group name in double quotation marks (" "). repositoryFullPolicy How you want snapshot processing to continue if the snapshot repository virtual disks are full. You can choose to fail writes to the base virtual disk (failBaseWrites) or delete (purge) the snapshot images (purgeSnapImages). The default action is purgeSnapImages.
Notes A consistency group is a logical entity that enables you to manage in batch form all of the snapshot images that you add to the collection. The consistency group is a collection of snapshot groups that have mutual consistency requirements or dependencies for their snapshot images. Any snapshot images that you create and use for this collection must be managed in accordance with the consistency dependencies.
completed successfully for all of the consistency group members, the operation fails and new snapshot images are not created. Normally, all members of a snapshot consistency group will have the same number of snapshot images. When you add a new member to a snapshot consistency group, that new member lacks the snapshot images that were previously created on the established members of the snapshot consistency group. This is not an error condition.
Parameter Description members The identifier of one base virtual disk or more than one base virtual disks that you want to add. The members identifier is comprised of the base virtual disk name concatenated with the repository virtual disk name. You must use a colon (:) between the two names. Enclose all of the member identifiers in parenthesizes. If you enter more than one member separated the members with a space.
• Creating a read/write consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 of only members cgm1 and cgm2: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk2" cgSnapImageID="snapCG1:14214" members=(cgm1:repos_1000 cgm2:repos_1001); • Creating a read-only consistency group snapshot virtual disk on a snapshot consistency group named snapCG1 that has three memebers cgm1, cgm2, and cgm3: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageID="snapCG1:oldes
A host group is an optional topological element that you can define if you want to designate a collection of hosts that share access to the same virtual disks. The host group is a logical entity. Define a host group only if you have two or more hosts that share access to the same virtual disks. Create Disk Group Description This command creates either a free-capacity disk group or a disk group with one virtual disk when you enter a set of assigned physical disks.
Parameter Description • allMedia — Use this option when you want to use all types of physical disk media that are in the expansion enclosure. physicalDiskType The type of physical disk that you want to use in the virtual disk. You cannot mix physical disk types. The valid physical disk type is SAS. You must specify a physical disk type. capacity The 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.
Parameter Description • • 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. Additional Information Cache Read Prefetch 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.
• set storageArray securityKey • start secureErase (physicalDisk | physicalDisks) • enable diskGroup [diskGroupName] security 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. If you set the enclosureLossProtect parameter to TRUE and have selected more than one physical disk from any one enclosure, the storage array returns an error.
Parameters Parameter Description physicalDisks The physical disks you want to assign to the disk pool. Enclosure ID values are 0 to 99; drawer ID values are 0 to 4; slot ID values are 0 to 31. NOTE: A disk pool must contain at least 11 physical disks. physicalDiskType Physical disk type value is sas. Enclose the physical disk type values in parentheses.
Parameter Description physicalDiskMediaType You must use this parameter when you have more than one type of physical disk media in your storage array. Valid physical disk media are: • • • • hdd—Use this option when you have hard disk drives. ssd—Use this option when you have solid state disks. unknown—Use this option if you are not sure what types of physical disk media are in the expansion enclosure.
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 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. securityType The setting to specify the security level when creating the disk groups and all associated virtual disks.
Parameter Description NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Spaces are not allowed. 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. freeCapacityArea Index number of the free space in an existing disk group to use to create the new virtual disk.
Parameter Description before writing data on the next physical disk. Valid values are 8, 16, 32, 64, 128, 256, or 512. For information about the segmentSize parameter, see Using The Auto Configure Command. usageHint The settings for both the cacheReadPrefetch parameter and the segmentSize parameter should be the default values. The default values are based on the typical I/O usage pattern of the application that is using the virtual disk. Valid values are fileSystem, dataBase, or multiMedia.
enclosureLossProtect=(TRUE | FALSE) drawerLossProtect=(TRUE | FALSE) dssPreAllocate=(TRUE | FALSE) securityType=(none | capable | 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 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. Valid RAID controller module identifier values are 0 and 1.
Parameter Description • enabled—The disk group and virtual disks have security enabled. For information about securityType, see Security Type. 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 RAID controller module firmware determines the owner. mapping This parameter enables you to map the virtual disk to a host. If you want to map later, set this parameter to none. If you want to map the virtual disk now, set this parameter to default, and the virtual disk is mapped to all hosts that have access to the storage pool. The default option is none. warningThreshold Valid values are from 1 to 100. The default value is determined by the RAID controller module firmware.
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.
one entity. You create a remote replication group to define the synchronization settings for all replicated pairs within the group. Each replicated pair in a remote replication group share the same synchronization settings, primary and secondary role, and write mode. The remote replication group is associated with the local storage array and remote storage array that is used for replicating.
Parameter Description array must be connected through a proper Fibre Channel fabric or iSCSI interface. remotePassword The password for the remote storage array. Use this parameter when the remote storage array is password protected. Enclose the password in double quotation marks (" "). 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.
Notes • The Remote Replication premium feature must be enabled and activated on the local and remote storage arrays that will be used for replication activities. • You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters. • The local and remote storage arrays must be connected through a Fibre Channel fabric or iSCSI interface. • Passwords are stored on each storage array in a management domain.
Parameter Description repositoryVirtualDisk The name of the repository virtual disk that contains the snapshot group. Enclose the snapshot repository virtual disk name in double quotation marks (" "). The repository virtual disk name is comprised of two parts: • • The term repos A four-digit numerical identifier that you assign to the repository virtual disk name repositoryFullPolicy Defines how snapshot image processing continues if the snapshot image repository virtual disk is full.
• 32 MB to support fixed overhead for the snapshot group and for copy-on-write processing. • Capacity for rollback processing, which is 1/5000th of the capacity of the base virtual disk. The minimum capacity is enforcement by the RAID controller module firmware and the MD storage management software. When a you first create a snapshot group, it does not contains any snapshot images. When you create snapshot images, you add the snapshot images to a snapshot group.
Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. A snapshot image is a logical point-in-time image of the contents of an associated base virtual disk. The snapshot image is created instantly and records the state of the base virtual disk at that moment. Every snapshot image is created in the context of exactly one snapshot group.
enclosureLossProtect=(TRUE | FALSE) userLabel="snapshotVirtualDiskName" warningThresholdPercent=percentValue repositoryPercentOfBase=percentValue repositoryUserLabel="repositoryName" repositoryFullPolicy=(failBaseWrites | failSnapshot) enableSchedule=(TRUE | FALSE) schedule=(immediate | snapshotSchedule)] Syntax (Existing Repository Disk Group) create snapshotVirtualDisk baseVirtualDisk="baseVirtualDiskName" [repositoryDiskGroup="repositoryDiskGroupName" repositoryUserLabel="repositoryName" freeCapacityAre
Parameter Description repository virtual disk. Enclose the name of the repository disk group in double quotation marks (" "). userLabel The name that you want to give to the snapshots (legacy) virtual disk. If you do not want to provide a name, the CLI creates a name using the base virtual disk user label that you provide. enclosureLossProtect The setting to enforce enclosure loss protection when you create the snapshot (legacy) repository virtual disk.
Parameter Description warningThresholdPercent The percentage of repository capacity at which you receive a warning that the snapshot (legacy) 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.
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.
startTime The time of a day you want to create a snapshot (legacy) virtual disk and start performing a copy-on-write operation. The format for entering the time is HH:MM, where HH is the hour and MM is the minute past the hour. Use a 24-hour clock. For example: startTime=14:27, which corresponds to 2:27 PM. scheduleInte rval Amount of time, in minutes, that defines a minimum between two copy-on-write operations.
Syntax create snapVirtualDisk userLabel="snapVirtualDiskName" snapImageID="snapImageID" [repositoryVirtualDisk="repos_xxxx" | repositoryFullLimit=percentValue] Parameters Parameter Description userLabel The alphanumeric identifier (including - and _) 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 the snapshot image.
Parameter Description values, the drawer ID values, and the slot ID values in parentheses. updateExistingVirtualDisks This optional parameter specifies whether the SSD cache should be enabled for all existing virtual disks in the storage array. To enable the SSD cache for all existing virtual disks, set this parameter to TRUE. If you want to enable the SSD cache for individual virtual disks later, set this parameter to FALSE. The default value is TRUE. Notes A storage array can have only one SSD cache.
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. commitSecurityKey This parameter commits the security key identifier to the storage array for all SES drives as well as the controllers. After the security key identifier is committed, a key is required to read data or write data.
Create Virtual Disk Copy Description This command creates a virtual disk copy and starts the virtual disk copy operation. CAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and (if applicable, the target disk) to ensure that you capture an accurate point-in-time image of the source virtual disk. Close all applications, including Windows Internet Explorer, to make sure all I/O activity has stopped.
Parameters Parameter Description source Name of an existing virtual disk to use as the source virtual disk. You must put quotation marks (" ") around the source virtual disk name. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. 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.
Deactivate Remote Replication (Legacy) NOTE: This command valid only with Fibre Channel storage arrays. Description This command deactivates the Remote Replication (legacy) premium feature, disassembles the replication repository virtual disk, and releases the RAID controller module owner of the secondary virtual disk. The RAID controller module host port that is dedicated to the secondary virtual disk is available for host data transfers.
Parameter Description set this parameter to FALSE. The default setting is FALSE. Delete Consistency Group Snapshot Image Description This command deletes the snapshot images in a consistency group. Syntax delete cgSnapImage consistencyGroup="consistencyGroupName" [(deleteCount=numberOfSnapImages | retainCount=numberOfSnapImages) | ignoreSnapVolume=(TRUE | FALSE) Parameter Parameter Description consistencyGroup The name of the consistency group from which you want to delete the snapshot images.
state. A snapshot virtual disk member in the Stopped state no longer has a relationship to the snapshot group of the deleted snapshot image. However, a snapshot virtual disk member in the Stopped state keeps its relationship to its consistency group snapshot virtual disk. Delete Consistency Group Snapshot Virtual Disk Description This command deletes the snapshot virtual disk of a consistency group. You can also delete the repository members.
Delete Disk Pool Description This command deletes a disk pool. Syntax delete diskPool [diskPoolName] 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 (" ").
Delete Host Group Description This command deletes a host group. CAUTION: This command deletes all of the host definitions in the host group. Syntax delete hostGroup [hostGroupName] 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.
Parameter Description NOTE: An HBA host port is a physical connection on a host bus adapter that resides within a host system. An HBA host port provides a host access to the virtual disks in a storage array. If the host bus adapter has only one physical connection (one host port), the terms HBA host port and host bus adapter are synonymous. Example -c "delete host [\"job2900\"];" Delete iSCSI Initiator Description This command deletes a specific iSCSI initiator object.
Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group that you want to delete. Enclose the snapshot group identifier 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 FALSE. To delete the member virtual disks, set this parameter to TRUE. The default value is FALSE.
Parameter Description snapshot group names in double quotation marks (" "). Enclose all of the snapshot group names in parenthesizes. If you do not use any other parameters with the snapGroup parameter or snapGroups parameter, then by default the oldest snapshot image is deleted. deleteCount The number of snapshot images that you want to delete from the snapshot group. Use integer values.
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.
Parameters Parameter Description allVirtualDisks Deletes all virtual disks in a storage array. NOTE: Using the allVirtualDisks parameter deletes virtual disks until all are removed or until an error is encountered. If an error is encountered, this command does not attempt to delete the remaining virtual disks. virtualDisk or virtualDisks Name of the virtual disk to delete. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name.
Parameters Parameter Description allVirtualDisks This parameter deletes all of the virtual disks on a disk pool. virtualDisk or virtualDisks The name of the virtual disk that you want to delete. You can enter more than one virtual disk 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 (" ").
• 1 — Reads the test • 2 — Performs a data loop-back test • 3 — Writes the test The diagnostic tests consist of loop-back tests in which data is written to physical disks and read from the physical disks. Syntax diagnose controller [(0 | 1)] loopbackPhysicalDiskChannel=(allchannels | (1 | 2)) testID=(1 | 2 | 3) [patternFile=”filename”] Parameters Parameter Description controller RAID controller module on which to run the diagnostic tests.
Parameter Description patternFile File path and file name of the file that contains a data pattern to use as test data. Enclose the path and file name with quotation marks (" "). Diagnose RAID Controller Module iSCSI Host Cable Description NOTE: This command valid only for the PowerVault MD3600i storage array. 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.
Notes When you run the cable diagnostic test, the firmware returns the following information: • Port: The port on which the diagnostic test was run. • The date and time the test was run. • RAID Controller Module • Status: – OK: All of the pairs of cables are good and do not have any faults. – Open: One or more of the four pairs of cables are open. – Short: One or more of the four pairs of cables are shorted.
Parameter Parameter Description primary or primaries The name of the primary virtual disk of the remote replication pair to be tested. More than one primary virtual disk name can be entered. Enclose the primary virtual disk names in square brackets ([ ]). If the primary virtual disk name has special characters, the primary virtual disk name must also be enclosed in double quotation marks (“ ”). Disable Storage Array Feature Description This command disables a storage array feature.
NOTE: This command must be run from the command line. It cannot be run in the MD Storage Manager script editor. Syntax supportBundle auto show Parameters None. Display Support Bundle Collection Schedule Description This command displays the schedule for collecting support bundles for all storage arrays. NOTE: This command must be run from the command line. It cannot be run in the MD Storage Manager script editor. Syntax supportBundle schedule show Parameters None.
Parameter Description • • file The allEnclosures parameter, which downloads new firmware to all of the EMMs in the storage array The enclosure parameter, which downloads new firmware to a specific EMM. If you need to download new firmware to more than one EMM, but not all RAID controller modules, you must enter this command for each storage array. File path and file name of the file that contains the firmware image. You must put quotation marks (" ") around the firmware image file path and file name.
Parameters Parameter Description physicalDisk Physical disk to which to download the firmware image. Specify the enclosure ID and slot ID for the physical disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and slot ID value. filename File path and file name of the file that contains the firmware image. You must put quotation marks (" ") around the firmware image file path and file name.
Parameter Description TRUE if you want to download an earlier version of firmware. activateNow Activates the firmware and NVSRAM images. The default value is TRUE. If you set activateNow to FALSE, you must use the activate storageArray firmware command to activate the firmware and NVSRAM values at a later time. Download Storage Array Physical Disk Firmware Description This command downloads firmware images to all of the physical disks in the storage array.
Download Storage Array NVSRAM Description This command downloads NVSRAM values for the storage array RAID controller module. Syntax download storageArray NVSRAM file="filename" Parameter Parameter Description file File path and name of the file that contains the NVSRAM values. Valid file names must end with a .dlp extension. You must put quotation marks (" ") around the file name. Enable Disk Group Security Description This command converts a non-secure disk group to a secure disk group.
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.
Parameters Parameter Description virtualDisk, snapVirtualDisk, or cgSnapVirtualDisk The name of the specific virtual disk for which you want to turn on or off the SSD cache. Enclose the virtual disk name in double quotation marks (" ") inside of square brackets ([ ]). ssdCacheEnabled To turn on SSD cache, set this parameter to TRUE. To turn off SSD cache, set this parameter to FALSE. Notes You can turn the SSD cache on or off for only one virtual disk at a time.
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 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. Enclose the virtual disk name in double quotation marks (" ").
Parameter Parameter Description addPhysicalDisks The setting to add new physical disks to the virtual disk. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for the physical disk. For low-capacity 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 \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. sourceLocation This parameter specifies the location from which to retrieve backup database information.
Syntax set diskPool [diskPoolName] ((addDrives=[enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn] | addCapacity=(addCapacityValue[KB|MB|GB|TB|Bytes])) | owner=(0 | 1)) Parameters Parameter Description addDrives Identifies multiple physical disks to add to the disk pool. Each disk pool must be created from a minimum of 11 physical disks specified.
Parameters Parameter Description target Name of the target virtual disk for which to reinitiate 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 reinitiate a virtual disk copy operation. You must put brackets ([ ]) around the source virtual disk name.
• User-defined disk group • User-defined number of physical disks If you choose to define a number of physical disks, the RAID controller module firmware chooses which physical disks to use for the replication repository virtual disk. Syntax User-Defined Physical Disks recreate storageArray replicationRepository repositoryRAIDLevel=(1 | 5 | 6) repositoryPhysicalDisks=(enclosureID1,slotID1...
Parameter Description repositoryPhysicalDiskCount The number of unassigned physical disks that you want to use for the replication repository virtual disk. enclosureLossProtect The setting to enforce enclosure loss protection when you create the replication repository virtual disk. To enforce enclosure loss protection, set this parameter to TRUE. The default value is FALSE.
Parameters Parameter Description virtualDisk or virtualDisks Name of the specific virtual disk for which to start a fresh copy-on-write operation. You can enter more than one virtual disk name. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. userLabel Name of the snapshot virtual disk. You must put quotation marks (" ") around the snapshot virtual disk name.
• virtual disks are not re-created. If the validation is successful for all of the snapshot virtual disks in the list, but one or more of the snapshots in the list fails to restart, the entire command fails and none of the snapshots are re-created. During snapshot re-creation, all affected virtual disks (snapshots, base, and repository) are appropriately quiesced and I/O operations are resumed to all affected virtual disks after all snapshots have been successfully re-created.
NOTE: Formatting a virtual disk starts a long-running operation that cannot be stopped. Syntax start virtualDisk [virtualDiskName] initialize [existingRepositoryLabel = existingRepositoryName] | [diskPoolUserLabel="diskPoolName" [retainRepositoryMembers = [TRUE|FALSE]] Parameters Parameter Description virtualDisk The name of the virtual disk for which you are starting the formatting. Enclose the virtual disk name in square brackets ([ ]).
Syntax remove asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] incompleteReplication virtualDisk="virtualDiskName" Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group that contains the orphaned virtual disk that you want to remove. Enclose the remote replication group name in double quotation marks (" ").
Remove Physical Disks From SSD Cache Description This command decreases the capacity of the SSD cache by removing Solid State Disks (SSDs). Syntax set ssdCache [ssdCacheName] removePhysicalDisks=(enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn) 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 ([ ]).
Syntax remove remoteReplication (localVirtualDisk [virtualDiskName] | localVirtualDisks [virtualDiskName1... virtualDiskNameN]) Parameter Parameter Description localVirtualDisk or localVirtualDisks The name of the primary virtual disk (the virtual disk on the local storage array) that you want to remove. You can enter more than one virtual disk name. Enclose the virtual disk name in square brackets ([ ]).
Remove Virtual Disk From Remote Replication Group Description This command removes a member virtual disk from an existing remote replication group. Optionally, you can delete the repository virtual disk members from the remote replication group. This command is valid only on the local storage array that contains the remote replication group whose member virtual disk that you want to remove.
Parameters Parameter Description allVirtualDisks Removes the LUN mapping from all virtual disks. virtualDisk or virtualDisks Name of the specific virtual disk to remove from the LUN mapping. You can enter more than one virtual disk name. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets. accessVirtualDisk Removes the access virtual disk.
Parameters Parameter Description snapVirtualDisk The name of the snapshot virtual disk that you want to rename. Enclose the snapshot virtual disk name in double quotation marks (" ") inside of square brackets ([ ]). userLabel A new name that you want to give to the snapshot virtual disk. Enclose the new snapshot virtual disk name in double quotation marks (" "). Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names.
Repair Virtual Disk Consistency Description This command repairs the consistency errors on a virtual disk. Syntax repair virtualDisk [virtualDiskName] consistency consistencyErrorFile="filename" [verbose=(TRUE | FALSE)] Parameters Parameter Description virtualDisk Name of the specific virtual disk for which to repair consistency. You must put brackets ([ ]) around the virtual disk name.
Parameters Parameter Description physicalDisk Specifies the physical disks to assign to the virtual disk that you want to create. Specify the enclosure ID and slot ID for each physical disk that you assign to the virtual disk. Enclosure ID values are 0 to 99. Slot ID values are 0 to 31. You must put brackets ([ ]) around the enclosure ID value and the slot ID value. physicalDisk The World Wide Identifier (WWID) of the physical disk that you want to replace.
Parameters Parameter Description remoteStorageArrayName The name for the remote storage array for which you are resetting the iSCSI IP address. Enclose the storage array name in double quotation marks (" "). remoteStorageArrayNameWwid The World Wide Identifier (WWID) of the storage array for which you are resetting the iSCSI IP address. You can use the WWID instead of the storage array name to identify the storage array. Enclose the WWID in angle brackets (< >).
controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 1, then RAID controller module 0 holds RAID controller module 1 in reset and then releases RAID controller module 1 from reset, which is a hard reboot. A soft reboot in some products only resets the IOC chip. A hard reboot resets both the IOC chip and the expander chips in the RAID controller module.
Parameter Description • errors—Statistics are reset for the most recent 20 failed resynchronization samples. Notes Statistics are reset for replicated virtual disks in the Primary role.
Reset Storage Array iSCSI Baseline Description This command resets the iSCSI baseline for the storage array to 0. Syntax reset storageArray iscsiStatsBaseline Parameters None. NOTE: This command resets the baseline to 0 for both RAID controller modules in the storage array. The purpose of resetting both of the RAID controller module baselines is to help ensure that the counts are synchronized between the RAID controller modules.
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 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. Enclose the snapshot image name in double quotation marks (" ").
Parameter Description name must also be enclosed in double quotation marks (“ ”). writeConsistency The setting to identify the virtual disks in this command that are in a write-consistency group or are separate. For the virtual disks to be in the same write-consistency group, set this parameter to TRUE. For the virtual disks to be separate, set this parameter to FALSE. NOTE: If you set the writeConsistency parameter to TRUE, the virtual disks must be in a write-consistency group (or groups).
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. Syntax resume snapImage [snapImageName] rollback Parameter Parameter Description snapImage The name of the snapshot image for which you want to restart a rollback operation.
cannot be resumed, the selected snapshot (legacy) virtual disk reverts to a paused state, and the Needs Attention condition is displayed. Syntax resume rollback virtualDisk [snapshotVirtualDiskName] Parameter Parameter Description virtualDisk Specifies the name of the snapshot (legacy) virtual disk for which you want to resume a rollback operation. Enclose the snapshot (legacy) virtual disk name in square brackets ([ ]).
Parameter Description • • NEWEST - Use this option when you want to show the latest snapshot image created in the snapshot group. OLDEST - Use this option when you want to show the earliest snapshot image created in the snapshot group. Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]).
Revive Disk Group Description This command forces the specified disk group and associated failed physical disks to the Optimal state. All physical disks assigned to the disk group must be installed before you attempt to run this command. CAUTION: Correct use of this command depends on the data configuration on all of the physical disks in the disk group. Never attempt to revive a physical disk unless supervised by a Customer or Technical Support representative.
Revive Physical Disk Description This command forces the specified physical disk to the optimal state. CAUTION: Correct use of this command depends on the data configuration on all physical disks in the disk group. Never attempt to revive a physical disk unless supervised by a Technical Support representative. Syntax revive physicalDisk [enclosureID,slotID] Parameter Parameter Description physicalDisk Identifies the enclosure and slot where, the physical disk resides. Enclosure ID values are 0 to 99.
Revive Snapshot Virtual Disk Description This command forces a specified snapshot virtual disk to the Optimal state. The snapshot virtual disk can be: • A standalone snapshot virtual disk • A 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. NOTE: You cannot use this command for a snapshot virtual disk that is used in online virtual disk copy.
Save Physical Disk Channel Fault Isolation Diagnostic Status Description This command saves the physical disk channel fault isolation diagnostic data that is returned from the start physical disk channel fault isolation diagnostics command. You can save the diagnostic data to a file as standard text or as XML. See Start Physical Disk Channel Fault Isolation Diagnostics for more information.
Parameter Parameter Description logFile Name of the file to which to write the log sense data. You must put quotation marks (" ") around the file name. Save RAID Controller Module NVSRAM Description This command saves a copy of the RAID controller module NVSRAM values to a file. This command saves all regions. Syntax save controller [(0 | 1)] NVSRAM file="filename" Parameters Parameter Description controller RAID controller module with the NVSRAM values to save.
Syntax save storageArray arvmStats asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] arvmStats file="filename" [virtualDisk="virtualDiskName" sampleType=(all | mostRecent | longestSyncTime | errors) recordLimit=(1-90)] Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you are retrieving synchronization statistics. Enclose the remote replication group name in square brackets ([ ]).
Parameter Description • recordLimit errors—Statistics are recorded for the most recent 20 failed resynchronization samples. These samples include a failure code. This parameter is optional. The default value for record limit is no limit. The recordLimit must be greater than 0 and less than or equal to 90. Notes Statistics are captured for replicated virtual disks in the Primary role.
Parameters Parameter Description file Name of the file that contains the configuration values. You must put quotation marks (" ") around the file name. allConfig Saves all of the configuration values to the file. (If you choose this parameter, all of the configuration parameters are set to TRUE.) globalSettings Saves the global settings to the file. To save the global settings, set this parameter to TRUE. To prevent saving the global settings, set this parameter to FALSE. The default value is TRUE.
Parameter Parameter Description file The file path and the file name to which you save the core dump. Enclose the file name in double quotation marks (" "). For example: file="C:\Array Backups \DBMbackup_03302010.core" Save Storage Array DBM Database Description This command saves the database management (DBM) of the storage array.
Parameter Description • If the parameter is set to all, all data that resides in the database will be retrieved. This includes disk group and disk pool configuration. The default is raidConfiguration. file The file path and the file name to which you want to save the database. Enclose the file name in double quotation marks (" "). For example: file="C:\Program Files \CLI\logs \events.txt". This parameter must appear last, after any of the optional parameters.
Parameter Description example: dbmDatabase="C:\Array Backups \DBMbackup_03302010.dbm". This command does not automatically append a file extension to the saved file. You must specify the .dbm file extension when you enter the file name. Notes If you are generating the XML information file in order to obtain a validator string, you must run this command while you are connected to the controller where you intend to restore the database.
file="filename" [count=numberOfEvents forceSave=(TRUE | FALSE)] Parameters Parameter Description allEvents Saves all events to a file. criticalEvents Saves only critical events to a file. warningEvents Saves only warning events to a file. infoEvents Saves only informational events to a file. debugEvents Saves only debug events to a file. file Specifies name of the file to which to save the events. You must put quotation marks (" ") around the file name.
Parameters Parameter Description raw This parameter defines that the statistics collected are all statistics from the RAID controller module start‑of‑day. Enclose the parameter in square brackets ([ ]). baseline This parameter defines that the statistics collected are all statistics from the time the RAID controller modules were reset to zero using the reset storageArray iscsiStatsBaseline command. Enclose the parameter in square brackets ([ ]).
Save Storage Array SAS PHY Counts Description This command saves the storage array SAS physical layer (SAS PHY) counters to a file. To reset the SAS PHY counters, run the Reset Storage Array SAS PHY Baseline command. See Reset Storage Array SAS PHY Baseline. Syntax save storageArray SASPHYCounts file="filename" Parameters Parameter Description file Specifies the file path and the file name to which you save the SAS PHY counters. Enclose the file path and the file name in double quotation marks (" ").
Support-related information includes: • • • • • • • • • • • • The storage array profile The Major Event Log information The NVSRAM data Current problems and associated recovery information The performance statistics for the entire storage array The persistent registration information and the persistent reservation information Detailed information about the current status of the storage array The diagnostic data for the physical disk A recovery profile for the storage array The unreadable sectors that are d
[startTime=HH:MM] [startDate=MM:DD:YY] [endDate=MM:DD:YY] (daysOfWeek={} | months={} (onDays={} | weekNumber=(First|Second|Third|Fourth|Last) dayOfWeek=(Sunday|Monday|Tuesday| Wednesday|) 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.
Parameter Description wednesday, thursday, friday, saturday, sunday, and all. For example: scheduleDay=wednesday. startTime Defines time of a day you want to create a snapshot virtual disk and start performing a copy-on-write operation. The format for entering the time is HH:MM, where HH is the hour and MM is the minute past the hour. Use a 24-hour clock. For example: startTime=14:27, which corresponds to 2:27 PM.
NOTE: To remove a schedule, use the delete virtualDisk command with the schedule parameter. The delete command with the schedule parameter deletes only the schedule, not the snapshot virtual disk. Ensure that you do not inadvertently delete the virtual disk itself. NOTE: If you also use the scheduleInterval option, the lowest value of the timesPerDay option and the scheduleInterval option is used. The value is determined by calculating an integer value for the scheduleInterval option.
Parameter Description snapshot images for a repository full policy. The default value is 32. rollBackPriority The priority for rollback operations for a consistency group while the storage array is operational. Valid values are highest, high, medium, low, or lowest. Set Consistency Group Snapshot Virtual Disk Description This command creates a unique name for a snapshot virtual disk of a consistency group.
raidLevel=(0 | 1 | 5 | 6) owner=(0 | 1) 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.
• 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. Set Disk Group Forced State Description This command moves a disk group into a Forced state.
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. Set Foreign Physical Disk to Native A physical disk is considered to be native when it is a part of a storage array disk group.
Set Host Description This command assigns a host to a host group or moves a host to a different host group. You can also create a new host group and assign the host to the new host group with this command. The actions performed by this command depend on whether the host has individual mappings or does not have individual mappings.
Host Group Parameter Host Has Individual Virtual Disk-toLUN Mappings Host Does Not Have Individual Virtual Disk-to-LUN Mappings defaultGroup The command fails. The host is removed from the present host group and is placed under the default group. NOTE: When you use this command, you can specify one or more of the optional parameters. You do not, however, need to use all of the parameters. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names.
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. If the host group name has special characters, you must also put quotation marks (" ") around the host group name. userLabel New name for the host group. You must put quotation marks (" ") around the host group name.
Parameter Description userLabel The new name that you want to give to the HBA host port. Enclose the new name of the HBA host port in double quotation marks (" "). NOTE: When you use this command, you can specify one or more of the optional parameters. You do not, however, need to use all of the parameters. NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters.
Syntax set iscsiTarget [“iscsiID”] (authenticationMethod=(none | chap) | chapSecret=”securityKey” | targetAlias=”userLabel”) Parameters Parameter Description iSCSIID The iSCSI target for which you want to set properties. Enclose the name in double quotation marks (“ ”). You must also enclose the iscsi ID in either square brackets ([ ]) or angle brackets (< >). authenticationMethod The means of authenticating your iSCSI session.
Parameter Description 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. Use the degraded parameter if the channel is experiencing problems, and the storage array requires additional time for data transfers.
Syntax set (physicalDisk [enclosureID,slotID] | physicalDisks [enclosureID1,slotID1 enclosureID2, slotID2... enclosureIDn,slotIDn]) operationalState=failed 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 ([ ]).
Parameter Description firmware for the RAID controller module returns a syntax error. availability The mode for the RAID controller module, which you can set to online, offline, or serviceMode (service). ethernetPort The attributes (options) for the management Ethernet ports. The entries to support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, and the subnet mask address.
Syntax Element Statement Data Options for the Ethernet Port Parameter enableIPv4=(TRUE | FALSE) | enableIPv6=(TRUE | FALSE) | IPv6LocalAddress=(0-FFFF):(0-FFFF):(0-FFFF):(0FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF) | IPv6RoutableAddress=(0-FFFF):(0-FFFF):(0FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0-FFFF):(0FFFF) | IPv4Address=(0-255).(0-255).(0-255).(0-255) | IPv4ConfigurationMethod=[(static | dhcp)] | IPv4SubnetMask=(0-255).(0-255).(0-255).
Use the show controller NVSRAM command to show the NVSRAM information. When the duplexMode option is set to TRUE, the selected Ethernet port is set to full duplex. The default value is half duplex (the duplexMode parameter is set to FALSE). To make sure that the IPv4 settings or the IPv6 settings are applied, you must set these iscsiHostPort options: • enableIPV4=TRUE • enableIPV6=TRUE The IPv6 address space is 128 bits. It is represented by eight 16-bit hexadecimal blocks separated by colons.
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 this parameter to secondary. This parameter applies only when the virtual disk is part of a replication relationship. 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 Remote Replication Group Description Use this command to change the synchronization settings and warning thresholds that the RAID controller module owner of the primary side of the remote replication group uses when it performs an initial synchronization or resynchronization. Changing the synchronization settings affects the synchronization operations of all replicated pairs within the remote replication group.
Parameter Description previous update. You can specify the length of time in minutes, hours, or days. NOTE: You must set the Recovery Point Threshold to be twice as large as the synchronization interval threshold. warningThresholdPercent Specify the percent value that determines when a warning is triggered when the capacity of a replication repository virtual disk reaches the defined percentage. Define the threshold by percentage (%) of the capacity remaining.
Parameter Description Enclose the name of the existing repository virtual disk in double quotation marks (" "). If you want to create a new repository virtual disk when you run this command you must enter the name of either a a disk group or a disk pool in which you want the repository virtual disk. Optionally, you also can define the capacity of the repository virtual disk.
element. The capacity of the expandable repository virtual disk is exactly that of the single element. You can increase the capacity of an expandable repository virtual disk by attaching additional standard virtual disks to it. The composite expandable repository virtual disk capacity then becomes the sum of the capacities of all of the concatenated standard virtual disks.
Passwords are stored on each storage array in a management domain. If a password was not previously set, you do not need a password. The password can be any combination of alphanumeric characters with a maximum of 30 characters. (You can define a storage array password by using the set storageArray command.) The polling interval and the number of iterations that you specify remain in effect until you end the session.
Parameter Description snapshot images for a repository full policy. Use integer values. The default value is 32. rollBackPriority Use this parameter to determine whether system resources should be allocated to the rollback operation at the expense of system performance. Valid values are highest, high, medium, low, or lowest. A value of high indicates that the rollback operation is prioritized over all other host I/O.
Parameter Description this parameter to TRUE. To turn off consistency checking, set this parameter to FALSE. 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.
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). Enclose the snapshot virtual disk name in double quotation marks (“ ”) inside of square brackets ([ ]).
Parameter Description 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. You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Names can have a maximum of 30 characters.
Parameter Description 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. 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.
Set Snapshot Virtual Disk Media Scan Description This command runs a media scan on the physical disks used for a snapshot virtual disk. You also can perform a consistency check on the data. Syntax set snapVirtualDisk ["snapVirtualDiskName"] mediaScanEnabled=(TRUE | FALSE) [consistencyCheckEnabled=(TRUE | FALSE)] Parameters Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk for which you are setting properties.
Parameters Parameters Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk for which you are setting properties. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside of square brackets ([ ]). repositoryFullLimit The percentage of repository virtual disk 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.
Parameters Parameter Description autoSupportConfig The setting for automatically collecting support data each time the firmware detects a critical MEL event. This parameter has these values: • • enable—Turns on the collection of support data disable—Turns off the collection of support data cacheBlockSize The cache block size that is used by the RAID controller module for managing the cache. Valid values are 4 (4 KB), 8 (8 KB), 16 (16 KB), or 32 (32 KB).
Additional Information When you use this command, you can specify one or more of the optional parameters. Auto Support Data When enabled, the set storageArray autoSupportConfig command causes all configuration and state information for the storage array to be returned each time a critical Major Event Log (MEL) event is detected. The configuration and state information is returned in the form of an object graph.
NOTE: If you are using self-encrypting disk physical disks in your storage array, you must use these criteria for your storage array password. NOTE: You must set a password for your storage array before you can create a security key for encrypted selfencrypting disk physical disks. Set Storage Array Enclosure Positions Description This command defines the position of the enclosures in a storage array. You must include all of the enclosures in the storage array when you enter this command.
Set Storage Array ICMP Response Description This command returns the default values for negotiable settings for sessions and connections, which represent the starting point for the storage array for negotiations. Syntax set storageArray icmpPingResponse=(TRUE | FALSE) 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.
Syntax set storageArray isnsIPv6Address=ipAddress Parameter Parameter Description isnsIPv6Address The IPv6 address that you want to use for the iSNS server. 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.
Syntax set storageArray learnCycleDate (daysToNextLearnCycle=numberOfDays | day=dayOfTheWeek) time=HH:MM Parameters Parameter Description daysToNextLearnCycle Valid values are 0 through 7, where, 0 is immediately and 7 is in seven days. The daysToNextLearnCycle parameter takes place up to seven days after the next scheduled learn cycle. day Valid values for the day parameter include the days of the week.
Set Storage Array Security Key Description Use this command to set the security key that is used throughout the storage array to implement the Physical Disk Security premium feature. When any security-capable physical disk in the storage array is assigned to a secured disk group, that physical disk is security-enabled using the security key. Before you can set the security key, you must use the create storageArray securityKey command to create the security key.
Set Storage Array Unnamed Discovery Session Description This command enables the storage array to participate in unnamed discovery sessions. Syntax set storageArray unnamedDiscoverySession=(TRUE | FALSE) Parameter Parameter Description unnamedDiscoverySession This parameter turns on or turns off unnamed discovery sessions. Set the parameter to TRUE to turn on unnamed discovery sessions. Set the parameter to FALSE to turn off unnamed discovery sessions.
Parameter Description 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. You can use the WWID instead of the virtual disk name to identify the virtual disk. Enclose the WWID in angle brackets (< >). newCapacity Increase the virtual capacity of the thin virtual disk.
virtualDisks [“virtualDiskName1” ...
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. cacheWithoutBatteryEnabled The setting to turn on or turn off caching without batteries. To turn on caching without batteries, set this parameter to TRUE. To turn off caching without batteries, set this parameter to FALSE.
Parameter Description assign to the virtual disk. Enclosure ID 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.
NOTE: Setting the addCapacity, addPhysicalDisks, or 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 display the progress of long-running operations, use the show virtualDisk actionProgress command. Set Virtual Disk Attributes For A Disk Pool Description This command defines the properties for a virtual disk.
Parameter Description virtualDisk The World Wide Identifier (WWID) of the virtual disk for which you are setting properties. You can use the WWID instead of the virtual disk name to identify the virtual disk. Enclose the WWID in angle brackets (< >). addCapacity The setting to increase the storage size (capacity) of the virtual disk for which you are defining properties. Size is defined in units of bytes, KB, MB, GB, or TB. The default value is bytes. This parameter is not valid for thin virtual disks.
Parameter Description replicationCacheEnabled The setting to turn on or turn off the replication cache. To turn on the replication cache, set this parameter to TRUE. To turn off the replication cache, set this parameter to FALSE. modificationPriority The priority for virtual disk modifications while the storage array is operational. Valid values are highest, high, medium, low, or lowest. preReadConsistencyCheck The setting to turn on or turn off preread consistency checking.
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.
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 ([ ]). The World Wide Identifier (WWID) of the virtual disk for which you are setting properties. You can use the WWID instead of the virtual disk name to identify the virtual disk. Enclose the WWID in angle brackets (< >). accessVirtualDisk The logical unit number for the virtual disk.
Syntax show ((CGSnapImage [(CGSnapImageName | CGSnapImageSequenceNumber)]) | (CGSnapImages [(CGSnapImageNumber1 ... CGSnapImageNumbern | CGSnapImageSequenceNumber1 ... CGSnapImageSequenceNumbern)]) | allCGSnapImages [summary] Parameters Parameter Description cgSnapImage or cgSnapImages The name of the snapshot image in a consistency group. The name of a snapshot image is comprised of two parts: • • The name of the consistency group. An identifier for the snapshot image in the consistency group.
To show the most recent snapshot image in a snapshot consistency group that has the name snapCGroup1, you would use this command: show snapImage ["snapCGroup1:newest"]; To show the snapshot images in several snapshot consistency groups that has the names snapCGroup1, snapCGroup2, and snapCGroup3, you would use this command: show snapImages ["snapCGroup1:12345 snapCGroup2:newest snapCGroup3:oldest"]; Note that in these examples the snapshot consistency group name is separated from the snapshot image identifi
Show Disk Group Description This command returns the following information about a disk group: • Status (online or offline) • Physical disk type (SAS) • Enclosure loss protection (yes or no) • Current owner (RAID controller module 0 or RAID controller module 1) • Associated virtual disks and free capacity • Associated physical disks NOTE: You can use the free capacity area value when you create a virtual disk based on the free capacity of a disk group.
Show Disk Group Import Dependencies Description This command shows a list of dependencies for the physical disks in a disk group that you want to move from one storage array to a second storage array. Syntax show diskGroup [diskGroupName] importDependencies [cancelImport=(TRUE | FALSE)] Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number.
Show Host Ports Description For all HBA host ports connected to a storage array, this command returns the following information: • HBA host port identifier • HBA host port name • HBA host type Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example.
– Enclosure location and slot location – Preferred channel – Redundant channel • Hot spare coverage • Details for each physical disk Depending on the size of the storage array, this information can be several pages long. The physical disk information is also returned when you issue the show storageArray profile command.
Parameter Description NOTE: To determine the type of physical disk in a specific location, use the physicalDisk parameter, and enter the enclosure and slot IDs for the physical disk. 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.
Parameters None. NOTE: When all firmware downloads have successfully completed, this command returns a Successful status. If any firmware downloads fail, this command shows the firmware download status of each targeted physical disk. This command returns the status values shown in the following table. Status Definition Successful Downloads completed without errors. Not Attempted Downloads did not start. Partial Download Downloads are in progress. Failed Downloads completed with errors.
Parameter Description 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. summary Returns a concise list of information about both RAID controller modules in the storage array.
Show Remote Replication Group Description This command displays configuration information for one or more remote replication groups. This command also displays the remote replicated pairs associated with each remote replication group, including incomplete remote replicated pairs. You can also use this command to show the progress of periodic data synchronization on all of the replicated pairs within the remote replication group.
NOTE: There are two types of synchronization: initial synchronization and periodic synchronization. Initial remote replication group synchronization progress is displayed in the Long Running Operations dialog and by executing the show storageArray longRunningOperations command.
Parameters Parameter Description primary The name of the local virtual disk that you want for the primary virtual disk in the remote-replicated pair. Enclose the primary virtual disk name in double quotation marks (“ ”). remoteStorageArrayName The remote storage array that contains possible virtual disks for a secondary virtual disk. If the remote storage array name has special characters, it must be enclosed in double quotation marks (“ ”).
Syntax show (allSnapGroups | snapGroup [snapGroupName] | snapGroups [snapGroupName1 ... snapGroupNamen]) [summary | schedule] Parameters Parameter Description allSnapGroups The parameter to return information about all of the snapshot groups in the storage array. snapGroup or snapGroups The name of the specific snapshot group for which you are retrieving information. Enclose the snapshot group name in square brackets ([ ]).
Associated base volume: 2 Cluster size: 65,536 bytes Repository Total repository volumes: 3 Aggregate repository status: Optimal Total repository capacity: 10.318 GB Used capacity: 0.000 MB (0%) Available repository capacity: 10.
Parameter Description double quotation marks (" ") inside square brackets ([ ]). Separate each snapshot image name with a white space. allSnapImages The parameter to return information about all of the snapshot images in the storage array. summary This parameter returns a concise list of information about the snapshot images. 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.
Parameter Description retrieving information. Enclose the snapshot virtual disk name in square brackets ([ ]). When you enter more than one snapshot virtual disk identifier, separate the identifiers with a space. Enclose all of the identifiers in only one set of square brackets ([ ]). summary The parameter to return a concise list of information about the snapshot virtual disks.
Parameter Description 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 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.
Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache for which you want to get information. 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. RAID controller module Each RAID controller module stores SSD cache metadata for the virtual disks that it owns.
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.
Populate Actions (Host Reads) Blocks Number of blocks in Populate Actions (Host Reads). Populate Actions (Host Writes) Number of host writes where data was copied from the base virtual disk to the SSD cache. Populate Actions (Host Writes) Blocks Number of blocks in Populate Actions (Host Writes). Invalidate Actions Number of times data was invalidated/removed from the SSD cache.
Parameters Parameter Description profile Displays all properties of the logical and physical components that comprise the storage array. The information returned takes several screens to display. NOTE: The profile parameter returns detailed information about the storage array. The information covers several screens on a display. You might need to increase the size of your display buffer to see all the information.
Parameter Description time Displays the current time to which both RAID controller modules in the storage array are set. virtualDiskDistribution Displays the current RAID controller module owner for each virtual disk in the storage array. summary Returns a concise list of information about the storage array configuration. longRunningOperations Shows the long running operations for each disk group and each virtual disk in the storage array.
Parameters Parameter Description physicalDiskType Type of physical disk to use for the storage array. Valid physical disk type is SAS. This parameter is not required if only one type of physical disk is in the storage array. raidLevel RAID level of the disk group that contains the physical disks in the storage array. Valid RAID levels are 0, 1, 5 or 6. diskGroupWidth Number of physical disks in a disk group in the storage array. This number depends on the capacity of the physical disks.
Syntax show storageArray coreDump 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. Syntax show storageArray dbmDatabase Parameters None. Show Storage Array Host Topology Description This command returns the storage partition topology, the host type labels, and the host type index for the host storage array.
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.
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.
NOTE: You must enclose the string in double quotation marks (“ ”). 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 ...
Virtual Disk Physical Capacity Consumned Capacity Quota % Prov. Consumed virtualDiskNam e 500.000 GB 230.000 GB 700.
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 ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (“ ”).
Show Virtual Disk Copy Description This command returns information about virtual disk copy operations. The following information is returned: • Copy status • Start timestamp • Completion timestamp • Copy priority • Source virtual disk WWID or target virtual disk WWID • Read-only attribute setting of the target virtual disk You can retrieve information about a specific virtual disk copy pair or all virtual disk copy pairs in the storage array.
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.0 GB Disk Group: 2 Show Virtual Disk Copy Target Candidates Description This command returns information about the candidate virtual disks that you can use as the target for a virtual disk copy operation.
Parameters Parameter Description allvirtualDisks The setting to return performance statistics about all of the virtual disks in the storage array. virtualDisk or virtualDisks Name of the source virtual disk for which you are trying to find a candidate target virtual disk. You must put quotation marks (" ") and brackets ([ ]) around the source virtual disk name. The source virtual disk name and quotation marks must be inside the brackets.
Parameters None. Notes Upon completion of the diagnostic test, the controller 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\FirmwareUpgradeReports\timestamp_buildNo.zip If the diagnostic test detects an inconsistency in the configuration database, the controller firmware performs these actions: • Returns a description of the inconsistency.
Parameters Parameter Description consistencyGroupName The name of the consistency group for which you want to start 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. memberVirtualDiskSet The name of one or more member base virtual disks in a consistency group that you want to rollback.
Parameters Parameter Description diskGroup Number of the disk group to identify. You must put brackets ([ ]) around the disk group number. Start Disk Group Defragment Description This command starts a defragment operation on the specified disk group. NOTE: Defragmenting a disk group starts a long‑running operation that you cannot stop. Syntax start diskGroup [diskGroupNumber] defragment Parameters Parameter Description diskGroup Number of the disk group to defragment.
Additional Information When this command is successful, you can run the start diskGroup import command to finish moving the disk group to a Complete state, which makes the disk group available to the new storage array. If this command is unsuccessful because hardware problems prevented the completion of the export, use the set diskGroup forceState command. The set diskGroup forceState command lets you use the start diskGroup import command to import a disk group.
Parameters Parameter Description diskPool The alphanumberic identifier of the disk pool (including – and _) that you want to locate. Enclose the diskPoolName in square brackets ([ ]). Start Enclosure Blink Description This command identifies an enclosure by turning on the indicator LED. (Use the stop enclosure blink command to turn off the indicator LED for the enclosure.) Syntax start enclosure [enclosureID] blink Parameters Parameter Description enclosure Identifies the enclosure to blink.
NOTE: This operation ends the iSCSI connections for the portal and brings down the portal temporarily. Start Physical Disk Blink Description This command blinks a physical disk by turning on an indicator light on the physical disk. Run the stop physicalDisk blink command to turn off the indicator light on the physical disk. Syntax start physicalDisk [enclosureID,slotID] blink Parameters Parameter Description physicalDisk The location of the physical disk that you want to find.
Start Physical Disk Channel Fault Isolation Diagnostics Description This command runs the physical disk channel fault isolation diagnostics and stores the results. Syntax start physicalDiskChannel [(1 | 2)] controller [(0 | 1)] faultDiagnostics testDevices=[(all | controller=(0 | 1) | emms=[enclosureID1 slotID1, enclosureID2 slotID2... enclosureIDn slotIDn] | physicalDisks= (enclosureID1,slotID1...
NOTE: Use the save physicalDiskChannel faultDiagnostics command and the stop physicalDiskChannel faultDiagnostics command in association with the start physicalDiskChannel faultDiagnostics command. These commands are needed to save the diagnostic test results to a file and to stop the diagnostic test. NOTE: You can stop this command at any time by pressing . Start Physical Disk Initialize Description This command starts physical disk initialization.
Start Remote Replication Synchronization Description This command starts Remote Replication synchronization. Syntax start asyncRemoteReplicationGroup ["asyncRemoteReplicationGroupName"] synchronize Parameter Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to start synchronization. Enclose the remote replication group name in square brackets ([ ]).
Start 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.
Parameters Parameter Description sourceLocation This parameter specifies the location of the database. • • disk indicates that data comes directly from the database on the physical disk. onboard indicates that data comes from the RPA memory location The default location is disk. diagnosticType The level of diagnostic testing that you want to run on the database. You can run one of these levels of testing: fileSystem mirror This option checks the structural integrity of the database.
NOTE: Executing a consistency check with the diagnosticType parameter set to a value other than filesystem, and with the sourceLocation parameter set to onboard, can cause the operation to run for a long time. This can have adverse effects on host I/O processing. This operation should be done only under direction from the support organization. Upon completion of the diagnostic test, the controller firmware returns one of these results: • Diagnosis completed without errors. No ZIP file created.
Start Virtual Disk Initialization Description This command starts the formatting of a virtual disk in a storage array. NOTE: Initializing a virtual disk is a long-running operation that you cannot stop. Syntax start virtualDisk [virtualDiskName] initialize Parameters Parameter Description virtualDisk Name of the virtual disk for which to start the formatting. You must put brackets ([ ]) around the virtual disk name.
NOTE: Canceling a consistency group snapshot rollback operation leaves the base virtual disk in an indeterminate state with potentially invalid or inconsistent data. The related consistency group snapshot virtual disk becomes disabled and unusable. Syntax stop cgSnapImage["consistencyGroupName"]| rollback [memberVirtualDiskSet ["memberVirtualDiskName1 ...
NOTE: This command does not delete a consistency group snapshot virtual disk. To delete a consistency group snapshot virtual disk use the delete cgSnapVirtualDisk command. Syntax stop cgSnapVirtualDisk [snapVirtualDiskName] Parameter Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk that you want to stop creating.
Syntax stop diskPool locate Stop Enclosure Blink Description This command turns off the indicator LED on the enclosure that was turned on by the start enclosure blink command. 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.
Syntax stop physicalDisk blink Parameters None. Stop Physical Disk Channel Blink Description This command turns off the indicator lights on the expansion enclosures that were turned on by the start physicalDiskChannel blink command. Syntax stop physicalDiskChannel blink Parameters None.
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 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...
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. If the base virtual disk already has n-1 number of snapshot (legacy) virtual disks, the default name is aaa-n.
Parameters Parameter Description virtualDisk Names the specific snapshot virtual disk for which you want to resume 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 (" "). Stop Snapshot Image Rollback Description This command stops a snapshot image rollback operation that was initiated by the start snapImage rollback command.
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 For example, if you want to stop a rollback operation for snapshot image 12345 in a snapshot group that has the name snapGroup1, you would use this command: 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, you would use this command: stop snapI
Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to locate. 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. file The file path and the file name to which you want to save the performance modeling data. Enclose the file name in double quotation marks (" ").
* = Current SSD cache physical capacity. SSD Cache Performance Modeling Data (Cache Hit %): Cache Capacity Cache Hit % 186 GB 0 % 372 GB 0 % 557 GB * 0 % 558 GB 0 % 744 GB 0 % 931 GB 0 % 1117 GB 0 % 1303 GB 0 % 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.
Parameters None. Notes The controller firmware returns a confirmation that the diagnostic test was cancelled. In addition, you can start the database configuration diagnostic test through the storage management software GUI; however, you cannot stop the database configuration diagnostic test through the storage management software GUI. If you want to stop a running diagnostic test, you must use the stop storageArray configDbDiagnostic command.
Parameters None. Stop Virtual Disk Copy Description This command stops a virtual disk copy operation. Syntax stop virtualDiskCopy target [targetName] [source [sourceName]] 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.
Parameters Parameter Description primary or primaries The name of the virtual disk for which you want to suspend operation. Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, also enclose the virtual disk name in double quotation marks (“ ”). writeConsistency This parameter defines whether the virtual disks identified in this command are in a writeconsistency group or are separate.
Parameter Description 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. 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.
Parameters Parameter Description asyncRemoteReplicationGroup The name of an existing remote replication group that you want to test. 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 (" "). testID The identifier for the diagnostic test you want to run.
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 12 This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array.
The first line of text is the show string command. This command displays text bounded by quotation marks (" ") on a monitor screen when the script file runs. In this example, the text Create RAID 5 Virtual Disk 7 on existing Disk Group 1 serves as a title describing the expected results of running this script file. The line beginning //Create is a comment explaining that the purpose of this script file is to create a new virtual disk by using the create virtualDisk command on an existing disk group.
set virtualDisk["7"] mediaScanEnabled=false; set virtualDisk["7"] consistencyCheckEnabled=false; set virtualDisk["7"] modificationPriority=high; The command in this example, like the create virtualDisk command in the previous example, creates a new virtual disk. The significant difference between these two examples is that this example shows how you can define specific physical disks to include in the virtual disk.
CLI Command Updates 13 This chapter reflects new and updated commands that are available for use with Dell's PowerVault Modular Disk Series of storage arrays. NOTE: Not all commands are necessarily valid with all storage arrays - some commands are specific to certain platforms. 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.
• Delete Remote Replication Group • Delete Snapshot Group • Delete Snapshot Image • Delete Snapshot Virtual Disk • Delete Snapshot (Legacy) Virtual Disk • Delete SSD Cache • Enable or Disable SSD Cache for a Virtual Disk • Establish Remote Replicated Pair • Modify Disk Pool • Reinitialize Thin Virtual Disk • Remove Incomplete Remote Replicated Pair from Remote Replication Group • Remove Member Virtual Disk From Consistency Group • Remove Physical Disks from SSD Cache • Remove
• Show Consistency Group Snapshot Image • Show Remote Replication Group • Show Remote Replication Group Synchronization Progress • Show Snapshot Group • Show Snapshot Image • Show Snapshot Virtual Disks • Show SSD Cache • Show SSD Cache Statistics • Show Storage Array Core Dump • Show Storage Array DBM Database • Show Storage Array Host Topology • Show Thin Virtual Disk • Start Consistency Group Snapshot Rollback • Start Remote Replication Synchronization • Start Snapshot Image
• Set Snapshot (Legacy) Virtual Disk • Set Virtual Disk Copy • Show Virtual Disk • Stop Snapshot (Legacy)