background image

After you create a virtual disk copy, the target virtual disk automatically becomes read

only to hosts to ensure that the 

data is preserved. Hosts that have been mapped to a target virtual disk do not have write access to the virtual disk, and 
any attempt to write to the read-only target virtual disk results in a host I/O error.
If you want hosts to have write access to the data on the target virtual disk, use the set virtualDiskCopy command to 
disable the read-only attribute for the target virtual disk.

Virtual Disk Expansion

A Virtual Disk Expansion (VDE) is a modification operation that increases the capacity of a standard virtual disk or a 
snapshot repository virtual disk. The increase in capacity is achieved by using the free capacity that is available in the 
disk group of the standard virtual disk or the snapshot repository virtual disk.
This modification operation is considered to be “dynamic because you can continually access data on disk groups, 
virtual disks, and physical disks throughout the entire operation.
A VDE operation can be performed on a primary virtual disk or a secondary virtual disk of a replication relationship.
You cannot perform a VDE operation on a replication repository virtual disk.

78

Summary of Contents for PowerVault MD3060e Series

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

Page 2: ... Sempron are trademarks of Advanced Micro Devices Inc Microsoft Windows Windows Server Internet Explorer MS DOS Windows Vista and Active Directory are either trademarks or registered trademarks of Microsoft Corporation in the United States and or other countries Red Hat and Red Hat Enterprise Linux are registered trademarks of Red Hat Inc in the United States and or other countries Novell and SUSE...

Page 3: ...ng A Storage Array 33 Configuring A Storage Array 33 Determining What Is On Your Storage Array 34 Saving A Configuration To A File 35 Using The Create Virtual Disk Command 36 Using The Auto Configure Command 38 Modifying Your Configuration 40 Setting The Storage Array Password 40 Setting Up SMTP And SNMP Alerts 40 Setting The RAID Controller Module Clocks 41 Setting The Storage Array Host Type 41 ...

Page 4: ...irtual Disk 54 5 Using The Virtual Disk Copy Feature 57 Creating A Virtual Disk Copy 58 Enabling The Virtual Disk Copy Feature 58 Determining Virtual Disk Copy Candidates 58 Creating A Virtual Disk Copy 58 Preparing Host Servers To Create A Virtual Disk Copy 59 Copying The Virtual Disk 59 Viewing Virtual Disk Copy Properties 60 Changing Virtual Disk Copy Settings 61 Recopying A Virtual Disk 62 Pre...

Page 5: ...Expansion 78 7 Maintaining A Storage Array 79 Routine Maintenance 79 Running A Media Scan 79 Running A Consistency Check 80 Resetting A RAID Controller Module 80 Enabling RAID Controller Module Data Transfer 81 Resetting Battery Age 81 Removing Persistent Reservations 81 Synchronizing RAID Controller Module Clocks 81 Locating Physical Disks 81 Performance Tuning 82 Monitoring Performance 82 Changi...

Page 6: ... Autoconfigure Storage Array 99 Autoconfigure Storage Array Hot Spares 100 Check Remote Replication Status 100 Check Virtual Disk Consistency 101 Clear Physical Disk Port Statistics 102 Clear Storage Array Configuration 102 Clear Storage Array Core Dump 103 Clear Storage Array Event Log 103 Clear Storage Array Firmware Pending Area 103 Clear Storage Array Recovery Mode 104 Clear Virtual Disk Reser...

Page 7: ...lication 137 Disable Storage Array Feature 138 Display Automatic Support Bundle Collection Configuration 138 Display Support Bundle Collection Schedule 138 Download Enclosure Management Module Firmware 139 Download Physical Disk Firmware 139 Download Storage Array Firmware NVSRAM 140 Download Storage Array Physical Disk Firmware 141 Download Storage Array NVSRAM 142 Enable Disk Group Security 142 ...

Page 8: ...orage Array Events 160 Save Storage Array iSCSI Statistics 161 Save Storage Array Performance Statistics 161 Save Storage Array SAS PHY Counts 162 Save Storage Array State Capture 162 Save Storage Array Support Data 162 Schedule Support Bundle Collection Configuration 163 Scheduling Snapshots 164 Set Disk Group 165 Set Disk Group Forced State 167 Set Disk Pool 167 Set Enclosure Attribute 168 Set E...

Page 9: ...w Host Ports 193 Show Physical Disk 194 Show Physical Disk Channel Statistics 195 Show Physical Disk Download Progress 196 Show RAID Controller Module 196 Show RAID Controller Module NVSRAM 197 Show Remote Replication Virtual Disk Candidates 198 Show Remote Replication Virtual Disk Synchronization Progress 198 Show Storage Array 199 Show Storage Array Auto Configure 200 Show Storage Array Host Top...

Page 10: ...hot Rollback 214 Start Storage Array Blink 214 Start Storage Array iSCSI Refresh 214 Start Virtual Disk Initialization 215 Stop Configuration Database Diagnostic 215 Stop Disk Group Blink 215 Stop Disk Pool Locate 216 Stop Enclosure Blink 216 Stop Physical Disk Blink 216 Stop Physical Disk Channel Blink 216 Stop Physical Disk Channel Fault Isolation Diagnostics 216 Stop Snapshot 217 Stop Storage A...

Page 11: ...face You can also run commands in an interactive mode Interactive mode enables you to connect to a specific storage array and rapidly enter a command determine the effect on the storage array and then enter a new command The command line interface gives you direct access to a script engine utility in the Dell PowerVault Modular Disk Storage Manager software MD Storage Manager The script engine rea...

Page 12: ...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 Interactive mode is useful for determining configuration errors and quickly testing configuration changes If you enter SMcli without any parameters or with an incorrect parameter the script engine returns usage ...

Page 13: ...ss f scriptfile n storage array name w WWID o outputfile p password e S SMcli n storage array name w WWID c command command2 o outputfile p password e S SMcli n storage array name w WWID f scriptfile o outputfile p password e S SMcli n storage array name w WWID o outputfile p password e S SMcli a email email address host name or IP address1 host name or IP address2 n storage array name w WWID h ho...

Page 14: ... connection out of band storage management you must specify the host name or IP address of the redundant array 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 configurati...

Page 15: ...rcase parameter allows you to execute script commands contained in a file NOTE By default any errors encountered when running the script commands in a file are ignored and the file continues to run To override this behavior use the set session errorAction stop command in the script file g Use to specify an ASCII file that contains e mail sender contact information to include in all e mail alert no...

Page 16: ...ified address The storage array name is required when host name or IP address is not used however the name of the storage array configured 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 c...

Page 17: ...r parameter enables you to set or change the alert notifications for all storage arrays under each management station S uppercase Use to suppress the informational messages describing command progress that appear when running script commands Suppressing informational messages is also called silent mode This parameter suppresses the following messages Performance syntax check Syntax check complete ...

Page 18: ...e following 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 Detai...

Page 19: ...alue Meaning 0 The command terminated without an error 1 The command terminated with an error Error information is also displayed 2 The script file does not exist 3 An error occurred while opening an output file 4 A storage array is not at the specified address 5 Addresses specify different storage arrays 6 A storage array name does not exist for the host agent connected 7 The storage array name w...

Page 20: ... script command following the c parameter NOTE See Script Commands for descriptions of the script commands used in the following examples This example shows how to change the name of a storage 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 storageA...

Page 21: ...tfile 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 shows how to display all storage arrays that are currently discovered ...

Page 22: ...22 ...

Page 23: ...ement operations listed in Table 4 Configuration and Management Operations Operation Activities Virtual disk disk group configuration Creating deleting and setting priority labeling setting physical disk composition when creating virtual disks setting segment size and setting media scan control Physical disk configuration Configuring the hot spare RAID controller module configuration Defining virt...

Page 24: ... all parameter means all objects of the specified type in the storage array for example allVirtualDisks To perform a command on a specific object use brackets to identify the object for example virtualDisk engineering 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 ...

