LSI 9690SA-8E-KIT Installation Guide

3ware® SATA+SASRAID Controller Card Command Line Interface Version 10.2 – Supports the 9750, 9690SA, and 9650SE ModelsPN: 45413-00, Rev. AMay 2010CLI

Chapter 1. Introduction to the 3ware Command Line Interface2 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Supported Operating Systems3w

Chapter 2. CLI Syntax Reference92 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Port Object CommandsPort object messages are commands th

Port Object Commandswww.lsi.com/channel/products 93 /cx/px show attribute [attribute ...]The /cx/px show attribute command shows the current setting

Chapter 2. CLI Syntax Reference94 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/px show identifyThe /cx/px show identify command req

Port Object Commandswww.lsi.com/channel/products 95 /cx/px show serialThe /cx/px show serial command shows the serial number of the drive attached t

Chapter 2. CLI Syntax Reference96 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 00 00 00 00 00 00 C4 32 00 C7 C7 01 00 00 00 0000 00 C5

Port Object Commandswww.lsi.com/channel/products 97 /c3/p3 Interface Type = Direct/c3/p3 Drive Ports = 1/c3/p3 Drive Connections = 1/c3/p3 Link Spee

Chapter 2. CLI Syntax Reference98 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /c1/p2 Status = OK/c1/p2 Model = SEAGATE ST936701SS/c1/p

Port Object Commandswww.lsi.com/channel/products 99 Monitoring” in the 3ware SATA+SAS RAID Controller Card Software User Guide, Version 10.2.Example

Chapter 2. CLI Syntax Reference100 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 6 6 0 7 7

