Dell PowerVault MD3600f Series Command Line Interface Manual Download Page 180

Page: 180 / 328

180

Script Commands

freeCapacityArea

The index number of the free space in an

existing disk group to use to create the

snapshot repository virtual disk. Free

capacity is defined as the free capacity

between existing virtual disks in a disk

group. For example, a disk group might

have the following areas: virtual disk 1,

free capacity, virtual disk 2, free capacity,

virtual disk 3, free capacity. To use the free

capacity following virtual disk 2, you specify:

freeCapacityArea=2

Use the

show diskGroup

command to

determine if free capacity area exists.

NOTE:

If you do not specify the

unconfigured or free space, the repository

virtual disk is placed in the same disk group

as the source virtual disk. If the disk group

where the source virtual disk resides does

not have enough space, this command fails.

warningThresholdPercent

The percentage of repository capacity at

which you receive a warning that the

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 repository virtual disk as a

percentage of the source virtual disk. Use

integer values. For example, a value of 40

means 40 percent. The default value is 20.

repositoryUserLabel

The name to give to the repository virtual

disk. You must put quotation marks (" ")

around the repository virtual disk name.

repositoryFullPolicy

Specifies how snapshot processing

continues if the repository is full. You can

choose to fail writes to the source virtual

disk (

failSourceWrites

) or fail the

snapshot virtual disk (

failSnapShot

). The

default value is

failSnapShot

Parameter

Description

book.book Page 180 Wednesday, June 8, 2011 12:20 PM

Summary of Contents for PowerVault MD3600f Series

Page 1: ...Dell PowerVault Modular Disk Storage Arrays CLI Guide ...

Page 2: ...atsoever without the written permission of Dell Inc is strictly forbidden Trademarks used in this text Dell the DELL logo and PowerVault are trademarks of Dell Inc Microsoft MS DOS Internet Explorer Windows and Windows Server are either trademarks or registered trademarks of Microsoft Corporation in the United States and or other countries Other trademarks and trade names may be used in this publi...

Page 3: ...ne Parameters 20 Formatting Considerations 26 Detailed Error Reporting 26 Exit Status 27 Usage Examples 29 2 About the Script Commands 31 Script Command Structure 32 Script Command Synopsis 34 Recurring Syntax Elements 36 Usage Guidelines 42 Adding Comments to a Script File 43 3 Configuring a Storage Array 45 Configuring a Storage Array 46 ...

Page 4: ... Host Servers to Create an Initial Snapshot Virtual Disk 65 Creating a Snapshot Virtual Disk 66 Enabling the Snapshot Virtual Disk Feature 67 Creating a Snapshot Virtual Disk with User Assigned Physical Disks 67 Preparing Host Servers to Create an Initial Snapshot Virtual Disk 67 Creating the Initial Snapshot Virtual Disk 68 Creating a Snapshot Virtual Disk with Software Assigned Physical Disks 70...

Page 5: ...ing a Virtual Disk Copy 82 Preparing Host Servers to Create a Virtual Disk Copy 82 Copying the Virtual Disk 83 Viewing Virtual Disk Copy Properties 84 Changing Virtual Disk Copy Settings 85 Recopying a Virtual Disk 87 Preparing Host Servers to Recopy a Virtual Disk 87 Recopying the Virtual Disk 88 Stopping a Virtual Disk Copy 89 Removing Copy Pairs 90 Interaction With Other Features 90 Storage Par...

Page 6: ...1 Determining Candidates for a Remote Replicated Pair 105 Creating a Remote Replicated Pair 105 Changing Remote Replication Settings 107 Suspending and Resuming a Replication Relationship 108 Removing a Replication Relationship 110 Deleting a Primary Virtual Disk or a Secondary Virtual Disk 110 Disabling the Remote Replication Premium Feature 111 Deactivating the Remote Replication Premium Feature...

Page 7: ...9 Locating Physical Disks 119 Performance Tuning 120 Monitoring Performance 120 Changing RAID Levels 121 Changing Segment Size 121 Defragmenting a Disk Group 122 Troubleshooting and Diagnostics 123 Collecting Physical Disk Data 123 Diagnosing a RAID Controller Module 123 Recovery Operations 124 Setting RAID Controller Module Operational Mode 124 Changing RAID Controller Module Ownership 126 Initia...

Page 8: ...137 Storage Array Commands 137 Virtual Disk Commands 139 Virtual Disk Copy Commands 139 Commands Listed Alphabetically 140 Activate Remote Replication Feature 140 Activate Storage Array Firmware 144 Autoconfigure Storage Array 144 Autoconfigure Storage Array Hot Spares 147 Check Remote Replication Status 147 Check Virtual Disk Consistency 148 Clear Physical Disk Port Statistics 149 Clear Storage A...

Page 9: ...age Array Security Key 181 Create Virtual Disk Copy 183 Deactivate Remote Replication 185 Delete Disk Group 186 Delete Host 186 Delete Host Group 186 Delete Host Port 188 Delete iSCSI Initiator 189 Delete Virtual Disk 189 Diagnose RAID Controller Module 190 Diagnose Remote Replication 193 Disable Storage Array Feature 193 Download Enclosure Management Module Firmware 194 Download Physical Disk Fir...

Page 10: ... Storage Array iSCSI Baseline 216 Reset Storage Array SAS PHY Baseline 216 Reset Storage Array Virtual Disk Distribution 217 Resume Remote Replication 217 Revive Disk Group 218 Revive Physical Disk 219 Save Enclosure Log Data 219 Save Physical Disk Channel Fault Isolation Diagnostic Status 220 Save Physical Disk Log 221 Save RAID Controller Module NVSRAM 221 Save Storage Array Configuration 222 Sa...

Page 11: ...t RAID Controller Module 241 Set Remote Replication 246 Set Session 249 Set Snapshot Virtual Disk 250 Set Storage Array 251 Set Storage Array Enclosure Positions 256 Set Storage Array ICMP Response 257 Set Storage Array iSNS Server IPv4 Address 257 Set Storage Array iSNS Server IPv6 Address 258 Set Storage Array iSNS Server Listening Port 258 Set Storage Array Learn Cycle 259 Set Storage Array Red...

Page 12: ...ates 279 Show Remote Replication Virtual Disk Synchronization Progress 280 Show Storage Array 280 Show Storage Array Auto Configure 282 Show Storage Array Host Topology 284 Show Storage Array LUN Mappings 285 Show Storage Array Negotiation Defaults 285 Show Storage Array Unconfigured iSCSI Initiators 286 Show Storage Array Unreadable Sectors 286 Show String 287 Show Virtual Disk 287 Show Virtual D...

Page 13: ...uction 301 Start Secure Physical Disk Erase 301 Start Remote Replication Synchronization 302 Start Storage Array Blink 302 Start Storage Array iSCSI Refresh 303 Start Virtual Disk Initialization 303 Stop Configuration Database Diagnostic 304 Stop Disk Group Blink 304 Stop Enclosure Blink 304 Stop Physical Disk Blink 305 Stop Physical Disk Channel Blink 305 Stop Physical Disk Channel Fault Isolatio...

Page 14: ...14 Contents A Sample Script Files 313 Configuration Script Example 1 314 Configuration Script Example 2 316 B CLI Command Updates 319 New Commands 319 Updated Commands 320 Index 321 ...

Page 15: ...lopers and engineers to configure and monitor storage arrays Using the command line interface you can issue commands from an operating system prompt such as the Microsoft Windows command prompt C or a Linux operating system terminal Each command performs a specific action for managing a storage array or returning information about the status of a storage array You can enter individual commands or ...

Page 16: ...Add storage arrays to and remove storage arrays from the management domain Perform automatic discovery of all storage arrays attached to the local subnet Add or delete Simple Network Management Protocol SNMP trap destinations and e mail alert notifications Specify the mail server and sender e mail address or Simple Mail Transport Protocol SMTP server for alert notifications Direct the output to a ...

Page 17: ...pt commands Usage Notes If you enter SMcli and a storage array name but do not specify CLI parameters script commands or a script file the command line interface runs in interactive mode Interactive mode enables you to run individual commands without prefixing the commands with SMcli You can enter a single command view the results and enter the next command without typing the complete SMcli string...

Page 18: ... lists definitions for the parameters shown in the CLI commands SMcli host name or IP address host name or IP address c command command2 n storage array name w WWID o outputfile p password e S SMcli host name or IP address host name or IP address f scriptfile n storage array name w WWID o outputfile p password e S Table 1 1 Command Name Conventions Parameter Definition a b pipe symbol indicating a...

Page 19: ...st name r host_sa direct_sa I information to include q frequency S SMcli x email email address host name or IP address1 host name or IP address2 n storage array name w WWID h host name r host_sa direct_sa S SMcli a x trap community host name or IP address host name or IP address1 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 n...

Page 20: ... of independent disks RAID controller modules If you have previously configured a storage array in the graphical user interface GUI of the MD Storage Manager you can specify the storage array by its user supplied name by using the n parameter A Use to add a storage array to the configuration files If you do not follow the A parameter with a host name or IP address automatic discovery scans the loc...

Page 21: ... the e mail address from which all alerts will be sent f lowercase Use to specify a file name containing script commands intended to run on the specified storage array This parameter is similar to the c parameter in that both are intended for running script commands The c parameter allows you to execute individual script commands The f parameter allows you to execute script commands contained in a...

Page 22: ...ch the storage array is connected I Use to specify the type of information to be included in the e mail alert notifications The following are valid information arguments eventOnly Only event information is included in the e mail profile Event and array profile information is included in the e mail supportBundle Event and support bundle information is included in the e mail NOTE You can enter only ...

Page 23: ... for use in the MD Storage Manager GUI that is listed in the configuration file must not be a duplicate name of any other configured storage array o Use with the c or f parameter to specify a file name for all output text that is a result of running the script commands p Use to specify the password for the storage array on which to run commands A password is not necessary under the following condi...

Page 24: ...ryEvent 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 12 Information is returned no more than once every 12 hours 24 Information is returned no more than once every 24 hours r Use with the a or x parame...

Page 25: ...le The configuration file lists all of the devices in a storage array configuration and the relationship between the devices Use the configuration file to reconstruct a storage array X uppercase Use to delete a storage array from the configuration file The configuration file lists all of the devices in a storage array configuration and the relationship between the devices Use the configuration fil...

Page 26: ...g string to set the storage array name to Finance Array c set storageArray userLabel Finance Array On a Linux operating system the delimiters around names or labels are single quotation marks The Linux versions of the previous examples are c set storageArray userLabel Engineering Detailed Error Reporting Error data collected from an error encountered by the CLI is written to a file Detailed error ...

Page 27: ...t place the file in the devmgr datadir specified directory the CLI saves the excprpt txt file in the same directory from which the CLI is running You cannot change the file name or location The excprpt txt file is overwritten every time an exception occurs To save the information in the excprpt txt file you must to copy the information to a new file or directory Exit Status After you run a CLI com...

Page 28: ...n unknown IP address was specified 21 The event monitor configuration file was corrupted 22 The storage array was unable to communicate with the event monitor 23 The RAID controller module was unable to write alert settings 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 configura...

Page 29: ...orage array The original name of the storage array is Payroll_Array The new name is Finance_Array Windows SMcli n Payroll_Array c set storageArray userLabel Finance_Array Linux SMcli n Payroll_Array c set storageArray userLabel Finance_Array This example shows how to delete an existing virtual disk and create a new virtual disk on a storage array The existing virtual disk name is Stocks_ _Bonds Th...