Page 25: ...rors in the object clear object statement data Discards the contents of some attribute of an object This is a destructive operation that cannot be reversed create object statement data Creates an object of the specified type deactivate object statement data Removes the environment for an operation delete object Deletes a previously created object diagnose object statement data Runs a test and disp...

Page 26: ...d it continues from the point at which it was suspended Recurring Syntax Elements Recurring syntax elements are a general category of variables and parameters you can use in one or more script commands The recurring syntax is used in the general definitions of the script commands that are listed in Script Commands The following table lists the recurring syntax and the syntax values that you can us...

Page 27: ...stance based repository spec count based repository spec ethernet port options IPV4Address ipv4 address IPV4ConfigurationMethod static dhcp IPV4GatewayIP ipv4 address IPV4SubnetMask ipv4 address iscsi host port options IPV4Address ipv4 address IPV6LocalAddress ipv6 address IPV6RoutableAddress ipv6 address IPV6RouterAddress ipv6 address enableIPV4 boolean enableIPV6 boolean enableIPV4Vlan boolean e...

Page 28: ...disks with a disk group Do not set enclosureLossProtect when specifying a disk group NOTE For enclosure loss protection to work each physical disk in a disk group must be on a separate 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...

Page 29: ...If you use the physicalDiskType parameter you must also use the hotSpareCount and diskGroupWidth parameters If you do not use the physicalDiskType parameter the configuration defaults to SAS physical disks NOTE The virtualDisksPerGroupCount parameter is the number of equalcapacity virtual disks per disk group create virtual disk copy attr value list create virtual disk copy attr value pair create ...

Page 30: ...ou can add comments to your scripts to make it easier for you and future users to understand the purpose of the script commands For information on how to add comments see Adding Comments To A Script File 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 ...

Page 31: ...ped between and as a comment If the script engine does not find both a beginning and ending comment notation an error message is displayed and the script operation is terminated Deletes the existing configuration clear storageArray Configuration Use the show statement to embed comments in a script file that you want to display while the script file is running Enclose the text you want to display i...

Page 32: ...32 ...

Page 33: ...ntation in this chapter does not explain all possible usage and syntax for the commands For complete definitions of the commands including syntax parameters and usage notes see Script Commands This chapter contains examples of CLI and script command usage The command syntax used in the examples is for a host running a Microsoft Windows operating system As part of the examples the complete C prompt...

Page 34: ...entifies 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 need to increase the size of your display buffer to see all of the information Because this information is so detailed you mig...

Page 35: ...on 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 determine if the file name already exists If you choose the name of a file that already exists the script engine ...

Page 36: ... and underscores The maximum length of the virtual disk name is 30 characters Spaces are not allowed You must put quotation marks around the virtual disk name The physicalDisks parameter is a list of the physical disks that you want to use for the disk group Enter the enclosure ID and slot ID of each physical disk that you want to use Put parentheses around the list Separate the enclosure ID and s...

Page 37: ...l disks This version of the command requires only the number and the type of physical disks to use in the disk group You do not need to enter a list of physical disks All other parameters are the same Enclosure loss protection is performed differently when MD Storage Manager assigns the physical disks as opposed to when a user assigns the physical disks For an explanation of the difference see Enc...

Page 38: ...ated disk group does not have enclosure loss protection The RAID controller module firmware assigns the physical disks The storage array posts an error if the RAID controller module firmware cannot provide physical disks to ensure that the new disk group has enclosure loss protection The storage array performs the operation even if it means that the disk group might not have enclosure loss protect...

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

Page 40: ... you to define a password for a storage array The following syntax is the general form of the command set storageArray password password The password parameter defines a password for the storage array Passwords provide added security to a storage array to reduce the possibility of implementing destructive commands CAUTION Implementing destructive commands can cause serious damage including data lo...

Page 41: ... hostTypeIdentifier The defaultHostType parameter defines how the RAID controller modules communicate with the operating system on undefined hosts connected to the storage array This parameter defines the host type only for storage array data I O activities it does not define the host type for the management station The operating system can be Windows or Linux For example if you set the defaultHos...

Page 42: ...shows how to use this command to set the modification priority for virtual disks named Engineering 1 and Engineering 2 client smcli 123 45 67 89 c set virtualDisks Engineering_1 Engineering_2 modificationPriority lowest The modification rate is set to lowest so that system performance is not significantly reduced by modification operations Assigning Global Hot Spares Hot spare physical disks can r...

Page 43: ...y default local logging is enabled in the properties file When local logging is enabled in the Windows operating system the persistent monitor logs the event information in the Windows Event Log file When local logging is enabled in the UNIX operating system the persistent monitor logs the event information in the syslog file The properties file can also be configured to enable or disable remote s...

Page 44: ...ep 4 b An individual storage array To send an alert email about events that occur on only a specified storage array Click OK The Select Storage Array dialog box appears Go to step 3 3 Select the storage array for which you want to receive email alerts and click OK The Configure Alerts dialog box appears NOTE If you do not know which storage array to select click Blink to turn on the indicator ligh...

Page 45: ...napshot Virtual Disks in the Owner s Manual Snapshot virtual disks allow you to perform the following tasks Create a complete image of the data on a source virtual disk at a particular point in time Use only a small amount of disk space Provide quick frequent nondisruptive backups or test new versions of a database system without affecting actual data Provide for snapshot virtual disks to be read ...

Page 46: ...urrent 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 following The following types of virtual disks are not valid source virtual disks snapshot repository virtual disks snapshot virtual disks target virtual disks that are participating in a virtual disk copy You cannot create a snapshot of a virtual disk ...

Page 47: ...n defining your storage array configuration When you choose the physical disks for your snapshot virtual disk you automatically create a new disk group You can specify which physical disks to use and the 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 acces...

Page 48: ...entOfSource percentValue repositoryUserLabel repositoryName repositoryFullPolicy failSourceWrites failSnapShot enclosureLossProtect TRUE FALSE enableSchedule TRUE FALSE schedule immediate snapshotSchedule NOTE Use one or all of the optional parameters as needed to help define your configuration You do not however need to use any optional parameters See step 1 through step 4 in the preceding sectio...

Page 49: ...t 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 necessary to use any optional parameters The following example is a command in which software assigns the physical disks client smcl...

Page 50: ...up with a RAID level of 5 This command also takes a snapshot of the source virtual disk which starts the copy on write operation The following example is the script file version of the command create snapshotVirtualDisk sourceVirtualDisk Mars_Spirit_4 repositoryRAIDLevel 5 repositoryPhysicalDiskCount 3 User Defined Parameters Parameters for the create snapshotVirtualDisk command enable you to defi...

Page 51: ...s 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 snapshot repository virtual disk The default value is 50 which represents 50 percent of total capacity Change this...

Page 52: ...phens and underscores The maximum length of the virtual disk names is 30 characters You must enclose the name in quotation marks The character string cannot contain a new line Make sure that you use unique names or the RAID controller module firmware returns an error One technique for naming the snapshot virtual disk and the repository virtual disk is to add a hyphenated suffix to the original nam...

Page 53: ...ars_Spirit_4 3 warningThresholdPercent 50 repositoryFullPolicy failSourceWrites The following example is the script file version of the command set virtualDisks Mars_Spirit_4 1 Mars_Spirit_4 2 Mars_Spirit_4 3 warningThresholdPercent 50 repositoryFullPolicy failSourceWrites Stopping And Deleting A Snapshot Virtual Disk When you create a snapshot virtual disk copy on write immediately starts running...

Page 54: ...are re creating have to be in the proper state To ensure that the host server is properly prepared to re create a snapshot virtual disk you can either use an application to carry out this task or you can perform the following steps 1 Stop all I O activity to the source and snapshot virtual disk if mounted 2 Using your Windows system flush the cache to both the source and the snapshot virtual disk ...

Page 55: ... script file version of the command recreate snapshot virtualDisks Mars_Spirit_4 2 Mars_Spirit_4 3 If you do not intend to use a snapshot virtual disk again you can delete the snapshot virtual disk using the delete virtualDisk command When you delete a snapshot virtual disk the associated snapshot repository virtual disk is also deleted 55 ...

