Home

3ware® SATA+SAS RAID Controller Card CLI Guide, Version 10.0

1. Example localhost gt c0 e0 show temp TempSensor Status Temperature Identify temp0 OK 41C 105F off templ OK 37C 98F Off temp2 OK 34C 93F off temp3 OK 38C 100F Off temps OK 38C 100F off temp5 OK 34C 93F Off temp6 NOT INSTALLED off temp7 NOT INSTALLED off This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command reports a summary of power supplies with their respective information for the specified enclosure The PowerSupply column lists the IDs of the power supply units the Status column lists the status of each power supply the State column indicate if the 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Enclosure Object and Element Commands unit is ON or OFF the Voltage and Current columns indicate whether the voltage or current is under or over the required thresholds and the Identify column lists the Identify setting of the power supplies Example localhost gt c0 e0 show pwrs PowerSupply Status State Voltage Current Identify pwrs0 OK on OK OK off pwrsl OK on OK OK Off cx ex show alarms Icx ex show This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex Note that in this command alarms may be abbreviated to alms as in this syntax usage cx ex s
2. 90002 Yes Yes Yes N A Yes Yes Yes No 9750 Yes Yes Yes Yes Yes Yes Yes No 9690SA and 9650SE a Models 95005 9550SX and 9590SE The quiet attribute turns off interactive mode where no confirmation is requested to proceed cx ux set rdcache basiclintelligentloff 92 This command allows you to set the read cache to either Basic Intelligent or Off on a specified unit Setting this to Intelligent enables both Intelligent Mode features and Basic Mode features Setting it to Off disables both This command is supported on the 9750 9690SA and 9650SE controllers This feature is supported in all types of RAID units 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands Read Cache Basic Mode is used to store read cache data locally on the controller that has recently been written to media and is likely to be frequently accessed This improves read access times for applications such as a database that can take advantage of storage caching The read cache may be disabled without reducing performance for applications that are write intensive or that rarely read back data recently written Read Cache Intelligent Mode enables the Intelligent Read Prefectch IRP feature The Intelligent Read Prefetch feature includes a typical read ahead caching method which is used to proactively retrieve data from media and store it locally on the controller with the anticipation that it may be requested by the
3. a pl OK u0 931 51 GB 1953525168 3QJ03W34 p2 OK u0 931 51 GB 1953525168 GTAO0OPAGE2JKA p3 OK ud 74 53 GB 156301488 SRX6AMGL p4 OK u0 931 51 GB 1953525168 3QJ0392E p5 OK u0 931 51 GB 1953525168 GTAOOOPAG67AGA p6 DEGRADED u0 931 51 GB 1953525168 30J01PG6 p7 OK S 931 51 GB 1953525168 GTAOOOPAGEI1RSA ps NOT PRESENT p9 NOT PRESENT 5 p10 NOT PRESENT m p11 NOT PRESENT Sn 5 p12 NOT PRESENT E p13 NOT PRESENT as p14 NOT PRESENT p15 NOT PRESENT Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu On Yes OK OK OK 0 XX XXK XKX cx show alarms reverse 46 Asynchronous event notifications also referred to as AENs or controller alarms are originated by controller firmware or an SES attached enclosure 9750 9690SA or 9650SE only and captured by the 3ware device drivers These events reflect warnings errors and or informative messages These events are kept in a finite queue inside the kernel and can be listed by CLI and 3DM 2 They are also stored in the operating system events log The cx show alarms command displays all available events on a given controller The default is to display the events in ascending order that is the oldest event messages appear at the top and the most recent event messages appear at the bottom You can use the reverse attribute to display the most recent event message at the top Events generated on 7000 8000 series controlle
4. localhost gt c0 p5 set identify on Setting Port Identify on c0 p5 to on Done www si com channel products 113 Chapter 2 CLI Syntax Reference cx px set dpmstat clear type ra lctlext This command only applies to 9000 series SX SE SA controllers except for type ext which applies only to SE SA models and 9750 models This command allows you to clear the data buffers of accumulated statistics information There are two reasons to clear this data e Once dpmstat is enabled statistics information continues to accumulate Eventually it can cause a buffer overflow causing all statistics information to be rendered as HHHF e You wish to have fresh data such as when switching between benchmarking writes to benchmarking reads This command clears the statistics counters of the Drive Performance Monitor The optional type attribute specifies which statistics should be cleared The options are ra for Running Average Ict for Long Command Times and ext for Extended Drive Statistics For more about these statistics see cx px show dpmstat type instlrallctlhistdatalext on page 110 Please note that if type ra both the Running Average and Histogram data are cleared If type Ict only the Long Command Times data will be cleared And if type ext the extended drive statistics are cleared If no type is specified the default is the same as type ra Note that there are no direct commands for clearing only histogram data
5. Example localhost gt c0 show numunits cO Number of Units 1 ex show ondegrade This feature only applies to 9500S controllers This command reports the write cache policy for degraded units If the ondegrade policy is Follow Unit Policy a unit write cache policy stays the same when the unit becomes degraded If the ondegrade policy is off a unit write cache policy will be forced to off when the unit becomes degraded Example localhost gt c0 show ondegrade c0 Cache on Degraded Policy Follow Unit Policy www si com channel products 43 Chapter 2 CLI Syntax Reference cx show pcb cx show pchip cx show serial cx show spinup cx show stagger 44 This command reports the PCB Printed Circuit Board version of the specified controller cx Example localhost gt c0 show pcb c0 PCB Version RevX This command reports the PCHIP PCI Interface Chip version of the specified controller cx Example localhost gt c0 show pchip c0 PCHIP Version 1 x This command reports the serial number of the specified controller cx Example localhost gt c0 show serial c0 Serial Number F12705A3240009 This feature only applies to 9000 series controllers This command reports the number of concurrent SAS and SATA disks that will spin up when the system is powered on after waiting for the number of seconds specified with the set stagger command Spinup does not work with SA
6. 1 fastest I O slowest verify This command applies to the 7000 8000 and 9000 models controllers Example localhost gt cl show verifyrate cl Verify task rate 4 faster verify slower 1 0 Related commands cx set verifymode lt adaptivellowlatency gt cx set verifyrate lt 1 5 gt cx show verifymode www si com channel products 55 Chapter 2 CLI Syntax Reference cx add type lt Ra dType gt disk lt p p gt stripe s ze noscan group lt 3 4 5 6 7 8 9 10 11 12 13 14 15 16 gt nocache nowrcache nordcache rdcachebasic autoverify noqpolicy ignoreECC name string storsave lt protect balance perform gt rapidrecovery all rebuild disable vO n vol a b c d This command allows you to create a new unit on the specified controller You specify type disks and optional stripe size By default the host operating system will be informed of the new block device write cache will be enabled Intelligent read cache will be enabled a storsave policy of balance will be set a rapid raid recovery policy of All will be set and the drive queuing policy is enabled In case of RAID 50 you can also specify the layout of the unit by specifying the number of disks per disk group with the group attribute BBU installed a message will warn you that you could lose data in the event of a Note By default write cache is enabled However if the controller does not have a power failure Enabling write cac
7. RAID 6 with hot spare RAID 50 Combination of RAID 0 1 5 6 10 hot spare single disk Using Drive Capacity Efficiently To make the most efficient use of drive capacity it is advisable to use drives of the same capacity in a unit This is because the capacity of each drive is limited to the capacity of the smallest drive in the unit The total unit capacity is defined as follows Table 4 Drive Capacity RAID Level Single Disk Capacity Capacity of the drive RAID 0 number of drives X capacity of the smallest drive RAID 1 Capacity of the smallest drive RAID 5 number of drives 1 X capacity of the smallest drive Storage efficiency increases with the number of disks storage efficiency number of drives 1 number of drives RAID 6 number of drives 2 x capacity of the smallest drive RAID 10 number of drives 2 X capacity of smallest drive RAID 50 number of drives number of groups of drives X capacity of the smallest drive 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Understanding RAID Levels and Concepts Through drive coercion the capacity used for each drive is rounded down so that drives from differing manufacturers are more likely to be able to be used as spares for each other The capacity used for each drive is rounded down to the nearest GB for drives under 45 GB 45 000 000 000 bytes and rounded down to the nearest
8. cx ex show attribute attribute where attributes are controllers diag protocol slots fans temp pwrs alarms cx ex show all cx ex slotx show cx ex slotx show identify cx ex slotx set identify on off cx ex fanx show cx ex fanx show identify cx ex fanx set identify on off 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Ic x ex show www si com channel products Enclosure Object and Element Commands cx ex fanx set speed lt 0 1 2 3 4 5 6 7 gt cx ex pwrsx show cx ex pwrsx show identify cx ex pwrsx set identify on off cx ex tempx show cx ex tempx show identify cx ex tempx set identify on off cx ex almx show cx ex almx set alarm mute unmute off This command is used with 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex This command shows summary information on the specified enclosure ex ex This report consists of several parts depending on the available elements of the enclosures Typically the summary consists of the Enclosure section listing the set of enclosures a Fan section a Temperature Sensor section a Power Supply section a Slot section and an Alarm section Example localhost gt c0 e0 show Encl Status c0 e0 0 Fan Status State Step RPM Identify fan0 O ON 1 2670 Off fanl O ON 1 9500 Off fan2 O ON 1 8540 Off fan3 O ON I 2830 Off fan4 O ON 1 9120 off fan5
9. host For example the host may read blocks 1 2 and 3 With the read ahead caching included in IRP the controller will also retrieve and hold in its cache blocks 4 5 and 6 in anticipation of getting those command requests from the host By loading a larger set of data into the cache chances are improved that another request can be filled by data that is already in the cache This can be helpful with applications that are sequential in nature such as video on demand video surveillance playback and restoring from a disk to disk backup Performance benefits of read ahead are especially pronounced when the host queue depth is low In addition read ahead caching also improves sequential read performance when the unit is degraded The Intelligent Read Prefetch IRP feature also includes an adaptive stream management layer to improve performance at higher queue depths in multiple read only or mixed read write stream environments The performance improvements should be seen for most RAID types regardless of the unit s operating unit state normal degraded and so forth Example localhost gt c0 u0 set rdcache basic Setting Read Cache Policy on c0 u0 to basic Done c x ux set identify 0n Joff This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This feature requires a supported enclosure For additional information about enclosure related commands see Enclosure Object and Elem
10. in a command window type tw_cli cO show c0 info displayed here if errorlevel 0 echo 0 0 tw_cli c7 show SELLO Ls if errorlevel 1 echo 1 1 This example fails returns 1 because there is no controller 7 www si com channel products 141
11. see cx px show dpmstat type instlrallctlhistdatalext on page 110 Drive Performance Monitoring can be turned on and off using the command cx set dpmstat onloff on page 68 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands Example of inst drive statistics To display a summary of instantaneous data for the set of drives attached to the controller use command cx show dpmstat since inst is the default you do not have to explicitly enter it in the command Since this is a controller level command the output provides summary information for the set of drives attached to the controller For statistics about a drive attached to a specific port see cx px show dpmstat type instlrallctlhistdatalext on page 110 In the configuration information displayed below the Performance Monitor is shown to be On Version refers to the firmware version of the Performance Monitor Max commands for averaging refers to the maximum number of commands that can be saved and used for calculating the average and Max latency commands to save refers to the maximum number of commands with high latency that are saved The amount of statistics data in the buffer is determined by these configurations and the memory constraints of the system These configuration settings cannot be changed at this time localhost gt cO show dmpstat Drive Performance Monitor Configuration for c0 Perf
12. 00 64 64 OC 01 00 00 00 00 00 OA 13 00 64 64 00 00 00 00 00 00 00 OC 32 00 64 64 52 00 00 00 00 00 00 BB 32 00 64 64 00 00 00 00 00 00 00 BD 3A 00 64 64 00 00 00 00 00 00 00 BE 22 00 40 38 24 00 1B 28 00 00 00 C2 22 00 24 2C 24 00 00 00 19 00 00 C3 1A 00 3B 38 68 2B 4E 00 00 00 00 C5 12 00 64 64 00 00 00 00 00 00 00 C6 10 00 64 64 00 00 00 00 00 00 00 C7 3E 00 C8 C8 00 00 00 00 00 00 00 C8 00 00 64 FD 00 00 00 00 00 00 00 CA 32 00 64 FD 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 82 00 AE 01 00 5B 03 00 01 00 01 CA 02 00 00 00 00 00 00 00 00 00 00 00 0B 01 00 00 02 07 07 07 07 06 07 07 07 00 00 00 00 00 00 00 00 01 3A 68 E2 4B 00 00 00 00 00 00 C5 AB 08 58 1D 00 00 00 00 00 00 00 00 00 00 00 00 00 3A 68 E2 4B 00 00 00 00 00 00 00 00 02 00 01 00 00 00 00 00 00 00 C5 60 F4 BC 00 00 00 00 30 00 00 00 00 00 00 00 0B 01 00 00 00 00 C4 55 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 CC dpmstat typeSinst ra lct histdatalext This command only applies to 9750 and 9000
13. 5 GB for drives over 45 GB For example a 44 3 GB drive will be rounded down to 44 GB and a 123 GB drive will be rounded down to 120 GB 3 Note All drives in a unit must be of the same type either SAS or SATA Support for Over 2 Terabytes Legacy operating systems such as Windows 2000 Windows XP 32 bit Windows 2003 32 bit and 64 bit without SP1 and Linux 2 4 do not recognize unit capacity in excess of 2 TB If the combined capacity of the drives to be connected to a unit exceeds 2 Terabytes TB you can enable auto carving when you configure your units Auto carving divides the available unit capacity into multiple chunks of 2 TB or smaller that can be addressed by the operating systems as separate volumes The carve size is adjustable from 1024 GB to 2048 GB default prior to unit creation If a unit over 2 TB was created prior to enabling the auto carve option its capacity visible to the operating system will still be 2 TB no additional capacity will be registered To change this the unit has to be recreated You may also want to refer to Knowledge Base article 13431 at https selfservice lsi com service main jsp Use Advanced search and enter the KB as a keyword www si com channel products 17 2 CLI Syntax Reference This chapter provides detailed information about using the command syntax for the 3ware CLI Throughout this chapter the examples reflect the interactive method of executing 3wa
14. A denotes that the percentage completion of the process is for the current active process and P denotes that the percentage completion of the process is for the current paused process Example localhost gt c0 show unitstatus Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy Here the RAID 6 unit u0 is in the Rebuild Verify state with percentage Rebuild completion of 50 and is the current active process The process of either Verifying Initializing or Migrating is at 70 and it is a paused process For the unit display localhost gt c0 u0 show Unit UnitType Status SRCmpl V 1I M Port Stripe Size GB u0 RAID 6 REBUILD VERIFY 50 A 70 P 64K 2683 80 u0 0 DIS O a p0 298 20 u0 1 DIS O gt pl s 298 20 u0 2 DIS O p2 298 20 u0 3 DIS REBUILDING 80 p3 298 20 u0 4 DIS O p4 298 20 u0 5 DIS O p5 298 20 u0 6 DIS O p6 298 20 u0 7 DIS O gt p7 298 20 u0 8 DIS REBUILD PAUSE 20 p8 298 20 u0 9 DIS O p9 298 20 u0 10 DIS O rs p10 298 20 u0 11 DIS O za p11 gt 298 20 www si com channel products 81 Chapter 2 CLI Syntax Reference c x ux show In the above example the RAID 6 unit u0 has 2 parity drives Currently it has two REBUILDING drives one is in the active rebuilding state and another is in the paused rebuild state The unit is also in the paused VERIFY state Like the output of the ex show unitstatus command the top level uni
15. AAA 136 help ESC iii A Ge tek pus A Rates s 136 Nelp update eco io Aad ae detect hag dan ob i a agri est 137 help COMM ME shee oa 137 help focus 2 svat Sete A ee hee oe YE hee Ne D OEA 137 help eX ieh eae ogee ag teal a ees pene od Pinan Pe ate ates eee eae a age ee 137 help CX PNYX oi Bete ee oleae ae as Bi a oie eke Mere 137 Nelp OX UX ese Bora as eer ee cei Reel er gee cat eee ee 137 Help CX DX raaa oe he ea ein eh oe ee near eae oS eatin i 137 help CX DDUE ities eee ole hia Bod a See 138 A A sad ol ey aie cae aie AA eyed HERG ake date ey ache AE 138 help CXMOXSIO Xica be ea ee eed ee ee 138 help Cx Oxfanx es gia ee di Vag DE lek eis nd SES 138 help cx ext Mpx 2 2h5s 0 hoe eb eet ieee ene beds See 138 Nelp CX SX PWISK ie ec ele di ae yes had eae a RA Aw eens aye ee pale Heese AR 138 help ex exialMx A a a eS 139 Command LOgging vias a a A eats 139 Location of the Log File 0 00 0 cece ee eee eee 139 Disabling and enabling command logging ee eee eee eee ee 140 Return Code tota lr tl tinal ght arta 141 www si com channel products vii About this CLI Guide 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 provides instructions for configuring and maintaining your 3ware controller using 3ware s command line interface CLI This guide assumes that you have already installed your 3ware RAID controller in your system If you have not yet done so see the installation guide that came
16. Installing the 3ware CLI on Linux 3ware CLI can be installed or run directly from the 3ware software CD or the latest version can be downloaded from the LSI web site http w ww si com channel ChannelDownloads To install 3ware CLI on Linux Do one of the following Copy the file Copy the file tw_cli to the directory from which you want to run the program CLI is located on the 3ware CD in the following directory packages cli linux Online manual pages are also available in nroff and html formats These are located in packages cli tw_cli 8 html or tw_cli 8 nroff You will need to be root or have root privileges to install the CLI to usr sbin and to run the CLI Notes The installation location needs to be in the environment path for root to execute the CLI without using complete paths i e if installed to usr sbin you can type tw_cli on the command line otherwise you will have to type the complete path home user tw_cli The 3ware CLI comes in both 32 bit and 64 bit versions If you are copying the file directly be sure to copy the correct version for the version of the operating system you are using Use the setup command from a command line e Navigate to one of the following directories on the 3ware CD packages installers tools linux x86 packages installers tools linux x86_64 e Type depending upon which directory you are in setupLinux_x86 bin console or setupLinux_x64 bin console
17. Inthe Properties dialog box click on the Advanced tab 3 On the Advanced tab click the Environment Variables button You can add a new variable by clicking New or edit an existing variable by selecting TW_CLI_LOG in the list and clicking Edit 140 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Return Code 4 If this is the first time you are creating the environment variable and you want to disable command logging add the variable TW_CLI_LOG and specify the value as OFF Command logging is on by default 5 If the environment variable already exists you may enable or disable it by editing the value and changing it to ON or OFF as desired 6 Restart your system for the new environment variable setting to take effect Return Code While informative messages are written to standard output error messages are written to standard error On success 0 is returned On failure 1 is returned To view the return code for Linux At the shell command prompt type echo The screen prints either a 0 or a 1 depending on whether the command was successful or not For example if you had a 3ware controller with an ID of 0 you could type this command tw_cli cO show c0 information displayed here echo 0 If you type tw_cli c7 show error CLI003 specified controller does not exist echo 1 This example fails returns 1 because there is no controller 7 To view the return code for Windows
18. Os to maximize the speed of both host I O and rebuild tasks The Low Latency setting minimizes latency delay in reading data from a RAID unit by slowing down the rebuild task process For some applications such as video server applications and audio applications it is important to minimize the latency of read commands so that users do not perceive a lag when viewing video or listening to audio For a more complete discussion of background task modes see Working with the Background Task Mode in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt cl show rebuildmode cl Rebuild background task mode Low Latency Related commands cx set rebuildmode lt adaptivellowlatency gt cx set rebuildrate lt 1 5 gt cx show rebuildrate cx show rebuildrate This command shows the current rebuild task rate of the specified controller The rebuild task rate sets the rebuild execution priority relative to I O operations This task rate is of the range 1 5 where 5 denotes the setting of fastest background task and slowest I O as follows www si com channel products 51 Chapter 2 CLI Syntax Reference 5 fastest rebuild slowest I O 4 faster rebuild slower I O 3 balanced between rebuild and I O 2 faster I O slower rebuild 1 fastest I O slowest rebuild This command applies to the 7000 8000 and 9000 models controllers Example localhost gt cl show rebui
19. Os to maximize the speed of both host I O and verify tasks When a verify background task is active if the task rate is set to a fast verify rate 1 e low I O rate the system latency increases and performance may be negatively affected especially for applications such as video server applications and audio applications The Low Latency setting will minimize the latency delay in reading data from the RAID unit by slowing down the rebuild task which allows host Reads to complete thus improving performance For a more complete discussion of background task modes see Working with the Background Task Mode in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 recommended when I O is active because in that case the verify as a background i Important Setting verifymode to low latency and verifyrate to 5 is not task may never complete Thus this setting should be used with care Example localhost gt cl set verifymode lowlatency Setting Verify background task mode of cl to lowlatency Done Related commands ex show verifymode cx set verifyrate lt 1 5 gt cx show verifyrate www si com channel products 73 Chapter 2 CLI Syntax Reference cx set verifyrate lt 1 5 gt This command sets the verify task rate of the specified controller The verify task rate sets the verify execution priority relative to I O operations This task rate is of the range 1 5 where 5 den
20. See the section Enclosure Object and Element Commands on page 122 for more information 138 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Command Logging help c x ex almx This command provides specific enclosure alarm cx ex almx related help illustrating various ways to use the cx ex almx command See the section Enclosure Object and Element Commands on page 122 for more information Command Logging Both CLI and 3DM 2 have a logging function that makes an entry into a log file for each command line that makes a change to the controller configuration for example add delete units This logging function is enabled by default for CLI It can be turned on for 3DM 2 through the 3DM 2 web interface You may be asked to supply this log file to tech support for troubleshooting Location of the Log File The log file name is tw_mgmt log For Windows Vista Server 2008 and Windows 7 The log file is stored in ProgramData 3ware Note that ProgramData is a hidden folder by default To display it in Windows Explorer enter cYWProgramData in the location field at the top of the Explorer Window To make the folder permanently visible select Organize gt Folder and Search Options from the Explorer menu choose the View tab and select the Show hidden files and folders option in Advance settings For all previous versions of Windows XP Server 2003 etc The log file is stored in Documents and Set
21. Show identify sra a Minot et dae ete es 83 cx ux show ignoreECC 1 ttt ee 83 cx ux show initializestatus 1 0 auauua 83 ex UX SHOW NAME sce is A DA Ad LS 83 CX UX SNOW QPOIICY eii aa bale ys ah a eee N 84 cx ux show rapidrecovery 0 0 cee tenes 84 cx ux show rebuildstatuS 0 ee tees 84 ex ux show Serial dorii ei Sen ea ed Ee nen be ae eee Rk ey 85 EXE SNOW SlAtUS otk ced eS ha o ete bane debe aE E 85 X UX SHOW SIOFSAVE oia cia cheep Gos nye acne le Sop gp ee we SCR Ee 85 cx ux show VerifyStatUS 0 tes 85 ICXIUX show voluMeS itai ei aa i a ee eens 86 LEXUS AO WAI a ci a o a ia a 86 cx ux remove noscan quiet 0 eee eee ee 87 cx ux del noscan quiet 26 0 eee eee 87 cx ux start rebuild disk lt p p gt ignoreECC 0 eee ee 88 LEX Start Verify se rinda a eS oR Ree Saeed oh ae hea Hao ti Bs 88 cxfux pause rebuild ooooooooooocorroo eee 90 exfuxresume rebuild iea a SE E ee ee eee 90 Jex x STOP verify 2 2 2 iol wep ee tri A Pee wae ee 90 OX UX A aca pind eg ata SANE TE avius hae SOE AAE es 90 cx ux set autoverify OnJOff 0 tne 90 cx ux set cache on off quiet 6 0 0 eee 92 cx ux set wrcache on off quiet 1 6 0 eee eee 92 cx ux set rdcache basiclintelligent off 0 2 eee eee 92 ex ux setidentify on Off 2 ue ese eed Rae a eee eee bee ad 93 cx ux set ignoreECC onloff nnan tte eee 94 cx ux SeUN
22. and may be caused by an ECC error SMART failure or a device error Rescanning the controller will clear the drive error status if the condition no longer exists 3 Note If an asterisk appears next to the status of a unit there is an error on one For controllers with read cache support 9650SE and newer controllers with release 9 5 2 or later the Cache column displays the settings of both the read cache and the write cache Below is a summary of the possible settings in the Cache column W only the write cache is enabled Rb only the read cache Basic Mode is enabled Ri only the read cache Intelligent Mode is enabled RbW the read cache Basic Mode and the write cache are both enabled RiW the read cache Intelligent Mode and the write cache are both enabled OFF all caches are disabled Note that when the Intelligent Mode of the read cache is enabled the Basic Mode features are also enabled For details see cx ux set rdcache basiclintelligentloff on page 92 For earlier controllers the Cache column displays only the write cache setting of ON or OFF www si com channel products 33 Chapter 2 CLI Syntax Reference For the 9750 and 9690SA controller models and 9650SE controllers with Release 9 5 2 or later this section lists the ports or virtual ports present and for each port specifies the port or vport number drive status unit affilication drive type phy number if direct attached the enclosure a
23. and would prefer a simpler verification schedule consider using the cx set verify basic command to specify a weekly day and time and make sure that the auto verify policy is set for your RAID units For more information see cx set verify basic pref ddd hh on page 72 Example localhost gt cl add verify Sun 16 3 Adding scheduled verify to slot 3 for Sun 4 00PM 3hr s Done In this example a verify task slot is added to the schedule so that verifies can be executed on Sundays at 16 hours 4 00 PM for a duration of 3 hours www si com channel products 65 Chapter 2 CLI Syntax Reference 66 Setting Up a Verify Schedule Setting up a verify schedule requires several steps and several different CLI commands in addition to cx add verify To set up the verify schedule you want to use follow this process 1 Use the ex show verify command to display the current schedule for verify tasks For details see page 53 2 If any of the scheduled tasks do not match your desired schedule use the ex del verify command to remove them For details see page 68 3 Use the ex add verify command to create the verify schedule slots you want described above 4 Use the cx set verify enable command or the cx set verify advanced to enable the schedule this enables all rebuild schedule slots For details see page 71 5 Use the cx ux set autoverify on command to turn on autoverify for each unit you want to fo
24. c2 e0 s1t9 AXTOR ATLAS15K2_36 p17 O u0 34 25 GB SAS z c2 e0 slt10 MAXTOR ATLAS15K2_36 pls O u0 34 18 GB SAS c2 e1 slt7 HITACHI HUS151436VL p19 0 u0 34 18 GB SAS c2 e1 s1t8 HITACHI HUS151436VL p20 O u0 34 18 GB SAS c2 e1 s1t9 HITACHI HUS151436VL p21 O u0 34 18 GB SAS c2 e1 s1t10 HITACHI HUS151436VL p22 O u0 34 25 GB SAS c2 e0 s1t11 MAXTOR ATLAS15K2_36 www si com channel products 41 Chapter 2 CLI Syntax Reference p23 O u0 34 25 GB SAS c2 e0 s1t12 MAXTOR ATLAS15K2_36 p24 Oo 34 25 GB SAS c2 e0 slt13 MAXTOR ATLAS15K2_36 p25 Oo 34 25 GB SAS c2 e0 s1t14 MAXTOR ATLAS15K2_36 p26 0 34 18 GB SAS c2 e1 s1t11 HITACHI HUS151436VL p27 0 ai 34 18 GB SAS c2 e1 s1t12 HITACHI HUS151436VL p28 0 3 34 18 GB SAS c2 e1 s1t13 HITACHI HUS151436VL p29 0 34 18 GB SAS c2 e1 s1t14 HITACHI HUS151436VL p30 0 34 25 GB SAS c2 e0 slt15 MAXTOR ATLAS15K2_36 p31 0 z 34 18 GB SAS c2 e1 s1t15 HITACHI HUS151436VL cx show firmware This command reports the firmware version of controller cx Example localhost gt c0 show firmware cO Firmware Version FE9X 3 03 06 X03 cx show memory This command reports the available memory on the controller memory available will be less than the controller actually has installed For example the 9690SA controller has 512MB of memory of which 448MB is available 3 Note Some memory is reserved for use by the controller so the amount
25. destination unit One or more ports can be specified Multiple ports can be specified using a colon or a dash as port index separators A dash indicates a range and can be mixed with colons For example disk 0 1 2 5 9 12 indicates port or VPort 0 1 2 through 5 inclusive 9 and 12 group 3 415161718191 0111112113114115116 indicates the number of disks per group for a RAID 50 type This attribute can only be used when type raid50 Recall that a RAID 50 is a multi tier array At the bottom most layer N number of disks per group are used to form the RAID 5 layer These RAID 5 arrays are then integrated into a RAID 0 This attribute allows you to specify the number of disks in the RAID 5 level Valid values are 3 through 12 For example group 3 indicates 3 disks of RAID 5 at the bottom layer of RAID 50 Note You can have a maximum of 4 subunits in a RAID 50 unit Note that a sufficient number of disks are required for a given pattern or disk group For example given 6 disks specifying 3 will create two RAID 5 arrays With 12 disks specifying 3 will create four RAID 5 arrays under the RAID 0 level With only 6 disks a grouping of 6 is not allowed as you would basically be creating a RAID 5 The default RAID 50 grouping varies based on number of disks For 6 and 9 disks default grouping is 3 For 8 disks the default grouping is 4 For 10 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands disks
26. drive fails Fault tolerance is a basic requirement for critical systems like web and database servers 3ware uses a patented technology TwinStor on RAID 1 arrays for improved performance during sequential read operations With TwinStor technology read performance is twice the speed of a single drive during sequential read operation The adaptive algorithms in TwinStor technology boost performance by distinguishing between random and sequential read requests For the sequential requests generated when accessing large files both drives are used with the heads simultaneously reading alternating sections of the file For the smaller random transactions the data is read from a single optimal drive head Figure 2 RAID 1 Configuration Example RAID 1 120 GB 240 GB 120 GB for mirror 120 GB 120 GB RAID 5 RAID 5 provides performance fault tolerance high capacity and storage efficiency It requires a minimum of three drives and combines striping data with parity exclusive OR to restore data in case of a drive failure Performance and efficiency increase as the number of drives in a unit increases Parity information is distributed across all of the drives in a unit rather than being concentrated on a single disk see Figure 3 This avoids throughput loss due to contention for the parity drive 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Understanding RAID Levels and Concepts RAID 5 is able to tolerate 1
27. ext Extended Drive Statistics for c3 Sectors Port Read Write po 28704384 0 p2 28704384 28704448 p3 28704704 0 p6 0 0 28704384 0 0 0 28704448 0 0 0 0 0 0 0 Note Depending on the amount of I O and the rate or duration of the data transfer overflow of the buffers containing this data can occur In this case the overflow is marked with HHHEHHEP as shown in the example below If this occurs you may want to zero out the counters by using the clear command cx px set dpmstat clear type rallctlext on page 114 Example of drive statistics overflow localhost gt c3 show dpmstat type ext Commands Extended Drive Statistics for c3 Sectors Port Read Write Write FUA po O 158838656 p2 PARRA PEERERRE HAHAHA p3 HARE O 0 p6 0 0 0 158838720 0 BERIA HAERA FERRER ARA 0 0 0 0 0 0 40 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx show drivestatus This command reports a list of drives and their port assignment status the unit with which they are associated their size in gigabytes and blocks and the serial number assigned by the drive manufacturer Definitions of the drive statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example for 9650SE and earlier controllers localhost gt c0 show drivestatus Port Status Unit Size Block
28. in hexadecimal form www si com channel products 107 Chapter 2 CLI Syntax Reference Notes E The SMART data is not decoded If the drive attached to the specified port is not present or if there are cabling problems reaching the drive CLI will return an error This can be one way of detecting whether or not a drive is present For SAS drives although the SMART data is now included when you use this command drive attributes for temperature spindle speed reallocated sectors and power on hours could be extracted from SMART data with the following commands cx px show temperature cx px show spindlespd cx px show rasect cx px show pohrs You may also use cx px show all to retrieve all of the drive attributes Example localhost gt c0 p5 show smart 10 00 01 OF 00 C8 C8 00 00 00 00 00 00 00 03 03 00 DA B5 34 08 00 00 00 00 00 04 32 00 64 64 88 00 00 00 00 00 00 05 33 00 C7 C7 01 00 00 00 00 00 00 07 OF 00 C8 C8 00 00 00 00 00 00 00 09 32 00 42 42 2A 63 00 00 00 00 00 0A 13 00 64 64 00 00 00 00 00 00 00 0B 12 00 64 64 00 00 00 00 00 00 00 OC 32 00 64 64 88 00 00 00 00 00 00 BE 22 00 3A 2F 2A 00 00 00 00 00 00 C2 22 00 69 5E 2A 00 00 00 00 00 00 C4 32 00 C7 C7 01 00 00 00 00 00 00 C5 12 00 C8 C8 00 00 00 00 00 00 00 C6 10 00 C8 C8 00 00 00 00 00 00 00 C7 3E 00 C8 C8 01 00 00 00 00 00 00 C8 09 00 C8 C8 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 0
29. increase the speed for best performance usually one level higher Possible speeds include 33 66 100 and 133 Mhz 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands SMART activity instructs the controller to check certain SMART supported thresholds by the disk vendor An AEN is logged to the alarms page if a drive reports a SMART failure The show selftest command displays the current selftest background task schedule as illustrated below Selftests do not have a time duration since they are completed momentarily localhost gt cl show selftest Selftest Schedule for Controller cl Slot Day Hour UDMA SMART 1 Sun 12 00am enabled enabled 2 Mon 12 00am enabled enabled 3 Tue 12 00am enabled enabled 4 Wed 12 00am enabled enabled D Thu 12 00am enabled enabled 6 Fri 12 00am enabled enabled Sat 12 00am enabled enabled cx show verify 9000 series controllers support background tasks and allow you to schedule a regular time when they occur Verify is one of the supported background tasks and show verify shows you the current verify schedule For 9750 9690SA and 9650SE RAID controllers the Verify Task Schedule can be either basic or advanced For details about the associated comands see cx set verify advancedlbasicl1 5 on page 72 The basic Verify Task Schedule sets a weekly day and time for verification to occur and is designed to be used with the auto verificatio
30. inserted since the controller allows time for the empty ports to respond cx start mediascan This command applies only to 7000 8000 controllers For 9000 series controllers use the verify command This command provides media scrubbing for validating the functionality of a disk including bad block detection remapping and so forth The command starts a media scan operation on the specified controller cx cx stop mediascan This command applies only to 7000 8000 controllers This commands stops a media scan operation on the specified controller cx Media scans are started using cx start mediascan 78 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands Unit Object Commands Unit Object commands provide information and perform actions related to a specific unit such as c0 u1 unit 1 on controller 0 For example you use logical disk object commands for such tasks as seeing the rebuild verify or initialize status of a unit starting stopping and resuming rebuilds and verifies and setting policies for the unit Note Features indicated as 9690SA only 9000 series or 9000 series SE SA E only also apply to 9750 controllers Syntax cx ux show cx ux show attribute attribute where attributes are autoverify 9000 series initializestatus cache wrcache rdcache name 9000 series qopolicy 9000 series SX SE SA only rebuildstatus serial 9000 series sta
31. is further presented If the Auto Carving policy was on at the time the unit was created and the unit is over the carve size multiple volumes were created and are displayed at the end of the summary information Similarly if the unit was created using the 3ware BIOS utility 3BM and a size was entered in the Boot Volume Size field multiple volumes were created and will be displayed Note that a volume created using the Boot Volume Size feature does not have to be used as a boot volume Note In the output of unit information tables that follows the column Port may be VPort depending on the applicable controller Example for 9750 and 9690SA controllers localhost gt c0 ul show Unit UnitType Status SRCmpl V I M VPort Stripe Size GB u RAID 0 O 64K 3576 06 ul 0 DIS O a po za 298 0 ul 1 DIS O a pl 298 0 ul 2 DIS O gt p2 298 0 ul 3 DIS O e p3 i 298 0 ul 4 DIS O p4 298 0 ul 5 DIS O pos 298 0 ul 6 DIS O p6 7 298 0 ul 7 DIS O p7 298 0 ul 8 DIS O gt p8 oa 298 0 ul 9 DIS O p9 hr 298 0 ul1 10 DIS O plo 5 298 0 ul 11 DIS O a p11 x 298 0 ul vo Volume A 2047 00 ul vl Volume S 5 S 1529 06 Example for 9650SE and earlier controllers localhost gt c0 u0 show Unit UnitType Status RCmpl V I M Port Stripe Size GB u0 RAID 50 O 64K 596 05 u0 0 RAID 5 O 64K u0 0 0 DISK O gt po 149 10 u0 0 1 DISK O p2 149 10 u0
32. is to prevent the operating system from creating block special devices such as dev sdb and dev sdc as some implementations might create naming fragmentation and a moving target nocache or nowrcache attribute instructs CLI to disable the write cache on the newly created unit Enabling write cache increases write performance at the cost of potential data loss in case of sudden power loss unless a BBU or UPS is installed By default the write cache is enabled To avoid the possibility of data loss in the event of a sudden power loss it is recommended 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands to set nocache or nowrcache unless there is a BBU battery backup unit or UPS uninterruptible power supply installed nordcache attribute instructs CLI to disable the read cache on the newly created unit Enabling the read cache increases performance The rdcachebasic attribute instructs CLI to set the read cache mode on the newly created unit to Basic By default if you do not set a read cache attribute the read cache mode is set to Intelligent This command is supported on 9650SE and later controllers For more information see cx ux set rdcache basiclintelligentloff on page 92 autoverify attribute enables the autoverify attribute on the unit that is to be created For more details on this feature see cx ux set autoverify onloff on page 90 This feature is not supported on model 7000
33. necessary change to the directory that contains CLI 2 Enter the following command tw_cli Under Linux if the directory containing the CLI is not in your path you may need to type tw_cli www si com channel products 5 Chapter 1 Introduction to the 3ware Command Line Interface The main prompt is displayed indicating that the program is awaiting a command localhost gt 3 At the CLI prompt you can enter commands to show or act on 3ware controllers units and drives For example localhost gt show displays all controllers in the system and shows summary information about them like this Ctl Model Ports Drives Units NotOpt RRate VRate BBU c0 9750 41 4 12 2 0 1 1 cl 9650SE 4 4 4 1 0 3 5 TESTING c2 7500 12 12 8 3 1 2 D Using a single command with output You can use 3ware CLI with line arguments processing a single command at a time To do so simply enter the command and the arguments Single commands can be useful when you want to perform a task such as redirecting the output of the command to a file It also allows you to use the command line history to eliminate some typing Syntax tw_cli lt command_line_arguments gt Example tw_cli c0 show diag gt tmp 3w_diag out Using an input file to execute a script You can operate 3ware CLI scripts by executing a file The file is a text file containing a list of CLI commands which you have entered in advance Each command must be on a
34. of array is an attribute with raid1 as the value of the attribute and disk is another attribute with 0 1 as the value ports 0 through 1 Information about commands is organized by the object on which the commands act Shell Object Commands Shell object commands set the focus or provide information such as alarms diagnostics rebuild schedules and so forth about all controllers in the system For details see Shell Object Commands on page 24 Controller Object Commands Controller object commands provide information and perform actions related to a specific controller For example you use controller object commands for such tasks as seeing alarms specific to acontroller creating schedules during which background tasks are run and setting policies for the controller You also use the controller object command ex add type to create RAID arrays For details see Controller Object Commands on page 31 Unit Object Commands Unit object commands provide information and perform actions related to a specific unit on a specific controller For example you use unit object commands for such tasks as seeing the rebuild verify or initialize status of a unit starting stopping and resuming verifies starting and stopping rebuilds and setting policies for the unit You also use the www si com channel products 23 Chapter 2 CLI Syntax Reference controller object command cx ux migrate to change the configuration of a RAID
35. of the first few volumes after which the auto carve size is used for additional volumes For more about auto carving see cx set autocarve onloff on page 75 and cx set carvesize 1024 32768 on page 76 Notes If the total size of the specified volumes up to 4 exceeds the size of the E array the volume s that exceeded the array s size boundary will not be carved Example of RAID 5 unit created with first volume set to 10 GB localhost gt c0 add type raid5 disk 2 5 v0 10 Creating new unit on Controller c0 Done The new unit is cO u0 Setting write cache ON for the new unit Done Setting default Command Queuing Policy for unit c0 u0 to on Done After the unit creation a subsequent show command for the unit shows the the volume size s localhost gt c0 u0 show Unit UnitType Status SRCmpl V I M VPort Stripe Size GB u0 RAID 5 OK 256K 1117 56 u0 0 DISK OK p2 3724519 u0 1 DISK OK p3 e 312 519 u0 2 DISK OK p4 312 519 u0 3 DISK OK e p5 e ITZ 51D u0 v0 Volume 10 u0 v1 Volume F 1107 56 Example of RAID 0 unit created with volume sizes set to 2000 500 1024 and 700 GB The example below combines auto carving and vol a b c d Notice that the last volume u0 v5 is odd sized 247 188 GB Volumes 0 through 3 are carved using the first four sizes as specified Volumes 4 5 and 6 are the auto carved volumes 1024 GB each Volume 6 is the remainder of the car
36. operating system Understanding RAID Levels and Concepts 3ware RAID controllers use RAID Redundant Array of Independent Disks to increase your storage system s performance and provide fault tolerance protection against data loss This section organizes information about RAID concepts and configuration levels into the following topics RAID Concepts on page 8 Available RAID Configurations on page 9 Determining What RAID Level to Use on page 15 RAID Concepts The following concepts are important to understand when working with a RAID controller Arrays and Units In the storage industry the term array is used to describe two or more disk drives that appear to the operating system as a single unit When working with a 3ware RAID controller unit is the term used to refer to an array of disks that is configured and managed through the 3ware software Single disk units can also be configured in the 3ware software Mirroring Mirrored arrays RAID 1 write data to paired drives simultaneously If one drive fails the data is preserved on the paired drive Mirroring provides data protection through redundancy In addition mirroring using a 3ware RAID controller provides improved performance because 3ware s TwinStor technology reads from both drives simultaneously 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Understanding RAID Levels and Concepts e Striping Striping across disk
37. or 24 Each port can be attached to a single disk drive On a controller such as the 9650SE with a multilane serial port connector one connector supports four ports On 9750 and 9690SA series controllers connections are made with phys and vports virtual port Phy Phys are transceivers that transmit and receive the serial data stream that flows between the controller and the drives 3ware 9750 and 9690SA controllers have 8 phys These controller phys are associated with virtual ports vports by 3ware software to establish up to 128 potential connections with SAS or SATA hard drives Each controller phy can be connected directly to a single drive or can be connected through an expander to additional drives VPort Connections from 3ware 9750 and 9690SA controllers to SAS or SATA drives are referred to as virtual ports or VPorts A VPort indicates the ID of a drive whether it is directly connected to the controller or cascaded through one or more expanders The VPort in essence is a handle in the software to uniquely identify a drive The VPort ID or port ID allows a drive to be consistently identified used in a RAID unit and managed For dual ported drives although there are two connections to a drive the drive is still identified with one VPort handle document in reference to a drive or disk Therefore unless otherwise specified the mention of port implies VPort as well For example when port is used to indicate a
38. required unless you first power down the system to Note If you are adding new drives add them physically before issuing the rescan prevent system hangs and electrical damage Example localhost gt cl rescan Rescanning controller cl for units and drives Done Found following unit s c1 u3 Found following drive s cl p7 c1 p8 62 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 cx commit cx flush Controller Object Commands This command only applies to the Windows operating system It commits all changes if a faster shutdown method is needed when running certain database applications Linux and FreeBSD file systems do not require this command since they have their own ways of notifying the controller to do clean up for shut down This command forces the controller to write all cached data to disk for the specified controller cx update fw fi ename_with_path force This command is only for 9750 and 9000 series controllers This command allows the downloading of the specified firmware image to the corresponding controller Note Before issuing this command you must have already obtained the firmware image and placed it on your system You can obtain the firmware image from the LSI website http www lsi com channel ChannelDownloads Important Before you update the firmware on your controller please follow these recommendations 1 Back up your data Updating the firmware can render
39. roll back if necessary 3 Close all applications Examining compatibility data from firmware image and cO Done New Firmware Current Firmware Current Driver Current API FE9X 3 05 00 005 FE9X 3 05 00 005 2 26 04 007 2 01 00 008 Current firmware version is the same as the new firmware Recommendation No need to update Given the above recommendation Do you want to continue Y N N y Downloading the firmware from file tmp prom0006 img Done The new image will take effect after reboot force attribute is optional If you include it the compatibility checks are bypassed cx add rebuild ddda hh duration This command adds a new task slot to the Rebuild Task Schedule on the day ddd where ddd is Sun Mon Tue Wed Thu Fri and Sat at the hour hh range 0 23 for a duration of duration range 1 24 hours A maximum of seven rebuild task slots can be included in the schedule This command will fail if no empty task slot is available Example localhost gt cl add rebuild Sun 16 3 Adding scheduled rebuild to slot 7 for Sun 4 00PM 3hr s Done In this example a rebuild task slot is added to the schedule so that rebuilds can be executed on Sundays at 16 hours 4 00 PM for a duration of 3 hours 64 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands Setting Up a Rebuild Schedule Setting up a rebuild schedule requires several steps and several diffe
40. scheduled to be executed on Sundays at 16 hours 4 00 PM Setting Up a Selftest Schedule Setting up a selftest schedule requires several steps and several different CLI commands in addition to ex add selftest To set up the selftest schedule you want to use follow this process 1 Use the ex show selftest command to display the current schedule for selftest tasks For details see page 64 2 If any of the scheduled tasks do not match your desired schedule use the ex del selftest command to remove them For details see page 68 3 Use the ex add selftest command to create the selftest schedule slots you want described above 4 Use the ex set selftest enable command to enable the schedule this enables all selftest schedule slots For details see page 74 c x del rebuild s ot d This command removes the rebuild background task slot s ot_id from the Rebuild Task Schedule Example localhost gt cl del rebuild 2 removes the rebuild background task in slot 2 www si com channel products 67 Chapter 2 CLI Syntax Reference Warning If all time slots are removed be sure to also disable the schedule AN Otherwise rebuilds will never occur c x del verify s ot_id This command removes the verify background task slot slot_id from the Verify Task Schedule Example localhost gt cl del verify 3 removes verify background task in slot 3 Warning If all time slots are removed be sure to also d
41. separate line Syntax tw_cli f lt filename gt Where lt filename gt is the name of the text file you want to execute Example tw_cli f clicommand txt 6 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Working with 3ware CLI This example executes the file clicommand txt and runs the CLI commands included in that file Scripting examples Following is a scripting example for a 4 port controller using a text file called config_unit txt containing three commands This example sets up a 4 port controller with two units each with 2 drives mirrored It then prints the configurations for verification The commands included in the script file are c0 add type raidl disk 0 1 cO add type raidl disk 2 3 c0 show Following is a scripting example for a 12 port controller using a text file called config_unit txt containing three commands This example sets up a 12 port controller with two units one with the first 2 drives mirrored and another with the remaining drives in a RAID 5 array It then prints the configurations for verification The commands included in the script file are cO add type raidl disk 0 1 c0 add type raid5 disk 2 11 c0 show To run either of the scripts enter tw_cli f config_unit txt Outputting the CLI to a Text File You can have the output of the 3ware CLI including errors sent to a text file by adding 2 gt amp 1 to the end of the line This could be useful for example if
42. series SX SE SA controllers except for type ext which applies only to SE SA models and 9750 models This command allows you to request drive statistics of the specified type for the specified port These statistics can be helpful when troubleshooting performance problems type specifies which statistics should be displayed The options are inst for Instantaneous ra for Running Average ct for Long Command Times histdata for Histogram Data and ext for Extended Drive Statistics inst Instantaneous This measurement provides a short duration average 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Port Object Commands ra Running Average Running average is a measure of long term averages that smooth out the data and results in older results fading from the average over time ext Extended Drive Statistics The extended drive statistics refers to statistics of a drive s read commands write commands write commands with FUA Force Unit Access flush commands and a drive sectors s read write and write commands with FUA Ict Long Command Times This a collection of the commands with the longest read write response time histdata Histogram Data The histogram categorizes the read write execution times and group them together based on time frames Summaries of the statistics for all drives on a controller are also available for the inst ra and ext statistics by using the command cx show dpmstat typ
43. set rebuildmode 70 Set the verify task rate cx set verifyrate 74 Set the verify task mode cx set verifymode 73 Set the basic verify start time and cx set verify basic pref ddd hh 72 day Enable disable the selftest cx set selftest 74 schedule View controller alarms cx show alarms 46 cx show events cx show AENs Unit Maintenance Tasks Start a rebuild cx ux start rebuild 88 Start a verify cx ux start verify 88 Pause resume rebuild cx ux pause rebuild and cx ux 90 resume rebuild Stop verify cx ux stop verify 90 Enable disable autoverify cx ux set autoverify 90 Identify all drives that make up a cx ux set identify 64 unit by blinking associated LEDs Port Tasks Locate drive by blinking an LED cx px set identify 113 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Common Tasks Mapped to CLI Commands Table 5 Common Tasks Mapped to CLI Commands Task CLI Command Page Check if LED is set to on or off cx px show identify 106 View information for specific drive cx px show 104 View the status of specific drive cx px show status 107 Show statistics for the drive ona cx px show dpmstat 110 particular port type inst ra lct histdata ext Clear statistics counters for a cx px set dpmstat clear 114 particular drive type ra ct ext PHY Tasks View details about link speed fora cx phyx show 115 specified phy Set the link spe
44. show rdcache This command shows the current read cache state of the specified unit The state of the read cache can be either Basic Intelligent or Off This feature is supported on 9650SE and later controllers This feature is supported with all RAID array types For more information see cx ux set rdcache basiclintelligentloff on page 92 Example localhost gt c0 u0 show rdcache c0 u0 Read Cache Intelligent cx ux show identify This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This feature requires a supported enclosure This command is related to the cx ux set identify onloff command It shows the identify status of the specified unit either on or off Example localhost gt c0 u0 show identify c0 u0 Identify status on cx ux show ignoreECC This feature only applies to 9000 series controllers This command shows the current setting of the ignoreECC policy for the specified unit Example localhost gt c0 u0 show ignoreECC c0 u0 Ignore ECC policy off cx ux show initializestatus This command reports the initializestatus if any of the specified unit Example localhost gt c0 u5 show initializestatus cO u5 is not initializing its current state is OK cx ux show name This feature only applies to 9000 series controllers This command reports the name if any of the specified unit Example localhost gt c0 u5 show name c
45. status can be either on or off If identify is on the LED associated with the power supply will blink If the enclosure does not support Power Supply Identify this command will return N A Example localhost gt c0 e0 pwrsl show identify c0 e0 pwrs1 Identify status on 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Enclosure Object and Element Commands cx ex pwrsx set identify onloff This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex If the enclosure supports Power Supply Identify this command causes the LED associated with the power supply to blink or turns off identification of the LED for this power supply Example localhost gt c0 e0 pwrsl set identify on Sending Identify request to Power Supply c0 e0 pwrs1 to on Done cx ex itempx show This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the information about the specified temperature sensor element tempx in the specified enclosure cx ex The possible status values are OK OVER WARNING OVER FAIL UNDER WARNING UNDER FAIL where OVER denotes over temperature and UNDER denotes under temperature For more information about these statuses see Temp Sensor Status on page 194 in the 3ware SATA SAS RAID Controller Card Software User Guide V
46. the default grouping is 5 and for 12 disks the disks can be grouped into groups of 3 4 or 6 drives the group of 4 drives is set by default as it provides the best of net capacity and performance For 15 disks the disks can be grouped into groups of 5 drives 3 drive groups would make 5 subunits you can have a maximum of 4 subunits For 16 disks the disks can be grouped into groups of 4 or 8 drives Note that RAID 10 always has group 2 so an attribute specifying it s group is not necessary stripe size consists of the stripe size to be used The following table illustrates the supported and applicable stripes on the respective unit types and controller models Stripe size units are in KB kilobytes Table 14 Supported Stripe Sizes Model RO R1 R5 R6 R10 Spare R50 Single 718000 164 NA 64 Ina e4 Ina na N A 128 128 256 256 512 512 1024 1024 900 16 NA ie wa lie wa lie NA 64 64 NA 64 64 256 256 N A 256 256 9750 16 NA 16 16 NA 16 NA 9690SA nd 64 64 les 64 64 9650SE 256 256 256 256 256 a Models 9500S 9550SX and 9590SE noscan attribute instructs CLI not to notify the operating system of the creation of the new unit By default CLI will inform the operating system One application of this feature is to prevent the operating system from creating block special devices such as dev sdb and dev sdc as some implementations might create nam
47. the device driver and or management tools incompatible 2 Make sure you have a copy of the current firmware image so that you can roll back to it if required 3 Close all applications before beginning the update of the firmware fw filename_with_path attribute allows you to specify the firmware image file name along with its absolute path Note filename_with_path must not have spaces in the directory names of its path as Windows allows The new image specified by this filename _with_path is checked for compatibility with the current controller current driver and current application versions A recommendation is then made as to whether an update is needed and you are asked to confirm whether you want to continue If you confirm that you want to continue the new firmware image is downloaded to the specified controller A reboot is required for the new firmware image to take effect www si com channel products 63 Chapter 2 CLI Syntax Reference for the 9650SE prom0008 img is for the 9690SA and prom0011 img is for the Note The prom image number will vary for different controllers Prom0006 img is El 9750 Example localhost gt c0 update fw tmp prom0006 img Warning Updating the firmware can render the device driver and or management tools incompatible Before you update the firmware it is recommended that you 1 Back up your data 2 Make sure you have a copy of the current firmware image so that you can
48. the speed level of the specified enclosure fan The speed level is a number in the range of lt 0 7 gt where www si com channel products 129 Chapter 2 CLI Syntax Reference 0 Off 1 Lowest 2 Low 3 Medium low 4 Medium 5 Medium high 6 High 7 Highest Example localhost gt c0 e0 fanl set speed 1 Setting Fan Speed on c0 e0 fanl to 1 Done cx ex pwrs x show This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the information about the specified power supply element pwrsx in the specified enclosure ex ex The power supply name is followed by its status The possible status values are OK FAIL NOT INSTALLED and OFF The possible values for voltage are OK OVER VOLTAGE and UNDER VOLTAGE The possible values for current are OK OVER CURRENT In either case OVER means over the set threshold of the voltage or current If a power supply is on and no fault has been detected the status would indicate OK Example localhost gt c0 e0 pwrs0 show PowerSupply Status State Voltage Current Identify pwrs0 OK on OK OK off cx ex pwrsx show identify 130 This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the identify status of the specified power supply element The
49. unit would become a mirrored array technically this is not a migration As a result this command shows a different status than other migration paths In addition the status of the newly specified disk will show DEGRADED until the migration rebuild is complete www si com channel products 101 Chapter 2 CLI Syntax Reference 102 For example below is a system with two migrating units cO u0 and c0 u1 u0 is migrating from a RAID 10 to a RAID 0 array while ul is migrating from Single to a RAID 1 initiated by the following commands c0 u0 migrate type raid0 c0 ul migrate type raidl disk 5 Note the difference in UnitType and Status of u0 and ul even though they are both migrating units 3ware CLI gt c0 show Size GB Cache Unit UnitType Status SRCmpl V I M Stripe AVrfy ud Migrator MIGRATING 26 ul RAID 1 REBUILD PAUSED 0 298 002 RiW OFF 3 12 91 9 OFF OFF Serial Port Status Unit Size po OK u0 149 05 GB p1 OK u0 149 05 GB p2 OK u0 372 61 GB p3 OK ud 372 61 GB p4 OK ul 372 61 GB p5 DEGRADED ul 372 61 GB p6 NOT PRESENT S p7 NOT PRESENT 3ware CLI gt c0 u3 show Unit UnitType Status RCmpl u0 Migrator MIGRATING sud RAID 10 OK su0 0 RAID 1 OK su0 0 0 DIS OK su0 0 1 DIS OK su0 1 RAID 1 OK su0 1 0 DIS OK su0 1 1 DIS OK su0 v0 Volume Es dud RAID 0 OK du0 0 DISK OK du0 1 DISK OK du0 2 DISK OK du0 3 DISK OK du0 v0 Volume 3ware CLI gt
50. use the ex px command See the section Port Object Commands on page 104 for more information www si com channel products 137 Chapter 2 CLI Syntax Reference help c x bbu This command provides specific ex bbu related help illustrating various ways to use the ex bbu command See the section BBU Object Commands on page 116 for more information help cxex This command provides specific enclosure cx ex related help illustrating various commands associated with the enclosure cx ex See the section Enclosure Object and Element Commands on page 122 for more information help c x ex slotx This command provides specific slot cx ex slotx related help illustrating various ways to use cx ex slotx See the section Enclosure Object and Element Commands on page 122 for more information help c x ex fanx This command provides specific fan cx ex fanx related help illustrating various ways to use the cx ex fanx command See the section Enclosure Object and Element Commands on page 122 for more information help cx exfttempx This command provides specific temperature sensor cx ex tempx related help illustrating various ways to use the cx ex tempx command See the section Enclosure Object and Element Commands on page 122 for more information help c x ex pwrsx This command provides specific power supply cx ex pwrsx related help illustrating various ways to use the cx ex pwrsx command
51. with your 3ware RAID controller for instructions This guide is available in PDF format on your 3ware CD or can be downloaded from the LSI website at http www 1s1 com channel ChannelDownloads Table 1 Sections in this CLI Guide Chapter Description 1 Introduction to 3ware Installation features concepts Command Line Interface 2 CLI Syntax Reference Describes individual commands using the primary syntax There are often multiple ways to accomplish the same configuration and maintenance tasks for your 3ware controller While this manual includes instructions for performing tasks using the command line interface you can also use the following applications e 3ware BIOS Manager 3DM 2 3ware Disk Manager For details see the user guide or the 3ware HTML Bookshelf viii www si com channel products Introduction to the 3ware Command Line Interface E A The 3ware SATA SAS Controller Card Command Line Interface CLI manages multiple 9750 9690SA and 9650SE 3ware RAID controllers Note Older 3ware RAID controllers also share the vast majority of CLI commands Wherever possible commands are labeled to indicate when they are supported for only a subset of controllers For example commands that apply only to 3ware 9000 series controllers are labeled as such and are not supported for 3ware 7000 8000 controllers Within the 9000 series some commands apply to only to models 9750 9690SA and 9650SE some ap
52. you want to email the output to LSI Technical Support Examples tw_cli c2 p0 show gt gt controller2port0info txt 2 gt amp 1 or tw_cli c0 show diag gt gt Logfile txt 2 gt amp 1 Conventions The following conventions are used through this guide e In text monospace font is used for code and for things you type In descriptions and explanations of commands a bold font indicates the name of commands and parameters for example c0 p0 show all e Incommands an italic font indicates items that are variable but that you must specify such as a controller ID or a unit ID for example c0 p0 show attribute and cx px show all www si com channel products 7 Chapter 1 Introduction to the 3ware Command Line Interface In commands brackets around an item indicates that it is optional In commands ellipses indicate that more than one parameter at a time can be included for example c0 p0 show attribute attribute or that there is a range between two values from which you can pick a value for example cx set carvesize 1024 2048 In commands a vertical bar I indicates an or situation where the user has a choice between more than one attribute but only one can be specified Example In the command to rescan all ports and reconstitute all units the syntax appears as ex rescan noscan The brackets indicate that you may omit the noscan parameter so that the operation will be reported to the
53. 0 11 12 13 14 15 16 gt group 13 16 9750 9690SA name string 9000 series ignoreECC autoverify noqpolicy v0 n vol a b c d n a b c d size of volume in GB 9000 series storsave lt protect balance perform gt 9KSX SE SA rapidrecovery all rebuild disable 9KSE SA only RaidType raid0O raidl raid5 raidl0 raid50 single spare raid6 9750 9690SA and 9650SE add rebuild ddd hh duration 9000 series add verify ddd hh duration 9000 series add selftest ddd hh 9000 series del rebuild slot_id 9000 series del verify slot_id 9000 series del selftest slot_id 9000 series set ondegrade cacheoff follow 9500S only set spinup nn 9000 series set stagger nn 9000 series set autocarve on off 9000 series set carvesize 1024 32768 9KSX SE SA only set rebuild enable disable lt 1 5 gt enable disable for 9000 series set rebuildmode lt adaptive lowlatency gt 9KSE SA only set rebuildrate lt 1 5 gt 9KSE SA only 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Help Commands cx set verify enable disable lt 1 5 gt enable disable for 9000 series cx set verifymode lt adaptive lowlatency gt 9KSE SA only cx set verifyrate lt 1 5 gt 9KSE SA only cx set selftest enable disable task UDMA SMART 9000 series cx set autorebuild on off 9KSX SE SA only cx set autodetect on off disk lt p p gt lall 9000 series cx
54. 0 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 82 00 74 13 01 7B 03 00 01 00 02 3C 06 00 00 00 00 00 00 00 00 00 00 00 01 04 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 108 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 cx px show status Port Object Commands This command displays the status of the drive attached to the specified port Definitions of the drive statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt c0 p5 show status c0 p5 Status OK Note This command only returns the status pertaining to the drive of the specified port Its intended use is not for determining the status of a drive relative to a unit for that please use cx px show on page 104 For example if a unit is DEGRADED and a drive is the degradation point of that
55. 0 2 DISK O p3 149 10 u0 1 RAID 5 O 64K u0 1 0 DISK O p4 gt 149 10 u0 1 1 DISK O gt pos 149 10 u0 1 2 DISK O p6 149 10 localhost gt c0 ul show Unit UnitType Status SRCmpl V I M Port Stripe Size GB ul RAID 0 OK 64K 3576 06 ul 0 DISK OK po a 298 01 ul 1 DISK OK p1 T 298 01 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands ul 2 DIS O p2 E 298 0 ul 3 DIS O p3 298 0 ul 4 DIS O p4 298 0 ul 5 DIS O a p5 298 0 ul 6 DIS O p6 y 298 0 ul 7 DIS O t 5 p7 298 0 ul 8 DIS O gt p8 298 0 ul 9 DIS O a p9 298 0 ul1 10 DIS O p10 298 0 wil Ta DIS O p11 298 0 ul vo Volume 5 2047 00 ul v1 Volume 3 5 1529 06 One application of the ex ux show command is to see which sub unit of a degraded unit has caused the unit to degrade and which disk within that sub unit is the source of degradation Another application is to see the source and destination units during a migration The unit information shows the percentage completion of the processes associated with the unit with RCompl percent Rebuild completion and ViM M percent Verifying Initializing or Migrating Unlike other unit types RAID 6 may potentially have 2 or more parity drives and can tolerate two or more failures within a unit As a result an added notation is used to describe RCompl and V I M and these are A and P
56. 0 u5 name Joe www si com channel products 83 Chapter 2 CLI Syntax Reference cx ux show qpolicy This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command reports the queue policy of the firmware for SATA drives Qpolicy is not applicable to SAS drives If the queue policy is on the firmware utilizes the drive s queueing policy If any drives do not support a queueing policy this policy will have no effect on those drives For a spare unit drive queuing is not meaningful or applicable When a spare becomes part of a true unit during a rebuild it will adopt the queue policy of the new parent unit Thus this command does not show the queue policy for the spare unit type Note that currently only NCQ will be enabled not tag queueing Note that queuing information is not available for SAS drives Example localhost gt c0 u5 show qpolicy c0 u5 Command Queuing Policy on cx ux show rapidrecovery This command only applies to 9750 model controllers and 9000 series controllers models SE and SA and only for redundant units Firmware 9 5 1 or later is required for 9000 series SE SA models Firmware 10 0 or later is required for 9750 model controllers This command shows the Rapid RAID Recovery policy for the specified unit This policy can be all rebuild or disable For information about the policy settings please see the description about the rapidrecovery a
57. 3 drive RAID 5 arrays are striped together to form the 12 drive RAID 50 array On a 16 port controller you can have a grouping of 4 or 8 drives No more than four RAID 5 subunits are allowed in a RAID 50 unit For example a 24 drive RAID 50 unit may have groups of 12 8 or 6 drives but not groups of 4 or 3 In addition RAID 50 arrays offer a higher degree of fault tolerance than RAID 1 and RAID 5 since the array can sustain multiple drive failures without data loss For example in a twelve drive RAID 50 array up to one drive in each RAID 5 set can fail and the array will continue to function Please note that if two or more drives in a RAID 5 set fail then all of the data will be lost www lsi com channel products 13 Chapter 1 Introduction to the 3ware Command Line Interface Figure 6 RAID 50 Configuration Example RAID 50 480 GB 960GB 480GB for mirror RAID 5 RAID 5 480 GB 480 GB 600GB 120GB for parity 600GB 120GB for parity At 1 parity c1 D1 E1 A A2 B2 2 parity D2 E2 il f E xA4 A3 B3 c3 3 parity E3 E E E a A4 B4 CA D4 4 parity a A Blocks B Blocks C Blocks D Blocks E Blocks A Blocks B Blocks C Blocks D Blocks E Blocks Single Disk A single drive can be configured as a unit through 3ware software 3BM 3DM 2 or CLI Like disks in other RAID configurations single dis
58. 55 The Adaptive setting is the default verify mode It allows the firmware to adjust the interaction of verify tasks with host I Os to maximize the speed of 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands both host I O and verify tasks The Low Latency setting minimizes latency delay in reading data from a RAID unit by slowing down the verify task process For some applications such as video server applications and audio applications it is important to minimize the latency of read commands so that users do not perceive a lag when viewing video or listening to audio For a more complete discussion of background task modes see Working with the Background Task Mode in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt cl show verifymode cl Verify background task mode Low Latency Related commands cx set verifymode lt adaptivellowlatency gt cx set verifyrate lt 1 5 gt cx show verifyrate cx show verifyrate This command shows the current verify task rate of the specified controller The verify task rate sets the verify execution priority relative to I O operations This task rate is of the range 1 5 where 5 denotes the setting of fastest background task and slowest I O as follows 5 fastest verify slowest I O 4 faster verify slower I O 3 balanced between verify and I O 2 faster I O slower verify
59. 750 No Yes Yes Yes Yes Yes No No 9690SA and 9650SE a Models 95005 9550SX and 9590SE www si com channel products 59 Chapter 2 CLI Syntax Reference name string attribute allows you to name the new unit This feature is for 9000 series and above controllers The string can be up to 21 characters and cannot contain spaces In order to use reserved characters lt gt V amp etc put double quotes around the name string The name can be changed after the unit has been created For more information see cx ux set name string on page 94 and cx ux show name on page 83 storsave protectlbalancelperform attribute allows user to set the storsave policy of the new unit This feature is only for 9000 series SX SE SA controllers For more information see cx ux set storsave protectlbalancelperform quiet on page 95 rapidrecovery alllrebuildldisable attribute specifies the Rapid RAID Recovery setting for the unit being created Rapid Raid Recovery can speed up the rebuild process and it can speed up initialize and verify tasks that may occur in response to an unclean system shutdown Setting this option to all applies this policy to both these situations Setting it to rebuild applies it only to rebuild tasks If the policy is set to disable then none of the tasks will be sped up changed again Disabling this policy is required if you want to move a unit t
60. 8000 For 9750 9690SA and 9650SE controllers that support basic verify autoverify will be set to ON by default for a new unit For other 9000 series controllers that do not support basic verify autoverify is set to OFF by default for a new unit noqpolicy attribute instructs CLI to disable the qpolicy drive queuing for SATA drives only on the newly created unit The default is for the qpolicy to be on in other words noqpolicy is not specified For a spare unit drive queuing is not meaningful so the noqpolicy cannot be set During unit creation specifying noqpolicy for a spare returns an error If the spare unit becomes a true unit it will adopt the qpolicy of the new unit For more about drive queuing see cx ux show qpolicy on page 84 and cx ux set qpolicy onloff on page 94 ignoreECC attribute enables the ignoreECC OverwriteECC attribute on the unit that is to be created For more details on this feature see cx ux set ignoreECC onloff on page 94 The following table illustrates the supported Model Unit Types This table only applies to setting this feature at unit creation time IgnoreECC only applies to redundant units For the 7 8000 series this setting is only applicable during rebuild it is not applicable during creation Table 8 Supported Model Unit Types for ignoreECC Model R 0 R 1 R 5 R 6 R 10 R 50 Single Spare 7K 8K No No No N A No No No No 90002 No Yes Yes N A Yes Yes No No 9
61. ED INITIALIZING INIT PAUSED REBUILDING REBUILD PAUSED DEGRADED MIGRATING MIGRATE PAUSED RECOVERY INOPERABLE and UNKNOWN RRate also applies to initializing migrating and recovery background tasks Definitions of the unit statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Shell Object Commands Example for 9690SA 414E with enclosure and expander Typical output of the Show command for a system with an enclosure expander and a 9690SA 4I4E controller looks like the following localhost gt show ctl Model V Ports Drives Units NotOpt RRate VRate BBU RRA e a a a e a g Encl Slots Drives Fans TSUnits PSUnits ao 4 a a a a show alarms reverse This command shows the controller alarms or events also known as AEN Asynchronous Event Notification messages of all controllers in the system The default is to display the most recent messages at the bottom The reverse attribute displays the most recent message at the top For more information see cx show alarms reverse on page 46 show events reverse This command is the same as show alarms reverse Please see above for details show AENs reverse Show diag This command is the same as show alarms reverse Please see above for details This command shows the diagnostic information of all controllers in the system The enclosur
62. NCL N A ao 3 0 Auto In the above example for phy1 the link speeds supported are 1 5 and 3 0 Gbps The current link speed for phy1 is 3 0 Gbps and the link control setting is Auto The link control setting could be either 1 5 3 0 or Auto Auto denotes Automatic Negotiation where the best negotiated speed possible for that link will be used Note that if SAS 2 0 is used with a 9750 controller the link speeds can be up to 6 0 Gbps Example of 9690SA 8I with direct attached drives localhost gt c3 show phy Device Link Speed Gbps Phy SAS Addesss Type Device Supported Enabled Limit phy0 500050e000000002 SATA c3 p0 29 30 3 0 Auto phyl 500050e000000002 SATA c3 p1 1 30 340 Auto phy2 500050e000000002 SATA c3 p2 53 50 3 0 Auto phy3 500050e000000002 SATA fe3ip3 5 3 0 3 0 Auto phy4 E 2 360 Auto phy5 z 2973 0 Auto phy6 500050e000000006 SAS c3 p6 30 30 Auto phy7 297330 Auto 48 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx show rebuild 9000 series controllers support background tasks and allow you to schedule a regular time when they occur Rebuild is one of the supported background tasks Migrate and initialize are other background tasks that follow the same schedule as rebuild Other background tasks for which there are separate schedules are verify and selftest For each background task up to 7 time periods can be reg
63. O ON 1 8330 off TempSensor Status Temperature Identify tempo OK 41C 105F off templ OK 38C 100F off temp2 OK 34C 93F off temp3 OK 38C 100F off temp4 OK 38C 100F off temp5 OK 34C 93F off temp6 NOT INSTALLED Off temp7 NOT INSTALLED Off PowerSupply Status State Voltage Current Identify pwrs0 OK on OK OK Off pwrsl OK on OK OK OEE 123 Chapter 2 CLI Syntax Reference Slot Status VPort Identify sloto O c0 p0 off slot1 NO DEVICE off slot2 O c0 p1 off slot3 O c0 p2 off slot4 O c0 p3 off slots O c0 p4 off slot6 O c0 p5 off slot7 O c0 p6 off slots O c0 p7 off slot9 O c0 p8 Off slot10 O c0 p9 off slot11 NO DEVICE off Alarm Status State Audibility alm0 OK OFF UNMUTE Ic x ex show attribute attribute This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the current setting of the given attribute s One or many attributes can be requested An invalid attribute will terminate the loop Possible attributes are controllers slots fans temp pwrs power supply and alms alarms cx ex show controllers This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command is primarily useful for 9650SE controllers where the enclosure number may not already be known This command lists
64. RAID 5 arrays are then integrated into a RAID 0 This attribute allows you to specify the number of disks in the RAID 5 level Valid values are 3 through 16 However no more than 4 RAID 5 subunits are allowed in a RAID 50 unit Note that a sufficient number of disks are required for a given pattern or disk group For example given 6 disks specifying 3 will create two RAID 5 arrays With 12 disks specifying 3 will create four RAID 5 arrays under the RAID 0 level With only 6 disks a grouping of 6 is not allowed as you would basically be creating a RAID 5 The default RAID 50 grouping varies based on number of disks For 6 and 9 disks default grouping is 3 For 8 disks the default grouping is 4 For 10 disks the default grouping is 5 and for 12 disks the disks can be grouped into groups of 3 4 or 6 drives the group of 4 drives is set by default as it provides the best of net capacity and performance For 15 disks the disks can be grouped into 5 drives 3 drive groups would make 5 subunits you can have a maximum of 4 subunits For 16 disks the disks can be grouped into groups of 4 or 8 drives Note that the indicated group number that is supported depends on the number of ports on the controller group 6 is the maximum and it is available on the 9690SA noscan attribute instructs CLI not to notify the operating system of the creation of the new unit By default CLI will inform the operating system One application of this feature
65. S or SATA disks attached to an expander Example localhost gt c0 show spinup c0 Disk Spinup Policy 1 This feature only applies to 9000 series controllers This command reports the time delay between each group of spinups at the power on Spinup does not work with SAS or SATA disks attached to an expander Example localhost gt cO show stagger cO Spinup Stagger Time Policy sec 2 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx show unitstatus E cx show all www si com channel products This command presents a list of units currently managed by the specified controller cx and shows their types capacity status and unit policies Possible statuses include OK VERIFYING VERIFY PAUSED INITIALIZING INIT PAUSED REBUILDING REBUILD PAUSED DEGRADED MIGRATING MIGRATE PAUSED RECOVERY INOPERABLE and UNKNOWN Definitions of the unit statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Note If an asterisk appears next to the status of a unit there is an error on one of the drives in the unit This feature provides a diagnostic capability for potential problem drives The error may not be a repeated error and may be caused by an ECC error SMART failure or a device error Rescanning the controller will clear the drive error status if the condition no longer exists Example localhost gt c2 show unit
66. Supported 3 0 Gb s c0 p5 SATA Link Speed 3 0 Gb s 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Port Object Commands cx px show model cx px show ncq This command displays the model of the drive attached to the specified port Example localhost gt c0 p5 show model c0 p5 Model WDC WD1600BB 00DAAO This command only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command displays the NCQ Native Command Queueing information for the drive attached to the specified port including whether NCQ is supported by the drive and whether it is enabled at the drive For queuing to be used it must be enabled for the unit and supported by the drive Queuing information is not available for SAS drives Example localhost gt c0 p5 show ncq c0 p5 NCQ Supported No c0 p5 NCQ Enabled No cx px show serial This command displays the serial number of the drive attached to the specified port Example localhost gt c0 p5 show serial c0 p5 Serial WD WMACK140649 cx px show smart SMART data can only be displayed for SATA drives although it is also tracked for SAS drives This command extracts SMART Self Monitoring Analysis and Reporting data from the specified SATA disk Because the data is extracted live from the disk this command can be used to get the most recent data about the presence or absence of a disk The SMART data is displayed
67. TSTATUS o 2 25 1 Gt aa 45 JOX Showa deci tied oh ate AA e g a ee ee EE 45 cx show alarms reverse 0 c eect tte eee 46 cx show events reverse 2 0c cee eee eee 47 cx show AENS reverse 00 c eee teeta 47 Jex SHOW diag eiii a E 47 EX SHOW PNY A Ve ew ieee 47 lt eShOWsreDuUIld ta ad ala lada 49 cx show rebuildmode 0 eee 51 ex show rebuildrate m ooo simen ido eae a da 51 ex show Selttest iii a Bre a Ee ee 52 ICX SNOW VERY io A Aleck Seale eee eee Soe 53 cx show verifymode 0 eect tte 54 cx show verifyrate 2 6 eee eens 55 cx add type lt RaidType gt disk lt p p gt stripe size noscan group lt 3 4 5 6 7 8 9 10 11 12 13 14 15 16 gt nocache nowrcache nordcache rdcachebasic autoverify noqpolicy ignoreECC name string storsave lt protect balance perform gt rapidrecovery all rebuild disable vOsn volSa b Cid ici a eed anit shee Bade 56 exrescan noscan 2 pa aa ee eee eee 62 IOXCOMMILS peste IN 63 O Sse hie Ne 63 cx update fw filename_with_path force 0 cece eee 63 cx add rebuild ddd hh duration 0 0 tees 64 cx add verify ddd hh duration 0 0 c cee 65 lex add selftest dddthh nera teei sunina maa A AA LEa A TA AA a E 67 cx del rebuild slot_id 0 0 0 0 tees 67 ex delverity Sl0l id tess ohn as Vea eben ene eid aaa ode adds 68 lex del selftest slot_id o nres derrer er er o tne 68 cx set dp
68. X Cx Ccx ox Cx 32 name string 9000 series vO n vol a b c d n size of first volume in GB rapidrecovery all rebuild disable 9000 series SE SA storsave lt protect balance perform gt 9000 series SX SE SA only add rebuild ddd hh duration 9000 series add verify ddd hh duration 9000 series add selftest ddd hh 9000 series set dpmstat on off 9000 series SX SE SA only del rebuild slot_id 9000 series del verify slot_id 9000 series del selftest slot_id 9000 series set ondegrade cacheoff follow 9500S only set spinup nn 9000 series set stagger nn 9000 series set autocarve on off 9000 series SX SE SA only set carvesize 1024 32768 9000 series SX SE SA only set rebuild enable disable 1 5 9000 series set rebuildmode lt adaptive lowlatency gt 9000 series SE SA only set rebuildrate lt 1 5 gt 9000 series SE SA only set autorebuild on off 9000 series SX SE SA only set autodetect on off disk lt p p gt lall set verify enable disable 1 5 9000 series set verify advanced basic 1 5 9000 series SE SA only set verifymode lt adaptive lowlatency gt 9000 series SE SA only set verifyrate lt 1 5 gt 9000 series SE SA only set verify basic pref ddd hh 9000 series SE SA only set selftest enable disable task UDMA SMART 9000 series flush update fw filename_with_path force 9000 series commit Window
69. aAMe SUING cease ny Oe eke ee a wale he 94 cx ux set qpolicy onloff 6 tees 94 cx ux set rapidrecovery all rebuild disable quiet 95 cx ux set storsave protect balance perform quiet 95 cx ux migrate type RaidType disk p p group 3 4 5 6 7 8 9 10 11 12 13 14 15 16 stripe size noscan nocache lautoverity is 3 seg GaAs AA a es te hee ates dae ate bee ag 97 Port Object Commands 00 cece teens 104 DA A a a ca dog eb Roque toe laud E a S ace ORE A E A E aches 104 cx px show attribute attribute 2 6 ee 105 www si com channel products v ICXIpX show capacity 1 tte eee 105 ex px show driveinfO 0 2 ee tte ee 105 cx px show firmware 0 2 0 cette eee 106 ICXIpx show identify oooooococoocococoo eee 106 cxipx show Ispeed o reiau e iiiar enaa eee eee 106 lX pX SHOW modela so ssp 2 soft a a a o Been eee 107 Iex PX SNOW NCQ ia ge nee Pha ee ee ay ee Mil E 107 cxipx show Serial ieira iaaa an a r E E E teens 107 CXPX SHOW Smart s sweat ae ee eke g aes e ng 107 lex px show status ashe ds a E E R 109 lex pX Showa voca Ei A ed Oe E ee See E E 109 cx px show dpmstat type instlrallct histdatalext o 110 cx px remove noscan quiet 0oooooooorororonrr 113 cx px set identify onloff ooooooooocoocro 113 cx px set dpmstat clear type rallctlext ooooocooocooooooo 114 Phy Object Comma
70. an input file to execute a script 00000 eee 6 Outputting the CLI to a Text File 0 0 eects 7 GONVENTIONS iia A A ia aod 7 Understanding RAID Levels and Concepts o cocccocccccoc o 8 RAID Concepts iio A a a ei 8 Available RAID Configurations oococcccccococo eee 9 Determining What RAID Level to Use 0 eee eee 15 Using Drive Capacity Efficiently 0 0 cece eee 16 Support for Over 2 TerabyteS oooococcccococ tees 17 CLI Syntax Reference 00 cece eee 18 Common Tasks Mapped to CLI Commands 000 0 0 cece eeeeee 18 Terminology hit oA dere ab dane cael Wid erate e pach eh gate ap dedos gatita 22 SYNtAXIOVENVIOW gt Llamada facets Ge aoe a Soe a ETa 23 Shell Object Commands 00 0 ete 24 focus Object oronro a o ie ii 25 COMME m annee kind an il aa he ode ace Rab ala alate Me 25 A ete ek Sie oe eed Ves Gas ee ee E R 26 FOSCAN heh wl ht ta A ede eer EM Vide ad Cadence dln bud ene 26 A ees baghdad detache te wee necked ae tibet dy a 26 show alarms reverse 00 cece eee eee eee 27 show events reverse 00 cee eee eee eee 27 Show AENS reverse sio ete seca aig eed cake a Rp Bo ee ea te ae 27 show diag voi A adan 27 NA A eon Anns wena bed ene a nee pag Asa oR 27 Show selflest iii rl eet ai ee ea eee Sh a Yi ad See ee 28 SNOW VCP aiani tia rd wees do Ek a eR a eens hast ea Eos dy 29 SHOW MOMMY eos at swore Gre ern poe leh Ok yale oD ole
71. apTest bbu On Yes OK OK OK 241 22 Jun 2004 cx show attribute attribute This command shows the current setting of the specified attributes on the specified controller One or many attributes can be specified Specifying an invalid attribute will terminate the loop Possible attributes are achip allunitstatus autocarve 9000 series SX SE SA only autorebuild 9000 series SX SE SA only bios carvesize 9000 series SX SE SA only driver drivestatus firmware memory model monitor numdrives numports numunits ctlbus 9000 series SX SE SA only ondegrade 9500S pcb pchip qpolicy serial spinup 9000 series stagger 9000 series and unitstatus Example To see the driver and firmware installed on controller 0 enter the following localhost gt c0 show driver firmware c0 Driver Version 2 x cO Firmware Version FE9X 3 x In the sample output above x will be replaced with the actual version number www si com channel products 35 Chapter 2 CLI Syntax Reference cx show achip For 9750 and 9690 SA controllers this command displays the SAS SATA IOC i o controller version of the specified controller cx For older controllers this command reports the ACHIP ATA Interface Chip version of the specified controller cx Example localhost gt c0 show achip c0 ACHIP Version 3 x cx show allunitstatus This command presents a count of total and Not Optimal units managed by the spe
72. are Version BBU 2 00 00 023 c1 bbu Serial Number L319003B7460719 c1 bbu BBU Ready Yes c1 bbu BBU Status OK c1 bbu Battery Voltage OK c1 bbu Battery Temperatur OK c1 bbu Estimated Backup Capacity 241 Hours c1 bbu Last Capacity Test 22 Jun 2008 c1 bbu Battery Installation Date 20 Jun 2008 c1 bbu Bootloader Version BBU 0 02 00 002 c1 bbu PCB Revision 65 localhost gt cx bbu test quiet This command starts the battery capacity test The test may take up to 24 hours to complete During the test the BBU is not capable of backup operation and the write cache of all units attached to that controller is disabled Once the test is completed with no error and the BBU status returns to OK the write cache will be re enabled Note Once started the test can not be terminated before it completes Write E cache cannot be enabled until the test completes AEN Asynchronous Event Notification messages are also generated by controllers to notify the user of the command status You can check for AENs with the controller alarms command cx show alarms reverse or with the commands cx show events reverse or ex show AENSs reverse Using the reverse attribute displays the most recent AEN message at the top of the list For a list of all AENs see the user guide that came with your 3ware RAID controller cx bbu enable This command enables BBU detection on the controller If the BBU is Ready the con
73. array For details see Unit Object Commands on page 79 Phy Object Commands Phy object commands provide information and perform actions related to a specific phy on a 9750 or 9690SA controller Port Object Commands Port object commands provide information and perform actions related to a drive on a specific port or vport You can use port object commands for such tasks as seeing the status model or serial number of the drive For details see Port Object Commands on page 104 BBU Object Commands BBU object commands provide information and perform actions related to a Battery Backup Unit on a specific controller For details see BBU Object Commands on page 116 Enclosure Object Commands Enclosure object commands provide information and perform actions related to a particular enclosure For example you can use enclosure object commands to see information about an enclosure and its elements slots fan and temperature sensor elements Help Commands Help commands allow you to display help information for all commands and attributes For details see Help Commands on page 133 Shell Object Commands Syntax 24 Shell object commands are either applicable to all the controllers in the system such as show rescan flush commit or redirect the focused object focus object commit flush rescan show attribute modifier alarms reverse diag rebuild selftest ver verify update fw filename_with_pat
74. ault is auto Example localhost gt c3 phy0 show Device Link Speed Gbps Phy SAS Address Type Device Supported Enabled Control phy0 2007020800153811 SATA c3 p1 Le 535 0 340 ures cx phyx set link auto 1 5 3 0 6 0 E This command is only for 9750 and 9690SA controller models and for 9650SE with Release 9 5 2 or later This command sets the link speed for the specified phy This will control the speed between the controller and the hard drive or enclosure to which it is connected The possible values for SATA are auto 1 5 or 3 0 The possible values for SAS are auto 3 0 or 6 0 Speed is in gigabits per second and the default setting is auto Example localhost gt c0 phy0 set link 1 5 Sending link speed control of cO0 phy0 to 1 5 Gbps Done Note After link speed control is set to a different value it is necessary to reboot the system for the new link speed to take effect www si com channel products 115 Chapter 2 CLI Syntax Reference BBU Object Commands Syntax BBU Battery Backup Unit Object Commands are commands that provide information and perform actions related to a specific BBU installed on a specific controller such as c0 bbu This object is only available on 9750 controllers and 9000 series controllers on which a BBU is actually installed The BBU is not supported on 9590SE 4ME Note Features indicated as 9690SA only 9000 series or 9000 series SE SA o
75. c0 p1 Yes cx ex slotx show identify This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the identify status of the specified slot The status can be either on or off If identify is on the LED associated with the slot will blink If the enclosure does not support Slot Identify this command will return N A Example localhost gt c0 e0 slot1 show identify c0 e0 slot1 Identify status on c x ex slotx set identify on off This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex If the enclosure supports Slot Identify this command identifies the specified slot by blinking the LED associated with it or turns off identification of the LED for this slot Setting identify to on will cause the LED associated with that slot to blink Note This command is equivalent to cx px set identify onloff on page 113 Example localhost gt c0 e0 slotl set identify on Setting Slot Identify c0 e0 slot0 to on Done 128 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Enclosure Object and Element Commands Ic x ex fanx show This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the information about the specified e
76. c0 ul show Unit UnitType Status RCmpl 312581808 312581808 781422768 781422768 781422768 781422768 WD WCANM1 883862 WD WCANM1754124 WD WMAMY1661939 WD WMAMY1579179 WD WMAMY1662720 WD WMAMY 1576310 SV I M Port Stripe Size GB po we pl p2 E p3 p3 p2 E p1 po 64K 298 002 149 001 149 001 149 001 149 001 298 002 64K 596 004 149 001 149 001 149 001 149 001 N A V I M Port Stripe Size GB 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 ul ul 0 ul 1 ul vO www si com channel products RAID 1 DISK DISK Volume REBUILD PAUSED OK DEGRADED Unit Object Commands S725 519 372 S226 372 519 519 519 103 Chapter 2 CLI Syntax Reference Port Object Commands E Syntax c x px show 104 Port Object Messages are commands that provide information and perform actions related to a specific disk attached to a port or virtual port such as c0 p0 You use port object commands for such tasks as seeing the status model or serial number of the drive Note that all references to port also apply to VPort for the commands in this section Note Features indicated as 9690SA only 9000 series or 9000 series SE SA only also apply to 9750 controllers cx px show cx px show attribute attribute where attributes are capacity firmware identify 9000 series SX SE SA only lspeed 9000
77. ce Unit suo is of type RAID 1 and Destination Unit duo is of type RAID 10 3ware CLI gt c0 show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 OK 64K 596 004 RiW OFF u2 SPARE OK 149 042 OFF u3 Migrator MIGRATING 39 149 001 RiW OFF VPort Status Unit Size Blocks Serial p0 O u0 49 05 GB 312581808 WD WCANM1771318 p1 O u0 49 05 GB 312581808 WD WCANM1757592 p2 O u0 49 05 GB 312581808 WD WCANM1782201 p3 O u0 49 05 GB 312581808 WD WCANM1753998 p4 O u2 49 05 GB 312581808 WD WCANM1766952 p5 O u3 49 05 GB 312581808 WD WCANM1 882472 p6 O ud 49 05 GB 312581808 WD WCANM1883862 p7 O u3 49 05 GB 312581808 WD WCANM1778008 p8 Q 49 05 GB 312581808 WD WCANM1770998 p9 NOT PRESENT p10 O u3 49 05 GB 312581808 WD WCANM1869003 p11 O u3 49 05 GB 2581808 WD WCANM1762464 3ware CLI gt c0 u3 show Unit UnitType Status SRCmpl V I M Port Stripe Size GB u3 Migrator MIGRATING 39 su3 RAID 1 O S 49 00 su3 0 DISK O gt ae p5 gt 49 00 su3 1 DISK O J p7 49 00 su3 v0 Volume re a 49 00 du3 RAID 10 O o 16K 298 002 du3 0 RAID 1 O 3 du3 0 0 DISK O pos 49 00 du3 0 1 DISK O p7 5 49 00 du3 1 RAID 1 O a du3 1 0 DISK O p10 49 00 du3 1 1 DISK O pii 49 00 du3 v0 Volume e 49 00 Example of migrate output for Single to RAID 1 The migration path of raidtype Single to RAID 1 is a special case Since the single
78. ched that is it is not in an enclosure The VPort number provides a handle by which to identify the drive even though the drive may not be directly attached to the controller To find the Block and Serial information use the specific show attribute command cx px show capacity or cx px show serial or the show all command attribute attribute This command shows the current setting of the given attributes on the specified port or drive One or many attributes can be requested Specifying an invalid attribute will terminate the loop Possible attributes are capacity firmware identify 9000 series SX SE SA only Ispeed 9000 series SX SE SA only model ncq 9000 series SX SE SA only serial smart SATA only and status cx px show capacity This command displays the capacity of the drive attached to the specified port in two formats GB and blocks Note that of this version the GB format is computed based on division by 1000 not 1024 Example localhost gt c0 p5 show capacity 149 05 GB 312581808 Blocks cx px show driveinfo This command only applies to the 9750 and 9690SA controllers It displays the following information about the drive Drive Type can be either SAS or SATA Interface Type can be either Direct or Expander This indicates how the drive is connected to the controller www si com channel products 105 Chapter 2 CLI Syntax Reference Drive Ports indicates the number of phy
79. cified controller cx For more about the meaning of Not Optimal see Shell Object Commands on page 24 Example localhost gt c0 show allunitstatus c0 Total Optimal Units 2 c0 Not Optimal Units 0 cx show autocarve This feature only applies to 9750 controllers and 9000 series SX SE SA controllers This command reports the Auto Carve policy If the policy is on all newly created or migrated units larger than the carvesize will be automatically carved into multiples of carvesize volumes plus one remainder volume Each volume can be treated as an individual drive with its own file system The default carvesize is 2TB For more information see cx show memory below For operating systems that support units larger than 2TB there is no need to set the policy to on unless you want the operating system to have multiple smaller volumes If you use a 32 bit operating system it is recommended that you keep the policy on unless you know that your operating system supports disks that are larger than 2 TB When the autocarve policy is off all newly created units will consist of one single volume Example localhost gt c0 show autocarve c0 Auto Carving Policy on 36 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx show autorebuild cx show bios This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command show
80. creased capacity e Change the stripe size The unit that results from the migration is subject to the same rules and policies that apply when creating a new unit with the cx add command For example a valid number of disks and parameters must be specified The unit to be migrated must be in a normal state not degraded initializing or rebuilding before starting the migration Note Rapid RAID Recovery is always disabled for units that are migrated The destination unit must use all source disks and potentially augment the number of disks in the disk p p disk list An exception to this is when migrating a RAID 1 to a unit of type single For details see the note below Unspecified parameters are assigned the default values stripe size of 64K write cache enabled autoverify disabled and ignoreECC disabled Both source name and serial number will be carried over to the destination unit Note A special case of this command is when the source unit has a type of RAID and destination unit has a type of single In this case the migrate command splits both drives into two identical single disks If you do this unmount the unit first before splitting The disk name will be duplicated on the destination units but the source unit serial number will not be carried over to the new unit The new destination unit will have its own serial number In this case the disk specifier of the migration command disk p p must not be included in t
81. cro Circuits Corporation LSI All rights reserved 3ware CLI version 2 x Commands Description show Displays information about controller s unit s and port s flush Flush write cache data to units in the system rescan Rescan all empty ports for new unit s and disk s update Update controller firmware from an image file commit Commit dirty DCB to storage on controller s Windows only Fes Controller specific commands cx ux Unit specific commands cx px Port specific commands cx bbu BBU specific commands 9000 only cx ex Enclosure Specific commands 9750 and 9690SA only Certain commands are qualified with constraints of controller type model support Please consult the tw_cli documentation for explanation of the controller qualifiers The controller qualifiers of the Enclosure commands ex also apply to Enclosure Element specific commands e g ex elementx Type help lt command gt to get more details about a particular command For more detail information see tw_cli s documentation This command provides specific show related help illustrating various ways to use the show command It provides reports on Controllers Units and Drives See the section Shell Object Commands on page 24 for more information This command provides specific flush related help illustrating various ways to use the flush command See the section Shell Object Commands on page 24 for more information This com
82. d controller name in the command and use ex This command lists the fans in enclosure cx ex and shows their status The Status column lists the status of each fan The State column indicates if the fan is On or Off Speed is shown by two columns showing the Step level and RPM revolutions per minute There are seven speed levels 0 Off 1 Lowest 2 Low 3 Medium low 4 Medium 5 Medium high 6 High 7 Highest The Identify column lists the Identify setting of the fans www si com channel products 125 Chapter 2 CLI Syntax Reference Example localhost gt c0 e0 show fans Speed Fan Status State Step RPM Identify fan0 OK ON 1 2670 Off fanl OK ON 1 9370 Off fan2 OK ON 1 8540 Off fan3 OK ON 1 2810 Off fan4 OK ON 1 9240 Off fan5 OK ON 1 8330 Off cx ex show temp cx ex show pwrs 126 This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command lists the temperature sensors in enclosure ex ex and the current temperature Note The maximum temperature for successful use of a drive should be noted in the documentation for the drive The TempSensor column lists the temperature sensor IDs the Status column lists the status of each temperature sensor the Temperature column shows the temperature at the sensors and the Identify column lists the Identify setting of the temperature sensors
83. drive it is implied that for the applicable controller series the reference also applies to VPort 3 Note For practical purposes port and VPort are used interchangeably in this For additional information about 3ware controller concepts and terminology see the user guide PDF for your 3ware RAID controller or the user guide portions of the 3ware HTML Bookshelf 22 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Syntax Overview Syntax Overview The command syntax uses the general form Object Command Attributes Objects are shell commands controllers units ports drives BBUs battery backup units and enclosures Commands can either select show get present read attributes or alter add change set write attributes Attributes are either Boolean Attributes or Name Value Attributes e The value of a boolean attribute is deduced by presence or lack of that is the attribute is either specified or not For example the command show alarms by default lists controller alarms with the oldest alarm first If you include the attribute reverse as in the command show alarms reverse alarms are listed in reverse order with the most recent alarm first e The value of name value attributes are expressed in the format attribute value Example When adding creating a unit to the controller with the following command string cl add type raidl disk 0 1 c1 is the object add is the command type for type
84. drive failure in the unit Figure 3 RAID 5 Configuration Example RAID 5 360 GB 480GB 120GB for parity A Blocks B Blocks C Blocks D Blocks RAID 6 RAID 6 provides greater redundancy and fault tolerance than RAID 5 It is similar to RAID 5 but has two blocks of parity information P Q distributed across all the drives of a unit instead of the single block of RAID 5 Due to the two parities a RAID 6 unit can tolerate two hard drives failing simultaneously This also means that a RAID 6 unit may be in two different states at the same time For example one sub unit can be degraded while another may be rebuilding or one sub unit may be initializing while another is verifying The 3ware implementation of RAID 6 requires a minimum of five drives Performance and storage efficiency also increase as the number of drives increase www lsi com channel products 11 Chapter 1 Introduction to the 3ware Command Line Interface Figure 4 RAID 6 Configuration Example RAID 6 360 GB 600GB 240GB for 2 parity drives A Blocks B Blocks C Blocks D Blocks E Blocks RAID 10 RAID 10 is a combination of striped and mirrored arrays for fault tolerance and high performance When drives are configured as a striped mirrored array the disks are configured using both RAID 0 and RAID 1 techniques thus the name RAID 10 see Figure 5 A minimum of four drives are required to
85. e Press Enter to begin installation 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Working with 3ware CLI e Use a GUI If you are using a graphical user interface insert and mount the 3ware CD Under Linux at the 3ware menu click Install Software If the 3ware menu does not appear automatically open a command window and type autorun from the CD directory The installer application will start in graphical mode Step through the pages of the installation wizard On the 3ware Disk Management Tools screen make sure that Command Line Interface tw_cli is selected The default directory location used by 3ware is opt 3ware CLI tw_cli Working with 3ware CLI You can work with the 3ware CLI in different ways e Interactively entering commands at the main prompt e As a series of single commands e By creating a script an input file with multiple commands The next few topics shows examples of these different methods e Using the command interface interactively on page 5 e Using a single command with output on page 6 e Using an input file to execute a script on page 6 e Outputting the CLI to a Text File on page 7 Examples shown in the CLI Syntax Reference chapter reflect the interactive method Using the command interface interactively You can use 3ware CLI interactively entering commands at the main prompt and observing the results on the screen To use the CLI interactively 1 If
86. e cache policy If the policy is set to cacheoff and a unit degrades the firmware will disable the write cache on the degraded unit regardless of what the unit based write cache policy is If the policy is set to follow and a unit degrades firmware will follow whatever cache policy has been set for that unit For details about the unit based policy see cx ux set cache onloff quiet on page 92 cx set spinup nn This command is only for 9750 and 9000 series controllers This command allows you to set a controller based Disk Spinup Policy that specifies how many drives can spin up at one time The value must be a positive integer between 1 and the number of disks ports supported on the controller 4 8 or 12 The default is 1 This policy is used to stagger spinups of disks at boot time in order to spread the power consumption on the power supply For example given a spinup policy of 2 the controller will spin up two disks at a time pause and then spin up another 2 disks The amount of time to pause can be specified with the Spinup Stagger Time Policy cx set stagger nn Not all drives support staggered spinup If you enable staggered spinup and have drives that do not support it the setting will be ignored cx set stagger nn This command is only for 9750 and 9000 series controllers This command allows you to set a controller based Disk Spinup Stagger Time Policy that specifies the delay between spin ups The value mu
87. e diagnostic log may be requested by 3ware Customer Support to help troubleshoot problems on your controller show rebuild This command displays all rebuild schedules for the 9000 series controllers in the system The rebuild rate is also applicable for initializing migrating and recovery background tasks www si com channel products 27 Chapter 2 CLI Syntax Reference Example localhost gt show rebuild Rebuild Schedule for Controller c0 slot Day Hour Duration Status i Sun 12 00am 24 hr s disabled 2 on 12 00am 24 hr s disabled 3 Tue 12 00am 24 hr s disabled 4 Wed 12 00am 24 hr s disabled 5 Thu 12 00am 24 hr s disabled 6 Fri 12 00am 24 hr s disabled 7 Sat 12 00am 24 hr s disabled For additional information about rebuild schedules see cx add rebuild ddd hh duration on page 64 and see the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 show selftest This command displays all selftest schedules for the 9000 series controllers in the system Example localhost gt show selftest Selftest Schedul for Controller c0 slot Day Hour UDMA SMART T Sun 12 00am enabled enabled 2 Mon 12 00am enabled enabled 3 Tue 12 00am enabled enabled 4 Wed 12 00am enabled enabled 5 Thu 12 00am enabled enabled 6 Fri 12 00am enabled enabled 7 Sat 12 00am enabled enabled For addit
88. e inserted the message refers to a disk The example below shows that autodetect has been set to off to initiate staggered spin up during hot swapping where port 3 was empty and ports 5 and 6 had drives inserted www si com channel products 77 Chapter 2 CLI Syntax Reference Example localhost gt gt c0 set autodetect off disk 3 5 6 Setting Auto Detect on c0 to off for port 3 and for disk 5 6 Done If disk all then all of the drives or ports for that controller are specified For a 9750 or 9690SA controller it would spinup all directly attached SAS and SATA drives but not any drives attached to an expander Example localhost gt gt c0 set autodetect off disk all Setting Auto Detect on c2 to off for all disks ports Done Usage Scenario If you are hot plugging a large number of drives at the same time and are concerned that you might overload the power supply you might use this command as follows 1 Issue the command set autodetect off to disable automatic detection of the ports for staggered spin up 2 Ifthe ports are not empty pull the drives out of the specified ports Insert or replace the drives at the ports specified 4 Issue the command set autodetect on to enable auto detect of the ports with the newly inserted drives The preceding steps would spin up the newly inserted drives in a staggered manner Please note that the command takes longer for ports that do not have drives
89. e instlralext on page 38 For more information see Drive Performance Monitoring on page 241 of the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example of running average statistics RA localhost gt c0 p3 show dpmstat type ra Queue Xfer Resp Port Status Unit Depth TOPs Rate MB s Time ms p3 OK u0 0 435 25 249 2 Example of long command times statistics LCT localhost gt c0 p3 show dpmstat type lct Port Status Unit p3 OK u0 Resp Date Time Time ms CDB ATA Task File hex 2007 02 09 13 47 57 383 216 00 80 60 40 92 9f 8a 40 la 00 00 00 00 00 00 00 2007 02 09 13 47 57 390 809 00 80 60 40 13 eb 30 40 26 00 00 00 00 00 00 00 2007 02 09 13 47 57 405 478 00 80 60 40 61 11 20 40 26 00 00 00 00 00 00 00 2007 02 09 13 47 57 410 379 00 80 60 40 cd 8b b9 40 23 00 00 00 00 00 00 00 2007 02 09 13 47 57 419 002 00 80 60 40 5e df dl 40 29 00 00 00 00 00 00 00 2007 02 09 13 47 57 444 250 00 80 60 40 8b c0 36 40 2e 00 00 00 00 00 00 00 2007 02 09 13 47 57 527 994 00 80 60 40 6e a5 b6 40 03 00 00 00 00 00 00 00 2007 02 09 13 47 57 569 429 00 80 60 40 3b e2 02 40 2d 00 00 00 00 00 00 00 2007 02 09 13 47 57 609 526 00 80 60 40 27 1c e9 40 2b 00 00 00 00 00 00 00 2007 02 09 13 47 57 612 051 00 80 60 40 dd Ob dl 40 2c 00 00 00 00 00 00 00 Note that in addition to the time and date stamps of the commands with the long response times their corresponding CDB or ATA Task File is displa
90. e port information is represented by VPort virtual port and Cache indicates both Read Cache and Write cache Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy ud SPARE OK 149 042 OFF ul Single OK 149 051 RiW OFF VPort Status Unit Size Type Phy Encl Slot Model po OK 149 05 GB SATA 3 WDC WD1600JS 22NCB1 pl OK u0 149 05 GB SATA 0 WDC WD1600JS 22NCB1 p2 OK ul 149 05 GB SATA 2 a WDC WD1600JS 22NCB1 p3 OK gt 34 18 GB SAS 6 SEAGATE ST936701SS 34 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands Example output for earlier controllers localhost gt c2 show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 OK ca 64K 596 004 ON OFF ul RAID 0 OK 64K 298 002 ON OFF u2 SPARE OK 149 042 OFF u3 RAID 1 OK 149 001 ON OFF Port Status Unit Size Blocks Serial pO O ud 49 05 GB 312581808 WD WCANM1771318 p1 O u0 49 05 GB 312581808 WD WCANM1757592 p2 O u0 49 05 GB 312581808 WD WCANM1782201 p3 O u0 49 05 GB 312581808 WD WCANM1753998 p4 O u2 49 05 GB 312581808 WD WCANM1766952 p5 O u3 49 05 GB 312581808 WD WCANM1882472 p6 O u0 49 05 GB 312581808 WD WCANM1883862 p7 O u3 49 05 GB 312581808 WD WCANM1778008 p8 O 49 05 GB 312581808 WD WCANM1770998 p9 NOT PRESENT p10 O ul 49 05 GB 312581808 WD WCANM1869003 p11 O ul 49 05 GB 312581808 WD WCANM1 762464 Name OnlineState BBUReady Status Volt Temp Hours LastC
91. e verify basic option allows you to set a basic verify schedule that starts each week at the same date and time With verify basic you can specify your preferred day and time or you can omit the day and time and use the default of Friday at midnight When you set verify basic the series of scheduled days and times associated with the advanced Verify Task Schedule is ignored Verify basic is intended to be used with the auto verify policy for RAID units to insure that a verification of the unit occurs on a regular basis 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands When verify advanced if you start a manual verify it will follow the advanced Note When verify basic if you start a manual verify it will start immediately Verify Task Schedule For more information see cx ux start verify on page 88 Example localhost gt c3 set verify basic pref Fri 23 Setting c3 basic verify preferred start time to Fri 11 00PM Done cx set verifymode lt adaptivellowlatency gt This command is only supported on 9750 9690SA and 9650SE controllers This command sets the verify mode The verify mode has two settings Adaptive and Low Latency Verify mode works in conjunction with the verify task rate see cx set verifyrate lt 1 5 gt on page 74 The Adaptive setting is the default verify mode It allows the firmware to adjust the interaction of verify tasks with host I
92. ebuild Schedule for Controller cl Slot Day Hour Duration Status 1 Mon 2 00pm 10 hr s enabled 2 Thu 7 00pm 18 hr s enabled 3 py 4 5 5 5 Es 3 6 Mon 1 00am 4 hr s enabled y Sun 12 00am 1 hr s enabled tw_cli cl show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 INIT PAUSED 0 64K 521 466 ON OFF Port Status Unit Size Blocks Serial po NOT PRESENT pl OK ud 76 33 GB 160086528 Y2NXL7FE p2 NOT PRESENT p3 OK u0 76 33 GB 160086528 Y2NXLB9E p4 NOT PRESENT E S po OK ud 76 33 GB 160086528 Y2NXQPZE 50 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands p6 NOT PRESENT p7 OK u0 76 33 GB 160086528 Y2NXM4VE p8 OK u0 74 53 GB 156301488 3JV3WTSE p9 OK u0 74 53 GB 156301488 3JV3WRHC p10 OK u0 74 53 GB 156301488 3JV3WOLO p11 OK u0 74 53 GB 156301488 3JV3WOLZ Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu On Yes OK OK OK 0 XX XXX XXXX cx show rebuildmode This command is only supported on 9750 9690SA and 9650SE controllers This command shows the current rebuild mode setting of the specified controller The rebuild mode has two settings Adaptive and Low latency Rebuild mode works in conjunction with the rebuild task rate see cx show rebuildrate on page 51 The Adaptive setting is the default rebuild mode It allows the firmware to adjust the interaction of rebuild tasks with host I
93. ed for a specified cx phyx set link auto 1 5 3 0 6 0 115 phy BBU Tasks Check on charge and condition of cx bbu show status 118 battery Start a test of the battery cx bbu test quiet 120 Enclosure Tasks View information about an cx ex show 123 enclosure and its components Locate a drive slot in an enclosure cx ex slotx set identify 128 by blinking an LED Locate a fan in an enclosure by cx ex fanx set identify 129 blinking an LED Set the speed for a fan in an cx ex fanx set speed 129 enclosure Locate a power supply in an cx ex pwrsx set identify 131 enclosure by blinking an LED Locate a temperature sensor in an cx ex tempx set identify 132 enclosure by blinking an LED Turn off or mute an audible alarm cx ex almx set alarm 132 in an enclosure 21 www si com channel products Chapter 2 CLI Syntax Reference Terminology 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 uses the following terminology Logical Units Usually shortened to units These are block devices presented to the operating system A logical unit can be a one tier two tier or three tier arrangement Spare and Single logical units are examples of one tier units RAID 1 and RAID 5 are examples of two tier units and as such will have sub units RAID 10 and RAID 50 are examples of three tier units and as such will have sub sub units Port 3ware controller models up to the 9650SE series have one or many ports typically 4 8 12 16
94. ent Commands on page 122 This command allows you to identify a unit within an enclosure by blinking the LEDs associated with the drive slots of the specified unit Example localhost gt c0 u0 set identify on Sending Identify request for unit c0 u0 to on Done www si com channel products 93 Chapter 2 CLI Syntax Reference c x ux set ignoreECC onloff This feature only applies to 9000 series controllers This command allows you to set the ignoreECC policy for a given unit When ignoreECC policy is set to off if a rebuild process encounters bad sectors on the source disk the rebuild will fail When ignoreECC is set to on such errors are ignored and the rebuild will continue When you use ignoreECC a file system check is recommended following the rebuild to insure data integrity By default ignoreECC is off See Table 8 Supported Model Unit Types for ignoreECC on page 59 cx ux set name string E This command allows you to name the unit with an arbitrary name You can use this name in conjunction with the unit serial number to cross reference with the unit The system does not check to ensure uniqueness of names so be careful to assign different names to each unit Note The unit s serial number is automatically assigned when the unit is created and is not changeable c xlux set qpolicy o0n Joff 94 This feature only applies to 9750 model controllers and 9000 series SX SE SA model controll
95. erred to as a manual verify this command starts a background verification process on the specified unit cx ux The following table shows the relationship between the controller model and logical unit type N A Not Applicable refers to cases where the RAID type is not supported on that controller model Table 9 Supported RAID Logical Unit Types for Verification 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands Table 9 Supported RAID Logical Unit Types for Verification Model RO R1 R5 R6 R10 R50 Single Spare 90002 Yes Yes Yes N A Yes Yes Yes Yes 9690SA Yes Yes Yes Yes Yes Yes Yes Yes and 9650SE 9750 Yes Yes Yes Yes Yes Yes Yes Yes a Models 95005 9550SX and 9590SE For 9550SX and earlier controllers and for 9650SE and 9690SA running pre 9 5 1 when you issue this command the specified verify will begin if the verify schedule is disabled otherwise it will pause until the next scheduled verify If after starting a verify you enable the Verify Task Schedule this on demand task will be paused until the next scheduled timeslot For 9750 controllers and for 9650SE and 9690SA controllers running firmware 9 5 1 or later if verify basic the verify will begin immediately If verify advanced the verify will pause until the next scheduled verify For more information see cx set verify advancedibasicl1 5 on page 72 Table 10 Manual Ve
96. ers This command sets the queue policy of the firmware If the queue policy is on the firmware utilizes the drive s queueing policy If any drives do not support a queueing policy this policy will have no effect on those drives For a spare unit drive queuing is not meaningful or applicable When a spare becomes part of a true unit during a rebuild it adopts the queue policy of the new parent unit Thus this command does not set the queue policy for the spare unit type Note Queuing is only applicable for SATA drives By default qpolicy is on Example localhost gt c0 u5 set qpolicy on Setting Command Queuing Policy for unit c0 u5 to on Done 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands cx ux set rapidrecovery all rebuild disable quiet This command only applies to 9750 and 9000 series controllers models SE and SA and only for redundant units Firmware 9 5 1 or later is required on 9000 series SE SA models Firmware 10 0 or later is required on 9750 This command sets the Rapid RAID Recovery policy for the specified unit Rapid Raid Recovery can speed up the rebuild process and it can speed up initialize and verify tasks that may occur in response to an unclean system shutdown Setting this option to all applies this policy to both these situations Setting it to rebuild applies it only to rebuild tasks If the policy is set to disable then none of the tasks will be
97. ersion 10 0 Example localhost gt c0 e0 temp0 show TempSensor Status Temperature Identify temp0 OK 42C 107F Off cx exitempx show identify This command is used with 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex This command shows the identify status of the specified temp sensor The status can be either on or off If identify is on the LED associated with the temp sensor will blink If the enclosure does not support Temperature Sensor Identify this command will return N A Example localhost gt c0 e0 templ show identify c0 e0 templ Identify status on www si com channel products 131 Chapter 2 CLI Syntax Reference cx ex tempx set identify onloff This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex If the enclosure supports Temperature Sensor Identify this command causes the LED associated with the temp sensor to blink or turns off identification of the LED for this temp sensor Example localhost gt c0 e0 templ set identify on Setting Temperature Sensor Identify on c0 e0 templ to on Done Icxtexfalmx show This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows information about the specified enclosure ala
98. ete Thus this setting should be used with care Example localhost gt cl set rebuildmode lowlatency Setting Rebuild background task mode of cl to lowlatency Done Related commands cx show rebuildmode cx set rebuildrate lt 1 5 gt cx show rebuildrate cx set rebuildrate lt 1 5 gt 70 This command sets the rebuild task rate of the specified controller The rebuild task rate sets the rebuild execution priority relative to I O operations This task rate is of the range 1 5 where 5 denotes the setting of fastest background task and slowest I O as follows 5 fastest rebuild slowest I O 4 faster rebuild slower I O 3 balanced between rebuild and I O 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands 2 faster I O slower rebuild 1 fastest I O slowest rebuild This command applies to the 7000 8000 and 9000 models controllers Example localhost gt cl set rebuildrate 2 Setting Rebuild background task rate on cl to 2 faster 1 0 Done Related Commands cx show rebuildmode cx set rebuildmode lt adaptivellowlatency gt cx show rebuildmode cx set verify enableldisable 1 5 Enabling and disabling verify schedules is only for 9000 series controllers This command enables or disables the advanced Verify Task Schedule defined for controller ex and when enabled sets the priority of verification versus VO operations When enabled
99. h force 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Shell Object Commands focus Object commit The focus command is active in interactive mode only and is provided to reduce typing The focus command will set the specified object in focus and change the prompt to reflect this This allows you to enter a command that applies to the focus instead of having to type the entire object name each time For example where normally you might type c0 u0 show If you set the focus to c0 u0 the prompt changes to reflect that and you only have to type show The concept is similar to being in a particular location in a file system and requesting a listing of the current directory object can have the following forms cx ux specifies the fully qualified URI Universal Resource Identifier of an object on controller cx unit ux specifies one level up the parent object specifies the root object specifies the next level of the object c0 bbu specifies a relative path with respect to the current focused hostname Example localhost gt focus c0 u0 localhost c0 u0 gt localhost c0 u0 gt focus localhost c0 gt localhost gt focus u0 localhost c0 u0 gt localhost c0 gt focus localhost gt The focus command is available by default You can disable focus by setting TW_CLL INPUT_STYLE to old See Return Code on page 141 This command sends a commit co
100. he command because the source drives are the destination drives Specifying more drives with the disk option would return an error type RaidType specifies the RAID type of the destination unit Possible unit types include raid0 raid1 raid5 raid6 raid10 raid50 or single For example type raid5 indicates the destination unit is RAID 5 The type single is a special case of the migrate command It splits the source unit RAID 1 or TWINSTOR into multiple Single units Note You can only migrate a unit to a RAID level that has the same or more capacity as the existing one A four drive RAID 5 unit can migrate to a four drive RAID O but a four drive RAID 0 unit cannot migrate to a four drive RAID 5 without adding another drive due to the need for additional storage capacity for parity bits www si com channel products 97 Chapter 2 CLI Syntax Reference 98 The following table illustrates valid migration paths Table 13 Valid Migration Paths Destination Source RO R1 R5 R6 R10 R50 Single Spare RO Yes No Yes Yes Yes Yes No No R1 Yes No Yes Yes Yes Yes Yes No R5 Yes No Yes Yes Yes Yes No No R6 Yes No Yes Yes Yes Yes No No R10 Yes No Yes Yes Yes Yes No No R50 Yes No Yes Yes Yes Yes No No Single Yes Yes Yes Yes Yes Yes No No Spare No No No No No No No No disk p p consists of a list of ports or VPorts disks to be used in addition to the source disks in the construction of the
101. he installer from the 3ware CD Start the 3ware CD and at the 3ware menu click Install Software Step through the pages of the installation wizard and make sure that Command Line Interface tw_cli is selected e Copy the file from the 3ware CD Copy the file tw_cli exe to the directory from which you want to run the program CLI is located on the 3ware CD in the directory packages cli windows copying the file directly be sure to copy the correct version for the Note CLI comes in both 32 bit and 64 bit versions If you are version of the operating system you are using Permissions Required to Run CLI To run CLI you can be logged onto Windows with one of the following sets of permissions e Administrator e User with administrator rights e Domain administrator e Domain user with Domain Admin or Administrator membership Without the correct privileges CLI will prompt and then exit when the application is executed If you are uncertain whether you have the correct permissions contact your network administrator To start CLI do one of the following e Start the 3ware CD and at the 3ware menu click Run CLI e Or open a console window change to the directory where tw_cli is located and at the command prompt enter tw_cli e OR double click the CLI icon in a folder The CLI prompt is displayed in a DOS console window www si com channel products 3 Chapter 1 Introduction to the 3ware Command Line Interface
102. he operating system quiet is used for non interactive mode No confirmation is given and the command is executed immediately This is useful for scripting purposes Example of interactive mode Nocalhost gt c0 u0 remove Removing c0 u0 will take the unit offline Do you want to continue Y N N Note After the unit is removed through the CLI the unit can be physically removed Hot swap bays are required to do this while the system is online Otherwise you must power down the system to prevent system hangs and damage c xlux del noscan quiet A This command allows you to delete a unit Deleting a unit not only removes the specified unit from the controller s list of managed units but also destroys the DCB Disk Configuration Block metadata After deleting a unit ports or disks associated with the unit will be part of the free pool of managed disks Warning This is a destructive command and should be used with care All data on the specified unit will be lost after executing this command noscan is used to not inform the operating system of this change The default 1s to inform the operating system quiet is used for non interactive mode No confirmation is given and the command is executed immediately This is useful for scripting purposes www si com channel products 87 Chapter 2 CLI Syntax Reference Example of interactive mode Nocalhost gt c0 u0 del Deleting c0 u0 will cause the data on the u
103. he will improve write performance greatly but you are at risk of losing data if a power failure occurs when data is still in the cache You may want to obtain a BBU and UPS to safeguard against power loss ex is the controller name for example cO c1 and so forth type RaidType specifies the type of RAID unit to be created Possible unit types include raidO raid1 raid5 raid6 9650SE and higher only raid10 raid50 single and spare Example type raid5 When a new unit is created it is automatically assigned a unique serial number In addition users can assign the unit a name 3 Note The unit s serial number cannot be changed 56 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands The following table shows supported types and controller models Table 6 Supported RAID Types Model RO R1 R5 R6 R10 R50 Single Spare 7K 8K Yes Yes Yes No Yes No No Yes 90002 Yes Yes Yes No Yes Yes Yes Yes 9690SA Yes Yes Yes Yes Yes Yes Yes Yes and 9650SE 9750 Yes Yes Yes Yes Yes Yes Yes Yes a Models 95005 9550SX U and 9590SE disk p p consists of a list of ports disks to be used in the construction of the specified unit type One or more ports can be specified Multiple ports can be specified using a colon or a dash as port index separators A dash indicates a range and can be mixed with colons For example disk 0 1 2 5 9 12 indicates por
104. how alms This command reports a summary of the alarms within the specified enclosure The Alarm column lists the alarm units IDs the Status column lists the status of each alarm the State column indicates if the alarm unit is ON or OFF and the Audibility column indicate whether the alarm is Muted or Unmuted Example localhost gt c0 e0 show alarms Alarm Status State Audibility alm0 OK OFF UNMUTE all This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the current settings of all attributes for enclosure ex ex cx ex slotx show www si com channel products This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows information about the specified slotx on the specified enclosure ex The slot name is followed by its status If a slot has been inserted with a drive and no fault has been detected the status is OK If the slot is empty the status will indicate NO DEVICE The port that is correlated to the slot is indicated in the next column If no device is found in the slot that 127 Chapter 2 CLI Syntax Reference a dash is shown in the Port column The final column shows the Identify setting for the specified slot Example localhost gt c0 e0 slot1 show slot Status Port Identify slot1 OK
105. ilding its current state is OK c0 ul is not verifying its current state is OK c0 ul is not initializing its current state is OK c0 ul Write Cache on c0 ul Read Cache Intelligent c0 ul volume s 2 c0 ul name myarray c0 ul serial number C6CPR7JMF98DA8001DF0 c0 ul Ignore ECC policy on c0 ul Auto Verify Policy on co ul Storsave policy protection c0 ul Command Queuing Policy on c0 ul Rapid RAID Recovery setting all Unit UnitType Status SRCmpl V I M VPort Stripe Size GB u RAID 0 O 64K 3576 06 ul 0 DIS O po 298 0 ul 1 DIS O pl 298 0 wisg DIS O oa p2 K 298 0 ul 3 DIS O p3 298 0 ul 4 DIS O p4 298 0 ul 5 DIS O p5 298 0 ul 6 DIS O p6 gt 298 0 ul 7 DIS O p7 T 298 0 ul 8 DIS O p8 298 0 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands ul 9 DISK OK p9 298 01 u1 10 DISK OK p10 298 01 u1 11 DISK OK E p11 298 01 ul v0 Volume z 2047 00 ul v1 Volume 1529 06 c xlux remove noscan quiet l This command allows you to remove previously called export a unit Removing a unit instructs the firmware to remove the specified unit from its poll of managed units but retains the DCB Disk Configuration Block metadata A removed unit can be moved to a different controller noscan is used to not inform the operating system of this change The default 1s to inform t
106. ing fragmentation and a moving target nocache attribute instructs CLI to disable the write cache on the migrated unit Enabling write cache increases write performance but at the cost of potential data loss in case of sudden power loss unless a BBU or UPS is installed By default the cache is enabled To avoid the possibility of data loss in the event of a sudden power loss it is recommended not to set nocache unless there is a BBU battery backup unit or UPS uninterruptible power supply installed www lsi com channel products 99 Chapter 2 CLI Syntax Reference autoverify attribute enables the autoverify attribute on the unit to be migrated For more details on this feature see cx ux set autoverify onloff on page 90 Migration Process In all cases of migration the background migration process must be completed before the newly sized unit is available for use You can continue using the original unit during this time Once the migration is finished a reboot will be required if you are booted from the unit For secondary storage depending on your operating system you may need to first unmount the unit then use CLI commands to remove and rescan the unit so that the operating system can see the new capacity and then remount the unit For details see cx ux remove noscan quiet on page 87 and cx rescan noscan on page 62 You may also need to resize the file system or add a new partition For i
107. ional information about selftest schedules see cx add selftest ddd hh on page 67 and see the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 28 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 show ver show verify Shell Object Commands This command will show the CLI and API version Example localhost gt show ver CLI Version 2 00 03 0xx API Version 2 01 00 xx In the above example xx stands for the actual version See the Release Notes for details This command displays all verify schedules for the 9000 series controllers in the system The output shown will be either the advanced or the basic verify schedule depending upon which is enabled for each controller Basic verify is supported on 9750 and 9690SA controllers and on 9650SE controllers running 9 5 1 or later Example This example shows two controllers one with an advanced verify schedule and one with a basic verify schedule localhost gt show verify Verify Schedule for Controller c2 Slot Day Hour Duration AdvVerify 1 Sun 12 00am 24 hr s on 2 Mon 12 00am 24 hr s on 3 Wed 4 00pm 24 hr s on 4 Wed 12 00am 24 hr s on 5 Thu 12 00am 24 hr s on 6 Fri 12 00am 24 hr s on 7 Sat 12 00am 24 hr s on c3 basic verify weekly preferred start Saturday 12 00AM For additional information about verify schedules see cx add verif
108. isable the schedule AN Otherwise the verification tasks will never occur c x del selftest s ot id This command removes or unregisters the selftest background task slot slot_id from the Self Test Task Schedule Example localhost gt cl del selftest 3 Will remove selftest background task in slot 3 Warning If all time slots are removed be sure to also disable the schedule AN Otherwise the selftest background task will never occur cx set dpmstat on ofrf This command applies only to 9000 series SX SE SA controllers This command allows you to enable or disable the Drive Performance Monitor DPM By setting dpmstat to on you can enable the gathering of statistics for drives when I O is running These statistics can be helpful when troubleshooting performance problems You can see whether the Performance Monitor is currently running and display a statistics summary by using the command cx show dpmstat type instlralext on page 38 68 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands For a description of each of the statistics that can be gathered and viewed see cx px show dpmstat type instlrallctlhistdatalext on page 110 DPM is disabled by default since there is overhead in maintaining the statistics DPM is also disabled following a reboot or power on Note that turning off DPM does not clear the statistical data that has been recorded To clear the data u
109. istered known as slots 1 through 7 Each task schedule can be managed by a set of commands including add del show and set a task Background task schedules have a slot id start day time duration and status attributes For details about setting up a schedule for background rebuild tasks see Setting Up a Rebuild Schedule on page 65 Rebuild activity attempts to re synchronize all members of redundant units such as RAID 1 RAID 10 RAID 5 RAID 6 and RAID 50 Rebuild can be started manually or automatically if a spare has been defined Scheduled rebuilds will take place during the scheduled time slot if enabled the schedules are enabled For in depth information about rebuild and other background tasks see About Background Tasks in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 The show rebuild command displays the current rebuild background task schedule as illustrated below localhost gt cl show rebuild Rebuild Schedule for Controller cl Slot Day Hour Duration Status 1 Mon 2 00pm 10 hr s disabled 2 Thu 7 00pm 18 hr s disabled 3 ing F disabled 4 disabled 5 disabled 6 Mon 1 00am 4 hr s disabled 7 Sun 12 00am 1 hr s disabled A status of disabled indicates that the task schedule is disabled In this case the controller will not use the defined schedule timeslots If the rebuild command is entered manually rebuilding will start within 10 to 15 minute
110. ks contain 3ware Disk Control Block DCB information and are seen by the OS as available units Single drives are not fault tolerant and therefore not recommended for high availability systems unless additional precautions are taken to prevent system hangs and data loss JBOD A JBOD acronym for Just a Bunch of Disks is an unconfigured disk attached to your 3ware RAID controller Creation of JBOD configuration is not supported in the 3ware 9750 series New single disk units must be created as Single Disk JBOD units are not fault tolerant and therefore not recommended for high availability systems unless additional precautions are taken to prevent system hangs and data loss 14 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Hot Spare Understanding RAID Levels and Concepts A hot spare is a single drive available online so that a redundant unit can be automatically rebuilt in case of drive failure Determining What RAID Level to Use Your choice of which type of RAID unit array to create will depend on your needs You may wish to maximize speed of access total amount of storage or redundant protection of data Each type of RAID unit offers a different blend of these characteristics The following table provides a brief summary of RAID type characteristics Table 2 RAID Configuration Types RAID Type RAID 0 Description Provides performance but no fault tolerance RAID 1 Provide
111. ld 9000 series SX SE SA only bios carvesize 9000 series SX S ctlbus 9000 series SX SE SA only dpmstat type inst ra ext 9000 series SX S E SA river drivestatus firmware memory model monitor NOW NOW NOW NOW NOW NOW NOW NOW NOW NOW NOW h d n Pp s s s show s s s s s s s s s NOW owever type ext is only for SI E SA only chip serial spinup stagger unitstatus E SA only umdrives numports numunits ondegrade 9500S only pcb all where all means attributes and configurations diag alarms reverse events reverse AENS reverse rebuild 9000 rebuildmode 9000 rebuildrate 9000 verify 9000 verifymode 9000 verifyrate 9000 selftest 9000 phy 9750 add type lt RaidType gt RaidType raid0 raidl only raid10 raid50 single spare disk lt p p gt raid5 raid6 965081 series series series series series series series nn nn E SA E SA E SA E SA only only only only and 9690SA only stripe lt Stripe gt noscan nocache nowrcache nordcache rdcachebasic group lt 3 4 5 6 7 8 9 autoverify noqpolicy ignorECC www si com channel products 10 11 12 13 14 15 16 gt E and higher 31 Chapter 2 CLI Syntax Reference CX CX CX Cx Cx Cx Cx Cx Cx Cx Cx Cx Cx VEX Cx FEX LER FEX cx FEX FEX CxX CX Cx JE
112. ldrate cl Rebuild background task rate 4 Faster Rebuild slower I 0 Related commands cx set rebuildmode lt adaptivellowlatency gt cx set rebuildrate lt 1 5 gt cx show rebuildmode cx show selftest 52 9000 series controllers support background tasks and allow you to schedule a regular time when they occur Selftest is one of the supported background tasks Rebuild and verify are other background tasks for which there are separate schedules Migrate and initialize are additional background tasks that follow the same schedule as rebuild For each background task up to 7 time periods can be registered known as slots 1 through 7 Each task schedule can be managed by a set of commands including add del show and set a task Background task schedules have a slot id start day time duration and status attributes For details about setting up a schedule for background selftest tasks see Setting Up a Selftest Schedule on page 67 Selftest activity provides two types of selftests UDMA Ultra Direct Memory Access and SMART Self Monitoring Analysis and Reporting Both self tests are checked once each day by default Note UDMA mode is applicable only for PATA parallel ATA drives on earlier 3ware controllers It is not applicable for SATA or SAS drives UDMA self test entails checking the current ATA bus speed between controller and attached disk which could have been throttled down during previous operations and
113. lence the alarm you may either set the state of the alarm to OFF or you may mute the alarm The default values are UNMUTE and OFF these enclosures using this command to set the alarm to mute will return an error message indicating that the feature is not supported For these enclosures the alarm is not mutable however it can be turned OFF 3 Note Some enclosures support alarms but not the mute unmute function For If you set this command to unmute for an enclosure that does not support mute the command will appear to complete and will not report an error However in this case there is no mute setting to change to unmute Example localhost gt c0 e0 alm0 set alarm unmute Setting alarm audibility setting of c0 e0 alm0 to unmute Done Help Commands The Help commands provides brief on line help You can get overview help by typing Help at the top level prompt This displays a brief definition of commands For an example see the discussion of the command help on page 135 You can also get help with specific commands by entering help before an object name or by typing a question mark at the point in a command where you are uncertain what the attributes are Help with specific commands If you enter the help command at the top level you are considered to be in the Shell Object and the help command will provide help on the Shell commands focus show flush rescan and commit Using the help command
114. llow the schedule For details see page 90 Note If you do not enable autoverify for units or start a verification manually no verifies will run during your verify task schedule even if the verify schedule is enabled with the cx set verify enable command or the cx set verify advanced Warning If all time slots are removed from the verify task schedule be sure to also disable the schedule Otherwise verify tasks will never occur 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx add selftest ddd hh This command adds a new task slot to the Selftest Task Schedule on the day ddd where ddd is Sun Mon Tue Wed Thu Fri and Sat at hour hh range 0 23 Notice that selftest runs to completion and as such no duration is provided A maximum of seven selftest task slots can be included in the schedule This command will fail if no empty task slot is available In order to run at the specified times selftests must be enabled using the command cx set selftest enableldisable task UDMAISMART on page 74 Note Adding self tests to the schedule is different from adding slots to the rebuild and verify schedules Adding a self test directly schedules the test as well as defining a time slot during which the task can occur Example localhost gt cl add selftest Sun 16 Adding scheduled verify to slot 7 for Sun 4 00PM Done In this example a selftest background task is
115. mand provides specific rescan related help illustrating various ways to use the rescan command See the section Shell Object Commands on page 24 for more information 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 help update help commit help focus help cx Help Commands This command provides specific update related help See Shell Object Commands on page 24 for more information This command provides specific commit related help illustrating various ways to use the commit command See the section Shell Object Commands on page 24 for more information This command provides specific focus related help illustrating various ways to use the focus command See the section Shell Object Commands on page 24 for more information This command provides specific controller ex related help illustrating various commands associated with the controller ex See the section Controller Object Commands on page 31 for more information help cx phyx help cx ux help c x px This command provides specific cx phyx related help illustrating various ways to use the cx phyx command See Phy Object Commands on page 115 This command provides specific unit ex ux related help illustrating various commands to use on a unit ex ux See the section Unit Object Commands on page 79 for more information This command provides specific cx px related help illustrating various ways to
116. mmand to all 3ware controllers in the system For more information see cx commit on page 63 www si com channel products 25 Chapter 2 CLI Syntax Reference flush rescan show 26 This command sends a flush command to all 3ware controllers in the system For more information see cx flush on page 63 This command sends a rescan command to all 3ware controllers in the system For more information see cx rescan noscan on page 62 This command shows a general summary of all detected controllers and enclosures The output of this command will vary depending upon your controller model and whether there is an enclosure with an expander attached Note that the device drivers for the appropriate operating system should be loaded for the list to show all controllers The intention is to provide a global view of the environment Example for controller without an enclosure and expander Typical output of the Show command for a controller looks like the following Nocalhost gt show ctl Model Ports Drives Units NotOpt RRate VRate BBU co 9590SE 4ME 4 4 1 0 2 5 The output above indicates that Controller 0 is a 9990SE 4ME model with 4 Ports with 4 Drives detected attached total of 1 Unit with no units in a NotOpt Not Optimal state RRate Rebuild Rate of 2 VRate Verify Rate of 5 BBU of Not Applicable Not Optimal refers to any state except OK and VERIFYING Other states include VERIFY PAUS
117. mstat on Off ices A A A AE E 68 cx set rebuild enable disable 1 5 0 ooo oooooooomoomcororrommooo 69 cx set rebuildmode lt adaptivellowlatency gt 0 cee eee ees 70 cx set rebuildrate lt 1 5 gt 0 0 00 0c ee eee 70 cx set verify enableldisable 1 5 0 ee tee 71 cx set verify advanced basic 1 5 ooooo oooooomorcrrrrrrr 72 cx set verify basic pref ddd hh ooo 72 cx set verifymode lt adaptivellowlatency gt 0 cece ee eee 73 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 cx set verifyrate lt 1 5 gt ri ara a o a eens 74 cx set selftest enable disable task UDMA SMART 00200005 74 cx set ondegrade cacheofflfollow 0 ce eect ee 75 ICX SCUSPINUPSIIA cri a ee 75 CX setstaggersnM iii A A A 75 ex set autocarve onjoff asse sragen as pE eens 75 cx set carvesize 1024 32768 6 eee 76 cx set autorebuild onloff 0 tees 76 cx set autodetect onl off disk lt p palall 2 ee 77 lex start mediascan iii pe ee een e ed e AES 78 ex stop MediasCan cs i secs Se ese ee ee ee A ENE ee Seale GE e 78 Unit Object Commands 0 ete 79 ICXIUX SNOW se uc serch a ean ore AA AS Bae ee 80 cx ux show attribute attribute 2 6 eee 82 ICXIUX show autoverify 0 6 tetas 82 JOXIUX SNOW CALOR otk sek a deeded pad nd a sag renee 82 ICXIUX SHOW wrcaCche 0 cece tee 82 ICXIUX show rdcache 0 eee eee 83 ox ux
118. n LSI 5 3ware SATA SAS RAID Controller Card Command Line Interface Version 10 0 Supports the 9750 and 9000 Series 9750 9690SA and 9650SE PN 45413 00 Rev A November 2009 CLI Guide Document Description Document 45413 00 Rev A November 2009 This document will remain the official reference source for all revisions and releases of this product until rescinded by an update Disclaimer It is the policy of LSI Corporation to improve products as new technology components software and firmware become available LSI reserves the right to make changes to any products herein at any time without notice All features functions and operations described herein may not be marketed by LSI in all parts of the world In some instances photographs and figures are of equipment prototypes Therefore before using this document consult your LSI representative for information that is applicable and current LSI DOES NOT ASSUME ANY RESPONSIBILITY OR LIABILITY FOR THE USE OF ANY PRODUCTS DESCRIBED HEREIN EXCEPT AS EXPRESSLY AGREED TO IN WRITING BY LSI LSI products are not intended for use in life support appliances devices or systems Use of any LSI product in such applications without written consent of the appropriate LSI officer is prohibited License Restriction The purchase or use of an LSI Corporation product does not convey a license under any patent copyright trademark or other intellectual property right of LSI or
119. n Ee 29 update fw filename_with_path force oooooocoocoocoo o 30 Controller Object Commands oocccoccccco 31 CX SNOW pied eet aa Baa eee he ae 33 cx show attribute attribute o on eee 35 EX SHOW ACKID esse eh ote A ee Pat cee dee ee 36 ex show allunitstatus ce seed ork ha ee ak He dew ee ew eae 36 ex show autocalve as ai adi caa dhia KEGA AS E A TE a a eee 36 ex show a toreb lld 2 25 pe ne oS ie og ai E E a i 37 JX SHOW DIOS nnii ne a ee See ie ie i ey a ee ee 37 www si com channel products iii Jex show GARVESIZE iii a ate a A a eee 37 OX SHOW CtDUSs ora eos eat eos eter guetta gona a nop a Aas ee tease nope 38 IGx SNOW CIIVER A ee ee Ee ate Se aaa PAE te 38 cx show dpmstat type inst rajext o ooooccoooccornooooo o 38 cx show drivestatuS 0 0 cette eas 41 LOX SHOW firmware a rt a er da ra cdi 42 TEX show Memory ooo 42 fox show model lt Senmi rc a ee a EE e 42 Jex Show MONITO x2 orita o es a Oe Skee ld E 42 cx show numdrives 43 cx SHOW NUMPOIIS oe nce ic ee ra He AN Faw A eae 43 ox show NUMUNIS ienei tee e a ete eee 43 ex show ondegrade o oocooccooo ee eee eee 43 ex Show PCD aia gether bei Perea een age Meee 44 TEX SHOW PCNIP e eves due ea A A alk cee ale ete die atts 2 44 fox show SEM All 200 Plomo das ol ec et tt oe op a pee E 44 OX SHOW SPINUP a aon EE Sanat purl neg des Mee nay es 44 ICX show Stagger 0 0 eee eee eee 44 fox SHOW UNI
120. n board scheduler where rebuild operations can be scheduled to take place at specified start and stop times The cx ux resume rebuild function is provided to enable 7000 8000 users to achieve similar functionality with use of Linux provided schedulers such as cron 8 or at 1 or user supplied programs cx ux stop verify c x ux flush This command stops a background verification process on the specified unit ex ux Table 9 on page 88 shows the supported matrix as a function of the controller model and logical unit type This command allows you to flush the write cache on the specified unit ux associated with controller ex Note that this command does not apply to spare unit types c x ux set autoverify onloff 90 This feature only applies to 9000 series controllers This command allows you to turn on and off the autoverify operation on a specified unit ex ux 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands By default autoverify is on for 9750 controllers and for 9650SE and 9690SA controllers running firmware 9 5 1 or later and off all earlier controller models For 9750 controllers and 9650SE and 9690SA controllers running firmware 9 5 1 or later auto verify works in conjunction with the basic verify schedule When autoverify is on and the basic verify schedule is used verify basic a verify will automatically run at the basic verify time Friday at midnight by default If the s
121. n of units The advanced Verify Task Schedule provides more control and is equivalent to the Verify Task Schedule available for 9550SX and earlier 9000 RAID controllers For the advanced Verify Task Schedule up to 7 time periods can be registered known as slots 1 through 7 This task schedule can be managed by a set of commands including add del show and set a task The task schedule has a slot id start day time duration and status attributes Rebuilds migrations and initializations follow similar background task schedules For details about setting up a schedule for verify tasks see Setting Up a Verify Schedule on page 66 Verify activity verifies all units based on their unit type Verifying RAID 1 involves checking that both drives contain the same data On RAID 5 and RAID 6 the parity information is used to verify data integrity RAID 10 and 50 are composite types and follow their respective array types On 9000 series non redundant units such as RAID O single and spare are also www si com channel products 53 Chapter 2 CLI Syntax Reference verified by reading and reporting un readable sectors If any parity mismatches are found the array will be automatically background initialized For information about the initialization process see the user guide that came with your 3ware RAID controller Example 1 Advanced Verify Schedule For 9550SX and earlier controllers and when verify advanced for 9750 contr
122. nclosure fan fanx in the specified enclosure cx ex The fan name is followed by its status If a fan is on and no fault has been detected the status will indicate OK Example localhost gt c0 e0 fan0 show Speed Fan Status State Step RPM Identify fan0 OK ON 1 2700 Off cx ex fanx show identify This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command shows the identify status of the specified fan The status can be either on or off If identify is on the LED associated with the fan will blink If the enclosure does not support Fan Identify this command will return N A Example localhost gt c0 e0 fanl show identify c0 e0 fanl Identify status on c x ex fanx set identify 0n Joff This command is used with 9750 and 9690SA controllers For the 96505E simply drop the prepended controller name in the command and use ex If the enclosure supports Fan Identify and there is an LED associated with the fan this command causes the LED associated with the fan to blink or turns off identification of the LED for this fan Example localhost gt c0 e0 fanl set identify on Setting Fan Identify on c0 e0 fanl to on Done cx ex fanx set speed lt 0 7 gt This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command sets
123. nd slot if expander attached and model number of the drive For earlier controller models up to the 9550SX and the 9650SE with Release 9 5 1 or earlier the Port summary section lists all present ports and for each port specifies the port number disk status unit affiliation size in gigabytes and blocks 512 bytes and the serial number assigned by the disk vendor 9 5 2 or later if a drive is not present that port entry is not listed This is different from displays for the 9550SX and older models which showed the port with the status NOT PRESENT with dashes across the columns in the summary table 3 Note For 9750 and 9690SA controllers and for 9650SE controllers with Release Consequently for newer controllers the port numbers in the list may not be sequential Moreover if there are no drives present at all for the specified controller the output of its Port Summary will show an empty summary consisting of only the header The BBU summary lists details about the BBU if one is installed It lists the online state readiness and status of the BBU unit along with the voltage temperature charge capacity expressed as time remaining in hours and the BBU s last test date Additional attributes about controllers units ports and disks can be obtained by querying for them explicitly For details see the other show subcommands Example output for 9750 9690SA and 9650SE with Release 9 5 2 or later Note that th
124. nds ooccccccc ttt 115 LS SS dr a nat Ria Mesa nie 115 cx phyx set link auto 1 5 3 0 6 0 0 2 eee 115 BBU Object Commands 0 0 c eee teen eee 116 JEXIDDUSSNOW seose 2 ies a8 fa Rare AA a og 116 cx bbu show attribute attribute 6 eee 117 ex D Show batinst eii e eee eae Oye he ed we ee eae ee oy 117 cx bbu show bootloader 0 eect eee 117 eX ODU SHOW Caprera ot obs a ca the ae ee SEE E ida 117 eX ODU SNOW TW ioe be see a e NAE A E AE 117 ex bbu show lasttest codi oat Oe es ae ee Pwd ee Hae LAE RS 117 CX DDU SHOW PCD fei cided wel dale de Slade a do tages 118 Icx bbu show serial 2 0 02 eee eee een eee 118 Tex bbu SHOW StatUS 10 tte 118 exibbu show temp sinet scouts eee MS ee a ee hie oe es 119 cx bbu show tempstat 00 eects 119 cx bbu show tempval 0 cette tenes 119 ex bbushow VOITA oia pi ais vee eee hee he Had ee ee a 119 exfobu show alliri ma Peat each ely alc ea aa een 120 ex bbu test quiet enine senne ii de ei tetas Oa yee kv eee bea oes 120 lX bbu enabler mnnn ae A ON em eee Yad ea es 120 cx obu disable quiet 0 0 20 a ee eee 121 Enclosure Object and Element Commands 2000 cece ences 122 TCX OX SNOW gt 2 i css seen a Ss ala ee fava hewn 123 cxlex show attribute attribute 2 ee 124 exfex show controllers 0 00 e eee eee ees 124 ex ex show diag helptext 0 0 eee tte 124 CXE SNOW SIOS e
125. nect it the controller will automatically try to use it again If the policy is off spares are the only candidates for rebuild operations Example localhost gt cO set autorebuild enable Setting Auto Rebuild Policy on c0 to enable Done cx set autodetect onloff disk lt p p gt lal This command is only for 9750 and 9000 series controllers This command is associated with the staggered spin up feature when hot swapping drives When staggered spin up is enabled see command ex set spinup and cx set stagger during a reset or power on the controller will spin up all detected drives with a delay between each spinup allowing the spread of power consumption on the power supply When a drive is hot swapped as opposed to when it has just been powered on or reset the default behavior of the system is to automatically detect and immediately spin up the drives This command can change the default behavior and set the controller to do a staggered spinup for hot swapped drives Note The autodetect setting cannot be shown in CLI or displayed in 3DM 2 or E 3BM This feature may be added in a future release autodetect onloff enables or disables automatic detection of drives on the controller s ports for staggered spin up disk lt p p gt lall specifies one or many disks that is drives ports or vports If a port is empty no drive is inserted the echo message of the command refers to a port If there is already a driv
126. nit to be permanently lost Do you want to continue Y N N cx ux start rebuild disk lt pv p gt ignoreECC This command allows you to rebuild a degraded unit using the specified disk p Rebuild only applies to redundant arrays such as RAID 1 RAID 5 RAID 6 RAID 10 and RAID 50 During rebuild bad sectors on the source disk will cause the rebuild to fail RAID 6 arrays are less susceptible to failing since two copies of the data exist You can allow the operation to continue by using ignoreECC The rebuild process is a background task and will change the state of a unit to REBUILDING Various show commands also show the percent completion as rebuilding progresses Note that the disk used to rebuild a unit specified with disk p must be a SPARE or a unconfigured disk You must first remove the degraded drive s before starting the rebuild Refer to the command cx px remove noscan quiet on page 113 for details Also refer to the command cx rescan noscan on page 62 to add new drives or to retry the original drive If you are rebuilding a RAID 50 RAID 6 or RAID 10 unit multiple drives can be specified if more than one sub array is degraded When you issue this command the specified rebuild will begin if schedules are disabled otherwise it will pause until the next scheduled rebuild A file system check is recommended following rebuild when using the ignoreECC option c xlux start verify 88 Also ref
127. nly also apply to 9750 controllers with the following exceptions The BBU firmware version and bootloader version are not applicable for 9750 cx bbu show 9000 series only cx bbu show attribute attribute where attributes are batinst bootloader cap fw lasttest pcb ready serial status temp tempstat tempval volt cx bbu show all 9000 series only cx bbu test quiet 9000 series only Warning May take up to 24 hours to complete Write cache will be disabled during the test cx bbu enable 9000 series only cx bbu disable quiet 9000 series only cx bbu show E 116 This command presents a summary report on the specified BBU object Example localhost gt c0 bbu show Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu ON No Testing OK OK 72 01 Jul 2004 The command output indicates that the battery capacity was last measured on 01 Jul 2004 The battery is estimated to last for 72 hours from the last tested date In this example the BBU unit is currently testing the battery Both voltage and temperature are normal The BBU is not ready to backup the write cache on the controller due to the testing For complete information about the BBU see the user guide that came with your 3ware RAID controller Note If the BBU is either not present or disabled the following will be displayed after the command localhost gt c0 bbu show Error CLI 053 Battery Backup Unit is not presen
128. ns in the disabled state until the problem is fixed Fault A battery fault is detected The BBU is not capable of backup operation and the write cache is disabled Replace the battery and or the BBU board as soon as possible so that the write cache will be enabled again Error A BBU error is detected The BBU is not capable of backup operation and the write cache is disabled Replace the battery and or the Battery Backup Unit as soon as possible so that the write cache will be enabled again Failed The battery failed a test In this state the BBU is not capable of backup operation and the write cache is disabled We recommend you replace the battery and or the Battery Backup Unit as soon as possible so that the write cache will be enabled again WeakBat The BBU is functioning normally and is online and capable of backing up the write cache However the battery is weak and should be replaced OK The BBU is ready online and capable of backing up the write cache dash A battery is not present or a Battery Backup Unit is not installed 118 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 BBU Object Commands cx bbu show temp This command shows the temperature status of the battery The status can be OK HIGH LOW TOO HIGH and TOO LOW The HIGH and LOW are in warning range TOO HIGH and TOO LOW are out of the operating range and indicate that it may be time to replace the battery Contact LSI to obtain a replaceme
129. nstructions consult the documentation for your operating system Warning It is important that you allow migration to complete before adding drives AN to the unit Making physical changes to the unit during migration may cause the migration process to stop and can jeopardize the safety of your data Example of splitting a mirror localhost gt c1 u3 migrate type single Sending migration message to cl u3 Done In this case the command indicates that u3 should be split into Single units In this case u3 is a RAID 1 and the Migrate command splits u3 into u3 and ux each with a RAID type of Single splitting a mirror If the RAID 1 is the boot device you should boot from a different i Warning Make sure that no I O is pending and that the unit is unmounted before device before splitting the mirror Example of capacity expansion localhost gt c0 u3 migrate type raid10 disk 10 11 stripe 16 Sending migration message to c0 u3 Done In this case the command indicates that the source unit is u3 and the destination unit has a RAID type of raid10 and has added the disks 10 and 11 to the disks in the existing unit u3 100 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands Example of migrate output The following is an example of how migrating units will be displayed In this example the report indicates that c0 u3 is a migrating unit with 39 completion The report also indicate that Sour
130. nt battery This command is equivalent to the command cx bbu show tempstat Example localhost gt c0 bbu show temp c0 bbu Battery Temperature Status OK cx bbu show tempstat This command shows the temperature status of the battery The status can be OK HIGH LOW TOO HIGH and TOO LOW The HIGH and LOW are in warning range TOO HIGH and TOO LOW are out of the operating range and indicate that it may be time to replace the battery Contact LSI to obtain a replacement battery This command is equivalent to the command cx bbu show temp Example localhost gt c0 bbu show tempstat c0 bbu Battery Temperature Status OK cx bbu show tempval This command shows the temperature of the BBU in Celsius Example localhost gt c0 bbu show tempval c0 bbu Battery Temperature Value 24 deg C cx bbu show volt This command shows the voltage status of the battery The status can be OK HIGH LOW TOO HIGH and TOO LOW The HIGH and LOW are in warning range TOO HIGH and TOO LOW are out of the operating range and indicate that it is time to replace the battery Contact LSI to obtain a replacement battery www si com channel products 119 Chapter 2 CLI Syntax Reference cx bbu show all This command shows the current settings of all BBU related attributes ready status batinst lasttest volt temp cap serial fw pcb bootloader Example localhost gt c1 bbu show all c1 bbu Firmw
131. o a Notes Once the rapidrecovery policy has been disabled for a unit it cannot be controller that has firmware earlier than 9 5 1 There is some system overhead from setting rapidrecovery to all If you have a BBU you can set rapid recovery to rebuild as a BBU provides protection against data loss in the event of an unclean shutdown This attribute is only for redundant units created on controller models 9750 and 9690SA controllers and 9650SE controllers with the 9 5 1 firmware or later Rapid RAID Recovery is not supported over migration v0 n or vol a b c d may be used to divide the unit up into multiple volumes vO n can be used if you only want two volumes in which case v0 n is used to define the size of the first volume and the second volume will use the remaining space One way in which this can be useful is if you want to create a special volume to function as a boot volume with a separate volume for data vol a b c d can be used to specify sizes for up to four volumes The value s should be positive integer s in units of gigabytes GB with a maximum of 32 TB If you specify a size that exceeds the size of the unit the volume will be left uncarved 60 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands Both v0 n or vol a b c d work in conjunction with auto carving if that feature is enabled When auto carving is used v0 n and vol a b c d are used to specify the size
132. of Example localhost gt c2 show memory c2 Available Memory 448MB cx show model This command reports the controller model of controller cx Example localhost gt c0 show model c0 Model 9690SA 8E ex show monitor This command reports the monitor firmware boot loader version of controller cx Example localhost gt c0 show monitor cO Monitor Version BLDR 2 x 42 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx show numdrives This command reports the number of drives currently managed by the specified controller cx This report does not include logically removed or exported drives On 9500S and earlier controllers physically removed disk s will still be counted For a workaround see cx px show smart on page 107 Example localhost gt c0 show numdrives cO Number of Drives 5 cx show numports This command reports how many physical connections are made to the controller and the total number of physical ports possible for the controller Example for a 9650SE 16ML with no drives attached localhost gt c0 show numports c0 Number of Ports 16 Example for 9690SA 8E with 8 dual port SAS drives localhost gt c3 show numports c3 Connections 16 of 128 cx show numunits This command reports the number of units currently managed by the specified controller cx This report does not include off line units or removed units
133. ollers and for 9690SA and 9650SE controllers running 9 5 1 or later the show verify command displays the current verify background task schedule as illustrated below localhost gt cl show verify Verify Schedule for Controller cl Slot Day Hour Duration Status 1 Mon 2 00am 4 hr s disabled 2 disabled 3 Tue 12 00am 24 hr s disabled 4 Wed 12 00am 24 hr s disabled 5 Thu 12 00am 24 hr s disabled 6 Fri 12 00am 24 hr s disabled 7 Sat 12 00am 24 hr s disabled A status of disabled indicates that the controller will not use the defined schedule timeslots and will start verifying within 10 to 15 minutes if the verify command is entered manually or it will begin automatically if the autoverify option is set Rebuilds migrations and initializations will take priority over verifies Example 2 Basic Verify Schedule For 9750 9690SA and 9650SE controllers if the basic Verify Task Schedule is selected the show verify command displays a schedule as illustrated below localhost gt cl show verify cl basic verify weekly preferred start Friday 12 00am cx show verifymode 54 This command is only supported on 9750 9690SA and 9650SE controllers This command shows the current rebuild mode setting of the specified controller The verify mode has two settings Adaptive and Low latency Verify mode works in conjunction with the verify task rate see cx show verifyrate on page
134. on objects such as ex cx ux cx px cx bbu ex ex slotx ex fanx and ex tempx displays all possible sub commands associated with the object For example help on the controller object ex will display all the sub commands associated with the controller cx like this www si com channel products 133 Chapter 2 CLI Syntax Reference 134 localhost gt help cx CxX CxX Ccx Ccx Ccx cx cx Ccx cx FOX cx TEX Ccx Cx Ccx CX CX CxX CxX CxX CxX cx Jox cx cx cx cx Jox CX show show attribute attribute where attribute is achip allunitstatus autocarve 9KSX SE SA bios driver firmware autorebuild 9KSX SE only carvesize 9KSX SE SA drivestatus ctlbus 9KSX SE SA memory model monitor numdrives numports numunits unitstatus ondegrade 9500S only pcb pchip serial spinup stagger show all where all means Attributes and configurations show diag show show rebuild 9000 series show rebuildmode 9KSE SA show rebuildrate 9KSE SA show verify 9000 series show verifymode 9KSE SA show verifyrate 9KSE SA show selftest 9000 series show phy 9750 and 9690SA only show dpmstat type lt inst ra ext gt 9000 series for type inst and type ra 9KSE SA for type ext add type lt RaidType gt disk lt p p gt stripe lt Stripe gt noscan nocache nowrcache nordcache rdcachebasic group lt 3 4 5 6 7 8 9 1
135. oot for 7000 and 8000 series controllers www si com channel products 69 Chapter 2 CLI Syntax Reference cx set rebuildmode lt adaptivellowlatency gt This command is only supported on 9750 9690SA and 9650SE controllers This command sets the rebuild mode The rebuild mode has two settings Adaptive and Low Latency Rebuild mode works in conjunction with the rebuild task rate see cx set rebuildrate lt 1 5 gt on page 70 The Adaptive setting is the default rebuild mode It allows the firmware to adjust the interaction of rebuild tasks with host I Os to maximize the speed of both host I O and rebuild tasks When a rebuild background task is active if the task rate is set to a fast rebuild rate 1 e low I O rate the system latency increases and performance may be negatively affected especially for applications such as video server applications and audio applications The Low Latency setting will minimize the latency delay in reading data from the RAID unit by slowing down the rebuild task which allows host Reads to complete thus improving performance For a more complete discussion of background task modes see Working with the Background Task Mode in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Important Setting rebuildmode to low latency and rebuildrate to 5 is not recommended when I O is active because in that case the rebuild as a background task may never compl
136. or creating and deleting RAID units online For a summary of what you can do using the CLI see Common Tasks Mapped to CLI Commands on page 18 Operating Systems The 10 0 version of the 3ware CLI is supported under the following operating systems e Windows Windows 7 Vista Windows Server 2008 and Windows Server 2003 SP2 32 bit and 64 bit versions of each e Linux Redhat Enterprise openSUSE Linux SUSE Linux Enterprise Server and other versions of Linux using the open source Linux 2 6 kernel driver sources Additional operating systems will be supported in later releases For specific operating system versions that are supported in a given release see the Release Notes available at http www lsi com channel ChannelDownloads or the file file versions txt available on the 3ware CD Installing the 3ware CLI This section section includes information on installing the 3ware CLI under various operating systems Installing the 3ware CLI on Windows 3ware CLI can be installed or run directly from the 3ware software CD or the latest version can be downloaded from the LSI web site http w ww lsi com channel ChannelDownloads Online manual pages are also available in nroff and html formats These are located in packages cli tw_cli 8 html Or tw_cli 8 nroff 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Installing the 3ware CLI To install 3ware CLI on Windows Do one of the following e Run t
137. or for clearing instantaneous data Example of clearing Running Average and Histdata statistics localhost gt c0 p3 set dpmstat clear type ra Clearing Drive Performance Monitor running average data on c0 p3 Done Please note this clears the Running Average and Histogram data Example of clearing when I O traffic has been stopped If I O traffic to the drive has been stopped after clearing a subsequent request to show the running average statistics would show all zeros localhost gt c0 p3 show dpmstat type ra Queue Xfer Resp Port Status Unit Depth TOPs Rate MB s Time ms p3 OK u0 0 0 0 000 0 Similarly the display for Histogram data would also be all zeros 114 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Phy Object Commands Phy Object Commands Syntax These commands are for 9750 and 9690SA controllers only Phy Object Commands are sent to an instance of a controller phy such as c0 phy0 cx phyx show cx phyx set link auto 1 5 3 0 6 0 c x phyx show This command is only for 9750 and 9690SA controller models and for 9650SE with Release 9 5 2 or later This command presents a summary report on the specified phy The link speed of the phy is shown in three columns Supported Enabled and Control The Supported and Enabled values are set for the phy and are not changeable The Control value is the link speed that may be set with the cx phyx set link autol1 513 016 0 command The def
138. ormance Monitor ON Version 1 Max commands for averaging 100 Max latency commands to save 10 Requested data Instantaneous Drive Statistics Queue Xfer Resp Port Status Unit Depth IOPs Rate MB s Time ms po NOT PRESENT 7 pl NOT PRESENT p2 OK 7 p3 OK u0 10 93 2 907 85 p4 OK ul 10 84 2 640 95 p5 OK p6 NOT PRESENT p7 NOT PRESENT Example of running average ra drive statistics To display a summary of the running average data for the set of drives attached to the controller use command cx show dpmstat type ra Notice that in this case the Performance Monitor is turned off localhost gt c0 show dpmstat type ra Drive Performance Monitor Configuration for c0 Performance Monitor OFF Version 1 www si com channel products 39 Chapter 2 CLI Syntax Reference Max commands for averaging 100 Max latency commands to save 10 Requested data Running Average Drive Statistics Resp Time ms Queue Port Status Unit Depth pO NOT PRESENT a pl NOT PRESENT p2 OK p3 OK ud 0 p4 OK ul 0 p5 OK p6 NOT PRESENT p7 NOT PRESENT Xfer IOPs Rate MB s 435 25 249 366 21 630 Example of extended drive statistics ext To display a summary of the extended drive statistics associated with the specified controller use command cx show dpmstat type ext localhost gt c3 show dpmstat type
139. otes the setting of fastest background task and slowest I O as follows 5 fastest verify slowest I O 4 faster verify slower I O 3 balanced between verify and I O 2 faster I O slower verify 1 fastest I O slowest verify This command applies to the 7000 8000 and 9000 models controllers Example localhost gt cl set verifyrate 2 Setting Verify background task rate on cl to 2 faster 1 0 Done Related commands cx show verifyrate cx set verifymode lt adaptivellowlatency gt ex show verifymode cx set selftest enable disable task UDMA SMART This command enables or disables all selftest tasks or a particular selftest_task UDMA or SMART The selftest schedule is always enabled For 3ware RAID controllers older than the 9690SA two self tests can be set one to check whether UDMA Mode can be upgraded applies to PATA drives only and another to check whether SMART thresholds have been exceeded For 9750 and 9690SA controllers you can only check the SMART thresholds for drives 7000 8000 series have the same internal schedule but it is not viewable or changeable Example localhost gt c0 selftest enable task UDMA enables UDMA selftest on controller c0 74 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands cx set ondegrade cacheoffifollow This command is only for 9500S controllers This command allows you to set a controller based writ
140. ped across more than one disk RAID 0 disk arrays achieve high transfer rates because they can read and write data on more than one drive simultaneously The stripe size is configurable during unit creation RAID 0 requires a minimum of two drives When drives are configured in a striped disk array see Figure 1 large files are distributed across the multiple disks using RAID 0 techniques Striped disk arrays give exceptional performance particularly for data intensive applications such as video editing computer aided design and geographical information systems RAID 0 arrays are not fault tolerant The loss of any drive results in the loss of all the data in that array and can even cause a system hang depending on your operating system RAID 0 arrays are not recommended for high availability systems unless additional precautions are taken to prevent system hangs and data loss www si com channel products 9 Chapter 1 Introduction to the 3ware Command Line Interface Figure 1 RAID 0 Configuration Example RAID 0 480 GB 64K Stripe ojala 120GB 120GB 120GB 120GB RAID 1 RAID 1 provides fault tolerance and a speed advantage over non RAID disks RAID 1 is also known as a mirrored array Mirroring is done on pairs of drives Mirrored disk arrays write the same data to two different drives using RAID 1 algorithms see Figure 2 This gives your system fault tolerance by preserving the data on one drive if the other
141. ply to 9690SA 9650SE 9590SE and 9550SX U but not to 9500S and are so labeled A few commands apply only to models 9500S and are labeled as such If a command is labeled as applying to the SX controller it is available for both 9550SX and 9550SXU You may need to install particular firmware and drivers for some features to take effect See the Release Notes for details Important For all of the functions of the 3ware CLI to work properly you must have the proper CLI firmware and driver versions installed For the latest versions and upgrade instructions check http www si com channel ChannelDownloads This chapter includes the following sections e Features of the CLI on page 2 e Installing the 3ware CLI on page 2 e Working with 3ware CLI on page 5 e Understanding RAID Levels and Concepts on page 8 www si com channel products Chapter 1 Introduction to the 3ware Command Line Interface Features of the CLI Supported 3ware CLI is a command line interface for managing 3ware RAID Controllers It provides controller logical unit drive enclosure and BBU Battery Backup Unit management It can be used in both interactive and batch mode providing higher level API application programming interface functionalities You can use the CLI to view unit status and version information and perform maintenance functions such as adding or removing drives 3ware CLI also includes advanced features f
142. port instructs the firmware to remove the specified port from its pool of managed ports but does not retain the DCB Disk Configuration Block metadata on the attached disk You can import or re introduce the port by rescanning the controller noscan is used to not inform the operating system of this change The default is to inform the operating system This feature is applicable for 7 8000 series only quiet is for non interactive mode any redundant units This command will fail if you attempt to remove a drive froma non redundant unit After the drive is removed in CLI it can be removed physically without powering down the system if a hot swap bay is available System hangs and damage can occur if a hot swap bay is not used i Warning Use caution when using this command as this operation will degrade c xlpx set identify 0n Joff This command applies only to 9000 series SX SE SA controllers This feature requires a supported enclosure This command sets the LED status of the port to on or off If identify is set to on the firmware activates the setting of the corresponding LED of the port on the controller and causes it to blink Note This command is equivalent to cx ex slotx set identify onloff on page 128 additional information about enclosure related commands see Enclosure Object Note This feature requires an enclosure with appropriate enclosure support For E and Element Commands on page 122 Example
143. ports the storsave policy on the unit For more information see cx ux set storsave protectlbalancelperform quiet on page 95 Example localhost gt c0 u5 show storsave c0O u5 Command Storsave Policy protect cx ux show verifystatus This command reports the verifystatus if any of the specified unit Example localhost gt c0 u5 show verifystatus cO u5 is not verifying its current state is OK www si com channel products 85 Chapter 2 CLI Syntax Reference cx ux show volumes c x ux show 86 This feature only applies to 9000 series controllers This command reports the number of volumes in the specified unit The number of volumes will normally be 1 unless auto carving is enabled and or a boot LUN was specified Example localhost gt c0 u0 show volumes c0 u0 volume s 1 all This command shows the current setting of all above attributes If the auto carve policy was on at the time the unit was created and the unit is over the carve size multiple volumes were created and are displayed at the end of the summary information Similarly if the unit was created using the 3ware BIOS utility 3BM and a size was entered in the Boot Volume Size field multiple volumes were created and will be displayed Note that a volume created using the Boot Volume Size feature does not have to be used as a boot volume Example localhost gt c0 ul show all c0 ul status OK c0 ul is not rebu
144. re CLI Note The output of some commands varies somewhat for different types of E controllers and may vary if you have an enclosure attached For most commands where this is the case examples are provided to show the differences Common Tasks Mapped to CLI Commands The table below lists many of the tasks people use to manage their RAID controllers and units and lists the primary CLI command associated with those tasks Table 5 Common Tasks Mapped to CLI Commands Task CLI Command Page Controller Configuration Tasks View information about acontroller cx show 33 View controller policies and other cx show attribute attribute 35 details View drive performance statistics cx show dpmstat 38 type inst ralext 18 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Common Tasks Mapped to CLI Commands Table 5 Common Tasks Mapped to CLI Commands Task CLI Command Page Set policies for a controller e Modify staggered spinup cx set stagger and cx set spinup 75 Disable write cache on unit cx set ondegrade 75 degrade Enable disable autocarving cx set autocarve 75 Enable disable autorebuild cx set autorebuild 76 Set the autocarve volume size cx set carvesize 75 Enable disable drive cx set dpmstat 68 performance monitoring statistics dpmstat Unit Configuration Tasks View information about a unit cx u
145. rent CLI commands in addition to cx add rebuild To set up the rebuild schedule you want to use follow this process 1 Use the ex show rebuild command to display the current schedule for rebuild tasks For details see page 49 2 If any of the scheduled tasks do not match your desired schedule use the cx del rebuild command to remove them For details see page 67 3 Use the ex add rebuild command to create the rebuild schedule slots you want described above 4 Use the cx set rebuild enable command to enable the schedule this enables all rebuild schedule slots For details see page 69 Warning If all time slots are removed from the rebuild task schedule be sure to AN also disable the schedule Otherwise the rebuild task will never occur cx add verify ddd hh duration This command adds a new task slot to the Verify Task Schedule on the day ddd where ddd is Sun Mon Tue Wed Thu Fri and Sat at hour hh range 0 23 for a duration of duration range 1 24 hours A maximum of seven verify task slots can be included in the schedule This command will fail if no empty task slot is available Note This Verify Task Schedule is used when cx set verify advanced for 9750 E controllers and 9690SA and 9650SE controllers running firmware 9 5 1 or later and for earlier controllers when cx set verify enabled If you have a 9750 controllers and 9690SA or 9650SE controllers running firmware 9 5 1 or later
146. rify Behavior cx ux start verify 9750 and 9650SE and 9550SX and 9650SE and 9690SA with earlier 9690SA with firmware 9 5 or 9 5 1 or later 9 5 0 1 Basic Verify Schedule Runs l N A N A verify basic immediately Advanced Verify Follows Schedule Advanced Verify N A N A verify advanced Schedule Verify Schedule is Runs A Runs Runs Bice ee immediately immediatel immediatel verify disable Same as Basic y y Verify Schedule is Follows 7 Enabled Advanced Verify Follows Verify Follows Verify Schedule Schedule verify enable Schedule Verify will pause if a rebuild migration or initialization is currently in progress www si com channel products 89 Chapter 2 CLI Syntax Reference c xlux pause rebuild This command allows you to pause the rebuild operation on the specified unit ex ux This feature is only supported on the 7000 8000 series controllers 9000 series controllers have an on board scheduler where rebuild operations can be scheduled to take place at specified start and stop times The cx ux pause rebuild command is provided to enable 7000 8000 users to achieve similar functionality with use of Linux provided schedulers such as cron 8 or at 1 or user supplied programs c xlux resume rebuild This command allows you to resume the rebuild operation on the specified unit ex ux This feature is intended only for 7000 8000 series controllers 9000 series controllers have an o
147. rm The possible status values are OK FAIL NOT INSTALLED and ACTIVATED The status values are described below The possible values for State are ON and OFF The possible values for Audibility are UNMUTE and MUTED Possible Status values OK Alarm device is functional and operational FAIL Alarm device has malfunctioned and is not operational NOT INSTALLED Alarm device has not been installed ACTIVATED Alarm device is functional and an error condition has been detected This is a visual indication for the alarm in addition to the sound If you mute the sound this indication remains Example localhost gt c0 e0 alm0 show Alarm Status State Audibility almo ACTIVATED OFF UNMUTE c x ex almx set alarm mute unmute off 132 This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command controls the audibility and state of the enclosure alarm It provides the ability to silence the alarm after it has activated It also gives you the option to mute or unmute the alarm setting 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Help Commands You can also use this command to prevent an audible alarm from sounding in the case where a known condition will set off the alarm by muting the alarm in advance If an error condition or degraded state is detected the enclosure alarm or buzzer will be audible To si
148. roller Bus Type PCIe c2 Controller Bus Width 8 lanes c2 Controller Bus Speed 2 5 Gbps lane This command reports the device driver version associated with controller Icx Example localhost gt c0 show driver cO Driver Version 3 x cx show dpmstat type inst rajext 38 This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers The type ext feature is only for SE SA controllers This command shows the configuration and setting of the Drive Performance Monitor and a summary of statistics for drives attached to the controller The optional type attribute specifies which statistics will be displayed The available options are inst for Instantaneous ra for Running Average and ext for Extended Drive Statistics If you do not specify a type the display will show the default set of drive statistics which is the type inst inst Instantaneous This measurement provides a short duration average ra Running Average Running average is a measure of long term averages that smooth out the data and results in older results fading from the average over time ext Extended Drive Statistics The extended drive statistics refers to statistics of a drive s read commands write commands write commands with FUA Force Unit Access flush commands and a drive sectors s read write and write commands with FUA Additional statistics are available for drives at specific ports For details
149. rs do not have dates so you will see a in the Date column This means that it is not applicable In 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands addition alarm messages on 7000 8000 controllers contain the severity in the message text so the Severity column also shows a Example Typical output looks like localhost gt cl show alarms Ctl Date Severity AEN Message co Fri Mar 21 2008 14 19 00 WARNING Drive removed port 1 co Fri Mar 21 2008 14 19 00 ERROR Degraded unit unit 1 port 1 co Fri Mar 21 2008 14 19 25 FO Drive inserted port 1 co Fri Mar 21 2008 14 19 25 FO Unit operational unit 1 co Fri Mar 21 2008 14 28 18 FO Migration started unit 0 co Sat Mar 22 2008 05 16 49 FO Migration completed unit 0 c0 Tue Apr 01 2008 12 34 02 WARNING Drive removed port 1 co Tue Apr 01 2008 12 34 22 ERROR Unit inoperable unit 1 co Tue Apr 01 2008 12 34 23 FO Drive inserted port 1 c0 Tue Apr 01 2008 12 34 23 FO Unit operational unit 1 cx show events reverse This command is the same as cx show alarms reverse See details above cx show AENSs reverse This command is the same as cx show alarms reverse See details above cx show diag This command extracts controller diagnostics suitable for technical support usage Note that some characters might not be printable or rendered correctly human readable It is recommended to save
150. s It will begin automatically if a rebuild is needed and a proper spare drive is set up If the rebuild schedule is enabled while a rebuild process is underway the rebuild will pause until a scheduled time slot www si com channel products 49 Chapter 2 CLI Syntax Reference Example for 9650SE controller If a unit is in the initialization state at noon on Wednesday and the rebuild schedule shown above is in use with schedules disabled you would see the following status using the show command tw_cli cl show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 INITIALIZING 0 64K 521 466 RiW OFF Port Status Unit Size Blocks Serial pO NOT PRESENT p1 O u0 76 33 GB 60086528 Y2NXL7FE p2 NOT PRESENT p3 O ud 76 33 GB 60086528 Y2NXLB9E p4 NOT PRESENT S gt p5 O u0 76 33 GB 60086528 Y2NXQPZE p6 NOT PRESENT p7 O u0 76 33 GB 60086528 Y2NXM4VE p8 O u0 74 53 GB 56301488 3JV3WTSE p9 o u0 74 53 GB 56301488 3JV3WRHC p10 O u0 74 53 GB 56301488 3JV3WOLO p11 O ud 74 53 GB 56301488 3IV3WOLZ Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu On Yes OK OK OK 0 XX XXX XXXX If you then enable the rebuild schedules the unit initialization will be paused until the next scheduled time slot as reflected in the examples below localhost gt cl set rebuild enable Enabling scheduled rebuilds on controller cl Done localhost gt cl show rebuild R
151. s Serial po OK u0 149 05 GB 312581808 3JSOTF14 p1 OK u0 149 05 GB 312581808 3JSOTETZ p2 OK ul 149 05 GB 312581808 3JS0VG85 p3 OK ul 149 05 GB 312581808 3JSOVGCY p4 OK ul 149 05 GB 312581808 3JS0OVGGO p5 OK u2 149 05 GB 312581808 3JSOVH1P p6 OK 149 05 GB 312581808 3JSOTFOP p7 OK 5 149 05 GB 312581808 3JS0VF43 p8 OK e 149 05 GB 312581808 3JS0VG8D p9 OT PRESEN p10 OT PRESEN p11 OT PRESEN Example for 9750 and 9690SA controller localhost gt c2 show drivestatus VPort Status Unit Size Type Phy Encl Slot odel po O u0 34 25 GB SAS c2 e0 s1t0 AXTOR ATLAS15K2_36 pl O u0 34 25 GB SAS c2 e0 slt1 AXTOR ATLAS15K2_36 p2 O ud 34 25 GB SAS S c2 e0 slt2 AXTOR ATLAS15K2_36 p3 O u0 34 18 GB SAS c2 e1 s1t0 HITACHI HUS151436VL p4 O u0 34 18 GB SAS c2 e1 s1t1 HITACHI HUS151436VL p5 O ud 34 18 GB SAS c2 e1 s1t2 HITACHI HUS151436VL p6 0 u0 34 25 GB SAS a c2 e0 s1t3 AXTOR ATLAS15K2_36 p7 0 u0 34 25 GB SAS c2 e0 s1t4 AXTOR ATLAS15K2_36 p8 O ud 34 25 GB SAS c2 e0 s1t5 AAXTOR ATLAS15K2_36 p9 0 u0 34 25 GB SAS c2 e0 s1t6 AXTOR ATLAS15K2_36 plo O u0 34 18 GB SAS c2 e1 s1t3 HITACHI HUS151436VL p11 O u0 34 18 GB SAS c2 e1 s1t4 HITACHI HUS151436VL p12 O ud 34 18 GB SAS c2 e1 slt5 HITACHI HUS151436VL p13 O u0 34 18 GB SAS c2 e1 s1t6 HITACHI HUS151436VL p14 O ud 34 25 GB SAS c2 e0 slt7 AXTOR ATLAS15K2_36 p15 O u0 34 25 GB SAS c2 e0 s1t8 AXTOR ATLAS15K2_36 p16 O ud 34 25 GB SAS
152. s allows data to be written and accessed on more than one drive at the same time Striping combines each drive s capacity into one large volume Striped disk arrays RAID 0 achieve highest transfer rates and performance at the expense of fault tolerance e Distributed Parity Parity works in combination with striping on RAID 5 RAID 6 and RAID 50 Parity information is written to each of the striped drives in rotation Should a failure occur the data on the failed drive can be reconstructed from the data on the other drives e Hot Swap The process of exchanging a drive without having to shut down the system This is useful when you need to exchange a defective drive in a redundant unit Array Roaming The process of removing a unit from a controller and putting it back later either on the same controller or a different one and having it recognized as a unit The disks may be attached to different ports than they were originally attached to without harm to the data Available RAID Configurations RAID is a method of combining several hard drives into one unit It can offer fault tolerance and higher throughput levels than a single hard drive or group of independent hard drives LSI s 3ware controllers support RAID 0 1 5 6 10 50 and Single Disk The information below provides a more in depth explanation of the different RAID levels RAID 0 RAID 0 provides improved performance but no fault tolerance Since the data is stri
153. s fault tolerance and a read speed advantage over non RAID disks RAID 5 This type of unit provides performance fault tolerance and high storage efficiency RAID 5 units can tolerate one drive failing before losing data RAID 6 Provides very high fault tolerance with the ability to protect against two consecutive drive failures Performance and efficiency increase with higher numbers of drives RAID 10 A combination of striped and mirrored units for fault tolerance and high performance RAID 50 A combination of RAID 5 and RAID 0 It provides high fault tolerance and performance Single Disk Not a RAID type but supported as a configuration Provides for maximum disk capacity with no redundancy You can create one or more units depending on the number of drives you have installed Table 3 Possible Configurations Based on Number of Drives Drives Possible RAID Configurations 4 Single disk 2 RAID 0 or RAID 1 www si com channel products Chapter 1 Introduction to the 3ware Command Line Interface Table 3 Possible Configurations Based on Number of Drives Drives 3 Possible RAID Configurations RAID 0 RAID 1 with hot spare RAID 5 RAID 5 with hot spare RAID 10 Combination of RAID 0 RAID 1 single disk 6 or more RAID 6 RAID 5 with hot spare RAID 10 with hot spare Combination of RAID 0 RAID 1 hot spare single disk RAID 6
154. s only Also known as shutdown start mediascan 7000 8000 only stop mediascan 7000 8000 only rescan noscan 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands c x show This command shows summary information on the specified controller cx This information is organized into a report containing two to three parts e A Unit summary listing all present units e A Port summary section listing of all ports or virtual ports and disks attached to them A BBU summary section listing if a BBU is installed on the controller The Unit summary section lists all present unit and specifies their unit number unit type such as RAID 5 unit status such as INITIALIZING R percent completion of rebuilding V I M percent completion of verifying initializing or migrating stripe size size usable capacity in gigabytes the write cache setting the read cache setting if supported by your controller and the auto verify policy status on off Possible unit statuses include OK RECOVERY INOPERABLE UNKNOWN DEGRADED INITIALIZING INIT PAUSED VERIFYING VERIFY PAUSED REBUILDING REBUILD PAUSED MIGRATING and MIGRATE PAUSED Definitions of the unit statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 of the drives in the unit This feature provides a diagnostic capability for potential problem drives The error may not be a repeated error
155. s the Auto Rebuild policy If the policy is enabled the firmware will select drives to use for rebuilding a degraded unit using the following priority order For more information see cx set autorebuild onloff on page 76 1 Smallest usable spare 2 Smallest usable unconfigured available drive 3 Smallest usable failed drive If the policy is disabled only spare drives will be used for an automatic rebuild operation Example localhost gt c0 show autorebuild c0 Auto Rebuild Policy on This command reports the BIOS version of controller cx Example localhost gt c0 show bios c0 BIOS Version BG9X 2 x cx show carvesize This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command shows the maximum size of the volumes that will be created if the autocarve policy is set to on The carvesize can be set between 1024 GB and 32768 GB 1 TB to 32 TB Default carvesize is 2048 GB 2 TB For more information see cx show autocarve above Example localhost gt c0 show carvesize c0 Auto Carving Size 2000 GB www si com channel products 37 Chapter 2 CLI Syntax Reference cx show ctlbus cx show driver This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command reports the controller host bus type bus speed and bus width Example for 9690SA localhost gt c2 show ctlbus c2 Cont
156. s you to set the carve size in GB This feature works together with autocarve See cx set autocarve onloff above for details Note that for some operating systems are limited to 2 TB For details see Support for Over 2 Terabytes on page 10 Example localhost gt cO set carvesize 2000 Setting Auto Carving Size on c0 to 2000 GB Done cx set autorebuild onloff 76 This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command turns the Auto Rebuild policy on or off By default autorebuild is on If the policy is on the firmware will select drives to use for rebuilding a degraded unit using the following priority order 1 Smallest usable spare 2 Smallest usable unconfigured available drive 3 Smallest usable failed drive 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands drives that have been disconnected from the controller long enough to cause a Note Failed drives can be drives that have mechanically failed or they can be l drive timeout error and for the controller to classify them as failed Enabling Auto Rebuild allows you to add a drive to the controller and have it be available for a rebuild as soon as you tell the controller to rescan without having to specify it as a spare It also means that if you accidentally disconnect a drive causing the controller to see it as a failed drive and then recon
157. se the command cx px set dpmstat clear type rallctlext on page 114 For more information see Drive Performance Monitoring on page 241 of the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt c0 set dpmstat off Setting Drive Performance Monitoring on c0 to off Done cx set rebuild enable disable 1 5 This command enables or disables the Rebuild Task Schedule defined for controller ex and sets the priority of rebuild versus I O operations When enabled rebuild tasks will only be run during the time slots scheduled for rebuilds If a rebuild is taking place when the schedule is enabled it will be paused until the next scheduled time The priority of rebuild versus I O operations is specified with 5 where 5 is more resources and 1 the least Setting the value to 5 gives maximum processing time to rebuilds rather than I O Setting the value to 1 gives maximum processing time to I O rather than rebuilds 5 fastest rebuild slowest I O 4 faster rebuild slower I O 3 balanced between rebuild and I O 2 faster I O slower rebuild 1 fastest I O slowest rebuild Enabling and disabling rebuild schedules is only for 9000 series controllers however the rebuild rate 1 5 applies to all controllers 7000 and 8000 series controllers have only one setting for Task Rate it applies to both rebuild and verify rates This rate is not persistent following a reb
158. series SX SE SA only model neq 9000 series SX SE SA only serial smart status identify 9000 series SX SE SA only driveinfo 9750 and 9690SA only dpmstat type instr ra lct histdata ext 9000 series SX SE SA except for type ext which is SE SA only cx px show all cx px remove noscan quiet cx px set identify on off 9000 series SX SE SA only cx px set dpmstate clear type lt ra lctlext gt 9000 series SX SE SA only except for type ext which is 9000 series SE SA only This command shows summary information about the specified disk attached to port cx px Example for 9650SE and earlier controllers localhost gt c1 p5 show Port Status Unit Size Blocks Serial ps OK u0 149 05 GB 312581808 3JS0L9QW The above output indicates that port 5 of controller 1 is attached to one disk with status OK participating in unit 0 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 c x px show Port Object Commands Example for 9750 and 9690SA controllers Note that in this case the summary information is in a slightly different format localhost gt c3 p1 show VPort Status Unit Size Type Phy Encl Slot Model pl OK u0 149 05 GB SATA 0 WDC WD1600JS 22NCBla The above output indicates that virtual port VPort 1 is associated with a SATA disk that has a status of OK and is part of unit 0 It also indicates that it is associated with controller phy 0 and is directly atta
159. set dpmstat on off 9000 series cx update fw filename_with_path force 9000 series cx flush cx commit Windows only Also known as shutdown cx start mediascan 7000 8000 only cx stop mediascan 7000 8000 only cx rescan noscan localhost gt Help with attributes As you work with specific objects or commands you can also use to get help For example If you enter the command c0 show and then need help on what specific attribute syntax is possible you can use to get help as following localhost gt c0 show cx show cx show attribute attribute where attribute is achip allunitstatus autocarve 9000 series autorebuild 9550SX only bios carvesize 9000series driver drivestatus firmware memory model monitor numdrives numports numunits ctlbus 9000 series SX SE SA only serial ondegrade 9500S only pcb pchip spinup stagger unitstatus cx show all where all means attributes and configurations cx show diag cx show alarms reverse cx show rebuild 9000 only cx show verify 9000 only cx show selftest 9000 only localhost gt help This help command provide a table of contents providing help with the overall navigation of the CLI commands For example www si com channel products 135 Chapter 2 CLI Syntax Reference help show help flush help rescan 136 Typical output looks like the following localhost gt help Copyright c 2004 2009 Applied Mi
160. sical ports on the drive Can be 1 or 2 depending on whether the drive is a dual ported drive SAS drives can be either single or double ported while SATA drives have only one port Drive Connections indicates the number of connections from the controller to the drive Can be either 1 or 2 Additional information is available using the cx px show all command Example localhost gt c3 p4 show driveinfo c3 p4 Drive Type SAS c3 p4 Interface Type Direct c3 p4 Drive Ports 2 c3 p4 Drive Connections 1 cx px show firmware This command displays the firmware version of the drive attached to the specified port Example localhost gt c0 p5 show firmware c0 p5 Firmware Version 65 13G65 cx px show identify This command only applies to 9750 model controllers and 9000 series SX SE SA model controllers This feature requires a supported enclosure This command shows whether the LED of the drive attached to the specified port is set to on or off For details see cx px set identify onloff on page 113 Example localhost gt c0 p5 show identify c0 p5 Identify Status on cx px show Ispeed 106 This command only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command displays the maximum SATA link speed supported by the drive attached to the port and the present SATA link speed setting Example localhost gt c0 p5 show lspeed c0 p5 SATA Link Speed
161. spe 3 pied ooh choc ho ap hn goa Se ere tense oe aie wide Bee eee 125 Iex 6xShOW aNs eve cue Seth Be a de ee ote ce ke Dy 125 ex ex SNOW temps dee a Es nee ed 126 eX EX SNOW PWIS cs oia 00 ae eae ode eae bea eee ee ee dale le 126 exfex show alarms seraa eee a a 127 EX showa vta peste Ye ee eh eee god Hie bed de Be lea tae eas 127 ICX GX SIOLX SNOW de fcc Tit a ened ae bloat 127 ex ex slotx show identify 00 000 eee 128 cx ex slotx set identify on off 0 2 eee 128 exiexHanx Shows 4 06 cigar SES Shoe Rae ak ee ee et a ek Ree eG 129 cx ex fanx show identify 0 0 teens 129 cx ex fanx set identify on off 2 2 eee 129 ex ex fanx set speed lt 0 7 gt 2 tte ena 129 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 ex ex pwiSxX SNOW pio Re ye ae SE AS aes 130 cx ex pwrsx show identify 0 0 0 ete 130 cx ex pwrsx set identify on off 6 2 eee 131 IEX X OMPX SNOW seek ese ashe Ste dla eae aes le a a 131 cx ex tempx show identify 0 0 ccc eens 131 cx ex tempx set identify on off 62 eee 132 cx ex alMx SNOW ici A ae eye Se eS 132 cxlex almx set alarm mute unmuteloff 0 0 eee ee 132 Help Commands voice Sane Shawls bob eed Cee bebe ewe e EEY 133 Help with specific commands 0 00 eee ett 133 Help with attributes voir pata Ee ace ees ed 135 Olivia a A A EI 135 E A grt Siig eave gee aa Be alee eee Shee be 136 help Tush coito ee ean aie ete AAA
162. sped up There is some system overhead from setting rapidrecovery to all If you have a BBU you can set rapid recovery to rebuild as a BBU provides protection against data loss in the event of an unclean shutdown Once this attribute is set the policy remains in effect unless it is changed or disabled for the unit Note Once disabled this setting cannot be changed for the unit at a later time The quiet option is provided for scripting purposes and is applicable only to the disable option cx ux set rapidrecovery disable quiet versions prior to 9 5 1 are assigned a Rapid Recovery Policy of disable which cannot be changed Note When upgrading to 9 5 1 or later redundant units created using firmware Example localhost gt c0 u0 set rapidrecovery all Setting Rapid RAID Recovery policy on c1 u0 to all Done cx ux set storsave protect balance perform quiet This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command sets the storsave policy to be either protect balance or perform when the unit write cache is enabled The default setting is balance when a BBU is installed and perform whan a BBU is not installed The storsave policy adjusts several factors that control the balance between protection and performance on a unit There is a trade off among the available settings The following description about the settings should help you to decide which one is s
163. st be a positive integer between 0 to 60 seconds This policy in conjunction with Disk Spinup Policy specifies how the controller should spin up disks at boot time The default is 6 seconds cx set autocarve onloff This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command allows you to set the auto carve policy to on or off By default autocarve is off When the auto carve policy is set to on any unit larger than the carvesize is created or migrated into one or more carvesize volumes and a remaining www si com channel products 75 Chapter 2 CLI Syntax Reference volume Each volume can then be treated as an individual disk with its own file system The default carvesize is 2 TB This feature is useful for operating systems limited to 2 TB file systems For example using the 2 TB default carvesize a 3 TB unit will be configured into one 2 TB volume and one 1 TB volume A 5 TB unit will be configured into two 2 TB volumes and one 1 TB volume When auto carve policy is set to off all new units are created as a single large volume If the operating system can only recognize up to 2 TBs space over 2 TB will not be available Example localhost gt c0 set autocarve on Setting Auto Carving Policy on c0 to on Done cx set carvesize 11024 32768 This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command allow
164. status Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 OK 64K 596 004 ON OFF ul RAID 0 OK i 64K 298 002 ON OFF u2 SPARE OK 149 042 OFF u3 RAID 1 OK 149 001 ON OFF This command shows the current setting of all of the following attributes on the specified controller achip allunitstatus autocarve bios driver drivestatus firmware memory model monitor numports numunits numdrives ondegrade pcb pchip serial spinup stagger and unitstatus Example for 9650SE localhost gt gt c2 show all Driver Version 2 26 08 004 2 6 22 Model 9650SE 16ML Available Memory 224MB FE9X 4 05 00 026 BE9X 4 05 00 013 BLOX 3 08 00 001 L322623A7320106 Rev 032 PCHIP Version 2 00 ACHIP Version 1 90 16 Number of Drives 7 Firmware Version Bios Version Boot Loader Version Serial Number PCB Version Number of Ports Number of Units 1 Total Optimal Units 0 Not Optimal Units 1 45 Chapter 2 CLI Syntax Reference c2 Disk Spinup Policy 4 c2 Spinup Stagger Time Policy sec 1 c2 Auto Carving Policy on c2 Auto Carving Size 4000 GB c2 Auto Rebuild Policy on c2 Controller Bus Type PCle c2 Controller Bus Width 8 lanes c2 Controller Bus Speed 2 5 Gbps lane Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 REBUILD PAUSED 0 z 64K 372 476 RiW ON Port Status Unit Size Blocks Serial po NOT PRESENT
165. t 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 BBU Object Commands cx obu show attribute attribute This command shows the current setting of the given attribute s on the BBU board One or many attributes can be specified Specifying an invalid attribute will terminate the loop Possible attributes are batinst bootloader cap fw lasttest pcb ready status serial temp volt cx bbu show batinst This command shows the date when the current battery was installed cx bbu show bootloader This command shows the BBU s boot loader version Note that the BBU bootloader version is not applicable for 9750 models cx bbu show cap This command shows the battery capacity in hours A value of 0 hours will be displayed if the battery capacity test has never been run taken during the last test If you have not run the BBU test command for some time this number can be misleading You can use the command cx bbu show lasttest to check the date of the last test For information about running a test see cx bbu test quiet on page 120 3 Note The estimated BBU capacity hours displayed is based on the measurement cx bbu show fw This command shows the BBU firmware version number Note that the BBU firmware version is not applicable for 9750 models cx bbu show lasttest This command shows the date the battery capacity was last measured If the battery capacity test has never been run
166. t mode but less performance than perform mode When storsave is set to the balance mode it means e When the unit becomes degraded the write cache will not be disabled e Write journaling is disabled if no BBU is present and is enabled if a BBU is present All data flushing from controller cache will be flushed to media if a BBU is installed and enabled Otherwise data will be flushed to disk only e Incoming FUA Force Unit Access host requests will be honored unless a BBU is installed and enabled in which case they will be ignored quiet is used for non interactive mode No confirmation is given and the command is executed immediately This is useful for scripting purposes For additional information see Setting the StorSave Profile for a Unit in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt c0 u5 set storsave protect Setting Command Storsave Policy for unit c0 u5 to protect Done 96 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands cx ux migrate type Ra dType disk p p group 3 4 5 6 7 8 9 10 11 12 13 14 15 16 stripe s ze noscan nocache autoverify E This feature only applies to 9000 series controllers This command allows you to change the existing configuration of a unit with type RaidType You can make three types of changes e Increase the capacity e Change the RAID level with the same or in
167. t 0 1 2 through 5 inclusive 9 and 12 If you have a 9750 or 9690SA controller the syntax is the same even though you are technically addressing vports stripe size consists of the stripe size to be used The following table illustrates the supported and applicable stripes on unit types and controller models Stripe size units are in K kilobytes If no stripe size is specified 256K is used by default if applicable If you need to change the stripe size after the unit is created you can do so by migrating the unit Table 7 Supported Stripe Sizes KB Model RO R1 R5 R6 R10 Spare R50 Single 7K 8K 64 N A 64 N A 64 N A N A N A 128 128 256 256 512 512 1024 1024 90008 16 N A 16 NA 16 N A 16 N A 64 64 64 64 256 256 256 256 www si com channel products 57 Chapter 2 CLI Syntax Reference 58 Table 7 Supported Stripe Sizes KB Model RO R1 R5 R6 R10 Spare R50 Single 9750 16 N A 16 16 NA 16 NA 9690SA nate 64 64 64 64 64 9650SE 256 256 256 256 256 a Models 95005 9550SX and 9590SE group 3141516171819110111112 13114115116 indicates the number of disks per group for a RAID 50 type This attribute can only be used when type raid50 Group 3 16 is only applicable to 9690SA Recall that a RAID 50 is a multi tier array At the bottom most layer N number of disks per group are used to form the RAID 5 layer These
168. t status and percentage show the composite unit status and composite rebuild percentage attribute attribute This command shows the current setting of the specified attributes One or many attributes can be requested Specifying an invalid attribute will terminate the loop Possible attributes are initializestatus name 9000 series autoverify 9000 series cache ignoreECC 9000 series identify 9000 series SX SE SA only qpolicy 9000 series SX SE SA only rapidrecovery 9000 series SE SA only rebuildstatus serial 9000 series status storsave 9000 series SX SE SA only verifystatus and volumes 9000 series cx ux show autoverify This feature only applies to 9000 series controllers This command shows the current autoverify setting of the specified unit Example localhost gt c0 u0 show autoverify c0 u0 Auto Verify Policy off cx ux show cache This command shows the current write cache state of the specified unit It provides the same information as the command cx ux show wrcache Example localhost gt c0 u0 show cache c0 u0 Write Cache State on cx ux show wrcache 82 This command shows the current write cache state of the specified unit It provides the same information as the command cx 1x show cache Example localhost gt c0 u0 show wrcache c0 u0 Write Cache State on 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands cx ux
169. the controller associated with enclosure cx ex Example localhost gt e0 show controllers e0 connects to controller c0 cx ex show diag helptext 124 This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex This command allows you to view the enclosure diagnostic log What is reported by this log will vary depending upon the manufacturer of the enclosure The enclosure diagnostic log may be requested by 3ware Customer Support to help troubleshoot problems on your controller 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Enclosure Object and Element Commands cx ex show slots This command is used with 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex This command reports the slots in enclosure ex ex and their associated information The Slot column lists the slot IDs the Status column lists the status of each slot the V Port column shows the associated port or virtual port of each slot and the Identify column lists the Identify setting of the slots Example localhost gt c0 e0 show slots Slot Status V Port Identify slot0 OK c0 p0 No slot1 OK c0 pl Yes slot2 NO DEVICE No slot3 NO DEVICE No cx ex show fans This command is used with 9750 and 9690SA controllers For the 9650SE simply drop the prepende
170. the output from this command to a file where it can be communicated to technical support or further studied with Linux utilities such as od 1 In order to redirect the output you must run the following command from a command line not from within the tw_cli shell tw_cli c0 show diag gt diag txt cx show phy This command is only for 9750 and 9690SA controllers and 9650SE with Release 9 5 2 or higher controllers It reports a list of the phys with related information for the specified controller The Device Type column indicates whether the connected device is an enclosure or a drive of type SATA or SAS The Device column is the www si com channel products 47 Chapter 2 CLI Syntax Reference device ID or handle There are three Link Speed columns Supported denotes the link speed capability of the phy device Enable denotes the current link speed setting and Control denotes the link control setting Example of 9690SA 8E connected to drives in an enclosure localhost gt c3 show phy Device Link Speed Gbps Phy SAS Addesss Type Device Supported Enabled Control phy0 500050e000030232 ENCL N A 3 0 3 0 Auto phyl 500050e000030232 ENCL N A 3 0 0 3 0 Auto phy2 500050e000030232 ENCL N A 3 0 3 0 Auto phy3 500050e000030232 ENCL N A 3 0 3 0 Auto phy4 500050e000030236 ENCL N A 3 0 3 0 Auto phy5 500050e000030236 ENCL N A 3 0 3 0 Auto phy6 500050e000030236 ENCL N A 349 0 350 Auto phy7 500050e000030236 E
171. the units to be verified For more information see cx ux set autoverify on off on page 90 You can view the verify schedule to be enabled or disabled with the command lex show verify on page 53 You can add verify task slots to the schedule using the command cx add verify ddd hh duration on page 65 You can remove verify task slots from the schedule with the cx del verify slot_id on page 68 cx set verify advanced basic 1 5 This command only applies to 9750 controllers and 9690SA and 9650SE RAID controllers running 9 5 1 or later This command is effectively the same as the set verify command Setting verify to advanced enables the advanced Verify Task Schedule which can include a series of up to 7 days and times Setting verify to basic creates a weekly schedule with one specific day and time and disables the series of scheduling slots associated with the advanced Verify Task Schedule For more about the basic schedule see cx set verify basic pref ddd hh below The priority of verify versus I O operations is specified with 5 where 5 is more resources and 1 the least Setting this value to 1 implies fastest I O and 5 implies fastest verify For information on the verify schedule see cx add verify ddd hh duration on page 65 cx set verify basic pref ddd hh 72 This command only applies to 9750 controllers and 9690SA and 9650SE RAID controllers running 9 5 1 or later Using th
172. then xx xxx xxxx will be displayed taken during the last test If you have not run the BBU test command for some time this number can be misleading For information about running a test see cx bbu test quiet on page 120 3 Note The estimated BBU capacity hours displayed is based on the measurement www si com channel products 117 Chapter 2 CLI Syntax Reference cx bbu show pcb This command shows the PCB revision number on the BBU cx bbu show serial This command shows the BBU serial number cx bbu show status This command shows the status of the BBU Possible values are Testing A battery test is currently in progress This test may take up to 24 hours to complete During the test the BBU is not capable of backup operation and the write cache of the RAID controller is also disabled If the test is completed with no error and the BBU status changes to WeakBat or OK the write cache will be re enabled If a Fault Failed or Error occurs during the test the write cache remains in the disabled state until the problem is fixed Charging The BBU is currently charging the battery Charging is started automatically by the BBU whenever necessary During charging the BBU is not capable of backup operation and the write cache is disabled Once the test is completed with no error and the BBU status changes to OK the write cache will be re enabled If a FAULT or ERROR occurs during the test the write cache remai
173. third parties Copyright Notice 2009 LSI Corporation All rights reserved Trademark Acknowledgments LSI the LSI logo design 3ware 3DM StorSwitch and TwinStor are all registered trademarks of LSI Corporation StorSave and StreamFusion are trademarks of LSI Linux is a registered trademark of Linus Torvalds in the United States other countries or both SUSE is a registered trademark of Novell Inc Windows is a registered trademark of Microsoft Corporation in the United States and other countries Firefox is a registered trademark of the Mozilla Foundation Safari is a registered trademark of Apple Inc registered in the U S and other countries PCI Express is a registered trademark of PCI SIG All other brand and product names may be trademarks of their respective companies Table of Contents Chapter 1 Chapier 2 About this CLI Guide 20 63 v4 cadet da viii Introduction to the 3ware Command Line Interface 1 Features ofthe Gila stele det ste ig atin he ee oy ee ee 2 Supported Operating Systems 00 cece ete 2 Installing the 3ware CLI 1 ketenes 2 Installing the 3ware CLI on Windows 0 0 cece eee ete eee 2 Installing the 3ware CLI on Linux ooccccccccoco eee 4 Working with 3ware CLI 0 0 0 cette teens 5 Using the command interface interactively 00 cee eee eee 5 Using a single command with output 00 000 eee 6 Using
174. tings All Users Application Data 3ware For Linux The log file is in the directory var log www si com channel products 139 Chapter 2 CLI Syntax Reference Disabling and enabling command logging You can disable or enable logging of controller commands by setting the environment variable TW_CLI_LOG to ON or OFF The method for setting the environment variable depends on the operating system For Linux The command you use to set the environment variable depends on the type of shell Important Use the same shell you are using to run CLI to set the environment variable If you set it in a different shell window and then terminate that shell the change will revert If Bash ksh or sh use export TW_CLI_LOG OFF or export TW_CLI_LOG 0N If csh C shell use setenv TW_CLI_LOG OFF or setenv TW_CLI_LOG ON Note Setting the environment variable as described above is not persistent across reboot because the the shell terminates when you power down and defaults are reset on power on To set an environment variable that will persist set a global variable in a login config file such as rc or cshrc that will set the variable to the desired state when the system powers on For details see the manpage for the shell you are using For Windows Under Windows you set the environment variable through My Computer gt Properties 1 Click the Start button right click on My Computer and choose Properties 2
175. troller will utilize BBU functionality in the event of a power failure 120 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 BBU Object Commands cx bbu disable quiet This command disables BBU detection on the controller When disabled the controller ignores the existence of the BBU and will show no BBU is installed even if a BBU is physically attached www si com channel products 121 Chapter 2 CLI Syntax Reference Enclosure Object and Element Commands Syntax 122 E Enclosure object commands provide information and perform actions related to a specific enclosure such as c0 e0 and its elements such as c0 e0 slot0 Enclosure object elements include slot fan and temperature sensor elements Note The command descriptions of this section show the syntax of enclosure commands for 9750 and 9690SA controllers which specify the controller ID and the enclosure ID For the 9650SE simply drop the prepended controller name in the command For example use e0 instead of c1 e0 The following table summarizes the supported controllers protocols configurations and enclosure elements Table 15 Enclosure protocol supported elements and syntax 9750 and Controller 9650SE 9690SA 2 Configuration Protocol CCU SAF TE SESIC SES 2 backplanes Syntax lex lex ex ex Slot Y Y Y Fan Y Y Y Enclosure Element Temp Sensor Y Y Y Supported Power Supply N Y Y Alarm N Y Y cx ex show
176. ttribute for the cx add command on page 56 Example localhost gt c0 u0 show rapidrecovery c1 u0 Rapid RAID Recovery policy setting disable cx ux show rebuildstatus 84 This command reports the rebuildstatus if any of the specified unit Example localhost gt c0 u5 show rebuildstatus cO u5 is not rebuilding its current state is OK If the unit is in the process of migrating the command will return the following localhost gt c0 u5 show rebuildstatus c0 u5 is not rebuilding its current state is MIGRATING 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Unit Object Commands cx ux show serial This feature only applies to 9000 series controllers This command reports the unique serial number of the specified unit Example localhost gt c0 u5 show serial c0 u5 Serial Number 12345678901234567890 cx ux show status This command reports the status of the specified unit Possible statuses include OK VERIFYING VERIFY PAUSED INITIALIZING INIT PAUSED REBUILDING REBUILD PAUSED DEGRADED MIGRATING MIGRATE PAUSED RECOVERY INOPERABLE and UNKNOWN Definitions of the unit statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 Example localhost gt c0 u0 show status c0 u5 status OK cx ux show storsave This feature only applies to 9750 model controllers and 9000 series SX SE SA model controllers This command re
177. tus verifystatus storsave 9000 series SX SE SA only rapidrecovery 9000 series SE SA volumes 9000 series ignoreECC 9000 series identify 9000 series SX SE SA only cx ux show all cx ux start rebuild disk lt p p gt ignoreECC cx ux start verify cx ux pause rebuild 7000 8000 only cx ux resume rebuild 7000 8000 only cx ux stop verify cx ux flush cx ux del noscan quiet cx ux set autoverify on off cx ux set cache on off quiet cx ux set wrcache on off quiet cx ux set rdcache basic intelligent off cx ux set identify on off 9000 series SX SE SA only cx ux set ignoreECC on off cx ux set qpolicy on off 9000 series SX SE SA only cx ux set name string 9000 series cx ux set rapidrecovery all rebuild disable quiet 9000 series SE SA only cx ux set storsave protect balance perform quiet 9000 series SX SE SA only cx ux migrate type RaidType disk p p group 3 4 5 6 7 8 9 10 11 12 13 14 15 16 stripe size noscan nocache autoverify 9000 series RaidType raid0 raidl raid5 raid6 9650SE and later only raidl0 raid50 single cx ux remove noscan quiet www si com channel products 79 Chapter 2 CLI Syntax Reference c x ux show 80 This command shows summary information about the specified unit ex ux If the unit consists of sub units as in the case of RAID 10 and RAID 50 then each sub unit
178. uitable to you and your application You will find further discussion of this setting in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 under About StorSave Profile Levels on page 119 www si com channel products 95 Chapter 2 CLI Syntax Reference protect provides the maximum data protection among the controller settings When storsave is set to protect mode it means e When the unit becomes degraded the write cache will be disabled e Write journaling is enabled All data flushing from controller cache will be flushed to media e Incoming FUA Force Unit Access host requests will be honored unless a BBU is installed and enabled in which case they will be ignored perform provides the maximum performance and least data protection of the three controller settings When storsave is set to perform mode it means e When the unit becomes degraded the write cache will not be disabled e Write journaling is disabled All data flushing from controller cache will be flushed to disk If a BBU is present this essentially disables the BBU for this unit e Incoming FUA Force Unit Access host requests will be honored If you set the storsave policy to perform a confirmation message will warn you that there could be data loss in the event of a power failure balance provides more data protection than perform mode but less data protection than protect mode and provides better performance than protec
179. unit the output of this command would not show DEGRADED as the command cx px show would Note also the difference that this command only shows the status of the drive it does not contain other information such as unit type size and so forth c x px show all This command shows the current setting for all port related attributes status model serial firmware capacity and smart Example for 9690SA and 9750 localhost gt c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 c3 p3 www si com channel products show all Status OK Model ST3750640AS Firmware Version 30DORGX6 Capacity 698 63 GB 1465149168 Blocks WWN 0000000000000000 Drive Type SATA Type Direct Drive Ports 1 3 AAK Serial Interfac Drive Connections 1 Link Speed Supported 1 5 Gbps Queuing Supported Enabled Reallocated Sectors 0 Power On Hours 268 36 C 7200 RPM N A N A 1 5 Gbps Link Speed Yes Queuing Yes Temperature Spindle Speed Identify Status Belongs to Unit Drive Smart Data 109 Chapter 2 CLI Syntax Reference cx px show 110 OA 00 01 OF 00 5E 59 B8 9A 24 OA 00 00 00 03 03 00 5E 5D 00 00 00 00 00 00 00 04 32 00 64 64 51 00 00 00 00 00 00 05 33 00 64 64 00 00 00 00 00 00 00 07 OF 00 4A 3E 88 3F 98 01 00 00 00 09 32
180. use this technique The first two drives are mirrored as a fault tolerant array using RAID 1 The third and fourth drives are mirrored as a second fault tolerant array using RAID 1 The two mirrored arrays are then grouped as a striped RAID 0 array using a two tier structure Higher data transfer rates are achieved by leveraging TwinStor and striping the arrays In addition RAID 10 arrays offer a higher degree of fault tolerance than RAID 1 and RAID 5 since the array can sustain multiple drive failures without data loss For example in a twelve drive RAID 10 array up to six drives can fail half of each mirrored pair and the array will continue to function Please note that if both halves of a mirrored pair in the RAID 10 array fail then all of the data will be lost 12 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Understanding RAID Levels and Concepts Figure 5 RAID 10 Configuration Example RAID 10 240 GB 120 GB 120 GB striped together RAID 1 RAID 1 120 GB 120 GB 240 GB 120 GB for mirror 240 GB 120 GB for mirror 120GB 120GB 120GB 120 GB RAID 50 is a combination of RAID 5 with RAID 0 This array type provides fault tolerance and high performance RAID 50 requires a minimum of six drives Several combinations are available with RAID 50 For example on a 12 port controller you can have a grouping of 3 4 or 6 drives A grouping of 3 means that the RAID 5 arrays used have 3 disks each four of these
181. vanced Verify y y 3 schedule schedule verify enable Schedule For more about setting up verify schedules see Setting Up a Verify Schedule on page 66 www si com channel products 91 Chapter 2 CLI Syntax Reference c x ux set cache on off quiet This command is the same as cx ux set wrcache onloff quiet Please see below for details cx ux set wrcache onloff quiet This command allows you to turn on or off the write cache for a specified unit ex ux This feature is supported on all controllers By default write cache is on Write cache includes the disk drive cache and controller cache When write cache is on data will be stored in 3ware controller cache and drive cache before the data is committed to disk This allows the system to process multiple write commands at the same time thus improving performance However when data is stored in cache it could be lost if a power failure occurs With a Battery Backup Unit BBU installed the data stored on the 3ware controller can be restored The following table shows the supported RAID types for write caching as a function of controller model and logical unit type N A Not Applicable refers to cases where the given logical unit type is not supported on a particular controller model Table 12 Supported RAID Types for Write Caching Model RO R1 R5 R6 R10 R50 Single Spare 7K 8K Yes Yes Yes N A Yes N A N A No
182. ve size localhost gt c2 add type raid0 disk 0 1 2 4 5 6 7 vol 2000 500 1024 700 Creating new unit on controller c2 Done The new unit is c2 u0 Setting default Command Queuing Policy for unit c2 u0 to on Done Setting write cache 0N for the new unit Done www si com channel products 61 Chapter 2 CLI Syntax Reference After the unit creation a subsequent show command for the unit shows the volume sizes localhost gt c2 u0 show Unit UnitType Status SRCmpl V I M Port Stripe Size GB u0 RAID 0 O 256K 6519 19 u0 0 DIS O S po a 931 312 u0 1 DIS O pl 931 312 u0 2 DIS O p2 931 312 u0 3 DIS O p4 931 312 u0 4 DIS O p5 S 931 312 u0 5 DIS O p6 931 312 u0 6 DIS O p7 931 312 u0 v0 Volume 2000 u0 vl Volume 500 u0 v2 Volume 1024 u0 v3 Volume 700 u0 v4 Volume E 1024 u0 v5 Volume 1024 u0 v6 Volume 247 188 cx rescan noscan This command instructs the controller to rescan all ports vports and phys and reconstitute all units The controller will update its list of disks and attempts to read every DCB Disk Configuration Block in order to re assemble its view and awareness of logical units Any newly found unit s or drive s will be listed noscan is used to not inform the operating system of the unit discovery The default is to inform the operating system commands Hot swap bays are
183. verify tasks will only be run during the time slots identified in the verify task schedule If a verify is taking place when the schedule is enabled it will be paused until the next scheduled time The priority of verify versus I O operations is specified with 5 where 5 is more resources and 1 the least Setting this value to 5 implies fastest verify and 1 implies fastest I O 5 fastest verify slowest I O 4 faster verify slower I O 3 balanced between verify and I O 2 faster I O slower verify 1 fastest I O slowest verify For 9550SX U and earlier controllers and for SE SA controllers running firmware 9 5 and 9 5 0 1 disabling verify with this command turns off the verify schedule In this case if a verify is manually started it should begin right away For 9750 controllers and 9690SA and 9650SE controllers running firmware 9 5 1 or later enabling verify with this command is equivalent to using the ex set verify advanced command while disabling verify with this command is equivalent to using the cx set verify basic command without specifying a preferred start day and time the default of Friday at midnight is used For more information see cx set verify advancedlbasicl1 5 on page 72 www si com channel products 71 Chapter 2 CLI Syntax Reference E Note If you want verifications to occur automatically when enabling the verify schedule you must also remember to enable the autoverify setting for
184. x show 80 Create a new unit cx add 56 Create a hot spare cx add 56 Enable disable unit write cache cx ux set cache 92 cx ux set wrcache Enable Basic or Intelligent read cx ux set rdcache 92 cache or disable both Set the queue policy cx ux set qpolicy 94 Set the rapid RAID recovery policy cx ux set rapidrecovery 95 Set the storsave profile cx ux set storsave 95 Unit Configuration Changes Change RAID level cx ux migrate 97 Change stripe size cx ux migrate 97 Expand unit capacity cx ux migrate 97 Delete a unit cx ux del 87 Remove a unit export cx ux remove 87 Name a unit cx ux set name 94 Controller Maintenance Tasks Update controller with new cx update 63 firmware Add a time slot to a rebuild cx add rebuild 64 schedule 19 www si com channel products Chapter 2 CLI Syntax Reference 20 Table 5 Common Tasks Mapped to CLI Commands Task CLI Command Page Controller Maintenance Tasks continued Add a time slot to a verify cx add verify 65 schedule Add a time slot to a selftest cx add selftest 67 schedule Enable disable the initialize cx set rebuild 69 rebuild migrate schedule and set the task rate Enable disable the verify schedule cx set verify 71 and set the task rate Set the verify schedule to cx set 72 advanced or basic verify advanced basic 1 5 Set the rebuild migrate task rate cx set rebuildrate 70 Set the rebuild migrate task mode cx
185. y ddd hh duration on page 65 cx set verify basic pref ddd hh on page 72 and see the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 0 www si com channel products 29 Chapter 2 CLI Syntax Reference update fw f ename_with_path force This command downloads the specified firmware image to the controllers that are compatible with it and iterates through all the controllers in the system updating the firmware For more information see cx update fw filename_with_path force on page 63 30 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Controller Object Commands Controller Object Commands Controller object commands provide information and perform actions related to a specific controller such as c0 For example you use controller object commands to see alarms specific to a controller to create schedules for when background tasks are run and to set policies for the controller You also use the controller object command cx add type to create RAID arrays only also apply to 9750 controllers 3 Note Features indicated as 9690SA only 9000 series or 9000 series SE SA Syntax CX show cx show attribute attribute where attributes are Cx Cx Cx eX FOX Cx Cx eX LEX Cx Cx EX CX CX achip allunitstatus autocarve 9000 series SX S E SA only autorebui
186. yed www Isi com channel products 111 Chapter 2 CLI Syntax Reference Example of histogram histdata To display a histogram of IOPs grouped together based on response time associated with the specified port use command cx px show dpmstat type histdata localhost gt c0 p3 show dpmstat type histdata Port Status Unit p3 OK u0 Bin Response Time ms IO Count 1 1 0 2 2 0 3 3 0 4 4 0 5 5 0 6 6 0 7 7 0 8 8 0 9 9 0 10 10 0 11 20 204 12 30 190 13 40 161 14 50 136 15 60 130 16 70 112 17 80 94 18 90 80 19 100 540 20 200 95 21 300 42 22 400 11 23 500 2 24 600 2 25 700 0 26 800 0 27 900 0 28 1000 0 29 2000 0 30 3000 0 31 4000 0 32 5000 0 33 6000 0 34 7000 0 35 8000 0 36 9000 0 37 10000 0 38 10000 0 112 3ware SATA SAS RAID Controller Card CLI Guide Version 10 0 Port Object Commands Note that in the example above there is a set of 38 Bins shown in the first column and each bin has associated with it a different Response Time category shown in the second column There are no commands with response times of 10 milliseconds or shorter and there are 204 commands with response times between 10 and 20 milliseconds bin 11 Each time that an I O or command sends to a drive the response time for that I O increments the bin associated with that response time cx px remove noscan quiet This command allows you to remove or export a port or drive ex px Exporting a
187. ystem is not on at that time verification will start the next time the system is powered on When the autoverify is on and the advanced verify schedule is used verify advanced autoverify will run during the times specified with the advanced schedule You can use the show verify command to display the existing schedule windows For more information about using basic or advanced verify see cx set verify advancedlbasicl1 5 on page 72 For all 9000 series controllers running pre 9 5 1 firmware auto verify allows the controller to run the verify function once every 24 hours If verify schedule windows are set up and enabled then the controller will only start an automatic verify task during the scheduled time slots If the verify takes longer than the schedule window the verify process will be paused and restarted during the next verify schedule window Table 11 Autoverify Behavior when enabled 9750 and 9650SE and 9550SX and 9650SE and 9690SA with earlier 9690SA with firmware 9 5 or 9 5 1 or later 9 5 0 1 Basic Verify Schedule Runs at weekly N A N A verify basic day and time Advanced Verify Follows Schedule Advanced Verify N A N A verify advanced Schedule Verify Schedule is Runs at weekly Huns at any Runs atany time as time as Disabled day and time i A determined by determined by verify disable Same as Basic e f firmware firmware verify Schedule is OS Follows verif Follows verif Enabled Ad

3ware® SATA+SAS RAID Controller Card CLI Guide, Version 10.0

Contents

Download Pdf Manuals

Related Search

Related Contents

3ware&reg; SATA+SAS RAID Controller Card CLI Guide, Version 10.0

Contents

Download Pdf Manuals

Related Search

Related Contents

3ware® SATA+SAS RAID Controller Card CLI Guide, Version 10.0