AMCC 720-0140-00 User manual

3ware®
Serial ATA RAID Controller
Command Line Interface
Supports the 9590SE-4ME for the Power Mac® G5
PN: 720-0140-00
September 2006
CLI Guide for the Power Mac G5

www.3ware.com ii
Copyright
©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. This
publication may be copied or reproduced for reference purposes only. All other
purposes require the express written consent of AMCC, 215 Moffett Park Drive,
Sunnyvale, CA 94089. AMCC shall not be responsible or liable for, and shall be held
harmless against, any and all damages, claims, and/or disputes that arise from the
copying or reproduction of this publication.
Trademarks
3ware®, Escalade®, 3DM®, and TwinStor® are all registered trademarks of AMCC.
The 3ware logo, 3BM , StorSwitch , and R5 Fusion are all trademarks of AMCC.
Apple®, the Apple logo, and PowerMac® are trademarks of Apple Computer Inc.,
registered in the United States and/or other countries. Safari is a trademark of Apple
Computer, Inc. PowerPC and the PowerPC logo are trademarks of International
Business Machines Corporation. Linux® is a registered trademark of Linus Torvalds
in the United States, other countries, or both. Windows® is a registered trademark of
Microsoft Corporation in the United States and other countries. Firefox® is a
registered trademark of the Mozilla Foundation. PCI Express® is a registered
trademark of PCI-SIG®. All other trademarks herein are property of their respective
owners.
Disclaimer
While every attempt is made to make this document as accurate as possible, AMCC
assumes no responsibility for errors or omissions in this document, nor does AMCC
make any commitment to update the information contained herein.

www.3ware.com iii
Table of Contents
Chapter 1. Introduction to the 3ware Command Line Interface . . . . . . .3
Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Terminology . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4
Installing the 3ware CLI on Mac OS X . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Working with 3ware CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5
Using the command interface interactively . . . . . . . . . . . . . . . . . . . . . . . . . .6
Using a single command with output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6
Using an input file to execute a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Outputting the CLI to a Text File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
Understanding RAID Levels and Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
RAID Concepts . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Available RAID Configurations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .10
Determining What RAID Level to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Chapter 2. CLI Syntax Reference. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Common Tasks Mapped to CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . .15
Syntax Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18
Shell Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
focus Object . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20
show ver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .21
show alarms [reverse] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
show diag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
show rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22
show verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
show selftest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .23
flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
update fw=filename_with_path [force] . . . . . . . . . . . . . . . . . . . . . . . . . . . .24
Controller Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .25
/cxshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .26
/cxshow attribute [attribute ...] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .27
/cxshow driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
/cxshow model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
/cxshow firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
/cxshow bios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
/cxshow monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .28
/cxshow serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
/cxshow pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
/cxshow pchip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
/cxshow achip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29

iv 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5
/cxshow numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .29
/cxshow numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
/cxshow numunits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
/cxshow ctlbus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
/cxshow exportjbod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .30
/cxshow spinup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
/cxshow stagger . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
/cxshow ondegrade . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
/cxshow autocarve . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
/cxshow carvesize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
/cxshow memory . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
/cxshow autorebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
/cxshow unitstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .33
/cxshow allunitstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
/cxshow drivestatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .34
/cxshow all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .35
/cxadd type=<RaidType> disk=<p:-p> [stripe=Stripe] [noscan]
[group=<3|4|5|6>] [nocache] [autoverify] [ignoreECC] [name=string]
[storsave=<protect|balance|perform>] . . . . . . . . . . . . . . . . . . . . . . . . . . .36
/cxrescan [noscan] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .38
/cxcommit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
/cxflush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .39
/cxupdate fw=filename_with_path [force] . . . . . . . . . . . . . . . . . . . . . . . . . .39
/cxshow alarms [reverse] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
/cxshow diag . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .40
/cxshow rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .41
/cxshow verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
/cxshow selftest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .44
/cxadd rebuild=ddd:hh:duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .45
/cxadd verify=ddd:hh:duration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .46
/cxadd selftest=ddd:hh . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
/cxdel rebuild=slot_id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .47
/cxdel verify=slot_id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
/cxdel selftest=slot_id . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
/cxset rebuild=enable|disable|1..5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .48
/cxset verify=enable|disable|1..5 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
/cxset selftest=enable|disable [task=UDMA|SMART] . . . . . . . . . . . . . . . . .49
/cxset exportjbod=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .49
/cxset ondegrade=cacheoff|follow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
/cxset spinup=nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
/cxset stagger=nn . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
/cxset autocarve=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .50
/cxset carvesize=[1024..2048] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
/cxset autorebuild=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .51
/cxstart mediascan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
/cxstop mediascan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .52
Unit Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
/cx/uxshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .53
/cx/uxshow attribute [attribute ...] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
/cx/uxshow status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .54
/cx/uxshow rebuildstatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
/cx/uxshow verifystatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
/cx/uxshow initializestatus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55