Page 30: ... This example shows how to run commands in a script file named scriptfile scr on a storage array named Example In this example the storage array is protected by the password My_Array Output as a result of commands in the script file goes to file output txt Windows SMcli n Example f scriptfile scr p My_Array o output txt Linux SMcli n Example f scriptfile scr p My_Array o output txt This example sh...

Page 31: ...ommands to the appropriate protocol compliant commands which is in turn run by the RAID controller module Passes the commands to the storage array At the storage array the redundant array of independent disks RAID controller modules in the storage array runs the script commands The script engine and script commands support the storage array configuration and management operations listed in Table 2...

Page 32: ...st An operand data object can be identified four ways The object types and object qualifiers The all parameter Brackets A list of identifiers General storage array configuration Resetting a configuration to defaults labeling checking the health status setting the time of day clearing the Major Event Log and setting the media scan rate NVSRAM configuration Downloading and modifying the user configu...

Page 33: ...le virtualDisks sales engineering marketing In a list of identifiers use a blank space as the delimiter A qualifier is necessary if you want to include additional information to describe the objects Table 2 2 lists the object type and identifiers associated with the object types Table 2 2 Object Types and Identifiers Object Type Identifier controller 0 or 1 physicalDisk Enclosure ID and the slot I...

Page 34: ... command Table 2 3 General Form of the Script Commands Command Syntax Description activate object statement data Sets up the environment so that an operation can take place or performs the operation if the environment is already correctly set up autoConfigure storageArray statement data Automatically creates a configuration based on parameters specified in the command check object statement data S...

Page 35: ...check command reset object statement data Returns the hardware or object to an initial state resume object Starts a suspended operation The operation begins where it left off when suspended revive object Forces the object from the Failed to the Optimal state Use only as part of an error recovery procedure save object statement data Writes information about the object to a file set object statement...

Page 36: ... raid level 1 5 6 capacity spec integer literal KB MB GB TB Bytes segment size spec integer literal boolean TRUE FALSE user label string literal user label list user label user label create raid vol attr value list create raid virtual disk attribute value pair create raid virtual disk attribute value pair create raid virtual disk attribute value pair capacity capacity spec owner 0 1 segmentSize in...

Page 37: ...ntifier 01 02 11 12 physical disk type Serial Attached SCSI SAS Serial Advanced Technology Attachment SATA feature identifier snapshot virtualDiskCopy repository spec instance based repository spec count based repository spec ethernet port options IPV4Address ipv4 address IPV4ConfigurationMethod static dhcp IPV4GatewayIP ipv4 address IPV4SubnetMask ipv4 address Table 2 4 Recurring Syntax Elements ...

Page 38: ...eger 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 is applied NOTE The IPV6 ad...

Page 39: ... enclosure If you set enclosureLossProtect TRUE and have selected more than one physical disk from any one enclosure the storage array returns an error If you set enclosureLossProtect FALSE the storage array performs operations but the disk group you create might not have enclosure loss protection NOTE To determine if a free capacity area exists issue the show diskGroup command count based reposit...

Page 40: ...lDiskType physical disk type raidLevel raid level diskGroupWidth integer literal diskGroupCount integer literal virtualDisksPerGroupCount integer literal hotSpareCount integer literal segmentSize segment size spec NOTE The physicalDiskType parameter is not required if only one type of physical disk is in the storage array If you use the physicalDiskType parameter you must also use the hotSpareCoun...

Page 41: ...r value pair recover raid virtual disk attr value pair owner 0 1 Table 2 5 Range of Values for Recurring Syntax Elements Recurring Syntax Syntax Values IPV4Priority 0 to 7 IPV4VlanID 1 to 4094 IPV6Priority 0 to 7 IPV6VlanID 1 to 4094 IPV6HopLimit 0 to 255 default value is 64 IPV6NdDetectDuplicateAddress 0 to 256 IPV6NdReachableTime 0 to 65535 default value is 30000 milliseconds IPV6RetransmitTime ...

Page 42: ... ports are case sensitive If you try to map to an object identified by a user label you must enter the user label exactly as it is defined or the CLI and script commands fails 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...

Page 43: ...t an error message is displayed and the script operation is terminated This error commonly occurs when a comment is placed at the end of a script and you have not pressed Enter Deletes the existing configuration clear storageArray Configuration The script engine interprets any text typed between and as a comment If the script engine does not find both a beginning and ending comment notation an err...

Page 44: ...44 About the Script Commands ...

Page 45: ...ID storage array Additional commands are also available to provide more control and flexibility Many of these commands however require a deeper understanding of the firmware as well as various structures that need to be mapped Use all of the command line interface CLI commands and script commands with caution The following sections in this chapter show some but not all of the CLI and script comman...

Page 46: ...eneral you configure a storage array by defining the following entities A disk group and associated RAID level The virtual disks Which hosts have access to the virtual disks This section explains how to use the script commands to create a configuration from an array of physical disks Determining What is on Your Storage Array Even when you create a configuration on a previously unconfigured storage...

Page 47: ...f the complete CLI and script command running on Windows client smcli 123 45 67 89 c show storageArray profile This example identifies the storage array by the dummy IP address 123 45 67 89 You can also identify the storage array by name The show storageArray profile command returns detailed information about the storage array The information is presented in several screens on a display You might ...

Page 48: ...omponents of a storage array The information returned by each of these commands is the same as the information returned by the show storageArray profile command but is constrained to the specific component The following commands are not complete commands For information about a command see the referenced section next to the command show controller RAID Controller Module Commands on page 135 show p...

Page 49: ...nds 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 you choose the name of a file that already exists the script engine writes over the information in the file without warning After you have created a new configuration or if you want to copy an ...

Page 50: ...hysical disks Create a new virtual disk in an existing disk group You must have unassigned physical disks in the disk group You do not need to assign the entire capacity of the disk group to a virtual disk Creating Virtual Disks with User Assigned Physical Disks When you create a new virtual disk and assign the physical disks to use the MD Storage Manager software creates a new disk group The RAID...

Page 51: ... controller module the RAID controller module firmware determines the owner of the virtual disk The segmentSize parameter is the same as described for the autoConfigure storageArray command See Using the Auto Configure Command on page 54 The enclosureLossProtect parameter turns on or turns off enclosure loss protection for the disk group For a description of how enclosure loss protection works see...

Page 52: ...the command create virtualDisk physicalDiskCount numberOfPhysicalDisks raidLevel 0 1 5 6 userLabel virtualDiskName physicalDiskType SAS SATA capacity virtualDiskCapacity owner 0 1 segmentSize segmentSizeValue enclosureLossProtect TRUE FALSE NOTE The physicalDiskType capacity owner segmentSize and enclosureLossProtect parameters are optional You can use one or all of the optional parameters as need...

Page 53: ...se any of them 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 vi...

Page 54: ...command creates the disk groups on a storage array the virtual disks in the disk groups and the hot spares for the storage array When you use the autoConfigure storageArray command define the following parameters Type of physical disks Serial Attached SCSI SAS or Serial Advanced Technology Attachment SATA RAID level Method enclosureLossProtect TRUE enclosureLossProtect FALSE You assign the physica...

Page 55: ...utoConfigure command returns a list of parameter values that MD Storage Manager uses to create a storage array Change any of the parameter values by entering new values for the parameters when you run the autoConfigure storageArray command If you are satisfied with the parameter values that the show storageArray autoConfiguration command returns run the autoConfigure storageArray command without n...

Page 56: ... segmentSize parameter defines the amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk The smallest units of storage are data blocks Each data block stores 512 bytes of data The size of a segment determines how many data blocks that it contains An 8 KB segment holds 16 data blocks A 64 KB segme...

Page 57: ...Width 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 The storage array has two hot spares and segment size for each virtual disk is 8 KB Modi...

Page 58: ...commands do not have interactive warnings for destructive commands Unless you define a password for the storage array anyone can run all of the script commands A password protects the storage array from any command that the RAID controller modules consider destructive A destructive command is any command that can change the state of the storage array such as virtual disk creation reset delete rena...

Page 59: ...67 891 The storage array is 123 45 67 892 and the community name is public SMcli a trap public 123 45 67 891 123 45 67 892 Setting the RAID Controller Module Clocks To synchronize the clocks on the RAID controller modules with the host use the set storageArray time command Running this command helps ensure that event timestamps written by RAID controller modules to the Major Event Log MEL match ev...

Page 60: ... host types connected to the storage array you can use the show storageArray command with the defaultHostType parameter or hostTypeTable parameter This command returns a list of 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...

Page 61: ...ionPriority highest high medium low lowest The following example shows how to use this command to set the modification priority for virtual disks named Engineering 1 and Engineering 2 client smcli 123 45 67 89 c set virtualDisks Engineering_1 Engineering_2 modificationPriority lowest The modification rate is set to lowest so that system performance is not significantly reduced by modification oper...

Page 62: ...owing 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 89 c set physicalDisks 0 2 0 3 hotSpare TRUE Enter the enclosure ID and slot ID of each physical disk that you want to use You must p...

Page 63: ...source virtual disk remains online and user accessible You can also create several snapshot virtual disks of a source virtual disk and write data to the snapshot virtual disks to perform testing and analysis NOTE If you ordered Premium Features for the Snapshot Virtual Disks you would have received a Premium Features Activation card shipped in the same box as your Dell PowerVault MD storage array ...

Page 64: ... Components Table 4 2 lists the snapshot virtual disk commands and brief descriptions of what the commands do 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 on write data for a particular snap...

Page 65: ...Dell PowerVault MD3200 and MD3220 Storage Arrays With Microsoft Windows Server Failover Clusters or Dell PowerVault MD3200i and MD3220i Storage Arrays With Microsoft Windows Server Failover Clusters at support dell com manuals NOTE You can create concurrent snapshots of a source virtual disk on both the source disk group and on another disk group Before creating a Snapshot Virtual Disk note the fo...

Page 66: ...red When you provide only the standard virtual disk name the storage management software provides default values for the other required property parameters for a snapshot virtual disk NOTE In some cases depending on the host operating system and any virtual disk manager software in use the software prevents you from mapping the same host to both a source virtual disk and its associated snapshot vi...

Page 67: ...he RAID level for the new disk group Preparing Host Servers to Create an Initial Snapshot Virtual Disk CAUTION Before you create a new point in time image of a source virtual disk stop any data access I O activity or suspend data transfer to the source virtual disk to ensure that you capture an accurate point in time image of the source virtual disk Close all applications including Windows Interne...

Page 68: ... Snapshot options to reuse the snapshot Disabling and re creating snapshots preserves the existing virtual disk to host mappings to the snapshot virtual disk After your server has been prepared see Creating the Initial Snapshot Virtual Disk on page 68 Creating the Initial Snapshot Virtual Disk After first preparing the host server s as specified in the preceding procedure use the following example...

Page 69: ...ervers to Create an Initial Snapshot Virtual Disk on page 67 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 89 c create snapshotVirtualDisk sourceVirtualDisk Mars_...

Page 70: ...positoryDiskGroup diskGroupNumber freeCapacityArea freeCapacityIndexNumber userLabel snapshotVirtualDiskName warningThresholdPercent percentValue repositoryPercentOfSource percentValue repositoryUserLabel repositoryName repositoryFullPolicy failSourceWrites failSnapShot enclosureLossProtect TRUE FALSE NOTE Use one or all of the optional parameters as needed to define your configuration It is not n...

