3Ware 720-0087-00 Manual de usuario

Command Line Interface

for Linux

For use on 7000 and 8000 Series

Escalade™ ATA RAID Controllers

PN 720-0087-00, Revision A

August 30, 2002

CLI

User Guide

reproduced, stored in a retrieval system, or transmitted in any form by any

means, electronic, mechanical, photocopying, recording or otherwise,

without the proper written consent of 3ware, Inc., 701 East Middlefield

Road, Suite 300, Mountain View CA 94043.

Trademarks

3ware, the 3ware logo, Escalade, StorSwitch, TwinStor, R5 Fusion and

3DM are all registered trademarks of 3ware, Inc. All other trademarks

herein are property of their respective owners.

Disclaimer

3ware, Inc. assumes no responsibility for errors or omissions in this docu-

ment, nor does 3ware, Inc. make any commitment to update the informa-

tion contained herein.

iii

Contents

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1

Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

Command Line Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

Ways to Run the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4

1) Interactive with command interface . . . . . . . . . . . . . . . . . .4

2) Single command with output . . . . . . . . . . . . . . . . . . . . . . . .4

3) Multiple commands through an input file . . . . . . . . . . . . . .5

Controller Information . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

The info command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5

Examples using Interactive Mode . . . . . . . . . . . . . . . . . . . . . .7

Settings . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

The set command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .12

Examples using Interactive Mode . . . . . . . . . . . . . . . . . . . . .13

Array Maintenance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

The maint command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .14

Examples using Interactive Mode . . . . . . . . . . . . . . . . . . . . .15

Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

The help command . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .18

Examples using Interactive Mode . . . . . . . . . . . . . . . . . . . . .18

3ware Technical Support and Services . . . . . . . . . . . . . . . . . 22

Sales and ordering information . . . . . . . . . . . . . . . . . . . . . . . . .22

Feedback on this manual . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .22

Introduction

www.3ware.com

Introduction

The Command Line Interface (CLI) for Linux is provided to

manage 7000 and 8000 series 3ware Escalade™ATA RAID con-

trollers. Multiple systems containing Escalade controllers may be

managed using the CLI via a command line or script. CLI is use-

ful in environments were a graphical user interface (GUI) is not

available.

Features

www.3ware.com

Features

The 3ware CLI provides the basic functionality of the 3ware Disk

Management (3DM®) utility through a Command Line Interface.

You can view array status and version information, and perform

maintenance functions like adding or removing drives.

Note: Refer to the Escalade ATA RAID Controller

User’s Guide for complete information on 3DM.

The CLI command set is listed below and described in detail in the

Command Line Interface chapter of this guide:

• info - to view basic controller information

• set - to display and modify current settings

• maint - to perform maintenance operations

• help - to display a list of commands and options

Installation

www.3ware.com

Installation

You will need to be root or have root privileges to install the CLI

to /usr/sbin and to run the CLI.

Filename: tw_cli.tar

To install the CLI, type the following as root:

tar xf tw_cli.tar -C /usr/sbin

To install the CLI to a different location, change /usr/sbin/ to the

desired location.

Note: The installation location needs to be in the envi-

ronment path for root to execute the CLI without using

complete paths (i.e., if installed to /usr/sbin/, you can

type tw_cli on the command line, otherwise you will have

to type the complete path: /home/user/tw_cli).

Command Line Interface

www.3ware.com 4

Command Line Interface

Note: In this chapter, text surrounded by [] brackets

indicates optional parameters.

Ways to Run the CLI

1) Interactive with command interface

tw_cli

Description:

Execute tw_cli to get into a console where you can interactively enter

commands to get, set or maintain your Escalade.

Example:

tw_cli

Escalade CLI>

The main prompt is displayed when the program is awaiting a com-

mand.

Escalade CLI>

2) Single command with output

tw_cli <command line arguments>

CLI run command

Description:

This command doesn’t invoke the main CLI prompt if used with com-

mand line arguments.

Syntax:

tw_cli <command line arguments>

3ware Escalade ATA RAID Controller CLI User Guide

www.3ware.com

Example:

tw_cli info c0 u0

3) Multiple commands through an input file

tw_cli -f <filename>

CLI run command

Description:

This method executes a specific filename, where the filename is the name

of a text file containing a list of CLI commands which the user types in

advance. Each command should be on a separate line.

Syntax:

tw_cli -f <filename>

Example:

tw_cli -f clicommand.txt

Note: All examples given in the following sections will

reflect the interactive mode method.

Controller Information

Note: Commands will be displayed in italics for easy

indentification.

The

info

command

The info command provides basic information on the controller,

unit and port. This command is for querying purposes only. To

make modifications use the set or maint command.

Command Line Interface

www.3ware.com 6

Specific options for the info command:

•Controller information options

-model - provides the controller model number

-firmware - provides the controller firmware version

-bios - provides the controller bios version