Page 56: ...56 ...

Page 57: ... disk NOTE The preferred method is to perform a Virtual Disk Copy from a Snapshot Virtual Disk This allows the original virtual disk used in the Snapshot operation to remain in full use while the Snapshot of this virtual disk is used as the source for the virtual disk copy operation NOTE The Virtual Disk Copy for any Virtual Disk cannot be mounted on the same host as the source Virtual Disk The Mi...

Page 58: ... the feature To enable the feature key file use the command enable storageArray feature file filename where the file parameter is the complete file path and file name of a valid feature key file Enclose 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 availa...

Page 59: ...ws or unmount the virtual drive s in Linux to help guarantee a stable copy of the drive for the virtual disk If this is not done the copy operation reports that it has completed successfully but the copied data is not updated properly 4 Follow any additional instructions for your operating system Failure to follow these additional instructions can create unusable virtual disk copies NOTE If your o...

Page 60: ...nly to the hosts Any write requests to the target virtual disk are rejected unless you disable the read only attribute Use the set virtualDiskCopy command to disable the read only attribute Viewing Virtual Disk Copy Properties Using the show virtualDiskCopy command you can view information about one or more selected source virtual disks or target virtual disks This command returns the following in...

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

Page 62: ...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 drive for the virtual disk copy Before creating a new virtual disk copy for an existing copy pair both the server and the associated virtual disk you are recopying have to be in the proper state To ensure that the host server is pro...

Page 63: ... 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 can use the recopy virtualDiskCopy command to create a new virtual disk copy using the original virtual disk copy pair All...

Page 64: ...ts that have been mapped to a target virtual disk do not have write access to the virtual disk and any attempt to write to the read only target virtual disk results in a host I O error If you want hosts to have write access to the data on the target virtual disk use the set virtualDiskCopy command to disable the read only attribute for the target virtual disk Snapshot Virtual Disks A snapshot virt...

Page 65: ...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 65 ...

Page 66: ...66 ...

Page 67: ...he ability to have two storage arrays back up each other by duplicating critical virtual disks on each storage array to virtual disks on the other storage array This action lets each storage array recover data from the other storage array in the event of any service interruptions How Remote Replication Works When you create a remote replicated pair the remote replicated pair consists of a primary ...

Page 68: ...y You must also create a secondary virtual disk on the secondary site if one does not already exist The secondary virtual disk must be a standard virtual disk of equal or greater capacity than the associated primary virtual disk When secondary virtual disks are available you can establish a replication relationship in the MD storage management software by identifying the primary virtual disk and t...

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

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

Page 71: ...ler module in the storage array As part of the activation process you can decide where the replication repository virtual disks will reside free capacity on an existing disk group or in a newly created disk group and the RAID level for the replication repository virtual disks The free capacity that you select for the replication repository virtual disk must have a total of 256 MB of capacity avail...

Page 72: ...is version of the activate storageArray feature remoteReplication command you choose an existing disk group in which to place the replication repository virtual disk The MD storage management software then determines which physical disks to use You can also define how much space to assign to the replication repository virtual disk Because you are using an existing disk group the RAID level for the...

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

Page 74: ...ondary virtual disk is as accurate a copy of the data on the primary virtual disk as possible The highest synchronization priority does however use more system resources which can reduce system performance This example shows how to use the command in a script file create remoteReplication primary Jan_04_Account secondary Jan_04_Account_B remoteStorageArrayName Tabor remotePassword jdw2ga05 syncPri...

Page 75: ...l remote replicated pairs within the group You can then resume replication operations for any of the individual remote replicated pairs that are in the group This example shows the suspend remoteReplication command c smX client smcli 123 45 67 88 123 45 67 89 c suspend remoteReplication primary Jan_04_Account writeConsistency false The writeConsistency parameter defines whether the virtual disks i...

Page 76: ...oose an alternate virtual disk to replace the deleted virtual disk CAUTION Possible loss of data access Deleting a primary virtual disk or a secondary virtual disk permanently removes the data from the storage array Disabling The Remote Replication Premium Feature You disable the Remote Replication premium feature to prevent the new replication relationship from being created When you disable the ...

Page 77: ... of this feature because it enables complete backups without significant impact to the storage array I O However some I O processing resources are lost to the 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 Virtual D...

Page 78: ...ual Disk Expansion A Virtual Disk Expansion VDE is a modification operation that increases the capacity of a standard virtual disk or a snapshot repository virtual disk The increase in capacity is achieved by using the free capacity that is available in the disk group of the standard virtual disk or the snapshot repository virtual disk This modification operation is considered to be dynamic becaus...

Page 79: ...rive failure and reduces the possibility of encountering a media error during host operations A media scan is performed as a background operation and scans all data and consistency information in defined user virtual disks A media scan runs on all virtual disks in the storage array with the following conditions An Optimal status No modification operations in progress Media scan enabled Errors dete...

Page 80: ... 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 inconsistencies are repaired RAID 0 virtual dis...

Page 81: ...you perform the following changes to your configuration Change or delete logical unit number LUN mappings on a virtual disk holding a reservation Delete virtual disk groups or virtual disks that have any reservations To determine which virtual disks have reservations run the following command show allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN reservatio...

Page 82: ...l I Os that are read operations calculate the write percentage by subtracting the read percentage from 100 percent Cache Hit Percentage Percentage of reads that are fulfilled by data from the cache rather than requiring an actual read from a physical disk Current KB second Current transfer rate in kilobytes per second current means the number of kilobytes per second since the last time the polling...

Page 83: ...skName wwid segmentSize segmentSizeValue where segmentSizeValue is the new segment size you want to set Valid segment size values are 8 16 32 64 128 256 and 512 You can identify the virtual disk by name or World Wide Identifier WWID see Set Virtual Disk Defragmenting A Disk Group When you defragment a disk group you consolidate the free capacity in the disk group into one contiguous area Defragmen...

Page 84: ...nitiates a write command as it would be sent over an I O data path to the diagnostics region on a specified physical disk This diagnostics region is then read and compared to a specific data pattern If the write fails or the data compared is not correct the RAID controller module is considered to be in error and it is failed and placed offline For best results run all three tests at initial instal...

Page 85: ...erformance The disk groups are automatically transferred back to the preferred RAID controller module when it is placed back online CAUTION A multipath driver is required on all hosts and is the only supported configuration If the multipath driver is not installed the virtual disks are not accessible Before you place a RAID controller module in Service mode ensure that a multipath driver is instal...

Page 86: ...t If the virtual disk starts exhibiting failures you might be required to re initialize the virtual disk to correct the failure condition The initialization process cannot be cancelled once it has begun This option cannot be used if any modification operations are in progress on the virtual disk or disk group To initialize a virtual disk run the following command start virtualDisk virtualDiskName ...

Page 87: ...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 87 ...

Page 88: ...88 ...

Page 89: ...mmands alphabetically and for each command includes command name syntax and parameters CAUTION Commands entered using the command line interface CLI are capable of damaging a configuration and causing loss of data if not used properly Command operations are performed as soon as you run the commands Some commands can immediately delete configurations or data Before using the command line interface ...

Page 90: ...icate a value or information that you need to provide For example when you encounter the italicized term numberOfPhysicalDisks Replace the italicized term with a value for the number of physical disks that you want to include with the command You can use any combination of alphanumeric characters hyphens and underscores for the names of the following components Storage arrays Host groups Hosts Dis...

Page 91: ...ds Listed By Function This section presents the commands organized into groups related to physical logical and operational features of the storage array Disk Group Commands Create Disk Group Delete Disk Group Enable Disk Group Security Resume Snapshot Rollback Set Disk Group Troubleshooting Show Disk Group Show Disk Group Export Dependencies Show Disk Group Import Dependencies Start Disk Group Bli...

Page 92: ...CSI Statistics Set iSCSI Initiator Set iSCSI Target Properties Show Current iSCSI Sessions Show Storage Array Negotiation Defaults Start iSCSI DHCP Refresh Stop Storage Array iSCSI Session Physical Disk Commands Clear Physical Disk Port Statistics Download Physical Disk Firmware Replace Physical Disk Revive Physical Disk Save Physical Disk Channel Fault Isolation Diagnostic Status Save Physical Di...