Page 71: ...ory virtual disk This version of the create snapshotVirtualDisk command creates a new disk group You must have physical disks in the storage array that are not assigned to a disk group for this command to work create snapshotVirtualDisk sourceVirtualDisk sourceVirtualDiskName repositoryRAIDLevel 0 1 5 6 repositoryPhysicalDiskCount numberOfPhysicalDisks physicalDiskType SAS SATA userLabel snapshotV...

Page 72: ...irements of your storage array Table 4 3 lists the parameters and descriptions of what the parameters do Table 4 3 Snapshot Virtual Disk Parameters Parameter Description physicalDiskType Specifies the type of physical disk to use for the snapshot repository virtual disk The choice is either Serial Attached SCSI SAS or Serial Advanced Technology Attachment SATA This parameter works only with the co...

Page 73: ...k name is Mars_Spirit_4 R1 If the source virtual disk already has n 1 number of snapshot repository virtual disks the default name is Mars_Spirit_4 Rn warningThresholdPercent Specifies how full to allow the snapshot repository virtual disk to get before sending a warning that the snapshot repository virtual disk is close to capacity The warning value is a percentage of the total capacity of the sn...

Page 74: ...k and repository virtual disk are defined by the user If you do not choose to create names for the snapshot virtual disks or the repository virtual disks the RAID controller modules provide default names See Names of Snapshot Virtual Disks and Repository Virtual Disks on page 74 for an explanation of naming conventions Names of Snapshot Virtual Disks and Repository Virtual Disks The names of snaps...

Page 75: ...source virtual disk already has n 1 number of repository virtual disks then the default name is aaa Rn In the examples from the previous section the user defined name of the snapshot virtual disk was Mars_Spirit_4_snap1 The user defined name of the repository virtual disk was Mars_Spirit_4_rep1 The default name provided by the RAID controller module for the snapshot virtual disk would be Mars_Spir...

Page 76: ...sholdPercent 50 repositoryFullPolicy failSourceWrites Stopping and Deleting a Snapshot Virtual Disk When you create a snapshot virtual disk copy on write immediately starts running As long as a snapshot virtual disk is enabled storage array performance is affected by the copy on write operations to the associated snapshot repository virtual disk If you no longer want copy on write operations to ru...

Page 77: ...he snapshot repository virtual disk are retained Preparing Host Servers to Re create a Snapshot Virtual Disk CAUTION Before you create a new point in time image of a source virtual disk stop any data access I O activity or suspend data transfer to the source virtual disk and snapshot virtual disk to ensure that you capture an accurate point in time image of the source virtual disk Close all applic...

Page 78: ...t Virtual Disk on page 77 to re create the snapshot virtual disk 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 on page 77 The following example shows the ...

Page 79: ...ual Disk Copy in the Owner s Manual The Virtual Disk Copy feature enables you to copy data from one virtual disk the source to another virtual disk the target in a single storage array You can use this feature to perform the following functions Back up data Copy data from disk groups that use smaller capacity physical disks to disk groups using larger capacity physical disks Restore snapshot virtu...

Page 80: ...sk copy operation disable storageArray feature virtualDiskCopy Turns off the current virtual disk copy operation enable storageArray feature Activates the Virtual Disk Copy feature recopy virtualDiskCopy Re initiates a virtual disk copy operation by using an existing virtual disk copy pair remove virtualDiskCopy Removes a virtual disk copy pair set virtualDiskCopy Defines the properties for a virt...

Page 81: ...e the file path and file name in quotation marks Valid file names for feature key files usually end with a key extension Determining Virtual Disk Copy Candidates All virtual disks might not be available for use in virtual disk copy operations To determine which candidate virtual disks on the storage array can be used as a source virtual disk use the show virtualDiskCopy sourceCandidates command To...

Page 82: ...he 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 NOTE Removing the drive letter of the associated virtual disk s in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the ...

Page 83: ...cedure use the following examples to make a virtual disk copy The following syntax is the general form of the command create virtualDiskCopy source sourceName target targetName copyPriority highest high medium low lowest targetReadOnlyEnabled TRUE FALSE NOTE Use one or both of the optional parameters as needed to help define your configuration It is not necessary to use any optional parameters Onc...

Page 84: ...e target virtual disk This setting also ensures that the data on the target virtual disk remains unaltered Refer to steps 1 through 4 in the preceding section Preparing Host Servers to Create a Virtual Disk Copy on page 82 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 virt...

Page 85: ...get targetName The following example shows a command that returns information about a virtual disk used for a virtual disk copy client smcli 123 45 67 89 c show virtualDiskCopy source Jaba_Hut The command in the preceding example requests information about the source virtual disk Jaba_Hut If you want information about all virtual disks use the allVirtualDisks parameter You can also request informa...

Page 86: ...virtual disk after the virtual disk copy is created Maintain the read only status when the following conditions apply You are using the target virtual disk for backup purposes You are copying data from one disk group to a larger disk group for greater accessibility You are planning to use the data on the target virtual disk to copy back to the source virtual disk in case of a disabled or failed sn...

Page 87: ...he recopy virtualDiskCopy command to create backups of the target virtual disk then copy the backup to tape for off site storage When using the recopy virtualDiskCopy command to make a backup you cannot write to source while the recopy is running The recopy might take a long time When you run the recopy virtualDiskCopy command the data on the source virtual disk is copied in its entirety to the ta...

Page 88: ...formation 3 Remove the drive letter s of the source and if mounted virtual disk in Windows or unmount the virtual drive s in Linux to help guarantee a stable copy of the drive for the virtual disk If this is not done the copy operation reports that it has completed successfully but the copied data is not updated properly 4 Follow any additional instructions for your operating system Failure to fol...

Page 89: ...you automatically created one virtual disk copy Using this command you are copying the data from the source virtual disk to the target virtual disk You are making this copy because the data on the source virtual disk changed since the previous copy was made Refer to steps 1 through 4 in the preceding section Preparing Host Servers to Recopy a Virtual Disk on page 87 The following example is the sc...

Page 90: ...e storage array configuration also removes the read only attribute for the target virtual disk CAUTION If the virtual disk copy has a status of In Progress you must stop the virtual disk copy before you can remove the virtual disk copy pair from the storage array configuration The following syntax is the general form of the command remove virtualDiskCopy target targetName source sourceName The fol...

Page 91: ...lly becomes read only to hosts to ensure that the data is preserved Hosts that have been mapped to a target virtual disk do not have write access to the virtual disk and any attempt to write to the read only target virtual disk results in a host I O error If you want hosts to have write access to the data on the target virtual disk use the set virtualDiskCopy command to disable the read only attri...

Page 92: ...e image is created is the source virtual disk and must be a standard virtual disk in the storage array You can select snapshot virtual disks as the source virtual disk for a virtual disk copy Selecting a snapshot virtual disk is a good use of this feature because it enables complete backups without significant impact to the storage array I O However some I O processing resources are lost to the co...

Page 93: ... storage based it does not require any server overhead or application overhead You can use Remote Replication for these functions Disaster recovery Remote Replication lets you replicate data from one site to another site which provides an exact duplicate at the remote secondary site If the primary site fails you can use replicated data at the remote site for failover and recovery You can then shif...

Page 94: ...d The secondary virtual disk maintains a replication or copy of the data on its associated primary virtual disk The RAID controller module owner of the secondary virtual disk receives remote writes from the RAID controller module owner of the primary virtual disk but will not accept host write requests Hosts are able to read from the secondary virtual disk which appears as read only In the event o...

Page 95: ...quired less disk storage space and needed to be upgraded to use the maximum amount of replication relationships Replication Relationships Before you create a replication relationship you must enable the Remote Replication premium feature on both the primary storage array and the secondary storage array You must also create a secondary virtual disk on the secondary site if one does not already exis...

Page 96: ...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 After the host write request has been written to the primary virtual disk and the data has been successfully copied to the sec...

Page 97: ...e remote secondary storage arrays is prevented to protect the consistency of the remote data set Link Interruptions or Secondary Virtual Disk Errors When processing write requests the primary RAID controller module might be able to write to the primary virtual disk but a link interruption might prevent communication with the remote secondary RAID controller module In this case the remote write ope...

Page 98: ...te request from a host the RAID controller module first logs information about the write to a replication repository virtual disk The RAID controller module then writes the data to the primary virtual disk The RAID controller module then initiates a write operation to copy the affected data to the secondary virtual disk on the remote storage array If a link interruption or a virtual disk error pre...

Page 99: ...des on the local storage array is the primary virtual disk Similarly the virtual disk that resides on the remote storage array is the secondary virtual disk If neither the primary virtual disk nor the secondary virtual disk exist you must create these virtual disks Keep these guidelines in mind when you create the secondary virtual disk The secondary virtual disk must be of equal or greater size t...

Page 100: ...onization 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 A full synchronization at the medium synchronization priority level takes approximately three and a half times as long as a full synchronization at the highest synchronization priority level A full sy...

Page 101: ...ts for each RAID controller module are reserved and dedicated to remote replication use In addition a replication repository virtual disk is automatically created for each RAID controller module in the storage array As part of the activation process you can decide where the replication repository virtual disks will reside free capacity on an existing disk group or in a newly created disk group and...

Page 102: ...ual 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 You define the number of physical disks but not specific physical disks for the replication repository virtual disk Ac...

Page 103: ...el 5 repositoryPhysicalDisks 1 1 1 2 1 3 1 4 1 5 Activating the Remote Replication Premium Feature with Software Assigned Physical Disks With this version of the activate storageArray feature remoteReplication command you choose an existing disk group in which to place the replication repository virtual disk The MD storage management software then determines which physical disks to use You can als...

Page 104: ...r 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 For this command to work you must have physical disks in the storage array that are not assigned to a disk group activate s...

Page 105: ...tes command This command returns a list of the virtual disks that you can use when creating a remote replication The command takes this form c smX client smcli 123 45 67 88 123 45 67 89 c show remoteReplication candidates primary virtualDiskName remoteStorageArrayName storageArrayName where virtualDiskName is the name of the virtual disk that you want to use for the primary virtual disk and storag...

Page 106: ...ion This example shows the create remoteReplication command c smX client smcli 123 45 67 88 123 45 67 89 c create remoteReplication primary Jan_04_Account secondary Jan_04_Account_B remoteStorageArrayName Tabor remotePassword jdw2ga05 syncPriority highest writeMode synchronous The command in this example creates a remote replication in which the primary virtual disk is named Jan_04_Account on the ...

Page 107: ...ynchronous After you have created a remote replication you can see the progress of data synchronization between the primary virtual disk and the secondary virtual disk by running the show remoteReplication synchronizationProgress command This command shows the progress as a percentage of data synchronization that has completed Changing Remote Replication Settings The set remoteReplication command ...

Page 108: ...econdary virtual disk are synchronized Suspending a replication relationship helps to 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 Suspending a replication relationship is particularly useful when you want to run a backup of the data on the secondary virtual disk When a replication ...

Page 109: ...at are not in a write consistency group set this parameter to FALSE This example shows how to use the command in a script file suspend remoteReplication virtualDisk Jan_04_Account writeConsistency false The replication relationship remains suspended until you use the resume remoteReplication command to restart synchronization activities This command restarts data transfers between a primary virtua...

Page 110: ...45 67 88 123 45 67 89 c remove remoteReplication localVirtualDisk Jan_04_Account When you run this command use the name of the primary virtual disk of the remote replicated pair This example shows how to use the command in a script file remove remoteReplication localVirtualDisk Jan_04_Account To re establish the link between a primary virtual disk and a secondary virtual disk use the create remote...

