Dell PowerVault MD3200 Series, Cli Manual

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

Page 2: ...r whatsoever 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 Othertrademarksandtradenamesmaybe usedin thispublicati...

Page 3: ...ne Parameters 18 Formatting Considerations 24 Detailed Error Reporting 24 Exit Status 25 Usage Examples 27 2 About the Script Commands 29 Script Command Structure 30 Script Command Synopsis 32 Recurring Syntax Elements 34 Usage Guidelines 40 Adding Comments to a Script File 41 3 Configuring a Storage Array 43 Configuring a Storage Array 44 ...

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

Page 5: ...ates 79 Creating a Virtual Disk Copy 80 Preparing Host Servers to Create a Virtual Disk Copy 80 Copying the Virtual Disk 81 Viewing Virtual Disk Copy Properties 82 Changing Virtual Disk Copy Settings 83 Recopying a Virtual Disk 85 Preparing Host Servers to Recopy a Virtual Disk 85 Recopying the Virtual Disk 86 Stopping a Virtual Disk Copy 87 Removing Copy Pairs 88 Interaction With Other Features 8...

Page 6: ...itoring Performance 96 Changing RAID Levels 97 Changing Segment Size 97 Defragmenting a Disk Group 98 Troubleshooting and Diagnostics 99 Collecting Physical Disk Data 99 Diagnosing a RAID Controller Module 99 Recovery Operations 100 Setting RAID Controller Module Operational Mode 100 Changing RAID Controller Module Ownership 102 Initializing a Physical Disk 102 Reconstructing a Physical Disk 102 I...

Page 7: ...Commands Listed Alphabetically 115 Activate Storage Array Firmware 115 Autoconfigure Storage Array 115 Autoconfigure Storage Array Hot Spares 118 Check Virtual Disk Consistency 118 Clear Physical Disk Port Statistics 120 Clear Storage Array Configuration 120 Clear Storage Array Event Log 121 Clear Storage Array Firmware Pending Area 121 Clear Virtual Disk Reservations 122 Clear Virtual Disk Unread...

Page 8: ...ble Storage Array Feature 157 Download Enclosure Management Module Firmware 158 Download Physical Disk Firmware 160 Download Storage Array Firmware NVSRAM 161 Download Storage Array Physical Disk Frimware 162 Download Storage Array NVSRAM 163 Enable Disk Group Security 164 Enable RAID Controller Module Data Transfer 165 Enable Storage Array Feature 165 Recopy Virtual Disk Copy 166 Recover RAID Vir...

Page 9: ...ave Storage Array Events 184 Save Storage Array iSCSI Statistics 184 Save Storage Array Performance Statistics 185 Save Storage Array SAS PHY Counts 186 Save Storage Array State Capture 186 Save Storage Array Support Data 186 Set Disk Group 187 Set Disk Group Forced State 188 Set Enclosure Attribute 189 Set Enclosure Identification 189 Set Foreign Physical Disk to Native 190 Set Host 191 Set Host ...

Page 10: ...ge Array Time 217 Set Storage Array Unnamed Discovery Session 217 Set Virtual Disk 218 Set Virtual Disk Copy 223 Show Current iSCSI Sessions 224 Show Disk Group 225 Show Disk Group Export Dependencies 225 Show Disk Group Import Dependencies 226 Show Host Ports 227 Show Physical Disk 227 Show Physical Disk Channel Statistics 230 Show Physical Disk Download Progress 230 Show RAID Controller Module 2...

Page 11: ...47 Start Disk Group Defragment 247 Start Disk Group Export 248 Start Disk Group Import 249 Start Enclosure Blink 249 Start iSCSI DHCP Refresh 250 Start Physical Disk Blink 251 Start Physical Disk Channel Blink 251 Start Physical Disk Channel Fault Isolation Diagnostics 252 Start Physical Disk Initialize 253 Start Physical Disk Reconstruction 254 Start Secure Physical Disk Erase 254 Start Storage A...

Page 12: ...259 Stop Storage Array iSCSI Session 259 Stop Storage Array Physical Disk Firmware Download 260 Stop Virtual Disk Copy 260 Validate Storage Array Security Key 261 A Sample Script Files 263 Configuration Script Example 1 263 Configuration Script Example 2 266 B CLI Command Updates 269 Updated Commands 269 Index 271 ...

Page 13: ...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 14: ...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 15: ...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 16: ... 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 17: ...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 18: ... 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 19: ... 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 20: ...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 21: ... 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 22: ...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 23: ...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 24: ...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 25: ...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 26: ...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 27: ...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 28: ... 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 29: ...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 30: ...es identifier list An operand data object can be identified four ways The object types and object qualifiers The all parameter 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 configuration region a...

Page 31: ... Specify a subset of objects with a list of identifiers in brackets for example 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 Obje...

Page 32: ...d provides a definition of each command virtualDiskCopy Target virtual disk and optionally the source virtual disk user labels diskGroup Virtual disk group number 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 ...

Page 33: ... the statement attributes similar to the create command recreate object statement data Restarts a snapshot operation using an existing snapshot virtual disk You can change attributes before the operation is restarted remove object statement data Removes a relationship from between objects repair object statement data Repairs errors found by the check command reset object statement data Returns the...

Page 34: ...e started You can query the progress of some operations stop object statement data Stops an asynchronous operation suspend object statement data Suspends an operation You can then restart the suspended operation and it continues from the point at which it was suspended Table 2 4 Recurring Syntax Elements Recurring Syntax Syntax Value raid level 0 1 5 6 snapshot repository raid level 1 5 6 capacity...

Page 35: ...ing literal error action stop continue physical disk channel identifier 1 2 physical disk channel identifier list physical disk channel identifier physical disk channel identifier host channel identifier 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 ...

Page 36: ...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 37: ... 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 38: ...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 39: ...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 40: ...pt File on page 41 NOTE While the CLI and script commands are not case sensitive user labels such as for virtual disk hosts or host 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 maxFramePayload 1500 NOTE The maxFramePayload parameter is shared between IPv4 and IPv6 The p...

Page 41: ...nd of line character is reached If the script engine does not find an end of line character in the script after processing a comment an error message is displayed and the script operation is terminated This error commonly occurs when a comment is placed at the end of a script and you have not pressed Enter Deletes the existing configuration clear storageArray Configuration The script engine interp...

Page 42: ...42 About the Script Commands ...