www.3ware.com v
/cx/uxshow name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
/cx/uxshow serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .55
/cx/uxshow qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
/cx/uxshow storsave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
/cx/uxshow identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
/cx/uxshow autoverify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .56
/cx/uxshow cache . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
/cx/uxshow ignoreECC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
/cx/uxshow volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
/cx/uxshow all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .57
/cx/uxremove [noscan] [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
/cx/ux del [noscan] [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .58
/cx/uxstart rebuild disk=p<p:-p...> [ignoreECC] . . . . . . . . . . . . . . . . . . . . .59
/cx/uxstart verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .59
/cx/uxpause rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
/cx/uxresume rebuild . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
/cx/ux stop verify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .60
/cx/uxflush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
/cx/uxset autoverify=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
/cx/uxset cache=on|off [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .61
/cx/uxset identify=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
/cx/uxset ignoreECC=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
/cx/uxset name=string . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
/cx/uxset qpolicy=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .62
/cx/uxset storsave=protect|balance|perform [quiet] . . . . . . . . . . . . . . . . . . .63
/cx/uxmigrate type=RaidType [disk=p:-p]
[group=3|4|5|6] [stripe=Stripe] [noscan] [nocache] [autoverify] . . . . . . . . .64
Port Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
/cx/px show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
/cx/pxshow attribute [attribute ...] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .69
/cx/pxshow status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
/cx/pxshow model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
/cx/pxshow serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
/cx/pxshow firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
/cx/pxshow identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .70
/cx/pxshow ncq . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
/cx/pxshow lspeed . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
/cx/pxshow capacity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
/cx/pxshow smart . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .71
/cx/pxshow all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .72
/cx/pxremove [noscan] [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
/cx/pxset identify=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .73
BBU Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
/cx/bbu show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .74
/cx/bbu show attribute [attribute ...] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
/cx/bbu show status . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .75
/cx/bbu show batinst . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
/cx/bbu show lasttest . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
/cx/bbu show volt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
/cx/bbu show temp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
/cx/bbu show cap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .76
/cx/bbu show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
/cx/bbu show fw . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77

vi 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5
/cx/bbu show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
/cx/bbu show bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
/cx/bbu show all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
/cx/bbu test [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .77
/cx/bbu enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
/cx/bbu disable [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .78
Enclosure Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
/exshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .79
/exshow attribute [attribute ...] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
/exshow controllers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
/exshow slots . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .80
/exshow fans . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
/exshow temp . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
/exshow all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
/ex/slotxshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .81
/ex/slotxshow identify . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
/ex/slotxset identify=on|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
/ex/fanxshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
/ex/tempxshow . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .82
Help Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
Help with specific commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .83
Help with attributes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .84
help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
help show . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
help flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .85
help rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help update . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help focus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help /cx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help /cx/ux . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help /cx/px . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .86
help /cx/bbu . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
help /ex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
help /ex/slotx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
help /ex/fanx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
help /ex/tempx . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87
Return Code . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .87

www.3ware.com 1
About this CLI Guide
3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 provides
instructions for configuring and maintaining your 3ware controller using
3ware’s command line interface (CLI).
There are often multiple ways to accomplish the same configuration and
maintenance tasks for your 3ware controller. While this manual includes
instructions for performing tasks using the command line interface, you can
also use 3DM®2 (3ware Disk Manager) to accomplish these tasks.
For details, see the user guide or the 3ware HTML Bookshelf.
Note: This guide assumes that you have already installed your 3ware RAID
controller in your system and set up your 3ware Sidecar. If you have not yet done
so, see the installation guide that came with your 3ware RAID controller for
instructions.
Note: The 3ware controller used for the Apple® Power Mac® G5 is the 9590SE-
4ME. AMCC makes a number of other 3ware controller models, including 9000-
series (9500S, 9550SX, and 9590SE), and earlier 7000/8000 series boards, that
work on other platforms.
The Command Syntax described in this document supports all of those boards, and
some commands indicate the particular boards that support the command.
For your Power Mac G5, the CLI commands that apply to the 9590SE-4ME are
those identified as 9000 series and those that are identified as 9590SE.
Note: You may notice mention of RAID 50 in the Command Syntax sections. RAID
50 requires six or more drives, and so is not available using the 9590SE-4ME.
Table 1: Sections in this CLI Guide
Chapter Description
1. Introduction to 3ware
Command Line Interface Installation, features, concepts
2. CLI Syntax Reference Describes individual commands using the
primary syntax

23ware Serial ATA RAID Controller CLI Guide for the Power Mac G5

www.3ware.com 3
1
Introduction to the 3ware
Command Line Interface
3ware RAID controllers can be managed using the CLI via a command line or
script.
This chapter includes the following sections:
•“Features of the CLI” on page 3
•“Installing the 3ware CLI on Mac OS X” on page 5
•“Working with 3ware CLI” on page 5
•“Understanding RAID Levels and Concepts” on page 8
Features of the CLI
3ware CLI is a command line interface for managing 3ware RAID
Controllers. It provides controller, logical unit, drive, and enclosure
management. It can be used in both interactive and batch mode, providing
higher level API (application programming interface) functionalities.
You can use the CLI to view unit status and version information and perform
maintenance functions such as adding or removing drives. 3ware CLI also
includes advanced features for creating and deleting RAID units online.
For a summary of what you can do using the CLI, see “Common Tasks
Mapped to CLI Commands” on page 15.
Important!
For all of the functions of the 3ware CLI to work properly, you must have the proper
CLI, firmware, and driver versions installed. Check http://www.3ware.com for the
latest versions and upgrade instructions.

Chapter 1. Introduction to the 3ware Command Line Interface
43ware Serial ATA RAID Controller CLI Guide for the Power Mac G5
Supported Operating Systems
The 3ware CLI is supported under the following operating systems:
•MacOSX,running in a Power Mac® G5 (PowerPC™-based) with PCI
Express®.
•Windows®.Windows 2000, Windows XP, and Windows Server 2003,
both 32-bit and 64-bit.
• Linux®.Redhat, SuSE, both 32-bit and 64-bit.
• FreeBSD®, both 32-bit and 64-bit.
Terminology
This document (3ware Serial ATA RAID Controller CLI Guide for the Power
Mac G5) uses the following terminology:
Logical Units. Usually shortened to “units.” These are block devices
presented to the operating system. A logical unit can be a one-tier, two-tier, or
three-tier arrangement. Spare and Single logical units are examples of one-tier
units. RAID 1 and RAID 5 are examples of two-tier units and as such will
have sub-units. RAID 10 is an example of a three-tier unit and as such will
have sub-sub-units.
Port. A controller has one or many ports. Each port can be attached to a single
disk drive. On a controller such as the 9590SE-4ME, with a multilane serial
port connector, one connector supports four ports.
For additional information about 3ware controller concepts and terminology,
see the user guide that came with your 3ware RAID controller or the user
guide portions of the 3ware HTML Bookshelf.