AMCC 9500S manual

3w ar e ® Serial A T A RAID Contr oller Command Line Interface Support s the 9000 Series (9500S, 9550SX, 9590SE, 9650SE) PN: 720-0145-00 October 20 06 CLI Guide[...]

www.3ware.com ii Cop yright ©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. This publication may be co pied or reproduced for reference purposes only . All other purposes require the express written consent of AMCC, 215 Mof fett Park Drive, Sunnyvale, CA 94089. AMCC shall not be responsible or liable for , and shall be h[...]

www.3ware.com iii Table of Contents About this CLI Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1 Chapter 1. Introduction to the 3ware Command Line Interface. . . . . . . . . . . . . . . . . .2 Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

iv 3ware Serial ATA RAID Controller CLI Guide /c x show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 /c x show numport s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 /c x show numunit s . . . . . . . . . . . . . . . . . . . . . . . [...]

www.3ware.com v /c x /u x show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /c x /u x show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /c x /u x show storsave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

vi 3ware Serial ATA RAID Controller CLI Guide /c x /bbu test [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /c x /bbu enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /c x /bbu disable [quiet] . . . . . . . . . . . . . . . [...]

www.3ware.com 1 About this CLI Guide 3war e Serial A T A Contr oller CLI Guide provides instructio ns for configuring and maintaining your 3ware controller using 3ware’ s command line interface (CLI). There are often multiple ways to acc omplish the same configuration and maintenance tasks for your 3ware cont roller . While this manual includes i[...]

2 3ware Serial ATA RAID Controller CLI Guide 1 Intr oduction to the 3w ar e Command Line Interf ace The 3ware SA T A RAID Controller Command Line Interface (CLI) for Linux, W indows, and FreeBSD is provided to manage 7000, 8000, and 9000-series 3ware A T A and Serial A T A RAID controllers. Multiple 3ware RAID controllers can be managed using the C[...]

Supported Operating Systems www.3ware.com 3 Y ou can use the CLI to view unit status and version information and perform maintenance functions su ch as adding or removing drives. 3ware CLI also includes advanc ed features for creating and deleting RAID units online. For a summary of what you can do using the CLI, see “Common T asks Mapped to CLI [...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 4 3ware Serial ATA RAID Controller CLI Guide Installing the 3ware CLI Installing the 3ware CLI on W indows 3ware CLI can be installed or run direc tly from the 3ware so ftware CD, or the latest version can be downlo aded from the 3ware web site, http://www .3ware.com . Online manual[...]

Installing the 3ware CLI www.3ware.com 5 If you are uncertain whether you hav e th e correct permissions , contact your network administrator . T o st art CLI, do one of the following: • Start the 3ware CD and at the 3ware Escalade menu, click Run CLI. • Or , open a console window , change to the directory where tw_cli is located, and at the co[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 6 3ware Serial ATA RAID Controller CLI Guide W or king with 3ware CLI Y ou can work with the 3ware CLI in different ways: • Interactively , entering co mmands at the main prompt • As a series of single commands • By creating a script—an input file with mu ltiple commands The[...]

Working with 3ware CLI www.3ware.com 7 Using a single command with output Y ou can use 3ware CLI with line argume nts, processing a single command at a time. T o do so, simply enter the command and the arguments. Single commands can be useful when you want to perform a task such as redirecting the output of the command to a file. It also allows you[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 8 3ware Serial ATA RAID Controller CLI Guide Outputting the CLI to a T e xt File Y ou can have the output of the 3ware CLI, including errors, sent to a text file by adding 2>&1 to the end of the line. This could be useful, for example, if you want to email the output to AMCC [...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 9 Under standing RAID Le v els and Concepts 3ware RAID controllers u se RAID (Redundant Array of In expensive Disks) to increase your storage system’ s pe rformance and provide fault tolerance (protection against data loss). This section organizes information ab out RAID concepts and config[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 10 3ware Serial ATA RAID Controller CLI Guide • Array Roaming. The process of removing a unit from a controller and putting it back later , either on the sa me controller , or a dif ferent one, and having it recognized as a un it. The di sks may be attached to dif ferent ports tha[...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 11 RAID 1 RAID 1 provides fault tolerance and a speed advantag e over non-RAID disks. RAID 1 is also known as a mirrored array . Mirroring is done on pairs of drives. Mirrored disk arrays write the sam e data to two dif ferent drives using RAID 1 algorithms (see Figure ?). This gives your sys[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 12 3ware Serial ATA RAID Controller CLI Guide Figure 3. RAID 5 Configuration Example RAID 6 RAID 6 requires a 3ware 9650SE RAID controller . RAID 6 provides greater redund anc y and fa ult tolerance than RAID 5. It is similar to RAID 5, but has two blocks of parity information (P+Q)[...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 13 Figure 4. RAID 6 Configuration Example 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 techniqu es, thus the name RAID 10[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 14 3ware Serial ATA RAID Controller CLI Guide Figure 5. RAID 10 Configuration Example RAID 50 RAID 50 is a combination of RAID 5 wi th RAID 0. This array type provides fault tolerance and high performance. RAID 50 requires a minimum of six drives. Several combinations are available [...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 15 Figure 6. RAID 50 Configuration Example Single Disk A single drive can be configured as a unit through 3ware software. (3BM, 3DM 2, or CLI). Like disks in other RAID configurations, single disk s contain 3ware Disk Control Block (DCB) information a nd are seen by the OS as available units.[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 16 3ware Serial ATA RAID Controller CLI Guide Hot S pare A hot spare is a single drive, available online, so that a redundant unit can be automatically rebuilt in case of drive failure. Deter mining W hat RAID Le vel to Use Y our choice of which type of RAID un it (array) to create [...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 17 Using Drive Cap acity Efficiently T o make the most efficient use of drive capacity , it is advisable to use drives of the same capacity . This is because th e capacity of each drive is limited to the capacity of the sma llest drive in the unit. The total array capacity is defined as follo[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 18 3ware Serial ATA RAID Controller CLI Guide Through drive coercion, the capac ity us ed for each drive is rounded down so that drives from dif fering manufacturers ar e more likely to be able to be used as spares for each other . The capacity used for each drive is rounded down to[...]

www.3ware.com 19 2 CLI Syntax R eference This chapter provides deta iled information about us ing the command syntax for the 3ware CLI. Throughout this chapter the examples reflect the interactive method of executing 3ware CLI. Common T asks Mapped to CLI Commands The table below lists many of the task s pe ople use to manage their RAID controllers[...]

Chapter 2. CLI Syntax Reference 20 3ware Serial ATA RAID Controller CLI Guide Enable/disable unit write cache /cx/ux set cache 68 Set the queue policy /cx/ux set qpolicy 70 Set the storsave profil e /cx/ux set storsave 70 Unit Configuration Changes Change RAID level /cx/ux migrate 72 Change stripe size /cx/ux migrate 72 Expand unit capaci ty /cx/ux[...]

Syntax Overview www.3ware.com 21 Syntax Ov er view The command syntax uses the general form: Object Command Attributes Object s are shell commands, controllers, units, ports (drives), BBUs (battery backup units), and enclosures. Commands can either select (show , get, present, read) attributes or alter (add, change, set, write) attributes. Enable/d[...]

Chapter 2. CLI Syntax Reference 22 3ware Serial ATA RAID Controller CLI Guide Attributes are either Boolean Attribut es or Name-V alue Attributes. • The value of a boolean attribute is deduced by presence or lack of—that is, the attribute is either specified , or not. For example, the command show alarms by default lists alarms wit h the most r[...]

Shell Object Commands www.3ware.com 23 Enclosure Ob je ct C omm an ds. Enclosure object commands provide information and perform ac tions related to a par ticular en clo s ure . For example, you can use enclos ure object c ommands to see information about an enclosure and its elements (slots, fan, and temp erature sensor elements). Help Commands. H[...]

Chapter 2. CLI Syntax Reference 24 3ware Serial ATA RAID Controller CLI Guide //hostname specifies the root of host h ostname . .. specifies one level up (the parent ob ject). / specifies the root at the current focused hostname. ./ object specifies the next level of the object. /c0/bbu specifies a relative path with respect to the current focused [...]

Shell Object Commands www.3ware.com 25 background tasks. (Defin itions of the unit statuses are available in the 3war e Serial A T A RAID Contr oller User Guide .) For a system with an enclosure un it that includes support for an EPCT (Enclosure Port Configuration T able), applicable firmware and software, and an appropriate controller (9550SX, 95 [...]

Chapter 2. CLI Syntax Reference 26 3ware Serial ATA RAID Controller CLI Guide sho w alar ms [r e v er se] This command shows the alarms or AEN messages of all controllers in the system. The default is to display the most re cent message first. The reverse attribute displays the most recent message last. sho w dia g This command shows the diagnostic[...]

Shell Object Commands www.3ware.com 27 sho w verify This command displays all verify sche dules for the 9000 controllers in the system. Example: //localhost> show verify Verify Schedule for Controller /c0 ==================================== ==================== Slot Day Hour Duration Status ------------------------------------ -----------------[...]

Chapter 2. CLI Syntax Reference 28 3ware Serial ATA RAID Controller CLI Guide flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 44. rescan This command sends a rescan command to all 3ware controllers in the system. For more information, see “/cx rescan [noscan]” on[...]

Controller Object Commands www.3ware.com 29 Contr oller Object Commands Controller object co mmands provide in formation and perform actions related to a specific controller , such as /c0 . For example, you u se controller object commands to see alarms sp ecific to a controller , to create schedules for when background tasks are run, and to set po [...]

Chapter 2. CLI Syntax Reference 30 3ware Serial ATA RAID Controller CLI Guide /c x set autorebuild=on|off (9550SX, 9590SE , 9650SE) /cx set autodetect=on|off disk=<p:-p>|all /c x set verify=enable|disable|1..5 (9000 only) /c x set selftest=enable|disable [task=UDMA|SMART](9 000 only) /c x flush /c x update fw= filename_with_path [force] (9000[...]

Controller Object Commands www.3ware.com 31 backup the controller cache in the event of power loss ), temperature, voltage, readiness, and so forth. Additional attributes about controllers, units, ports and disks can be obtained by querying for them explicitly . For de tails, see the other show subcommands. T ypical output looks like: //localhost&g[...]

Chapter 2. CLI Syntax Reference 32 3ware Serial ATA RAID Controller CLI Guide /c x show driv er This command reports the device driver version associated with controller /c x . Example: //localhost> /c0 show driver /c0 Driver Version = 2.x /c x sho w model This command reports the cont roller model of controller /c x . Example: //localhost> /[...]

Controller Object Commands www.3ware.com 33 /c x show serial This command reports the serial num ber of the specif ied controller /c x . Example: //localhost> /c0 show serial /c0 Serial Number = F12705A3240009 /c x sho w pcb This command reports the PCB (Printed Circui t Board) version of the specified controller /c x . Example: //localhost> [...]

Chapter 2. CLI Syntax Reference 34 3ware Serial ATA RAID Controller CLI Guide /c x show numpor ts This command reports the port capacity (number of physical ports) of t he specified controller /c x . Example: //localhost> /c0 show numports /c0 Number of Ports = 12 /c x show numunits This command reports the number of un its currently managed by [...]

Controller Object Commands www.3ware.com 35 /c x sho w spinup This feature only applies to 9000 series controllers. This command reports the number of conc urrent disks that will spin up when the system is powered on, after waiting for the number of seconds specified with the set stagger comma nd. Example: //localhost> /c0 show spinup /c0 Disk S[...]

Chapter 2. CLI Syntax Reference 36 3ware Serial ATA RAID Controller CLI Guide For operating systems that support units la rger than 2TB, there is no need to set the policy to on unless you want the operati ng system to have multiple smaller volumes. If you use a 32-bit operating system, it is recommended that you keep the policy on unless you know [...]

Controller Object Commands www.3ware.com 37 /c x sho w autor e build This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This command shows the Au to-Rebuild policy . If the policy is enabled, the firmware will select drives to use for rebuilding a degraded unit using the following priority order . For mo re information, se[...]

Chapter 2. CLI Syntax Reference 38 3ware Serial ATA RAID Controller CLI Guide /c x sho w allunitstatus This command presents a count of tota l and Not Optimal units managed by the specified controller /c x . For more about the mean ing of Not Optimal, see “Shell Object Commands” on page 23. Example: //localhost> /c0 show allunitstatus /c0 To[...]

Controller Object Commands www.3ware.com 39 /c x sho w all This command shows the cu rrent setting of all of the following attributes on the specified controller: driver , model, memory , firmware, bios, monitor , serial, pcb, pchip, achip, n umports, numunits, numdrives, unitstatus, drivestatus, allunitstatus, exportjbo d, ondegrade, spinup, stagg[...]

Chapter 2. CLI Syntax Reference 40 3ware Serial ATA RAID Controller CLI Guide /c x add type =<RaidT ype> disk =<p:-p> [stripe= Stripe ] [noscan] [g r oup= <3|4|5|6|7|8> ] [nocac he] [auto v erify] [noqpolic y][ignor eECC] [name= string ] [stor sa v e=<pro tect|balance|perf or m>] This command allows you to create a ne w unit[...]

Controller Object Commands www.3ware.com 41 stripe= St r i p e consists of the stripe size to be used. The following table illustrates the supported an d applicable stripes on unit types and controller models. Stripe size units are in K (kiloby tes). If no stripe size is specified, 64K is used by default, if applicable. If you need to change the st[...]

Chapter 2. CLI Syntax Reference 42 3ware Serial ATA RAID Controller CLI Guide grouped into grou ps of 3 or 5 drives. For 16 disk s, the disks can be grouped into groups of 4 or 8 drives. noscan attribute instructs CLI not to no tify the operating system of the creation of the new unit. By default CLI will inform the operating system. One applicatio[...]

Controller Object Commands www.3ware.com 43 name= string attribute allows you to name th e new unit. (This feature is for 9000 series and above controllers.) The st ring can be up to 21 characters and cannot contain spaces. In order to use r eserved characters (‘<‘, ‘>’, ‘!’, ‘&’, etc.) put double quotes (" ") ar[...]

Chapter 2. CLI Syntax Reference 44 3ware Serial ATA RAID Controller CLI Guide /c x commit This command only applies to the W ind ows operating system . It commits all changes if a faster shutdown method is needed w hen run n ing certain database applications. Linux and FreeBSD file systems do not requ ire this command since they have their own ways[...]

Controller Object Commands www.3ware.com 45 Given the above recommendation... Do you want to continue ? Y|N [N]: y Downloading the firmware from file /tmp/prom0006.img ... Done. The new image will take effect after reboot. force attribute is optional. If you incl ude it, the compa tibility checks are bypassed. /c x sho w alar ms [r e v erse] Asynch[...]

Chapter 2. CLI Syntax Reference 46 3ware Serial ATA RAID Controller CLI Guide /c x show dia g This command extracts controller diag nostics suitable for technical support usage. Note that some characters might not be printable or rendered correctly (human readable). It is recommended to save the out put from this command to a file, where it can be [...]

Controller Object Commands www.3ware.com 47 A status of “disabled” indicates that the task schedule is disabled. In this case, the controller will not use the define d schedule timeslots. If the rebuild command is entered manually , rebuilding w ill start within 10 to 15 minutes. It will begin automatically if a rebuild is needed and a proper s[...]

Chapter 2. CLI Syntax Reference 48 3ware Serial ATA RAID Controller CLI Guide --------------------------------------------------------- ----------------- u0 RAID-5 INITIALIZING 0 - 64K 521 .466 ON OFF Port Status Unit Size Blocks Serial --------------------------------------------------------- ------ p0 NOT-PRESENT - - - - p1 OK u0 76.33 GB 1600865[...]

Controller Object Commands www.3ware.com 49 //localhost> /c1 show verify Verify Schedule for Controller /c1 =================================== ===================== Slot Day Hour Dur ation Status ----------------------------------- --------------------- 1 Mon 2:00am 4 hr(s) disabled 2 - - - disabled 3 Tue 12:00am 24 hr(s) disabled 4 Wed 12:00am[...]

Chapter 2. CLI Syntax Reference 50 3ware Serial ATA RAID Controller CLI Guide The show selftest command displays the current selftest background task schedule as illustrated below . Selftest s do not have a time du ration since they are completed momentarily . //localhost> /c1 show selftest Selftest Schedule for Controller /c 1 =================[...]

Controller Object Commands www.3ware.com 51 3U s e t h e /c x add rebuild co mmand to create the rebuild schedule slots you want (described above.) 4 Use the /c x set rebuild=enable command to enable the schedule (this enables all rebuild schedule slots). (For details, see page 53.) /c x add v erify= dd d:hh:duration This command adds a ne w bac kg[...]

Chapter 2. CLI Syntax Reference 52 3ware Serial ATA RAID Controller CLI Guide /c x add selftest= ddd: hh This command adds a new backgr ound selftest task to b e ex ecuted on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at hour hh (range 0 .. 23). Notice that selftest ru ns to completion and as such no duration is provided. A[...]

Controller Object Commands www.3ware.com 53 /c x del r e build= slot_id This command removes the rebuild background task in slot slot_id . Example : //localhost> /c1 del rebuild=2 removes the rebuild background task in slot 2. /c x del v erify= slot_id This command removes the ve rify background task in slot slot_id . Example : //localhost> /[...]

Chapter 2. CLI Syntax Reference 54 3ware Serial ATA RAID Controller CLI Guide The priority of rebuild versus I/ O operations is specified with 1..5 , where 1 is more resources and 5 the least. Setting the value to 1 gives maximum processing time to rebuilds rather th an I/O. Setting the value to 5 gi ves maximum processing time to I/ O rather than [...]

Controller Object Commands www.3ware.com 55 /c x set e xpor tjbod=on|of f This command allows you to set the JBOD Export Policy to on or off . By default, exportjbod is off . If the JBOD export policy is off, CLI will not be able to create JBODs. During reboot, firmware will not export JB OD units to the operating system. The JBOD Export Pol icy is[...]

Chapter 2. CLI Syntax Reference 56 3ware Serial ATA RAID Controller CLI Guide /c x set sta g ger= nn This command is only fo r 9000 series controllers. This command allows you to set a cont roller-based Disk Spinup S tagger T ime Policy that specifies the de lay between spin-ups. The value must be a positive integer between 0 to 60 seconds. This po[...]

Controller Object Commands www.3ware.com 57 /c x set autorebuild=on|of f This command is only for 9 550SX , 9590SE, and 9650SE con trollers. This command turns the Auto-Rebuild policy on or off. By default, autorebuild is on. If the policy is on the firmware will select drives to use for rebuilding a degraded unit using the fo llowing priority orde[...]

Chapter 2. CLI Syntax Reference 58 3ware Serial ATA RAID Controller CLI Guide autodetect=on|off enables or disables automatic detection of drives on the controller ’ s ports fo r staggered spin-up. disk=<p:-p>|all specifies one or many disks (that is, drives or ports). If a port is empty (no drive is inserted), this featur e is disabled for[...]

Unit Object Commands www.3ware.com 59 /c x stop mediascan This command appli es only to 7000/8000 co ntrollers. This commands stops a media scan op eration on the specifie d controller /cx . (Media scans are started using /c x s tart mediascan .) Unit Object Commands Unit Object commands pr ovide information and perfo rm actions related to a specif[...]

Chapter 2. CLI Syntax Reference 60 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w This command shows summary info rmation about the specified unit /c x /u x . If the unit consists of sub-units as with the case of RAID-1, RAID-5, RAID-10, RAID-50, then each sub- unit is further presented. If the Auto-Carving policy was on at the time the[...]

Unit Object Commands www.3ware.com 61 /c x /u x sho w at tr ib u te [ a ttribute ...] This command shows the cu rrent setting of the specif ied attri but es. One or many attributes can be requested. Specifying an invalid attribute will terminate the loop. Possible attributes ar e: i nitializestatus, name (9000 series), qpolicy (9550SX, 9590SE, a nd[...]

Chapter 2. CLI Syntax Reference 62 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w initializestatus This command reports the initializestat us (if any) of th e specified unit. Example: //localhost> /c0/u5 show initialize status /c0/u5 is not initializing, its cur rent state is OK /c x /u x sho w name This feature only applies to 9000 [...]

Unit Object Commands www.3ware.com 63 /c x /u x sho w stor sav e This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This command reports the storsave policy on the unit. For more information see, “/cx/ux set storsave=protect|balance|perform [quiet]” on page 70. Example: //localhost> /c0/u5 show storsave /c0/u5 Comma[...]

Chapter 2. CLI Syntax Reference 64 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w ignor eECC This feature only applies to 9000 series controllers. This command shows the current setting of the ignoreECC policy for the specified unit. Example: //localhost> /c0/u0 show ignoreECC /c0/u0 Ignore ECC policy = off /c x /u x sho w volumes Th[...]

Unit Object Commands www.3ware.com 65 Unit UnitType Status %RCmpl %V/I/M Port S tripe Size(GB) --------------------------------------------------------- --------------- u1 RAID-0 OK - - - 6 4K 3576.06 u1-0 DISK OK - - p0 - 298.01 u1-1 DISK OK - - p1 - 298.01 u1-2 DISK OK - - p2 - 298.01 u1-3 DISK OK - - p3 - 298.01 u1-4 DISK OK - - p4 - 298.01 u1-5[...]

Chapter 2. CLI Syntax Reference 66 3ware Serial ATA RAID Controller CLI Guide /c x /u x del [noscan] [quiet] This command allows you to delete a unit. Deleting a unit not only removes the specified unit from the c ontroller's list of managed units, but al so destroys the DCB (Disk Configuration Block) meta data. After deleting a unit, ports (o[...]

Unit Object Commands www.3ware.com 67 /c x /u x star t v eri fy This command starts a backgr ou nd veri fication process on the specified unit /c x /u x . The following table shows the supported matrix as a function of the controller model and logical unit type. N/A (Not Applicable) refers to cases wh ere the given logical unit type is not supporte[...]

Chapter 2. CLI Syntax Reference 68 3ware Serial ATA RAID Controller CLI Guide functionality with use of Linux-provided schedulers such as cron(8) or at(1), or user supplied programs. /c x /u x stop v erify This command stops a bac kground veri fication process on the specified unit /c x /u x . T able 9 on page 6 7 sh ows the supported matrix as a f[...]

Unit Object Commands www.3ware.com 69 The quiet attribute turns of f interactive mode. /c x /u x set identify=on|of f This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This feature requires an enclosure that use s an integrated AMCC/3ware CCU (chassis control unit). (Check the 3ware web site for a list of chassis vendors [...]

Chapter 2. CLI Syntax Reference 70 3ware Serial ATA RAID Controller CLI Guide /c x /u x set name= string This command allows you to name the unit with an arbitrary name. Y ou can use this name in conjunction with th e unit serial number to cross-reference with the unit. The system does not check to ensure uniqueness of names, so be careful to assig[...]

Unit Object Commands www.3ware.com 71 protect provides the maximum data protec tion among the controller settings. When storsave is set to prot ect mode, it means : • When the unit becomes degraded, the write cache will be disabled. • W rite journaling is enabled. All data flushing from controller cache will be flushed to media. • Incoming FU[...]

Chapter 2. CLI Syntax Reference 72 3ware Serial ATA RAID Controller CLI Guide /c x /u x migr a te type= RaidT ype [disk= p:-p ] [g roup=3|4|5|6|7|8] [stripe= Stripe ] [noscan] [nocac he] [auto v erify] This feature only applies to 9000 series controllers. This command allows you to change th e existing configuration of a unit with type= RaidT ype .[...]

Unit Object Commands www.3ware.com 73 : disk= p:-p.. consists of a list of ports (disks) to be used in addition to the source disks in the construction of the destination unit. One or more ports can be specified. Multiple ports can be spec ified using a colon (:) or a dash (-) as port index separators. A dash indicates a ra nge and can be mixed wit[...]

Chapter 2. CLI Syntax Reference 74 3ware Serial ATA RAID Controller CLI Guide the best of net capacity and performan ce). For 15 disks, the disks can be grouped into grou ps of 3 or 5 drives. For 16 disk s, the disks can be grouped into groups of 4 or 8 drives. Note that RAID-10 always has gr ou p=2 , so an attribute specifying it’ s group is not[...]

Unit Object Commands www.3ware.com 75 autoverify attribute enables the autoverify a ttribute on the unit that is to be migrated. For more details on this feat ure, see “/cx/ux set autoverify=on|of f” on page 68. Migration Process In all cases of migration, the background migration process must be completed before the new ly sized unit is availa[...]

Chapter 2. CLI Syntax Reference 76 3ware Serial ATA RAID Controller CLI Guide Example of migrate output The following is an example of how migrating units will be displayed. In this example, the report indicates that /c0/u3 is a migrating unit with 39% completion. The report also indicate that Source Unit su0 is of type RAID-1 and Destination Unit [...]

Port Object Commands www.3ware.com 77 P or t Object Commands Port Object Messages are commands th at provide information and perform actions related to a specific disk, attached to a port, such as /c0/p0 . Y ou use port object commands for such tasks as seeing the status, model, or serial number of the drive. Synt ax /c x /p x s h o w /c x /p x sho[...]

Chapter 2. CLI Syntax Reference 78 3ware Serial ATA RAID Controller CLI Guide /c x /p x sho w status This command displays the status of th e drive attached to the specified port. (Definitions of the drive statuses are available in the 3war e Serial A T A RAID Contr oller User Guide .) Example: //localhost> /c0/p5 show status /c0/p5 Status = OK [...]

Port Object Commands www.3ware.com 79 /c x /p x sho w ncq This command appli es only to 9550SX, 9590SE, an d 9650SE model controllers. This command displays the NCQ (Nat ive Command Queuei ng) information for the drive attached to the specified port, in cluding whether NCQ is supported by the drive , and whet her it is enabled at the drive. For que[...]

Chapter 2. CLI Syntax Reference 80 3ware Serial ATA RAID Controller CLI Guide Example: //localhost> /c0/p5 show smart /c0/p5 Drive SMART Data: 10 00 01 0B 00 C8 C8 00 00 00 00 00 00 00 03 07 00 9A 96 BC 14 00 00 00 00 00 04 32 00 64 64 7A 00 00 00 00 00 00 05 33 00 C8 C8 00 00 00 00 00 ... 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2C /c x /p [...]

Port Object Commands www.3ware.com 81 /c x /p x remo v e [noscan] [quiet] This command allows yo u to remove (or export) a port (or drive) /c x /p x . Exporting a port instructs the firmware to remove the spec ified port from its pool of managed ports, but does no t retain the DCB (D isk Configuration Block) metadata on the at tached disk . Y ou ca[...]

Chapter 2. CLI Syntax Reference 82 3ware Serial ATA RAID Controller CLI Guide BB U Object Commands BBU (Battery Backup Unit) Object Commands are commands that provide information and perform ac tions related to a specific BBU installed on a specific controller , such as /c0/bbu . This object is only available o n 9000 series controllers on which a [...]

BBU Object Commands www.3ware.com 83 /c x /bbu sho w at tr ib u te [ at tr ib u te ...] This command shows the current setting of the given attribute(s) on the BBU board. One or many attributes can be sp ecified. Specifying an invalid attribute will terminate the loop. Possible attribut es are: batinst, bootloader , cap, fw , lasttest, pcb, ready ,[...]

Chapter 2. CLI Syntax Reference 84 3ware Serial ATA RAID Controller CLI Guide /c x /bbu sho w batinst This command shows the date when the current battery was installed. /c x /bbu sho w lasttest This command shows the date the battery capacity was last measured. If the battery capacity test has n eve r been run, then 'xx-xxx-xxxx' will be[...]

BBU Object Commands www.3ware.com 85 /c x /bbu show serial This command shows the BBU serial number . /c x /bbu sho w fw This command shows the BBU firmware version number . /c x /bbu sho w pcb This command shows the PCB revision number on the BBU. /c x /bbu sho w bootloader This command shows the BBU's boot loader version. /c x /bbu sho w all[...]

Chapter 2. CLI Syntax Reference 86 3ware Serial ATA RAID Controller CLI Guide /c x /bbu test [quiet] This command starts the battery capacity test. The test may take up to 24 hours to complete. During the test, the BBU is not capable of backup operation and the write cache of all un its attached to that controller is disabled. Once the test is comp[...]

Enclosure Object Commands www.3ware.com 87 Enc losure Object Commands Enclosure obje ct commands provide in formation and perform actions related to a specific enclosure, such as /e0 and its elements, such as /e0/slot0 . Enclosure obje ct elements inclu de slot , fan, and temperature sensor elements. These commands are support ed on the 9550SX, 959[...]

Chapter 2. CLI Syntax Reference 88 3ware Serial ATA RAID Controller CLI Guide T ypical output looks like: //localhost> /e0 show Encl Controllers ------------------------- e0 /c0 Fan Status ---------------------- fan0 OK TempSensor Temperature ------------------------------- temp0 24~C(75~F) Slot Status Port Identify -----------------------------[...]

Enclosure Object Commands www.3ware.com 89 /e x sho w slots This command reports the slots in enclosure /ex and their associated information. Example: //localhost> /e0 show slots Slot Status Port Identify ----------------------------------- ----------------- slot0 OK /c0/p0 No slot1 OK /c0/p1 Yes slot2 NO-DEVICE - No slot3 NO-DEVICE - No /e x sh[...]

Chapter 2. CLI Syntax Reference 90 3ware Serial ATA RAID Controller CLI Guide /e x/slotx sho w This command shows inform ation about the specified /slot x on the specified enclosure /e x . The slot name is followed by its status. If a slot has been inserted with a drive and no fault has been detected, the status is OK. If the slot is empty the stat[...]

Help Commands www.3ware.com 91 /e x/fanx sho w This command shows the informatio n about the specified fan element /fan x in the specified enclosure /e x . The fan name is followed by its status. If a fan is on and no fault has been detect ed, the status would indicate OK. Example: //localhost> /e0/fan0 show Fan Status ------------------- fan0 O[...]

Chapter 2. CLI Syntax Reference 92 3ware Serial ATA RAID Controller CLI Guide //localhost> help /cx /cx show /cx show attribute [ attribute ...] where attribut e is: achip|allunitstatus|autocarve|autorebuild (9550SX, 9590SE, 9650SE only)|bios|carvesize(9000 series)| ctlbus (9550SX, 9590SE, 9650SE)|driver|drivestatus| exportjbod|firmware|memory|m[...]

Help Commands www.3ware.com 93 Help with a ttributes As you work with specific object s or commands, you can also use ? to get help. For example: If you enter the command /c0 show and then need help on what specific attribute syntax is possible, you can use ? to get help as following: //localhost> /c0 show ? /cx show /cx show attribute [ attribu[...]

Chapter 2. CLI Syntax Reference 94 3ware Serial ATA RAID Controller CLI Guide Certain commands are qualified with constraints of control ler type/model support. Please consult the tw_cli documentation for expla nation of the controller-qualifiers. The controller-qualifiers of the Enclosure commands (/ex) also apply to Enclosure Element specific com[...]

Help Commands www.3ware.com 95 help fo cu s This command provides sp ecific focus related help , illustrating various ways to use the focus command. See the section “Shell Object Commands” on page 23 for more information. help /c x This command provide s specific controller /c x related help, illustrating various commands associated with the co[...]

Chapter 2. CLI Syntax Reference 96 3ware Serial ATA RAID Controller CLI Guide help /e x /fan x This command provides specific fan /e x /fan x related help, illustrating various ways to use the /e x /fan x command. See the section “Enclosure Object Commands” on page 87 for more information. help /e x /temp x This command provides spec ific tempe[...]

Return Code www.3ware.com 97 For example, if you had a 3ware cont roller with an ID of 0, you could type this command: tw_cli /c0 show (c0 information displayed here) echo $? 0 If you type: tw_cli /c7 show error: (CLI003) specified controller does not exist. echo $? 1 This example fails (returns 1) b ecause there is no controller 7. T o view the re[...]