AMCC 3WARE 9590SE User's Guide

3ware® SAS/SATARAID ControllerCommand Line Interface Version 9.5—Supports the 9000 Series(9690SA, 9650SE, 9590SE, 9550SX, and 9500S)PN: 720-0176-00 S

Chapter 1. Introduction to the 3ware Command Line Interface4 3ware Serial ATA RAID Controller User Guide more expanders. The VPort ID allows a drive t

Chapter 2. CLI Syntax Reference94 3ware Serial ATA RAID Controller User Guide The maximum temperature for successful use of a drive should be noted in

Enclosure Object Commandswww.3ware.com 95 /cx/ex/slotx show identifyThis command is used by 9690SA controllers.This command shows the identify status

Chapter 2. CLI Syntax Reference96 3ware Serial ATA RAID Controller User Guide /cx/ex/fanx set identify=on|offThis command is used by 9690SA controller

Enclosure Object Commandswww.3ware.com 97 /cx/ex/pwrsx set identify=on|offThis command is used by 9690SA controllers.This command causes the power su

Chapter 2. CLI Syntax Reference98 3ware Serial ATA RAID Controller User Guide Setting identify to on will cause the LED associated with that temp sens

Help Commandswww.3ware.com 99 [nocache][group=<3|4|5|6|7|8|9|10|11|12|13|14|15|16>] [autoverify][ignoreECC] [name=string (9000 series)][storsav

Chapter 2. CLI Syntax Reference100 3ware Serial ATA RAID Controller User Guide SX/SE/SA only)|serial|ondegrade (9500S only)|pcb|pchip|spinup|stagger|u

Help Commandswww.3ware.com 101 help flushThis command provides specific flush-related help, illustrating various ways to use the flush command. See t

Chapter 2. CLI Syntax Reference102 3ware Serial ATA RAID Controller User Guide help /cx/uxThis command provides specific unit /cx/ux related help, ill

Command Loggingwww.3ware.com 103 help /cx/ex/pwrsxThis command provides specific power supply /cx/ex/pwrsx related help, illustrating various ways to

Installing the 3ware CLIwww.3ware.com 5 Permissions Required to Run CLITo run CLI, you can be logged onto Windows with one of the following sets of p

Chapter 2. CLI Syntax Reference104 3ware Serial ATA RAID Controller User Guide 0If you type:tw_cli /c7 showerror: (CLI003) specified controller does n

Chapter 1. Introduction to the 3ware Command Line Interface6 3ware Serial ATA RAID Controller User Guide • If no GUI is installed, navigate to package

Working with 3ware CLIwww.3ware.com 7 Examples shown in the CLI Syntax Reference chapter reflect the interactive method.Using the command interface i

Chapter 1. Introduction to the 3ware Command Line Interface8 3ware Serial ATA RAID Controller User Guide Example tw_cli /c0 show diag > /tmp/3w_dia

Understanding RAID Levels and Conceptswww.3ware.com 9 Outputting the CLI to a Text FileYou can have the output of the 3ware CLI, including errors, se

Chapter 1. Introduction to the 3ware Command Line Interface10 3ware Serial ATA RAID Controller User Guide This section organizes information about RAI

Understanding RAID Levels and Conceptswww.3ware.com 11 Available RAID ConfigurationsRAID is a method of combining several hard drives into one unit.

Chapter 1. Introduction to the 3ware Command Line Interface12 3ware Serial ATA RAID Controller User Guide RAID 1RAID 1 provides fault tolerance and a

Understanding RAID Levels and Conceptswww.3ware.com 13 Figure 3. RAID 5 Configuration Example RAID 6RAID 6 requ

www.3ware.com iiCopyright ©2003-2007 Applied Micro Circuits Corporation (AMCC). All rights reserved. This publication may be copied or reproduced for

Chapter 1. Introduction to the 3ware Command Line Interface14 3ware Serial ATA RAID Controller User Guide Figure 4. RAID 6 Configuration Example

Understanding RAID Levels and Conceptswww.3ware.com 15 Figure 5. RAID 10 Configuration Example RAID 50RAID 50 i

Chapter 1. Introduction to the 3ware Command Line Interface16 3ware Serial ATA RAID Controller User Guide Figure 6. RAID 50 Configuration Example

