Dell 38XX - Manuals

How To Use The Command Line Interface Using the CLI commands, you can access the script engine, specify which storage array receives the script commands, and set operation environment parameters. A CLI command consists of the following elements: • The term SMcli • Storage array identifier• Parameter...

[ host-name-or-IP-address2 ]] [-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...

Parameter Definition -v Use with the -d parameter to display the current global status of the known devices in the storage array configuration file. (The configuration file lists all of the devices in a storage array configuration and the relationship between the devices. Use the configuration file ...

• The CLI automatically saves the error data by writing the data to a file with a standard name.• The CLI does not have any provisions to avoid overwriting an existing version of the file containing error data. For error processing, errors appear as two types: • Parameter or syntax errors you might ...

Status Value Meaning 14 The RAID controller module was unable to communicate with the storage array. 15 A duplicate argument was entered. 16 An execution error occurred. 17 A host was not at the specified address. 18 The World Wide Identifier (WWID) was not in the configuration file. 19 The WWID was...

3 About The Script Commands You can use the script commands to configure and manage a storage array. The script commands are distinct from the command line interface (CLI) commands; however, you enter the script commands using the command line interface. You can enter individual script commands, or ...

Operation Activities Firmware management Downloading RAID controller module, enclosure management module (EMM), and physical disk firmware Script Command Structure All script commands have the following structure: command operand-data {statement-data} where, command identifies the action to be perfo...

Object Type Identifier host User label hostChannel Host channel identifier hostGroup User label hostPort User label snapVirtualDiskName Virtual disk user label snapshot Virtual disk user label snapGroup A snapshot group contains a sequence of snapshot images of an associated base virtual disk. A sna...

Command Syntax Description stop object { statement ‑ data } Stops an asynchronous operation. suspend object { statement ‑ data } Suspends an operation. You can then restart the suspended operation, and it continues from the point at which it was suspended. Recurring Syntax Elements Recurring syntax ...

Usage Guidelines The following list provides guidelines for writing script commands on the command line: • You must end all commands with a semicolon (;).• You can enter more than one command on a line, but you must separate each command with a semicolon (;). • You must separate each base command an...

4 Configuring A Storage Array This chapter explains how to run script commands from the command line to create a virtual disk from a group of physical disks, and how to configure a redundant array of independent disks (RAID) storage array. This chapter assumes that you understand basic RAID concepts...

Configuring A Storage Array When you configure a storage array, you can maximize data availability by ensuring that data is quickly accessible while maintaining the highest level of data protection possible. The speed at which a host can access data is affected by the disk group RAID level and the s...

storage array activities that the commands support. Examples include virtual disk commands, host commands, enclosure commands, and others. Saving A Configuration To A File CAUTION: When you write information to a file, the script engine does not check to determine if the file name already exists. If...

use for virtual disk creation. You do not have to assign the entire capacity of the physical disks to the virtual disk. Assign any unused space to another virtual disk at another time. The userLabel , capacity , owner , and segmentSize parameters are the same as in the previous versions of the creat...

After you have finished creating the disk groups and virtual disks by using the autoConfigure storageArray command, you can further define the properties of the virtual disks in a configuration using the set virtualDisk command. (See Modifying Your Configuration.) Example Of The Auto Configuration C...

as virtual disk creation, reset, delete, rename, or change. If you have more than one storage array in a storage configuration, each array has a separate password. Passwords can have a maximum length of 30 characters. You must put quotation marks (" ") around the password. The following exam...

running Linux. Typically, you need to change the host type only when you are setting up the storage array. The only time you might need to use this parameter is if you need to change how the storage array behaves relative to the hosts. Before you can define the default host type, you need to determi...

Assigning Global Hot Spares Hot spare physical disks can replace any failed physical disk in the storage array. The hot spare must be the same type of physical disk as the physical disk that failed and must have capacity greater than or equal to any physical disk that can fail. If a hot spare is sma...

You can configure the MD storage management software to notify only the event levels that you specify. For example, you can configure alert notifications only for Critical and Warning events. 1. Open the Configure Alerts dialog by performing one of these actions: a. Select a storage array in the Dev...

5 Using The Snapshot Feature 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 descr...

Only the following can be included in a snapshot image: • Standard virtual disks• Thin provisioned virtual disks• Consistency groups Snapshot Groups And Snapshot Consistency Groups The Snapshot Virtual Disk premium feature supports two types of snapshot groups: • Snapshot groups• Consistency groups ...

• Consistency groups can be created initially with or without member virtual disks.• Snapshot images can be created for a consistency group to enable consistent snapshot images between all member virtual disks. • Consistency groups can be rolled back.• A virtual disk can belong to multiple consisten...

Creating Snapshot Images Guidelines before creating a snapshot image: • If you attempt to create a snapshot image on a snapshot group and that snapshot group has reached its maximum number of snapshot images. The failBaseWrites or purgeSnapImages parameters used with the create snapGroup command all...

retainCount= numberOfSnapImages | ignoreSnapVirtualDisk=(TRUE | FALSE) | snapImageID=OLDEST) Creating A Consistency Group Snapshot Virtual Disk Creating a snapshot virtual disk of a consistency group creates a viewable virtual disk of specific images in the consistency group. A consistency group sna...

Create a consistency group snapshot virtual disk that has a repository full limit set to 60 percent on a snapshot consistency group named snapCG1 with these three members cgm1 , cgm2 , and cgm3 , with the following command: create cgSnapVirtualDisk userLabel="cgSnapVirtualDisk3" cgSnapImageI...

• The repository’s reserve space for reuse within the consistency group is released.• Any member virtual disk associated with the deleted snapshot image(s) is moved to a Stopped state.• The member snapshot virtual disks associated with the deleted snapshot image(s) is deleted. To delete two snapshot...

To start a rollback for a snapshot group named snapGroup1 : start snapImage ["snapGroup1"] rollback You can specify a snapshot image rollback for a specific snapshot image in a snapshot group named 12345 : stop snapImage ["snapGroup1:12345"] rollback; To stop a rollback operation for...

Deleting A Snapshot Group CAUTION: All of the data in the snapshot group is lost as soon as you run this command. This command deletes an entire snapshot group and, if specified, the associated repository virtual disks. delete snapGroup [" snapGroupName "] deleteRepositoryMembers=TRUE; In th...

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

autoDeleteLimit allows you to configure each snapshot group to perform automatic deletion of its snapshot images to keep the total number of snapshot images in the snapshot group at or below a maximum number of images. When the number of snapshot images in the snapshot group is at the maximum limit,...

The removeCGMemberVirtualDisk parameter is the name of the member virtual disk that you want to remove; deleteRepositoryMembers determines whether the command removes all the repository members from the consistency group. To remove a virtual disk names payroll-backup from a consistency group named C...

preReadConsistencyCheck=(TRUE | FALSE) readCacheEnabled=(TRUE | FALSE) writeCacheEnabled=(TRUE | FALSE) cacheReadPrefetch=(TRUE | FALSE) Syntax Applicable To Only One Virtual Disk set (virtualDisk [" virtualDiskName "] | virtualDisk <wwID>) addCapacity=virtualDiskCapacity [addPhysicalD...

The following table lists the components that comprise a snapshot virtual disk and briefly describes what they do. 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...

• You must satisfy the requirements of your host operating system for creating snapshot virtual disks. Failure to meet the requirements of your host operating system results in an inaccurate point-in-time image of the source virtual disk or the target virtual disk in a virtual disk copy. Creating A ...

Preparing Host Servers To Create An Initial Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point-in-time image of the s...

The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=3; User-Defined Parameters Parameters for the create snapshotVirtualDisk command enable you to define the snapshot ...

The following example is the script file version of the command: create snapshotVirtualDisk sourceVirtualDisk= "Mars_Spirit_4" repositoryRAIDLevel=5 repositoryPhysicalDiskCount=5 physicalDiskType= SAS userLabel="Mars_Spirit_4_snap1" repositoryUserLabel="Mars_Spirit_4_rep1" wa...

The following example shows the command to change the name of a snapshot virtual disk: client>smcli 123.45.67.89 -c "set virtualDisk [\"Mars_Spirit_4-1\"] userLabel=\"Mars_Odyssey_3-2\";" The following example is the script file version of the command: set virtualDisk [...

Preparing Host Servers To Re-create A Snapshot Virtual Disk CAUTION: Before you create a new point-in-time image of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk and snapshot virtual disk to ensure that you capture an accurate point-in...

7 Using The Virtual Disk Copy Feature 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 a...

Creating A Virtual Disk Copy Before creating a virtual disk copy, ensure that a suitable target virtual disk exists on the storage array, or create a new target virtual disk specifically for the virtual disk copy. The target virtual disk must have a capacity equal to or greater than the source virtu...

Preparing Host Servers To Create A Virtual Disk Copy CAUTION: Before you create a new copy of a source virtual disk, stop any data access (I/O) activity or suspend data transfer to the source virtual disk (and, if applicable, the target disk) to ensure that you capture an accurate point-in-time imag...

– In Linux, mount the virtual disk. See step 1 to step 4 in Preparing Host Servers To Create A Virtual Disk Copy. The create virtualDiskCopy command might look like the following example: client>smcli 123.45.67.89 -c "create virtualDiskcopy source=\"Jaba_Hut\" target= \"Obi_1\"...

The following example shows a command that returns information about a virtual disk used for a virtual disk copy: client>smcli 123.45.67.89 -c "show virtualDiskCopy source [\"Jaba_Hut\"];" The command in the preceding example requests information about the source virtual disk Jaba...

The following example shows how to change parameters using the set virtualDiskCopy command: client>smcli 123.45.67.89 -c "set virtualDiskcopy target [\"Obi_1\"] copyPriority=highest targetreadonlyenabled=false;" The following example is the script file version of the command: set ...

NOTE: If your operating system requires additional instructions, you can find those instructions in your operating system documentation. After your server has been prepared, see Recopying The Virtual Disk to recopy the virtual disk. Recopying The Virtual Disk After first preparing the host server(s)...

Removing Copy Pairs The remove virtualDiskCopy command enables you to remove a virtual disk copy pair from the storage array configuration. All virtual disk copy information for the source virtual disk and target virtual disk is removed from the storage array configuration. The data on the source vi...

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

In this case, the remote write operation cannot be completed to the secondary virtual disk, and the primary virtual disk and the secondary virtual disk are no longer correctly replicated. The primary RAID controller module transitions the replicated pair into an Unsynchronized state and sends an I/O...

Remote Replication Group After your Remote Replication premium feature is activated on both local and remote storage arrays, you must create Remote Replication groups on the local storage array.A replication group contains at least one replicated virtual disk pair, one on the local storage and one o...

– The first port that successfully establishes an iSCSI connection is used for all subsequent communication with that remote storage array. If that connection subsequently fails, a new session is attempted using any available ports. Primary And Secondary Virtual Disks Before you create any replicati...

The create asyncRemoteReplicationGroup command creates a new, empty remote replication group on both the local storage array and the remote storage array. Each replicated pair you add to the remote replication group share the same synchronization settings, primary and secondary role, and write mode....

• warningThresholdPercent The following parameters allow you to change (or force) the primary/secondary role of a replication group, or whether or not to perform a synchronization before changing primary/secondary roles. • role • force • nosync You can apply the changes to one or several remote repl...

reduce any performance impact to the host application that might occur while any changed data on the primary virtual disk is copied to the secondary virtual disk.When a replication relationship is in a suspended state, the primary virtual disk does not make any attempt to contact the secondary virtu...

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

9 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 sec...

Data Replication The RAID controller modules manage data replication between the primary virtual disk and the secondary virtual disk. This process is transparent to host machines and applications. This section describes how data is replicated between the storage arrays that are participating in Remo...

blocks of data that have changed on the primary virtual disk during the link interruption are copied to the secondary virtual disk. CAUTION: Possible loss of data access – Any communication disruptions between the primary storage array and the secondary storage array while resynchronization is under...

Enabling The Remote Replication (Legacy) Premium Feature The first step in creating a remote replication is to make sure that the Remote Replication (legacy) premium feature is enabled on both storage arrays. Because Remote Replication (legacy) is a premium feature, you need a feature key file to en...

The command in this example creates a new replication repository virtual disk in disk group 2 using the second free capacity area. This example shows how to use the command in a script file: activate storageArray feature=remoteReplication repositoryDiskGroup=2 freeCapacityArea=2; Activating The Remo...

by the name of the virtual disk. You define the secondary virtual disk by name with either the name or the World Wide Identifier (WWID) of the storage array on which the secondary virtual disk resides. The primary virtual disk name, the secondary virtual disk name, and the remote storage array name ...

• The synchronization priority• The write order• The write mode You can apply the changes to one or several remote replicated pairs by using this command. Use the primary virtual disk name to identify the remote replicated pairs for which you are changing the properties.This example shows how to use...

CAUTION: Possible loss of data access – Deleting a primary virtual disk or a secondary virtual disk permanently removes the data from the storage array. Disabling The Remote Replication (Legacy) Premium Feature You disable the Remote Replication (legacy) premium feature to prevent the new replicatio...

was created. Snapshot repository virtual disks cannot be selected as a source virtual disk or target virtual disk in a virtual disk copy. The virtual disk for which the point-in-time image is created is the source virtual disk and must be a standard virtual disk in the storage array. You can select ...

Virtual Disk Expansion A Virtual Disk Expansion (VDE) is a modification operation that increases the capacity of a standard virtual disk or a snapshot repository virtual disk. The increase in capacity is achieved by using the free capacity that is available in the disk group of the standard virtual ...

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

Recovered media error The physical disk could not read the requested data on its first attempt. The result of this action is that the data is rewritten to the physical disk and verified. The error is reported to the MEL. Consistency mismatches Consistency errors are found, and a media error is force...

RAID 0 virtual disks No redundancy exists. NOTE: Do not run consistency checking commands on RAID 0 virtual disks. Before attempting a consistency check, you must enable consistency checking using the set virtualDisk command. Use the following command to set the consistencyCheckEnabled parameter to ...

• Change or delete logical unit number (LUN) mappings on a virtual disk holding a reservation.• Delete virtual disk groups or virtual disks that have any reservations. To determine which virtual disks have reservations, run the following command: show (allVirtualDisks | virtualDisk [virtualDiskName]...

Type of Information Description module pair, regardless if one, both, or neither are selected for monitoring Total I/Os Number of total I/Os performed since the storage array was started Read Percentage Percentage of total I/Os that are read operations (calculate the write percentage by subtracting ...

performance is maximized when a single I/O request is serviced with a single data stripe; use smaller values for the segment size. To change the segment size, run the following command: set virtualDisk ([virtualDiskName] | < wwid >) segmentSize= segmentSizeValue where, segmentSizeValue is the ...

For a consistency group snapshot virtual disk: set cgSnapVirtualDisk [" cgSnapshotVirtualDisk "] ssdCacheEnabled=TRUE When you turn off SSD caching for a virtual disk, cache contents is purged. You can turn on SSD caching for only one virtual disk per command. Creating SSD Cache To create ss...

The modeling process runs in the background until you run the stop command. The file parameter is optional. If used, it will write modeling results to the file you specify. stop ssdCache [ ssdCacheName ] performanceModeling file=" filename " Output is displayed directly on your screen, unles...

physical disk-side channel out onto the loop and back again. Enough data is transferred to determine error conditions on the channel. If the test fails on any channel, this status is saved so that it can be returned if all other tests pass. The write test initiates a write command as it would be sen...

If you take a RAID controller module offline, the second RAID controller module in the pair takes over. Disk groups and their associated virtual disks that were assigned to the offline RAID controller module are automatically reassigned to the remaining RAID controller module. CAUTION: Place a RAID ...

Reconstructing A Physical Disk If two or more physical disks in a disk group have failed, the virtual disk shows a status of Failed. All of the virtual disks in the disk group are no longer operating. To return the disk group to an Optimal status, you must replace the failed physical disks. After re...

11 Script Commands CAUTION: Script commands are capable of changing the configuration and may cause loss of data if not used correctly. Command operations are performed as soon as you run the commands. Before using the script commands, ensure that you have backed up all data, and have saved the curr...

NOTE: You can use any combination of alphanumeric characters, hyphens, and underscores for the names. Command names can have a maximum of 30 characters. If you exceed the maximum character limit, replace square brackets ([ ]) with angle brackets (< >) to overcome this limitation. On Microsoft ...

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

Remote Replication Commands Activate Remote Replication Add Virtual Disk to Remote Replication Group Cancel Remote Replication Group Role Reversal Check Remote Replication Group Consistency Check Remote Replication Status Create Remote Replication Check Storage Array Connectivity Clear Remote Replic...

Resume SSD Cache Show SSD Cache Show SSD Cache Statistics Start SSD Cache Performance Modeling Stop SSD Cache Performance Modeling Suspend SSD Cache Storage Array Commands Activate Storage Array Firmware Autoconfigure Storage Array Autoconfigure Storage Array Hot Spares Clear Storage Array Configura...

12 Commands Listed Alphabetically 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...

[drawerLossProtect=(TRUE | FALSE)] [dataAssurance=(none | enabled)] Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk. Valid values are 0 , 1 , 5 , or 6 . repositoryPhysicalDisks The physical disks for the replication repository virtual d...

Parameter Description 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 . drawerLossProtect The setting to enforce drawer loss pr...

set the enclosureLossProtect parameter to FALSE , the storage array performs operations, but the disk group that you create might not have enclosure loss protection. When the RAID controller module firmware assigns the physical disks, if you set the enclosureLossProtect parameter to TRUE , the stora...

operations on each of the base virtual disks. In the context of this command, the term member means a base virtual disk for snapshot operations. You can manipulate snapshot images associated with members of a consistency group through batch-style operations, while maintaining consistency across the ...

Syntax set ssdCache [ ssdCacheName ] addPhysicalDisks=( enclosureID1,drawerID1,slotID1 ... enclosureIDn,drawerIDn,slotIDn ) Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache to which you want to add SSDs. Enclose the identifier in square brack...

Parameter Description Enclose the name of the new repository virtual disk in parenthesis ( ). Autoconfigure Storage Array Description This command automatically configures a storage array. Before entering the autoConfigure storageArray command, run the show storageArray autoConfiguration command. Th...

Autoconfigure Storage Array Hot Spares Description This command automatically defines and configures the hot spares in a storage array. You can run this command at any time. This command provides the best hot spare coverage for a storage array. Syntax autoConfigure storageArray hotSpares Parameters ...

Cancel Remote Replication Group Role Reversal Description This command cancels a pending role reversal operation between remote replication groups. Syntax stop asyncRemoteReplicationGroup [" asyncRemoteReplicationGroupName "] rolechange Parameter Parameter Description asyncRemoteReplicationG...

Parameter Description cache. Valid values are webServer , dataBase , or fileSystem . Check Remote Replication Status NOTE: This command valid only with Fibre Channel storage arrays. Description This command returns the status of a remote replication virtual disk. Use this command to determine when t...

Parameters Parameter Description asyncRemoteReplicationGroup The alphanumeric identifier (including - and _) of the remote replication group on which to run a consistency check. Enclose the remote replication group identifier in square brackets ([ ]). localVirtualDisk Specifies the alphanumeric iden...

Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk on which to run a consistency check. Enclose the snapshot virtual disk identifier in square brackets ([ ]). virtualDisk The alphanumeric identifier (including - and _) of the thin virtu...

Parameters Parameter Description remoteStorageArrayName The name for the remote storage array for which you are checking connectivity. Enclose the storage array name in double quotation marks (" "). remoteStorageArrayNameWwid The World Wide Identifier (WWID) of the storage array for which yo...

Parameter Description 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 th...

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

Parameter Description virtualDisk The name of the specific member virtual disk (in a remote replication group) from which you want to clear the remote replication fault. Enclose the member virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must encl...

Parameter Description 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...

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

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

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. Configure Aut...

Parameter Parameter Description baseVirtualDisk The alphanumeric identifier (including - and _) of the base virtual disk that has the snapshots (legacy) that you want to convert into a snapshot group. Enclose the base virtual disk name in double quotation marks (" "). Create Consistency Grou...

An operation on a snapshot image consistency group is treated as a single request, and causes all pending I/O operations to the associated base virtual disk of each member to be drained and suspended before creating the snapshot images. If creation of the snapshot images cannot be completed successf...

Create Consistency Group Snapshot Virtual Disk Description This command creates a snapshot virtual disk of specific images in the base virtual disks in a consistency group. You can select one base virtual disk or more than one base virtual disks from the consistency group to include in the snapshot ...

• 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:oldest" readOnly; • Creating a consistency group s...

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

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. dataAssurance The setting to specify that a disk group, and the virtual disks within the disk gr...

stripe. A data stripe is the segment size that is multiplied by the number of physical disks in the disk group that are used for data transfers. In this case, multiple physical disks are used for the same request, but each physical disk is accessed only once. For optimal performance in a multiuser d...

Parameter Description Valid values are highest , high , medium , low , and lowest . The default value is high . dataAssurance The setting to specify that a disk pool has data assurance protection to make sure that the data maintains its integrity. When you use this parameter, only protected physical...

• export storageArray securityKey • import storageArray securityKey • set storageArray securityKey • start secureErase (physicalDisk | physicalDisks) Create Host Description This command creates a new host. If you do not specify a host group in which to create the new host, the new host is created i...

Parameter Parameter Description userLabel Name to give the host group that you are creating. You must put quotation marks (" ") around the host group name. Create Host Port Description This command creates a new HBA host port identification. The identification is a software value that repres...

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. Create iSCSI ...

Create RAID Virtual Disk (Free Extent Base Select) Description This command creates a virtual disk in the free space of a disk group. Syntax create virtualDisk diskGroup="diskGroupName" userLabel="virtualDiskName" [freeCapacityArea=freeCapacityIndexNumber] [capacity=virtualDiskCapaci...

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

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

Parameter Description 256 , or 512 . For information about the segmentSize parameter, see Using the Auto Configure Command. usageHint Valid values are multiMedia , database or fileSystem . Create Read-Only Snapshot Virtual Disk Description This command creates a read-only snapshot virtual disk for t...

Parameter Description readOnly This parameter sets the snapshot virtual disk to read-only. This parameter is actually a Boolean; however, in the context of this command, the Boolean value is always TRUE . NOTE: With the readOnly parameter, snapshot virtual disks are not created. Notes You can use an...

Notes Names can be any combination of alphanumeric characters, hyphens, and underscores. Names can have a maximum of 30 characters. When the primary virtual disk and the secondary virtual disk are chosen, the secondary virtual disk must be of equal or of a greater size than the primary virtual disk....

• 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. If a password was not previously set, you do not need a password. The password can be any combination of a alphanumeric char...

other snapshot image. A snapshot image that is created before another snapshot image is a predecessor relative to that other one. A snapshot group repository virtual disk must satisfy a minimum capacity requirement that is the sum of the following: • 32 MB to support fixed overhead for the snapshot ...

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 (legacy) virtual disk and end the copy-on...

Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. The identifier of a snapshot image has two parts separated by a colon (:): • The name of the snapshot group.• The identifier of the snapsh...

Parameter Description (#) for the identifier. Identifiers can have a maximum of 30 characters. physicalDisks The physical disks that you want to use to create the SSD cache. For high-capacity expansion enclosures, specify the enclosure ID value, the drawer ID value, and the slot ID value for each ph...

Additional characters are automatically generated and appended to the end of the string that you enter for the key identifier. If you do not enter any string for the keyIdentifier parameter, the key identifier consists of only the characters that are automatically generated. Your pass phrase must me...

Parameter Description snapshot (legacy), set this parameter to online. To create a virtual disk copy without a snapshot (legacy), set this parameter to offline . If this parameter is not used, the virtual disk copy is created without a snapshot (legacy). Deactivate Remote Replication (Legacy) NOTE: ...

Parameter Description characters, you must enclose the snapshot consistency group name in double quotation marks (" "). deleteRepositoryMembers The setting to delete on or retain the repository virtual disks. To delete the repository virtual disks, set this parameter to TRUE . To retain the ...

Parameter Description the snapshot virtual disk, set this parameter to FALSE . The default value is FALSE . Notes If the snapshot images cannot be deleted for all of the relevant consistency groups, the operation fails and none of the snapshot images are deleted. When you delete a consistency group ...

CAUTION: All data in the disk group is lost as soon as you run this command. Syntax delete diskGroup [ diskGroupNumber ] Parameter Parameter Description diskGroup Number of the disk group to delete. You must put brackets ([ ]) around the disk group number. Delete Disk Pool Description This command d...

Parameter Parameter Description host Name of the host to delete. You must put brackets ([ ]) around the host name. If the host name has special characters, you must also put quotation marks (" ") around the host name. NOTE: A host is a system that is attached to the storage array and accesse...

Syntax delete hostPort [ hostPortName ] Parameter Parameter Description hostPort Name of the HBA host port to delete. You must put brackets ([ ]) around the name of the HBA host port. NOTE: An HBA host port is a physical connection on a host bus adapter that resides within a host system. An HBA host...

Delete Snapshot Group CAUTION: Possible damage to the storage array configuration – All of the data in the snapshot group is lost as soon as you run this command. Description This command deletes an entire snapshot group and optionally the associated member virtual disks. Syntax delete snapGroup [&#...

Delete Snapshot Virtual Disk Description This command deletes a snapshot virtual disk and optionally the associated snapshot repository members. NOTE: You cannot use this command for snapshot images involved in online virtual disk copy. Syntax delete snapVirtualDisk [" snapVirtualDiskName "]...

Parameters Parameter Description virtualDisk or virtualDisks The name of the snapshot virtual disk to delete. You can enter more than one snapshot virtual disk name. Enclose the snapshot virtual disk name in square brackets ([ ]). If the snapshot virtual disk name has special characters, you must al...

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

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

Parameter Description NOTE: When you run a data loop-back test, you can optionally specify a file that contains a data pattern. If you do not specify a file, the RAID controller module firmware provides a default pattern. patternFile File path and file name of the file that contains a data pattern t...

Parameter Description testID Specifies the identifier for the diagnostic test you want to run. For this diagnostic test, the value is cableDiagnostics . Notes When you run the cable diagnostic test, the firmware returns the following information: • Port: The port on which the diagnostic test was run...

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

NOTE: The following attribute is for enabling the snapshot (legacy) feature only. • snapshot[2|4|8|16] The form for this attribute value is a combination of the alphabetical term merged with the numerical value, for example, snapshot16 NOTE: The remoteReplication attribute is valid only for firmware...

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

Download Physical Disk Firmware Description This command downloads a firmware image to a physical disk. CAUTION: Downloading physical disk firmware incorrectly can result in damage to the physical disks or loss of data. Before attempting to download physical disk firmware, you must take the followin...

Download Storage Array Firmware/NVSRAM Description This command downloads firmware and, optionally, NVSRAM values for the RAID controller module in the storage array. If you want to download only NVSRAM values, use the downLoad storageArray NVSRAM command. Syntax download storageArray firmware [, NV...

Syntax download storageArray physicalDiskFirmware file= ” filename ” [file=” filename2 ”... file=” filenameN ”] Parameter Parameter Description file File path and name of the file that contains the firmware. Valid file names must end with a .dlp extension. You must put quotation marks (" ") ...

Parameter Parameter Description file The file path and the file name that contains the NVSRAM values. Enclose the NVSRAM file name in double quotation marks (" "). For example: file="C:\Program Files\CLI\dnld \afrm.dlp" Valid file names have a .dlp extension. healthCheckMelOverride T...

Additional Information To successfully run this command, the following conditions must be met: • All physical disks in the disk group must be self-encrypting disk (SED) physical disks.• The Physical Disk Security premium feature must be enabled.• The storage array security key must be set.• The disk...

Parameter Parameter Description odxEnabled The setting to turn on or turn off ODX. To turn on ODX set this parameter to TRUE . To turn off ODX set this parameter to FALSE . The default setting is that ODX is turned on. NOTE: ODX provides a way to transfer data without using buffered read and buffere...

Notes You can turn the SSD cache on or off for only one virtual disk at a time. When you turn off SSD cache for a virtual disk, the SSD cache for that virtual disk is purged. Enable or Disable VAAI This command turns on or turns off VMware vStorage API Array Architecture (VAAI) for a storage array. ...

Parameter Description from the rear of the enclosure. You must put brackets ([ ]) around the RAID controller module identifier. If you do not specify a RAID controller module, the storage management software returns a syntax error. Enable Storage Array Feature Description This command enables a prem...

The two virtual disks comprising a remote replicated pair function as a single entity. Establishing a remote replicated pair allows you to perform actions on the entire replicated pair versus the two individual virtual disks. Syntax establish asyncRemoteReplication virtualDisk=" secondaryVirtual...

NOTE: In configurations where disk groups consist of more than 32 virtual disks, the operation can result in host I/O errors or internal RAID controller module reboots due to the expiration of the timeout period before the operation completes. If you experience host I/O errors or internal RAID contr...

Notes Depending on the size of the database image, restoring the database might take up to 30 minutes. The host software does not show the RAID controller modules in an optimal state till all actions for loading the database image are completed on the controllers. Modify Disk Pool Description This c...

Parameter Description copyType Creates a virtual disk copy with or a snapshot which enables you to continue to write to the source virtual disk while creating the virtual disk copy. To reinitiate a virtual disk copy with a snapshot, set this parameter to online . To reinitiate a virtual disk copy wi...

NOTE: The MD storage management software collects recovery profiles of the monitored storage arrays and saves the profiles on a storage management station. The physicalDisk parameter supports both high-capacity expansion enclosures and low-capacity expansion enclosures. A high-capacity expansion enc...

If the virtual disk is in an environment where a single user is transferring large units of data (such as multimedia), performance is maximized when a single data transfer request is serviced with a single data stripe. (A data stripe is the segment size that is multiplied by the number of physical d...

Reduce Disk Pool Capacity Description This command reduces the capacity of the disk pool by logically removing the physical disks from the pool. This command uses the Dynamic Capacity Reduction (DCR) feature, which enables you to remove selected physical disks from a disk pool and re-use the removed...

virtual disks remain fully accessible during this operation. The progress of the removal operation is reported as part of the long running operations status. This command fails if there is not enough free capacity on the physical disks that remain in the disk pool to store the data that was on the p...

Syntax create snmpTrapDestination trapReceiverIP=ipAddress communityName="communityName" [sendAuthenticationFailureTraps=(TRUE | FALSE)] Parameters Parameter Description trapReceiverIP The IP address of the SNMP manager to which you want to send trap messages. communityName The name of the S...

Parameter Description must be an unused repository virtual disk with the name in the proper form. • If the newly specified repository virtual disk is on a different disk pool, the thin virtual disk will change ownership to that pool. • The old repository virtual disk will be deleted by default. disk...

Parameter Description name in double quotation marks (" ") inside square brackets. incompleteAsyncRemoteReplication The name of the orphaned virtual disk that you want to remove from the remote replication group. Enclose the virtual disk name in double quotation marks (" "). Remove M...

Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache from which you want to remove SSDs. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers, you also must enclose the ide...

Parameter Description name. Enclose the virtual disk name in square brackets ([ ]). If the virtual disk name has special characters, you also must enclose the virtual disk name in double quotation marks (" "). Remove Virtual Disk Copy Description This command removes a virtual disk copy pair...

Syntax remove virtualDisk [" virtualDiskName "] asyncRemoteReplicationGroup=" asyncRemoteReplicationGroupName " [deleteRepositoryMembers=(TRUE | FALSE)] Parameters Parameter Description virtualDisk The name of the specific virtual disk that you want to remove from the remote replicat...

Parameter Description CAUTION: The host agent uses the access virtual disks to communicate in-band with a storage array. If you remove an access virtual disk mapping for a storage array from a host that has an agent running on it, the storage management software is no longer able to manage the stora...

Rename SSD Cache Description This command changes the name of the SSD cache. Syntax set ssdCache [ old_ssdCacheName ] userLabel=" new_ssdCacheName " Parameters Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to rename. Enclose the...

Parameter Description special characters, you must also put quotation marks (" ") around the virtual disk name. consistencyErrorFile Name of the file that contains the consistency error information you use to repair the errors. You must put quotation marks (" ") around the file name....

Parameter Description replacementPhysicalDisk 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 . copyPhysic...

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

NOTE: The physicalDisk parameter supports both high-capacity expansion enclosures and low-capacity expansion enclosures. A high-capacity expansion enclosure has drawers that hold the physical disks. The drawers slide out of the expansion enclosure to provide access to the physical disks. A low-capac...

Additional Information The RAID controller module that receives the reset RAID controller module command resets the RAID controller module specified. For example, if the reset RAID controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 0, then RAID...

Parameter Description sampleType This parameter is optional. The default value for sampleType is all . • all —Data for all three sample types are reset. • mostRecent —Statistics are reset for the most recent 50 resynchronization samples. • longestSyncTime —Statistics are reset for the most recent 20...

Parameter Description enclosure. Use the controller parameter only for RAID controller modules with batteries. NOTE: If you do not specify a RAID controller module, the age is reset for the storage array battery or both RAID controller module batteries. If you specify a RAID controller module, then ...

Parameters None. Reset Storage Array Virtual Disk Distribution Description This command reassigns (moves) all virtual disks to their preferred RAID controller module. Syntax reset storageArray virtualDiskDistribution Parameters None. CAUTION: Ensure that the multipath driver is running before you us...

Parameter Description • An identifier for the snapshot image in the consistency group. The identifier for the snapshot image can be one of these:• An integer value that is the sequence number of the snapshot in the consistency group. • NEWEST - Use this option when you want to show the latest snapsh...

Parameter Description characters, the primary virtual disk name must also be enclosed in double quotation marks (“ ”). writeConsistency The setting to identify the virtual disks in this command that are in a write-consistency group or are separate. For the virtual disks to be in the same write-consi...

Resume Snapshot Image Rollback Description This command resumes a rollback operation that has entered a paused state. A rollback operation can enter a paused state due to processing errors, which causes a Needs Attention condition for the storage array. If the rollback operation cannot be resumed, t...

For example, if you want to restart a rollback operation for snapshot image 12345 in a snapshot group that has the name snapgroup1 , you would use this command: resume snapImage ["snapgroup1:12345"] rollback; Resume Snapshot (Legacy) Rollback Description NOTE: With firmware version 7.83 the ...

Resume SSD Cache Description This command restarts the caching for all virtual disks using the SSD cache that was temporarily stopped with the suspend ssdCache command. Syntax resume ssdCache [ ssdCacheName ] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of...

Revive Disk Pool Description This command forces a disk pool and its associated physical disks to the Optimal state. CAUTION: Correct use of this command depends on the data configuration on all of the physical disks in the disk pool. Do not try to revive a disk pool unless you are supervised by you...

Revive Snapshot Group Description This command forces the specified snapshot group to the Optimal state. If the snapshot group is not in a Failed state, the firmware displays an error message and does not run this command. Syntax revive snapGroup [ snapGroupName ] Parameter Parameter Description sna...

Save Enclosure Log Data Description This command saves the enclosure log sense data to a file. Log sense data is maintained by the environmental cards for each enclosure. Not all of the environmental cards contain log sense data. Syntax save allEnclosures logFile=" filename " Parameter Param...

NOTE: This command retrieves from both RAID controller modules the IOC dump log data and the IOC dump metadata. Using a 7zip file format, the retrieved data is archived and compressed into a single file with a file name of your choice. The 7zip archive file contains the following:filename+”IOCLog”+[...

Parameters Parameter Description controller RAID controller module with the NVSRAM values to save. Valid RAID controller module identifier values are 0 and 1 . The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the ...

Notes Statistics are captured for replicated virtual disks in the Primary role. The statistics collected include the following data: • Synchronization start time• Synchronization type (manual or periodic)• Synchronization duration• Number of bytes sent• Maximum write time (for a single write)• Minim...

Parameter Description prevent saving the global settings, set this parameter to FALSE . The default value is TRUE . virtualDiskConfigAndSettings Saves the virtual disk configuration settings and all of the global settings to the file. To save the virtual disk configuration and global settings, set t...

Parameter Description This command does not automatically append a file extension to the saved file. You must specify a file extension when entering the file name. Notes The data that you save to the host using this command can, if needed, be restored to the RAID controller module. A validator, howe...

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 RAID controller module where you intend to restore the database. The following example show the format of the XML file: <?xml version="1.0" ...

Parameter Description 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. ...

Parameter Description file The name of the file to which you want to save the performance statistics. Enclose the file name in double quotation marks (" "). NOTE: This command does not automatically append a file extension to the new file. You must specify the file extension when you enter t...

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 (" "). For example: file="C:\Program Files\CLI\logs\sasphy.csv"This command does not automatically...

• The unreadable sectors that are detected on the storage array• The state capture data• An inventory of the versions of the firmware running on the RAID controller modules, the physical disks, and the RAID controller modules Syntax save storageArray supportData file=" filename " [force=(TRU...

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. Divide 1440 by the scheduleInterval option value that you set. For example, ...

Parameter Description 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 sn...

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

operation, stripe size, and whether replication is enabled may result in less memory being available to complete the DCE operation. In such a scenario, try each of the options below and retry the operation: • Create the required disk group size using other unassigned physical disks.• Delete the curr...

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

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

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

Parameters Parameter Description eventType This parameter is the integer value for the event. Enter the event value in a hexadecimal format, for example, 0x280D. Always begin the hexadecimal value with 0x to indicate that it is in hexadecimal format. If you do not use 0x, the value will be interpret...

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

Host Group Parameter Host Has Individual Virtual Disk- to-LUN Mappings Host Does Not Have Individual Virtual Disk-to-LUN Mappings under the new host group defined by hostGroupName . under the new host group defined by hostGroupName . none The host is removed from the host group as an independent par...

Set Host Group Description This command renames a host group. Syntax set hostGroup [ hostGroupName ] userLabel=" newHostGroupName " Parameters Parameter Description hostGroup Name of the host group to rename. You must put brackets ([ ]) around the host group name. If the host group name has ...

Parameter Description label has special characters, enclose the HBA host port label in double quotation marks (" "). host The name of the host to which the HBA host port is connected. Enclose the host name in double quotation marks (" "). userLabel The new name that you want to give ...

NOTE: Use the chapSecret parameter only for initiators requiring mutual authentication. Set iSCSI Target Properties Description This command defines properties for an iSCSI target. Syntax set iscsiTarget [“ iscsiID ”] (authenticationMethod=(none | chap) | chapSecret=” securityKey ” | targetAlias=” u...

Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to set the status. Valid physical disk channel values are 1 or 2 . You must put brackets ([ ]) around the physical disk channel number. status Condition of the channel. You can set the chann...

Set Physical Disk State Description This command sets a physical disk to the Failed state. To return a physical disk to the Optimal state, use the revive physicalDisk command. Optionally, you can copy the data from the physical disk before you fail it. Syntax set physicalDisk [enclosureID,drawerID,s...

Parameter Description The values that support this parameter are listed in the Syntax Element Statement Data table that follows. Many settings are possible, including setting the IP address, the gateway address, the subnet mask address, the IPv4 priority, and the IPv6 priority. rloginEnabled The set...

• The tcpListeningPort option is 3260. Set Read-Only Snapshot Virtual Disk To A Read/Write Virtual Disk Description This command changes a snapshot virtual disk that is a read-only virtual disk to a snapshot virtual disk that is read/write virtual disk. You can also use this command to define the re...

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

Notes You can use any combination of alphanumeric characters, underscore (_), hyphen (-), and pound (#) for the names. Names can have a maximum of 30 characters. When you use this command, you can specify one or more of the parameters. You do not, however, need to use all of the parameters. A remote...

Parameter Description performanceMonitorInterval The frequency of gathering performance data. Enter an integer value for the polling interval, in seconds, for which you want to capture data. The range of values is 3 to 3600 seconds. The default value is 5 seconds. performanceMonitorIterations The nu...

Parameter Description repositoryFullPolicy How you want snapshot image processing to continue if the repository virtual disks for the snapshot image group are full. You can choose to fail writes to the base virtual disk ( failBaseWrites ) or delete (purge) the snapshot images ( purgeSnapImages ). Th...

Parameters Parameter Description snapGroup The alphanumeric identifier (including - and _) of the snapshot group on which you want to run a media scan. Enclose the snapshot group name in double quotation marks (" ") inside of square brackets ([ ]). mediaScanEnabled The setting to turn on or ...

Parameter Description virtual disk to increase the capacity of the repository virtual disk.The repository virtual disk name is comprised of two parts:• The term repos • A numerical identifier generated by the MD storage management software and the firmware count The number of repository virtual disk...

Parameter Description timeZone Specifies the time zone to use for the scheduling operations, using one of the following values:• GMT±HH:MM —The offset from Greenwich Mean Time (GMT), in hours and minutes. For example, GMT-06:00 must be used to specify Central Standard Time (CST). • Text string —A st...

Parameter Description properties. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside of square brackets ([ ]). mediaScanEnabled The setting to turn on or turn off media scan for the snapshot virtual disk. To turn on media scan, set this parameter to TRUE . To...

Parameters Description Enclose the snapshot virtual disk name in double quotation marks (" "). count The number of repository virtual disks that you want to remove from the snapshot group. Use integer values. Notes When you use this command, you can specify only one of the parameters. You ca...

Passwords are stored on each storage array. For best protection, the password must meet these criteria: • The password must be between eight and 30 characters long.• The password must contain at least one uppercase letter.• The password must contain at least one lowercase letter.• The password must ...

NOTE: You must include all of the enclosures in the storage array in the list defined by the enclosurePositions parameter. If the number of enclosures in the list does not match the total number of enclosures in the storage array, an error message is shown. Set Storage Array ICMP Response Descriptio...

Set Storage Array iSNS Server IPv6 Address Description This command sets the IPv6 address for the iSNS server. 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 L...

Set Storage Array Learn Cycle Description This command sets the learn cycle for the battery backup unit. The learn cycle enables the MD storage management software to predict the remaining battery life. Learn cycles run at set intervals and store the results for software analysis. Syntax set storage...

Parameter Parameter Description redundancyMode Use simplex mode when you have a single RAID controller module. Use duplex mode when you have two RAID controller modules Set Storage Array Security Key Description Use this command to set the security key that is used throughout the storage array to im...

Syntax set storageArray time Parameters None. 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 unnamedDiscoverySe...

Set Virtual Disk Description This command defines the properties for a virtual disk. You can use most of the parameters to define properties for one or more virtual disks, however, some of the parameters define properties for only one virtual disk at a time. The syntax definitions are separated to s...

Parameter Description userLabel Specifies the new name to give an existing virtual disk. You must put quotation marks (" ") around the new virtual disk name. preReadRedundancyCheck The setting to check the consistency of RAID redundancy data on the stripes during read operations. Do not use ...

Cache Flush Modifier Valid values for the cache flush modifier are listed in the following table. Value Description Immediate Data is flushed as soon as it is placed into the cache. 250 Data is flushed after 250 ms. 500 Data is flushed after 500 ms. 750 Data is flushed after 750 ms. 1 Data is flushe...

Cache Read Prefetch The cacheReadPrefetch parameter enables the RAID controller module to 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 disk into cache. This action increases the chance that a fut...

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

Show Blocked Events Description This command returns a list of events that are currently blocked by the set blockEventAlert command. The events in this list are the events that will not send any notifications that you have configured using the alert terminals and parameters; that is, the email, sysl...

Parameter Description • NEWEST - Use this option when you want to show the latest snapshot image created in the consistency group. • OLDEST - Use this option when you want to show the earliest snapshot image created in the consistency group. Enclose the snapshot image name in double quotation marks ...

Syntax When running from the command line, use: show iscsiInitiator [\“ initiatorName \”] iscsiSessions show iscsiTarget [\“ targetName \”] iscsiSessions When running from a script file, use: show iscsiInitiator [“ initiatorName ”] iscsiSessions show iscsiTarget [“ targetName ”] iscsiSessions Parame...

NOTE: You can use the free capacity area value when you create a virtual disk based on the free capacity of a disk group. For a description of how to use the free capacity value, see the create virtualDisk command on Create RAID Virtual Disk (Free Capacity Base Select). Syntax show diskGroup [ diskG...

Parameters Parameter Description diskGroup Number of the disk group for which to display information. You must put brackets ([ ]) around the disk group number. cancelImport The setting to spin the physical disks back down after the disk group dependencies have been read. To spin down the physical di...

Syntax show allHostPorts Parameters None. Additional Information This command returns HBA host port information similar to this example. HOST PORT IDENTIFIER HOST PORT NAME HOST TYPE 12:34:56:54:33:22:22:22 Jupiter1 Solaris 12:34:56:78:98:98:88:88 Pluto 1 Windows 2000/Server 2003 Clustered 54:32:12:...

Show Physical Disk Channel Statistics Description This command shows cumulative physical disk channel data transfer and error information. If the RAID controller module has automatically degraded a channel, this command also shows interval statistics. When using this command, you can display informa...

Status Definition Successful Downloads completed without errors. Not Attempted Downloads did not start. Partial Download Downloads are in progress. Failed Downloads completed with errors. Show RAID Controller Module Description For each RAID controller module in a storage array, this command returns...

Show RAID Controller Module NVSRAM Description This command returns a list of the NVSRAM byte values for the specified host type. If you do not enter the optional parameters, this command returns a list of all NVSRAM byte values. Syntax show (allControllers | controller [(0 | 1)]) NVSRAM [hostType=(...

Syntax show (allAsyncRemoteReplicationGroups | asyncRemoteReplicationGroup [" asyncRemoteReplicationGroupName "]) [summary] Parameters Parameter Description allAsyncRemoteReplicationGroups Use this parameter if you want to display the properties for all remote replication groups. asyncRemote...

Parameters Parameter Description asyncRemoteReplicationGroup The name of the remote replication group for which you want to check the synchronization progress. Enclose the remote replication group name in square brackets ([ ]). If the remote replication group name has special characters, you also mu...

Show Remote Replication Virtual Disk Synchronization Progress NOTE: This command valid only with Fibre Channel storage arrays. Description This command returns the progress of data synchronization between the primary virtual disk and the secondary virtual disk in a Remote Replication configuration. ...

Auto-delete Snapshot images: Disabled Snapshot image schedule: Not Applicable Show Snapshot Image Description This command returns information about the snapshot images that a user had previously created. Syntax For Showing A Specific Snapshot Image show (snapImage [" snapImageName "] | snap...

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 show snapshot image 12345 in a snapshot group that has the name snapGroup1 , you would use this command: show snapImag...

Notes This command returns snapshot virtual disk information as shown in this example: SNAPSHOT Virtual Disk(SNAPSHOT-IMAGE BASED) SUMMARY SUMMARY Total Snapshot virtual disks: 1 Most Recent Snapshot virtual disk: Day month date hh:mm:ss yyyy Status: 1 Optimal, 0 Non Optimal Name Type Status Capacit...

Notes This command returns the SSD cache information similar to this example. SSD Cache name: my_cache Status: Optimal Type: Read Only I/O characteristic type: File System Maximum capacity allowed: 1,862.645 GB Current capacity: 557.792 GB Additional capacity allowed 1,304.852 GB Physical disk capac...

The available bytes, allocated bytes, and user data bytes are used to compute the Cache Allocation % and the Cache Utilization %. Show Storage Array NOTE: With firmware version 8.10 the cacheFlushStop parameter is deprecated and will be removed in a future release of storage management software. Des...

Parameter Description • Time remaining NOTE: When you save the information to a file, you can use the information as a record of your configuration and as an aid during recovery. Show Storage Array Auto Configure Description This command shows the default autoconfiguration that the storage array cre...

Parameter Description diskGroupCount Number of disk groups in the storage array. Use integer values. virtualDisksPerGroupCount Number of equal-capacity virtual disks per disk group. Use integer values. hotSpareCount Number of hot spares desired in the storage array. Use integer values. For informati...

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

NOTE: This command returns the host topology information similar to this example. TOPOLOGY DEFINITIONS DEFAULT GROUP Default type: Windows 2000/Server 2003 Non-Clustered Host Group: scott Host: scott1 Host Port: 28:37:48:55:55:55:55:55 Alias: scott11 Type: Windows 2000/Server 2003 Clustered Host: sc...

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

Syntax show storageArray odxsetting Parameters None. NOTE: This command returns the ODX and VAAI information similar to this example.Windows ODX Setting Status odxEnabled True | False | Inconsistent | Unknown vaaiEnabled True | False | Inconsistent | Unknown Show Storage Array Power Information Desc...

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. The table is organized with column headings for the following information: • Virtual disk user label• Logical unit number (...

Show Thin Virtual Disk Description This command returns the expansion history or the consumed capacity for the specified thin virtual disk or virtual disks. Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNameN ]) (consumedCapacity | (e...

MM/DD/YYYY HH:MM:SS Manual|Automatic NNNNNNNN bytes NNNNNNNN bytes With the consumedCapacity parameter, the command returns information similar to the example shown below. Virtual Disk Physical Capacity Consumned Capacity Quota % Prov. Consumed virtualDiskName 500.000 GB 230.000 GB 700.000 GB 46% Sh...

Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] | virtualDisks [ virtualDiskName1 ... virtualDiskNameN ]) summary Parameters Parameter Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array. virtualDisk or virtualDisks The nam...

Parameters Parameter Description virtualDisk Name of the virtual disk running the long ‑ running operation. You must put quotation marks (" ") and brackets ([ ]) around the virtual disk name. The virtual disk name and quotation marks must be inside the brackets. Show Virtual Disk Copy Descri...

Show Virtual Disk Copy Source Candidates Description This command returns information about the candidate virtual disks that you can use as the source for a virtual disk copy operation. Syntax show virtualDiskCopy sourceCandidates Parameters None. Additional Information This command returns virtual ...

Show Virtual Disk Performance Statistics Description This command returns information about the performance of the virtual disks in a storage array. Syntax show (allVirtualDisks | virtualDisk [ virtualDiskName ] virtualDisks [ virtualDiskName1... virtualDiskNameN ]) performanceStats Parameters Param...

Start Configuration Database Diagnostic Description This command starts a diagnostic test to validate the configuration database in the RAID controller module firmware. Syntax start storageArray configDbDiagnostic Parameters None. Notes Upon completion of the diagnostic test, the RAID controller mod...

Start Disk Group Blink Description This command identifies the physical disks that are logically grouped together to form the specified disk group by blinking the indicator LEDs on the physical disks. (Use the stop diskGroup blink command to turn off the indicator LEDs on the physical disks.) Syntax...

Syntax start diskGroup [ diskGroupName ] export Parameters Parameter Description diskGroup Number of the disk group to defragment. You must put brackets ([ ]) around the disk group number. Additional Information When this command is successful, you can run the start diskGroup import command to finis...

NOTE: Higher-level virtual disks that are specifically related to premium features (Snapshot, Remote Virtual Disk Replication, Virtual Disk Copy, mapping, and persistent reservations) are removed as part of the import operation. You must run the show diskGroup importDependencies command before you r...

Start Input Output RAID Controller Module (IOC) Dump Description This command produces a dump of the IOC log of data transmissions between a host and a RAID controller module. RAID Controller Modules are identified as "0" or "1". Each RAID controller module can have up to four host c...

Parameters Parameter Description controller The identifier letter of the RAID controller module that has the iSCSI host ports. Valid RAID controller module identifier values are 0 or 1 , where, 0 is the RAID controller module in slot 0, and 1 is the RAID controller module in slot 1. iscsi-host-port ...

Syntax start physicalDiskChannel [(1 | 2)] blink Parameters Parameter Description physicalDiskChannel The identifier number of the physical disk channel that you want to locate. Valid values for the identifier number are 1 or 2 . Enclose the identifier number in square brackets ([ ]). Start Physical...

Parameter Description ID values are 0 to 31 . You must put brackets ([ ]) around the enclosure ID value and slot ID value. Start Remote Replication Synchronization Description This command starts Remote Replication synchronization. Syntax start asyncRemoteReplicationGroup [" asyncRemoteReplicati...

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

Parameters Parameter Description virtualDisk or virtualDisks 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,...

Parameter Description Enclose the snapshot image name in double quotation marks (" ") inside square brackets ([ ]). 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...

• Saves a ZIP file containing raw binary data The RAID controller module firmware saves the ZIP file to this location:...\Install_dir\data\FirmwareUpgradeReports\timestamp_buildNo.zip You can use the binary data to help determine the cause of the problem, or you can send the file containing the bina...

Parameters Parameter Description virtualDisk Name of the virtual disk for which to start the formatting. You must put brackets ([ ]) around the virtual disk name. If the virtual disk name has special characters, you must also put quotation marks (" ") around the virtual disk name. Stop Confi...

Parameters Parameter Description consistencyGroupName The name of the consistency group for which you want to stop a rollback operation. Enclose the name of the consistency group in double quotation marks (" ") inside square brackets ([ ]). When the memberVirtualDiskSet parameter is not used...

Parameter Parameter Description cgSnapVirtualDisk The name of the consistency group snapshot virtual disk that you want to stop creating. Enclose the name of the consistency group snapshot virtual disk in square brackets ([ ]) The name of the consistency group snapshot virtual disk that you want to ...

Syntax stop enclosure blink Parameters None. Stop Pending Snapshot Images On Consistency Group Description This command stops all of the pending snapshot images that are to be created on a snapshot consistency group. If the snapshot consistency group does not have any pending snapshot images, the MD...

Syntax stop physicalDiskChannel blink Parameters None. Stop Physical Disk Replace Description This command stops a data copy operation that was started by either a set physicalDisk command or a replace physicalDisk command with the copyPhysicalDisk user input. Syntax stop physicalDisk replace ([encl...

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. Syntax stop (snapGroup [ snapGroupName ] | consistencyG...

Parameter Description If the virtual disk names have special characters or numbers, enter the names using these rules:• Enclose all names in square brackets ([ ]).• Enclose each name in double quotation marks (" "). • Separate each name with a space. Stop Snapshot Rollback Description This c...

Parameter Parameter Description snapImage The name of the snapshot image for which you want to stop a rollback operation. The name of a snapshot image is comprised of two parts:• The name of the snapshot group.• An identifier for the snapshot image in the snapshot group. The identifier for the snaps...

Parameter Parameter Description snapVirtualDisk The alphanumeric identifier (including - and _) of the snapshot virtual disk that you want to stop. Enclose the snapshot virtual disk identifier in double quotation marks (" ") inside square brackets ([ ]). Stop SSD Cache Performance Modeling D...

Stop Storage Array iSCSI Session Description This command forces the termination of an iSCSI session. Syntax stop storageArray iscsiSession [ sessionNumber ] Parameters Parameter Description sessioNumber The identifier number of the iSCSI session. Enclose the identifier number of the iSCSI session i...

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

NOTE: If the writeConsistency parameter is set to TRUE , the virtual disks must be in a write- consistency group (or groups). This command suspends all write-consistency groups that contain the virtual disks. For example, if virtual disks A, B, and C are in a write-consistency group and they have re...

Syntax suspend ssdCache [ ssdCacheName ] Parameter Parameter Description ssdCache The alphanumeric identifier (including - and _) of the SSD cache that you want to suspend. Enclose the identifier in square brackets ([ ]). If the SSD cache name contains special characters or consists only of numbers,...

Parameter Description path. The connectivity test sends an inter-RAID controller module message between the storage arrays, and then validates that the corresponding remote replication group on the remote storage array exists. It also validates that the virtual disk members of the remote replication...

Unregister SNMP Community Description This command deletes an existing Simple Network Management Protocol (SNMP) community that you previously created and registered using the create snmpCommunity command. Deleting an SNMP community effectively unregisters the community. Any trap destinations associ...

Syntax set snmpCommunity communityName="snmpCommunityName" newCommunityName="newSnmpCommunityName" Parameters Parameter Description communityName The name of the existing SNMP community that you want to rename. Enclose the SNMP community name in double quotation marks (" "). ...

Parameter Description sysLocation The physical location of the system, such as "3rd flr". Enclose the SNMP system location in square brackets([ ]). Update SNMP Trap Destination Description This command turns on or turns off sending authentication failure messages for an SNMP trap destination...

13 Sample Script Files This appendix provides sample scripts for configuring a storage array. These examples show how the script commands appear in a complete script file. You can copy these scripts and modify them to create a configuration unique to your storage array. Create a script file in two w...

Configuration Script Example 2 This example creates a new virtual disk using the create virtualDisk command with user-defined physical disks in the storage array. Show "Create RAID 5 Virtual Disk 2 on existing Disk Group 2"; //This command creates the disk group and the initial virtual disk ...