Page 43: ...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 44: ...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 45: ...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 46: ...ameter The following show commands return information about the specific components 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 ...

Page 47: ...an help you learn about your storage array To see a list of the commands see Commands Listed by Function on page 108 These commands are organized by the storage array activities that the commands support Examples include virtual disk commands host commands enclosure commands and others Saving a Configuration to a File CAUTION When you write information to a file the script engine does not check to...

Page 48: ...reate virtualDisk command enables you to create new virtual disks in the storage array in three ways Create a new virtual disk while simultaneously creating a new disk group to which you assign the physical disks Create a new virtual disk while simultaneously creating a new disk group to which the MD Storage Manager software assigns the physical disks Create a new virtual disk in an existing disk ...

Page 49: ...lot ID of each physical disk that you want to use Put parentheses around the list Separate the enclosure ID and slot ID of a physical disk by a comma Separate each enclosure ID and slot ID pair by a space For example 0 0 0 1 0 2 0 3 0 4 The capacity parameter defines the size of the virtual disk You do not have to assign the entire capacity of the physical disks to the virtual disk You can later a...

Page 50: ... group You must create hot spares after running this command Creating Virtual Disks with Software Assigned Physical Disks You can let the MD Storage Manager software assign the physical disks when you create the virtual disk To have the software assign the physical disks you need only specify the number of physical disks to use The MD Storage Manager software then chooses the physical disks on whi...

Page 51: ...existing disk group use the following command create virtualDisk DiskGroup diskGroupNumber userLabel virtualDiskName freeCapacityArea freeCapacityIndexNumber capacity virtualDiskCapacity owner 0 1 segmentSize segmentSizeValue NOTE The freeCapacityArea capacity owner and segmentSize parameters are optional You can use one or all optional parameters as needed to help define your configuration though...

Page 52: ...ns You assign the physical disks The RAID controller module assigns the physical disks The following table shows possible results for the enclosureLossProtect parameter The results depend on whether you assign the physical disks or the RAID controller module assigns the physical disks The enclosureLossProtect parameter is not valid when creating virtual disks on existing disk groups Method enclosu...

Page 53: ...MD Storage Manager creates the initial configuration you can use the set virtualDisk command to define virtual disk labels Before running the autoConfigure storageArray command run the show storageArray autoConfigure command The show storageArray autoConfigure command returns a list of parameter values that MD Storage Manager uses to create a storage array Change any of the parameter values by ent...

Page 54: ...es the number of hot spares wanted in each disk group The 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 co...

Page 55: ...t 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 Modifying Your Configurat...

Page 56: ... 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 rename or change If you have more than one storage array in a storage configuration each array has a separa...

Page 57: ...ommand Running this command helps ensure that event timestamps written by RAID controller modules to the Major Event Log MEL match event timestamps written to the host log files The RAID controller modules remain available during synchronization An example of the command is client smcli 123 45 67 89 c set storageArray time Setting the Storage Array Host Type The set storageArray command enables yo...

Page 58: ...ller modules can communicate it does not return a list of the hosts The following examples show how to use the defaultHostType parameter and the hostTypeTable parameter client smcli 123 45 67 89 c show storageArray defaultHostType client smcli 123 45 67 89 c show storageArray hostTypeTable The following example shows how to define a specific default host type client smcli 123 45 67 89 c set storag...

Page 59: ...t 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 operations Assigning Global Hot Spares Hot spare physical disks can replace any failed physical disk in the storage array The hot spare must be the same type of physical disk as the physical di...

Page 60: ...ALSE The following example shows how to use this command to set hot spare physical disks client smcli 123 45 67 89 c set physicalDisks 0 2 0 3 hotSpare TRUE Enter the enclosure ID and slot ID of each physical disk that you want to use You must put brackets around the list Separate the enclosure ID and slot ID of a physical disk by a comma Separate each enclosure ID and slot ID pair by a space ...

Page 61: ...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 62: ... 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 63: ...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 64: ...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 65: ...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 66: ... 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 66 Creating the Initial Snapshot Virtual Disk After first preparing the host server s as specified in the preceding procedure use the following example...

Page 67: ...ervers to Create an Initial Snapshot Virtual Disk on page 65 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 68: ...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 69: ...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 70: ...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 71: ...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 72: ...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 72 for an explanation of naming conventions Names of Snapshot Virtual Disks and Repository Virtual Disks The names of snaps...

Page 73: ...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 74: ...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 75: ...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 76: ...t Virtual Disk on page 75 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 75 The following example shows the ...

Page 77: ...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 78: ...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 79: ...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 80: ...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 81: ...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 82: ...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 80 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 83: ... virtualDiskCopy source Jaba_Hut The command in the preceding example requests information about the source virtual disk Jaba_Hut If you want information about all virtual disks use the allVirtualDisks parameter You can also request information about a specific target virtual disk The following example is the script file version of the command show virtualDiskCopy source Jaba_Hut Changing Virtual ...

Page 84: ...ility 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 snapshot virtual disk At other times you might want to write additional data to the target virtual disk You can use the set virtualDiskCopy command to reset the read write permission for the target virtual disk NOTE If you enabled host writes to the target virtu...

Page 85: ...s copied in its entirety to the target virtual disk Reset the copy priority for the recopy operation by using the recopy virtualDiskCopy command The higher priorities allocate storage array resources to the virtual disk copy at the expense of storage array performance Preparing Host Servers to Recopy a Virtual Disk CAUTION Before you create a new copy of a source virtual disk stop any data access ...

Page 86: ...pies NOTE If your operating system requires additional instructions you can find those instructions in your operating system documentation After your server has been prepared see Recopying the Virtual Disk on page 86 to recopy the virtual disk Recopying the Virtual Disk After first preparing the host server s as specified in the preceding procedure use the following examples to make a virtual disk...

Page 87: ...4 in the preceding section Preparing Host Servers to Recopy a Virtual Disk on page 85 The following example is the script file version of the command recopy virtualDiskCopy target Obi_1 copyPriority highest Stopping a Virtual Disk Copy The stop virtualDiskCopy command enables you to stop a virtual disk copy that has a status of In Progress Pending or Failed After you stop a virtual disk copy you c...

Page 88: ...tual 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 following example shows a command to remove a virtual disk copy pair client smcli 123 45 67 89 c remove virtualDiskCopy target Obi_1 The following example is the script file version of the command remove virtualDiskCopy targ...