Understanding RAID Levels and Conceptswww.3ware.com 17 Hot SpareA hot spare is a single drive, available online, so that a redundant unit can be auto

Chapter 1. Introduction to the 3ware Command Line Interface18 3ware Serial ATA RAID Controller User Guide Using Drive Capacity EfficientlyTo make the

Understanding RAID Levels and Conceptswww.3ware.com 19 Through drive coercion, the capacity used for each drive is rounded down so that drives from d

20 3ware Serial ATA RAID Controller User Guide2 CLI Syntax ReferenceThis chapter provides detailed information about using the command syntax for the

Common Tasks Mapped to CLI Commandswww.3ware.com 21 Unit Configuration TasksCreate a new unit /cx add 40Create a hot spare /cx add 40Enable/disable

Chapter 2. CLI Syntax Reference22 3ware Serial ATA RAID Controller User Guide Syntax OverviewThe command syntax uses the general form:Object Command

Syntax Overviewwww.3ware.com 23 Attributes are either Boolean Attributes or Name-Value Attributes. • The value of a boolean attribute is deduced by p

www.3ware.com iii Table of ContentsAbout this CLI Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1Chapter

Chapter 2. CLI Syntax Reference24 3ware Serial ATA RAID Controller User Guide Enclosure Object Commands. Enclosure object commands provide information

Shell Object Commandswww.3ware.com 25 / specifies the root./object specifies the next level of the object./c0/bbu specifies a relative path with resp

Chapter 2. CLI Syntax Reference26 3ware Serial ATA RAID Controller User Guide Note that the device drivers for the appropriate operating system should

Shell Object Commandswww.3ware.com 27 show rebuildThis command displays all rebuild schedules for the 9000 series controllers in the system. The rebu

Chapter 2. CLI Syntax Reference28 3ware Serial ATA RAID Controller User Guide show verThis command will show the CLI and API version. Example://localh

Controller Object Commandswww.3ware.com 29 Controller Object CommandsController object commands provide information and perform actions related to a

Chapter 2. CLI Syntax Reference30 3ware Serial ATA RAID Controller User Guide /cx set stagger=nn (9000 series)/cx set autocarve=on|of

Controller Object Commandswww.3ware.com 31 The Port summary section lists all present ports (or virtual ports) and specifies the port number, disk st

Chapter 2. CLI Syntax Reference32 3ware Serial ATA RAID Controller User Guide /cx show attribute [attribute ...]This command shows the current setting

Controller Object Commandswww.3ware.com 33 default carvesize is 2TB. For more information see, “/cx show memory”, below. For operating systems that s

iv 3ware Serial ATA RAID Controller User Guide /cx show driver . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. CLI Syntax Reference34 3ware Serial ATA RAID Controller User Guide /cx show carvesizeThis feature only applies to 9000 series SX/SE/SA mode

Controller Object Commandswww.3ware.com 35 p5 OK u2 149.05 GB 312581808 3JS0VH1P p6 OK - 149.05 G

Chapter 2. CLI Syntax Reference36 3ware Serial ATA RAID Controller User Guide /cx show memoryThis command reports the available memory on the controll

Controller Object Commandswww.3ware.com 37 Example: //localhost> /c0 show numports /c0 Number of Ports = 12For the 9690SA, this command reports th

Chapter 2. CLI Syntax Reference38 3ware Serial ATA RAID Controller User Guide /cx show serialThis command reports the serial number of the specified c

Controller Object Commandswww.3ware.com 39 Example: //localhost> /c2 show unitstatus Unit UnitType Status %RCmpl %V/I/M Stripe Size(GB)

Chapter 2. CLI Syntax Reference40 3ware Serial ATA RAID Controller User Guide p4 OK u0 34.25 GB SAS - /c0/e0/slt5 MAXTOR ATLAS15K

Controller Object Commandswww.3ware.com 41 /cx show phyThis command is for the 9690SA only. It reports a list of the phys for the controller.Example

Chapter 2. CLI Syntax Reference42 3ware Serial ATA RAID Controller User Guide enabled. For in depth information about rebuild and other background tas