Page 111: ...emoved all of the replication relationships you can deactivate the premium feature Deactivating the premium feature re establishes the normal use of dedicated ports on both storage arrays and deletes both replication repository virtual disks To deactivate the Remote Replication premium feature use this command deactivate storageArray feature remoteReplication Interaction with Other Premium Feature...

Page 112: ...ot virtual disks based on the primary virtual disk or secondary virtual disk of a remote replication Virtual Disk Copy The Virtual Disk Copy premium feature copies data from one virtual disk the source virtual disk to another virtual disk the target virtual disk within a single storage array You can use this premium feature to perform these functions Copy data from disk groups that use smaller cap...

Page 113: ... of each other If these definitions are put in place while the virtual disk is in a secondary role the administrative effort associated with the site recovery is reduced if it becomes necessary to promote the virtual disk to a primary role 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 ...

Page 114: ...114 Using the Remote Replication Premium Feature ...

Page 115: ...mands you can use for maintenance Other commands particularly the set commands can provide diagnostic or maintenance capabilities Routine Maintenance Routine maintenance involves those tasks you might perform periodically to ensure that the storage array is running as well as possible or to detect conditions before they become problems Running a Media Scan Media scan provides a method of detecting...

Page 116: ...ified and the error is reported to the MEL Recovered media error The physical disk could not read the requested data on its first attempt The result of this action is that the data is rewritten to the physical disk and verified The error is reported to the MEL Consistency mismatches Consistency errors are found and a media error is forced on the block stripe so that it is found when the physical d...

Page 117: ...virtual disk See Running a Media Scan on page 115 for an explanation about setting up and running media scans During a consistency check all data blocks in a virtual disk are scanned and deteriorated data is corrected The method of correction depends on the redundant array of independent disks RAID levels RAID 5 and RAID 6 virtual disks Consistency is checked and repaired RAID 1 virtual disks The ...

Page 118: ...nt while running diagnostics If this occurs the RAID controller module might become unresponsive To revive a RAID controller module run the following command enable controller 0 1 dataTransfer Resetting Battery Age NOTE A smart battery module does not require the battery age to be reset After replacing the batteries in the storage array you must reset the age of the battery either for an entire st...

Page 119: ...cks 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 In very large storage array configurations this can sometimes be awkward If you need to locate a specific physical disk turn on the indicator LED on the front of the ph...

Page 120: ...1 and a list of the virtual disks owned by the RAID controller module Virtual Disk A list of the virtual disk names Storage Array Totals A list of the totals for both RAID controller modules in an active active RAID controller 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 Perce...

Page 121: ...n for your data To change the RAID level run the following command set diskGroup diskGroupNumber raidLevel 0 1 5 6 where diskGroupNumber is the number of the disk group for which to change the RAID level Changing Segment Size When creating a new virtual disk define the segment size for that virtual disk You can later change the segment size to optimize performance In a multi user database or file ...

Page 122: ...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 If you delete virtual disks 1 and 3 your disk group is configured in the following manner space virtual disk 2 space virtual disk 4 virtual disk 5...

Page 123: ...t would be sent over an I O data path The read test compares data with a known specific data pattern checking for data integrity and errors If the read command is unsuccessful or the data compared is not correct the RAID controller module is considered to be in error and is placed offline Run the data loopback test only on RAID controller modules that have connections between the RAID controller m...

Page 124: ...e used but larger files can cause an error 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 wh...

Page 125: ...se Service mode when you want to perform an operation such as replacing a RAID controller module Placing a RAID controller module in Service mode makes it unavailable for I O operations Placing a RAID controller module in Service mode also moves the disk groups from the RAID controller module to the second RAID controller module without affecting the disk groups preferred path Moving disk groups m...

Page 126: ...group and virtual disk information on the physical disks that you move is incomplete Each physical disk that you move contains only part of the information defined for the virtual disk and disk group To be able to reuse the physical disks to create a new disk group and virtual disk you must erase all old information from the physical disks by initializing the physical disk When you initialize a ph...

Page 127: ...entifiers for the physical disk NOTE You can use this command only when the physical disk is assigned to a RAID 1 5 or 6 disk group Initializing a Virtual Disk CAUTION When you initialize a virtual disk all data on the virtual disk and all information about the virtual disk are erased A virtual disk is automatically initialized when you first create it If the virtual disk starts exhibiting failure...

Page 128: ...second RAID controller module The second RAID controller module becomes the current owner of the virtual disks This change is considered to be a routine ownership change and is reported in the MEL CAUTION Ensure that a multipath driver is installed or the virtual disks are not accessible To redistribute virtual disks to their preferred RAID controller modules run the following command reset storag...

Page 129: ... maintain a storage array This chapter is organized into four sections Command Formatting Rules on page 130 lists general formatting rules that apply to the command syntax Firmware Compatibility Levels on page 132 lists the firmware level for this release Commands Listed by Function on page 132 lists the commands by functional activity Disk group Enclosure Host topology Physical disk Redundant arr...

Page 130: ...tions mixed case is used as an aid to reading the command names and understanding the purpose of the command You must enter spaces in the commands as they are shown in the command descriptions 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 Parenthes...

Page 131: ... of alphanumeric characters hyphens and underscores for the names of the following components Storage arrays Host groups Hosts Disk groups Virtual disks Host bus adapter HBA host ports Names can have a maximum of 30 characters If the label contains multiple words underscores or hyphens you must put quotation marks around the name In some usages you must also put brackets around the name The descri...

Page 132: ...WID parameter tells you if you must put quotation marks or angle brackets around the WWID Script commands must end with a semicolon You can enter more than one script command on the command line each time you enter a CLI command Firmware Compatibility Levels The RAID controller module firmware for commands is 7 70 Commands Listed by Function This section presents the commands organized into groups...

Page 133: ...t Module Firmware on page 194 Save Enclosure Log Data on page 219 Set Enclosure Attribute on page 229 Set Enclosure Identification on page 230 Start Enclosure Blink on page 297 Stop Enclosure Blink on page 304 Host Topology Commands Create Host on page 159 Create Host Group on page 160 Create Host Port on page 160 Create iSCSI Initiator on page 162 Delete Host on page 186 Delete Host Group on page...

Page 134: ... page 238 Show Current iSCSI Sessions on page 269 Show Storage Array Negotiation Defaults on page 285 Start iSCSI DHCP Refresh on page 297 Stop Storage Array iSCSI Session on page 307 Physical Disk Commands Clear Physical Disk Port Statistics on page 149 Download Physical Disk Firmware on page 195 Replace Physical Disk on page 213 Revive Physical Disk on page 219 Save Physical Disk Channel Fault I...

Page 135: ...art Secure Physical Disk Erase on page 301 Stop Physical Disk Blink on page 305 Stop physical disk channel blink Stop Physical Disk Channel Fault Isolation Diagnostics on page 305 RAID Controller Module Commands Clear Physical Disk Port Statistics on page 149 Diagnose RAID Controller Module on page 190 Enable RAID Controller Module Data Transfer on page 201 Reset RAID Controller Module on page 214...

Page 136: ... 147 Create Remote Replication on page 173 Deactivate Remote Replication on page 185 Diagnose Remote Replication on page 193 Re create Remote Replication Repository Virtual Disk on page 204 Remove Remote Replication on page 209 Resume Remote Replication on page 217 Set Remote Replication on page 246 Show Remote Replication Virtual Disk Candidates on page 279 Show Remote Replication Virtual Disk Sy...

Page 137: ...Create Storage Array Security Key on page 181 Disable Storage Array Feature on page 193 Download Storage Array Firmware NVSRAM on page 197 Enable RAID Controller Module Data Transfer on page 201 Download Storage Array NVSRAM on page 199 Enable Storage Array Feature on page 201 Reset Storage Array Battery Install Date on page 215 Reset Storage Array Battery Install Date on page 215 Reset Storage Ar...

Page 138: ...ncy Mode on page 260 Set Storage Array Security Key on page 260 Set Storage Array Time on page 261 Set Storage Array Unnamed Discovery Session on page 262 Show Storage Array on page 280 Show Storage Array Auto Configure on page 282 Show Storage Array Host Topology on page 284 Show Storage Array LUN Mappings on page 285 Show Storage Array Negotiation Defaults on page 285 Show Storage Array Unconfig...

Page 139: ...ge 211 Repair Virtual Disk Consistency on page 212 Set Virtual Disk on page 262 Show Virtual Disk on page 287 Show Virtual Disk Action Progress on page 289 Show Virtual Disk Performance Statistics on page 291 Show Virtual Disk Reservations on page 292 Start Virtual Disk Initialization on page 303 Virtual Disk Copy Commands Create Virtual Disk Copy on page 183 Recopy Virtual Disk Copy on page 202 R...

Page 140: ...roup 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 volume Syntax User Defined Physical Disks activate storageArray feature remoteReplication repositoryRAIDLevel 1 5 6 repositoryPhysicalDisks enclosureID1 slotID1 enclosureIDn slotIDn repositoryDiskGroupUs...

Page 141: ...tory virtual disk For high capacity physical disk enclosures specify the enclosure ID value and the slot ID value for each physical disk that you assign to the replication repository virtual disk For low capacity physical disk enclosures specify the enclosure ID value and the slot ID value for each physical disk that you assign to the replication repository virtual disk Enclosure ID values are 0 t...

Page 142: ...l disk media are these HDD Use this option when you have hard physical disks in the expansion enclosure SSD Use this option when you have solid state physical disks in the expansion enclosure unknown Use if you are not sure what types of physical disk media are in the expansion enclosure allMedia Use this option when you want to use all types of physical disk media that are in the expansion enclos...

Page 143: ... re entered using the value from the error message for the repository storage space value freeCapacityArea The index number of the free space in an existing disk group that you want to use to create the replication repository virtual disk Free capacity is defined as the free capacity between existing virtual disks in a disk group For example a disk group might have the following areas virtual disk...

Page 144: ...vate Storage Array Firmware This command activates firmware previously downloaded to the pending configuration area in the RAID controller modules in the storage array Syntax activate storageArray firmware Parameters None Autoconfigure Storage Array This command automatically configures a storage array Before entering the autoConfigure storageArray command run the show storageArray autoConfigurati...

Page 145: ... 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 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 diskGrou...

Page 146: ...ize parameter see Using the Auto Configure Command on page 54 cacheReadPrefetch The setting to turn on or turn off cache read prefetch To turn off cache read prefetch set this parameter to FALSE To turn on cache read prefetch set this parameter to TRUE securityType The setting to specify the security level when creating the disk groups and all associated virtual disks none The disk group and virtu...

Page 147: ...te Replication Status NOTE This command valid only with Fibre Channel storage arrays This command returns the status of a remote replication virtual disk Use this command to determine when the status of the remote replication virtual disk becomes Optimal Syntax check remoteReplication localVirtualDisk virtualDiskName optimalStatus timeout timeoutValue Parameters Parameter Description localVirtualD...

Page 148: ...ingLBA LBAvalue verbose TRUE FALSE Parameters timeout The time interval within which the software can return the remote replication virtual disk status The timeout value is in minutes 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 ...

Page 149: ...ets the statistics for all physical disk ports Syntax clear allPhysicalDiskChannels stats Parameters None priority Specifies the priority that the consistency check has relative to host I O activity Valid entries are highest high medium low or lowest startingLBA The starting logical block address Use integer values endingLBA The ending logical block address Use integer values verbose Captures prog...