Page 93: ...t RAID Controller Module Save RAID Controller Module NVSRAM Set Host Channel Set Host Port Set Physical Disk Channel Status Set RAID Controller Module Show Physical Disk Channel Statistics Show RAID Controller Module Show RAID Controller Module NVSRAM Start Physical Disk Channel Blink Start Physical Disk Channel Fault Isolation Diagnostics Stop Physical Disk Channel Blink Stop Physical Disk Channe...

Page 94: ...Spares Clear Storage Array Configuration Clear Storage Array Event Log Clear Storage Array Firmware Pending Area Scheduling Snapshots Disable Storage Array Feature Download Storage Array Firmware NVSRAM Enable RAID Controller Module Data Transfer Download Storage Array NVSRAM Enable Storage Array Feature Reset Storage Array Battery Install Date Reset Storage Array Battery Install Date Reset Storag...

Page 95: ...egotiation Defaults Show Storage Array Unconfigured iSCSI Initiators Show Storage Array Unreadable Sectors Stop Snapshot Rollback Start Storage Array iSCSI Refresh Stop Storage Array Blink Stop Storage Array Physical Disk Firmware Download Validate Storage Array Security Key Virtual Disk Commands Check Virtual Disk Consistency Clear Virtual Disk Reservations Clear Virtual Disk Unreadable Sectors C...

Page 96: ...disk group User defined number of physical disks If you choose to define a number of physical disks the RAID controller module firmware chooses which physical disks to use for the replication repository volume Syntax User Defined Physical Disks activate storageArray feature remoteReplication repositoryRAIDLevel 1 5 6 repositoryPhysicalDisks enclosureID1 drawerID1 slotID1 enclosureIDn drawerIDn slo...

Page 97: ...k group in which the replication repository virtual disk is located Enclose the disk group identifier in square brackets repositoryDiskGroup The name of the replication repository disk group where the replication repository virtual disk is located To determine the names of the disk groups in your storage array run the show storageArray profile command physicalDiskMediaType The type of physical dis...

Page 98: ...e amount of space that is needed for the replication repository virtual disks The command does not try to activate Remote Replication The command can be re entered using the value from the error message for the repository storage space value When you assign the physical disks if you set the enclosureLossProtect parameter to TRUE and have selected more than one physical disk from any one enclosure ...

Page 99: ...and without any parameters To modify the configuration change a single parameter or all of the parameters to meet your configuration requirements After entering the autoConfigure storageArray command the RAID controller modules set up the storage array using either the default parameters or those you selected Syntax autoConfigure storageArray physicalDiskType SAS raidLevel 0 1 5 6 diskGroupWidth n...

Page 100: ...prefetch set this parameter to TRUE securityType The setting to specify the security level when creating the disk groups and all associated virtual disks none The disk group and virtual disks are not secure capable The disk group and virtual disks are capable of having security set but security has not been enabled enabled The disk group and virtual disks have security enabled Autoconfigure Storag...

Page 101: ...is command when you run the Asynchronous Remote Replication utility 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 consistencyErrorFile filename mediaErrorFile filename priority highest high medium low lowest startingLBA LBAvalue endingLBA LBAvalue ...

Page 102: ...ata blocks you can reduce the time that a virtual disk consistency check takes to complete Clear Physical Disk Port Statistics This command resets the statistics for all physical disk ports Syntax clear allPhysicalDiskChannels stats Parameters None Clear Storage Array Configuration Use this command to Clear the entire storage array configuration and return it back to the initial installation state...

Page 103: ... set storageArray coreDumpAllowOverWrite Parameters None Notes When you retrieve a core dump from the RAID controller module cache to a host a flag is set on the RAID controller module to indicate that the core dump does not need to be retrieved This setting persists for 48 hours If a new core dump occurs during that period the new core dump is saved to the RAID controller module cache and overwri...

Page 104: ...l Disk Reservations This command clears persistent virtual disk reservations Syntax clear allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN reservations Parameters Parameter Description allVirtualDisks Clears reservations on all virtual disks in the storage array virtualDisk or virtualDisks Name of the specific virtual disk for which to clear reservations Y...

Page 105: ...ngle brackets to overcome this limitation Configure Automatic Support Bundle Collection This command enables or disables the automatic collection of support bundles on one or more storage arrays when a critical MEL event is detected NOTE This command must be run from the command line It cannot be run in the MD Storage Manager script editor Syntax supportBundle auto enable disable all storageArrayN...

Page 106: ... virtual disk Valid values are 0 1 5 or 6 userLabel The alphanumeric identifier including and _ that you want to give the 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 disk drives in the expansion enclosure ...

Page 107: ...is using the virtual disk Valid values are fileSystem dataBase or multiMedia enclosureLossProtect The setting to enforce enclosure loss protection when you create the disk group To enforce enclosure loss protection set this parameter to TRUE The default value is FALSE drawerLossProtect The setting to enforce drawer loss protection when you create the disk group To enforce drawer loss protection se...

Page 108: ...est Security Type The securityType parameter is valid for physical disks that are capable of selfencrypting disk SED With SED the RAID controller module firmware can create a key and activate the physical disk security feature The physical disk security feature encrypts data as the data is written to the physical disk and decrypts the data as the data is read from the physical disk Without the key...

Page 109: ... disks you want to assign to the disk pool Enclosure ID values are 0 to 99 drawer ID values are 0 to 4 slot ID values are 0 to 31 physicalDiskType Physical disk type value is sas Enclose the physical disk type values in parentheses If the physical disk type is specified then all of the unassigned physical disks of that type that are compatible with each other are used for the creation of the disk ...

Page 110: ...nclosure allMedia Use this option when you want to use all types of physical disk media that are in the expansion enclosure The default value is hdd Security Type The securityType parameter is valid for physical disks that are capable of self encrypting disk SED With SED the RAID controller module firmware can create a key and activate the physical disk security feature The physical disk security ...

Page 111: ...orageArray hostTypeTable command to generate a list of available host type identifiers If the host type has special characters enclose the host type in double quotation marks NOTE You can use any combination of alphanumeric characters hyphens and underscores for the names Command names can have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle ...

Page 112: ...st port You must enter SAS If you do not enter SAS the command attempts to use an invalid type of interface A SAS selection requires an 8 byte WWID NOTE You can use any combination of alphanumeric characters hyphens and underscores for the names Command names can have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this l...

Page 113: ...FALSE dssPreAllocate TRUE FALSE securityType none capable enabled Parameters Parameter Description physicalDiskCount Number of unassigned physical disks to use in the disk group NOTE The physicalDiskCount parameter enables you to choose the number of physical disks to use in the disk group You do not need to specify the physical disks by enclosure ID and slot ID The RAID controller modules choose ...

Page 114: ...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 enclosureLossProtect Specifies that enclosure loss protection is enforced when creating the disk group To enforce enclosure loss protection set this parameter to TRUE The default setting is FALSE For information about the enclosureLossProtect parameter ...

Page 115: ...s 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 group might have the following areas virtual disk 1 free capacity virtual disk 2 free capacity virtual disk 3 free capacity To use the free capaci...

Page 116: ...egmentSize parameter see Using The Auto Configure Command usageHint The settings for both the cacheReadPrefetch parameter and the segmentSize parameter should be the default values The default values are based on the typical I O usage pattern of the application that is using the virtual disk Valid values are fileSystem dataBase or multiMedia dssPreAllocate The setting to make sure that reserve cap...

Page 117: ...isk Specify the enclosure ID and slot ID for each unassigned physical disk to assign to the virtual disk Enclosure ID values are 0 to 99 Drawer ID values are 0 to 4 Slot ID values are 0 to 31 You must put parentheses around the enclosure ID values and the slot ID values diskGroupUserLabel The alphanumeric identifier including and _ that you want to give the new disk group Enclose the disk group id...