-monitor - provides the controller monitor version

-numunits - provides the number of units on the controller

-numports - provides the number of ports on the controller

-numdrives - provides the number of drives on the controller

-allunitstatus - provides simple numeric status for all units

-unitstatus - provides the status for a specific unit

-drivestatus - provides the status of drives on the controller

•Unit information options

-status - provides the status of a specific unit

-rebuildstatus - provides percent complete of rebuild

-verifystatus - provides percent complete of verify

•Port (drive) information options

-status - provides the status of drives on the controller

-model - provides drive manufacturer model number

-serial - provides drive serial number

-capacity - provides drive capacity

-smart - provides SMART data in hex format for drive troubleshoot-

ing

Syntax:

info [c<c>[u<u>|p<p>]]

3ware Escalade ATA RAID Controller CLI User Guide

www.3ware.com

Note:

• Ιf cis not specified, information for all controllers is dis-

played, including a brief description of each.

• Ιf only cis specified, information about the cth controller is

provided in detail.

• Ιf cis specified and uis also specified, information about

the uth unit on the cth controller is provided in detail.

• Ιf cis specified and uis also specified with status, text and

hex code of the status is displayed in the form OK (0xFF).

Also, an error code is returned, bit masking bad drives if any

of the drives used by the array are bad. For example, if port 2

is bad, the return code would be 4 (in hex).

• Ιf cis specified and uis also specified with rebuildstatus,

then the status of the array is displayed (e.g., 0=array is not

rebuilding, 1-99 = the percentage of the rebuild)

• Ιf cis specified and pis also specified, information about

the pth port on the cth controller is displayed.

Examples using Interactive Mode

info

Example:

Escalade CLI> info

Sample of output:

List of controllers

-------------------

Controller 1: Escalade 7000-2 (2 ports)

Controller 0: Escalade 7500-8 (8 ports)

info for specific controller

Example:

Escalade CLI> info c0

Este manual sirve para los siguientes modelos

Tabla de contenidos

Otros manuales de Controladores de 3Ware

3Ware

3Ware 9550SXU-16ML - Sata Rohs Manual de usuario

3Ware

3Ware 720-0104-00 Manual de usuario

3Ware

3Ware 9590SE Series Instrucciones de instalación y funcionamiento

3Ware

3Ware 9550SXU-12 - PCI-X-to-Serial ATA II Hardware RAID... Manual de usuario

3Ware

3Ware 9000 Series Manual de usuario

3Ware

3Ware 9590SE Series Manual de usuario

3Ware

3Ware 7500-12 - Escalade RAID Controller Hoja de especificaciones

3Ware

3Ware 8506-12 - Escalade RAID Controller Hoja de especificaciones

3Ware

3Ware 9500S-4LP - Escalade RAID Controller Manual de usuario

3Ware

3Ware 720-0127-02 Manual de usuario

3Ware

3Ware 3WARE 9650SE Manual de usuario

3Ware

3Ware 720-0186-00 Manual de usuario

3Ware

3Ware 8006-2LP - Escalade RAID Controller Manual de usuario

3Ware

3Ware 9650SE-8LPML-SGL Manual de usuario

3Ware

3Ware 9550SX-4LP - Scalade RAID Controller Manual de usuario

3Ware

3Ware 9650SE-2LPB-10 - Sataii Raid Hardware 10Pk Manual de usuario

3Ware

3Ware 720-0192-00 Manual de usuario

3Ware

3Ware 9550SXU-4LP-SGL - Pci-x Sataraid Manual de usuario

3Ware

3Ware 9000 Series Cómo utilizar

3Ware

3Ware 7000-2 - Escalade RAID Controller Manual del propietario

Manuales populares de Controladores de otras marcas

Digiplex

Digiplex DGP-848 Instrucciones de funcionamiento

YASKAWA

YASKAWA SGM series Manual de usuario

Sinope

Sinope Calypso RM3500ZB Manual de usuario

Isimet

Isimet DLA Series Style 2 Manual de instalación

LSIS

LSIS sv-ip5a Manual de usuario

Rockwell Automation

Rockwell Automation 1769-L31 Manual de usuario

Airflow

Airflow Uno hab Manual de usuario

ABB

ABB ACS580-01 drives Manual de usuario

Panasonic

Panasonic GM1 Series Manual de usuario

Emerson

Emerson SW93 Manual de usuario

AutoAqua

AutoAqua Smart ATO micro SATO-120P Manual de usuario

Panasonic

Panasonic FP? Positioning Unit RTEX Manual de usuario

Samson

Samson Type 5824 Manual de servicio

Alpha IP

Alpha IP MIOB 21001 Manual de usuario

Siemens

Siemens OpenAir GMA 1 Series Manual de usuario

Surecom

Surecom SR-629 Manual de usuario

Fishman

Fishman TriplePlay Manual de usuario

Regulus

Regulus SRS1 T Manual de usuario