Page 150: ...lated to security and identification NOTE When you run this command the storage array becomes unresponsive and all script processing is cancelled You must remove and re add the storage array to resume communication with the host To remove an unresponsive storage array access the Enterprise Management Window and click Edit Remove To re add the storage array access the Enterprise Management Window c...

Page 151: ...ray is deleted Syntax clear storageArray eventLog Parameters None Clear Storage Array Firmware Pending Area 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 firmw...

Page 152: ...s can have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation 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 You must...

Page 153: ...maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation 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 ent...

Page 154: ...dia enclosureLossProtect TRUE FALSE securityType none capable enabled Parameters Parameter Description physicalDisks The physical disks that you want to assign to the disk group that you want to create Specify the enclosure ID value and the slot ID value for each physical disk that you assign to the disk group Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 Enclose the enclosure ID valu...

Page 155: ...l 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 The following examples show the syntax capacity 500 bytes capacity 2 GB NOTE A space must be added between the last digit and the size bytes KB MB or GB for values greater than 9 If you do not specify a capacity all...

Page 156: ...32 64 128 256 or 512 usageHint The setting for both the cacheReadPrefetch parameter and the segmentSize parameter to be 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 The setting to enforce enclosure loss protection when you create the disk group T...

Page 157: ...before writing data on the next physical disk Each data block stores 512 bytes of data A data block is the smallest unit of storage The size of a segment determines how many data blocks that it contains For example an 8 KB segment holds 16 data blocks A 64 KB segment holds 128 data blocks When you enter a value for the segment size the value is checked against the supported values that are provide...

Page 158: ... create storageArray securityKey command to create a storage array security key The following commands are related to the securtiy key create storageArray securityKey set storageArray securityKey start secureErase physicalDisk physicalDisks enable diskGroup diskGroupName security Enclosure Loss Protection For enclosure loss protection to work each physical disk in a disk group must be in a separat...

Page 159: ...e this limitation 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 defau...

Page 160: ...rt identification the RAID controller module cannot receive instructions or data from the host port Syntax create hostPort identifier wwid userLabel portLabel host hostName interfaceType SAS Parameters Parameter Description userLabel Name to give the host group that you are creating You must put quotation marks around the host group name Parameter Description identifier WWID of the HBA host port Y...

Page 161: ...ion marks around the host name NOTE An HBA host port is a physical connection on a host adapter that resides within a host system An HBA host port provides 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 host port and host bus adapter are synonymous interfaceType The identifier for the type of interface for the ho...

Page 162: ...l Disk Select This command creates a disk group across the storage array physical disks and a new virtual disk in the disk group The RAID controller modules in the storage array choose the physical disks to include in the virtual disk Syntax create virtualDisk physicalDiskCount numberOfPhysicalDisks diskGroupUserLabel diskGroupName raidLevel 0 1 5 6 userLabel virtualDiskName physicalDiskType SAS P...

Page 163: ...t 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 raidLevel RAID level of the disk group that contains the virtual disk Valid values are 0 1 ...

Page 164: ...he left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure If you do not specify an owner the RAID controller module firmware determines the owner NOTE The owner parameter defines which RAID controller module owns the virtual disk cacheReadPrefetch The setting to turn on or turn off cache read prefetch To turn off cache read prefetch set this parameter to F...

Page 165: ...g 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 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 T...

Page 166: ...e capable enabled Parameters Parameter Description diskGroup Sequence number of the disk group in which to create the new virtual disk To determine the sequence numbers of the disk groups in your storage array enter the show storageArray Profile command userLabel Name for the new virtual disk You must put quotation marks around the new virtual disk name NOTE You can use any combination of alphanum...

Page 167: ...B NOTE Add a space between the last digit and the size bytes KB MB or GB for values greater than 9 If you do not specify a capacity all the available physical disk capacity in the disk group is used If you do not specify the capacity unit bytes is used as the default unit owner RAID controller module that owns the virtual disk Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID...

Page 168: ...nd 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 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 secu...

Page 169: ...DiskName capacity virtualDiskCapacity owner 0 1 cacheReadPrefetch TRUE FALSE segmentSize segmentSizeValue usageHint fileSystem dataBase multiMedia enclosureLossProtect 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 u...

Page 170: ...Name that you want to give the new virtual disk You must put quotation marks around the new virtual disk name NOTE You can use any combination of alphanumeric characters hyphens and underscores for the names Spaces are not allowed Names can have a maximum of 30 characters capacity Size of the virtual disk that you are adding to the storage array Size is defined in units of bytes KB MB GB or TB NOT...

Page 171: ...to turn on or turn off cache read prefetch To turn on cache read prefetch set this parameter to TRUE To turn off cache read prefetch set this parameter to FALSE segmentSize Amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk Valid values are 8 16 32 64 128 256 or 512 For information about the s...

Page 172: ...he security level when creating the disk groups and all associated virtual disks none The disk group and virtual disks are not secure capable The disk group and virtual disks are capable of having security set but security has not been enabled enabled The disk group and virtual disks have security enabled For information about securityType see Security Type on page 158 Parameter Description ...

Page 173: ...utoResync enabled disabled writeOrder preserved notPreserved writeMode synchronous asynchronous Parameters Parameter Description primary The name of an existing virtual disk on the local storage array that you want to use for the primary virtual disk Enclose the primary virtual disk name in double quotation marks secondary The name of an existing virtual disk on the remote storage array that you w...

Page 174: ...t I O activity Valid values are highest high medium low or lowest 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 vir...

Page 175: ...imary virtual disk to the secondary virtual disk in the same order as the host writes to the primary virtual disk In the event of a transmission link failure the data is buffered until a full synchronization can occur This action can require additional system overhead to maintain the buffered data which slows operations Setting the writeOrder parameter to notPreserved frees the system from having ...

Page 176: ...tVirtualDisk sourceVirtualDisk sourceVirtualDiskName repositoryRAIDLevel 1 5 6 repositoryDriveCount numberOfPhysicalDisks repositoryDiskGroupUserLabel repositoryDiskGroupName driveMediaType HDD SSD unknown allMedia physicalDiskType SAS enclosureLossProtect TRUE FALSE userLabel snapshotVirtualDiskName warningThresholdPercent percentValue repositoryPercentOfSource percentValue repositoryUserLabel re...

Page 177: ...repositoryName repositoryFullPolicy failSourceWrites failSnapshot Syntax Existing Repository Disk Group create snapshotVirtualDisk sourceVirtualDisk sourceVirtualDiskName repositoryDiskGroup repositoryDiskGroupName repositoryUserLabel repositoryName freeCapacityArea freeCapacityIndexNumber userLabel snapshotVirtualDiskName warningThresholdPercent percentValue repositoryPercentOfSource percentValue...

Page 178: ...nt Number of unassigned physical disks to use for the repository virtual disk repositoryDiskGroupUserLabel Use this parameter when you create a new disk group The name of a new disk group to be used for the repository virtual disk Enclose the repository disk group name in double quotation marks repositoryDiskGroup Sequence number of the disk group where the repository virtual disk is located userL...

Page 179: ...sion enclosure unknown Use if you are not sure what types of physical disk media are in the expansion enclosure 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 disks that you want to use for the snapshot repository virtual disk The valid physical disk type is SAS You must specify a physical dis...

Page 180: ...roup where the source virtual disk resides does not have enough space this command fails warningThresholdPercent The percentage of repository capacity at which you receive a warning that the 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 repository virtual disk as a percentage of the source ...

Page 181: ...ult name using the source virtual disk name For example if the source virtual disk name is aaa and does not have a snapshot virtual disk the default snapshot virtual disk name is aaa 1 If the source virtual disk already has n 1 number of snapshot virtual disks the default name is aaa n If the source virtual disk name is aaa and the source virtual disk does not have a repository virtual disk the de...

Page 182: ...se methods You can enter up to 189 alphanumeric characters for a key identifier The key identifier cannot have these characters White spaces Parameter Description keyIdentifier A character string that you can read that is a wrapper around a security key passPhrase A character string that encrypts the security key so that you can store the security key in an external file file The file path and the...

Page 183: ...Disk Copy This command creates a virtual disk copy and starts the virtual disk copy operation CAUTION Before you create a new copy of a source virtual disk stop any data access I O activity or suspend data transfer to the source virtual disk and if applicable the target disk to ensure that you capture an accurate point in time image of the source virtual disk Close all applications including Windo...

Page 184: ...hens 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 target Name of an existing virtual disk to use as the target virtual disk You must put quotation marks around the target virtual disk name NOTE You can use any combination of alphanumeric characters hy...

Page 185: ...the priority that a virtual disk copy has relative to host I O activity Valid entries are highest high medium low or lowest NOTE CopyPriority defines the amount of system resources used to copy the data between the source virtual disk and target virtual disk of a virtual disk copy pair If you select the highest priority level the virtual disk copy uses the most system resources to perform virtual ...

Page 186: ... deletes a host group CAUTION This command deletes all of the host definitions in the host group Parameter Description diskGroup Number of the disk group to delete You must put brackets around the disk group number 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 hos...

Page 187: ...lete You must put brackets around the host group name If the name of the host group has special characters you must also put quotation marks around the host group name NOTE A host group is an optional topological element that is a collection of hosts that share access to the same virtual disks The host group is a logical entity ...

Page 188: ... port Syntax delete hostPort hostPortName Parameter Example c delete host job2900 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 port provides a host access to the virtual disks in a storage array If the ho...

Page 189: ...ks or snapshot repository virtual disks CAUTION All the data in the virtual disk is lost as soon as you run this command Syntax delete allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN removeDiskGroup TRUE FALSE Parameters Description iSCSI ID The identifier of the iSCSI initiator that you want to delete Enclose the name in double quotation marks name The n...

Page 190: ...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 If the virtual disk name has special chara...

Page 191: ... 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 loopbackPhysicalDiskChannel Physical disk channel on which to run the diagnostic tests You can choose to run the diagnostics on all channels or select a specific channel on which to run diagnostics Valid phys...

Page 192: ...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 to use as test data Enclose the path and file name with quotation marks Parameter Description ...

Page 193: ... a list of the feature identifiers for all enabled features in the storage array Syntax disable storageArray featurePack feature storagePartition2 storagePartition4 storagePartition8 storagePartition16 storagePartition32 storagePartition64 storagePartition96 storagePartition128 storagePartition256 storagePartitionMax snapshot2 snapshot4 snapshot8 snapshot16 remoteReplication8 remoteReplication16 P...

Page 194: ...mand disables the Remote Replication premium feature and takes away the structure of the replication repository virtual disk To use the High Performance Tier premium feature you must configure a storage array as SHIPPED_ENABLED SHIPPED_ENABLED FALSE KEY_ENABLED TRUE Download Enclosure Management Module Firmware This command downloads firmware for the enclosure management module Syntax download all...

Page 195: ...he selected physical disk enclosure the enclosure might become unusable Parameter Description enclosure Identifies the enclosure to which to load new firmware Enclosure ID values are 0 to 99 You must put brackets around the enclosure ID value You can use the following parameters The allEnclosures parameter which downloads new firmware to all of the EMMs in the storage array The enclosure parameter...

Page 196: ...storage array This command blocks all I O activity until the download finishes or fails The download returns one of the following statuses Successful Unsuccessful With Reason Never Attempted With Reason Syntax download physicalDisk enclosureID slotID firmware file filename Parameters Parameter Description physicalDisk Physical disk to which to download the firmware image Specify the enclosure ID a...