Page 118: ...le on the bottom 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 The preferred owner 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 p...

Page 119: ... virtual diskName capacity virtualDiskCapacity KB MB GB TB Bytes owner 0 1 mapping none default dataAssurance none enabled existingRepositoryLabel existingRepositoryName newRepositoryCapacity newRepositoryCapacityValue repositoryMaxCapacity repositoryMaxCapacityValue KB MB GB TB Bytes warningThresholdPercent warningThresholdPercentValue repositoryExpansionPolicy automatic manual cacheReadPrefetch ...

Page 120: ... segmentSize Amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk Valid values are 8 16 32 64 128 256 or 512 For information about the segmentSize parameter see Using the Auto Configure Command usageHint Valid values are multiMedia database or fileSystem Create Remote Replication NOTE This comma...

Page 121: ... settings for automatic resynchronization between the primary virtual disks and the secondary virtual disks of a remote replication pair This parameter has these values enabled Automatic resynchronization is turned on You do not need to do anything further to resynchronize the primary virtual disk and the secondary virtual disk disabled Automatic resynchronization is turned off To resynchronize th...

Page 122: ... data in a buffer but it requires forcing a full synchronization to make sure that the secondary virtual disk has the same data as the primary virtual disk Create Snapshot Virtual Disk This command creates a snapshot virtual disk When you use this command you can define the snapshot virtual disk in one of three ways User defined physical disks User defined disk group User defined number of physica...

Page 123: ...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 enclosure ID and slot ID for each physical disk assigned to the virtual disk Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 You must put parentheses around the list of repository physical disks repositoryDriveCount Number of unassigned...

Page 124: ...k group to use to create the snapshot repository virtual disk Free capacity is defined as the free capacity between existing virtual disks in a disk group For example a disk group might have the following areas virtual disk 1 free capacity virtual disk 2 free capacity virtual disk 3 free capacity To use the free capacity following virtual disk 2 you specify freeCapacityArea 2 Use the show diskGrou...

Page 125: ...kets with angle brackets to overcome this limitation NOTE One technique for naming the snapshot virtual disk and the repository virtual disk is to add a hyphenated suffix to the original name of the source virtual disk The suffix distinguishes between the snapshot virtual disk and the repository virtual disk For example if you have a source virtual disk with a name of Engineering Data the snapshot...

Page 126: ...For example scheduleDay wednesday startTime Defines time of a day you want to create a snapshot virtual disk and start performing a copy on write operation The format for entering the time is HH MM where HH is the hour and MM is the minute past the hour Use a 24 hour clock For example startTime 14 27 which corresponds to 2 27 PM scheduleInterval Amount of time in minutes that defines a minimum bet...

Page 127: ... schedule not the snapshot virtual disk Ensure that you do not inadvertently delete the virtual disk itself NOTE If you also use the scheduleInterval option the lowest value of the timesPerDay option and the scheduleInterval option is used The value is determined by calculating an integer value for the scheduleInterval option Divide 1440 by the scheduleInterval option value that you set For exampl...

Page 128: ... which restricts access to all SES drives that exist within the storage array You can have a storage array configuration with more than one set of encrypted disk groups Each disk group can have a unique security key The character string generated by the keyIdentifier parameter is a string that you can read and that enables you to identify the security key that you need You can create a keyIdentife...

Page 129: ...e This command creates virtual disk copies in two ways Virtual disk copy without snapshot Virtual disk copy with snapshot If you use virtual disk copy without snapshot you cannot write to the source virtual disk until the copy operation is complete If you want to be able to write to the source virtual disk before the copy operation is complete use virtual disk copy with snapshot You can select vir...

Page 130: ...set this parameter to FALSE To prevent writing to the target virtual disk set this parameter to TRUE copyType Creates a virtual disk copy with or a snapshot Creating a virtual disk copy with a snapshot enables you to continue to write to the source virtual disk while creating the virtual disk copy To create a virtual disk copy with a snapshot set this parameter to online To create a virtual disk c...

Page 131: ...are brackets If the disk pool name has special characters you also must enclose the host group name in double quotation marks Notes If the disk pool contains virtual disks the virtual disks are deleted along with the disk pool Delete Host This command deletes a host Syntax delete host hostName Parameter Parameter Description host Name of the host to delete You must put brackets around the host nam...

Page 132: ...nts the physical HBA host port to the RAID controller module By deleting the identification the RAID controller module no longer recognizes instructions and data from the HBA host port Syntax delete hostPort hostPortName Parameter Parameter Description hostPort Name of the HBA host port to delete You must put brackets around the name of the HBA host port NOTE An HBA host port is a physical connect...

Page 133: ...sks virtualDiskName1 virtualDiskNameN schedule Parameters Parameter Description virtualDisk or virtualDisks The name of the snapshot virtual disk to delete You can enter more than one snapshot virtual disk name Enclose the snapshot virtual disk name in square brackets If the snapshot virtual disk name has special characters you must also enclose the snapshot virtual disk name in double quotation m...

Page 134: ...e Deletes only the schedule Delete Virtual Disk On A Disk Pool This command deletes virtual disks on a disk pool CAUTION All of the data in the virtual disk is lost as soon as you run this command Syntax delete allVirtualDisks virtualDisk virtualDiskName virtualDisks virtualDiskName1 virtualDiskNameN removeDiskGroup TRUE FALSE retainRepositoryMembers TRUE FALSE Parameters Parameter Description all...

Page 135: ...tID parameter takes the following options which you can use to verify that a RAID controller module is functioning correctly 1 Reads the test 2 Performs a data loop back test 3 Writes the test The diagnostic tests consist of loop back tests in which data is written to physical disks and read from the physical disks Syntax diagnose controller 0 1 loopbackPhysicalDiskChannel allchannels 1 2 testID 1...

Page 136: ...PowerVault MD3600i storage array This command runs diagnostic tests on the copper cables between the iSCSI Host interface cards and a RAID controller module You can run diagnostics on a selected port or all ports The ports must be able to support the cable diagnostics If the ports do not support cable diagnostics an error is returned Syntax diagnose controller 0 1 iscsiHostPort all 0 1 testID cabl...

Page 137: ... which are the shortest and the longest lengths of the cable pairs If the cable status is Open or Short the approximate distance to the failure in the cable pairs If there is one failure the length is reported for that cable pair If there is more than one failure the information returned is both the shortest and longest lengths to the failures The lengths are listed as a range L1 L2 where L1 L2 If...

Page 138: ...rtitionMax snapshot2 snapshot4 snapshot8 snapshot16 remoteReplication8 remoteReplication16 remoteReplication32 remoteReplication64 remoteReplication128 virtualDiskCopy goldKey mixedPhysicalDiskTypes highPerformanceTier SSDSupport Parameters None Additional Information If you specify the remoteReplication parameter this command disables the Remote Replication premium feature and takes away the stru...

Page 139: ...ns the firmware image You must put quotation marks around the firmware image file path and file name Download Physical Disk Firmware This command downloads a firmware image to a physical disk CAUTION Downloading physical disk firmware incorrectly can result in damage to the physical disks or loss of data Before attempting to download physical disk firmware you must take the following precautions 1...

Page 140: ...enclosure ID and slot ID for the physical disk Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 You must put brackets around the enclosure ID value and slot ID value filename File path and file name of the file that contains the firmware image You must put quotation marks around the firmware image file path and file name Download Storage Array Firmware NVSRAM This command downloads firmw...

Page 141: ... Additional Information When you run this command you can download more than one firmware image file to the physical disks in a storage array The number of firmware image files that you can download depends on the storage array The MD storage management software returns an error if you try to download more firmware image files than the storage array can accept You can schedule downloads for multip...

Page 142: ...isk group identifier in square brackets Additional Information To successfully run this command the following conditions must be met All physical disks in the disk group must be self encrypting disk SED physical disks The Physical Disk Security premium feature must be enabled The storage array security key must be set The disk group must be Optimal and not have snapshot virtual disks or repository...