Controller Object Commandswww.3ware.com 43 If you then enable the rebuild schedules, the unit initialization will be paused until the next scheduled

www.3ware.com v /cx/ux show ignoreECC . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 63/cx/ux show initializesta

Chapter 2. CLI Syntax Reference44 3ware Serial ATA RAID Controller User Guide For details about setting up a schedule for background selftest tasks, s

Controller Object Commandswww.3ware.com 45 Selftest Schedule for Controller /c1 ======================================================== Slot Day

Chapter 2. CLI Syntax Reference46 3ware Serial ATA RAID Controller User Guide A status of “disabled” indicates that the controller will not use the de

Controller Object Commandswww.3ware.com 47 The following table shows supported types and controller models. disk

Chapter 2. CLI Syntax Reference48 3ware Serial ATA RAID Controller User Guide group=3|4|5|6|7|8|9|10|11|12/13|14|15|16 indicates the number of disks p

Controller Object Commandswww.3ware.com 49 noqpolicy attribute instructs CLI to disable the qpolicy (drive queuing for SATA drives only) on the newly

Chapter 2. CLI Syntax Reference50 3ware Serial ATA RAID Controller User Guide Creating new unit on Controller /c0 ... Done. The new unit is /c0/u0. S

Controller Object Commandswww.3ware.com 51 /cx commit This command only applies to the Windows operating system. It commits all changes if a faster s

Chapter 2. CLI Syntax Reference52 3ware Serial ATA RAID Controller User Guide Example: //localhost> /c0 update fw=/tmp/prom0006.imgWarning: Updatin

Controller Object Commandswww.3ware.com 53 To set up the rebuild schedule you want to use, follow this process:1 Use the /cx show rebuild command to