Page 89: ...ad only attribute for the target virtual disk Snapshot Virtual Disks A snapshot virtual disk is a point in time image of a virtual disk It is typically created so that an application such as a backup can access the snapshot virtual disk and read the data while the source virtual disk remains online and accessible to hosts CAUTION Before using the source virtual disk of a snapshot virtual disk as y...

Page 90: ...s feature because it enables complete backups without significant impact to the storage array I O However some I O processing resources are lost to the copy operation The Snapshot Virtual Disk feature can be used with the Virtual Disk Copy feature to back up data on the same storage array and to restore the data on the snapshot virtual disk back to its original source virtual disk ...

Page 91: ...ands 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 physical disk media errors before they are found during a normal read fro...

Page 92: ... 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 disk is scanned again If consistency is repaired this forced media error is removed The result of this action is that the first ten consis...

Page 93: ...tion 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 data is compared between the mirrored physical disks and data in...

Page 94: ...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 95: ...ks 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 phy...

Page 96: ... 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 Percen...

Page 97: ...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 98: ...ou 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 99: ... 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 mo...

Page 100: ...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 101: ...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 102: ...e 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 physical disk all old disk group and virtual disk information is erased and the physical disk is returned to an unassigned state Returning a physical disk to an unassigned state adds unconfigured capacity to a storage array ...

Page 103: ...k or disk group To initialize a virtual disk run the following command start virtualDisk virtualDiskName initialize where virtualDiskName is the identifier for the virtual disk Redistributing Virtual Disks Redistributing virtual disks returns the virtual disks to their preferred RAID controller module owners The preferred RAID controller module ownership of a virtual disk or disk group is the RAID...

Page 104: ...tion NOTE You cannot run this command if all virtual disks are currently owned by their preferred RAID controller module or if the storage array does not have defined virtual disks Under some host operating systems you must reconfigure the multipath host driver You might also need to make operating system modifications to recognize the new I O path to the virtual disk ...

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

Page 106: ...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 107: ... 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 108: ...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 Compatability Levels The RAID controller module firmware for commands is 7 70 Commands Listed by Function This section presents the commands organized into groups...

Page 109: ...t Module Firmware on page 158 Save Enclosure Log Data on page 180 Set Enclosure Attribute on page 189 Set Enclosure Identification on page 189 Start Enclosure Blink on page 249 Stop Enclosure Blink on page 257 Host Topology Commands Create Host on page 128 Create Host Group on page 129 Create Host Port on page 129 Create iSCSI Initiator on page 131 Delete Host on page 152 Delete Host Group on page...

Page 110: ... page 197 Show Current iSCSI Sessions on page 224 Show Storage Array Negotiation Defaults on page 238 Start iSCSI DHCP Refresh on page 250 Stop Storage Array iSCSI Session on page 259 Physical Disk Commands Clear Physical Disk Port Statistics on page 120 Download Physical Disk Firmware on page 160 Replace Physical Disk on page 175 Revive Physical Disk on page 180 Save Physical Disk Channel Fault I...

Page 111: ...art Secure Physical Disk Erase on page 254 Stop Physical Disk Blink on page 257 Stop physical disk channel blink Stop Physical Disk Channel Fault Isolation Diagnostics on page 258 RAID Controller Module Commands Clear Physical Disk Port Statistics on page 120 Diagnose RAID Controller Module on page 155 Enable RAID Controller Module Data Transfer on page 165 Reset RAID Controller Module on page 176...

Page 112: ...41 Re create Snapshot on page 170 Set Snapshot Virtual Disk on page 205 Stop Snapshot on page 259 Storage Array Commands Activate Storage Array Firmware on page 115 Autoconfigure Storage Array on page 115 Autoconfigure Storage Array Hot Spares on page 118 Clear Storage Array Configuration on page 120 Clear Storage Array Event Log on page 121 Clear Storage Array Firmware Pending Area on page 121 Cr...

Page 113: ...ve Storage Array State Capture on page 186 Save Storage Array Support Data on page 186 Set Storage Array on page 207 Set Storage Array Enclosure Positions on page 211 Set Storage Array ICMP Response on page 212 Set Storage Array iSNS Server IPv4 Address on page 213 Set Storage Array iSNS Server IPv6 Address on page 213 Set Storage Array iSNS Server Listening Port on page 214 Set Storage Array Lear...

Page 114: ...Virtual Disk Reservations on page 122 Clear Virtual Disk Unreadable Sectors on page 122 Create RAID Virtual Disk Automatic Physical Disk Select on page 131 Create RAID Virtual Disk Free Capacity Base Select on page 134 Create RAID Virtual Disk Manual Physical Disk Select on page 137 Delete Virtual Disk on page 154 Recover RAID Virtual Disk on page 168 Remove Virtual Disk LUN Mapping on page 173 Re...

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

Page 116: ... default parameters or those you selected Syntax autoConfigure storageArray physicalDiskType SAS raidLevel 0 1 5 6 diskGroupWidth numberOfPhysicalDisks diskGroupCount numberOfDiskGroups virtualDisksPerGroupCount numberOfVirtualDisksPerGroup hotSpareCount numberOfHotSpares segmentSize segmentSizeValue cacheReadPrefetch TRUE FALSE securityType none capable enabled Parameters Parameters Parameter Des...

Page 117: ...ntroller 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 53 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 cach...

Page 118: ...gure storageArray hotSpares command the RAID controller module firmware determines the number of hot spares to create based on the total number and type of physical disks in the storage array Check Virtual Disk Consistency This command checks a virtual disk for consistency and media errors and writes the results of the check to a file Syntax check virtualDisk virtualDiskName consistency consistenc...

Page 119: ... marks around the virtual disk name consistencyErrorFile Name of the file in which to save the consistency error information You must put quotation marks around the file name mediaErrorFile Name of the file in which to save the media error information You must put quotation marks around the file name priority Specifies the priority that the consistency check has relative to host I O activity Valid...

Page 120: ...disk group configuration information and virtual disk configuration information only CAUTION As soon as you run this command the existing storage array is deleted Syntax clear storageArray configuration all volumeGroups Parameters If you do not enter a parameter this command removes all configuration information for the storage array except for the information related to security and identificatio...

Page 121: ...r the storage array by deleting the data in the MEL buffer CAUTION As soon as you run this command the existing MEL in the storage array 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 so...

Page 122: ...o overcome this limitation Clear Virtual Disk Unreadable Sectors This command clears the unreadable sector information from one or more virtual disks Syntax clear allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN unreadableSectors Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array virtualDisk or virtualDisks ...