Page 143: ...entifier If you do not specify a RAID controller module the storage management software returns a syntax error Enable Storage Array Feature This command enables a premium feature using a feature key file Syntax enable storageArray featurePack feature file filename Parameter Parameter Description file File path and file name of a valid feature key file Valid file names for feature key files must en...

Page 144: ...rawer ID value and the slot ID value for the physical disk For low capacity expansion enclosures specify the enclosure ID value and the slot ID value for the physical disk Enclosure ID values are 0 to 99 Drawer ID values are 0 to 4 Slot ID values are 0 to 31 Enclose the enclosure ID value drawer ID value and the slot ID value in parentheses Use this parameter with the addCapacity parameter if you ...

Page 145: ... 1 where 0 is the controller in slot 0 and 1 is the controller in slot 1 contentType This parameter specifies the content type of the data that is retrieved If the parameter is set to raidConfiguration the RAID configuration data is retrieved The RAID configuration data includes disk groups and associated virtual disks If the parameter is set to all all of the data including disk pool configuratio...

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

Page 147: ...acityIndexNumber User Defined Number of Drives recreate storageArray replicationRepository repositoryRAIDLevel 1 5 6 repositoryPhysicalDiskCount numberOfPhysicalDisks enclosureLossProtect TRUE FALSE Parameters Parameter Description repositoryRAIDLevel The RAID level for the replication repository virtual disk Valid values are 1 5 or 6 repositoryPhysicalDisks The physical disks for the replication ...

Page 148: ...ction When the RAID controller module firmware assigns the physical disks if you set the enclosureLossProtect parameter to TRUE the storage array returns an error if the RAID controller module firmware cannot provide physical disks that result in the new replication repository virtual disk having enclosure loss protection If you set the enclosureLossProtect parameter to FALSE the storage array per...

Page 149: ...hanumeric characters hyphens and underscores for the names Command names can have a maximum of 30 characters If you exceed the maximum character limit replace square brackets with angle brackets to overcome this limitation You can recreate a single snapshot virtual disk or multiple snapshot virtual disks with optional parameters If you specify one or more of the optional parameters the re create o...

Page 150: ...uccessful the snapshots start the re creation process and all of the affected virtual disks snapshot source and repository are quiesced until the process is complete NOTE The Microsoft Virtual Shadow Copy Service VSS provider allows the recreation of multiple snapshots simultaneously Reduce Disk Pool Capacity This command reduces the capacity of the disk pool by removing the physical disks from th...

Page 151: ...o put quotation marks around the source virtual disk name copyType Identifies a virtual disk copy with a snapshot If the virtual disk copy has an online copy snapshot set this parameter to online If the virtual disk copy does not have a snapshot set this parameter to offline Remove Virtual Disk LUN Mapping This command removes the logical unit number LUN mapping Syntax remove allVirtualDisks virtu...

Page 152: ...ks parameters Repair Virtual Disk Consistency This command repairs the consistency errors on a virtual disk Syntax repair virtualDisk virtualDiskName consistency consistencyErrorFile filename verbose TRUE FALSE Parameters Parameter Description virtualDisk Name of the specific virtual disk for which to repair consistency You must put brackets around the virtual disk name If the virtual disk name ha...

Page 153: ... the virtual disk Enclosure ID values are 0 to 99 Slot ID values are 0 to 31 Reset RAID Controller Module This command resets a RAID controller module NOTE When you reset a RAID controller module the RAID controller module is not available for I O operations until the reset is complete If a host is using virtual disks owned by the RAID controller module being reset the I O directed to the RAID con...

Page 154: ...cifies the RAID controller module that contains the battery for which to reset the age Valid RAID controller module identifier values are 0 and 1 The identifier value is 0 for the RAID controller module on the top and 1 for the RAID controller module on the bottom when viewed from the rear of the enclosure Use the controller parameter only for RAID controller modules with batteries NOTE If you do ...

Page 155: ...e CAUTION Ensure that the multipath driver is running before you use this command or the virtual disk is not accessible NOTE Under certain host operating system environments you might be required to reconfigure the multipath host physical disk You might also need to make operating system modifications to recognize the new I O path to the virtual disks Resume Remote Replication NOTE This command va...

Page 156: ...ocessing errors which triggers a Needs Attention condition for the storage array If the rollback operation cannot be resumed the selected snapshot virtual disk reverts to a paused state and the Needs Attention condition is displayed Syntax resume rollback virtualDisk snapshotVirtualDiskName Parameter Parameter Description virtualDisk Specifies the name of the snapshot virtual disk for which you wa...

Page 157: ...kets Revive Physical Disk This command forces the specified physical disk to the optimal state CAUTION Correct use of this command depends on the data configuration on all physical disks in the disk group Never attempt to revive a physical disk unless supervised by a Technical Support representative Syntax revive physicalDisk enclosureID slotID Parameter Parameter Description physicalDisk Identifi...

Page 158: ...er in square brackets file The name of the file in which you are storing the results of the fault isolation diagnostics test on the drive channel Enclose the name in double quotation marks NOTE A file extension is not automatically appended to the saved file You must specify the applicable format suffix for the file If you specify a file extension of txt then the output is in a text file format If...

Page 159: ...hat contains the configuration values You must put quotation marks around the file name allConfig Saves all of the configuration values to the file If you choose this parameter all of the configuration parameters are set to TRUE globalSettings Saves the global settings to the file To save the global settings set this parameter to TRUE To prevent saving the global settings set this parameter to FAL...

Page 160: ...ations This event is reporting a change in configuration or other information useful in evaluating the performance of the storage array Debug events Events occurring on the storage array that provides information useful in determining steps or states that led to the error This information may be useful to your Technical Support representative in helping determine error causes NOTE Some storage arr...

Page 161: ... 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 to which you want to save the performance statistics Enclose the file name in double quotation marks NOTE This command does not automatically append a file extension to the ne...

Page 162: ...atically append a file extension to the saved file Any file name is acceptable but the csv extension must be used Save Storage Array State Capture This command saves the state capture to a file Syntax save storageArray stateCapture file filename Parameter Parameter Description file Name of the file to which to save the state capture You must put quotation marks around the file name Save Storage Ar...

Page 163: ...support data when there is a failure in securing a lock on controller operations To force the collection of support data set this parameter to TRUE The default value is FALSE Schedule Support Bundle Collection Configuration This command specifies a schedule for collecting support bundle data NOTE This command must be run from the command line It cannot be run in the MD Storage Manager script edito...

Page 164: ...duleDay Defines a day of the week you want to create a snapshot virtual disk and perform a copy on write operation The values that you can enter are monday tuesday wednesday thursday friday saturday sunday and all For example scheduleDay wednesday startTime Defines time of a day you want to create a snapshot virtual disk and start performing a copy on write operation The format for entering the ti...

Page 165: ...ring is specified the default time zone is GMT For example CST can be specified in two different ways timeZone GMT 06 00 or timeZone USA Chicago NOTE To remove a schedule use the delete virtualDisk command with the schedule parameter The delete command with the schedule parameter deletes only the schedule not the snapshot virtual disk Ensure that you do not inadvertently delete the virtual disk it...

Page 166: ...Troubleshooting Attempting to expand large disk groups by adding physical disks also called Dynamic Capacity Expansion DCE may fail with the one of the following messages Return code Error 26 The modification operation cannot complete because of the number of physical disks in the disk group and the segment size of the associated virtual disks Reduce the segment size of all virtual disks in the di...

Page 167: ... sets the attributes associated with a disk pool based on the specified parameters Syntax set diskPool diskPool diskPoolName diskPools diskPoolName1 diskPoolNamen allDiskPools reservePhysicalDiskCount reservePhysicalDiskCountValue warningThreshold warningThresholdValue default criticalThreshold criticalThresholdValue default criticalPriority highest high medium low lowest backgroundPriority highes...

Page 168: ...osure ID value chassisName Chassis name or number 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 asset...

Page 169: ...ly when one or more physical disks must 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 enclosureID1 slotID1 enclosureID2 slotID2 enclosureID...

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