Port Object Commandswww.lsi.com/channel/products 101 /cx/px remove [quiet]The /cx/px remove command allows you to remove (or export) a port (or driv

Installing the 3ware CLIwww.lsi.com/channel/products 3 • Copy the file from the 3ware CD. Copy the file tw_cli.exe to the directory from which you wa

Chapter 2. CLI Syntax Reference102 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 This command allows you to clear the statistics counter

BBU Object Commandswww.lsi.com/channel/products 103 Supported, Enabled, and Control. The Supported and Enabled values are set for the phy and are no

Chapter 2. CLI Syntax Reference104 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/bbu show attribute [attribute ...] where attributes

BBU Object Commandswww.lsi.com/channel/products 105 /cx/bbu show bootloaderThe /cx/bbu show bootloader command shows the BBU's boot loader vers

Chapter 2. CLI Syntax Reference106 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/bbu show statusThe /cx/bbu show status command show

BBU Object Commandswww.lsi.com/channel/products 107 /cx/bbu show tempThe /cx/bbu show temp command shows the temperature status of the battery. The

Chapter 2. CLI Syntax Reference108 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /c1/bbu Battery Temperature Status = OK/c1/bbu Battery

Enclosure Object and Element Commandswww.lsi.com/channel/products 109 Enclosure Object and Element CommandsEnclosure object commands provide informa

Chapter 2. CLI Syntax Reference110 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ex/fanx set identify=on|off /cx/ex/fanx set speed=&

Enclosure Object and Element Commandswww.lsi.com/channel/products 111 pwrs0 OK on OK OK Off pwrs1

Chapter 1. Introduction to the 3ware Command Line Interface4 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 To install 3ware CLI on Linux

Chapter 2. CLI Syntax Reference112 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ex/ show diag=helptextThe /cx/ex show diag=helptext

Enclosure Object and Element Commandswww.lsi.com/channel/products 113 2 - Low3 - Medium-low4 - Medium5 - Medium-high6 - High7 - HighestThe Identify

Chapter 2. CLI Syntax Reference114 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ex show pwrsThe /cx/ex show pwrs command applies on

Enclosure Object and Element Commandswww.lsi.com/channel/products 115 /cx/ex show allThe /cx/ex/show all command applies only to 9750 and 9690SA con

Chapter 2. CLI Syntax Reference116 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ex/slotx set identify=on|offThe /cx/ex/slotx set id

Enclosure Object and Element Commandswww.lsi.com/channel/products 117 /cx/ex/fanx set identify=on|offThe /cx/ex/fanx set identify command applies on

Chapter 2. CLI Syntax Reference118 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 are OK and OVER-CURRENT. In either case, OVER means ove

Enclosure Object and Element Commandswww.lsi.com/channel/products 119 /cx/ex/tempx showThe /cx/ex/tempx show command applies only to 9750 and 9690SA

Chapter 2. CLI Syntax Reference120 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ex/almx showThe /cx/ex/almx show command applies on

Enclosure Object and Element Commandswww.lsi.com/channel/products 121 Example: //localhost> /c0/e0/alm0 set

Installing the 3ware CLIwww.lsi.com/channel/products 5 c Respond to each screen as the script walks you through the installation.d After the installa

Chapter 2. CLI Syntax Reference122 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Help CommandsThe Help commands provides brief on-line h

Help Commandswww.lsi.com/channel/products 123 (group=13-16 9750/9690SA)[name=string (9000 series)] [ignoreECC][autoverify][noqpolicy][v0=n|vol=a:b:c

Chapter 2. CLI Syntax Reference124 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 bios|carvesize(9000series)|driver|drivestatus|firmware|

Help Commandswww.lsi.com/channel/products 125 help showThe help show command provides specific show-related help, illustrating various ways to use t

Chapter 2. CLI Syntax Reference126 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 help /cx/ux The help /cx/ux command provides specific u

Command Loggingwww.lsi.com/channel/products 127 help /cx/ex/tempx help /cx/ex/tempx command provides specific temperature sensor cx/ex/tempx-related

Chapter 2. CLI Syntax Reference128 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Window. To make the folder permanently visible, select

Return Codewww.lsi.com/channel/products 129 For WindowsUnder Windows, you set the environment variable through

Chapter 2. CLI Syntax Reference130 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 If you type the followingtw_cli /c7 showerror: (CLI003)

Chapter 1. Introduction to the 3ware Command Line Interface6 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Installing the 3ware CLI on M

Working with 3ware CLIwww.lsi.com/channel/products 7 Using the command interface interactivelyYou can use the CLI interactively by entering commands

Chapter 1. Introduction to the 3ware Command Line Interface8 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Using an input file to execut

Understanding RAID Levels and Conceptswww.lsi.com/channel/products 9 Outputting the CLI to a Text FileYou can send the output of the 3ware CLI, inclu

Chapter 1. Introduction to the 3ware Command Line Interface10 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 • “Available RAID Configurat

Understanding RAID Levels and Conceptswww.lsi.com/channel/products 11 Available RAID ConfigurationsRAID is a method of combining several hard drives

Document DescriptionDocument 45413-01, Rev. A. May 2010.This document will remain the official reference source for all revisions and releases of this

Chapter 1. Introduction to the 3ware Command Line Interface12 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 technology, read performance

Understanding RAID Levels and Conceptswww.lsi.com/channel/products 13 RAID 6RAID 6 provides greater redundancy and fault tolerance than RAID 5. It is

Chapter 1. Introduction to the 3ware Command Line Interface14 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 structure. Higher data trans

Understanding RAID Levels and Conceptswww.lsi.com/channel/products 15 Figure 6. RAID 50 Configuration Example S

Chapter 1. Introduction to the 3ware Command Line Interface16 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Hot SpareA hot spare is a si

Understanding RAID Levels and Conceptswww.lsi.com/channel/products 17 Using Drive Capacity EfficientlyBecause the capacity of each drive is limited t

Chapter 1. Introduction to the 3ware Command Line Interface18 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Through drive coercion, the

19 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.22 CLI Syntax ReferenceThis chapter provides detailed information about using the command

Chapter 2. CLI Syntax Reference20 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Update controller with new firmware /cx update 58Add a t

Common Tasks Mapped to CLI Commandswww.lsi.com/channel/products 21 Set the storsave profile /cx/ux set storsave 84Unit Configuration ChangesChange R

www.lsi.com/channel/products iii Table of ContentsAbout this CLI Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. CLI Syntax Reference22 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Terminology3ware SATA+SAS RAID Controller Card CLI Guide

Syntax Overviewwww.lsi.com/channel/products 23 Phy. Phys are transceivers that transmit and receive the serial data stream that flows between the co

Chapter 2. CLI Syntax Reference24 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Example: When adding (creating) a unit to the controller

Shell Object Commandswww.lsi.com/channel/products 25 Help Commands. Help commands allow you to get help information for all commands and attributes.

Chapter 2. CLI Syntax Reference26 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 • /c0/bbu specifies a relative path with respect to the

Shell Object Commandswww.lsi.com/channel/products 27 Example for 9750-8i controller without an enclosure and expander:Typical output of the Show com

Chapter 2. CLI Syntax Reference28 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 show events [reverse]The show events command is the same

Shell Object Commandswww.lsi.com/channel/products 29 show selftestThe show selftest command shows all selftest schedules for the 3ware RAID controll

Chapter 2. CLI Syntax Reference30 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 ========================================================

Controller Object Commandswww.lsi.com/channel/products 31 /cx show rebuildmode /cx show rebuildrate /cx show verify

iv 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx show carvesize . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. CLI Syntax Reference32 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx showThe /cx show command shows summary information o

Controller Object Commandswww.lsi.com/channel/products 33 ( if direct attached), the enclosure and slot (if expander attached), and model number of

Chapter 2. CLI Syntax Reference34 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx show achipThe /cx show achip command shows the SAS+S

Controller Object Commandswww.lsi.com/channel/products 35 3. Smallest usable failed drive.If the policy is disabled, only spare drives are used for

Chapter 2. CLI Syntax Reference36 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx show dpmstat [type=inst|ra|ext]The /cx show dpmstat

Controller Object Commandswww.lsi.com/channel/products 37 Queue Xfer Resp Port Status Unit De

Chapter 2. CLI Syntax Reference38 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 p6 0 0 0 0 0

Controller Object Commandswww.lsi.com/channel/products 39 p18 OK u0 34.18 GB SAS - /c2/e1/slt7 HITACHI HUS151436VL p19 OK

Chapter 2. CLI Syntax Reference40 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx show monitorThe /cx show monitor command shows the m

Controller Object Commandswww.lsi.com/channel/products 41 /cx show pchipThe /cx show pchip command shows the PCI Interface Chip (PCHIP) version of t

www.lsi.com/channel/products v /cx set selftest=enable|disable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 68/cx s

Chapter 2. CLI Syntax Reference42 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 available in the 3ware SATA+SAS RAID Controller Card Sof

Controller Object Commandswww.lsi.com/channel/products 43 /c1 Verify Mode = Adaptive/c1 Verify Rate = 1/c1 Controller Bus Type = PCIe/c1 Controller

Chapter 2. CLI Syntax Reference44 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 oldest event messages appear at the top, and the most re

Controller Object Commandswww.lsi.com/channel/products 45 /cx show phyThe /cx show phy command shows a list of the phys with related information for

Chapter 2. CLI Syntax Reference46 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx show rebuildBackground tasks can be scheduled to run

Controller Object Commandswww.lsi.com/channel/products 47 Example for 9750 controller: If a unit is in the initialization state at noon on Wednesday

Chapter 2. CLI Syntax Reference48 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 p9 OK u0 34.18 GB SAS - /c0/e0/slt1

Controller Object Commandswww.lsi.com/channel/products 49 /cx show rebuildrate The /cx show rebuildrate command shows the current rebuild task rate

Chapter 2. CLI Syntax Reference50 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 The show selftest command shows the current selftest bac

Controller Object Commandswww.lsi.com/channel/products 51 doing a media scan and reporting an unreadable sectors. (For information about the initial

vi 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/px show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .

Chapter 2. CLI Syntax Reference52 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 For a more complete discussion of background task modes,

Controller Object Commandswww.lsi.com/channel/products 53 /cx add type=<RaidType> disk=<p:-p> [stripe=size] [noscan] [group=<3|4|5|6|

Chapter 2. CLI Syntax Reference54 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 stripe=size consists of the stripe size to be used. The

Controller Object Commandswww.lsi.com/channel/products 55 newly created unit to Basic. By default (if you do not set a read cache attribute), the re

Chapter 2. CLI Syntax Reference56 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 v0=n can be used if you only want two volumes, in which

Controller Object Commandswww.lsi.com/channel/products 57 Volumes 0 through 3 are carved using the first four sizes, as specified. Volumes 4, 5, an

Chapter 2. CLI Syntax Reference58 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Rescanning controller /c1 for units and drives ...Done

Controller Object Commandswww.lsi.com/channel/products 59 Reboot the system so that the new firmware image takes effect.

Chapter 2. CLI Syntax Reference60 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Setting Up a Rebuild ScheduleSetting up a rebuild schedu

Controller Object Commandswww.lsi.com/channel/products 61 2 Use the /cx del verify command to remove any of the scheduled tasks which do not match y

www.lsi.com/channel/products vii /cx/ex/almx set alarm=mute|unmute|off . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120/cx/ex upda

Chapter 2. CLI Syntax Reference62 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 2 Use the /cx del selftest command to remove any of the

Controller Object Commandswww.lsi.com/channel/products 63 You can see whether the Performance Monitor is currently running and also see a statistics

Chapter 2. CLI Syntax Reference64 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 The Adaptive setting is the default rebuild mode. It all

Controller Object Commandswww.lsi.com/channel/products 65 Example: //localhost> /c1 set rebuildrate=2 Setting Rebuild background task rate on /c1

Chapter 2. CLI Syntax Reference66 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx set verify=advanced|basic|1..5The /cx set verify=adv

Controller Object Commandswww.lsi.com/channel/products 67 When a verify background task is active, if the task rate is set to a fast verify rate (i.

Chapter 2. CLI Syntax Reference68 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Related commands: /cx show verifyrate /cx set verifymod

Controller Object Commandswww.lsi.com/channel/products 69 volume. Each volume can then be treated as an individual disk with its own file system. Th

Chapter 2. CLI Syntax Reference70 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 disconnect a drive (causing the controller to respond to

Unit Object Commandswww.lsi.com/channel/products 71 Usage Scenario: If you are hot-plugging a large number of drives at the same time and are concer

viii www.lsi.com/channel/products About this CLI GuideThis manual, the 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2, provides instruc

Chapter 2. CLI Syntax Reference72 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux set storsave=protect|balance|perform [quiet]/cx/u

Unit Object Commandswww.lsi.com/channel/products 73 completion of the active process and (P) denotes that the percentage completion of the paused pr

Chapter 2. CLI Syntax Reference74 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux show attribute [attribute ...]The /cx/ux show att

Unit Object Commandswww.lsi.com/channel/products 75 /cx/ux show ignoreECCThe /cx/ux show ignoreECC command shows the current setting of the ignoreEC

Chapter 2. CLI Syntax Reference76 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux show rapidrecoveryThe /cx/ux show rapidrecovery c

Unit Object Commandswww.lsi.com/channel/products 77 /cx/ux show storsaveThe /cx/ux show storsave command shows the storsave policy on the unit. For

Chapter 2. CLI Syntax Reference78 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Unit UnitType Status %RCmpl %V/I/M VPort

Unit Object Commandswww.lsi.com/channel/products 79 /cx/ux del [noscan] [quiet]The /cx/ux del command allows you to delete a unit. Deleting a unit n

Chapter 2. CLI Syntax Reference80 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 When you issue this command, the specified rebuild begin

Unit Object Commandswww.lsi.com/channel/products 81 /cx/ux set autoverify=on|offThe /cx/ux set autoverify command allows you to turn on and turn off

www.lsi.com/channel/products 11 Introduction to the 3ware Command Line InterfaceThe 3ware SATA+SAS Controller Card Command Line Interface (CLI) mana

Chapter 2. CLI Syntax Reference82 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux set rdcache=basic|intelligent|offThe /cx/ux set r

Unit Object Commandswww.lsi.com/channel/products 83 /cx/ux set identify=on|offThis command requires a supported enclosure. For additional informatio

Chapter 2. CLI Syntax Reference84 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux set qpolicy=on|off The /cx/ux set qpolicy command

Unit Object Commandswww.lsi.com/channel/products 85 settings. The following description about the settings can help you to decide which one is suita

Chapter 2. CLI Syntax Reference86 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 /cx/ux migrate type=RaidType [disk=p:-p] [group=3|4|5|6|

Unit Object Commandswww.lsi.com/channel/products 87 The following table illustrates valid migration paths:

Chapter 2. CLI Syntax Reference88 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 Note: You can have a maximum of four subunits in a RAID

Unit Object Commandswww.lsi.com/channel/products 89 on your operating system, you might need to first unmount the unit, then use CLI commands to rem

Chapter 2. CLI Syntax Reference90 3ware SATA+SAS RAID Controller Card CLI Guide, Version 10.2 3ware CLI> /c0 show Unit UnitType Status %RCm

Unit Object Commandswww.lsi.com/channel/products 91 Note the difference in UnitType and Status of u0 and u1, even though they are both migrating uni