Page 123: ...Dn raidLevel 0 1 5 6 userLabel diskGroupName driveMediaType HDD SSD unknown allMedia capacity virtualDiskCapacity owner 0 1 cacheReadPrefetch TRUE FALSE segmentSize segmentSizeValue usageHint fileSystem dataBase multiMedia enclosureLossProtect TRUE FALSE securityType none capable enabled Parameter Description allVirtualDisks Clears unreadable sector information from all of the virtual disks in the...

Page 124: ... new disk group Enclose the disk group identifier in double quotation marks driveMediaType The type of physical disk media that you want to use for the disk group Valid physical disk media consists of HDD Use this option when you have hard physical disks in the expansion enclosure SSD Use this option when you have solid state physical disks in the expansion enclosure unknown Use if you are not sur...

Page 125: ...ler module in slot 0 and 1 is the RAID controller module in slot1 If you do not specify an owner the RAID controller module firmware determines the owner cacheReadPrefetch The setting to turn on or turn off cache read prefetch To turn off cache read prefetch set this parameter to FALSE To turn on cache read prefetch set this parameter to TRUE segmentSize The amount of data in KB that the RAID cont...

Page 126: ...meter If you do not enter a value the RAID controller module firmware uses the usageHint parameter with fileSystem as the default value Entering a value for the usageHint parameter and a value for the cacheReadPrefetch parameter or a value for the segmentSize parameter does not cause an error The value that you enter for the cacheReadPrefetch parameter or the segmentSize parameter takes priority o...

Page 127: ...ipe A data stripe is the segment size that is multiplied by the number of physical disks in the disk group that are used for data transfers In this case multiple physical disks are used for the same request but each physical disk is accessed only once For optimal performance in a multiuser database or file system storage environment set your segment size to minimize the number of physical disks th...

Page 128: ...u create virtual disks on existing disk groups Create Host This command creates a new host If you do not specify a host group in which to create the new host the new host is created in the default group Syntax create host userLabel hostName hostGroup hostGroupName defaultGroup hostType hostTypeIndexLabel hostTypeIndexNumber Parameters Parameter Description userLabel The name that you want to give ...

Page 129: ...ication The identification is a software value that represents the physical HBA host port to the RAID controller module Without the host port identification the RAID controller module cannot receive instructions or data from the host port hostType The index label or the index number that identifies the host type Use the show storageArray hostTypeTable command to generate a list of available host t...

Page 130: ...ive the new HBA host port You must put quotation marks around the port label host Name of the host for which you are defining an HBA host port You must put quotation marks around the host name 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 on...

Page 131: ... 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 volumeGroupUserLabel diskGroupName raidLevel 0 1 5 6 userLabel virtualDiskName physicalDiskType SAS ...

Page 132: ... 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 volumeGroupUserLabel 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 133: ...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 134: ...p To enforce enclosure loss protection set this parameter to TRUE The default setting is FALSE For information about the enclosureLossProtect parameter see Enclosure Loss Protection on page 52 dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases The default value is TRUE securityType The setting to specify the security level when creating the...

Page 135: ...allowed Command names can have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation freeCapacityArea Index number of the free space in an existing disk group to use to create the new virtual disk Free capacity is defined as the free capacity between existing virtual disks in a disk group For example a disk grou...

Page 136: ...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 The preferred RAID controller module ownership of a virtual disk is the RAID controller module that currently owns the disk group cacheReadPrefetch The setting to turn on or turn off cache read prefetch To ...

Page 137: ...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 securit...

Page 138: ...rs Parameter Description physicalDisks Specifies the physical disks to assign to the created virtual disk Specify the enclosure ID and slot ID for each unassigned physical disk to assign to the virtual disk Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 You must put parentheses around the enclosure ID values and the slot ID values volumeGroupUserLabel The alphanumeric identifier includ...

Page 139: ...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 140: ...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 141: ...sitoryRAIDLevel 1 3 5 6 repositoryPhysicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slotIDn repositoryVolumeGroupUserLabel repositoryDiskGroupName enclosureLossProtect TRUE FALSE dssPreAllocate The setting to make sure that reserve capacity is allocated for future segment size increases The default value is TRUE securityType The setting to specify the security level when creatin...

Page 142: ...ame driveMediaType HDD SSD unknown allMedia physicalDiskType SAS enclosureLossProtect TRUE FALSE userLabel snapshotVirtualDiskName warningThresholdPercent percentValue repositoryPercentOfSource percentValue repositoryUserLabel repositoryName repositoryFullPolicy failSourceWrites failSnapshot Syntax User Defined Disk Group create snapshotVirtualDisk sourceVirtualDisk sourceVirtualDiskName repositor...

Page 143: ...licy failSourceWrites failSnapshot Parameters Parameter Description sourceVirtualDisk Name of the source virtual disk from which to take a snapshot You must put quotation marks around the source virtual disk name repositoryRAIDLevel RAID level for the repository virtual disk Valid values are 0 1 5 or 6 repositoryPhysicalDisks Specifies the physical disks to assign to the repository Specify the enc...

Page 144: ...reating the repository To enforce enclosure loss protection set this parameter to TRUE The default setting is FALSE For information about the enclosureLossProtect parameter see Enclosure Loss Protection on page 52 driveMediaType The type of physical disk media that you want to use for the disk group Valid physical disk media consists of HDD Use this option when you have hard physical disks in the ...

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

Page 146: ...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 default repository virtual d...

Page 147: ...Identifier A character string that you can read that is a wrapper around a security key passPhrase A character string that encrypts the security key so that you can store the security key in an external file file The file path and the file name to which you want to save the security key For example file C Program Files CLI sup seckey slk NOTE You must add a file extension of slk to the end of the ...

Page 148: ... by using one of these methods You can enter up to 189 alphanumeric characters for a key identifier The key identifier cannot have these characters White spaces Punctuation Symbols You can leave out this parameter Additional characters are automatically generated and appended to the end of the string that you enter for the key identifier If you do not enter any string for the keyIdentifier paramet...

Page 149: ...OTE See Preparing Host Servers to Create a Virtual Disk Copy on page 80 NOTE Removing the drive letter of the associated virtual disk s in Windows or unmounting the virtual drive in Linux helps to guarantee a stable copy of the drive for the virtual copy NOTE You can have a maximum of eight virtual disk copies in progress at one time If you try to create more than eight virtual disk copies at one ...