Page 197: ... Description NVSRAM Specifies that you want to download a file with NVSRAM values when you download a firmware file You must not put brackets around this parameter Include a comma after the term firmware file File path and name of the file that contains the firmware Valid file names must end with a dlp extension You must put quotation marks around the file name NVSRAM filename File path and name o...

Page 198: ...tware returns an error if you try to download more firmware image files than the storage array can accept downgrade Specifies that you are loading firmware that is a previous version The default value is FALSE Set downgrade to 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 yo...

Page 199: ... you run the stop storageArray downloadPhysicalDiskFirmware command When the download storageArray physicalDiskFirmware command finishes downloading the firmware image each candidate physical disk shows the download status for each physical disk One of these statuses is returned Successful Unsuccessful With Reason Never Attempted With Reason Download Storage Array NVSRAM This command downloads NVS...

Page 200: ...mal and it does not have snapshot virtual disks or repository virtual disks The RAID controller module firmware creates a lock that restricts access to the SED physical disks SED physical disks have a state called Security Capable When you create a security key the state is set to Security Enabled which restricts access to all SED physical disks that exist within the storage array Parameter Descri...

Page 201: ...oller module that you want to revive Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure You must put brackets around the RAID controller module identifier If you do not specify a RAID controller module the storage management software returns a syntax error ...

Page 202: ... copy operation by using an existing virtual disk copy pair NOTE See Preparing Host Servers to Recopy a Virtual Disk on page 87 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 Clos...

Page 203: ...on marks around the source virtual disk name copyPriority Specifies the priority that the virtual disk copy has relative to host I O activity Valid entries are highest high medium low or lowest NOTE CopyPriority defines the amount of system resources used to copy the data between the source and target virtual disks of a virtual disk copy pair If you select the highest priority level the virtual di...

Page 204: ...sk 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 enclosureIDn slotIDn repositoryDiskG...

Page 205: ...e in an existing disk group that you want to use to re create the replication repository virtual disk Free capacity is defined as the free capacity between existing virtual disks in a disk group For example a disk group might have the following areas virtual disk 1 free capacity virtual disk 2 free capacity virtual disk 3 free capacity To use the free capacity following virtual disk 2 you would sp...

Page 206: ...tect parameter to TRUE the storage array returns an error if the RAID controller module firmware cannot provide physical disks that result in the new replication repository virtual disk having enclosure loss protection If you set the enclosureLossProtect parameter to FALSE the storage array performs the operation even if it means that the replication repository virtual disk might not have enclosur...

Page 207: ...ame of the snapshot virtual disk You must put quotation marks around the snapshot virtual disk name If you enter more than one snapshot virtual disk name this command fails warningThresholdPercent Percentage of repository capacity at which you receive a warning that the repository is nearing full Use integer values For example a value of 70 means 70 percent The default value is 50 percent NOTE If ...

Page 208: ...rmed before restarting any snapshot If any of the listed snapshot virtual disks fail the validation the entire command fails and the snapshot 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...

Page 209: ...ce and repository are quiesced until the process is complete NOTE The Microsoft Virtual Shadow Copy Service VSS provider allows the recreation of multiple snapshots simultaneously Remove Remote Replication NOTE This command valid only with Fibre Channel storage arrays This command removes the replication relationship between the primary virtual disk and the secondary virtual disk in a remote repli...

Page 210: ...are brackets If the virtual disk name has special characters you also must enclose the virtual disk name in double quotation marks Parameter Description target Name of the target virtual disk to remove 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 ...

Page 211: ...ion 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 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...

Page 212: ...ription virtualDisk Name of the specific virtual disk for which to repair 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 consistencyError File Name of the file that contains the consistency error information you use to repair the errors You must put quotation marks around ...

Page 213: ... 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 wwID The World Wide Identifier WWID of the physical disk that you want to replace You can use the WWID instead of the virtual disk name to identify the virtual disk Enclose the WW...

Page 214: ...ller module command is sent to RAID controller module 0 to request a reset of RAID controller module 0 then RAID controller module 0 reboots itself by doing a soft reboot If the reset RAID controller module command is sent to RAID controller module 0 to request a reset of RAID controller module 1 then RAID controller module 0 holds RAID controller module 1 in reset and then releases RAID controlle...

Page 215: ...r module the age is reset for the storage array battery or both RAID controller module batteries If you specify a RAID controller module then the age for only that RAID controller module battery is reset Parameter Description controller Specifies the RAID controller module that contains the battery for which to reset the age Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID c...

Page 216: ...ensure that the counts are synchronized between the RAID controller modules If one RAID controller module resets but the second RAID controller module does not reset the host is informed that the RAID controller modules are out of synchronization The host is informed by the time stamps that are reported with the statistics Example c reset storageArray iscsiStatsBaseline Reset Storage Array SAS PHY...

Page 217: ...ications to recognize the new I O path to the virtual disks Resume Remote Replication NOTE This command valid only with Fibre Channel storage arrays This command resumes a suspended Remote Replication operation Syntax resume remoteReplication primary virtualDiskName primaries virtualDiskName1 virtualDiskNameN writeConsistency TRUE FALSE Parameters Parameter Description primary or primaries The nam...

Page 218: ...igned 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 Syntax revive diskGroup diskGroupNumber Parameter writeConsistency The setting to identify the...

Page 219: ...ommand saves the enclosure log sense data to a file Log sense data is maintained by the environmental cards for each enclosure Not all of the environmental cards contain log sense data Syntax save allEnclosures logFile filename Parameter Parameter Description physicalDisk Identifies the enclosure and slot where the physical disk resides Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 Yo...

Page 220: ...TE A file extension is not automatically appended to the saved file You must specify the applicable format suffix for the file If you specify a file extension of txt then the output is in a text file format If you specify a file extension of xml then the output is in an XML file format Parameter Description physicalDiskChannel The identifier number of the physical disk channel for which you want t...

Page 221: ...le filename Parameters Parameter Description logFile Name of the file to which to write the log sense data You must put quotation marks around the file name Parameter Description controller RAID controller module with the NVSRAM values to save Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when ...

Page 222: ...er 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 virtualDiskConfigAn dSettings Saves the virtual disk configuration settings and all of the global settings to the file To save the virtual disk c...

Page 223: ...ts file filename count numberOfEvents Parameters lunMappings Saves the LUN mapping to the file To save the LUN mapping set this parameter to TRUE To prevent saving the LUN mapping set this parameter to FALSE The default value is FALSE Parameter Description file Name of the file to which to save the events You must put quotation marks around the file name count Specifies the number of events or cri...

Page 224: ...e default baseline time 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 co...

Page 225: ... save storageArray performanceStats file filename Parameter Save Storage Array SAS PHY Counts This command saves the storage array SAS PHY counters to a file Syntax save storageArray SASPHYCounts file filename Parameter Parameter Description file Name of the file to which to save the performance statistics You must put quotation marks around the file name Parameter Description file Name of the fil...

Page 226: ...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 detected on the storage array The state capture data An inventory of the versions of the firmware running ...

Page 227: ...age array support related data You must put quotation marks around the file name Parameter Description diskGroup Sequence number of the disk group for which to set properties You must put brackets around the disk group number addPhysical Disks 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...

Page 228: ...the disk group can be imported and you can then identify the hardware errors Syntax set diskGroup diskGroupName forcedState Parameter NOTE You can move the physical disks that comprise a disk group from one storage array to another storage array The CLI provides three commands that let you move the physical disks The commands are start diskGroup export start diskGroup import and set diskGroup forc...

Page 229: ...Script Commands 229 Set Enclosure Attribute This command sets user defined attributes for an enclosure Syntax set enclosure enclosureID chassisName assetTag userID Parameters ...

Page 230: ...ter You cannot use spaces in a chassis name You must put quotation marks around the chassis name assetTag Asset tag name or number to give the new enclosure Asset tags can be any combination of alphanumeric characters with a maximum length of ten characters Alphabetical characters can be uppercase or lowercase You can also use the underscore character _ and the hyphen character You cannot use spac...

Page 231: ...the new storage array Use this operation for emergency recovery only when one or more physical disks need to be changed from a foreign physical disk status and returned to a native status within their original disk group CAUTION Using this command for purposes other than what is stated above might result in data corruption or data loss without notification Syntax set physicalDisk enclosureID slotI...

Page 232: ...st name in square brackets If the host name has special characters you must also enclose the host name in double quotation marks hostGroup The host group to which you want to assign the host The following table defines how the command runs if the host does or does not have individual virtual disk to LUN mappings Enclose the host group name in double quotation marks The defaultGroup is the host gro...

Page 233: ...as Individual Virtual Disk to LUN Mappings Host Does Not Have Individual Virtual Disk to LUN Mappings hostGroupName The host is removed from the present host group and is placed under the new host group defined by hostGroupName The host is removed from the present host group and is placed under the new host group defined by hostGroupName none The host is removed from the host group as an independe...

Page 234: ...h you want to set the loop ID The host channel identifier number is constructed by combining the controller number and the host channel number Enclose the host channel identifier number in square brackets Separate the controller number from the host channel number with a comma For example the identifier number for host channel 2 on controller 0 would be 0 2 preferredID The port identifier for the ...

Page 235: ...have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation 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 g...

Page 236: ... maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation Parameter Description hostPort The name of the HBA host port for which you want to change the host type or for which you want to create a new name Enclose the HBA host port name in square brackets If the HBA host port label has special characters enclose the H...

Page 237: ... the peers sharing a secret A secret is a security key that is similar to a password NOTE Use the chapSecret parameter only for initiators requiring mutual authentication Parameter Description iscsiID The name of the iSCSI initiator for which you want to set attributes userLabel The new name that you want to use for the iSCSI initiator host The name of the new host to which the HBA host port is co...

Page 238: ...ing mutual authentication NOTE The targetAlias is a descriptive name that you can give to the target to help make it easier to identify You can use any combination of alphanumeric characters hyphens and underscores for the targetAlias The targetAlias can have a maximum of 30 characters Parameter Description iSCSIID The iSCSI target for which you want to set properties Enclose the name in double qu...

Page 239: ...ical disk channel for which to set the status Valid physical disk channel values are 1 or 2 You must put brackets around the physical disk channel number status Condition of the channel You can set the channel status to optimal or degraded NOTE Use the optimal parameter to move a degraded channel back to the Optimal state Use the degraded parameter if the channel is experiencing problems and the s...

Page 240: ...meters 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 hotSpare The setting to assign the physical disk as the hot spare To assign the physical disk as the hot spare set this parameter to TRUE To remove a...

Page 241: ...tes for the RAID controller modules Syntax set controller 0 1 availability online offline serviceMode ethernetPort 1 2 ethernetPortOptions globalNVSRAMByte nvsramOffset nvsramByteSetting nvsramBitSetting hostNVSRAMByte hostType nvsramOffset nvsramByteSetting nvsramBitSetting IPv4GatewayIP ipAddress IPv6RouterAddress ipv6Address iscsiHostPort 1 2 3 4 Parameter Description physicalDisk or physicalDi...

Page 242: ...ervice 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 globalNVSRAMByte A portion of the RAID controller module NVSRAM Specify the region to be modified using the st...

Page 243: ...teway address the subnet mask address the IPv4 priority and the IPv6 priority rloginEnabled The setting for whether the remote login feature is turned on or turned off To turn on the remote login feature set this parameter to TRUE To turn off the remote login feature set this parameter to FALSE serviceAllowedIndicator The setting for whether the Service Action Allowed indicator light is turned on ...

