3Ware 720-0087-00 Manual

Manual is about: Command Line Interface for Linux; For use on 7000 and 8000 Series Escalade ATA RAID Controllers

Summary of 720-0087-00

  • Page 1

    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.

  • Page 2

    Copyright ©2002 3ware, inc. All rights reserved. No part of this publication may be 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...

  • Page 3: Contents

    Iii contents introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2 installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...

  • Page 4: Introduction

    Introduction 1 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 envi...

  • Page 5: Features

    Features www.3ware.Com 2 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 esc...

  • Page 6: Installation

    Installation 3 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/...

  • Page 7: Command Line Interface

    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 comm...

  • Page 8: Tw_Cli -F

    3ware escalade ata raid controller cli user guide 5 www.3ware.Com example: tw_cli info c0 u0 3) multiple commands through an input file tw_cli -f 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 whi...

  • Page 9

    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 monito...

  • Page 10: Info

    3ware escalade ata raid controller cli user guide 7 www.3ware.Com note: • Ι f c is not specified, information for all controllers is dis- played, including a brief description of each . • Ι f only c is specified, information about the c th controller is provided in detail. • Ι f c is specified and u...

  • Page 11

    Command line interface www.3ware.Com 8 sample of output: controller 0 ------------ model: 7500-8 fw: fe7x 1.05.00.034 bios: be7x 1.08.00.038 monitor: me7x 1.01.00.035 serial #: d415tgze pcb: rev b achip: 3.2 pchip: 1.3 # of units: 3 unit 0: raid 5 60.3 gb (117262592 blocks): rebuilding (2%) unit 3: ...

  • Page 12: Info

    3ware escalade ata raid controller cli user guide 9 www.3ware.Com info for specific unit on a controller example: escalade cli> info c0 u0 sample of output: controller 0, unit 0 -------------------- status: rebuilding (54%) unit type: raid 5 size: 60.3 gb (117262592 blocks) # of subunits: 3 subunit ...

  • Page 13: Info

    Command line interface www.3ware.Com 10 info for specific code versions on a specific controller (firmware, bios, monitor, model) example: escalade cli> info c0 firmware sample of output: fe7x 1.12.34.24 info for specific port (drive) example: escalade cli> info c0 p0 serial sample of output: d415tg...

  • Page 14: Unitstatus

    3ware escalade ata raid controller cli user guide 11 www.3ware.Com unitstatus description: to get a general status of the units of a controller. Example: escalade cli> info c0 unitstatus sample of output: # of units: 1 unit 0: raid 0 163.92 gb (320168960 blocks): ok example: escalade cli> info c0 al...

  • Page 15: Controller Not Found

    Command line interface www.3ware.Com 12 controller not found example: escalade cli> info c2 sample of output: invalid controller id specified, no control- ler with id 2 exists. Settings the set command the set command can be used to display and modify settings. • rebuild - sets the rebuild rate (per...

  • Page 16: Set

    3ware escalade ata raid controller cli user guide 13 www.3ware.Com examples using interactive mode set description: using the set command without the rebuild or cache options displays the current configuration, as shown below: example: escalade cli> set sample of output: controller 1 ===============...

  • Page 17: Set Cache

    Command line interface www.3ware.Com 14 sample of output: turning the cache on for unit 0 on controller 0 set cache disable example: escalade cli> set cache c0 u0 off sample of output: turning the cache off for unit 0 on control- ler 0 set rebuild description: to set the rebuild rate of controller 0...

  • Page 18: Maint Add

    3ware escalade ata raid controller cli user guide 15 www.3ware.Com • remove - removes a drive from a port. After this is done, a drive can safely be removed from the controller. • rebuild - rebuilds a degraded array. Specify a unit number on a controller you want to rebuild, along with the port numb...

  • Page 19: Maint Add Spare

    Command line interface www.3ware.Com 16 maint add spare description: to add a spare drive to port 3 on controller 0. Example: escalade cli> maint add c0 p3 spare sample of output: successfully added a spare to port 3 on con- troller 0 maint remove description: to remove a disk drive from port 3 of c...

  • Page 20: Maint Rebuild

    3ware escalade ata raid controller cli user guide 17 www.3ware.Com example: escalade cli> maint rebuild c0 u2 p3 sample of output: replace command failed, cannot start rebuild (108) maint rebuild a degraded raid 10 array description: to rebuild a degraded array, unit 2 (u2) on controller 0, with a d...

  • Page 21: Maint Verify

    Command line interface www.3ware.Com 18 maint verify description: to start a verify on unit 3 of controller 2. Example: escalade cli> maint verify c2 u3 sample of output: verify successfully started on unit 3 on con- troller 2 help the help command the help command displays a list of the cli command...

  • Page 24

    3ware escalade ata raid controller cli user guide 21 www.3ware.Com maint add c0 p4 spare // add a spare drive to port 4 on controller 0 maint remove c2 p5 // removes drive 5 on controller 2 maint rebuild c1 u4 p8 // rebuild unit4 on controller 1 with a newly added cbod on port 8 maint rebuild c1 u4 ...

  • Page 25: 3Ware Technical Support

    3ware technical support and services 22 www.3ware.Com 3ware technical support and services product information, frequently asked questions, software upgrades, driver files and other support are available through the 3ware world wide web site at http://www.3ware.Com. 3ware's soft- ware library is acc...

  • Page 26

    3ware escalade ata raid controller cli user guide www.3ware.Com 23.