Page 150: ...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 hyphens and underscores for the names Command names can have a maximum of...

Page 151: ...opy 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 disk copy which decreases performance for host data transfers targetReadOnlyEnabled Specifies whether the target virtual disk is write enabled or read only To be able to write to the target ...

Page 152: ...l characters you must also put quotation marks around the host name NOTE A host is a system that is attached to the storage array and accesses the virtual disks on the storage array through its HBA host ports Parameter Description hostGroup Name of the host group to delete You must put brackets around the host group name If the name of the host group has special characters you must also put quotat...

Page 153: ... 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 154: ...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 removeDiskGroup TRUE FALSE virtualDiskName1 virtualDiskNameN 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 155: ...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 156: ... 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 157: ...shot8 snapshot16 remoteMirror8 remoteMirror16 remoteMirror32 remoteMirror64 remoteMirror128 virtualDiskCopy goldKey mixedPhysicalDiskTypes highPerformanceTier SSDSupport Parameters None testID Identifier for the diagnostic test to run The identifier and corresponding tests are 1 Reads the test 2 Write test 3 Data loop back test NOTE When you run a data loop back test you can optionally specify a f...

Page 158: ...structure of the mirror 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 allEnclosures enclosure enclosureID firmware file filename ...

Page 159: ...sures parameter which downloads new firmware to all of the EMMs in the storage array The enclosure parameter which downloads new firmware to a specific EMM If you need to download new firmware to more than one EMM but not all RAID controller modules you must enter this command for each storage array file File path and file name of the file that contains the firmware image You must put quotation ma...

Page 160: ...ht become unusable 3 Do not make any configuration changes to the storage array while downloading the physical disk firmware Attempting to make a configuration change can cause the firmware download to fail and make the selected physical disks unusable You can use this command to test the firmware on one physical disk before installing the firmware on all of the physical disks in a storage array U...

Page 161: ...nclosure ID and slot ID for the physical disk Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 You must put brackets around the enclosure ID value and slot ID value filename File path and file name of the file that contains the firmware image You must put quotation marks around the firmware image file path and file name Parameter Description NVSRAM Specifies that you want to download a f...

Page 162: ...nclude a comma after the firmware file name 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 you must use the activate storageArray firmware command to activ...

Page 163: ...ified firmware images can be downloaded only to a compatible physical disk Use the download physicalDisk firmware command to download a firmware image to a specific physical disk The download storageArray physicalDiskFirmware command blocks all I O activity until a download try has been made for each candidate physical disk or you run the stop storageArray downloadPhysicalDiskFirmware command When...

Page 164: ...sk Security premium feature must be enabled The storage array security key has to be set The disk group is Optimal and it does not have snapshot virtual disks or repository virtual disks Parameter Description file File path and name of the file that contains the NVSRAM values Valid file names must end with a dlp extension You must put quotation marks around the file name Parameter Description disk...

Page 165: ...stics Syntax enable controller 0 1 dataTransfer Parameter Enable Storage Array Feature This command enables a premium feature using a feature key file Syntax enable storageArray featurePack feature file filename Parameter Description controller RAID controller 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 ...

Page 166: ... an existing virtual disk copy pair NOTE See Preparing Host Servers to Recopy a Virtual Disk on page 85 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 inclu...

Page 167: ...ource virtual disk name has special characters you must also put quotation 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 virtua...

Page 168: ...reID2 slotID2 enclosureIDn slotIDn diskGroup diskGroupName newDiskGroup diskGroupName userLabel virtualDiskName virtualDiskWWID virtualDiskWWID capacity virtualDiskCapacity offset offsetValue raidLevel 0 1 5 6 segmentSize segmentSizeValue dssPreallocate TRUE FALSE SSID virtualDiskCapacity owner 0 1 cacheReadPrefetch TRUE FALSE Parameters Parameter Description physicalDisk or physicalDisks Specifie...

Page 169: ... 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 offset Number of blocks from the beginning of the disk group to the beginning of the referenced virtual disk 1 block is equal to 512 bytes raidLevel RAID level of the disk grou...

Page 170: ...mage 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 in Windows or unmounting the virtual drive in Linux helps guarantee a stable copy of the drive for the Snapshot SSID The storage array subsystem identifier of a virtual disk owner RAID controller module th...

Page 171: ...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 172: ...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 173: ...tualDiskCopy target targetName source sourceName Parameters Remove Virtual Disk LUN Mapping This command removes the logical unit number LUN mapping Syntax remove allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNamen accessVirtualDisk lunMapping host hostName hostGroup hostGroupName Parameter Description target Name of the target virtual disk to remove You must...

Page 174: ... from the LUN mapping You can enter more than one virtual disk name You must put quotation marks and brackets around the virtual disk name The virtual disk name and quotation marks must be inside the brackets accessVirtualDisk Removes the access virtual disk 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...

Page 175: ...hich 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 the file name verbose Captures progress details such as per...

Page 176: ...t controller 0 1 Parameter Description physicalDisk Specifies the physical disks to assign to the virtual disk that you want to create Specify the tray ID and slot ID for each physical disk that you assign to the virtual disk Tray ID values are 0 to 99 Slot ID values are 0 to 31 You must put brackets around the tray ID value and the slot ID value physicalDisk wwID The World Wide Identifier WWID of...

Page 177: ...t in some products only resets the IOC chip A hard reboot resets both the IOC chip and the expander chips in the RAID controller module Reset Storage Array Battery Install Date This command resets the age of the batteries in a storage array to zero days You can reset the batteries for an entire storage array or just the battery for a specific RAID controller module or in a specific battery pack Sy...

Page 178: ...odule baselines is to help 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 ...

Page 179: ...ble NOTE Under certain host operating system environments you might be required to reconfigure the multipath host physical disk You might also need to make operating system modifications to recognize the new I O path to the virtual disks Revive Disk Group This command forces the specified disk group and associated failed physical disks to the Optimal state All physical disks assigned to the disk g...

Page 180: ...a 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 diskGroup Number of the disk group to be set to the optimal state You must put brackets around the disk group number Parameter Description physicalDisk Identifies the enclosure and slot where the physical ...

Page 181: ...able 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 Save Physical Disk Log This command saves the log sense data to a file Log sense data is maintained by the storage array for each physical disk Syntax save allPhysicalDisks logFile filename Parameter Descript...

Page 182: ...SE virtualDiskConfigAndSettings TRUE FALSE hostTopology TRUE FALSE lunMappings TRUE FALSE 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...

Page 183: ...e 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 configuration and global settings set this parameter to TRUE To prevent saving the virtual disk configuration and g...

Page 184: ...cs related to the physical Ethernet port Statistics related to the TCP protocol Statistics related to the IP protocol Syntax save storageArray iscsiStatistics raw baseline file filename 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 critical events to save to a file If you do not ente...

Page 185: ...that the statistics collected are all statistics from the RAID controller module start of day Enclose the parameter in square brackets baseline This parameter defines that the statistics collected are all statistics from the time the RAID controller modules were reset to zero using the reset storageArray iscsiStatsBaseline command Enclose the parameter in square brackets file The name of the file ...

Page 186: ...mmand saves the storage array support related information to a file Support related information includes The storage array profile The Major Event Log information The NVSRAM data Current problems and associated recovery information The performance statistics for the entire storage array Parameter Description file Name of the file to which to save the storage array SAS PHY counters You must put quo...

Page 187: ...ler modules the physical disks and the RAID controller modules Syntax save storageArray supportData file filename Parameter Set Disk Group This command defines the properties for a disk group Syntax set diskGroup diskGroupName addPhysicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slotIDn Parameters Parameter Description file Name of the file to which to save the storage array sup...

Page 188: ...up to an Imported state or if the import operation does not work because of hardware errors In a Forced state 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...

Page 189: ...r to give the new enclosure Chassis names can be any combination of alphanumeric characters with a maximum length of 32 characters Alphabetical characters can be uppercase or lowercase You can also use the underscore character _ and the hyphen character 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 enc...

Page 190: ... 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 slotID physicalDisks enclo...

Page 191: ...ot where the physical disk resides Tray ID values are 0 to 99 Slot ID values are 0 to 31 Enclose the tray ID values and the slot ID values in square brackets allPhysicalDisks Selects all the physical disks Parameter Description host The name of the host that you want to assign to a host group Enclose the host name in square brackets If the host name has special characters you must also enclose the...

Page 192: ...ageArray hostTypeTable command to generate a list of available host type identifiers If the host type has special characters enclose it in double quotation marks Host Group Parameter Host Has Individual Virtual Disk 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 ...

Page 193: ...ost 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 specified host port Port ID values ...

Page 194: ...ith angle brackets to overcome this limitation Set Host Port This command changes the host type for an HBA host port You can also change an HBA host port label with this command Syntax set hostPort portLabel host hostName userLabel newPortLabel 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 charac...

Page 195: ...escription hostPort The name of the HBA host port for which you want to change the host type or for which you want to create a new name Enclose the HBA host port name in square brackets If the HBA host port label has special characters enclose the HBA host port label in double quotation marks host The name of the host to which the HBA host port is connected Enclose the host name in double quotatio...

Page 196: ... peer of a connection CHAP is based upon the peers sharing a secret A secret is a security key that is similar to a password NOTE Use the chapSecret parameter only for initiators requiring mutual authentication chapSecret The password that you want to use to authenticate a peer connection Parameter Description ...

Page 197: ...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 198: ...2 slotID2 enclosureIDn slotIDn hotSpare TRUE FALSE Parameter Description physicalDiskChannel Identifier number of the physical disk channel for which to set the status Valid physical disk channel values are 1 or 2 You must put brackets around the physical disk channel number status Condition of the channel You can set the channel status to optimal or degraded NOTE Use the optimal parameter to move...

Page 199: ...the slot where the physical disk resides Tray ID values are 0 to 99 Slot ID values are 0 to 31 Enclose the tray 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 hot spare assignment from a physical disk set this parameter to FALSE Parameter Descri...

Page 200: ...iHostPortOptions rloginEnabled TRUE FALSE serviceAllowedIndicator on off Parameters Parameter Description controller The RAID controller module for which you want to define properties Valid identifiers for the RAID controller module are 0 or 1 where 0 is the RAID controller module in slot 0 and 1 is the RAID controller module in slot 1 Enclose the identifier for the RAID controller module in squar...

Page 201: ...at for the IPv4 gateway is 0 255 0 255 0 255 0 255 IPv6RouterAddress The IP address of IPv6 router that connects two or more logical subnets The address format for the IPv6 router is 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF iscsiHostPort The values that support this parameter are listed in the Syntax Element Statement Data table that follows Many settings are possible including sett...

Page 202: ...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 203: ...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 204: ...es how you want the current script engine session to run Syntax set session errorAction stop continue password storageArrayPassword performanceMonitorInterval intervalValue performanceMonitorIterations iterationValue Parameters Parameter Description errorAction How the session responds if an error is encountered during processing You can choose to stop the session if an error is encountered or you...

Page 205: ...iterations return to 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 performanceMonit...

Page 206: ...irtual disk name if you use the virtualDisks parameter Enclose the snapshot virtual disk name in double quotation marks inside of square brackets userLabel A new name that you want to give to a snapshot virtual disk Enclose the new snapshot virtual disk name in double quotation marks warningThresholdPerce nt The percentage of repository capacity at which you receive a warning that the snapshot rep...

Page 207: ...r failoverAlertDelay delayValue mediaScanRate disabled 1 30 password password userLabel storageArrayName isnsRegistration TRUE FALSE Parameters Parameter Description alarm The setting for the audible alarm This parameter has these values enable The audible alarm is turned on and sounds if a fault occurs disable The audible alarm is turned off and does not sound if a fault occurs mute The audible a...

Page 208: ...ntage This value must be less than the value of the cacheFlushStart parameter defaultHostType The default host type of any unconfigured host port to which the RAID controller modules are connected To generate a list of valid host types for the storage array run the show storageArray hostTypeTable command Host types are identified by a name or a numerical index Enclose the host type name in double ...

Page 209: ... storage array zip archive file The archive file has a time stamp that is used to manage the archive files Two storage array zip archive files are maintained for each storage array The zip archive files are kept on a physical disk After the 72 hour time period is exceeded the oldest archive file is always overwritten during the new cycle After you enable automatic collection of the configuration a...

Page 210: ...to start a cache flush a value that is too low increases the chance that data needed for a host read is not in the cache A low value also increases the number of physical disk writes that are necessary to maintain the cache level which increases system overhead and decreases performance When setting storage array cache settings the value of the cacheFlushStart parameter must always be greater than...