Page 244: ...5 0 255 0 255 duplexMode TRUE FALSE portSpeed autoNegotiate 10 100 1000 IPv4Address 0 255 0 255 0 255 0 255 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 0 FFFF IPv6RouterAddress 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF enableIPv4 TRUE FALSE enableIPv6 TRUE FALSE enableIPv4Vlan TRUE FALSE e...

Page 245: ...rnet 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 The maxFramePayload option is shared between...

Page 246: ...arameter is 3260 Values for the portSpeed option of the iscsiHostPort parameter are in megabits per second Mb s Set Remote Replication NOTE This command valid only with Fibre Channel storage arrays This command defines the properties for a remote replication pair Syntax set remoteReplication localVirtualDisk virtualDiskName localVirtualDisks virtualDiskName1 virtualDiskNameN role primary secondary...

Page 247: ...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 syncPriority The priority that full synchronization has relative to host I O activity Valid values are...

Page 248: ...t data from the primary virtual disk to the secondary virtual disk in the same order as the host writes to the primary virtual disk In the event of a transmission link failure the data is buffered until a full synchronization can occur This action can require additional system overhead to maintain the buffered data which slows operations Setting the writeOrder parameter to notPreserved frees the s...

Page 249: ...on after encountering an error The default value is stop This parameter defines the action for execution errors not syntax errors Some error conditions might override the continue value password The password for the storage array Enclose the password in double quotation marks performanceMonitorInterval The frequency of gathering performance data Enter an integer value for the polling interval in s...

Page 250: ...their default values Set Snapshot Virtual Disk This command defines the properties for a snapshot virtual disk and lets you rename a snapshot virtual disk Syntax set virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN userLabel snapshotVirtualDiskName warningThresholdPercent percentValue repositoryFullPolicy failSourceWrites failSnapshot Parameters Parameter Description virt...

Page 251: ...BlockSizeValue cacheFlushStart cacheFlushStartSize cacheFlushStop cacheFlushStopSize defaultHostType hostTypeName hostTypeIdentifier failoverAlertDelay delayValue mediaScanRate disabled 1 30 password password userLabel storageArrayName isnsRegistration TRUE FALSE warningThresholdPerce nt The percentage of repository capacity at which you receive a warning that the snapshot repository is nearing fu...

Page 252: ...are 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 cacheFlushStart The percentage of unwritten data in the cache that causes a cache flu...

Page 253: ...s Do not enclose the host type numerical identifier in double quotation marks failoverAlertDelay The failover alert delay time in minutes The valid values for the delay time are 0 to 60 minutes The default value is 5 mediaScanRate The number of days over which the media scan runs Valid values are disabled which turns off the media scan or 1 day to 30 days where 1 day is the fastest scan rate and 3...

Page 254: ...state informationusing this command an initial collection of information starts Collecting information after the you issue the command makes sure that one archive file is available and starts the time stamp cycle You can run the set storageArray autoSupportConfig command on more than one storage array Cache Block Size When you define cache block sizes use the 4 KB cache block size for storage arra...

Page 255: ...ta for a host read requires a physical disk read rather than reading from the cache Default Host Type When you define host types if Storage Partitioning is enabled the default host type affects only those virtual disks that are mapped in the default group If Storage Partitioning is not enabled all of the hosts that are attached to the storage array must run the same operating system and be compati...

Page 256: ...rth position The enclosurePositions sequence 1 84 50 12 places the RAID enclosure in the second position expansion enclosure 1 in the first position expansion enclosure 50 in the third position and expansion enclosure 12 in the fourth position 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 ...

Page 257: ...iSNS Syntax set storageArray isnsIPv4ConfigurationMethod static dhcp isnsIPv4Address ipAddress 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 Parameter Description isnsIPv4Address The IP address that you want to use for...

Page 258: ...nsible for these activities Listening monitoring for incoming client connection requests Managing the traffic to the server When a client requests a network session with a server a listener receives the actual request If the client information matches the listener information then the listener grants a connection to the database server Parameter Description isnsIPv6Address The IPv6 address that yo...

Page 259: ...n cycle If a value is not entered the command uses a default value of 00 00 midnight If the day and time specified are in the past the next learn cycle takes place on the next possible day specified 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 sche...

Page 260: ... using the security key Before you can set the security key you must use the create storageArray securityKey command to create the security key Syntax set storageArray securityKey Parameters None Additional Information Security capable physical disks have hardware to accelerate cryptographic processing and each has a unique physical disk key A security capable physical disk behaves like any other ...

Page 261: ...yKey command commits the security key to all of the RAID controller modules and security enabled physical disks in the storage array The self encrypting disk feature ensures that if a security enabled physical disk is physically removed from a storage array its data cannot be read by any other device unless the security key is known Set Storage Array Time This command sets the clocks on both RAID ...

Page 262: ...e available to the targets Set Virtual Disk 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 show which parameters apply to several virtual disks and which apply to only one virtual d...

Page 263: ...pplication features a continuous string of Writes However Write Cache does introduce some risk of data loss in the unlikely event of a controller failure Syntax Applicable to Only One Virtual Disk set virtualDisk virtualDiskName virtualDisk wwID addCapacity virtualDiskCapacity addPhysicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slotIDn consistencyCheckEnabled TRUE FALSE segment...

Page 264: ...around the WWID 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 p...

Page 265: ...er to TRUE To turn off the read cache set this parameter to FALSE writeCacheEnabled The setting to turn on or turn off the write cache To turn on the write cache set this parameter to TRUE To turn off the write cache set this parameter to FALSE cacheReadPrefetch The setting to turn on or turn off cache read prefetch To turn off cache read prefetch set this parameter to FALSE To turn on cache read ...

Page 266: ...t to FALSE segmentSize Amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk Valid values are 8 16 32 64 128 256 or 512 For information about the segmentSize parameter see Using the Auto Configure Command on page 54 userLabel Specifies the new name to give an existing virtual disk You must put qu...

Page 267: ...ng operations use the show virtualDisk actionProgress command accessVirtualDisk Specifies the logical unit number for the access virtual disk The logical unit number is the only property that you can set for the access virtual disk NOTE If you specify the accessVirtualDisk parameter the only property that you can set is the logicalUnitNumber logicalUnitNumber Defines specific virtual disk to LUN m...

Page 268: ...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 If the source virtual disk name has special characters you must also put quotation marks around the source virtual disk name copyPrio...

Page 269: ...e information displayed enter a specific iSCSI initiator or a specific iSCSI target The command then displays only information about that particular iSCSI initiator or iSCSI target session Parameter Description initiatorName The name of the iSCSI initiator for which session information is desired Enclose the iSCSI initiator name in double quotation marks The name and quotation marks must also be e...

Page 270: ...ee 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 on page 166 Syntax show diskGroup diskGroupNumber Parameter Show Disk Group Export Dependencies This command shows a list of dependencies for the physical disks in a disk group that you want to move from one storage array to a ...

Page 271: ...elImport parameter can be enforced to spin the physical disks back down You must run the show diskGroup importDependencies command before you run the start diskGroup import command Parameter Description diskGroup Number of the disk group for which to display information You must put brackets around the disk group number Parameter Description diskGroup Number of the disk group for which to display ...

Page 272: ...port information similar to this example Show Physical Disk For each physical disk in the storage array this command returns the following information The total number of physical disks The type of physical disk SAS Basic physical disk information Enclosure location and slot location Status 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 ...

Page 273: ... 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 Syntax show allPhysicalDisks driveMediaType HDD SSD unknown allMedia physicalDiskType SAS physicalDisk enclosureID slotID physicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slo...

Page 274: ...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 for which you want to retrieveinformation The valid physical disk type is SAS physicalDisk or physicalDisks Identifies the enclosure and slot where the physical disk resides You can enter enclosure IDs and slot IDs for one or several physical...

Page 275: ...Syntax show physicalDiskChannel 1 2 physicalDiskChannels 1 2 allPhysicalDiskChannels stats Parameters Parameter Description physicalDiskChannel Identifier number of the physical disk port for which to display information Valid physical disk port values are 1 or 2 You must put brackets around the physical disk channel values physicalDiskChannels Identifier number of the physical disk ports for whic...

Page 276: ...d shows the firmware download status of each targeted physical disk This command returns the status values shown in the following table Show RAID Controller Module For each RAID controller module in a storage array this command returns the following information Status Online Offline Current firmware and NVSRAM configuration Pending firmware and NVSRAM configuration configurations if any Board ID P...

Page 277: ...AID controller modules in the storage array controller Returns information about a specific RAID controller module in the storage array Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure You must put brackets around the RAID controller module identifier sum...

Page 278: ... Returns information about both RAID controller modules in the storage array controller Returns information about a specific RAID controller module in the storage array Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID controller module on the left and 1 is the RAID controller module on the right when viewed from the rear of the enclosure You must put brackets around the RAID...

Page 279: ...emoteReplication candidates primary virtualDiskName remoteStorageArrayName storageArrayName 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 seco...

Page 280: ...the storage array The parameters return lists of values for the components and features in the storage array You can enter the command with a single parameter or more than one parameter If you enter the command with no parameters the entire storage array profile is displayed which is the same information as if you entered the profile parameter Syntax show storageArray autoSupportConfiguration prof...

Page 281: ...r to the following smcli 123 45 67 89 c show storagearray profile o c folder storagearray profile txt NOTE The previous command syntax is for a host running Windows The actual syntax varies depending on your operating system autoSupportConfiguration The parameter to return information about the current state of the operation to automatically collect support data The information this parameter retu...

Page 282: ...ptions you must specify the raidLevel option When you specify auto configuration properties the RAID controller modules validate that the firmware can support the properties healthStatus Displays the health logical properties and physical component properties of the storage array hostTypeTable Displays a table of all host types known to the RAID controller module Each row in the table displays a h...

Page 283: ...torage 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 Integer values are required For information about the number of physical disks that you can use in a disk group see Enclosure ...

Page 284: ...the segmentSize parameter see Using the Auto Configure Command on page 54 cacheReadPrefetch The setting to turn on or turn off cache read prefetch To turn off cache read prefetch set this parameter to FALSE To turn on cache read prefetch set this parameter to TRUE securityType The setting to specify the security level when creating the disk groups and all associated virtual disks These settings ar...

Page 285: ...get negotiation Syntax show storageArray iscsiNegotiationDefaults Parameters None NOTE Information returned includes RAID controller module default settings settings that are the starting point for negotiation and the current active settings 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 n...

Page 286: ...rray that cannot be read The table is organized with column headings for the following information Virtual disk user label Logical unit number LUN Accessible by host or host group Date time Virtual disk relative logical block address hexadecimal format 0xnnnnnnnn Physical disk location enclosure t slot s Physical disk relative logical block address hexadecimal format 0xnnnnnnnn Failure type The da...

Page 287: ...the virtual disks in a storage array this command returns the following information The number of virtual disks The name The status The capacity The RAID level The disk group where the virtual disk is located Details The virtual disk ID The subsystem ID The physical disk type SAS Enclosure loss protection The preferred owner The current owner The segment size The modification priority The read cac...

Page 288: ... copies Syntax show allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN summary Parameters Parameter Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array virtualDisk or virtualDisks The name of the specific virtual disk for which you are retrieving information You can enter more than one virtual dis...

Page 289: ...ters Show Virtual Disk Copy 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 p...