Page 171: ...s around the host group name If the host group name has special characters you must also put quotation marks around the host group name userLabel New name for the host group You must put quotation marks around the host group name NOTE You can use any combination of alphanumeric characters hyphens and underscores for the names Command names can have a maximum of 30 characters If you exceed the maxi...

Page 172: ...ation Set iSCSI Initiator This command sets the attributes for an iSCSI initiator Syntax set iscsiInitiator iscsiID userLabel newName host newHostName chapSecret newSecurityKey Parameters Parameter Description iscsiID The name of the iSCSI initiator for which you want to set attributes userLabel The new name that you want to use for the iSCSI initiator host The name of the new host to which the HB...

Page 173: ...et A secret is a security key that is similar to a password NOTE Use the chapSecret parameter only for initiators requiring 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 char...

Page 174: ...o 31 Enclose the enclosure ID values and the slot ID values in square brackets hotSpare The setting to assign the physical disk as the hot spare To assign the physical disk as the hot spare set this parameter to TRUE To remove a hot spare assignment from a physical disk set this parameter to FALSE Set Physical Disk State This command sets a physical disk to the Failed state To return a physical di...

Page 175: ...ID controller module the firmware for the RAID controller module returns a syntax error availability The mode for the RAID controller module which you can set to online offline or serviceMode service ethernetPort The attributes options for the management Ethernet ports The entries to support this parameter are listed in the Syntax Element Statement Data table that follows Many settings are possibl...

Page 176: ...turn on the Service Action Allowed indicator light set this parameter to on To turn off the Service Action Allowed indicator light set this parameter to off Syntax Element Statement Data Options for the Ethernet Port Parameter enableIPv4 TRUE FALSE enableIPv6 TRUE FALSE IPv6LocalAddress 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF IPv6RoutableAddress 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0 FFFF 0...

Page 177: ...xMode 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 IPv4 and IPv6 The payload portion of a standard Ethernet frame is set to ...

Page 178: ...elationship force The role reversal is forced if the communications link between the storage arrays is down and promotion or demotion on the local side results in a dual primary condition or a dual secondary condition To force a role reversal set this parameter to TRUE The default value is FALSE syncPriority The priority that full synchronization has relative to host I O activity Valid values are ...

Page 179: ...tions Setting the writeOrder parameter to notPreserved frees the system from having to maintain data in a buffer but it requires forcing a full synchronization to make sure that the secondary virtual disk has the same data as the primary virtual disk Set Session This command defines how you want the current script engine session to run Syntax set session errorAction stop continue password storageA...

Page 180: ...immediate snapshotSchedule rollbackPriority 0 1 2 3 4 Parameters Parameter Description virtualDisk or virtualDisks The name of the specific snapshot virtual disk for which you want to define properties You can enter more than one virtual disk name if you use the virtualDisks parameter Enclose the snapshot virtual disk name in double quotation marks inside of square brackets userLabel A new name th...

Page 181: ...nation of alphanumeric characters hyphens and underscores for the names Names can have a maximum of 30 characters NOTE You can set the warningThresholdPercent parameter and the repositoryFullPolicy parameter for both the snapshot repository virtual disk or the snapshot virtual disk Set Storage Array This command defines the properties of the storage array Syntax set storageArray autoSupportConfig ...

Page 182: ... the delay time are 0 to 60 minutes The default value is 5 mediaScanRate The number of days over which the media scan runs Valid values are disabled which turns off the media scan or 1 day to 30 days where 1 day is the fastest scan rate and 30 days is the slowest scan rate A value other than disabled or 1 to 30 does not allow the media scan to function password The password for the storage array E...

Page 183: ...reases 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 or equal to the value of the cacheFlushStop param...

Page 184: ...on The enclosurePositions sequence 1 84 50 12 places the RAID enclosure in the second position expansion enclosure 1 in the first position expansion enclosure 50 in the third position and expansion enclosure 12 in the fourth position NOTE You must include all of the enclosures in the storage array in the list defined by the enclosurePositions parameter If the number of enclosures in the list does ...

Page 185: ...ingPort The IP address that you want to use for the iSNS server listening port The range of values for the listening port is 49152 to 65535 The default value is 3205 Additional Information A listening port resides on the database server and is responsible for these activities Listening monitoring for incoming client connection requests Managing the traffic to the server When a client requests a ne...

Page 186: ... sets the redundancy mode of the storage array to either simplex or duplex Syntax set storageArray redundancyMode simplex duplex Parameter Parameter Description redundancyMode Use simplex mode when you have a single RAID controller module Use duplex mode when you have two RAID controller modules Set Storage Array Security Key Use this command to set the security key that is used throughout the sto...

Page 187: ... unnamedDiscoverySession TRUE FALSE Parameter Parameter Description unnamedDiscoverySession This parameter turns on or turns off unnamed discovery sessions Set the parameter to TRUE to turn on unnamed discovery sessions Set the parameter to FALSE to turn off unnamed discovery sessions NOTE Discovery is the process where initiators determine the targets that are available Discovery occurs at power ...

Page 188: ...tualDiskName virtualDisk wwID accessVirtualDisk logicalUnitNumber LUN host hostName hostGroup hostGroupName defaultGroup Parameters Parameter Description allVirtualDisks Specifies the properties for all virtual disks in the storage array virtualDisk or virtualDisks name Specifies the name of the virtual disk for which to define properties You can enter more than one virtual disk name if you use th...

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

Page 190: ...he accessVirtualDisk parameter the only property that you can set is the logicalUnitNumber logicalUnitNumber Defines specific virtual disk to LUN mappings to an individual host or assigns the host to a host group host Specifies the name of the host to which the virtual disk is mapped You must put quotation marks around the host name hostGroup Specifies the name of the host group to which the virtu...

Page 191: ...I O activity Valid entries are highest high medium low or lowest targetReadOnlyEnabled Specifies whether the target virtual disk is write enabled or read only To be able to write to the target virtual disk set to FALSE To prevent writing to the target virtual disk set to TRUE copyType Identifies a virtual disk copy with a snapshot If the virtual disk copy has a snapshot set this parameter to onlin...

Page 192: ...CSI target The command then displays only information about that particular iSCSI initiator or iSCSI target session Show Disk Group This command returns the following information about a disk group Status online or offline Physical disk type SAS Enclosure loss protection yes or no Current owner RAID controller module 0 or RAID controller module 1 Associated virtual disks and free capacity Associat...

Page 193: ... the physical disks stay spinning set this parameter to FALSE NOTE This command returns the dependencies of a specific disk group which must be in an Exported state or a Forced state If a decision is made to retain the listed dependencies then the cancelImport parameter can be enforced to spin the physical disks back down You must run the show diskGroup importDependencies command before you run th...

Page 194: ...isk SAS Basic physical disk information Enclosure location and slot location Status Capacity Data transfer rate Product ID Firmware level Physical disk channel information Enclosure location and slot location Preferred channel Redundant channel Hot spare coverage Details for each physical disk Depending on the size of the storage array this information can be several pages long The physical disk i...

Page 195: ...s Identifies the enclosure and slot where the physical disk resides You can enter enclosure IDs and slot IDs for one or several physical disks 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 summary Returns the status capacity data rate product ID and firmware version for the specified physical disks NOTE To ...

Page 196: ...ysicalDisks downloadProgress Parameters None NOTE When all firmware downloads have successfully completed this command returns a Successful status If any firmware downloads fail this command shows the firmware download status of each targeted physical disk This command returns the status values shown in the following table Status Definition Successful Downloads completed without errors Not Attempt...

Page 197: ...ed host type If you do not enter the optional parameters this command returns a list of all NVSRAM byte values Syntax show allControllers controller 0 1 NVSRAM hostType hostTypeIndexLabel host hostName Parameters Parameter Description allControllers Returns information about both RAID controller modules in the storage array controller Returns information about a specific RAID controller module in ...

Page 198: ...e The remote storage array that contains possible virtual disks for a secondary virtual disk If the remote storage array name has special characters it must be enclosed in double quotation marks Show Remote Replication Virtual Disk Synchronization Progress NOTE This command valid only with Fibre Channel storage arrays This command returns the progress of data synchronization between the primary vi...