Page 211: ... Storage Array Enclosure Positions This command defines the position of the enclosures in a storage array You must include all of the enclosures in the storage array when you enter this command Syntax set storageArray enclosurePositions controller enclosureID enclosureIDn Parameter Parameter Description enclosurePostions A list of all of the enclosure IDs The sequence of the enclosure IDs in the l...

Page 212: ...e 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 list does not match the total number of enclosures in the storage array an error message is shown Set Storage Array ICMP Response Th...

Page 213: ...his command sets the IPv6 address for the iSNS server Syntax set storageArray isnsIPv6Address ipAddress Parameter Parameter Description isnsIPv4Address The IP address that you want to use for the iSNS server Use this parameter with the static value for IPv4 configurations If you choose to have a DHCP server set the IP address for an IPv4 Internet iSNS server you must set the isnsIPv4Address parame...

Page 214: ...st If the client information matches the listener information then the listener grants a connection to the database server Set Storage Array Learn Cycle This command sets the learn cycle for the battery backup unit The learn cycle enables the MD storage management software to predict the remaining battery life Learn cycles run at set intervals and store the results for software analysis Syntax set...

Page 215: ...de simplex duplex Parameter Parameter Description daysToNextLearnCycle Valid values are 0 through 7 where 0 is immediately and 7 is in seven days The daysToNextLearnCycle parameter takes place up to seven days after the next scheduled learn cycle day Valid values for the day parameter include the days of the week Setting the day causes the next learn cycle to be scheduled on the specified day afte...

Page 216: ...ical disk behaves like any other physical disk until it is added to a secured disk group When a security capable physical disk is added to a secured disk group it becomes security enabled Whenever a security enabled physical disk is powered on it requires the correct security key from the RAID controller module before it can read or write data So a security enabled physical disk uses two keys the ...

Page 217: ...scovery is the process where initiators determine the targets that are available Discovery occurs at power on initialization and also if the bus topology changes for example if an extra device is added NOTE An unnamed discovery session is a discovery session that is established without specifying a target ID in the login request For unnamed discovery sessions neither the target ID nor the target p...

Page 218: ...acheFlushModifier cacheFlushModifierValue cacheWithoutBatteryEnabled TRUE FALSE mediaScanEnabled TRUE FALSE mirrorCacheEnabled TRUE FALSE modificationPriority highest high medium low lowest owner 0 1 readCacheEnabled TRUE FALSE writeCacheEnabled TRUE FALSE cacheReadPrefetch TRUE FALSE CAUTION Enabling Write Cache on a virtual disk generally improves performance for applications with significant Wr...

Page 219: ... virtual disk for which to define properties You can enter more than one virtual disk name if you use the virtualDisks parameter You must put quotation marks and brackets around the virtual disk name The virtual disk name and quotation marks must be inside the brackets virtualDisk Specifies the WWID of the virtual disk for which you are setting properties You can use the WWID instead of the virtua...

Page 220: ... mirror cache set this parameter to FALSE modificationPriority The priority for virtual disk modifications while the storage array is operational Valid values are highest high medium low or lowest owner The RAID controller module that owns the virtual disk Valid RAID controller module identifiers are 0 or 1 where 0 is the RAID controller module in slot 0 and 1 is the RAID controller module in slot...

Page 221: ...Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 You must put brackets around the enclosure ID values and the slot ID values Use with the addCapacity parameter if you must specify additional physical disks to accommodate the new size consistencyCheckEnabled Turns consistency checking during a media scan on or off To turn consistency checking on set to TRUE To turn consistency checking of...

Page 222: ...pes during read operations Do not use this operation for nonredundant virtual disks for example RAID Level 0 To check redundancy consistency set this parameter to TRUE For no stripe checking set this parameter to FALSE 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...

Page 223: ...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 224: ...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 225: ...e free capacity of a disk group For a description of how to use the free capacity value see the create virtualDisk command on Create RAID Virtual Disk Free Capacity Base Select on page 134 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 t...

Page 226: ...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 227: ... 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 or SATA Basic physical disk information Enclosure location and slot location HOST PORT IDENTIFIER HOST PORT NAME HOST TYPE 12 34 56 54 33 22 22 22 Jupiter1 Solaris 12 34 56 78 98 98 8...

Page 228: ... for each physical disk Depending on the size of the storage array this information can be several pages long The physical disk information is also returned when you issue the show storageArray profile command Syntax show allPhysicalDisks driveMediaType HDD SSD unknown allMedia physicalDiskType SAS physicalDisk enclosureID slotID physicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn...

Page 229: ...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 230: ... This command returns the status of firmware downloads for the physical disks targeted by the download physicalDisk firmware or download storageArray physicalDiskFirmware commands Syntax show allPhysicalDisks downloadProgress Parameters None Parameter Description physicalDiskChannel Identifier number of the physical disk portfor which to display information Valid physical disk port values are 1 or...

Page 231: ...he following information Status Online Offline Current firmware and NVSRAM configuration Pending firmware and NVSRAM configuration configurations if any Board ID Product ID Product revision Serial number Date of manufacture Date and time to which the RAID controller module is set Associated virtual disks including preferred owner Ethernet port Physical disk interface Syntax show allControllers con...

Page 232: ...ription allControllers 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 br...

Page 233: ...ections defaultHostType healthStatus hostTypeTable hotSpareCoverage features time virtualDiskDistribution summary Parameter Description allControllers 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 controlle...

Page 234: ...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 235: ...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 236: ... if only one type of physical disk is in the storage array raidLevel RAID level of the disk group that contains the physical disks in the storage array Valid RAID levels are 0 1 5 or 6 diskGroupWidth Number of physical disks in a disk group in the storage array This number depends on the capacity of the physical disks Integer values are required For information about the number of physical disks t...

Page 237: ...the segmentSize parameter see Using the Auto Configure Command on page 53 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 238: ...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 239: ...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 240: ...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 241: ... 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 242: ...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 243: ...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 244: ... 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 245: ...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 246: ...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 247: ...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 248: ...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 249: ...oup 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 importDependencies command before you run the start diskGroup import command Start Enclosure Blink This command id...

Page 250: ... 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 controller module identifier values are 0 or 1 where 0 is the RAID controller module in slot 0 and 1 is the RAI...