Page 290: ...xample Virtual Disk Name finance Capacity 4 0 GB Disk Group 1 Parameter Description allVirtualDisks Returns information about virtual disk copy operations for all virtual disk copy pairs source Name of the source virtual disk about which to retrieve information You must put quotation marks and brackets around the source virtual disk name The source virtual disk name and quotation marks must be ins...

Page 291: ... Virtual Disk Performance Statistics This command returns information about the performance of the virtual disks in a storage array Syntax show allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN performanceStats Parameter Description source Name of the source virtual disk for which you are trying to find a candidate target virtual disk You must put quotation...

Page 292: ...tual 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 Parameter Description allVirtualDisks Returns reservation information about all virtual disks in the storage array virtualDisk or virtualDisks Name of the specific virtua...

Page 293: ...ta FirmwareUpgradeReports times tamp_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 Saves a ZIP file containing raw binary data The controller firmware saves the ZIP file to this location Install_dir data FirmwareUpgradeReports timestamp_buildNo zip The binary data c...

Page 294: ...ator LEDs on the physical disks Use the stop diskGroup blink command to turn off the indicator LEDs on the physical disks Syntax start diskGroup diskGroupNumber blink Parameter Start Disk Group Defragment 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 ...

Page 295: ...Group 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 After the disk grou...

Page 296: ...are associated with the premium features from one storage array to another storage array Syntax start diskGroup diskGroupName import Parameter NOTE Higher level virtual disks that are specifically related to premium features Snapshot Remote Virtual Disk Mirroring Virtual Disk Copy mapping and persistent reservations are removed as part of the import operation You must run the show diskGroup import...

Page 297: ...pRefresh Parameters NOTE This operation ends the iSCSI connections for the portal and brings down the portal temporarily Parameter Description enclosure Identifies the enclosure to blink Enclosure ID values are 0 to 99 You must put brackets around the enclosure ID value Parameter Description controller The identifier letter of the RAID controller module that has the iSCSI host ports Valid RAID con...

Page 298: ...se the stop physicalDiskChannel blink command to turn off the indicator lights on the expansion enclosure Syntax start physicalDiskChannel 1 2 blink Parameter Parameter Description physicalDisk The location of the physical disk that you want to find For high capacity expansion enclosures specify the enclosure ID value and the slot ID value of the physical disk that you want to revive Enclosure ID ...

Page 299: ...escription 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 controller The identifier letter of the RAID controller module that you want to test Valid RAID controller module identifier values are 0 or 1 where 0 is the RAID controller module on the left an...

Page 300: ... all user data is erased Syntax start physicalDisk enclosureID slotID initialize Parameters patternNumber The hexadecimal data pattern you want to use to run the test This number can be any hexadecimal number between 0000 to FFFF maxErrorCount The number of errors that you want to accept before terminating the test testIterations The number of times that you want to repeat the test timeout The len...

Page 301: ...all physical disks in an array that contains only SED physical disk type the physical disks should be erased in two groups using the start secureErase physicalDisks command For example if there are seven 7 SED physical disks the secure erase can be performed by executing start secureErase physicalDisks 0 0 0 1 0 2 0 3 start secureErase physicalDisks 0 4 0 5 0 6 Syntax start secureErase physicalDis...

Page 302: ...y Use the stop storageArray blink command to turn off the indicator LED for the storage array Syntax start storageArray blink Parameters None Parameter Description physicalDisk or physicalDisks Identifies the enclosure and slot where the physical disk resides 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 Parameter D...

Page 303: ...he configuration but did not set the configuration to DHCP running the start storageArray isnsServerRefresh returns an error Start Virtual Disk Initialization This command starts the formatting of a virtual disk in a storage array NOTE Initializing a virtual disk is a long running operation that you cannot stop Syntax start virtualDisk virtualDiskName initialize Parameter Parameter Description vir...

Page 304: ...ration diagnostic test can be started through the storage management software GUI but cannot be stopped through the storage management software GUI If you want to stop a running diagnostic test you must use the stop storageArray configDbDiagnostic command Stop Disk Group Blink This command turns off the indicator LED on the physical disk that was turned on by the start diskGroup blink command Synt...

Page 305: ...Disk Channel Fault Isolation Diagnostics This command stops the physical disk port fault isolation diagnostics which stops the start physicalDisk channel fault isolation diagnostics command before it completes Syntax stop physicalDiskChannel faultDiagnostics Parameters None NOTE Use the start physicalDiskChannel faultDiagnostics command and the save physicalDiskChannel faultDiagnostics command wit...

Page 306: ...rns off the indicator lights on the storage array that were turned on by the start storageArray blink command Syntax stop storageArray blink Parameters None Parameter Description virtualDisk or virtualDisks 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 a...

Page 307: ...irmware command This command does not stop a firmware download that is already in progress to a physical disk however this command stops all firmware downloads to physical disks that are waiting for the download Syntax stop storageArray physicalDiskFirmwareDownload Parameters None Stop Virtual Disk Copy This command stops a virtual disk copy operation Syntax stop virtualDiskCopy target targetName ...

Page 308: ...t virtual disk name If the target virtual disk name has special characters you must also put quotation marks around the target virtual disk name source Name of the source virtual disk for which to stop a virtual disk copy operation You must put brackets around the source virtual disk name If the source virtual disk name has special characters you must also put quotation marks around the source vir...

Page 309: ...Replication virtualDisk A writeConsistency TRUE suspends A A B B and C C If you have a write consistency group 1 A B C and write consistency group 2 D E F the command suspend remoteReplication virtualDisks A D writeConsistency TRUE suspends both write consistency groups writeConsistency This parameter defines whether the virtual disks identified in this command are in a write consistency group or ...

Page 310: ...contain at least one uppercase letter The pass phrase must contain at least one lowercase letter The pass phrase must contain at least one number The pass phrase must contain at least one non alphanumeric character for example NOTE If your pass phrase does not meet these criteria you receive an error message Parameter Description file The file path and the file name to which you want to save the s...

Page 311: ...Script Commands 311 ...

Page 312: ...312 Script Commands ...

Page 313: ...orage arrays You can also use this file to restore an existing configuration that has become corrupted You can also copy an existing file to serve as a pattern from which you create a new script file by modifying portions of the original file The default file extension is scr Create a new script file using a text editor such as Microsoft Notepad The maximum line length is 256 characters The comman...

Page 314: ...ty 2GB show Setting additional attributes for virtualDisk 7 Configuration settings that cannot be set during virtualDisk creation set virtualDisk 7 mediaScanEnabled false set virtualDisk 7 consistencyCheckEnabled false set virtualDisk 7 modificationPriority high This example shows blank lines between the lines beginning with Show Create Note and create The blank lines are included in this example ...

Page 315: ...label is 7 Note the quotation marks around the 7 The quotation marks indicate that the information in the marks is a label The new virtual disk is assigned to the RAID controller module in slot 0 in the RAID enclosure The segment size is set to 16 The following syntax is the general form of the command create virtualDisk diskGroup diskGroupNumber userLabel virtualDiskName freeCapacityArea freeCapa...

Page 316: ...w virtual disk using the create virtualDisk command with user defined physical disks in the storage array Show Create RAID 5 Virtual Disk 2 on existing Disk Group 2 This command creates the disk group and the initial virtual disk on that group Note For disk groups that use all available capacity the last virtual disk on the group is created using all remaining capacity by omitting the capacity vir...

Page 317: ...s to include in the virtual disk To find out what physical disks are available in a storage array run the show storageArray profile command The following syntax is the general form of the create virtualDisk command shown in the previous example create virtualDisk raidLevel 0 1 5 6 userLabel virtualDiskName physicalDisks enclosureID0 slotID0 enclosureIDn slotIDn capacity virtualDiskCapacity owner 0...

Page 318: ...318 Sample Script Files ...

Page 319: ...rent configuration so that you can reinstall it if the changes do not work New Commands The following commands have been added to this guide to reflect the additional functionality available in the PowerVault MD3600f series of storage arrays Note that these commands are valid only with Fibre Channel storage arrays Activate Remote Replication Feature Check Remote Replication Status Create Remote Re...

Page 320: ... has been updated Create RAID Virtual Disk Manual Physical Disk Select Syntax has been updated Create Snapshot Virtual Disk Syntax has been updated Diagnose RAID Controller Module Description of syntax has been updated Replace Physical Disk Syntax and parameter descriptions have been updated Set Disk Group Additional parameters and descriptions added Set iSCSI Initiator Syntax has been updated Set...

Page 321: ... array firmware pending 151 virtual disk reservations 152 CLI commands 18 usage examples 29 clocks RAID controller module synchronizing 119 collecting physical disk data 123 command formatting rules 130 command line interface how to use 16 command line parameters 20 commands listed alphabetically 140 listed by function 132 commands listed by function 132 comments adding 43 configuration script exa...

Page 322: ... group 122 delete disk group 186 host 186 host group 186 host port 188 iSCSI initiator 189 Snapshot Virtual Disk 76 77 virtual disk 189 detailed error reporting 26 determining Virtual Disk Copy candidates 81 what is on your storage array 46 diagnosing RAID controller module 123 190 disable storage array feature 193 disk group commands 132 create disk group 154 defragmenting 122 294 delete disk gro...

Page 323: ...ete host group 186 set host group 235 host port create host port 160 delete host port 188 set 236 show host ports 272 hot spare assigning global hot spares 61 set physical disk hot spare 262 how to use the command line interface 16 I initializing physical disk 126 virtual disk 127 interaction with other features 90 ISCSI recurring syntax values 41 iSCSI commands 134 iSCSI initiator create iSCSI in...

Page 324: ...w 276 RAID level changing 121 reconstructing a physical disk 127 recopy virtual disk 88 202 recopying virtual disk 87 recovery operations 124 re creating snapshot virtual disk 78 recurring syntax elements 36 redistributing virtual disk 128 redundancy check running 117 remove copy pairs 90 persistent reservations 118 virtual disk copy 210 virtual disk LUN mapping 211 repair virtual disk consistency...

Page 325: ...on command 136 Set 227 set enclosure id 230 foreign physical disk to native 231 host group 235 physical disk channel status 239 physical disk hot spare 262 virtual disk 262 Virtual Disk Copy 268 set controller 227 set disk group 227 set enclosure attribute 229 set host 232 set host port 236 set iSCSI initiator 237 set iSCSI target properties 238 setting controller clocks 59 modification priority 6...

Page 326: ...ment 294 enclosure blink 297 physical disk initialize 300 physical disk reconstruction 301 storage array blink 302 virtual disk initialization 303 start disk group import 303 Start Disk Group Import Export 303 start iSCSI DHCP refresh 297 start physical disk channel fault isolation diagnostics 299 stop disk group blink 304 enclosure blink 304 Snapshot Virtual Disk 76 77 storage array physical disk...

Page 327: ...ting in an existing disk group 53 creating with software assigned physical disks 52 creating with user assigned physical disks 50 initializing 127 recopy 88 recopy virtual disk 202 recopying 87 redistributing 128 repair consistency 212 set 262 Virtual Disk Copy command 139 show 289 stop 307 viewing properties 84 virtual disk copy remove 210 ...

Page 328: ...Index 328 ...

Search results

Summary of Contents for PowerVault MD3600f Series

Reviews:

Related manuals for PowerVault MD3600f Series

Brands by name

Popular brands

Dell PowerVault MD3600f Series, Command Line Interface Manual

Search results

Summary of Contents for PowerVault MD3600f Series

Reviews:

Related manuals for PowerVault MD3600f Series

Brands by name

Popular brands