Page 199: ...mation covers several screens on a display You might need to increase the size of your display buffer to see all the information Because this information is so detailed you might want to save the output of this parameter to a file To save the output to a file enter the show storageArray command similar to the following smcli 123 45 67 89 c show storagearray profile o c folder storagearray profile ...

Page 200: ...e disk group or virtual disk Long running operation Status complete Time remaining NOTE When you save the information to a file you can use the information as a record of your configuration and as an aid during recovery Show Storage Array Auto Configure This command shows the default autoconfiguration that the storage array creates if you issue the autoConfigure storageArray command To determine w...

Page 201: ... hotSpareCount Number of hot spares desired in the storage array Use integer values For information about hot spares see Assigning Global Hot Spares segmentSize Amount of data in kilobytes that the RAID controller module writes on a single physical disk in a virtual disk before writing data on the next physical disk Valid values are 8 16 32 64 128 256 or 512 For information about the segmentSize p...

Page 202: ...ch to see the LUN mappings You must put quotation marks and brackets around the host group name The host group name and quotation marks must be inside the brackets Show Storage Array Negotiation Defaults This statement returns information about connection level settings that are subject to initiator target negotiation Syntax show storageArray iscsiNegotiationDefaults Parameters None NOTE Informati...

Page 203: ...e data is sorted first by the virtual disk user label and second by the logical block address LBA Each entry in the table corresponds to a single sector Syntax show storageArray unreadableSectors Parameters None Show String This command shows a string of text from a script file This command is similar to the echo command in MS DOS and UNIX Syntax show textString Parameters None NOTE You must enclo...

Page 204: ...er Description allvirtualDisks The setting to return information about all of the virtual disks in the storage array virtualDisk or virtualDisks The name of the specific virtual disk for which you are retrieving information You can enter more than one virtual disk name Enclose the virtual disk name in square brackets If the virtual disk name has special characters you also must enclose the virtual...

Page 205: ...mation is returned Copy status Start timestamp Completion timestamp Copy priority Source virtual disk WWID or target virtual disk WWID Read only attribute setting of the target virtual disk You can retrieve information about a specific virtual disk copy pair or all virtual disk copy pairs in the storage array Syntax show virtualDiskCopy allVirtualDisks source sourceName target targetName Parameter...

Page 206: ...rameters 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 marks and brackets around the source virtual disk name The source virtual disk name and quotation marks must be inside the brackets Show Virtual Disk Performance Statistics This command returns information about the performance of the virtual...

Page 207: ...tart Configuration Database Diagnostic This command starts a diagnostic test to validate the configuration database in the controller firmware Syntax start storageArray configDbDiagnostic Parameters None Notes Upon completion of the diagnostic test the controller firmware returns one of these results Diagnosis completed without errors No ZIP file created Diagnosis completed with errors Refer to th...

Page 208: ...group to identify You must put brackets around the disk group number 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 defragment Parameter Parameter Description diskGroup Number of the disk group to defragment You must put bra...

Page 209: ...al NOTE Within the disk group you cannot move virtual disks that are associated with the premium features from one storage array to another storage array Syntax start diskGroup diskGroupName import Parameter Parameter Description diskGroup Number of the disk group to defragment You must put brackets around the disk group number NOTE Higher level virtual disks that are specifically related to premi...

Page 210: ...n which you want to refresh the DHCP parameters Enclose the iSCSI host port name in square brackets NOTE This operation ends the iSCSI connections for the portal and brings down the portal temporarily Start Physical Disk Blink This command blinks a physical disk by turning on an indicator light on the physical disk Run the stop physicalDisk blink command to turn off the indicator light on the phys...

Page 211: ...0 1 emms enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slotIDn physicalDisks enclosureID1 slotID1 enclosureIDn slotIDn dataPattern fixed pseudoRandom patternNumber 0xhexadecimal number maxErrorCount integer testIterations integer timeout timeInterval Parameters Parameter Description physicalDiskChannel The identifier number of the physical disk channel that you want to locate Valid values...

Page 212: ... You can stop this command at any time by pressing Ctrl C Start Physical Disk Initialize This command starts physical disk initialization CAUTION As soon as you enter this command all user data is erased Syntax start physicalDisk enclosureID slotID initialize Parameters Parameter Description physicalDisk Identifies the enclosure and slot where the physical disk resides Enclosure ID values are 0 to...

Page 213: ...o 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 physicalDisk enclosureID slotID physicalDisks enclosureID1 slotID1 enclosureID2 slotID2 enclosureIDn slotIDn Parameters Param...

Page 214: ...back operation leaves the base virtual disk in an indeterminate state with potentially invalid or inconsistent data The related snapshot virtual disk becomes disabled and unusable Syntax stop rollback virtualDisk snapshotVirtualDiskName Parameter Parameter Description virtualDisk Names the specific snapshot virtual disk for which you want to resume a rollback operation Enclose the snapshot virtual...

Page 215: ...has special characters you must also put quotation marks around the virtual disk name Stop Configuration Database Diagnostic This command stops the diagnostic test to validate the configuration database in the controller firmware that was started by the start storageArray configDbDiagnostic command Syntax Stop storageArray configDbDiagnostic Parameters None NOTE The controller firmware returns a c...

Page 216: ...ysical 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 enclosures that were turned on by the start physicalDiskChannel blink command Syntax stop physicalDiskChannel blink Parameters None Stop Physical Disk Channel Fault Isolation Diagnostics T...

Page 217: ...virtual disk name If the virtual disk name has special characters you must also put quotation marks around the virtual disk name Stop Storage Array Blink This command turns off the indicator lights on the storage array that were turned on by the start storageArray blink command Syntax stop storageArray blink Parameters None Stop Storage Array iSCSI Session This command forces the termination of an...

Page 218: ...ou 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 Suspend Remote Replication NOTE This command valid only with Fibre Channel storage arrays This command suspends a Remote Replication operation Syntax suspend remoteReplication primary primaryVirtualDiskName primaries p...

Page 219: ...ity Key This command validates the security key for a storage array that has self encrypting disk physical disks to make sure that the security key is not corrupt Syntax validate storageArray securityKey file fileName passPhrase passPhraseString Parameters Parameter Description file The file path and the file name to which you want to save the security key For example file C Program Files CLI sup ...

Page 220: ...NOTE If your pass phrase does not meet these criteria you receive an error message 220 ...

Page 221: ... text client smcli 123 45 67 89 f scriptfile scr Configuration Script Example 1 This example creates a new virtual disk using the create virtualDisk command in the free space of a disk group Show Create RAID 5 Virtual Disk 7 on existing Disk Group 1 Create virtual disk on a disk group created by the create virtual disk command Note For disk groups that use all available capacity the last virtual d...

Page 222: ... 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 addition properties that could not be set...

Page 223: ...mple shows how you can define specific physical disks to include in the virtual disk To find out what physical disks are available in a storage array run the show storageArray profile command The following syntax is the general form of the create virtualDisk command shown in the previous example create virtualDisk raidLevel 0 1 5 6 userLabel virtualDiskName physicalDisks enclosureID0 slotID0 enclo...

Page 224: ...224 ...

Page 225: ...nality available in the PowerVault MD32 and MD36 series of arrays Clear Storage Array Core Dump Clear Storage Array Recovery Mode Create Disk Pool Create RAID Virtual Disk on a Disk Pool Configure Automatic Support Bundle Collection Delete Disk Pool Delete Virtual Disk on a Disk Pool Display Automatic Support Bundle Collection Configuration Display Support Bundle Collection Schedule Enable Disk Po...

Page 226: ...Physical Disk Select Create Snapshot Virtual Disk Create Virtual Disk Copy Recopy Virtual Disk Copy Remove Virtual Disk Copy Reset Storage Array SAS PHY Baseline Save Storage Array Events Save Storage Array Support Data Set Snapshot Virtual Disk Set Virtual Disk Copy Show Storage Array Show Virtual Disk 226 ...

Reviews: