Home

LSI 3ware 9650SE-24M8

1. 0 0 ees 116 cx ex fanx set identify on off 0 eee 117 ex ex fanx set speed lt 0 7 gt 2 2 2 eee 117 x X PWISX SNOW cicle 117 cx ex pwrsx show identify 0 0 0 ete 118 cx ex pwrsx set identify on off 0 6 eee 118 CX 6XHOMPX SNOW ii A ka esa ee a lek ees hg AS 119 cx ex tempx show identify ooooocococcoccocoocn 119 cx ex tempx set identify on off 6 0 eee 119 lexiex alMx SNOW si gushes ad Bee ee din ee ee SE ee ees 120 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 cxlex almx set alarm mute unmuteloff 00 eee 120 cx ex update fw filename_with_path sep n force 121 cx ex show firmware ooooocccoco teens 121 Help Commands vercion oo kin aac eae te he E ge ee 122 Help with specific commands 000 cece ett 122 Help with attributes 0 0 eee cee eee nee 123 NOI iii Tue an ee ie a eee ee tae 124 help Tocus ick a eto lan oe Ae Ea Det 124 Help Show ss ia Stake teehee aS ees age nail delete em ieee ean E DEA 125 help fl ssige siesta A eid Gaeta ee ied ee 125 help resScaN Canos eet ee eee er as ek dw Fede Sue eae vote Ghee 125 help update vers ae aie kd excl A EN hock bated ait ad ae ett 125 help commit so a OV at ad oe A Ie Pe ee 125 A 25h 0 tated ee E eee le She ewan ao Mapes 125 help ex pAy Xe A A PCa aaa Rok oka ii 125 hele LUX ht Mt Eyed de oe 126 help CXPX sank kee neha eee we oe geek Ee poh hae din AE EE
2. 0 0 cette eee 76 cx ux show rebuildstatuS 0 eee tees 76 ex ux show senal oeroet ots A a A belts 76 exX UX SHOW SlatUS 200 2 ci dR ras di 76 ICXIUX show StorSave s ira apra ae aaa ee eee 77 cx ux show verifystatuS 6 0 tees 77 ICXIUX SHOW VOIUMES ooo 77 JOXIUX SMOW Alle occiso ob dd Gao a dade te edt at arian A 77 cx ux remove noscan quiet 0 e eee eee 78 cx ux del noscan quiet 0 0 eee 79 cx ux start rebuild disk lt p p gt ignoreECC 0 ee ee 79 Jex Ux start VOM Y 22 0 ant en a donee pdt ene om d 80 EX UX Stop Verify pita Pe he A oe ies A iS ai 80 CXX TUS Wy ii aca is cee Meee ene le wenn eer bea de aac 80 cx ux set autoverify on off 0 tees 81 cx ux set wrcache on off quiet 1 6 0 eee 81 cx ux set rdcache basiclintelligent off 0 2 eee eee 82 exfux setidentify on Off eso i eek eke A wade See ee tee 83 cx ux set ignoreECC onloff 1 eee 83 eX ux setname string 60 e eee eee ee 83 cx ux set qpolicy onloff 6 eee 84 cx ux set rapidrecovery all rebuild disable quiet 84 cx ux set storsave protect balance perform quiet 84 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 AUTOVIA A Ses ee 86 Port Object Commands 0 0 0 cece ttt eee eee 92 ICXIDX SNOW a FO SG Me TE aed VE Webel A ee 9
3. FH9X 5 11 00 008 cl Bios Version BE9X 5 11 00 002 cl Boot Loader Version BT9X 6 00 00 003 cl Serial Number C297BP269 cl PCB Version Rev 001 cl PCHIP Version B2 cl ACHIP Version 05000900 cl Controller Phys 8 cl Connections 23 of 128 cl Drives 23 of 128 cl Units 3 of 128 cl Active Drives 17 of 128 cl Active Units 3 of 32 cl Max Drives Per Unit 32 cl Total Optimal Units 3 cl Not Optimal Units 0 cl Disk Spinup Policy 1 cl Spinup Stagger Time Policy sec 1 cl Auto Carving Policy off cl Auto Carving Size 2048 GB cl Auto Rebuild Policy on cl Rebuild Mode Adaptive cl Rebuild Rate 1 42 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 cl Verify Mode cl Verify Rate cl Controller Bus Type cl Controller Bus Width cl Controller Bus Speed Unit UnitType u0 RAID 6 ul RAID 5 u2 RAID 1 VPort Status 0 u DO F WN FP OO Oo 0 0 UD SO TU U TO O o N o p21 p22 p23 p24 p25 p26 p27 p28 p29 p30 o O O OGO 0 0 OLO O 70 00 20 OO OF 0 0 0 Name OnlineState Adaptive 1 PCIe 8 lanes 2 5 Gbps lane Controller Object Commands Status RCmpl V I M Stripe Size GB Cache AVrfy OK 256K 1923 11 RiW ON OK 256K 167 588 RiW ON OK 65 1826 RiW ON Unit Size Type Phy Encl Slot Model u2 68 36 GB SAS c1 e0 s1t0 HITACHI HUS153073VL
4. If the policy is on the firmware selects 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 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 drive timeout error and for the controller to classify them as failed Enabling Autorebuild 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 www si com channel products 69 Chapter 2 CLI Syntax Reference disconnect a drive causing the controller to respond to it as a failed drive and then reconnect it the controller automatically tries 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 on Joff disk lt p p gt lal 70 The cx set autodetect command is associated with the staggered spinup feature when hot swapping drives When staggered spinup is enabled see command cx set spinup and cx set stagger during a reset or power on the controller spins up all detected drives with a delay between each spinup all
5. The cx ex tempx show identify command applies only to 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex The cx ex tempx show identify 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 blinks If the enclosure does not support Temperature Sensor Identify this command returns N A Example localhost gt c0 e0 templ show identify c0 e0 temp1l Identify status on cx ex tempx set identify onloff The cx ex tempx set identify command applies only to 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 www si com channel products 119 Chapter 2 CLI Syntax Reference cx ex almx show The cx ex almx show command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex almx show command shows information about the specified enclosure alarm The possible status values are OK FAIL N
6. Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 6 REBUILD VERIFY 50 A 70 P 256k 298 22 RiW OFF In the preceding example the RAID 6 unit u0 is in the Rebuild Verify state The rebuild is currently active at 50 percent complete while the verify is paused at 70 percent complete For the unit output 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 Bo p0 a 298 20 u0 1 DIS O A pl 298 20 u0 2 DIS O re p2 Eas 298 20 u0 3 DIS REBUILDING 80 p3 298 20 u0 4 DIS O p4 298 20 u0 5 DIS O a p5 298 20 u0 6 DIS O p6 298 20 u0 7 DIS O p7 298 20 u0 8 DIS REBUILD PAUSE 20 p8 298 20 u0 9 DIS O z p9 298 20 u0 10 DIS O p10 ms 298 20 u0 11 DIS O ES p11 298 20 In the preceding 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 Similar to the output of the cx show unitstatus command the top level unit status and percentage show the composite unit status and composite rebuild percentage www si com channel products 73 Chapter 2 CLI Syntax Reference cx ux show attribute attribute The cx ux show attribute command shows the current setting of one or more specified attributes If you
7. For more detail information see tw_cli s documentation The help focus command provides specific focus related help illustrating various ways to use the focus command See the section Shell Object Commands on page 25 for more information 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 help show help flush help rescan help update help commit help cx Help Commands The help show 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 25 for more information The help flush command provides specific flush related help illustrating various ways to use the flush command See the section Shell Object Commands on page 25 for more information The help rescan command provides specific rescan related help illustrating various ways to use the rescan command See the section Shell Object Commands on page 25 for more information The help update command provides specific update related help See Shell Object Commands on page 25 for more information The help commit command provides specific commit related help illustrating various ways to use the commit command See the section Shell Object Commands on page 25 for more information The help cx command provides specific controller ex related help illustrating various commands associated
8. The ex set autocarve command allows you to set the autocarve policy to on or off By default autocarve is off When the autocarve policy is set to on any unit larger than the carvesize is created or migrated into one or more carvesize volumes and a remaining 68 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands volume Each volume can then be treated as an individual disk with its own file system The default carvesize is 2 TB This command is useful for operating systems limited to 2 TB file systems For example using the 2 T B default carvesize a 3 T B unit is configured into one 2 TB volume and one 1 TB volume A 5 TB unit is configured into two 2 TB volumes and one 1 TB volume When autocarve 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 is not available Example localhost gt c0 set autocarve on Setting Autocarving Policy on c0 to on Done cx set carvesize lt 1024 32768 gt The ex set carvesize command allows you to set the carve size in GB This command works together with autocarve See cx set autocarve onloff above for details Example localhost gt cO set carvesize 2000 Setting Auto Carving Size on c0 to 2000 GB Done cx set autorebuild onloff The cx set autorebuild command turns the Autorebuild policy on or off By default autorebuild is on
9. or redundant protection of data Each type of RAID unit offers a different blend of these characteristics The following table summarizes RAID configuration types Table 2 RAID Configuration Types RAID Type Description RAID 0 Provides performance but no fault tolerance RAID 1 Provides fault tolerance and a read speed advantage over non RAID disks RAID 5 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 Provides a combination of striped and mirrored units for fault tolerance and high performance RAID 50 Provides a combination of RAID 5 and RAID 0 RAID 50 provides high fault tolerance and performance Single Disk Not a RAID type but supported as a configuration Provides maximum disk capacity with no redundancy You can create one or more units depending on the number of drives you install The following table provides possible configurations based on your number of drives Table 3 Possible Configurations Based on Number of Drives Pumper or Possible RAID Configurations Drives 1 Single disk 2 RAID 0 or RAID 1 16 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Understanding RAID Levels and Concepts T
10. 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 Example localhost gt cl show rebuildrate 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 Background tasks 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 seven 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 61 Selftest activity provides Self Monitoring Analysis and Reporting SMART Self tests are checked once each day by default 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 www si com channel products 49 Chapter
11. 00 00 00 02 00 01 00 00 00 00 00 00 00 C5 60 F4 00 00 30 00 00 00 00 00 00 00 0B 01 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 Example for SAS drive localhost gt c1 p2 show all www si com channel products 00 64 00 00 64 00 00 40 00 00 64 00 00 00 00 00 00 00 00 00 00 00 01 00 07 00 00 00 BC 00 00 00 03 64 00 09 64 00 BD 38 00 C5 64 00 CA 00 00 00 00 00 00 00 00 00 00 00 07 00 00 00 00 00 00 00 Port Object Commands N WwOO0OQwoguo BrP OON OF W ORR DN O 0 DO 0 00 Ow WS O 10 O O OO 0 WO E O O O O 0 0 0 OQ 0 Oe Or 0 01 00 70 O0 Or WD Q Q 97 Chapter 2 CLI Syntax Reference cx px show 98 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 cl p2 Status OK Model SEAGATE Firmware Version 3LCODB25 Capacity 34 18 GB 71687371 Blocks WWN 5000c500003ac760 Drive Type SAS Type Direct Drive Ports 2 ST936701SS 0002 Serial Interfac Drive Connections 1 Reallocated Sectors 0 Hours 0 44 deg C 10000 Link Speed Supported 3 0 Gbps Queuing Supported Queuing Enabled Identify Status Belongs to Unit Power On Temperatur RPM 1 5 Gbps and 3 0 Gbps Spindle Speed Link Speed Yes Yes N A N A dpmstat
12. 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 cx px show status cx px show 96 The cx px show shatus command shows 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 2 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 ux show on page 72 all The ex px show all command shows all port related attributes status model serial firmware capacity and SMART for SATA drives Example for SATA drive localhost gt c3 p3 show all c3 p3 Status OK c3 p3 Model ST3750640AS c3 p3 Firmware Version c3 p3 30DORGX6 c3 p3 Capacity 698 63 GB 1465149168 Blocks c3 p3 WWN 0000000000000000 c3 p3 Drive Type SATA 3 AAK Serial 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 c3 p3 Interface Type Direct c3 p3 Drive P
13. 2 Unit Object Commands cx ux show storsave The cx ux show storsave command shows the storsave policy on the unit For more information see cx ux set storsave protectlbalancelperform quiet on page 84 Example localhost gt c0 u5 show storsave c0 u5 Command Storsave Policy protect cx ux show verifystatus The cx ux show verifystatus command shows 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 cx ux show volumes cx ux show The cx ux show volumes command shows the number of volumes in the specified unit Normally there is one volume unless autocarving is enabled and or a boot volume was specified Example localhost gt c0 u0 show volumes c0 u0 volume s 1 all The ex ux show all command shows the current setting of all unit attributes Example localhost gt c0 ul show all c0 ul status OK c0 ul is not rebuilding 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 www si c
14. 2 CLI Syntax Reference The show selftest command shows 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 SMART 1 Sun 12 00am enabled 2 Mon 12 00am enabled S Tue 12 00am enabled 4 Wed 12 00am enabled 5 Thu 12 00am enabled 6 Fri 12 00am enabled 7 Sat 12 00am enabled cx show verify 50 3ware controllers support background tasks and allow you to schedule a regular time when they occur Verify is one of the supported background tasks and the ex show verify command shows you the current verify schedule The Verify Task Schedule can be either basic or advanced For details about the associated commands see cx set verify advancedibasicl1 5 on page 66 The basic Verify Task Schedule sets a single weekly day and time for verification to occur and is designed for use with the autoverification of units The advanced Verify Task Schedule provides more control with settings for a maximum of seven time periods or slots known as 1 through 7 For the advanced Verify Task Schedule up to seven time periods can be registered known as slots 1 through 7 You can manage this task schedule with a set of commands including add del show and set a task When you add a schedule you can set start day start hour and duration attributes R
15. 34 18 GB SAS c0 e0 slt0 HITACHI HUS151436VL p9 O ud 34 18 GB SAS c0 e0 slt1 HITACHI HUS151436VL p10 O u0 34 18 GB SAS s c0 e0 slt2 HITACH HUS151436VL p11 O u0 34 18 GB SAS c0 e0 s1t3 HITACH HUS151436VL p12 0 u0 34 18 GB SAS c0 e0 s1t4 HITACHI HUS151436VL p13 O u0 34 18 GB SAS c0 e0 s1t5 HITACH HUS151436VL p14 O u0 34 18 GB SAS gt c0 e0 s1t6 HITACH HUS151436VL p15 O u0 34 18 GB SAS c0 e0 s1t7 HITACH HUS151436VL p16 O u0 34 18 GB SAS c0 e0 s1t8 HITACH HUS151436VL p17 O u0 34 18 GB SAS c0 e0 slt9 HITACH HUS151436VL p18 O u0 34 18 GB SAS c0 e0 s1t10 HITACHI HUS151436VL p19 O u0 34 18 GB SAS c0 e0 s1t11 HITACHI HUS151436VL p20 O u0 34 18 GB SAS c0 e0 s1t12 HITACHI HUS151436VL p21 O u0 34 18 GB SAS c0 e0 s1t13 HITACHI HUS151436VL p22 O u0 34 18 GB SAS c0 e0 s1t14 HITACHI HUS151436VL p23 O u0 34 18 GB SAS c0 e0 s1t15 HITACHI HUS151436VL Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu On Yes OK OK OK LL 18 Mar 2010 If you then enable the rebuild schedules the unit initialization pauses until the next scheduled time slot as the following examples indicate localhost gt c0 set rebuild enable Enabling scheduled rebuilds on controller c0 Done localhost gt c0 show rebuild Rebuild Schedule for Controller c0 1 2 3 ran 4 ok E 5 en 6 Mon 1 00am 4 hr s enabled 7 Sun 12 00am 1 hr s enabled c0 show Unit UnitType Status SRCmpl V 1I M St
16. Auto phy4 oo 3 0 Auto phy5 s9 30 9 Auto phy6 500050e000000006 SAS c3 p6 53 0 3 0 Auto phy7 7 az 0 350 Auto www si com channel products 45 Chapter 2 CLI Syntax Reference cx show rebuild 46 Background tasks can be scheduled to run at times that are most convenient for your organization 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 seven time periods can be registered known as slots 1 through 7 You can manage each task schedule with 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 60 Rebuild activity attempts to re synchronize all members of redundant units such as RAID 1 RAID 10 RAID 5 RAID 6 and RAID 50 You can start a rebuild manually or it can start automatically if a spare has been defined Scheduled rebuilds occur during the scheduled time slot if 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 2 The
17. You can change the name after the unit has been created For more information see cx ux set name string on page 83 and cx ux show name on page 75 storsave protectlibalancelperform attribute allows you to set the storsave policy of the new unit For more information see cx ux set storsave protectlbalancelperform quiet on page 84 rapidrecovery alllrebuildldisable attribute specifies the Rapid RAID Recovery setting for the unit being created Rapid Raid Recovery can accelerate the rebuild process and it can accelerate initialize and verify tasks that might 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 the time required to complete these tasks remains unchanged Notes After the rapidrecovery policy has been disabled for a unit it cannot be E changed again There is some system overhead from setting rapidrecovery to all If you have a BBU you can set rapid recovery to rebuild because a BBU provides protection against data loss in the event of an unclean shutdown Rapid RAID Recovery is not supported over migration v0 n or vol a b c d can be used to divide the unit up into multiple volumes www si com channel products 55 Chapter 2 CLI Syntax Reference 56 v0 n can be used if you only want two volumes in which case v0 n is used to define t
18. a unit or hot spare cx add 53 Enable disable unit write cache cx ux set wrcache 81 82 Enable Basic or Intelligent read cx ux set rdcache 82 cache or disable both Set the queue policy cx ux set qpolicy 84 Set the rapid RAID recovery policy cx ux set rapidrecovery 84 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Common Tasks Mapped to CLI Commands Table 5 Common Tasks Mapped to CLI Commands Continued Task CLI Command Page Set the storsave profile cx ux set storsave 84 Unit Configuration Changes Change RAID level cx ux migrate 86 Change stripe size cx ux migrate 86 Expand unit capacity cx ux migrate 86 Delete a unit cx ux del 79 Remove a unit export cx ux remove 78 Name a unit cx ux set name 83 Unit Maintenance Tasks Start a rebuild cx ux start rebuild 79 Start a verify cx ux start verify 80 Stop verify cx ux stop verify 80 Enable disable autoverify cx ux set autoverify 81 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 101 Check if LED is set to on or off cx px show identify 94 View information for specific drive cx px show 92 View the status of specific drive cx px show status 95 Show statistics for the drive ona cx px show dpmstat 98 particular port type inst ra Ict histdata ext Clear stat
19. and Single logical units are examples of one tier units RAID 1 and RAID 5 are examples of two tier units and as such have subunits RAID 10 and RAID 50 are examples of three tier units and as such have sub subunits Port 3ware controller models prior to and including the 9650SE series have one or many ports typically 4 8 12 16 or 24 You can attach each port 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 22 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Syntax Overview 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 four or more 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 You can connect each controller phy directly to a single drive or you can connect it 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 connects directly to the controller or cascades through one or more expanders The VPort in essence is a handle in the software to uniquely i
20. and then terminate that shell the change reverts to the original condition If Bash ksh or sh use export TW_CLI_LOG 0FF or export TW_CLI_LOG 0N If csh C shell use setenv TW_CLI_LOG OFF or setenv TW_CLI_LOG ON 128 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Return Code not persistent across reboot because the the shell terminates when you power down the system and defaults are reset on powerup To set an environment variable that persists set a global variable in a login config file such as rc or cshrc that sets the variable to the desired state when the system powers up For details see the manpage for the shell you are using 3 Note Setting the environment variable according to the preceding description is For Windows Under Windows you set the environment variable through My Computer gt Properties 1 Click the Start button right click My Computer and choose Properties 2 Inthe Properties dialog box click 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 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 can e
21. c2 e0 slt10 MAXTOR ATLAS15K2_36 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands p18 0 u0 34 18 GB SAS c2 e1 s1t7 HITACHI HUS151436VL p19 O u0 34 18 GB SAS c2 e1 s1t8 HITACHI HUS151436VL p20 O u0 34 18 GB SAS c2 e1 s1t9 HITACHI HUS151436VL p21 0 u0 34 18 GB SAS c2 e1 s1t10 HITACHI HUS151436VL p22 0 u0 34 25 GB SAS c2 e0 slt11 MAXTOR ATLAS15K2_36 p23 0 u0 34 25 GB SAS c2 e0 s1t12 MAXTOR ATLAS15K2_36 p24 0 34 25 GB SAS c2 e0 slt13 MAXTOR ATLAS15K2_36 p25 0 34 25 GB SAS c2 e0 slt14 MAXTOR ATLAS15K2_36 p26 0 E 34 18 GB SAS 7 c2 e1 s1t11 HITACHI HUS151436VL p27 10 R 34 18 GB SAS c2 e1 s1t12 HITACHI HUS151436VL p28 0 z 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 s1t15 MAXTOR ATLAS15K2_36 p31 0 34 18 GB SAS z c2 e1 s1t15 HITACHI HUS151436VL cx show firmware The cx show firmware command shows the firmware version of controller cx Example localhost gt cO show firmware cO Firmware Version FE9X 3 03 06 X03 cx show memory The ex show memory command shows the available memory on the controller memory available is less than the controller actually has installed For example the Note Some memory is reserved for use by the controller so the amount of 9690SA controller has 512 MB of memory of which 448 MB is availab
22. cx px show attribute attribute The cx px show attribute command shows the current setting of the given attributes on the specified port or drive You can request one or many attributes If you specify an invalid attribute the loop terminates Possible attributes are capacity firmware identify lspeed model ncq serial smart SATA only and status cx px show capacity The cx px show capacity command shows the capacity of the drive attached to the specified port in two formats GB and blocks Note that the CLI shows capacity in GB that 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 The cx px show driveinfo command shows the following information about the drive for 9750 and 9690SA controllers Drive Type can be either SAS or SATA Interface Type can be either Direct or Enclosure The Interface Type indicates how the drive is connected to the controller Drive Ports indicates the number of physical ports on the drive SAS drives are usually dual ported while SATA drives have only one port Drive Connections indicates the number of connections from the controller to the drive There can be either one drive connection or two 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 Port
23. cx show rebuild command shows the current rebuild background task schedule as illustrated below localhost gt c0 show rebuild Rebuild Schedule for Controller c0 Slot Day Hour Duration Status 1 Mon 2 00pm 10 hr s disabled 2 Thu 7 00pm 18 hr s disabled 3 cm F disabled 4 disabled 5 disabled 6 Mon 1 00am 4 hr s disabled 7 Sun 12 00am FACS disabled A status of disabled indicates that the task schedule is disabled In this case the controller does not use the defined schedule timeslots If you start the command manually rebuilding starts within 10 to 15 minutes Otherwise it begins automatically if a rebuild is needed and a proper spare drive is set up or if the auto rebuild feature is turned on and a suitable unconfigured drive is available If the rebuild schedule is enabled while a rebuild process is underway the rebuild pauses until a scheduled time slot 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands Example for 9750 controller If a unit is in the initialization state at noon on Wednesday the rebuild schedule shown above is in use with schedules disabled and you use the show command you see the following status c0 show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 50 INITIALIZING 62 256K 469 246 RiW ON VPort Status Unit Size Type Phy Encl Slot Model p8 0 u0
24. drives is set by default as it provides the best of net capacity and performance For 15 disks you can group the disks into groups of 5 drives 3 drive groups make 5 subunits you can have a maximum of 4 subunits For 16 disks you can group the disks into groups of 4 or 8 drives 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 kilobytes KB Table 10 Supported Stripe Sizes RO R1 R5 R6 R10 R50 Single 16 N A 16 16 16 N A 64 N A 64 64 64 64 N A 256 N A 256 256 256 256 N A noscan attribute instructs the CLI not to notify the operating system of the creation of the new unit By default the CLI informs the operating system nocache attribute instructs the CLI to disable the write cache on the migrated unit Enabling write cache increases write performance but at the risk 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 do not set nocache unless there is a BBU or UPS installed 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 81 Migration Process In all cases of migration the background migration pro
25. enabled a storsave policy of balance is set a Rapid RAID Recovery policy of All is 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 warns you that without a BBU you could experience a Note By default write cache is enabled However if the controller does not have a possible loss of data in the event of a power failure Enabling write cache improves write performance greatly but you are at risk of losing data if a power failure occurs when data is still in the cache A recommended practice is to use a BBU and uninterruptible power supply 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 raid0 raid1 raid5 raid6 raid10 raid50 single and spare Example type raid5 Newly created units automatically receive a unique serial number In addition you can assign the unit a name Note You cannot change the unit s serial number disk p p consists of a list of ports or virtual ports disks to be used in the construction of the specified unit type You can specify one or more ports Indicate multiple ports by using a colon Indicate a range of ports by using a dash You can combine dashes and colons if appropriate For exampl
26. for a controller is similar to the following localhost gt show ctl Model V Ports Drives Units NotOpt RRate VRate BBU ep 9750 81 8 8 2 0 1 1 The output above indicates that Controller 0 is a 9750 81 with eight V ports eight drives detected two units both in optimal state with rebuild rate set to 1 and verify rate set to 1 This controller does not have a BBU attached Not Optimal refers to any state except OK and VERIFYING RRate also applies to initializing and migrating Definitions of the unit statuses are available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 Example for 9750 8e with an enclosure attached Typical output of the Show command for a system with an enclosure expander and a 9750 8e controller is similar to the following localhost gt show ctl Model V Ports Drives Units NotOpt RRate VRate BBU cl 9750 882 w a a ee Enclosure Slots Drives Fans TSUnits PSUnits Alarms fife a ee ee ee ee ee 2 The output above indicates that Controller 1 is a 9750 8e with 23 drives attached with 3 units in optimal state rebuild and verify rate set to 1 and with a BBU in normal and ready state show alarms reverse The show alarms command shows the controller alarms or events also known as Asynchronous Event Notification AEN messages of all controllers in the system The default is to list the most recent messages at the bottom The reverse attribute lists the most recent messag
27. forward slash specifies the root e object specifies the next level of the object www si com channel products 25 Chapter 2 CLI Syntax Reference commit flush rescan show 26 e 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 commit command sends a commit command to all 3ware controllers in the system For more information see cx commit on page 58 The flush command sends a flush command to all 3ware controllers in the system For more information see cx flush on page 58 The rescan command sends a rescan command to all 3ware controllers in the system For more information see cx rescan noscan on page 57 The show command shows a general summary of all detected controllers and enclosures The output of this command can vary depending upon your controller model and whether the system has an enclosure with an expander attached Note that the device drivers for the appropriate operating system must be loaded for the list to show all controllers 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Shell Object Commands Example for 9750 81 controller without an enclosure and expander Typical output of the Show command
28. 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 2 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 5is not task might never complete Use this setting with care Example localhost gt cl set verifymode lowlatency Setting Verify background task mode of cl to lowlatency Done Related commands cx show verifymode cx set verifyrate lt 1 5 gt cx show verifyrate cx set verifyrate lt 1 5 gt The cx set verifyrate 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 in the range of 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 1 fastest I O slowest verify Example localhost gt cl set verifyrate 2 Setting Verify background task rate on cl to 2 faster 1 0 Done www si com channel products 67 Chapter 2 CLI Syntax Reference Related commands cx show verifyra
29. lex SNOW diag ii e ea Dae ee ae hn ES eee whe BE ER eG 44 CX SHOW PV add a ve eis eee Ba eee ee eo deals 45 fox show rebuild icono yaw lade oa Vt a Pen ep e ee 46 cx show rebuildmode ooocccoccco eee 48 cx show rebuildrate 0 20 00 eee 49 OxSHOW SEIMEST caia ia der tahoe nt ahaa iia nar aisle Neng cies 49 1EX SHOW VETY oc A ee aE a eee 50 lex show verifymode e a a eee eens 51 ex show verifyrate 0 ee eee ees 52 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 nowrcache nordcache rdcachebasic autoverify noqpolicy ignoreECC name string storsave lt protect balance perform gt rapidrecovery all rebuild disable vO n Vol a b d iio A A AR ee id eee 53 fex rescan noscan edi ti 57 L CASIA LNA i EE to bh ees ae OE 58 MATE a E EE NAE TE E E E 58 cx update fw filename_with_path force oooooooomooorrooooo 58 cx add rebuild ddd hh duration oooooooocooooroor 59 cx add verify ddd hh duration oooooccoooocoo o 60 ex add selftest ddd tlh tita oDe a e e See ca 61 x delir build slotild tica ade ai dci 62 cx del very SlO id iii a A A ae ee les 62 cx del selftest slot_id ooooooccccocoooo eee 62 cx set dpmstat onloff 2 eee 62 cx set rebuild enable disable 1 5 20 2 0 eee 63 cx set rebuildmode lt adaptivellowlatency gt 2 cece eee 63 cx s
30. mode works with the rebuild task rate see cx show rebuildrate on page 49 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 The Low latency setting minimizes latency delay in reading data from a RAID unit by slowing the rebuild task process For some applications such as video server applications and audio applications use the Low latency setting 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 2 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands cx show rebuildrate The ex show rebuildrate 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 in the range of 1 5 where 5 denotes the setting of fastest background task and slowest I O as follows 5 fastest rebuild
31. on off 9000 series cx set carvesize lt 1024 32768 gt 9KSX SE SA only cx set rebuild enable disable lt 1 5 gt enable disable for 9000 series cx set rebuildmode lt adaptive lowlatency gt 9KSE SA only cx set rebuildrate lt 1 5 gt 9KSE SA only 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 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 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 rescan noscan localhost gt Help with attributes As you work with specific objects or commands you can also use the question mark character gt to get help For example If you type the command c0 show and then need help to determine specific attribute syntax you can type to get help as follows localhost gt c0 show cx show cx show attribute attribute where attribute is achiplallunitstatuslautocarve 9000 series www si com channel products 123 Chapter 2 CLI Syntax Reference help help focus 124 bios carvesize 9000series driver drivestatus firmware memory model monitor numdrives numports numunits c
32. set verify enable command or the cx set verify advanced to enable the schedule this enables all rebuild schedule slots 5 Use the cx ux set autoverify on command to turn on autoverify for each unit you want to follow the schedule verifies will not run during your verify task schedule even if you use the cx set verify basic command the cx set verify advanced command or the cx set verify enabled command to enable the verify schedule 3 Note If you do not enable autoverify for units or start a verification manually cx add selftest ddd hh The cx add selftest 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 fails if an empty task slot is not available In order to run at the specified times selftests must be enabled using the command cx set selftest enableldisable on page 68 Note Adding selftests to the schedule is different from adding slots to the rebuild and verify schedules Adding a selftest directly schedules the test and defines 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 sched
33. show pcb command shows the Printed Circuit Board PCB version of the specified controller cx Example localhost gt c0 show pcb c0 PCB Version RevX 40 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands cx show pchip The cx show pchip command shows the PCI Interface Chip PCHIP version of the specified controller cx Example localhost gt c0 show pchip c0 PCHIP Version 1 x cx show serial The cx show serial command shows the serial number of the specified controller cx Example localhost gt c0 show serial c0 Serial Number F12705A3240009 cx show spinup The cx show spinup command shows the number of concurrent SAS and SATA disks that spin up when the system is powered up after waiting for the number of seconds specified with the set stagger command Spinup does not work with SAS or SATA disks attached to an expander Example localhost gt c0 show spinup c0 Disk Spinup Policy 1 cx show stagger The cx show stagger command shows the time delay between each group of spinups at power up 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 cx show unitstatus The cx show unitstatus command presents a list of units currently managed by the specified controller cx and shows their types capacity status and unit policies Possible sta
34. spinup stagger cx show all where all means Attributes and configurations cx show diag cx show cx show rebuild 9000 series cx show rebuildmode 9KSE SA cx show rebuildrate 9KSE SA cx show verify 9000 series cx show verifymode 9KSE SA cx show verifyrate 9KSE SA cx show selftest 9000 series cx show phy 9750 and 9690SA only cx show dpmstat type lt inst ra ext gt 9000 series for type inst and type ra 9KSE SA for type ext cx 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 10 11 12 13 14 15 16 gt 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Help Commands 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 cx add rebuild ddd hh duration 9000 series cx add verify ddd hh duration 9000 series cx add selftest ddd hh 9000 series cx del rebuild slot_id 9000 series cx del verify slot_id 9000 series cx del selftest slot_id 9000 series cx set spinup nn 9000 series cx set stagger nn 9000 series cx set autocarve
35. 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 These configurations and the amount of memory in the system determine the amount of statistics data in the buffer These configuration settings cannot be changed at this time localhost gt cO show dmpstat Drive Performance Monitor Configuration for c0 Performance Monitor ON Version 1 Max commands for averaging 100 Max latency commands to save 10 Requested data Instantaneous Drive Statistics 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands Queue Xfer Resp Port Status Unit Depth TOPs Rate MB s Time ms po NOT PRESENT pl NOT PRESENT p2 OK 7 a 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 view 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 Max commands for averaging 100 Max latency commands to save 10 Requested data Running Average Drive Statist
36. the autoverify is on and the advanced verify schedule is used verify advanced autoverify runs during the times specified with the advanced schedule You can use the show verify command to show the existing schedule windows For more information about using basic or advanced verify see cx set verify advancedlbasicl1 5 on page 66 Table 8 Autoverify Behavior when enabled Command Setting Action Basic Verify Schedule Verity b sic Follows Basic Verify Schedule Advanced Verify Schedule verify advanced Follows Advanced Verify Schedule For more about setting up verify schedules see Setting Up a Verify Schedule on page 60 cx ux set wrcache on loff quiet The cx ux set wreache command allows you to turn on or off the write cache for a specified unit ex ux This command 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 is stored in both the 3ware controller cache and the 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 can be lost if a power failure occurs With a BBU installed the data stored on the 3ware controller can be restored The quiet attribute turns off interactive mode so that no confirmation is requested to proceed www si
37. typeSinst ra lct histdatalext The cx px show dpmstat type command allows you to request drive performance statistics of the specified type for the specified port These statistics can be helpful when troubleshooting related problems type specifies which statistics should be reported 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 The inst is a measure of a short duration average ra Running Average Running average is a measure of long term averages The measure smooths the data and results in older data 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 Force Unit Access FUA flush commands and a drive sectors s read write and write commands with FUA Ict Long Command Times The Ict is a collection of the commands with the longest read write response time histdata Histogram Data The histogram categorizes the read write execution times and groups 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 type instlralext on page 36 For more information see Drive Performance 3ware SATA SAS RAID Controller Card CLI Gu
38. u2 68 36 GB SAS c1 e0 sl1t1 HITACHI HUS153073VL 68 36 GB SAS c1 e0 s1t2 SEAGATE ST373455SS ra 68 36 GB SAS c1 e0 s1t3 SEAGATE ST373455SS ul 34 18 GB SAS c1 e0 s1t4 HITACH HUS151436VL ul 34 18 GB SAS c1 e0 sl1t5 HITACH HUS151436VL ul 34 18 GB SAS c1 e0 sl1t6 HITACH HUS151436VL ul 34 18 GB SAS c1 e0 s1t7 HITACHI HUS151436VL ul 34 18 GB SAS c1 e0 s1t8 HITACH HUS151436VL ul 34 18 GB SAS c1 e0 s1t9 HITACHI HUS151436VL 279 39 GB SAS c1 e0 s1t10 SEAGATE ST3300656SS 279 39 GB SAS c1 e0 s1t11 SEAGATE ST3300656SS 279 39 GB SAS c1 e0 s1t12 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t13 SEAGATE ST3300655SS 279 39 GB SAS c1 e0 slt14 FUJITSU MBA3300RC ud 279 39 GB SAS c1 e0 s1t16 SEAGATE ST3300655SS ud 279 39 GB SAS c1 e0 s1t17 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t18 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t19 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t20 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t21 SEAGATE ST3300655SS u0 279 39 GB SAS c1 e0 s1t22 SEAGATE ST3300655SS ud 279 39 GB SAS c1 e0 s1t23 SEAGATE ST3300655SS BBUReady Status Volt Temp Hours LastCapTest Yes OK OK OK 136 XX XXX XXXX cx show alarms reverse Asynchronous event notifications also referred to as AENs or controller alarms are originated by controller firmware or an SES attached enclosure and captured by the 3ware device drivers These events reflect warnings errors and or informative messages These event
39. with the controller ex See the section Controller Object Commands on page 30 for more information help c x phyx The help cx phy x command provides specific cx phyx related help illustrating various ways to use the cx phyx command See Phy Object Commands on page 102 www si com channel products 125 Chapter 2 CLI Syntax Reference help cx ux The help cx ux 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 71 for more information help cx px The help cx px command provides specific cx px related help illustrating various ways to use the cx px command See the section Port Object Commands on page 92 for more information help cx bbu The help cx bbu command provides specific ex bbu related help illustrating various ways to use the ex bbu command See the section BBU Object Commands on page 103 for more information help cx ex The help cx ex 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 109 for more information help c x ex slotx The help cx ex slotx 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 109 for mo
40. 00am 24 hr s on Example 2 Basic Verify Schedule When verify is set to basic the ex show verify command shows the basic verify schedule as illustrated below localhost gt cl show verify cl basic verify weekly preferred start Friday 12 00am cx show verifymode The cx show verifymode shows the current rebuild mode setting of the specified controller The verify mode has two settings Adaptive and Low latency Verify mode works with the verify task rate see cx show verifyrate on page 52 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 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 www si com channel products 51 52 Chapter 2 CLI Syntax Reference 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 2 Example localhost gt cl show verifymode cl Verify background task mode Low Latency Related commands cx set verifymode lt adaptivellowl
41. 12581808 WD WCANM1869003 p11 O u3 49 05 GB 2581808 WD WCANM1762464 3ware CLI gt c0 u3 show Unit UnitType Status RCmpl V I M Port Stripe Size GB u3 Migrator MIGRATING a 39 su3 RAID 1 O 49 00 su3 0 DISK O gt po S 49 00 su3 1 DISK O p7 5 49 00 su3 v0 Volume E 5 49 00 du3 RAID 10 O 16K 298 002 du3 0 RAID 1 O ZA du3 0 0 DISK O p5 49 00 du3 0 1 DISK O gt p7 49 00 du3 1 RAID 1 O a 3 du3 1 0 DISK O p10 49 00 du3 1 1 DISK O gt p11 49 00 du3 v0 Volume 49 00 Example of migrate output for Single to RAID 1 The migration path from RAID type Single to RAID 1 is a special case Because the single unit becomes 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 shows DEGRADED until the migration rebuild is complete For example below is a system with two migrating units cO u0 and c0 u1 Unit u0 is migrating from a RAID 10 to a RAID 0 unit while unit 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 90 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands Note the difference in UnitType and Status of u0 and ul even though they are both migrating units 3ware CLI gt c0 show Uni
42. 2 cx px show attribute attribute 2 0 ee 93 ex px ShOWw Capacity cie eich ew yes EE a eee a eae 93 eX pX Show OFIVSINTO Ceci o Bee be Gals Peels kale ees ES as 93 ICXIPX show firmware 0 0 0 eet ees 93 CXPX Show identify s isc cance ieee ae ae Mawes aay eda eee a 94 cxipx show Ispeed ooooooooooo ees 94 lX PX Show model ione a aot ok ha da neg ges Reece ao RE 94 CX PX SNOW NG eck pais ea Pek Ee Vid oe ede A ae da 94 www si com channel products v lex pXshow seral sred cer oi it A Yee he 95 eX pX Show MA ei noe a epee ae none 95 lex px Show Status n e a van ee dae ee eee Eee 96 CX p SHOW allis ss erie theck eG ek eek A Goes a dale hte 96 cx px show dpmstat type instlrallct histdatalext o o ooo oo 98 cxipx remove quiet cauca a le ee ie ae SaaS 101 cx px set identify onloff 0 teens 101 cx px set dpmstat clear type rallctlext oooooooomommmmm o 101 Phy Object Commands 0 0 0 cece cette 102 TCX PKV SNOW seccucs Se ee A A A ee AE 102 cx phyx set link auto 1 5 3 0 6 0 0 2 eee 103 BBU Object Commands 000 cette 103 FEXIDDUS SNOW cria A a Qe BM la ee 104 cx bbu show attribute attribute o on ee 104 CXIDDU SNOWIDAtINSt idas wc acid een a 104 cx bbu show bootloader 0 eee 105 GX BDU SNOW CAD ics Sor ent cd eee epee e ply een De un Baas 105 Jex bBu SNOW TW cs A id te ee es 105 cx Dbu show lastest is succes sca baie
43. 6 0 0 0 0 0 0 0 cx show drivestatus 38 The ex show drivestatus command shows 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 2 Example localhost gt c2 show drivestatus VPort Status Unit Size Type Phy Encl Slot odel po 0 u0 34 25 GB SAS a c2 e0 s1t0 AXTOR ATLAS15K2_36 pl O ud 34 25 GB SAS c2 e0 s1t1 AXTOR ATLAS15K2_36 p2 0 u0 34 25 GB SAS 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 slt2 HITACHI HUS151436VL p6 O u0 34 25 GB SAS c2 e0 sl1t3 AXTOR ATLAS15K2_36 p7 O u0 34 25 GB SAS c2 e0 slt4 AXTOR ATLAS15K2_36 p8 O u0 34 25 GB SAS S c2 e0 slt5 AXTOR ATLAS15K2_36 p9 O ud 34 25 GB SAS c2 e0 slt6 AXTOR ATLAS15K2_36 p10 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 u0 34 18 GB SAS c2 e1 s1t5 HITACHI HUS151436VL p13 O u0 34 18 GB SAS c2 e1 s1t6 HITACHI HUS151436VL p14 O u0 34 25 GB SAS c2 e0 s1t7 AXTOR ATLAS15K2_36 p15 0 u0 34 25 GB SAS a c2 e0 s1t8 AXTOR ATLAS15K2_36 p16 O u0 34 25 GB SAS c2 e0 s1t9 AXTOR ATLAS15K2_36 p17 0 u0 34 25 GB SAS
44. A SAS RAID Controller Card CLI Guide Version 10 2 Shell Object Commands Help Commands Help commands allow you to get help information for all commands and attributes For details see Help Commands on page 122 Shell Object Commands Shell object commands either apply to all the controllers in the system such as show rescan flush commit or they redirect the focused object Syntax focus object commit flush rescan show attribute modifier alarms reverse diag rebuild selftest ver verify update fw filename_with_path force focus Object The focus command is active in interactive mode only and is provided to reduce typing The focus command sets the specified object in focus and changes the prompt to reflect the specified object This allows you to type a command that applies to the specified object instead of typing 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 c0 u0 and you only have to type show The concept is similar to working in a particular location in a file system and requesting a listing of the current directory When you type the command focus object object can have the following forms e cx ux specifies the fully qualified Universal Resource Identifier URI of an object on controller cx unit ux e two trailing periods specifies one level up the parent object e a
45. C policy is set to off if a rebuild process encounters bad sectors on the source disk the rebuild fails When ignoreECC is set to on such errors are ignored and the rebuild continues When you use ignoreECC a recommended practice is to run a file system check following the rebuild to insure data integrity By default ignoreECC is off cx ux set namesstring El The cx ux set name command allows you to name the unit with an arbitrary name You can use this name with the unit serial number to cross reference with the unit The system does not check to ensure uniqueness of names so be sure 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 www si com channel products 83 Chapter 2 CLI Syntax Reference cx ux set qpolicy on off The cx ux set qpolicy command sets the queue policy for the drives on the unit If the queue policy is on the firmware utilizes the drive s queueing policy However the cx ux set qpolicy command has no effect on drives that do not support a queueing policy By default qpolicy is on This setting is only applicable for SATA drives that support native command queueing NCQ and has no effect on SAS units For spare drives drive queuing is not applicable Example localhost gt c0 u5 set qpolicy on Setting Command Queuing Policy for unit c0 u5 to on Done cx ux set rapidrecovery all rebui
46. CLI on page 6 e Understanding RAID Levels and Concepts on page 9 Features of the CLI You can use the 3ware CLI to manage 3ware RAID Controllers The CLI provides all the features and functions found in 3DM 2 but in command line format You can use the CLI in both interactive and batch modes providing higher level application programming interface API functionalities You can use the CLI to view and manage controller unit drive enclosure and Battery Backup Unit BBU For a summary of CLI capabilities see Common Tasks Mapped to CLI Commands on page 19 www si com channel products 1 Chapter 1 Introduction to the 3ware Command Line Interface Supported Operating Systems 3ware 9750 RAID controllers may be used with the following operating systems for Intel and AMD 32 bit and 64 bit x86 based motherboards e Microsoft Windows Server 2003 SP2 or newer and 2008 e Microsoft Windows Vista and Windows 7 e Red Hat Enterprise Linux e openSUSE Linux e SUSE Linux Enterprise Server e Fedora Core Linux e Other Linux distributions based on open source Linux 2 6 kernel e VMware e OpenSolaris e FreeBSD e Mac OS X Intel only For the latest supported operating systems see the current Release Notes at http w ww si com channel ChannelDownloads or the file versions txt available on the 3ware CD Installing the 3ware CLI This section section includes information about installing the 3ware CLI on
47. ID Controller Card CLI Guide Version 10 2 Understanding RAID Levels and Concepts Figure 6 RAID 50 Configuration Example RAID 50 480 GB 960 GB 480 GB for mirror AA RAID 5 RAID 5 480 GB 480 GB 600 GB 120 GB for parity 600 GB 120 GB for parity A E S 4 k f A2 2 parity D2 E2 5l A3 c3 3 parity E3 4 S ma BR A4 B4 4 parity A4 CA D4 4 parity xr __ xA _ xr A Blocks B Blocks C Blocks D Blocks E Blocks A Blocks B Blocks C Blocks D Blocks E Blocks Single Disk You can configure a single drive as a unit through 3ware software 3BM 3DM2 or CLD Similar to disks in other RAID configurations single disks contain 3ware Disk Control Block DCB information and the OS addresses them as available units Single drives are not fault tolerant and therefore are not recommended for high availability systems unless you take additional precautions to prevent system hangs and data loss www lsi com channel products 15 Chapter 1 Introduction to the 3ware Command Line Interface Hot Spare A hot spare is a single drive available online so that a redundant unit is automatically rebuilt without human intervention in case of drive failure Determining Which RAID Level to Use The type of RAID unit array that you create depends on your needs You might want to maximize speed of access total amount of storage
48. LI Guide Version 10 2 Unit Object Commands 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 can use this command as follows 1 Issue the command set autodetect off to disable automatic detection of the ports for staggered spinup 2 Remove the drives from the specified ports if the ports are not empty Insert or replace the drives at the ports specified 4 Issue the command set autodetect 0n to enable autodetect of the ports with the newly inserted drives The preceding steps spin up the newly inserted drives in a staggered manner Please note that the command takes longer for ports that do not have drives inserted since the controller allows time for the empty ports to respond Unit Object Commands Syntax Unit Object commands provide information and perform actions related to a specific unit such as co u1 unit 1 on controller 0 You can use unit object commands for a number of tasks for example to see the rebuild status verify status or initialize status of a unit to start stop and resume verifies to start and stop rebuilds to set policies for the unit and to perform other tasks related to the unit cx ux show cx ux show attribute attribute where attributes are autoverify initializestatus wrcache rdcache name apolicy rebuildstatus serial status verifystatus storsave rapidrecovery volumes ig
49. OT 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 and their descriptions are as follows 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 the visual indication remains Example localhost gt c0 e0 alm0 show Alarm Status State Audibility alm0 ACTIVATED ON UNMUTE cx ex almx set alarm mute unmuteloff The cx ex almx set alarm command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex almx set alarm command controls the audibility and state of the enclosure alarm It provides the ability to silence an activated alarm It also gives you the option to mute or unmute the alarm setting 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 sounds To silence the alarm you can either set the state of the alarm to off o
50. Object Commands Reboot the system so that the new firmware image takes effect Note The prom image number vary for different controllers Prom0006 img is for E the 9650SE prom0008 img is for the 9690SA and prom0011 img is for the 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 roll back if necessary 3 Close all applications Examining compatibility data from firmware image and c0 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 The force attribute is optional If you include it the warning message is suppressed as well as the prompt to proceed Compatibility checks are not bypassed If the image to be downloaded is not compatible an error message 1s shown If the image to be downloaded is compatible a message indicates the downloading of the image cx add rebuild ddd hh duration The cx add rebu
51. The cx show attribute command shows the current setting of the specified attributes on the specified controller You can specify one or many attributes If you specify an invalid attribute the loop terminates Possible attributes are achip allunitstatus autocarve autorebuild bios carvesize driver drivestatus firmware memory model monitor numdrives numports numunits ctlbus pcb pchip qpolicy serial spinup stagger and unitstatus Example To view the driver and firmware version installed on controller 0 type the following localhost gt c0 show driver firmware c0 Driver Version 2 x c0 Firmware Version FE9X 3 x In the sample output above x represents the actual version number www si com channel products 33 Chapter 2 CLI Syntax Reference cx show achip The cx show achip command shows the SAS SATA I O controller IOC version of the specified controller cx Example localhost gt c0 show achip c0 ACHIP Version 3 x cx show allunitstatus The cx show allunitstatus command presents a count of total and Not Optimal units managed by the specified controller cx Example localhost gt c0 show allunitstatus c0 Total Optimal Units 2 c0 Not Optimal Units 0 cx show autocarve The ex show autocarve command shows the Autocarve policy If the policy is on all newly created or migrated units larger than the carvesize are automatically carved into multiples of carvesize vo
52. Thu Fri or 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 fails if an empty task slot is not available 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 autoverify policy is enabled for your RAID units For more information see cx set verify basic pref ddd hh on page 66 3 Note This Verify Task Schedule is used when cx set verify advanced If you 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 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 a verify schedule follow this process 1 Use the ex show verify command to show the current schedule for verify tasks 60 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands 2 Use the ex del verify command to remove any of the scheduled tasks which do not match your desired schedule 3 Use the ex add verify command to create the verify schedule slots you want described above 4 Use the cx
53. UILD 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 2 Note An asterisk next to the status of a unit indicates there is an error on one of the drives in the unit This feature provides a diagnostic capability for potential problem drives The error might not be a repeated error and might be caused by an error correction code ECC error Smart Monitoring Analysis and Reporting SMART failure or a device error Rescanning the controller clears the drive error status if the condition no longer exists For controllers with read cache support the Cache column shows 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 82 This section lists the ports or virtual ports present and for each port specifies the port or vport number drive status unit affiliation drive type ph
54. Unit Object Commands Unit object commands provide information and perform actions related to a specific unit on a specific controller You can use unit object commands for a number of tasks for example to see the rebuild verify or initialize status of a unit to start or stop verifies to start rebuilds to set policies for the unit and to perform other tasks related to the unit You also use the controller object command cx ux migrate to change the configuration of a RAID array For details see Unit Object Commands on page 71 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 viewing the status model or serial number of the drive For details see Port Object Commands on page 92 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 103 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 3ware SAT
55. X SNOW pied eet aa Baa eee he a E E 32 cx show attribute attribute 0 eee 33 EX SHOW ACKID eset eg eh toed A ed Pa see tee E N 34 ex show allunitstatus coe sere ork ha ee ak Heda wee ee ew oat 34 ex show autocalve asai adi caa ahia KEGA AES E A TE eee es 34 ex show a toreb lld gt 00h cita oS Ae og ease iene sate Guan SoeG2 4 e 3d 34 JEX SNOW DIOS niiin he oe eee A te ee 35 www si com channel products iii eX SNOW GARVESIZE iii a Sate a A AA ee 35 OX SHOW GUDUS iia ci dosed anesh iaa 2 aie ty caoba Asie 35 Jex SNOW diver eoa eS A A Sa ada BBE 35 cx show dpmstat type inst rajext 0 0 2 eee 36 ICEX show drivestatuS lt situas er ccc 38 LOX SHOW firmware a a hoa eh og hae ae ers da ra Ace 39 TEX Show MeEMOry ooo 39 fox show model en r parieri ea a ee ee 39 ex ShOW MONITON ses ose et chee oe eg de ld 40 cx show numdriveS 0 0000 eee 40 CX SHOW NUMPOMIS sence o eee ee ee ON Hews Peewee eee 40 fox show NUMUNIS viii ee eae eee ee a ele eee 40 ICX SNOW POD irma malaa a a hanced Gale Os 40 ICEX SHOW PCHIP osc gag wend ae ee e kee Bete 41 CX SHOW Seal a a dad 41 cX SNOW SPINUP oct po rd e daa daa 41 LOS WEST ts Age male ote 41 cx show unitstatus aupa A o ca Da 41 IOX SMOW all harsh o a ds rd a a ide la a 42 cx show alarms reverse oooooocooocoocrr teens 43 cx show events reverse 0 0 0 cect teens 44 cx show AENS reverse 000 c eee eee 44
56. 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 3141516171819110111112113114115116 indicates the number of disks per group for a RAID 50 type You can only use this attribute when type raid50 Note that a RAID 50 is a multitier 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 16 For example group 3 indicates 3 disks of RAID 5 at the bottom layer of RAID 50 www si com channel products 87 Chapter 2 CLI Syntax Reference 88 Note You can have a maximum of four 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 creates two RAID 5 arrays With 12 disks specifying 3 creates four RAID 5 arrays under the RAID 0 level With only 6 disks a grouping of 6 is not allowed because you are basically 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 For 12 disks you can group the disks into groups of 3 4 or 6 drives the group of 4
57. able 3 Possible Configurations Based on Number of Drives Number of 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 RAID 6 RAID 5 with hot spare RAID 10 with hot spare Combination of RAID 0 RAID 1 hot spare single disk 6 or more RAID 6 RAID 6 with hot spare RAID 50 Combination of RAID 0 1 5 6 10 hot spare single disk Using Drive Capacity Efficiently Because the capacity of each drive is limited to the capacity of the smallest drive in the unit use drives of the same capacity in a unit The total unit capacity is defined as follows Table 4 Drive Capacity RAID Level Capacity Single Disk 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 www si com channel products Chapter 1 Introduction to the 3ware Command Line Interface Through drive coercion the capacity used for each
58. ace the battery Contact LSI to obtain a replacement battery cx bbu show all The cx bbu show all 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 Firmware Version BBU 2 00 00 023 c1 bbu Serial Number L319003B7460719 cl bbu BBU Ready Yes c1 bbu BBU Status OK c1 bbu Battery Voltage OK www si com channel products 107 Chapter 2 CLI Syntax Reference cx bbu test c1 bbu Battery Temperature Status OK cl bbu Battery Temperature Value 25 deg C c1 bbu Estimated Backup Capacity 241 Hours c1 bbu Last Capacity Test 22 Jun 2008 c1 bbu Battery Installation Date 20 Jun 2008 cl bbu Bootloader Version BBU 0 02 00 002 c1 bbu PCB Revision 65 quiet The cx bbu test command starts the battery capacity test The test can 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 After the test is completed successfully and the BBU status returns to OK the write cache is re enabled Note Once started the test can not be terminated before it completes Write cache cannot be enabled until the test completes Asynchronous Event Notification AEN messages are also generated by controllers to notify you of the command status You can
59. alhost gt c0 ul show Unit UnitType Status SRCmpl V I M VPort Stripe Size GB u RAID 0 O S 64K 3576 06 ul 0 DIS O po z 298 0 ul 1 DIS O a pl zi 298 0 ul 2 DIS O p2 298 0 ul 3 DIS O p3 298 0 ul 4 DIS O p4 298 0 ul 5 DIS O pos 298 0 ul 6 DIS O gt p6 298 0 ul 7 DIS O p7 2 98 50 ul 8 DIS O p8 298 0 ul 9 DIS O p9 298 0 ul1 10 DIS O p10 gt 298 0 ul 11 DIS O p11 298 0 ul vo Volume z 2047 00 ul vl Volume S 1529 06 One application of the ex ux show command is to determine which subunit of a degraded unit has caused the unit to degrade and which disk within that subunit is the source of degradation Another application is to determine the source and destination units during a migration The unit information shows the percentage completion of the processes associated with the unit with RComp l percent Rebuild completion and V I M percent Verifying Initializing or Migrating Unlike other unit types RAID 6 units have two parity drives and can tolerate up to two drive failures As a result an added notation is used to describe RCompl and V I M and these are A and P A denotes the percentage 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands completion of the active process and P denotes that the percentage completion of the paused process Example localhost gt c0 show unitstatus
60. 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 Figure 4 RAID 6 Configuration Example RAID 6 360 GB 600 GB 240 GB for 2 parity drives 120 GB 120 GB 120 GB 120 GB 120 GB gt gt DO D1 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 see Figure 5 A minimum of four drives are required to 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 www si com channel products 13 Chapter 1 Introduction to the 3ware Command Line Interface structure Higher data transfer rates are achieved by leveraging TwinStor technology and striping the arrays In addition RAID 10 arrays offer a higher degree of fault tolerance than RAID 1 and RAID 5 because the array can sustain multiple drive failures without data loss For example in a 12 drive RAID 10 array up to 6 drives can fail half of each mirrored pair and the array
61. apter 2 CLI Syntax Reference cx ex slotx set identify 0n off The cx ex slotx set identify command applies only to 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 causes the LED associated with that slot to blink Note This command is equivalent to cx px set identify onloff on page 101 Example localhost gt c0 e0 slot1l set identify on Setting Slot Identify c0 e0 slot0 to on Done cx ex fanx show The cx ex fanx show command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex fanx show command shows the information about the specified enclosure 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 indicates 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 116 The cx ex fanx show identify command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex fanx show identify command
62. 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 www si com channel products 23 Chapter 2 CLI Syntax Reference 24 Example When adding creating a unit to the controller by using the following command string cl add type raidl disk 0 1 c1 is the object add is the command type for type 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 Commands act on different objects for example shell objects controller objects unit objects and other objects Information about these commands is organized into sections about each object Shell Object Commands Shell object commands set the focus or provide information such as alarms diagnostics rebuild schedules and other functions about all controllers in the system For details see Shell Object Commands on page 25 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 viewing a list of alarms specific to a controller creating schedules during which background tasks are run and setting policies for the controller You can also use the controller object command ex add to create RAID arrays For details see Controller Object Commands on page 30
63. atency gt cx set verifyrate lt 1 5 gt cx show verifyrate cx show verifyrate The cx show verifyrate 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 in the range of 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 1 fastest I O slowest verify 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 ex show verifymode 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands cx add type lt RaidType gt disk lt p p gt I stripe ize noscan group lt 3 4 5 6 7 8 9 10 11 12 13 14 15 16 gt nowrcache nordcache rdcachebasic autoverify nogpolicy ignoreECC name string storsave lt protect balance perform gt rapidrecovery all rebuild disable vO n vol a b c d The cx add command allows you to create a unit on the specified controller You specify RAIDType disks and optional stripe size By default the new unit has the following options 256k stripe size autoverify is enabled write cache is enabled Intelligent read cache is
64. be root or have root privileges to install the CLI to usr sbin and to run the CLI Notes When copying the CLI it is best to copy it to a location that is in the environment path so you can run CLI without using the complete path i e usr sbin Otherwise you will have to type the complete path home user tw_cli Use the setup command from a command line For Linux a Navigate to one of the following directories on the 3ware CD packages installers tools linux b Type install sh i c Respond to each screen as the script walks you through the installation d After the installation is complete check that the software was installed correctly For FreeBSD a Navigate to the directory on the mounted image or CD that contains the installer packages installers tools freebsd b Type install sh i 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Installing the 3ware CLI Respond to each screen as the script walks you through the installation After the installation is complete check that the software was installed correctly For OpenSolaris a Navigate to the following directory on the 3ware CD packages installers tools OpenSolaris b Type setupSolaris_x86 bin Press Enter to begin installation d After the installation is complete check that the software was installed correctly For VMWare a Navigate to the following directory on the 3ware CD packages installers tools vmware esx40 b T
65. because you are basically creating a single RAID 5 unit 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 because 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 noscan attribute instructs the CLI not to notify the operating system of the creation of the new unit By default the CLI informs the operating system nowrcache attribute instructs the CLI to disable the write cache on the newly created unit By default the write cache is enabled for best performance If there is not a BBU or UPS installed you can avoid the possibility of data loss in the event of a power loss by setting nowrcache nordcache attribute instructs the CLI to disable the read cache on the newly created unit Enabling the read cache increases performance The rdcachebasic attribute instructs the CLI to set the read cache mode on the 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands newly created unit to Basic By default if you do not set a read cache attribute the read cac
66. build cx set autorebuild 69 e Set the autocarve volume size cx set carvesize 68 Enable disable drive cx set dpmstat 62 performance monitoring statistics dpmstat Controller Maintenance Tasks 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Chapter 2 CLI Syntax Reference 20 Table 5 Common Tasks Mapped to CLI Commands Continued Task CLI Command Page Update controller with new cx update 58 firmware Add a time slot to a rebuild cx add rebuild 59 schedule Add atime slot to a verify cx add verify 60 schedule Add a time slot to a selftest cx add selftest 61 schedule Enable disable the initialize cx set rebuild 63 rebuild migrate schedule and set the task rate Enable disable the verify schedule cx set verify 65 and set the task rate Set the verify schedule to cx set 66 advanced or basic verify advanced basic 1 5 Set the rebuild migrate task rate cx set rebuildrate 64 Set the rebuild migrate task mode cx set rebuildmode 63 Set the verify task rate cx set verifyrate 67 Set the verify task mode cx set verifymode 66 Set the basic verify start time and cx set verify basic pref ddd hh 66 day Enable disable the selftest cx set selftest 68 schedule View controller alarms errors cx show alarms 43 warnings messages cx show events cx show AENs Unit Configuration Tasks View information about a unit cx ux show 72 Create
67. butes You can specify one or many attributes If you specify an invalid attribute the loop terminates Possible attributes are controllers slots fans temp pwrs power supply and alms alarms cx ex show controllers The ex ex show controllers command applies only to 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 might not already be known The cx ex show controllers command lists the controller associated with enclosure cx ex Example localhost gt e0 show controllers e0 connects to controller c0 www Isi com channel products 111 Chapter 2 CLI Syntax Reference cx ex show diag helptext The ex ex show diag helptext command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex show diag helptext command allows you to view the enclosure diagnostic log What is reported by this log varies depending upon the manufacturer of the enclosure The enclosure diagnostic log might be requested by 3ware Customer Support to help troubleshoot problems on your enclosure cx ex show slots The cx ex show slots command applies only to 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex The cx ex show slots
68. ccur automatically when enabling the verify more information see cx ux set autoverify on Joff on page 81 You can view the verify schedule to be enabled or disabled with the command lex show verify on page 50 You can add verify task slots to the schedule by using the command cx add verify ddd hh duration on page 60 You can remove verify task slots from the schedule with the cx del verify slot_id on page 62 www si com channel products 65 Chapter 2 CLI Syntax Reference cx set verify advanced basic 1 5 The ex set verify advancedlbasicl1 5 command is effectively the same as the set verify enabledldisabled command Setting verify to advanced enables the advanced Verify Task Schedule which can include a series of up to seven 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 1 5 where 5 is more resources and 1 the least Setting this value to 1 invokes fastest I O and 5 invokes fastest verify For information on the verify schedule see cx add verify ddd hh duration on page 60 cx set verify basic pref ddd hh Using the verify basic option allows you to set a basic verify schedule that starts each we
69. cess must be completed before the newly sized unit is available for use You can continue using the original unit during this time When the migration is finished you must reboot if you are booted from the unit For secondary storage depending 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands on your operating system you might need to first unmount the unit then use CLI commands to remove and rescan the unit so that the operating system can determine the new capacity and then remount the unit For details see cx ux remove noscan quiet on page 78 and cx rescan noscan on page 57 If necessary you can resize the file system or add a new partition For instructions consult the documentation for your operating system unit Making physical changes to the unit during migration can cause the migration i Warning It is important to allow migration to complete before adding drives to the 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 requests that u3 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 Warning Make sure that no l O is pending and that the unit is unmounted before AN you split a mirror If the RAID 1 is the boot device you shou
70. 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 lists 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 The cx bbu enable command enables BBU detection on the controller If the BBU is Ready the controller utilizes BBU functionality in the event of a power failure cx bbu disable quiet 108 The cx bbu disable command disables BBU detection on the controller When disabled the controller ignores the existence of the BBU and shows that no BBU is installed even if a BBU is physically attached 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands Enclosure Object and Element Commands Syntax Enclosure object commands provide information and perform actions related to a specific enclosure such as c0 e0 and its elements for example c0 e0 slot0 Enclosure object elements include slot fan temperature sensor power supply and alarm 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 su
71. com channel products 81 Chapter 2 CLI Syntax Reference cx ux set rdcache basiclintelligentloff The cx ux set rdcache 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 Read Cache Basic Mode is used to store data that has been written recently to media and is likely to be frequently accessed to the read cache on the controller This improves read access times for applications such as a database that can take advantage of storage caching The read cache can 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 that is used to proactively retrieve data from media and store it locally on the controller so that it can be requested by the host For example the host might read blocks 1 2 and 3 With the read ahead caching included in IRP the controller also retrieves and holds blocks 4 5 and 6 in its cache in case the host requests the data 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 sequ
72. command shows the slots in enclosure cx 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 p1 Yes slot2 NO DEVICE No slot3 NO DEVICE No cx ex show fans The cx ex show fans command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex show fans command lists the fans in enclosure cx ex and shows their status as shown in the example below The Status column lists the status of each fan The State column indicates whether the fan is On or Off Speed is shown by two columns One shows the Step level and the other shows the RPM revolutions per minute There are seven speed levels 0 Off 1 Lowest 112 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands 2 Low 3 Medium low 4 Medium 5 Medium high 6 High 7 Highest The Identify column lists the Identify setting of the fans Example localhost gt c0 e0 show fans Speed Fan Status State Step RPM Identify fan0 OK ON 1 2670 Off fanl OK ON al 9370 Off fan2 OK ON 1 8540 Off
73. continues to function Note that if both halves of a mirrored pair in the RAID 10 array fail all of the data 1s lost 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 ae gt gt gt 120GB 120 GB 120GB 120 GB RAID 50 is a combination of RAID 5 and RAID O 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 three four or six drives A grouping of three means that the RAID 5 arrays used have three disks each four of these 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 four or eight 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 eight or six drives but not groups of four or three see Figure 6 In addition RAID 50 arrays offer a higher degree of fault tolerance than RAID 1 and RAID 5 because the array can sustain multiple drive failures without data loss For example in a 12 drive RAID 50 array one drive in each RAID 5 set can fail and the array continues to function Note that if two or more drives in a RAID 5 set fail all of the data is lost 3ware SATA SAS RA
74. d 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 The ex set verify command enables or disables the advanced Verify Task Schedule defined for controller ex and when enabled sets the priority of verification versus I O operations When the Verify Task Schedule is enabled verify tasks are only run during the time slots identified in the verify task schedule If a verify is taking place when the schedule is enabled it pauses until the next scheduled time The priority of verify versus I O operations is specified with 1 5 where 5 is more resources and 1 the least Setting this value to 5 invokes fastest verify and 1 invokes 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 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 66 schedule you must also enable the autoverify setting for the units to be verified For Note If you want verifications to o
75. dentify a drive The VPort ID or port ID allows a drive to be consistently identified used in a RAID unit and managed For dual port 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 portis used to indicate a drive it is implied that for the applicable controller series the reference also applies to VPort E Note For practical purposes port and VPort are used interchangeably in this For additional information about 3ware controller concepts and terminology refer to the user guide PDF for your 3ware RAID controller or the user guide portions of the 3ware HTML Bookshelf Syntax Overview The command syntax uses the general form Object Command Attributes Objects are shell commands controllers units ports drives battery backup units BBUs 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 The value of a boolean attribute is deduced by presence of a value for that attribute or the lack of a value 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
76. derstanding RAID Levels and Concepts 0 0c cece eee eee eee 9 RAID Concepts sucio oe Rade eld Ba hed heed 10 Available RAID Configurations 0 00 eect tees 11 Determining Which RAID Level to Use 0 0 cee eee 16 Using Drive Capacity Efficiently 0 0 eect 17 CLI Syntax Reference 00 cece eee eee 19 Common Tasks Mapped to CLI Commands 0000 0 cece eee eeeee 19 Terminology ht ti e Wid erate e ash ee goa ap eke gata 22 SYNtAXIOVENRVIOW gt Lead facets Geog Rog aa Es 23 Shell Object Commands 00 0 cette tees 25 focus Object vico E aed ws eae Pea Dae Bie Sie 25 COMME ci ds AA Ao de GS deve dee ets as tt neh al ek aa Re mae gone Pe 26 MSN a Mek Ore Baik ne vies GA Wee Rie ee 26 OCN heh wk ch ta A ede ele EM vide ad dd een ee 26 SNOW iio Beaten Gach Gatien A a Rae eke hate diene data 26 show alarms reverse 000 eee eens 27 show events reverse ooooocooocorro a rannnnn nananana 28 Show AENS reverse is s ccos 5 uc ete se hace aig es cake Ae ee ea ke ee 28 show diago r aaa A aii 28 SHOW rebuild st ee E ht oe Anns EOE bed ene oa E E AAEE ed 28 show selftest isc sci ra eet hee ee a eee Sh a Ye bu See ee 29 SHOW Ver gepi eee A sab iis Me nes ae ae eh ae Ee i ae oe 29 SHOW NMGMY eos atari Ses woe Gre ec poe leh Ok yale oO glen E a 29 update fw filename_with_path force 0 cee ee 30 Controller Object Commands 000 cece eee eee 30 IC
77. different controller and having the unit recognized as a unit You can attach the disks to different ports without harm to the data 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Understanding RAID Levels and Concepts 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 O 1 5 6 10 50 and Single Disk The following information explains the different RAID levels RAID 0 RAID 0 provides improved performance but no fault tolerance Because the data is striped 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 You can configure the stripe size 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 r
78. disk for the specified controller cx update fw filename_with_path force 58 The cx update command installs the specified firmware image to the corresponding controller Note Before issuing this command copy the firmware image to the system that contains your 3ware controller 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 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller
79. drate lt 1 5 gt set autorebuild on off set autodetect on off disk lt p p gt lall set verify enable disable 1 5 set verify advanced basic 1 5 set verifymode lt adaptive lowlatency gt set verifyrate lt 1 5 gt set verify basic pref ddd hh set selftest enable disable flush updat fw filename_with_path force commit Windows only Also known as shutdown rescan noscan www si com channel products 31 Chapter 2 CLI Syntax Reference cx show 32 The cx show command shows summary information on the specified controller cx This information is organized into a report containing two or three parts e A Unit summary section 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 units and for each one 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 autoverify policy status on off Possible unit statuses include OK RECOVERY INOPERABLE UNKNOWN DEGRADED INITIALIZING INIT PAUSED VERIFYING VERIFY PAUSED REBUILDING REB
80. drive is rounded down to improve the likelihood that you can use drives from differing manufactures 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 5 GB for drives over 45 GB For example a 44 3 GB drive is rounded down to 44 GB and a 123 GB drive is rounded down to 120 GB 3 Note All drives in a unit must be of the same type either SAS or SATA 18 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 2 CLI Syntax Reference This chapter provides detailed information about using the command syntax for the 3ware CLI Throughout this chapter the examples shown use the interactive mode of using the 3ware CLI Common Tasks Mapped to CLI Commands The table below lists many of the tasks that you can use to manage your RAID controllers and units and also 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 a controller cx show 32 View controller policies and other cx show attribute attribute 33 details View drive performance statistics cx show dpmstat 36 type inst ralext Set policies for a controller e Modify staggered spinup cx set stagger and cx set spinup 68 Enable disable autocarving cx set autocarve 68 Enable disable autore
81. ds show selftest show ver show verify The show selftest command shows all selftest schedules for the 3ware RAID controllers in the system Example localhost gt show selftest Selftest Schedule for Controller c0 Slot Day Hour SMART 1 Sun 12 00am enabled 2 Mon 12 00am enabled 3 Tue 12 00am enabled 4 Wed 12 00am enabled 5 Thu 12 00am enabled 6 Fri 12 00am enabled 7 Sat 12 00am enabled For additional information about selftest schedules see cx add selftest ddd hh on page 61 and refer to the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 The show ver command shows 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 Refer to the Release Notes for details The show verify command shows all verify schedules The output shows either the advanced or the basic verify schedule depending upon which schedule is enabled for each controller 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 www si com channel products 29 Chapter 2 CLI Syntax Reference Slot Day Hour Duration AdvVerify E Sun 12 00am 24 hr s on 2 Mon 12 00am 24 hr s on 3 Wed 4 00p
82. e disk 0 1 2 5 9 12 indicates port 0 1 2 through 5 inclusive 9 and 12 www si com channel products 53 Chapter 2 CLI Syntax Reference 54 stripe size consists of the stripe size to be used The following table illustrates the supported and applicable stripes on unit types Stripe size units are in KB 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 either migrating or recreating the unit Table 6 Supported Stripe Sizes KB RO R1 R5 R6 R10 R50 Single 16 N A 16 16 16 N A 64 64 64 64 64 256 256 256 256 256 group 3141516171819110111112 13114115116 indicates the number of disks per group for a RAID 50 type You can use this attribute only when type raid50 Note that a RAID 50 is a multitier 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 16 However no more than 4 RAID 5 subunits are allowed in a RAID 50 unit A sufficient number of disks are required for a given pattern or disk group For example given 6 disks specifying 3 creates 2 RAID 5 arrays With 12 disks specifying 3 creates 4 RAID 5 arrays under the RAID 0 level With only 6 disks a grouping of 6 is not allowed
83. e asked to supply this log file to the LSI technical support team 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 show it in Windows Explorer type c ProgramData in the location field at the top of the Explorer www si com channel products 127 Chapter 2 CLI Syntax Reference 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 the following location Documents and Settings All Users Application Data 3ware For Linux FreeBSD Mac OS and OpenSolaris The log file is in the following directory var log 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 FreeBSD Mac OS and OpenSolaris The command you use to set the environment variable depends on the type of shell Important To set the environment variable use the same shell you are using to AN run the CLI If you set it in a different shell window
84. e at the top To view this information for a specific controller see cx show alarms reverse on page 43 www si com channel products 27 Chapter 2 CLI Syntax Reference show events reverse The show events command is the same as show alarms reverse Please see above for details show AENSs reverse The show AENS command is the same as show alarms reverse Please see above for details show diag The show diag command shows the diagnostic information for all controllers in the system The enclosure diagnostic log might be requested by 3ware Customer Support to troubleshoot problems on your controller show rebuild The show rebuild command shows all rebuild schedules for the 3ware RAID controllers in the system Example localhost gt show rebuild Rebuild Schedule for Controller c0 slot Day Hour Duration Status 1 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 59 and refer to the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 28 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Shell Object Comman
85. e drive CLI returns an error This can be one way of Note 1 If the drive attached to the specified port is not present or if there are detecting whether a drive is present 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 OA 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 www si com channel products 95 Chapter 2 CLI Syntax Reference 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 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 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
86. easurement provides a short duration average ra Running Average Running average is a measure of long term averages that even out the data which results in older measurement 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 Force Unit Access FUA 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 see cx px show dpmstat type instlrallctlhistdatalext on page 98 You can turn Drive Performance Monitoring on and off using the command cx set dpmstat onloff on page 62 Example of inst drive statistics To view a summary of instantaneous data for the set of drives attached to the controller use command cx show dpmstat Because inst is the default you do not have to explicitly type it in the command Because 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 98 In the configuration information shown 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
87. ebuilds migrations and initializations follow similar schedule formats For details about setting up a schedule for verify tasks see Setting Up a Verify Schedule on page 60 For details about setting a basic verify schedule see cx set verify basic pref ddd hh 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 If any parity mismatches are found the array is automatically background initialized RAID 10 and 50 are composite types and follow their respective array types Nonredundant units such as RAID 0 and single are also verified verified by 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands doing a media scan and reporting an unreadable sectors For information about the initialization process see the user guide that came with your 3ware RAID controller Example 1 Advanced Verify Schedule When verify is enabled and set to advanced the show verify command shows the scheduling as follow localhost gt cl show verify Verify Schedule for Controller cl Verify Schedule for Controller cl slot Day Hour Duration AdvVerify 1 Sun 12 00am 24 hr s on 2 Mon 12 00am 24 hr s on 3 Tue 12 00am 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
88. ecommended for high availability systems unless you take additional precautions to prevent system hangs and data loss Figure 1 RAID 0 Configuration Example RAID 0 480 GB 64K Stripe olola 120GB 120GB 120GB 120GB RAID 1 RAID 1 provides fault tolerance and a speed advantage over non RAID disks RAID 1 also is 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 drive fails Fault tolerance is a basic requirement for critical systems should as web and database servers 3ware firmware uses a patented TwinStor technology on RAID 1 arrays for improved performance during sequential read operations With TwinStor www lsi com channel products 11 Chapter 1 Introduction to the 3ware Command Line Interface technology read performance during a sequential read operation is twice the speed of a single drive The adaptive algorithms in TwinStor technology boost performance by distinguishing between random read request and sequential read requests For the sequential read requests generated when accessing large files both drives are used with the drive heads simultaneously reading alternating sections of the file For the smaller random transactions the data is read by a single optimal drive head Figure 2 RAID 1 Conf
89. ecovery policy for the specified unit This policy can be all rebuild or disable For information about the policy settings see the description about the rapidrecovery attribute for the ex add command here on page 53 Example localhost gt c0 u0 show rapidrecovery c1 u0 Rapid RAID Recovery policy setting disable cx ux show rebuildstatus The cx ux show rebuildstatus command shows the rebuildstatus if any of the specified unit Example localhost gt c0 u5 show rebuildstatus c0 u5 is not rebuilding its current state is OK Tf the unit is in the process of migrating the command returns the following localhost gt c0 u5 show rebuildstatus c0 u5 is not rebuilding its current state is MIGRATING cx ux show serial The ex ux show serial command shows the unique serial number of the specified unit Example localhost gt c0 u5 show serial c0 u5 Serial Number 12345678901234567890 cx ux show status The cx ux show status command shows 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 2 Example localhost gt c0 u0 show status c0 u5 status OK 76 3ware SATA SAS RAID Controller Card CLI Guide Version 10
90. eek ete gels a SA ow aces Sa aOR 105 CX DOU SNOW PCD wes create oie eels be eee Oe a Shak ees 105 cx bbu show Serial 0 0 0 ett 105 eX BP SHOW status ci ir wth eae ie tie wees Ae RG 106 x bbu SHOW temp i e es ete Oe a ee A IGA e ae 107 cx bbu show tempstat 0 cette 107 cx bbu show tempval 0 cect teens 107 exibbu show Volts ss i a Pea ees ee ae Ba Pes Dan PAE eS 107 ex DDuU SMOW alloen i a Rakes Ear steed a aed ph heed andl bed 107 ex bbu test quiet isc is ais pace oe wets a ed Po Pa aE ponds 108 ex bbu enable cto aoe e A ee 108 ex obu disable quiet 00 eee eee 108 Enclosure Object and Element Commands 0 0 cece eee eee eee 109 lX eX SNOW irrin T Maer E ie Oe ees ata wc AL eg ee 110 cx ex show attribute attribute 2 6 eee 111 cxfex show controllers oooooooomoooorornr inara rrarena 111 cx ex show diag helptext 0 cee eee 112 CXIE X SNOW SIONS osc Soy Faye eee eK a Yodo ee id 112 ex 6x SHOW TANS ci aie oe fee E aw eels hd ee ee 112 IX SNOW TOM io a ede bee ee ened e ng gta 113 CXE X SHOW PWIS ties ccs bid iaa 114 iexlex show alar MS oia a pa ee eee ie Ree ES 114 dex Solis spend cheeses A e 115 LA AE A Gul dant Gy dolandeg eet lee gettin gress 115 cx ex slotx show identify 0 2 0 0 cee eee ee 115 cx ex slotx set identify onloff 0 2 eee 116 x ex tanx SNOW ci cael cds Hee ee A EE DS 116 ex ex fanx show identify
91. ek 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 autoverify policy for RAID units to insure that a verification of the unit occurs on a regular basis 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 66 The ex set verifymode command sets the verify mode The verify mode has two settings Adaptive and Low Latency Verify mode works with the verify task rate see cx set verifyrate lt 1 5 gt on page 67 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 both host I O and verify tasks 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands When a verify background task is active if the task rate is set to a fast verify rate i e low I O rate the system latency increases and performance can be negatively affected especially for applications such as video server applications and audio applications The Low Latency setting minimizes the latency delay in reading data
92. ential 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 queue depth of the host 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 with larger queue depths in multiple read only or mixed read write stream environments The performance improvements can be expected for most RAID types regardless of the unit s operating state normal degraded and so forth Example localhost gt c0 u0 set rdcache basic Setting Read Cache Policy on c0 u0 to basic Done 82 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands cx ux set identify 0n Joff This command requires a supported enclosure For additional information about enclosure related commands see Enclosure Object and Element Commands on page 109 The cx ux set identify 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 cx ux set ignoreECC 0n Joff The cx ux set ignoreECC command allows you to set the ignoreECC policy for a given unit When ignoreEC
93. ery capacity was last measured on 01 Apr 2010 The battery typically lasts 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 is shown after the command localhost gt c0 bbu show Error CLI 053 Battery Backup Unit is not present cx obu show attribute attribute The cx bbu show attribute command shows the current setting of one or more of the given attributes on the BBU board You can specify one or many attributes If you specify an invalid attribute the loop terminates Possible attributes are batinst bootloader cap fw lasttest pcb ready status serial temp volt cx bbu show batinst 104 The cx bbu show batinst command shows the date when the current battery was installed 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 BBU Object Commands cx bbu show bootloader The cx bbu show bootloader command shows the BBU s boot loader version Note that the BBU bootloader version is not applicable for 9750 models cx bbu show cap The cx bbu show cap command shows the battery capacity in hours estimate of battery capacity and to determine whe
94. et rebuildrates lt 1 O gt 255008 cing Gig td Ge bapa ee 64 cx set verify enable disable 1 5 020 000 ee 65 cx set verify advanced basic 1 5 2 0 cette 66 cx set verify basic pref ddd hh ooo 66 cx set verifymode lt adaptivellowlatency gt 00 e eee eee eee 66 cx set verifyrate lt 1 5 gt nna oni oa ees 67 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 cx set selftest enable disable o ooooocoocccoroor ee 68 TEX SCUSPINUPSNNS e rt pasadas aaa 68 ICXSOLSIAQGSISNN ii A A A ee ee ee ee a 68 ex set autocarve On Olt szi nes ear aca easel E ede Sec lla ies 68 cx set carvesize lt 1024 32768 gt 0 eee 69 cx set autorebuild onloff 2 0 ete 69 cx set autodetect on off disk lt p p gt lall ooooooooommommooooo o 70 Unit Object Commands 00 teen ae 71 ICH USA Wise Be RE Ee eed eae eile se 72 cx ux show attribute attribute 2 6 eee 74 ICXIUX show autoverify 6 ees 74 ICXIUX show wrcache Tam cu eee eens 74 TOXIUX SNOWSOCACN OY ici a a yeh BMS Paar Ed Pewee eee E 74 cxfux show identify 0 0 0 0 eens 74 ex ux Show ignore ECG asics ahs ee tes hee aes ule pad a Atha Aaa eee 75 cx ux show initializestatus 2 6 tee 75 X UX SHOW NAME gt wis ee aie ed fale hose ea goa eae ee 75 ex ux shOw Qpolicy coc ce aoe ee eb ie ee ee ee A 75 Ox UX SHOW parity rita Seca ed cde hated ate Loins e 75 cx ux show rapidrecovery
95. etting minimizes the latency delay in reading data from the RAID unit by slowing 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 2 recommended when I O is active because in that case the rebuild as a i Important Setting rebuildmode to low latency and rebuildrate to 5 is not background task might never complete Use this setting 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 The cx set rebuildrate 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 in the range of 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 2 faster I O slower rebuild 1 fastest I O slowest rebuild 64 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands Example localhost gt cl set rebuildrate 2 Setting Rebuil
96. fan3 OK ON 1 2810 Off fan4 OK ON 1 9240 Off fan5 OK ON 1 8330 off cx ex show temp The ex ex show temp command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The ex ex show temp command lists the temperature sensors in enclosure ex ex and the current temperature 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 lists the temperature at the sensors and the Identify column lists the Identify setting of the temperature sensors Example localhost gt c0 e0 show temp TempSensor Status Temperature Identify tempo 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 www si com channel products 113 Chapter 2 CLI Syntax Reference cx ex show pwrs The ex ex show pwrs command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The ex ex show pwrs command shows a summary of power supplies with their respective information for the specified enclosure The PowerSupply column lists the IDs of the po
97. for SAS and SATA drives are auto 1 5 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 you must reboot the system for the new link speed to take effect BBU Object Commands Syntax E Battery Backup Unit BBU 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 controllers on which a BBU is actually installed Note The BBU firmware version and bootloader version do not apply for 9750 controller models cx bbu show www si com channel products 103 Chapter 2 CLI Syntax Reference 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 cx bbu test quiet Warning Can take up to 24 hours to complete Write cache will be disabled during the test cx bbu enable cx bbu disable quiet cx bbu show E The cx bbu show 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 Apr 2010 The command output indicates that the batt
98. ght Notice 2010 LSI Corporation All rights reserved Trademark Acknowledgments LSI the LSI logo design 3ware 3DM 3DM2 StorSwitch and TwinStor StorSave and StreamFusion are trademarks or registered trademarks of LSI Corporation Apple the Apple logo Mac OS and Macintosh are trademarks of Apple Computer Inc registered in the United States and or other countries Sun Solaris and OpenSolaris are trademarks or registered trademarks of Sun Microsystems Inc in the U S and other countries All other brand and product names may be trademarks of their respective companies Table of Contents Chapter 1 Chapter 2 About this CLI Guide cion da viii Introduction to the 3ware Command Line Interface 1 Features ofthe Gila rst dt A e A A ee 1 Supported Operating Systems ococcccccccoc 2 Installing the 3ware CLI oooooccccoccccoco eee 2 Installing the 3ware CLI on Windows 0 0 e eee eee eee 2 Installing the 3ware CLI on Linux FreeBSD OpenSolaris and VMWare 3 Installing the 3ware CLI on Mac OS X eects 6 Working with 3ware CLI 0 0 eet 6 Using the command interface interactively 00 cee eee eee 7 Using a single command with output 0 ee ee 7 Using an input file to execute a script 00000 eee 8 Outputting the CLI to a Text File 0 2 0 0 0c ect eens 9 CONVENtiONS 3 26 A eo ee ee Oe eee ae 9 Un
99. he mode is set to Intelligent For more information see cx ux set rdcache basiclintelligentloff on page 82 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 81 Autoverify is set to on by default for a new unit noqpolicy attribute instructs the CLI to disable the drive command queuing on the newly created unit The default is for the qpolicy to be on in other words noqpolicy is not specified When drive command queuing is disabled the performance of a unit might be degraded For a spare unit drive queuing 1s not used so the noqpolicy cannot be set During unit creation specifying noqpolicy for a spare returns an error If the spare unit is used to rebuild a degraded unit the spare unit adopts the qpolicy of the degraded unit For more about drive queuing see cx ux show qpolicy on page 75 and cx ux set qpolicy onloff on page 84 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 83 IgnoreECC applies only to redundant units RAID 1 5 6 10 and 50 name string attribute allows you to name the new unit The string can be up to 21 characters and cannot contain spaces To use reserved characters lt gt amp etc put double quotes around the name string
100. he size of the first volume and the second volume uses 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 Use values that are positive integers 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 is left uncarved Both v0 n or vol a b c d work with autocarving if that feature is enabled When autocarving is used v0 n and vol a b c d are used to specify the size of the first few volumes after which the autocarve size is used for additional volumes For more about autocarving see cx set autocarve onloff on page 68 and cx set carvesize lt 1024 32768 gt on page 69 Note If the total size of the specified volumes up to four exceeds the size of the unit the volumes that exceeded the array s size boundary are not 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 c0 u0 Setting write cache 0N 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 sizes localhost gt c0 u0 show Unit UnitType Status SRCmp
101. hile the system is online 78 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands cx ux del noscan quiet The cx ux del 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 eliminates the Disk Configuration Block DCB metadata After you delete a unit ports or disks associated with the unit become part of the free pool of managed disks Warning This is a destructive command and you must use it with care If you AN execute this command all data on the specified unit is lost noscan is used to prevent informing the operating system of this change The default is to inform the operating system quiet is used for noninteractive mode Confirmation statements are suppressed and the command is executed immediately Using the quiet mode is useful for scripting purposes Example of interactive mode Nocalhost gt c0 u0 del Deleting c0 u0 will cause the data on the unit to be permanently lost Do you want to continue Y N N cx ux start rebuild disk lt p p gt ignoreECC The cx ux start rebuild command allows you to rebuild a degraded unit by using the specified disk p Rebuild applies only to redundant arrays such as RAID 1 RAID 5 RAID 6 RAID 10 and RAID 50 During rebuild bad sectors on the source disk cause the rebuild to fail RAID 6 arrays are less susceptible to failing since two cop
102. ics Queue Xfer Resp Port Status Unit Depth TOPs Rate MB s Time ms pO NOT PRESENT F pl NOT PRESENT p2 OK 7 p3 OK ud 0 435 25 249 2 p4 OK ul 0 366 21 630 3 p5 OK a 5 p6 NOT PRESENT s a a a p7 NOT PRESENT i gt Example of extended drive statistics ext To view 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 ext Extended Drive Statistics for c3 Sectors Commands Port Read Write Write FUA Read Write Write FUA Flush po 28704384 0 28704384 28704448 0 0 0 p2 28704384 28704448 0 0 0 0 0 p3 28704704 0 0 0 0 0 0 www si com channel products 37 Chapter 2 CLI Syntax Reference p 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 HHHHHHP as shown in the example below If overflow occurs you might want to return the counters to zero by using the clear command cx px set dpmstat clear type rallctlext on page 101 Example of drive statistics overflow localhost gt c3 show dpmstat type ext Extended Drive Statistics for c3 Sectors Commands Port Read Write Write FUA Read Write Write FUA Flush po O 158838656 158838720 0 0 0 p2 PARRA FHHEEHEHE FREER EEE HEHEHE FREER EE FREER EEE HEHEHE HH p3 HARE O 0 0 0 0 0 p
103. ide Version 10 2 Port Object Commands Monitoring in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 Example of running average RA statistics localhost gt c0 p3 show dpmstat type ra Queue Xfer Resp Port Status Unit Depth IOPs Rate MB s Time ms p3 OK u0 0 435 25 249 2 Example of long command times LCT statistics 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 shown Example of histogram histdata To
104. ies of the data exist You can allow the operation to continue by using ignoreECC The rebuild process is a background task and changes 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 before starting the rebuild See the command cx px remove quiet on page 101 for details Also see the command cx rescan noscan on page 57 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 subunit is degraded www si com channel products 79 Chapter 2 CLI Syntax Reference When you issue this command the specified rebuild begins if the rebuild schedule is disabled otherwise the rebuild pauses until the next scheduled rebuild A file system check is recommended following rebuild when using the ignoreECC option cx ux start verify Also referred to as a manual verify the ex ux start verify command starts a background verification process on the specified unit cx ux When you issue this command the specified unit begins verification if the verify schedule is basic or disabled otherwise it pauses until the next scheduled verify timeslot on the advanced schedule If verify basic or is disabled verification of the s
105. iguration Example RAID 1 120 GB 240 GB 120 GB for mirror CA a 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 method avoids throughput loss due to contention for the parity drive RAID 5 can tolerate one drive failure in the unit Figure 3 RAID 5 Configuration Example RAID 5 360 GB 480 GB 120 GB for parity c3 w A Blocks B Blocks C Blocks D Blocks 12 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Understanding RAID Levels and Concepts RAID 6 RAID 6 provides greater redundancy and fault tolerance than RAID 5 It is similar to RAID 5 but instead of a single block RAID 6 has two blocks of parity information P Q distributed across all the drives of a unit see Figure 4 Due to the two parities a RAID 6 unit can tolerate two hard drives failing simultaneously This also means that a RAID 6 unit can be in two different states at the same time For example one subunit can be degraded while another is rebuilding or one subunit can be initializing while
106. ild command adds a new task slot to the Rebuild Task Schedule on the day ddd where ddd is Sun Mon Tue Wed Thu Fri or 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 fails if an empty task slot is not 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 www si com channel products 59 Chapter 2 CLI Syntax Reference Setting Up a Rebuild Schedule Setting up a rebuild schedule requires several steps and several different CLI commands in addition to cx add rebuild To set up the rebuild schedule follow this process 1 Use the cx show rebuild command to show the current schedule for rebuild tasks 2 If any of the scheduled tasks do not match your desired schedule use the cx del rebuild command to remove them 3 Use the ex add rebuild command to create the rebuild schedule slots you want described above 4 Use the ex set rebuild enable command to enable the schedule this enables all rebuild schedule slots cx add verify ddd hh duration The ex add verify command adds a new task slot to the Verify Task Schedule on the day ddd where ddd is Sun Mon Tue Wed
107. is for a 12 port controller uses a text file called config_unit text that contains three commands This example sets up a 12 port controller with two units one with the first two drives mirrored and another with the remaining drives in a RAID 5 array The last command then prints the configurations for verification The following commands are included in the script file cO add type raidl disk 0 1 c0 add type raid5 disk 2 11 c0 show To run either of the scripts type tw_cli f config_unit txt 8 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Understanding RAID Levels and Concepts Outputting the CLI to a Text File You can send the output of the 3ware CLI including errors to a text file by adding 2 gt amp 1 to the end of the line Outputting to a text file can be useful for example if 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 81 Conventions The following conventions are used throughout this guide e In text monospace font is used for code and for things you type e 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 c
108. istics counters for a cx px set dpmstat clear 101 particular drive type ra Ict ext PHY Tasks View details about link speed fora cx phyx show 102 specified phy Set the link speed for a specified cx phyx set link auto 1 5 3 0 6 0 103 phy BBU Tasks 21 www si com channel products Chapter 2 CLI Syntax Reference Table 5 Common Tasks Mapped to CLI Commands Continued Task CLI Command Page Check on charge and condition of cx bbu show status 106 battery Start a test of the battery cx bbu test quiet 108 Enclosure Tasks View information about an cx ex show 110 enclosure and its components Locate a drive slot in an enclosure cx ex slotx set identify 116 by blinking an LED Locate a fan in an enclosure by cx ex fanx set identify 117 blinking an LED Set the speed for a fan in an cx ex fanx set speed 117 enclosure Locate a power supply in an cx ex pwrsx set identify 118 enclosure by blinking an LED Locate a temperature sensor inan cx ex tempx set identify 119 enclosure by blinking an LED Turn off or mute an audible alarm cx ex almx set alarm 120 in an enclosure Terminology 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 uses the following terminology Logical Units This term is 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
109. it 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Port Object Commands cx px show serial The cx px show serial command shows 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 The cx px show smart command extracts SMART data from a specified SATA disk This command will output drive attributes in hex format without any decoding For additional information please refer to AT Attachment standard Because the data is extracted directly from the disk you can use this command to get the most recent data about a disk The cx px show smart command is currently only available for SATA drives For SAS drives limited attribute data is available through the commands listed below Since the SMARTA data is not decoded you can use the commands below to get important drive status in a more meaningful way For both SATA and SAS drives you can get information with regard to temperature spindle speed reallocated sectors and power on hours e cx px show temperature e cx px show spindlespd e cx px show rasect e cx px show pohrs You can also use cx px show all to retrieve all of the drive attributes cabling problems affecting th
110. ives numports numunits pcb pchip serial spinup stagger unitstatus cx show all where all means attributes and configurations cx show diag cx show alarms reverse cx show events reverse cx show AENS reverse cx show rebuild 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Cx JOX Cx JOX Cx JEX Cx CX CX CX CX ex FOX Cx FEX Cx Cx ex Cx Cx Cx Cx Cx Cx Cx Cx Cx ex Cx Cx Cx JEX Vox JOX Controller Object Commands how rebuildmode how rebuildrate how verify how verifymode how verifyrate how selftest how phy 9750 and 9690SA only T ur TO a Nn DW add type lt RaidType gt RaidType raid0O raidl raid5 raid6 raidl10 raid50 single spare disk lt p p gt stripe lt Stripe gt noscan nocache nowrcache nordcache rdcachebasic group lt 3 4 5 6 7 8 9 10 11 12 13 14 15 16 gt autoverify noqpolicy ignorECC name string rapidrecovery all rebuild disable vO n vol a b c d n size of first volume in GB storsave lt protect balance perform gt add rebuild ddd hh duration add verify ddd hh duration add selftest ddd hh del rebuild slot_id del verify slot_id del selftest slot_id set dpmstat on off set spinup nn set stagger nn set autocarve on off set carvesize 1024 32768 set rebuild enable disable 1 5 set rebuildmode lt adaptive lowlatency gt set rebuil
111. k 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 Address Type Device Supported Enabled Control phy0 500050e000030232 ENCL N A 30 0 3 0 Auto phyl 500050e000030232 ENCL N A 0 30 Auto phy2 500050e000030232 ENCL N A 23 20 3 0 Auto phy3 500050e000030232 ENCL N A 3 0 3 0 Auto phy4 500050e000030236 ENCL N A Pau 3 0 Auto phy5 500050e000030236 ENCL N A 3 5 0 3 0 Auto phy6 500050e000030236 ENCL N A 300 3 0 Auto phy7 500050e000030236 ENCL N A 5 3 0 3 0 Auto In the previous example for phy1 the link speeds supported are 1 5 Gb s and 3 0 Gb s 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 is used Note that if SAS 2 0 is used with a 9750 controller the link speeds can be up to 6 0 Gb s Example of 9690SA 8I with direct attached drives localhost gt c3 show phy Device gt Link Speed Gbps Phy SAS Address Type Device Supported Enabled Limit phy0 500050e000000002 SATA c3 p0 30 300 Auto phyl 500050e000000002 SATA c3 p1 5 30 3 0 Auto phy2 500050e000000002 SATA c3 p2 153a 3 0 Auto phy3 500050e000000002 SATA c3 p3 30 3 0
112. l V I M VPort Stripe Size GB u0 RAID 5 OK 256K 1117 56 u0 0 DISK OK a p2 a 372519 u0 1 DISK OK a p3 s 372 519 u0 2 DISK OK p4 372 519 u0 3 DISK OK E p5 372 519 u0 v0 Volume 10 u0 vl Volume 1107 56 Example of RAID 0 unit created with volume sizes set to 2000 500 1024 and 700 GB The example below combines autocarving and vol a b c d Notice that the last volume u0 v5 is odd sized 247 188 GB 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands Volumes 0 through 3 are carved using the first four sizes as specified Volumes 4 5 and 6 are the autocarved volumes 1024 GB each Volume 6 is the remainder of the carve 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 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 a po 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 a p5 931 312 u0 5 DIS O p6 931 312 u0 6 DIS O p7 931 312 ud v0 Volume 2000 u0 vl Volume 5 500 u0 v2 V
113. l number is not catried over to the new unit The new destination unit has its own serial number In this case the disk specifier of the migration command disk p p must not be included in the command because the source drives are the destination drives Specifying more drives with the disk option returns 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 into two Single units 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands capacity as the existing one You can migrate a four drive RAID 5 unit to a four drive RAID 0 but you cannot migrate a four drive RAID 0 unit to a four drive RAID 5 unless you add another drive due to the need for additional storage capacity for parity bits 3 Note You can only migrate a unit to a RAID level that has the same or more The following table illustrates valid migration paths Table 9 Valid Migration Paths Source Destination R6 R10 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 destination unit You can specify one or more ports You can specify Multiple ports by using
114. ld boot from a different 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 Example of migrate output The following is an example of how the CLI shows migrating units In this example the report indicates that c0 u3 is a migrating unit with 39 percent completion The report also indicates that Source Unit suo is type RAID 1 and Destination Unit duo is type RAID 10 www si com channel products 89 Chapter 2 CLI Syntax Reference 3ware CLI gt c0 show Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 RAID 5 OK 5 64K 596 004 RiW OFF u2 SPARE OK gt 149 042 OFF u3 Migrator MIGRATING 39 5 149 001 RiW OFF VPort Status Unit Size Blocks Serial pO 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 WCANM1882472 p6 O u0 49 05 GB 312581808 WD WCANM1883862 p7 O u3 49 05 GB 312581808 WD WCANM1778008 p8 O al 49 05 GB 312581808 WD WCANM1770998 p9 NOT PRESENT lt p10 O u3 49 05 GB 3
115. ld disable quiet The cx ux set rapidrecovery command sets the Rapid RAID Recovery policy for the specified redundant unit Rapid Raid Recovery can accelerate both the rebuild process and the initialize and verify tasks that can 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 the time required to complete these tasks remains unchanged There is some system overhead from setting rapidrecovery to all If you have a BBU you can set rapid recovery to rebuild because a BBU provides protection against data loss in the event of an unclean shutdown When this attribute is set the policy remains in effect unless it is changed or disabled for the unit Note If the setting is disabled it cannot be changed for the unit at a later time The quiet option is provided for scripting purposes and applies only to the disable option cx ux set rapidrecovery disable quiet 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 The cx ux set storsave command sets the storsave policy to either protect balance or perform when the unit write cache is enabled The default setting is balance when a BBU is installed and protect when a BBU is not installed The storsave po
116. le Example localhost gt c2 show memory c2 Available Memory 448MB cx show model The cx show model command shows the controller model of controller cx Example localhost gt c0 show model c0 Model 9690SA 8E www si com channel products 39 Chapter 2 CLI Syntax Reference cx show monitor The cx show monitor command shows the monitor firmware boot loader version of controller cx Example localhost gt c0 show monitor cO Monitor Version BLDR 2 x cx show numdrives The cx show numdrives command shows the number of drives currently managed by the specified controller cx This report does not include logically removed or exported drives Example localhost gt c0 show numdrives cO Number of Drives 5 ex show numports The cx show numports command shows the total number of physical connections made to the controller and the maximum connections 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 The cx show numunits command shows the number of units currently managed by the specified controller cx This report does not include off line units or removed units Example localhost gt c0 show numunits cO Number of Units 1 cx show pcb The cx
117. le localhost gt c1 e0 show firmware c1 e0 SEP 0 Firmware Version 90 00 03 15 www si com channel products 121 Chapter 2 CLI Syntax Reference Help Commands The Help commands provides brief on line help You can get overview help by typing Help at the top level prompt This lists a brief definition of commands For an example see the discussion of the command help on page 124 You can also get help with specific commands by typing help before an object name or by typing a question mark at the point in a command where you are uncertain of the attributes Help with specific commands 122 If you type the help command at the top level you are considered to be working in the Shell Object and the help command provides help on the Shell commands focus show flush rescan and commit Using the help command on objects such as ex ex ux ex px cx bbu ex ex slotx ex fanx and ex tempx shows all possible subcommands associated with the object For example Help on the controller object ex lists all the subcommands associated with the controller cx as follows localhost gt help cx cx show cx 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 pcb pchip serial
118. licy adjusts several factors that control the balance between protection and performance on a unit There is a trade off among the available 84 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands settings The following description about the settings can help you to decide which one is suitable to your application For more information refer to the discussion of this setting in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 under About StorSave Profile Levels protect provides the maximum data protection among the controller settings When storsave is set to protect mode it means the following e When the unit becomes degraded the write cache is disabled e Write journaling is enabled All data flushing from controller cache is flushed to media e Incoming Force Unit Access FUA host requests are honored unless a BBU is installed and enabled in which case they are ignored perform provides the maximum performance and least data protection of the three controller settings When storsave is set to perform mode it means the following e When the unit becomes degraded the write cache is not disabled e Write journaling is disabled All data flushing from controller cache is flushed to disk If a BBU is present specifying perform as the storsave setting essentially disables the BBU for this unit e Incoming FUA host requests are honored If you set the storsave po
119. licy to perform a confirmation message warns 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 protect mode but lower performance than perform mode When storsave is set to the balance mode it means the following e When the unit becomes degraded the write cache is not 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 is flushed to media if a BBU is installed and enabled Otherwise data is flushed to disk only e Incoming FUA host requests are honored unless a BBU is installed and enabled in which case they are ignored quiet is used for noninteractive mode Confirmation statements are suppressed and the command is executed immediately Using quiet 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 2 Example localhost gt c0 u5 set storsave protect Setting Command Storsave Policy for unit c0 u5 to protect Done www si com channel products 85 Chapter 2 CLI Syntax Reference 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 86 The ex ux migrate command all
120. list 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 www si com channel products 99 Chapter 2 CLI Syntax Reference 6 6 0 7 y 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 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 ms or less and there are 204 commands with response times between 10 ms and 20 ms 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 100 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Port Object Commands cx px remove quiet The cx px remove command allows you to remove or export a port or drive cx px The command instructs the firmware to remove the specified port from its po
121. lumes plus one remainder volume You can treat each volume as an individual drive with its own file system The default carvesize is 2 TB For more information see cx show memory on page 39 For operating systems that support units larger than 2 TB do not 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 best to keep the policy on unless your operating system supports disks larger than 2 TB When the Autocarve policy is off all newly created units consist of one single volume Example localhost gt c0 show autocarve c0 Autocarving Policy on cx show autorebuild 34 The ex show autorebuild command shows the Autorebuild policy If you enable the policy the firmware selects drives to use for rebuilding a degraded unit by using the following priority order For more information see cx set autorebuild onloff on page 69 1 Smallest usable spare 2 Smallest usable unconfigured available drive 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 cx show bios Controller Object Commands 3 Smallest usable failed drive If the policy is disabled only spare drives are used for an automatic rebuild operation Example localhost gt c0 show autorebuild c0 Auto Rebuild Policy on The ex show bios command shows the BIOS version of controller cx Example localhost gt c0 show bios c0 BIOS Ve
122. m 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 verify ddd hh duration on page 60 cx set verify basic pref ddd hh on page 66 and refer to the discussion of background tasks and schedules in 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 update fw filename with path force The update fw command downloads the specified firmware image to the controllers that are compatible with the firmware image 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 58 Controller Object Commands Syntax 30 Controller object commands provide information and perform actions related to a specific controller such as c0 For example you use controller object commands to view a list of 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 cx show cx show attribute attribute where attributes are achip allunitstatus autocarve autorebuild bios carvesize ctlbus dpmstat type inst ra ext driver drivestatus firmware memory model monitor numdr
123. mmarizes the supported controllers protocols configurations and enclosure elements Table 11 Enclosure protocol syntax and supported elements 9750 and Controller 9650SE 9690SA 2 Configuration Protocol ccu sAF TE SESC SES 2 backplanes Syntax lex lex Icxlex Slot Y Y Y Fan Y Y Y Enclosure Temperature Element Kaia y y Y Supported Power Supply N Y Y Alarm N Y Y cx ex show 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 www si com channel products 109 Chapter 2 CLI Syntax Reference cx ex show 110 cx ex fanx set identify on off 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 un 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 The ex ex show command applies to 9750 and 9690SA controllers For the 9650SE and CCU enclosure simply drop the prepended controller name in the command and use ex The ex ex show 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 consi
124. mpleted without detection of a BBU error and the BBU status changes to WeakBat or OK the write cache is re enabled If a Fault Failed or Error occurs during the test the write cache remains in the disabled state until you resolve the problem Charging The BBU is currently charging the battery The BBU automatically starts charging whenever necessary During charging the BBU is not capable of backup operation and the write cache might be disabled depending on the unit s Storsave setting After the test is completed successfully and the BBU status changes to OK the write cache is re enabled If a FAULT or ERROR occurs during the test the write cache remains in the disabled state until you resolve the problem Fault A battery fault is detected The BBU is not capable of backup operation and the write cache might be disabled depending on the unit s Storsave setting To re enable write cache replace the battery and or the BBU board as soon as possible Error A BBU error is detected The BBU is not capable of backup operation and the write cache might be disabled depending on the unit s Storsave setting To re enable write cache replace the battery and or the Battery Backup Unit as soon as possible Failed The battery failed a test In this state the BBU is not capable of backup operation and the write cache is disabled To re enable write cache replace the battery and or the BBU as soon as possible WeakBat The BBU is functi
125. mula oa peak ARIA 126 help Cx DDU cise eit ae ba hoe Poet ee eoet BES Pea en Gide oA eed 126 A AR teen ees Ree a Wad obi alte AAS lade pal eceacd wees 126 help COSO its teks a vet ne sob eal da 126 help ex ex fanx reiri nee P ae Peed eer ede ee E 126 help cx extempore ir a ia 127 help ICAO PWISX cti Pe dee dde 127 help cx ex almx oia ri a de A ene ob oa Bayes 127 Command Logging asaan aaaea 127 Location of the Log File eines ee iain eet eed kee ee fs 127 Disabling and enabling command logging cece eee eee eee 128 Return A A e eS re hae ad AIRETA COE wenn i 129 www si com channel products vii About this CLI Guide This manual the 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 provides instructions for configuring and maintaining your 3ware controller card using the 3ware command line interface CLI This manual describes CLI support for the LSI 3ware 9750 9690SA and 9650SE with Release 9 5 2 or newer If you have an earlier LSI 3ware controller 95905E 9550S X U 9500S or a legacy 7000 8000 series board refer to the CLI guide for your controller Documentation is available from the LSI website at http www si com channel ChannelDownloads You can still use many of the CLI commands with earlier 3ware controllers although not all commands are supported on every controller Earlier versions of the CLI Guide detail which commands are supported on each controller model Before
126. n Lsis 3ware SATA SAS RAID Controller Card Command Line Interface Version 10 2 Supports the 9750 9690SA and 9650SE Models PN 45413 00 Rev A May 2010 CLI Guide Document Description Document 45413 01 Rev A May 2010 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 third parties Copyri
127. n Speed on c0 e0 fanl to 1 Done cx ex owrsx show The cx ex pwrsx show command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex pwrsx show command shows the information about the specified power supply element pwrsx in the specified enclosure cx 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 www si com channel products 117 Chapter 2 CLI Syntax Reference are OK and 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 indicates 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 The cx ex pwrsx show identify command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex pwrsx show identify command shows the identify status of the specified power supply element The status can be either on or off If identify is on the LED associated with the power supply blinks If the enclosure does not support Power Supply Identify this command returns N A Example localh
128. n it needs to be replaced an AEN is also issued as a reminder 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 108 Note A battery test should be run every four weeks in order to get a reliable cx bbu show fw The cx bbu show fw command shows the BBU firmware version number Note that the BBU firmware version does not apply to 9750 models cx bbu show lasttest The cx bbu show lasttest command shows the date the battery capacity was last measured If the battery capacity test has never been run then XX XXX XXXX is Shown taken during the last test For information about running a test see cx bbu test Note The estimated BBU capacity hours shown is based on the measurement quiet on page 108 cx bbu show pcb The cx bbu show pcb command shows the PCB revision number on the BBU cx bbu show serial The cx bbu show serial command shows the BBU serial number www si com channel products 105 Chapter 2 CLI Syntax Reference cx bbu show status The cx bbu show status command shows the status of the BBU Possible values are as follows Testing A battery test is currently in progress This test can take up to 24 hours to complete During the test the BBU is not capable of backup operation and the write cache might be disabled deending on the unit s Storsave setting If the test is co
129. nable 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 reports either a O or a 1 depending on whether the command is successful For example if you have a 3ware controller with an ID of 0 you can type the following command tw_cli c0 show cO information shown here echo 0 www si com channel products 129 Chapter 2 CLI Syntax Reference If you type the following 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 in a command window type tw_cli cO show c0 info shown here if errorlevel 0 echo 0 0 tw_cli c7 show error if errorlevel 1 echo 1 1 This example fails returns 1 because there is no controller 7 130 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2
130. noreECC identify parity cx ux show all cx ux start rebuild disk lt p p gt ignoreECC cx ux start verify cx ux stop verify cx ux flush cx ux del noscan quiet cx ux set autoverify on off cx ux set wrcache on off quiet cx ux set rdcache basic intelligent off cx ux set identify on off cx ux set ignoreECC on off cx ux set gqpolicy on off cx ux set name string cx ux set rapidrecovery all rebuild disable quiet www si com channel products 71 Chapter 2 CLI Syntax Reference cx ux show 72 cx ux set storsave protect balance perform quiet 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 RaidType raid0 raidl raid5 raid6 raidl0 raid50 single cx ux remove noscan quiet The ex ux show command shows summary information for the specified unit If the unit consists of subunits as in the case of RAID 10 and RAID 50 then each subunit is further presented If the Autocarving policy was on at the time the unit was created and the unit is over the carve size multiple volumes were created and are listed at the end of the summary information Similarly if the unit was created with a boot volume this is also shown as the first volume v0 Note In the output of unit information tables that follows the column VPort might be Port depending on the applicable controller Example loc
131. ns When the schedule is enabled rebuild tasks only run during the time slots scheduled for rebuilds If a rebuild is taking place when the schedule is enabled it pauses until the next scheduled time The priority of rebuild versus I O operations is specified with 1 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 cx set rebuildmode lt adaptivellowlatency gt The cx set rebuildmode command sets the rebuild mode The rebuild mode has two settings Adaptive and Low Latency Rebuild mode works with the rebuild task rate see cx set rebuildrate lt 1 5 gt on page 64 www si com channel products 63 Chapter 2 CLI Syntax Reference 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 can be negatively affected especially for applications such as video server applications and audio applications The Low Latency s
132. nts processing a single command at a time To do so simply type the command and the arguments Single commands are useful when you want to perform a task such as redirecting the output of the command to a file They also allow you to use the command line history to reduce some typing Syntax tw_cli lt command_line_arguments gt Example tw_cli c0 show diag gt tmp 3w_diag out www lsi com channel products 7 Chapter 1 Introduction to the 3ware Command Line Interface 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 that you have entered in advance Each command must be on a 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 This example describes execution of the file clicommand txt which runs the CLI commands included in that file Scripting examples The following scripting example which is for a four port controller uses a text file called config_unit text that contains three commands This example sets up a four port controller with two units each with two drives mirrored The last command then prints the configurations for verification The following commands are included in the script file c0 add type raidl disk 0 1 c0 add type raidl disk 2 3 c0 show The following scripting example which
133. ol of managed ports When the drive is removed the DCB Disk Configuration Block metadata remains on the attached disk You can import or re introduce the port by rescanning the controller quiet is for noninteractive mode any redundant units This command fails if you attempt to remove a drive from a nonredundant unit After the drive is removed using the 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 because this operation degrades cx px set identify onloff The cx px set identify command 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 116 For additional information about enclosure related commands see Enclosure Note This command requires an enclosure with appropriate enclosure support E Object and Element Commands on page 109 Example localhost gt c0 p5 set identify on Setting Port Identify on c0 p5 to on Done cx px set dpmstat clear type ra lctlext The cx px set dpmstat clear command allows you to clear the data buffers of accumulated statistics information There are t
134. olume 1024 u0 v3 Volume 700 u0 v4 Volume a 7 1024 u0 v5 Volume e 5 1024 u0 v6 Volume e a 247 188 cx rescan noscan The ex rescan command instructs the controller to rescan all ports or vports and phys and reconstitute all units The controller updates its list of disks and attempts to read every Disk Configuration Block DCB in order to reassemble its view of logical units Any newly found units or drives are listed noscan is used to prevent the operating system from being notified of the unit discovery The default is to inform the operating system commands If you want to hot swap drives without first powering down the system Note If you are adding new drives add them physically before issuing the rescan use hot swap bays This helps prevent system hangs and electrical damage Example localhost gt cl rescan www si com channel products 57 Chapter 2 CLI Syntax Reference cx commit cx flush Rescanning controller cl for units and drives Done Found following unit s c1 u3 Found following drive s cl p7 c1 p8 The ex commit command applies only to the Windows operating system It commits all changes if a faster shutdown method is needed when running certain database applications This command has no effect and is not required with other operating systems such as Linux and FreeBSD The cx flush command forces the controller to write all cached data to
135. om channel products 77 Chapter 2 CLI Syntax Reference Unit UnitType Status SRCmpl V I M VPort Stripe Size GB u RAID O O 64K 3576 06 ul 0 DIS o po 298 0 ul 1 DIS O pl 298 0 ul 2 DIS o p2 a 298 0 ul 3 DIS o z p3 a 298 0 ul 4 DIS o p4 298 0 ul 5 DIS o p5 z 298 0 ul 6 DIS o p6 E 298 0 ul 7 DIS o 4 p7 7 298 0 ul 8 DIS o ps 298 0 ul 9 DIS o p9 298 0 ul 10 DIS o plo 298 0 ul 11 DIS O p11 298 0 ul v0 Volume 2047 00 ul vl Volume 1529 06 cx ux remove noscan quiet The cx ux remove command allows you to remove a unit Removing a unit instructs the firmware to remove the specified unit from its list of managed units but retains the Disk Configuration Block DCB metadata A logically removed unit can be physically moved to a different controller or reinstalled at a later time noscan is used to prevent informing the operating system of this change The default is to inform the operating system quiet is used for noninteractive mode Confirmation statements are suppressed and the command is executed immediately Using the quiet mode is useful for scripting purposes Example of interactive mode localhost 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 E removed You can physically remove hot swap bays w
136. oning normally and is online and capable of backing up the write cache However the battery is weak and needs to be replaced OK The BBU is ready online and capable of backing up the write cache The unit s write cache is automatically reenabled if applicable A dash indicates that a battery or a BBU is not installed 106 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 BBU Object Commands cx bbu show temp The cx bbu show temp 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 the need to replace the battery Contact LSI to obtain a replacement 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 is equivalent to the command cx bbu show temp cx bbu show tempval cx bbu show volt The cx bbu show tempval command shows the temperature of the BBU in Celsius Example localhost gt c0 bbu show tempval c0 bbu Battery Temperature Value 24 deg C The cx bbu show volt 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 the need to repl
137. orts 1 c3 p3 Drive Connections 1 c3 p3 Link Speed Supported 1 5 Gbps c3 p3 Link Speed 1 5 Gbps c3 p3 Queuing Supported Yes c3 p3 Queuing Enabled Yes c3 p3 Reallocated Sectors 0 c3 p3 Power On Hours 268 c3 p3 Temperature 36 C c3 p3 Spindle Speed 7200 RPM c3 p3 Identify Status N A c3 p3 Belongs to Unit N A c3 p3 Drive Smart Data OA 00 01 OF 00 5E 59 B8 9A 24 OA 00 00 00 5E 5D 00 00 00 00 00 00 00 04 32 00 00 00 00 00 00 00 05 33 00 64 64 00 00 00 00 07 OF 00 4A 3E 88 3F 98 01 00 00 00 64 64 OC 01 00 00 00 00 00 OA 13 00 00 00 00 00 00 00 OC 32 00 64 64 52 00 00 00 BB 32 00 64 64 00 00 00 00 00 00 00 64 64 00 00 00 00 00 00 00 BE 22 00 00 1B 28 00 00 00 C2 22 00 24 2C 24 00 00 00 C3 1A 00 3B 38 68 2B 4E 00 00 00 00 64 64 00 00 00 00 00 00 00 C6 10 00 00 00 00 00 00 00 C7 3E 00 C8 C8 00 00 00 00 C8 00 00 64 FD 00 00 00 00 00 00 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 82 00 AE 03 00 01 00 01 CA 02 00 00 00 00 00 00 00 00 0B 01 00 00 02 07 07 07 07 06 07 00 00 00 00 00 00 00 01 3A 68 E2 4B 00 00 00 C5 AB 08 58 1D 00 00 00 00 00 00 00 00 00 00 3A 68 E2 4B 00 00
138. ost gt c0 e0 pwrsl show identify c0 e0 pwrs1 Identify status on cx ex pwrsx set identify 0n off The cx ex pwrsx set identify command applies only to 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 118 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands cx ex tempx show The cx ex tempx show command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex tempx show 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 in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 Example localhost gt c0 e0 temp0 show TempSensor Status Temperature Identify tempo OK 42C 107F Off cx ex tempx show identify
139. owing the spread of power consumption on the power supply When a drive 1s 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 3DM2 or 3BM 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 drive inserted the message refers to a disk The following example shows that autodetect has been set to off to initiate staggered spin up during hot swapping where port 3 is empty and ports 5 and 6 contain newly inserted drives 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 This setting is only for direct attached drives and has no effect on drives behind an expander Example localhost gt gt c0 set autodetect off disk all Setting Auto Detect on c2 to off for all disks ports Done 3ware SATA SAS RAID Controller Card C
140. ows you to change the existing configuration of a unit by using type RaidType You can make three types of changes e Increase the capacity e Change the RAID level with the same or increased 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 you must specify a valid number of disks and parameters 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 Single unit For details see the following note Unspecified parameters are assigned the default values is applicable stripe size of 256 KB write cache enabled autoverify enabled and ignoreECC disabled Both source name and serial number are carried over to the destination unit Note A special case of this command occurs when the source unit has a type of RAID1 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 drives The disk name is duplicated on the destination units but the source unit seria
141. pecified unit begins immediately If verify advanced the verify pauses until the next timeslot on the advanced schedule For more information see cx set verify advancedlbasicl1 5 on page 66 The following table summarizes how manual verify works Table 7 Manual Verify Behavior cx ux start verify Command Setting Action Basic Verify Schedule verify basic Runs immediately Advanced Verify Schedule verify advanced Follows Advanced Verify Schedule Verify pauses if a rebuild migration or initialization is in progress and resumes after those operations are completed cx ux stop verify cx ux flush 80 The cx ux stop verify command stops a background verification process on the specified unit ex ux The cx ux flush 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands c x ux set autoverify onloff The cx ux set autoverify command allows you to turn on and turn off the autoverify operation on a specified unit ex ux By default autoverify is on When autoverify is on and the basic verify schedule is used verify basic a verify automatically runs at the basic verify time Friday at midnight by default If the system is not on at that time verification starts the next time the system is powered up When
142. r you can mute the alarm 120 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands Note Some enclosures support alarms but not the mute unmute function For these enclosures using this command to set the alarm to mute returns an error message indicating that the feature is not supported For these enclosures the alarm is not mutable however it can be turned off If you set this command to unmute for an enclosure that does not support mute the command appear to complete and does 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 cx ex update fw filename_with_path sep n force cx ex show The ex ex update command applies only to 9750 controllers The ex ex update command downloads the specified expander firmware image to the target SEP Storage Enclosure Processor expander that supports the SES 2 SCSI Enclosure Services standard for enclosure management CCU enclosures with SAF TE protocol are not supported For details about working with this command see the LSI 3ware KnowledgeBase Go to http kb lsi com and refer to article 15803 firmware The cx ex show firmware command lists the SEP and corresponding firmware version in the specified expander This command applies only to 9750 controllers Examp
143. re information help c x ex fanx help cx ex fanx 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 109 for more information 126 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Command Logging help c x exfttempx help cx ex tempx 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 109 for more information help cx ex pwrs x help cx ex pwrsx command provides specific power supply cx ex pwrsx related help illustrating various ways to use the cx ex pwrsx command See the section Enclosure Object and Element Commands on page 109 for more information help c x ex almx help cx ex almx 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 109 for more information Command Logging Both the CLI and 3DM2 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 3DM2 through the 3DM2 web interface You might b
144. ripe Size GB Cache AVrfy u0 RAID 50 INIT PAUSED 63 256K 469 246 RiW ON VPort Status Unit Size Type Phy Encl Slot Model p8 OK u0 34 18 GB SAS c0 e0 s1t0 HITACHI HUS151436VL www si com channel products 47 Chapter 2 CLI Syntax Reference p9 0 ud 34 18 GB SAS c0 e0 s1t1 HITACHI HUS151436VL p10 0 ud 34 18 GB SAS c0 e0 s1t2 HITACHI HUS151436VL p11 O ud 34 18 GB SAS c0 e0 s1t3 HITACHI HUS151436VL p12 O u0 34 18 GB SAS c0 e0 s1t4 HITACHI HUS151436VL p13 0 u0 34 18 GB SAS E c0 e0 s1t5 HITACHI HUS151436VL pl4 0 ud 34 18 GB SAS z c0 e0 s1t HITACHI HUS151436VL p15 0 ud 34 18 GB SAS 7 c0 e0 s1t7 HITACHI HUS151436VL p16 0 ud 34 18 GB SAS c0 e0 s1t8 HITACHI HUS151436VL p17 0 ud 34 18 GB SAS c0 e0 s1t9 HITACHI HUS151436VL p18 0 ud 34 18 GB SAS E c0 e0 slt10 HITACHI HUS151436VL p19 0 ud 34 18 GB SAS a c0 e0 s1t11 HITACHI HUS151436VL p20 0 ud 34 18 GB SAS c0 e0 s1t12 HITACHI HUS151436VL p21 0 u0 34 18 GB SAS c0 e0 s1t13 HITACHI HUS151436VL p22 O u0 34 18 GB SAS 7 c0 e0 s1t14 HITACHI HUS151436VL p23 0 u0 34 18 GB SAS 7 c0 e0 s1t15 HITACHI HUS151436VL Name OnlineState BBUReady Status Volt Temp Hours LastCapTest bbu On Yes OK OK OK 119 18 Mar 2010 cx show rebuildmode 48 The cx show rebuildmode command shows the current rebuild mode setting of the specified controller The rebuild mode has two settings Adaptive and Low latency Rebuild
145. rives that appear to the operating system as a single unit When working with a RAID controller unit refers to an array of disks that you can configured and manage through the 3ware software You can also use the 3ware software to configure Single disk units 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 the 3ware TwinStor technology reads from both drives simultaneously Striping Striping across disks allows data to be written and accessed on more than one drive simultaneously 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 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 If a failure occurs you can reconstructed the data on the failed drive from the data on the other drives Hot Swap The process of exchanging a drive without shutting down the system This process 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 either on the same controller or a
146. rompt and then exits 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 Start the 3ware CD and at the 3ware menu click Run CLI Open a console window change to the directory where tw_cli is located and at the command prompt type tw_cli Double click the CLI icon in the folder on your computer where you copied it After you start CLI the CLI prompt appears in a DOS console window Installing the 3ware CLI on Linux FreeBSD OpenSolaris and VMWare You can install the 3ware CLI from the 3ware software CD or you can download the latest version from the LSI web site http www si com channel ChannelDownloads www si com channel products 3 Chapter 1 Introduction to the 3ware Command Line Interface To install 3ware CLI on Linux FreeBSD OpenSolaris or VMWare do one of the following Copy the file CLI binary and executable files are located on the 3ware CD in the following directory packages cli Navigate to the appropriate folder under packages c1i for your OS Coy the file tw_c1i to an appropriate location on your system where you can easily access the file Make sure to copy the correct version for your OS and OS architecture 32 bit or 64 bit Online manual pages are also available in nroff and html formats These are located in packages cli tw_cli 8 html Of tw_cli 8 nroff You must
147. rovide information and perform actions related to a specific disk that is attached to a port or virtual port such as c0 p0 You use port object commands for such tasks as viewing information about 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 cx px show cx px show attribute attribute where attributes are capacity firmware identify lspeed model ncq serial smart status identify driveinfo dpmstat type instr ra lct histdata ext cx px show all cx px remove noscan quiet cx px set identify on off cx px set dpmstate clear type lt ra lctlext gt The ex px show command shows summary information about the specified disk attached to port cx px Example for 9750 and 9690SA controllers localhost gt c3 p1 show VPort Status Unit Size Type Phy Encl Slot Model pl OK ud 149 05 GB SATA 0 WDC WD1600JS 22NCBla The preceeding 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 attached that is it is not in an enclosure with an expander 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Port Object Commands
148. rse See details above cx show diag 44 The cx show diag command extracts controller diagnostics for technical support usage The output contains general information about the controller followed by two logs The first is the diagnostic log and the second is the controller log The diagnostic log contains output related to any anomaly or error in the system while the controller log is a snapshot of recent controller activity The diagnostic log contains persistent and usually less recent data than the controller log Note that some characters might not be printable or rendered correctly not readable You can save 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 For more information see Outputting the CLI to a Text File on page 9 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands cx show phy The ex show phy command shows a list of the phys with related information for the specified controller In the following example the column Device Type indicates whether the connected device is an enclosure or a SATA or SAS drive The Device column is the device ID or handle There are three Link Speed columns Supported denotes the lin
149. rsion BG9X 2 x cx show carvesize cx show ctlbus cx show driver The cx show carvesize command shows the maximum size of the volumes that can be created if the autocarve policy is set to on You can set the carvesize 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 on page 34 Example localhost gt c0 show carvesize c0 Autocarving Size 2000 GB The cx show ctlbus command shows the controller host bus type bus speed and bus width Example for 9690SA localhost gt c2 show ctlbus c2 Controller Bus Type PCIe c2 Controller Bus Width 8 lanes c2 Controller Bus Speed 2 5 Gbps lane The ex show driver command shows the device driver version associated with controller cx Example localhost gt c0 show driver c0 Driver Version 3 x www si com channel products 35 Chapter 2 CLI Syntax Reference cx show dpmstat type inst rajext 36 The cx show dpmstat 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 are reported The available options are inst for Instantaneous ra for Running Average and ext for Extended Drive Statistics If you do not specify a type you see the default set of drive statistics which is the type inst inst Instantaneous This m
150. s 2 c3 p4 Drive Connections 1 cx px show firmware The cx px show firmware command shows the firmware version of the drive attached to the specified port Example localhost gt c0 p5 show firmware c0 p5 Firmware Version 65 13G65 www si com channel products 93 Chapter 2 CLI Syntax Reference cx px show identify The cx px show identify command requires a supported enclosure The cx px show identify 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 101 Example localhost gt c0 p5 show identify c0 p5 Identify Status on cx px show Ispeed The cx px show Ispeed command shows 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 Supported 3 0 Gb s c0 p5 SATA Link Speed 3 0 Gb s cx px show model cx px show ncq 94 The cx px show model command shows the model of the drive attached to the specified port Example localhost gt c0 p5 show model c0 p5 Model WDC WD1600BB 00DAAO The cx px show neq command shows the Native Command Queueing NCQ 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 un
151. s are stored in a finite queue inside the kernel and can be listed by CLI and 3DM2 They are also stored in the operating system events log The cx show alarms command shows all available events on a given controller The default is to list the events in ascending order that is the www si com channel products 43 Chapter 2 CLI Syntax Reference oldest event messages appear at the top and the most recent event messages appear at the bottom You can use the reverse attribute to list the most recent event message at the top 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 co 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 co Tue Apr 01 2008 12 34 23 FO Unit operational unit 1 cx show events reverse The cx show events command is the same as cx show alarms reverse See details above cx show AENSs reverse The cx show AENS command is the same as cx show alarms reve
152. 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 blinks If the enclosure does not support Fan Identify this command returns N A Example localhost gt c0 e0 fanl show identify c0 e0 fanl Identify status on 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands cx ex fanx set identify o0n Joff The cx ex fanx set identify command applies only to 9750 and 9690SA controllers For the 9650SE 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 The cx ex fanx set speed command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex fanx set speed command sets the speed level of the specified enclosure fan The speed level is a number in the range of lt 0 7 gt as follows 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 Fa
153. specify an invalid attribute the loop terminates Possible attributes are initializestatus name autoverify rdcache wrcache ignoreECC identify qpolicy parity rapidrecovery rebuildstatus serial status storsave verifystatus and volumes cx ux show autoverify The cx ux show autoverify 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 wrcache The cx ux show wrcache command shows the current write cache state of the specified unit Example localhost gt c0 u0 show wrcache c0 u0 Write Cache State on cx ux show rdcache The cx ux show rdcache 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 command is supported with all RAID array types For more information see cx ux set rdcache basiclintelligentloff on page 82 Example localhost gt c0 u0 show rdcache c0 u0 Read Cache Intelligent cx ux show identify 74 The cx ux show identify 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 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Unit Object Commands cx ux show ignoreECC The ex ux show ignoreECC command sho
154. stat on Joff The ex set dpmstat 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 62 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands You can see whether the Performance Monitor is currently running and also see a statistics summary by using the command cx show dpmstat type instlralext on page 36 For a description of each of the statistics that can be gathered and viewed see cx px show dpmstat type instlrallctlhistdatalext on page 98 DPM is disabled by default since there is overhead in maintaining the statistics DPM is also disabled following a reboot or powerup Note that turning off DPM does not clear the statistical data that has been recorded To clear the data use the command cx px set dpmstat clear type rallctlext on page 101 For more information see Drive Performance Monitoring in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 Example localhost gt c0 set dpmstat off Setting Drive Performance Monitoring on c0 to off Done cx set rebuild enable disable 1 5 The ex set rebuild command enables or disables the Rebuild Task Schedule defined for controller ex and sets the priority of rebuild versus I O operatio
155. sts 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 O 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 1 2830 OE fan4 O ON 1 9120 Off fan5 O ON Li 8330 Off TempSensor Status Temperature Identify temp0 OK 41C 105F Off templ OK 38C 100F Off temp2 OK 34C 93F Off temp3 OK 38C 100F Off temp OK 38C 100F Off temp5 OK 34C 93F Off temp6 NOT INSTALLED Off temp7 NOT INSTALLED Off PowerSupply Status State Voltage Current Identify 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands pwrs0 OK on OK OK Off pwrsl OK on OK OK Off slot Status VPort Identify slot0 O c0 p0 off slot1 NO DEVICE Off slot 2 o c0 p1 off slot3 O c0 p2 off slot4 o c0 p3 off slot5 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 cx ex show attribute attribute The cx ex show attribute command applies to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex show attribute command shows the current setting of one or more attri
156. t UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy ud Migrator MIGRATING 26 298 002 RiW OFF ul RAID 1 REBUILD PAUSED 0 3124519 OFF OFF Port Status Unit Size Blocks Serial po OK u0 149 05 GB 312581808 WD WCANM1883862 pl OK u0 149 05 GB 312581808 WD WCANM1754124 p2 OK u0 372 61 GB 781422768 WD WMAMY1661939 p3 OK ud 372 61 GB 781422768 WD WMAMY1579179 p4 OK ul 372 61 GB 781422768 WD WMAMY 1662720 p5 DEGRADED ul 372 61 GB 781422768 WD WMAMY 1576310 p6 NOT PRESENT 5 p7 NOT PRESENT T ee 3ware CLI gt c0 u3 show Unit UnitType Status SRCmpl V I M Port Stripe Size GB u0 Migrator MIGRATING 26 sul RAID 10 OK 64K 298 002 su0 0 RAID 1 OK 5 s su0 0 0 DIS OK te po 2 149 001 su0 0 1 DIS OK t pl 149 001 su0 1 RAID 1 OK Es Es s ES y su0 1 0 DIS OK p2 149 001 su0 1 1 DIS OK p3 149 001 su0 v0 Volume 298 002 dud RAID 0 OK 5 64K 596 004 du0 0 DISK OK p3 149 001 du0 1 DISK OK p2 od 149 001 du0 2 DISK OK z p1 149 001 du0 3 DISK OK po 149 001 du0 v0 Volume gt N A 3ware CLI gt c0 ul show Unit UnitType Status SRCmpl V I M Port Stripe Size GB ul RAID 1 REBUILD PAUSED 0 gt 3723519 ul 0 DISK OK p4 372 519 ul 1 DISK DEGRADED p5 3725529 ul vO Volume 372513 www si com channel products 91 Chapter 2 CLI Syntax Reference Port Object Commands Syntax cx px show 92 Port object messages are commands that p
157. te cx set verifymode lt adaptivellowlatency gt ex show verifymode cx set selftest enable disable The ex set self test command enables or disables the specified controller s SMART self test Example localhost gt c0 selftest enabl enables the selftest on controller c0 cx set spinup nn The cx set spinup 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 two the controller spins up two disks at a time pause and then spin up another two 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 is ignored cx set stagger nn The cx set stagger command allows you to set a controller based Disk Spinup Stagger Time Policy that specifies the delay between spin ups The value must be a positive integer between 0 s and 60 s where s is seconds This policy with Disk Spinup Policy specifies how the controller spins up disks at boot time The default is 6 s cx set autocarve onloff
158. tlbus 9000 series SX SE SA only serial 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 The help command provides a table of contents to help with the overall navigation of the CLI commands For example Typical output is similar to the following example localhost gt help Copyright c 2010 LSI LSI 3ware CLI version 2 00 11 010 Commands Description focus Changes from one object to another For Interactive Mode Only 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 Ox Controller specific commands cx ux Unit specific commands cx px Port specific commands cx phyx Phy specific commands cx bbu BBU specific commands 9000 only cx ex Enclosure specific commands 9690SA only ex Enclosure specific commands 9KSX SE only Certain commands are qualified with constraints of controller type model support Please consult the tw_cli documentation for explanation of the controller qualifiers Type help lt command gt to get more details about a particular command
159. tuses 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 www si com channel products 41 Chapter 2 CLI Syntax Reference available in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 of the drives in the unit This feature provides a diagnostic capability for potential problem drives The error might not be a repeated error and can be caused by an ECC error SMART failure or a device error Rescanning the controller clears the drive error status when the condition no longer exists 3 Note If an asterisk appears next to the status of a unit there is an error on one Example localhost gt c2 show unitstatus 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 64K 298 002 ON OFF u2 SPARE OK 149 042 OFF u3 RAID 1 OK s 149 001 ON OFF cx show all The cx show all 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 9750 8e cl Driver Version 5 01 00 018 cl Model 9750 8e cl Available Memory 488MB cl Firmware Version
160. uled to run 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 follow this process 1 Use the cx show selftest command to show the current schedule for selftest tasks www si com channel products 61 Chapter 2 CLI Syntax Reference 2 Use the ex del selftest command to remove any of the scheduled tasks which do not match your desired schedule 3 Use the ex add selftest command to create the selftest schedule slots you want described above 4 Use the cx set selftest enable command to enable the schedule this enables all selftest schedule slots cx del rebuild slot_id The cx del rebuild command removes the rebuild background task slot slot_id from the Rebuild Task Schedule Example localhost gt cl del rebuild 2 removes the rebuild background task in slot 2 cx del verify slot_id The ex del verify 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 c x del selftest slot_id The cx del selftest command removes or unregisters the selftest background task slot slot_id from the Self Test Task Schedule Example localhost gt cl del selftest 3 Removes the selftest background task in slot 3 cx set dpm
161. various operating systems Installing the 3ware CLI on Windows You can install the 3ware CLI from the 3ware software CD or you can run it directly from the CD You can also download the latest version from the LSI web site http www l si com channel ChannelDownloads Online manual pages are also available in nroff and html formats These are located on the software CD in the folder packages cli tw_cli 8 html or tw_cli 8 nroff To install 3ware CLI on Windows do one of the following e Run the installer from the 3ware CD Start the 3ware CD and at the 3ware menu click Install Software Follow the instructions in the installation wizard and make sure that Command Line Interface tw_cli is selected 2 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Installing the 3ware CLI Copy the file from the 3ware CD Copy the file tw_c1i 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 your Note CLI comes in both 32 bit and 64 bit versions If you are operating system Permissions Required to Run CLI To run CLI you can be logged onto Windows with one of the following sets of permissions Administrator User with administrator rights Domain administrator Domain user with Domain Admin or Administrator membership Without the correct privileges the CLI displays a p
162. ve 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 listing for Histogram data would also be all zeros Phy Object Commands Syntax These commands apply only to 9750 and 9690SA controllers Phy Object Commands are sent to an instance of a controller phy such as cO phy0 cx phyx show cx phyx set link auto 1 5 3 0 6 0 cx phyx show 102 The cx phyx show command presents a summary report on the specified phy In the following example the link speed of the phy is shown in three columns 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 BBU Object Commands 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 can be set with the cx phyx set link autol1 513 016 0 command The default 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 1 530 3 0 g cx phyx set link auto 1 5 3 0 6 0 E The cx phyx set link command sets the link speed for the specified phy This controls the speed between the controller and the hard drive or enclosure to which it is connected The possible values
163. wer supply units the Status column lists the status of each power supply the State column indicate if the 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 114 The ex ex show alarms command applies only to 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 can be abbreviated to alms For example cx ex show alms The cx ex show alarms command shows 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 whether the alarm unit is ON or OFF and the Audibility column indicates whether the alarm is Muted or Unmuted Example localhost gt c0 e0 show alarms Alarm Status State Audibility alm0 OK OFF UNMUTE 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Enclosure Object and Element Commands cx ex show all The ex ex show all command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The ex e
164. with multiple commands The next topics shows examples of these different methods e Using the command interface interactively on page 7 e Using a single command with output on page 7 e Using an input file to execute a script on page 8 e Outputting the CLI to a Text File on page 9 Examples shown in the CLI Syntax Reference chapter reflect the interactive method 6 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Working with 3ware CLI Using the command interface interactively You can use the CLI interactively by entering commands at the main prompt and observing the results on the screen To use the CLI interactively 1 If necessary change to the directory that contains CLI 2 Type the following command tw_cli Under Mac OS X Linux FreeBSD and OpenSolaris if the directory containing the CLI is not in your path you might need to type tw_cli The main prompt appears 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 lists all controllers in the system and shows summary information about them For example 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 Using a single command with output You can use 3ware CLI with line argume
165. wo reasons to clear this data e After dpmstat is enabled statistics information continues to accumulate Eventually it can cause a buffer overflow causing all statistics information to be rendered as e You want fresh data such as when switching between benchmarking writes to benchmarking reads www si com channel products 101 Chapter 2 CLI Syntax Reference This command allows you to clear 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 98 Please note that if type ra both the Running Average and Histogram data are cleared If type Ict only the Long Command Times data is 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 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 dri
166. ws 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 The cx ux show initialize status command shows 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 The ex ux show name command shows the name if any of the specified unit Example localhost gt c0 u5 show name c0 u5 name Joe cx ux show qpolicy The ex ux show qpolicy command shows the queue policy set for the drives on unit ex If the queue policy is on the firmware utilizes the drive s queueing feature However the queue policy has no effect on drives that do not support native command queueing NCQ For a spare drive drive queuing is not meaningful or applicable so this command does not show the queue policy for a spare Example localhost gt c0 u5 show qpolicy c0 u5 Command Queuing Policy on cx ux show parity The ex ux show parity command shows the number of parity drives for the specified unit This attribute is only applicable or supported for RAID 6 units Example localhost c0 u5 show parity c0 u5 Parity Number 2 www si com channel products 75 Chapter 2 CLI Syntax Reference cx ux show rapidrecovery The ex ux show rapidrecovery command shows the Rapid RAID R
167. x px show all e In commands brackets around an item indicate that it is optional e Incommands ellipses indicate that more than one parameter at a time can be included for example c0 p0 show attribute attribute e In commands two dots indicate that there is a range between two values from which you can pick a value for example ex set carvesize 1024 2048 e Incommands a vertical bar I indicates an or situation where you have 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 cx rescan noscan The brackets indicate that you can omit the noscan parameter so that the operation will be reported to the 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 includes the following RAID specific topics e RAID Concepts www si com channel products 9 Chapter 1 Introduction to the 3ware Command Line Interface Available RAID Configurations on page 11 Determining Which RAID Level to Use on page 16 RAID Concepts The following concepts are important to understand when working with a RAID controller Arrays and Units In the storage industry an array refers to two or more disk d
168. x show all command shows the current settings of all attributes for enclosure cx ex cx ex slotx show The ex ex slotx show command applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex slotx show command shows information about the specified slotx on the specified enclosure ex The slot name is followed by its status If the slot contains a drive and no fault is detected the status is OK If the slot is empty the status indicates NO DEVICE The port that is correlated to the slot 1s indicated in the next column If the slot is empty then a dash is shown in the Port column The final column shows the Identify setting for the specified slot The following is an example of the output Example localhost gt c0 e0 slot1 show slot Status Port Identify slot1 OK c0 p1 Yes cx ex slotx show identify The cx ex slotx show identify applies only to 9750 and 9690SA controllers For the 9650SE simply drop the prepended controller name in the command and use ex The cx ex slotx show identify 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 blinks If the enclosure does not support Slot Identify this command returns N A Example localhost gt c0 e0 slot1 show identify c0 e0 slot1 Identify status on www si com channel products 115 Ch
169. y number 3ware SATA SAS RAID Controller Card CLI Guide Version 10 2 Controller Object Commands if direct attached the enclosure and slot if expander attached and model number of the drive Consequently the port numbers in the list might not be sequential Moreover if there are no drives present for the specified controller the output of its Port summary shows an empty summary consisting of only the header 3 Note If a drive is not present that port entry is not listed 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 You can obtain additional attributes about controllers units ports and disks by querying for them explicitly For details see the other show subcommands Example output Note that the port information is represented by VPort virtual port and Cache is represented by both Read Cache and Write cache Unit UnitType Status SRCmpl V I M Stripe Size GB Cache AVrfy u0 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 WDC WD1600JS 22NCB1 p3 OK qa 34 18 GB SAS 6 SEAGATE ST936701SS cx show attribute attribute
170. you can use the CLI you must install your LSI 3ware RAID controller card For details see the installation guide that came with your 3ware RAID controller The installation guide is available in PDF format on your 3ware CD or you can downloaded it from the LSI website at http w ww si 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 Although this manual includes instructions for performing tasks using the command line interface you can also use the following applications e 3ware BIOS Manager not applicable to the Mac os e 3DM2 3ware Disk Manager 2 For details see the user guide or the 3ware HTML Bookshelf viii www si com channel products Introduction to the 3ware Command Line Interface The 3ware SATA SAS Controller Card Command Line Interface CLI manages multiple 9750 9690SA and 9650SE 3ware RAID controllers Important AN For all of the functions of the 3ware CLI to work properly you must install the proper CLI firmware and driver versions For the latest versions and upgrade instructions check http www Isi com channel ChannelDownloads This chapter includes the following sections e Features of the CLI on page 1 e Installing the 3ware CLI on page 2 e Working with 3ware
171. ype rpm ivh lt LSI 3ware CommandLine Management Utility XXX rpm gt Press Enter to begin installation d After the installation is complete check that the software was installed correctly Permissions Required to Run CLI To run CLI you must be logged on with one of the following sets of permissions e Administrator e Root To start CLI e Ina Terminal window type tw_cli www si com channel products Chapter 1 Introduction to the 3ware Command Line Interface Installing the 3ware CLI on Mac OS X 3ware CLI can be installed from the 3ware software CD or the latest version can be downloaded from the LSI web site http www lsi com channel ChannelDownloads To install 3ware CLI on Mac OS X e Run the installer and select CLI as the software to be installed For more complete instructions see Appendix B Driver and Software Installation in the 3ware SATA SAS RAID Controller Card Software User Guide Version 10 2 Permissions Required to Run CLI To run CLI you must be logged on with one of the following sets of permissions e Administrator e Root You can also use SUDO to run CLI To start CLI e Ina Terminal window type sudo tw_cli If prompted enter your password Working with 3ware CLI You can work with the 3ware CLI in three different ways e Interactively by entering commands at the main prompt e As a series of single commands e By creating a script that is an input file

LSI 3ware 9650SE-24M8

Contents

Download Pdf Manuals

Related Search

Related Contents