vi 3ware Serial ATA RAID Controller User Guide /cx/bbu show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. CLI Syntax Reference54 3ware Serial ATA RAID Controller User Guide 4Use the /cx set verify=enable command to enable the schedule (this enab

Controller Object Commandswww.3ware.com 55 /cx del rebuild=slot_idThis command removes the rebuild background task in slot slot_id. Example: //localh

Chapter 2. CLI Syntax Reference56 3ware Serial ATA RAID Controller User Guide The priority of rebuild versus I/O operations is specified with 1..5, wh

Controller Object Commandswww.3ware.com 57 /cx set ondegrade=cacheoff|followThis command is only for 9500S controllers.This command allows you to set

Chapter 2. CLI Syntax Reference58 3ware Serial ATA RAID Controller User Guide volume. Each volume can then be treated as an individual disk with its o

Controller Object Commandswww.3ware.com 59 having to specify it as a spare. It also means that if you accidentally disconnect a drive (causing the co

Chapter 2. CLI Syntax Reference60 3ware Serial ATA RAID Controller User Guide Example://localhost>> /c0 set autodetect=off disk=allSetting Auto

Unit Object Commandswww.3ware.com 61 Unit Object CommandsUnit Object commands provide information and perform actions related to a specific unit, suc

Chapter 2. CLI Syntax Reference62 3ware Serial ATA RAID Controller User Guide /cx/ux showThis command shows summary information about the specified un

Unit Object Commandswww.3ware.com 63 /cx/ux show attribute [attribute ...]This command shows the current setting of the specified attributes. One or

www.3ware.com 1 About this CLI Guide3ware SAS/SATA RAID Controller CLI Guide provides instructions for configuring and maintaining your 3ware control

Chapter 2. CLI Syntax Reference64 3ware Serial ATA RAID Controller User Guide /cx/ux show initializestatusThis command reports the initializestatus (i

Unit Object Commandswww.3ware.com 65 /cx/ux show serialThis feature only applies to 9000 series controllers.This command reports the unique serial nu

Chapter 2. CLI Syntax Reference66 3ware Serial ATA RAID Controller User Guide /cx/ux show volumesThis feature only applies to 9000 series controllers.

Unit Object Commandswww.3ware.com 67 u1-11 DISK OK - - p11 - 298.01 u1/v0 Volume - -

Chapter 2. CLI Syntax Reference68 3ware Serial ATA RAID Controller User Guide Example of interactive mode: //localhost> /c0/u0 delDeleting /c0/u0 w

Unit Object Commandswww.3ware.com 69 When you issue this command, the specified verify will begin if schedules are disabled; otherwise it will pause

Chapter 2. CLI Syntax Reference70 3ware Serial ATA RAID Controller User Guide /cx/ux flushThis command allows you to flush the write cache on the spec

Unit Object Commandswww.3ware.com 71 /cx/ux set identify=on|offThis feature only applies to 9000 series SX/SE/SA model controllers.This feature requi

Chapter 2. CLI Syntax Reference72 3ware Serial ATA RAID Controller User Guide /cx/ux set qpolicy=on|off This feature only applies to 9000 series SX/SE

Unit Object Commandswww.3ware.com 73 • Incoming FUA (Force Unit Access) host requests will be honored.If you set the storsave policy to perform, a co

2 3ware Serial ATA RAID Controller User Guide1 Introduction to the 3ware Command Line InterfaceThe 3ware SATA RAID Controller Command Line Interface (

Chapter 2. CLI Syntax Reference74 3ware Serial ATA RAID Controller User Guide The destination unit must use all source disks and potentially augment t

Unit Object Commandswww.3ware.com 75 disk=p:-p.. consists of a list of ports or VPorts (disks) to be used in addition to the source disks in the cons

Chapter 2. CLI Syntax Reference76 3ware Serial ATA RAID Controller User Guide noscan attribute instructs CLI no

Unit Object Commandswww.3ware.com 77 then use CLI commands to ‘remove’ and ‘rescan’ the unit so that the operating system can see the new capacity, a

Chapter 2. CLI Syntax Reference78 3ware Serial ATA RAID Controller User Guide p3 OK u0 149.05 GB 312581808 WD-WCANM175399

Port Object Commandswww.3ware.com 79 Port Object CommandsPort Object Messages are commands that provide information and perform actions related to a

Chapter 2. CLI Syntax Reference80 3ware Serial ATA RAID Controller User Guide The VPort number provides a handle by which to identify the drive, even

Port Object Commandswww.3ware.com 81 /cx/px show firmwareThis command displays the firmware version of the drive attached to the specified port. Exam

Chapter 2. CLI Syntax Reference82 3ware Serial ATA RAID Controller User Guide /cx/px show ncqThis command only applies to 9000 series SX/SE/SA model c

Port Object Commandswww.3ware.com 83 /cx/px show statusThis command displays the status of the drive attached to the specified port. (Definitions of

Supported Operating Systemswww.3ware.com 3 You can use the CLI to view unit status and version information and perform maintenance functions such as

Chapter 2. CLI Syntax Reference84 3ware Serial ATA RAID Controller User Guide 00 00 00 00 00 00 C7 3E 00 C8 C8 00 00 00 00 0000 00 C8 00 00 64 FD 00 0

Phy Object Commandswww.3ware.com 85 /cx/px set identify=on|offThis command applies only to 9000 series SX/SE/SA controllers.This command sets the LED

Chapter 2. CLI Syntax Reference86 3ware Serial ATA RAID Controller User Guide BBU Object CommandsBBU (Battery Backup Unit) Object Commands are command

BBU Object Commandswww.3ware.com 87 /cx/bbu show attribute [attribute ...]This command shows the current setting of the given attribute(s) on the BBU

Chapter 2. CLI Syntax Reference88 3ware Serial ATA RAID Controller User Guide /cx/bbu show serialThis command shows the BBU serial number. /cx/bbu sho

BBU Object Commandswww.3ware.com 89 /cx/bbu show tempThis command shows the temperature status of the battery. The status can be OK, HIGH, LOW, TOO-H

Chapter 2. CLI Syntax Reference90 3ware Serial ATA RAID Controller User Guide /cx/bbu test [quiet]This command starts the battery capacity test. The t

Enclosure Object Commandswww.3ware.com 91 Enclosure Object CommandsEnclosure object commands provide information and perform actions related to a spe

Chapter 2. CLI Syntax Reference92 3ware Serial ATA RAID Controller User Guide Example: //localhost> /c0/e0 show Encl Status ---------------

Enclosure Object Commandswww.3ware.com 93 /cx/ex/ show diag=helptextThis command is used with the 9690SA controller.This command allows you to view t