3Ware 9650SE-2LPB-10 CLI Guide - Page 3

www.3ware.com

iii

Table of Contents

About this CLI Guide

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1

Chapter 1.

Introduction to the 3ware Command Line Interface. . . . . . . . . . . . . . . . . .2

Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Supported Operating Systems

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Terminology

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Installing the 3ware CLI

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Installing the 3ware CLI on Mac OS X

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Installing the 3ware CLI on Windows

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Installing the 3ware CLI on Linux and FreeBSD . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Working with 3ware CLI

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Using the command interface interactively . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7

Using a single command with output

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Using an input file to execute a script . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8

Outputting the CLI to a Text File

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Conventions

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9

Understanding RAID Levels and Concepts

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

RAID Concepts

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

Available RAID Configurations

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

Determining What RAID Level to Use . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17

Chapter 2.

CLI Syntax Reference . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .20

Common Tasks Mapped to CLI Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20

Syntax Overview

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22

Shell Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

focus

Object

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24

show

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25

show ver

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

show alarms [reverse] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

show diag

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

show rebuild

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26

show verify

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27

show selftest

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

commit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

update fw=

filename_with_path

[force]

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28

Controller Object Commands . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

/c

x

show

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30

/c

x

show

attribute

[

attribute

...]

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31

/c

x

show driver

. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

/c

x

show model . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

/c

x

show firmware . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

/c

x

show bios . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

/c

x

show monitor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32

/c

x

show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

/c

x

show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

/c

x

show pchip . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33