Page 251: ...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 252: ...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 253: ... 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 254: ...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 255: ... marginal or unresponsive the refresh operation can take from 2 to 3 minutes to complete NOTE This command is for IPv4 only Syntax start storageArray isnsServerRefresh Parameter None NOTE If you used the set storageArray isnsIPv4ConfigurationMethod command to set the configuration but did not set the configuration to DHCP running the start storageArray isnsServerRefresh returns an error Parameter ...

Page 256: ...ax Stop storageArray configDbDiagnostic Parameters None NOTE The controller firmware returns a confirmation that the diagnostic test was cancelled In addition the database configuration 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 stora...

Page 257: ...nclosure that was turned on by the start enclosure blink command Syntax stop enclosure blink Parameters None Stop Physical Disk Blink This command turns off the indicator light on the physical disk that was turned on by the start physicalDisk blink command Syntax stop physicalDisk blink Parameters None Stop Physical Disk Channel Blink This command turns off the indicator lights on the expansion en...

Page 258: ...mmand before it completes Syntax stop physicalDiskChannel faultDiagnostics Parameters None NOTE Use the start physicalDiskChannel faultDiagnostics command and the save physicalDiskChannel faultDiagnostics command with the stop physicalDiskChannel faultDiagnostics command These commands are needed to start the diagnostic test and save diagnostic test results to a file You can also stop the start ph...

Page 259: ...y the start storageArray blink command Syntax stop storageArray blink Parameters None Stop Storage Array iSCSI Session This command forces the termination of an iSCSI session Syntax stop storageArray iscsiSession sessionNumber 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 virtua...

Page 260: ...already in progress to a physical disk however this command stops all firmware downloads to physical disks that are waiting for the download Syntax stop storageArray physicalDiskFirmwareDownload Parameters None Stop Virtual Disk Copy This command stops a virtual disk copy operation Syntax stop virtualDiskCopy target targetName source sourceName Parameter Description sessioNumber The identifier num...

Page 261: ...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 virtual disk name Parameter Description file The f...

Page 262: ...ers long The pass phrase must 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 ...

Page 263: ...Script Commands 263 ...

Page 264: ... 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 command syntax must conform to the guidelines in Usage Guidelines on page 40 and the rules in Command Formatting Rules on page 106 When creating a...

Page 265: ...owever the size of this page causes the command text to wrap You might want to include blank lines in your script files to separate blocks of commands or make a comment more outstanding You can do this by entering two forward slashes which causes the script engine to treat the line as a comment The first line of text is the show string command This command displays text bounded by quotation marks ...

Page 266: ...than the optional parameters in the example You can enter optional parameters in any sequence You must enter the required parameters in the sequence shown in the command descriptions The line show Setting additional attributes for virtual disk 7 is another example of using the show string command This command is placed here to tell you that the create virtualDisk command ran successfully In additi...

Page 267: ...idLevel 5 userLabel 2 physicalDisks 0 1 0 6 1 7 1 3 2 3 2 6 owner 1 segmentSize 16 capacity 2GB show Setting additional attributes for virtual disk 7 Configuration settings that cannot be set during virtual disk creation set virtualDisk 7 mediaScanEnabled false set virtualDisk 7 consistencyCheckEnabled false set virtualDisk 7 modificationPriority high The command in this example like the create vi...

Page 268: ...reate 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 1 segmentSize segmentSizeValue enclosureLossProtect TRUE FALSE ...

Page 269: ...268 Sample Script Files ...

Page 270: ...med as soon as you run the commands Before using the script commands ensure that you have backed up all data and have saved the current configuration so that you can reinstall it if the changes do not work Updated Commands The following command is available in both PowerVault MD3200 Series and PowerVault MD3600i Series storage arrays but the syntax of the command has either been modified or enhanc...

Page 271: ...270 CLI Command Updates ...

Page 272: ...e array firmware pending 121 virtual disk reservations 122 CLI commands 16 usage examples 27 clocks RAID controller module synchronizing 95 collecting physical disk data 99 command formatting rules 106 command line interface how to use 14 command line parameters 18 commands listed alphabetically 115 listed by function 108 commands listed by function 108 comments adding 41 configuration script exam...

Page 273: ...sk group 98 delete disk group 151 host 152 host group 152 host port 153 iSCSI initiator 154 Snapshot Virtual Disk 74 75 virtual disk 154 detailed error reporting 24 determining Virtual Disk Copy candidates 79 what is on your storage array 44 diagnosing RAID controller module 99 155 disable storage array feature 157 disk group commands 108 create disk group 123 defragmenting 98 247 delete disk grou...

Page 274: ...lete host group 152 set host group 194 host port create host port 129 delete host port 153 set 194 show host ports 227 hot spare assigning global hot spares 59 set physical disk hot spare 218 how to use the command line interface 14 I initializing physical disk 102 virtual disk 103 interaction with other features 88 ISCSI recurring syntax values 39 iSCSI commands 110 iSCSI initiator create iSCSI i...

Page 275: ...de 100 show 231 RAID level changing 97 RAID virtual disk recover 168 reconstructing a physical disk 102 recopy virtual disk 86 166 recopying virtual disk 85 recover RAID Virtual Disk 168 RAID virtual disk 168 recovery operations 100 re creating snapshot virtual disk 76 recurring syntax elements 34 redistributing virtual disk 103 redundancy check running 93 remove copy pairs 88 persistent reservati...

Page 276: ...g RAID controller module NVSRAM values 182 script command structure 30 synopsis 32 usage guidelines 40 segment size changing 97 session command 112 Set 187 set enclosure id 189 foreign physical disk to native 190 host group 194 physical disk channel status 198 physical disk hot spare 218 virtual disk 218 Virtual Disk Copy 223 set controller 187 set disk group 187 set enclosure attribute 189 set ho...

Page 277: ...nabling 65 restarting 75 stopping 74 75 snapshot virtual disk creating 66 re creating 76 start disk group blink 247 disk group defragment 247 enclosure blink 249 physical disk initialize 253 physical disk reconstruction 254 storage array blink 255 virtual disk initialization 256 start disk group import 256 Start Disk Group Import Export 256 start iSCSI DHCP refresh 250 start physical disk channel ...

Page 278: ...heck consistency 118 commands 114 copying 81 creating in an existing disk group 51 creating with software assigned physical disks 50 creating with user assigned physical disks 48 initializing 103 recopy 86 recopy virtual disk 166 recopying 85 redistributing 103 repair consistency 174 set 218 Virtual Disk Copy command 115 show 242 stop 260 viewing properties 82 virtual disk copy remove 173 ...

Page 279: ...Index 278 ...