AMCC 9590SE-4ME manual

3w ar e ® Serial A T A RAID Contr oller Command Line Interface Support s the 9590SE-4ME for the Power Mac® G5 PN: 720-0140-00 Septembe r 2006 CLI Guide for the Power Mac G5[...]

www.3ware.com ii Cop yright ©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. Th is 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 [...]

www.3ware.com iii Table of Contents Chapter 1. Introduction to the 3ware Co mmand Line Interf ace . . . . . . . 3 Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 T erminolo[...]

iv 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 /c x show numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 /c x show numunits . . . . . . . . . . . . . . . . . . . . . . .[...]

www.3ware.com v /c x /u x show name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 /c x /u x show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 /c x /u x show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

vi 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /bbu show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 /c x /bbu show bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 /c x /bbu show all . . . . . . . . . . . . . . . . . . . . . . .[...]

www.3ware.com 1 About this CLI Guide 3war e Serial AT A RAID Contr oller CLI Guide for the Power Mac G5 provides instructions for configuring and main taining 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 . Whi[...]

2 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5[...]

www.3ware.com 3 1 Intr oduction to the 3war e Command Line Interf ace 3ware RAID controllers can be managed using the CLI via a command line or script. This chapter includes th e following sections: • “Features of the CLI” on page 3 • “Installing the 3ware CLI on Mac OS X” on page 5 • “W orking with 3ware CLI” on pa ge 5 • “Un[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 4 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Suppor ted Oper a ting Systems The 3ware CLI is supported under the following oper ating systems: •M a c O S X , running in a Power Mac® G5 (PowerPC™-based) with PCI Express®. •W i n d o w s ® . W indows 2[...]

Installing the 3ware CLI on Mac OS X www.3ware.com 5 Installing the 3ware CLI on Mac OS X 3ware CLI can be installed from the 3war e software CD, or the latest version can be downloaded from the 3w are web site, http://www .3ware.com/support/ download.asp. T o inst all 3ware CLI on Mac OS X • Run the installer and select CLI as the software to be[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 6 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Using the command interface interactiv el y Y ou c an use 3ware CLI inte ractively , entering commands at the main prompt and observing the results on the screen. T o use the CLI interactively 1 Enter the following[...]

Working with 3ware CLI www.3ware.com 7 Using an input file to e xecute a script Y ou can operate 3ware CLI scripts by executing a file. The file is a text file containing a list of CLI command s which you have entered in ad vance. Each command must be on a s eparate line. Synt ax tw_cli -f <filename> Where <filename> is the name of the [...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 8 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Con ventions The following co nv en tio ns ar e used through this guide: • In text, monospace font is used for code and for things you type. • In descriptions and expl anations of commands, a bold fo nt indicat[...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 9 RAID Concepts The following concepts are important to understand when working with a RAID controller: • Arrays and Unit s . In the storage industry , the term “array” is used to describe two or more disk drives that appear to the operating system as a single unit. When you work with 3[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 10 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 A v ailable RAID Configur ations The following RAID levels and config urations are available for drives attached to a 9590SE-4ME 3ware RAID controller: • RAID 0 • RAID 1 • RAID 5 • RAID 10 • Single Disk [...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 11 Figure 1. RAID 0 Configuration Example RAID 1 RAID 1 provides fault tolerance and a speed advantag e over non-RAID disks. Also known as a mirrored array . Mirroring is done on pairs of dri ves. Mirrored disk arrays write the same data to two different drives using RAID 1 algorithms (see Fi[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 12 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Figure 3. RAID 5 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 a[...]

Understanding RAID Levels an d Co nc ep ts www.3ware.com 13 Single Disk A single drive can be configured as a unit through 3ware software. (3DM 2 or CLI). Like disks in other RAID config urations, single disks contain 3ware Disk Control Block (DCB) information and are seen by the OS as available units. Single drives are not fault tolerant an d ther[...]

Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 14 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 [...]

www.3ware.com 15 2 CLI Syntax R ef er ence 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 th eir RAID controll[...]

Chapter 2. CLI Syntax Refere nce 16 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 T able 4: Common T asks Mapped to CLI Commands T a sk CLI Command Page Controller Co nfiguration T a sks View information about a controller /cx show 26 View controller policies /cx show [attribute] [attribute] 27 Set policies for a controller • Ex[...]

Common T asks Mapped to CLI Commands www.3ware.com 17 Add a time slot to a verify schedule /cx add verify 46 Add a time slot to a selftest schedule /cx add selftest 47 Enable/disable the rebui ld/migrate schedule and set the task rate /cx set rebuild 48 Enable/disable the verify schedule and set the task rate /cx set verify 49 Enable/disable the se[...]

Chapter 2. CLI Syntax Refere nce 18 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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)[...]

Shell Object Commands www.3ware.com 19 Port Object Commands. Port object commands provide information and perform actions related to a drive on a specific port. For example, you use port object commands for such tasks as seeing the status, model, or serial number of the drive. For details, see “P ort Object Comm an ds” on page 69. BBU Object Co[...]

Chapter 2. CLI Syntax Refere nce 20 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 if you set the focus to //hostname /c0/u0 , the prompt changes to reflect that, and you only have to type show . The conce pt is similar to being in a particular location in a file system and requesting a listing of the current directory . object can[...]

Shell Object Commands www.3ware.com 21 (Not Optimal) state, RRate (Rebuild Ra te) of 2, VRate (V erify Rate) of 5, BBU of '-' (Not Applicable). Not Optimal refers to any state except OK and VERIFYING . Other states include VERIFY -P AUSED, INITIALIZING , INIT - P AUSED, REBUILDING , REBUILD-P AUSED, DEGRADED, MIGRA TING , MIGRA T E-P AUSE[...]

Chapter 2. CLI Syntax Refere nce 22 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 comman[...]

Shell Object Commands www.3ware.com 23 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 Refere nce 24 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 39. rescan This command sends a rescan command to all 3ware controllers in the system. For more information, see “/cx[...]

Controller Object Commands www.3ware.com 25 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 crea te schedules for when background tasks are run, and to set po[...]

Chapter 2. CLI Syntax Refere nce 26 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 filename_with_path [force] (9000 only) /c x commit (Windows only. Also known as sh utdown) /c x start mediascan (700[...]

Controller Object Commands www.3ware.com 27 T ypical output looks like: //localhost> /c0 show Unit UnitType Status %Cmpl Stripe Size(GB) Cache AVerify IgnECC ---------------------------------------------------------- ---------------- u0 RAID-1 OK - - 149.05 ON OFF OFF u1 RAID-5 OK - 64k 298.22 ON OFF OFF u2 SPARE OK - - 149.05 ON OFF - Port Stat[...]

Chapter 2. CLI Syntax Refere nce 28 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 . Exam[...]

Controller Object Commands www.3ware.com 29 /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 Refere nce 30 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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[...]

Controller Object Commands www.3ware.com 31 /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 Refere nce 32 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 poli[...]

Controller Object Commands www.3ware.com 33 /c x sho w autor ebuild This feature only applies to 955 0SX an d 9590SE 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, see “/cx s[...]

Chapter 2. CLI Syntax Refere nce 34 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 19. Example: //localhost> /c0 sho[...]

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

Chapter 2. CLI Syntax Refere nce 36 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x add type =<RaidT ype> disk =<p:-p> [stripe= Stripe ] [noscan] [g r oup= <3|4|5|6> ] [nocac he] [auto verify] [ignoreECC] [name= string ] [stor sav e=<pr otect|balance|perfor m>] This command allows you to create a ne w un[...]

Controller Object Commands www.3ware.com 37 group= 3|4|5|6 indicates the number of disks p er group for a RAID 50 type. (This attribute can only be used when type=raid50.) Recall that a RAID 50 is a multi-tier array . At the bottom-most la yer , N number of disks per group are used to form the RAID 5 layer . These RA ID 5 arrays are then integrated[...]

Chapter 2. CLI Syntax Refere nce 38 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 (‘<‘, ‘>’, ‘!’,[...]

Controller Object Commands www.3ware.com 39 /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 of notifying the controller to do[...]

Chapter 2. CLI Syntax Refere nce 40 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 afte r reboot. force attribute is optional. If you[...]

Controller Object Commands www.3ware.com 41 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 > diag.txt /c x show r ebuild 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . Rebuild is one of th [...]

Chapter 2. CLI Syntax Refere nce 42 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 If the rebuild schedule is enabled while a rebuild process is underway , the rebuild will pause until a scheduled time slot. Example: If a unit is in the initial ization state at noon on W ednesday and the rebuild schedule sh ow n above is in use (wi[...]

Controller Object Commands www.3ware.com 43 p9 OK u0 74.53 GB 156301488 3JV3WRHC p10 OK u0 74.53 GB 156301488 3JV3WQLQ p11 OK u0 74.53 GB 156301488 3JV3WQLZ /c x show v e rify 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . V erify is one of the su pported backgro und tasks. Rebuild and s[...]

Chapter 2. CLI Syntax Refere nce 44 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x show selftest 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . Selftest is one of the supported backgro und tasks. Rebuild and verify are other background tasks for which there are sepa[...]

Controller Object Commands www.3ware.com 45 /c x add r ebuild= dd d:hh:dur ation This command adds a new backgr ound rebu ild task to be executed on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at the hour hh (range 0 .. 23), for a duration of duration (range 1 .. 24) hours. A maximu m of seven rebuild tasks can be scheduled.[...]

Chapter 2. CLI Syntax Refere nce 46 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x add v erify= dd d:hh:dur a tion This command adds a ne w bac kground verify task to be executed on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at hour hh (range 0 .. 23), for a duration of duration (range 1 .. 24) hours. [...]

Controller Object Commands www.3ware.com 47 /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 maximum of seven selftest tasks c[...]

Chapter 2. CLI Syntax Refere nce 48 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x del v e rify= slot_id This command removes the ve rify background task in slot slot_id . Example : //localhost> /c1 del verify=3 removes verify background task in slot 3. /c x del selftest= slot_id This command removes (or unregisters) the se[...]

Controller Object Commands www.3ware.com 49 /c x set v e rify=ena ble|disable|1..5 This command enables or disables al l verify background task slots on controller /c x and (when enabled ) sets the priority of verification versus I/O operations. When enabled, verify tasks will only be run during the time slots scheduled for verifies. If a verify is[...]

Chapter 2. CLI Syntax Refere nce 50 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x set onde g r ade=cacheoff|follo w This command is only for 9500S controllers. This command allows you to set a cont roller -based write cache policy . If the policy is set to cacheoff and a unit degrades, the firmware will disable the write-cach[...]

Controller Object Commands www.3ware.com 51 volume. Each volume can then be treated as an individual disk with its own file system. The default carvesize is 2 TB. This feature is useful for operating systems limited to 2TB file systems. For example, using the 2 TB default car vesize, a 3 TB unit will be confi gured into one 2 TB volume and one 1 TB[...]

Chapter 2. CLI Syntax Refere nce 52 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 having to specify it as a spare. It also means that if you accidentally disconnect a drive (causing the controller to see it as a failed drive) and then reconnect it, the controller will au tomatically try to use it again. If the policy is off, spare[...]

Unit Object Commands www.3ware.com 53 Unit Object Commands Unit Object commands pr ovide information and perfo rm actions related to a specific unit, such as /c0/u1 (unit 1 on contro ller 0). For example, yo u use logical disk object commands for such tasks as seeing the rebuild, verify , or initialize status of a unit, starting, stopping, and resu[...]

Chapter 2. CLI Syntax Refere nce 54 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 One application of the /c x /u x show command is to see which sub-unit of a degraded unit has caus ed the unit to degrade and which disk within that sub- unit is the source of degradation. Anot her application is to see the source and destination uni[...]

Unit Object Commands www.3ware.com 55 /c x /u x sho w r ebuildsta tus This command reports the rebuildstatus (if any) of the specified unit. Example: //localhost> /c0/u5 show rebuildsta tus /c0/u5 is not rebuilding, its curre nt state is OK If the unit is in the process of migrating, the command will return the following: //localhost> /c0/u5 [...]

Chapter 2. CLI Syntax Refere nce 56 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /u x sho w qpolicy This feature only applies to 955 0SX an d 9590SE model controllers. This command reports the queue policy of the firmware. If the queue policy is on, the firmware utilizes th e drive queueing pol icy . If some drives in the un[...]

Unit Object Commands www.3ware.com 57 /c x /u x sho w cache This command shows the current write cach e stat e of the specified unit. Example: //localhost> /c0/u0 show cache /c0/u0 Cache State = on /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 t[...]

Chapter 2. CLI Syntax Refere nce 58 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 u1-2 DISK OK - - p2 - 298.20 u1-3 DISK OK - - p3 - 298.20 u1-4 DISK OK - - p4 - 298.20 u1-5 DISK OK - - p5 - 298.20 u1-6 DISK OK - - p6 - 298.20 u1-7 DISK OK - - p7 - 298.20 u1-8 DISK OK - - p8 - 298.20 u1-9 DISK OK - - p9 - 298.20 u1-10 DISK OK - - [...]

Unit Object Commands www.3ware.com 59 noscan is used to not inform the operatin g system of this cha nge. The default is to inform the operating system. quiet is used for non-intera ctive mode. No confirma tion is given and the command is executed immediately . This is useful for scripting purpos es. Example of interactive mode: //localhost> /c0[...]

Chapter 2. CLI Syntax Refere nce 60 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 When you issue this comman d, the specified verify w ill begin if schedules are disabled; otherwise it will pause until the next scheduled verify . V erify will also pause if a rebuild or initializ ation is currently in progress. /c x /u x pause rebu[...]

Unit Object Commands www.3ware.com 61 /c x /u x flush This command allows yo u to flush th e write cache on the specified unit /u x associated w ith controller /c x . Note that this command does not apply to spare unit types. /c x /u x set auto v erify=on|of f This feature only applies to 9000 series controllers. This command allows you to turn on [...]

Chapter 2. CLI Syntax Refere nce 62 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /u x set identify=on|of f This feature only applies to 955 0SX an d 9590SE model controllers. This command allows yo u to identify a unit withi n an enclosure. When that the EPCT (Enclosure Port Configuration T able) equates identify with blinki[...]

Unit Object Commands www.3ware.com 63 By default, qpolicy is off. Example: //localhost> /c0/u5 set qpolicy = on Setting Command Queuing Policy for unit /c0/u5 to [on] ... Do ne. /c x /u x set stor sav e=pr otect|balance|perfor m [quiet] This command appli es only to 9550SX and 9 590SE model controllers. This command sets the storsave policy to b[...]

Chapter 2. CLI Syntax Refere nce 64 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 • W rite journaling is disabled, if no BBU is present, and is enabled, if a BBU is present. All data flushing from controller c ache will be flushed to media if a BBU is installed and enabled. Otherwise, data will be flushed to disk only . • Inco[...]

Unit Object Commands www.3ware.com 65 type= RaidT ype specifies the RAID type of th e destination unit. Possible unit types include raid0 , raid1 , raid5 , raid10 , raid50 , or single . For example, type=raid5 indicates the destina tion unit is RAID-5. The type=single is a special case of the migrate command. It splits the source unit RAID-1 or TWI[...]

Chapter 2. CLI Syntax Refere nce 66 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 group= 3|4|5|6 indicates the number of disks p er group for a RAID 50 type. (This attribute can only be used when type=raid50.) Recall that a RAID 50 is a multi-tier array . At the bottom-most la yer , N number of disks per group are used to form the[...]

Unit Object Commands www.3ware.com 67 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|off” on page 61. 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 Refere nce 68 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 //localhost> /c0/u0 migrate type=raid10 disk=2-3 stripe=16 Sending migration message to /c0/u0 ... Done. 3ware CLI> /c0 show Unit UnitType Status %Cmpl Stripe Size(GB) Cache AVerify IgnECC -------------------------------------------------------[...]

Port Object Commands www.3ware.com 69 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 Refere nce 70 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 Us er Guide .) Example: //localhost> /c0/p5 show sta[...]

Port Object Commands www.3ware.com 71 /c x /p x sho w ncq This command appli es only to 9550SX and 9 590SE 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 queuing to b[...]

Chapter 2. CLI Syntax Refere nce 72 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 0[...]

Port Object Commands www.3ware.com 73 /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 Refere nce 74 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 c[...]

BBU Object Commands www.3ware.com 75 /c x /bbu sho w at t r i b u t e [ at t r i b u t e ...] 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, r[...]

Chapter 2. CLI Syntax Refere nce 76 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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-[...]

BBU Object Commands www.3ware.com 77 /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 Refere nce 78 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 AEN (Asynchronous Event Notification) messages are also generated by controllers to notify the us er of the command status. Check for AENs with the alarms command /c x show alarms [reverse] . Using the “reverse” attribute dis p lays the most rece[...]

Enclosure Object Commands www.3ware.com 79 Enc losur e Object Commands Enclosure obje ct commands prov ide in formation and perform actions related to a specific enclosure, such as /e0 and its elements, such as /e0/slot0 . Enclosure obje ct elements in clude slot , fan, and temperature sensor elements. These commands suppor t the 9550SX and 9590SE [...]

Chapter 2. CLI Syntax Refere nce 80 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 TempSensor Temperature ------------------------------- temp0 24~C(75~F) Slot Status Port Identify ----------------------------------- ----------------- slot0 OK /c0/p0 No slot1 OK /c0/p1 Yes slot2 NO-DEVICE - No slot3 NO-DEVICE - No /e x sho w a ttri[...]

Enclosure Object Commands www.3ware.com 81 /e x show fans This command lists the fans in enclosure /e x and shows their status. Possible statuses are OK and Unknown. Example: //localhost> /e0 show fans Fan Status ---------------------- fan0 OK /e x sho w temp This command lists the temperature sensors in enclosure /e x and the current temperatur[...]

Chapter 2. CLI Syntax Refere nce 82 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /e x /slot x sho w identify This command shows the identify status of the specified slot. The status can be either on or off . Example: //localhost> /e0/slot1 show identify /e0/slot1 Identify status = on /e x /slot x set identify=on|of f This comm[...]

Help Commands www.3ware.com 83 Help Commands The Help commands provid es brief on-line help. Y ou can get overview help by typing Help at the top-level prompt. This displays a brief definition of commands in both the new synt ax and the legacy syntax. (For an example, see the di scussion of the co mmand “help” on page 85.) Y ou can also get hel[...]

Chapter 2. CLI Syntax Refere nce 84 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /cx del selftest= slot_id (9000 only) /cx set exportjbod=on|off (9000 only) /cx set ondegrade=cacheoff|follow (9500S only) /cx set spinup= nn (9000 only) /cx set stagger= nn (9000 only) /cx set autocarve=on|off (9000 only) /cx set rebuild=enable|disa[...]

Help Commands www.3ware.com 85 help This help command provide a table of contents, providin g help with the overall navigation of the CLI comman d s. T ypical output looks like the following. //localhost> help Copyright(c) 2004, 2005 Applied Micr o Circuits Corporation (AMCC). All rights reserved. AMCC/3ware CLI (version 2.x) Commands Descriptio[...]

Chapter 2. CLI Syntax Refere nce 86 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 help res can This command provides spec ific rescan related help, illustrating various ways to use the rescan command. See the section “Shell Object Commands” on page 19 for more information. help upda te This command provides specific u pdate-re[...]

Return Code www.3ware.com 87 help /c x /bbu This command provides specific /c x /bbu related help, illustrating various ways to use the /c x /bbu command. Se e the section “BBU Object Com mands” on page 74 for mo re information. help /e x This command provide s specific enclosure /e x related help, illustrating various commands associated with [...]