Section	Page
Title Page	1
Table of Contents	3
Introduction to the 3ware Command Line Interface	8
Features of the CLI	8
Supported Operating Systems	9
Terminology	9
Installing the 3ware CLI	10
Installing the 3ware CLI on Mac OS X	10
Permissions Required to Run CLI	10
Installing the 3ware CLI on Windows	10
Permissions Required to Run CLI	11
Installing the 3ware CLI on Linux and FreeBSD	12
Working with 3ware CLI	13
Using the command interface interactively	13
Using a single command with output	14
Using an input file to execute a script	14
Scripting examples	14
Outputting the CLI to a Text File	15
Conventions	15
Understanding RAID Levels and Concepts	16
RAID Concepts	16
Available RAID Configurations	17
RAID 0	17
RAID 1	18
RAID 5	18
RAID 6	19
RAID 10	20
RAID 50	21
Single Disk	22
JBOD	22
Hot Spare	23
Determining What RAID Level to Use	23
Using Drive Capacity Efficiently	24
Support for Over 2 Terabytes	25
CLI Syntax Reference	26
Common Tasks Mapped to CLI Commands	26
Syntax Overview	28
Shell Object Commands	30
focus Object	30
show	31
show ver	32
show alarms [reverse]	32
show diag	32
show rebuild	32
show verify	33
show selftest	34
flush	34
rescan	34
commit	34
update fw=filename_with_path [force]	34
Controller Object Commands	35
/cx show	36
/cx show attribute [attribute ...]	37
/cx show driver	38
/cx show model	38
/cx show firmware	38
/cx show bios	38
/cx show monitor	38
/cx show serial	39
/cx show pcb	39
/cx show pchip	39
/cx show achip	39
/cx show numdrives	39
/cx show numports	40
/cx show numunits	40
/cx show ctlbus	40
/cx show exportjbod	40
/cx show spinup	41
/cx show stagger	41
/cx show ondegrade	41
/cx show autocarve	41
/cx show carvesize	42
/cx show memory	42
/cx show autorebuild	43
/cx show unitstatus	43
/cx show allunitstatus	44
/cx show drivestatus	44
/cx show all	45
/cx add type=<RaidType> disk=<p:-p> [stripe=Stripe] [noscan] [group=<3\|4\|5\|6\|7\|8\|9\|10\|11\|12>] [nocache] [autoverify] [noqpolicy][ignoreECC] [name=string] [storsave=<protect\|balance\|perform>]	46
/cx rescan [noscan]	49
/cx commit	50
/cx flush	50
/cx update fw=filename_with_path [force]	50
/cx show alarms [reverse]	51
/cx show diag	52
/cx show rebuild	52
/cx show verify	54
/cx show selftest	55
/cx add rebuild=ddd:hh:duration	56
Setting Up a Rebuild Schedule	56
/cx add verify=ddd:hh:duration	57
Setting Up a Verify Schedule	57
/cx add selftest=ddd:hh	58
Setting Up a Selftest Schedule	58
/cx del rebuild=slot_id	59
/cx del verify=slot_id	59
/cx del selftest=slot_id	59
/cx set rebuild=enable\|disable\|1..5	59
/cx set verify=enable\|disable\|1..5	60
/cx set selftest=enable\|disable [task=UDMA\|SMART]	60
/cx set exportjbod=on\|off	61
/cx set ondegrade=cacheoff\|follow	61
/cx set spinup=nn	61
/cx set stagger=nn	62
/cx set autocarve=on\|off	62
/cx set carvesize=[1024..2048]	62
/cx set autorebuild=on\|off	63
/cx set autodetect=on\|off disk=<p:-p>\|all	63
/cx start mediascan	64
/cx stop mediascan	65
Unit Object Commands	65
/cx/ux show	66
/cx/ux show attribute [attribute ...]	67
/cx/ux show status	67
/cx/ux show rebuildstatus	67
/cx/ux show verifystatus	67
/cx/ux show initializestatus	68
/cx/ux show name	68
/cx/ux show serial	68
/cx/ux show qpolicy	68
/cx/ux show storsave	69
/cx/ux show identify	69
/cx/ux show autoverify	69
/cx/ux show cache	69
/cx/ux show ignoreECC	70
/cx/ux show volumes	70
/cx/ux show all	70
/cx/ux remove [noscan] [quiet]	71
/cx/ux del [noscan] [quiet]	72
/cx/ux start rebuild disk=p<p:-p...> [ignoreECC]	72
/cx/ux start verify	73
/cx/ux pause rebuild	73
/cx/ux resume rebuild	73
/cx/ux stop verify	74
/cx/ux flush	74
/cx/ux set autoverify=on\|off	74
/cx/ux set cache=on\|off [quiet]	74
/cx/ux set identify=on\|off	75
/cx/ux set ignoreECC=on\|off	75
/cx/ux set name=string	76
/cx/ux set qpolicy=on\|off	76
/cx/ux set storsave=protect\|balance\|perform [quiet]	76
/cx/ux migrate type=RaidType [disk=p:-p] [group=3\|4\|5\|6\|7\|8\|9\|10\|11\|12] [stripe=Stripe] [noscan] [nocache] [autoverify]	78
Migration Process	81
Example of splitting a mirror	81
Example of capacity expansion	81
Example of migrate output	81
Port Object Commands	83
/cx/px show	83
/cx/px show attribute [attribute ...]	83
/cx/px show status	84
/cx/px show model	84
/cx/px show serial	84
/cx/px show firmware	84
/cx/px show identify	84
/cx/px show ncq	85
/cx/px show lspeed	85
/cx/px show capacity	85
/cx/px show smart	85
/cx/px show all	86
/cx/px remove [noscan] [quiet]	87
/cx/px set identify=on\|off	87
BBU Object Commands	88
/cx/bbu show	88
/cx/bbu show attribute [attribute ...]	89
/cx/bbu show status	89
/cx/bbu show batinst	90
/cx/bbu show lasttest	90
/cx/bbu show volt	90
/cx/bbu show temp	90
/cx/bbu show cap	90
/cx/bbu show serial	91
/cx/bbu show fw	91
/cx/bbu show pcb	91
/cx/bbu show bootloader	91
/cx/bbu show all	91
/cx/bbu test [quiet]	92
/cx/bbu enable	92
/cx/bbu disable [quiet]	92
Enclosure Object Commands	93
/ex show	93
/ex show attribute [attribute ...]	94
/ex show controllers	94
/ex show slots	95
/ex show fans	95
/ex show temp	95
/ex show all	95
/ex/slotx show	96
/ex/slotx show identify	96
/ex/slotx set identify=on\|off	96
/ex/fanx show	97
/ex/tempx show	97
Help Commands	97
Help with specific commands	97
Help with attributes	99
help	99
help show	100
help flush	100
help rescan	100
help update	100
help commit	100
help focus	101
help /cx	101
help /cx/ux	101
help /cx/px	101
help /cx/bbu	101
help /ex	101
help /ex/slotx	101
help /ex/fanx	102
help /ex/tempx	102
Command Logging	102

3Ware 9650SE-2LPB-10 CLI Guide - Page 3

Table of Contents

Page 3 highlights