1. DL manuals
  2. 3Ware
  3. Network Card
  4. 720-0127-02
  5. Manual

3Ware 720-0127-02 Manual

Manual is about: Serial ATA RAID Controller

Summary of 720-0127-02

  • Page 1

    3ware ® serial ata raid controller command line interface supports the 9000 series (9500s and 9550sx) pn: 720-0127-02 november 2005 cli guide.

  • Page 2

    Copyright ©2003-2005 applied micro circuits corporation (amcc). 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 ...

  • Page 3: Table of Contents

    Www.3ware.Com i table of contents about this guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 how this guide is organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 chapter 1. Introduction to the 3ware command line...

  • Page 4

    Ii 3ware 9000 series serial ata controller cli guide /cx show numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 /cx show numunits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32 /cx show numdrives . ...

  • Page 5

    Www.3ware.Com iii /cx/ux show volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 /cx/ux show all . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56 /cx/ux export[noscan] [quiet] . . . . . . . . . . . ...

  • Page 6

    Iv 3ware 9000 series serial ata controller cli guide help flush . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 help rescan . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79 help com...

  • Page 7

    Www.3ware.Com v [maint] rebuild cid uid pause . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 101 [maint] rebuild cid uid resume . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 102 [maint] flush cid [uid ...] . . . . . . . . . . . . . . . . . . ....

  • Page 8

    Vi 3ware 9000 series serial ata controller cli guide.

  • Page 9

    Www.3ware.Com 1 about this guide 3ware 9000 series serial ata controller cli guide provides instructions for configuring and maintaining your 3ware controller using 3ware’s command line interface (cli). This guide assumes that you have already installed your controller in your system. If you have no...

  • Page 10

    2 3ware 9000 series serial ata controller cli guide.

  • Page 11

    Www.3ware.Com 3 1 introduction to the 3ware command line interface the 3ware sata raid controller command line interface (cli) for linux, windows, and freebsd is provided to manage 7000, 8000, and 9000-series 3ware ata and serial ata raid controllers. Multiple 3ware raid controllers can be managed u...

  • Page 12

    Chapter 1. Introduction to the 3ware command line interface 4 3ware 9000 series serial ata controller cli guide supported operating systems windows. Windows 2000, windows xp, and windows server 2003, both 32-bit and 64-bit. Linux.Redhat, suse, both 32-bit and 64-bit. Freebsd, both 32-bit and 64-bit....

  • Page 13

    Installing the 3ware cli www.3ware.Com 5 installing the 3ware cli warning! If you are using 3dm, as opposed to 3dm2, amcc does not recommend installing both 3dm and cli on the same system. Conflicts may occur. For example, if both are installed, alarms will be captured only by 3dm. You should use ei...

  • Page 14

    Chapter 1. Introduction to the 3ware command line interface 6 3ware 9000 series serial ata controller cli guide installing the 3ware cli on linux and freebsd 3ware cli can be installed or run directly from the 3ware software cd, or the latest version can be downloaded from the 3ware web site, http:/...

  • Page 15

    Working with 3ware cli www.3ware.Com 7 working with 3ware cli you can work with the 3ware cli in different ways: interactively, entering commands at the main prompt as a series of single commands by creating a script—an input file with multiple commands this first section shows examples of each of t...

  • Page 16

    Chapter 1. Introduction to the 3ware command line interface 8 3ware 9000 series serial ata controller cli guide 2 at the cli prompt, you can enter commands to show or act on 3ware controllers, units, and drives. For example, //localhost> show displays all controllers in the system and shows details ...

  • Page 17

    Working with 3ware cli www.3ware.Com 9 two units: one with the first 2 drives mirrored, and another with the remaining drives in a raid 5 array. In then prints the configurations for verification. The commands included in the script file are: /c0 add type=raid1 disk=0-1 /c0 add type=raid5 disk=2-11 ...

  • Page 18

    Chapter 1. Introduction to the 3ware command line interface 10 3ware 9000 series serial ata controller cli guide understanding raid concepts and levels the next few pages introduce raid concepts you may find useful. For additional information about installing and managing your 3ware controller, see ...

  • Page 19

    Understanding raid concepts and levels www.3ware.Com 11 available raid configurations the following raid levels and configurations are available for drives attached to a 3ware controller: raid 0 raid 1 raid 5 raid 10 raid 50 single disk jbod hot spare raid 0 provides striping, but no mirroring. Stri...

  • Page 20

    Chapter 1. Introduction to the 3ware command line interface 12 3ware 9000 series serial ata controller cli guide figure 2). This gives your system fault tolerance by preserving the data on one drive if the other drive fails. Fault tolerance is a basic requirement for mission critical systems like we...

  • Page 21

    Understanding raid concepts and levels www.3ware.Com 13 when drives are configured as a striped mirrored array, the disks are configured using both raid 0 and raid 1 techniques, thus the name raid 10 (see figure 4). A minimum of four drives are required to use this technique. The first two drives ar...

  • Page 22

    Chapter 1. Introduction to the 3ware command line interface 14 3ware 9000 series serial ata controller cli guide single drives are not fault tolerant and therefore not recommended for high availability systems unless additional precautions are take to prevent system hangs and data loss. Jbod a jbod ...

  • Page 23

    Understanding raid concepts and levels www.3ware.Com 15 drive capacity considerations the capacity of each drive is limited to the capacity of the smallest drive in the array. The total array capacity is defined as follows: through drive coercion, the capacity used for each drive is rounded down so ...

  • Page 24

    Chapter 1. Introduction to the 3ware command line interface 16 3ware 9000 series serial ata controller cli guide support for over 2 terabytes windows 2000, windows xp, and linux 2.4 do not currently recognize unit capacity in excess of 2 tb. If the combined capacity of the drives to be connected to ...

  • Page 25

    Storsave profiles www.3ware.Com 17 fua (force unit access) . Fua commands are a way that the raid controller or a program (such as a database program) can ensure that data is actually written to the disk drive media, and is not stored in cache. When a write command is followed with a fua command, th...

  • Page 26

    Chapter 1. Introduction to the 3ware command line interface 18 3ware 9000 series serial ata controller cli guide rebuilt, you must enable the write cache manually using 3dm2, 3bm, or the cli. The write cache will not automatically reenable when the unit is rebuilt. The protection profile enables thi...

  • Page 27

    Www.3ware.Com 19 2 primary cli syntax reference note: information contained throughout this chapter that describes usage only for the 3ware 9000 series products does not work with 3ware 7000 or 8000 series controllers. This chapter provides detailed information about using the primary command syntax...

  • Page 28

    Chapter 2. Primary cli syntax reference 20 3ware 9000 series serial ata controller cli guide unit configuration tasks create a new unit /cx add 37 create a hot spare /cx add 37 enable/disable unit write cache /cx/ux set cache 60 set the queue policy /cx/ux set qpolicy 61 set the storsave profile /cx...

  • Page 29

    Primary syntax overview www.3ware.Com 21 primary syntax overview the primary command syntax uses the general form: object command attributes objects are shell commands, controllers, units, ports (drives), and bbus (battery backup units). Commands can either select (show, get, present, read) attribut...

  • Page 30

    Chapter 2. Primary cli syntax reference 22 3ware 9000 series serial ata controller cli guide information about commands is organized by the object on which the commands act: shell object commands. Shell object commands set the focus or provide information (such as alarms, diagnostics, rebuild schedu...

  • Page 31

    Shell object commands www.3ware.Com 23 shell object commands shell object commands are either applicable to all the controllers in the system (such as show, rescan, flush, commit), or redirect the focused object. Syntax focus object show [attribute [modifier]] ver alarms [reverse] diag rebuild verif...

  • Page 32

    Chapter 2. Primary cli syntax reference 24 3ware 9000 series serial ata controller cli guide for example: //localhost> focus //elvis.Amcc.Com //elvis.Amcc.Com> //elvis.Amcc.Com> focus /c0/u0 //elvis.Amcc.Com/c0/u0> //elvis.Amcc.Com/c0/u0> focus.. //elvis.Amcc.Com/c0> //elvis.Amcc.Com/c0/> focus u0 /...

  • Page 33

    Shell object commands www.3ware.Com 25 show ver this command will show the cli and api version. Example: //localhost> show ver cli version = 2.00.00.0xx api version = 2.00.00.0xx where xx is the actual version. See the release notes for details. Show alarms [reverse] this command shows the alarms or...

  • Page 34

    Chapter 2. Primary cli syntax reference 26 3ware 9000 series serial ata controller cli guide show verify this command displays all verify schedules for the 9000 controllers in the system. Example: //localhost> show verify verify schedule for controller /c0 ===========================================...

  • Page 35

    Shell object commands www.3ware.Com 27 flush this command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 40. Rescan this command sends a rescan command to all 3ware controllers in the system. For more information, see “/cx rescan [noscan]”...

  • Page 36

    Chapter 2. Primary cli syntax reference 28 3ware 9000 series serial ata controller cli guide controller object commands controller object commands provide information and perform actions related to a specific controller, such as /c0 . For example, you use controller object commands to see alarms spe...

  • Page 37

    Controller object commands www.3ware.Com 29 /cx show this command shows summary information on the specified controller /cx. This information is organized into a report containing two to three parts: a unit summary listing all present units a port summary section listing of all ports and disks attac...

  • Page 38

    Chapter 2. Primary cli syntax reference 30 3ware 9000 series serial ata controller cli guide p8 ok - 149.05 gb 312581808 3js0vg8d p9 not-present - - - - p10 not-present - - - - p11 not-present - - - - name onlinestate bbuready status volt temp hours lastcaptest --------------------------------------...

  • Page 39

    Controller object commands www.3ware.Com 31 /cx show bios this command reports the bios version of controller /cx. Example: //localhost> /c0 show bios /c0 bios version = bg9x 2.X /cx show monitor this command reports the monitor (firmware boot-loader) version of controller /cx. Example: //localhost>...

  • Page 40

    Chapter 2. Primary cli syntax reference 32 3ware 9000 series serial ata controller cli guide /cx show numports this command reports the port capacity (number of physical ports) of the specified controller /cx. Example: //localhost> /c0 show numports /c0 number of ports = 12 /cx show numunits this co...

  • Page 41

    Controller object commands www.3ware.Com 33 //localhost> /c0 show spinup /c0 disk spinup policy = 1 /cx show stagger this feature only applies to 9000 series controllers. This command reports the time delay between each group of spinups at the power on. Example : //localhost> /c0 show stagger /c0 sp...

  • Page 42

    Chapter 2. Primary cli syntax reference 34 3ware 9000 series serial ata controller cli guide /cx show carvesize this feature only applies to 9000 series controllers. This command shows the maximum size of the volumes that will be created if the autocarve policy is set to on. The carvesize can be set...

  • Page 43

    Controller object commands www.3ware.Com 35 /cx show unitstatus this command presents a list of units currently managed by the specified controller /cx, and shows their types, capacity, and status. Possible statuses include: ok, verifying, verify-paused, initializing, init-paused, rebuilding, rebuil...

  • Page 44

    Chapter 2. Primary cli syntax reference 36 3ware 9000 series serial ata controller cli guide p7 ok - 149.05 gb 312581808 3js0vf43 p8 ok - 149.05 gb 312581808 3js0vg8d p9 not-present - - - - p10 not-present - - - - p11 not-present - - - - /cx show all this command shows the current setting of all of ...

  • Page 45

    Controller object commands www.3ware.Com 37 /cx add type = disk = [stripe= stripe ] [noscan] [group= ] [nocache] [autoverify] [ignoreecc] [name= string ] [storsave=] this command allows you to create a new unit on the specified controller. You specify type, disks, and optional stripe size. By defaul...

  • Page 48

    Chapter 2. Primary cli syntax reference 40 3ware 9000 series serial ata controller cli guide example: //localhost> /c1 rescan rescanning controller /c1 for units and drives ...Done found following unit(s): [/c1/u3] found following drive(s): [/c1/p7, /c1/p8] note: rescanning does not import non-jbod ...

  • Page 49

    Controller object commands www.3ware.Com 41 typical output looks like: tw_cli> /c1 show alarms reverse ctl date severity message ------------------------------------------------------------------------------------- c1 [fri nov 28 04:26:31 2003] error (0x04:0x0002): degraded unit detected:unit=0, por...

  • Page 50

    Chapter 2. Primary cli syntax reference 42 3ware 9000 series serial ata controller cli guide the show rebuild command displays the current rebuild background task schedule as illustrated below. //localhost> /c1 show rebuild rebuild schedule for controller /c1 ========================================...

  • Page 51

    Controller object commands www.3ware.Com 43 if you then enable the rebuild schedules, the unit initialization will be paused until the next scheduled time slot, as reflected in the examples below: //localhost> /c1 set rebuild=enable enabling scheduled rebuilds on controller /c1 ...Done. //localhost>...

  • Page 52

    Chapter 2. Primary cli syntax reference 44 3ware 9000 series serial ata controller cli guide rebuild. For each background task, up to 7 time periods can be registered, known as slots 1 through 7. Each task schedule can be managed by a set of commands including add, del, show and set a task. Backgrou...

  • Page 53

    Controller object commands www.3ware.Com 45 commands including add, del, show and set a task. Background task schedules have a slot id, start-day-time, duration, status attributes. For details about setting up a schedule for background selftest tasks, see “setting up a selftest schedule” on page 47....

  • Page 54

    Chapter 2. Primary cli syntax reference 46 3ware 9000 series serial ata controller cli guide setting up a rebuild schedule setting up a rebuild schedule requires several steps, and several different cli commands in addition to /cx add rebuild. To set up the rebuild schedule you want to use, follow t...

  • Page 55

    Controller object commands www.3ware.Com 47 3 use the /cx add verify command to create the verify schedule slots you want (described above.) 4 use the /cx set verify=enable command to enable the schedule (this enables all rebuild schedule slots). (for details, see page 49.) 5 use the /cx/ux set auto...

  • Page 56

    Chapter 2. Primary cli syntax reference 48 3ware 9000 series serial ata controller cli guide /cx del rebuild= slot_id this command removes the rebuild background task in slot slot_id. Example : //localhost> /c1 del rebuild=2 removes the rebuild background task in slot 2. Warning: if all time slots a...

  • Page 57

    Controller object commands www.3ware.Com 49 processing time to rebuilds rather than i/o. Setting the value to 5 gives maximum processing time to i/o rather than rebuilds. Enabling and disabling rebuild is only for 9000 models, however the rebuild rate (1..5) applies to all controllers. 7000- and 800...

  • Page 58

    Chapter 2. Primary cli syntax reference 50 3ware 9000 series serial ata controller cli guide a jbod is an unconfigured disk attached to your 3ware raid controller. Amcc recommends that you use single disk as a replacement for jbod, to take advantage of features such as raid level migration. /cx set ...

  • Page 59

    Controller object commands www.3ware.Com 51 this feature is useful for operating systems limited to 2tb file systems. For example, using the 2 tb default carvesize, a 3 tb unit will be configured into one 2 tb volume and one 1 tb volume. A 5 tb unit will be configured into two 2 tb volumes and one 1...

  • Page 60

    Chapter 2. Primary cli syntax reference 52 3ware 9000 series serial ata controller cli guide example: //localhost> /c0 set autorebuild=enable setting auto-rebuild policy on /c0 to enable ... Done. /cx start mediascan this command applies only to 7000/8000 controllers. For 9000 series controllers, us...

  • Page 61

    Unit object commands www.3ware.Com 53 unit object commands unit object commands provide information and perform actions related to a specific unit, such as /c0/u1 (unit 1 on controller 0). For example, you use logical disk object commands for such tasks as seeing the rebuild, verify, or initialize s...

  • Page 62

    Chapter 2. Primary cli syntax reference 54 3ware 9000 series serial ata controller cli guide example: //localhost> /c0/u0 show unit unittype status %cmpl port stripe size(gb) blocks ---------------------------------------------------------------------- u0 raid-50 ok - - 64k 596.05 1249921024 u0-0 ra...

  • Page 63

    Unit object commands www.3ware.Com 55 /cx/ux show verifystatus this command reports the verifystatus (if any) of the specified unit. Examples : //localhost> /c0/u5 show verifystatus /c0/u5 is not verifying, its current state is ok /cx/ux show initializestatus this command reports the initializestatu...

  • Page 65

    Unit object commands www.3ware.Com 57 /cx/ux export [noscan] [quiet] this command allows you to export (or remove) a unit. Exporting a unit instructs the firmware to remove the specified unit from its poll of managed units, but retains the dcb (disk configuration block) metadata. As such the unit ca...

  • Page 66

    Chapter 2. Primary cli syntax reference 58 3ware 9000 series serial ata controller cli guide /cx/ux start rebuild disk= p [ignoreecc] this command allows you to rebuild a degraded unit using the specified disk=p. Rebuild only applies to redundant arrays such as raid 1, raid 5, raid 10, and raid 50. ...

  • Page 67

    Unit object commands www.3ware.Com 59 /cx/ux pause rebuild this command allows you to pause the rebuild operation on the specified unit /cx/ux. This feature is only supported on the 7000/8000 series controllers. 9000 series controllers have an on-board scheduler where rebuild operations can be sched...

  • Page 69

    Unit object commands www.3ware.Com 61 /cx/ux set name= string this command allows you to name the unit with an arbitrary name. You can use this name in conjunction with the unit serial number to cross-reference with the unit. The system does not check to ensure uniqueness of names, so be careful to ...

  • Page 70

    Chapter 2. Primary cli syntax reference 62 3ware 9000 series serial ata controller cli guide write journaling is disabled. All data flushing from controller cache will be flushed to disk. If a bbu is present, this essentially disables the bbu for this unit. Incoming fua (force unit access) host requ...

  • Page 71

    Unit object commands www.3ware.Com 63 a special case of this command is when the source unit has a type of raid1 and destination unit has a type of single. In this case, the migrate command splits both drives into two identical single disks. The disk name will be duplicated on the destination units,...

  • Page 73

    Unit object commands www.3ware.Com 65 creating block special devices such as /dev/sdb and /dev/sdc as some implementations might create naming fragmentation and a moving target. Nocache attribute instructs cli to disable the write cache on the migrated unit. Enabling write cache increases write perf...

  • Page 74

    Chapter 2. Primary cli syntax reference 66 3ware 9000 series serial ata controller cli guide example of migrate output the following is an example of how migrating units will be displayed. In this example, the report indicates that /c0/u0 is a migrating unit with 67% completion. The report also indi...

  • Page 75

    Port object commands www.3ware.Com 67 port object commands port object messages are commands that provide information and perform actions related to a specific disk, attached to a port, such as /c0/p0 . You use port object commands for such tasks as seeing the status, model, or serial number of the ...

  • Page 76

    Chapter 2. Primary cli syntax reference 68 3ware 9000 series serial ata controller cli guide /cx/px show model this command displays the model of the drive attached to the specified port. Example: //localhost> /c0/p5 show model /c0/p5 model = wdc wd1600bb-00daa0 /cx/px show serial this command displ...

  • Page 77

    Port object commands www.3ware.Com 69 for queuing to be used, it must be enabled for the unit and supported by the drive. Example: //localhost> /c0/p5 show ncq /c0/p5 ncq supported = no /c0/p5 ncq enabled = no /cx/px show lspeed this command applies only to 9550sx model controllers. This command dis...

  • Page 78

    Chapter 2. Primary cli syntax reference 70 3ware 9000 series serial ata controller cli guide note: the smart data is not decoded. If the drive attached to the specified port is not present or if there are cabling problems reaching the drive, cli will return an error. This can be one way of detecting...

  • Page 79

    Port object commands www.3ware.Com 71 warning: use caution when using this command as this operation will degrade any redundant units. This command will fail if you attempt to remove a drive from a non-redundant unit. After the drive is removed in cli it can be removed physically, without powering d...

  • Page 80

    Chapter 2. Primary cli syntax reference 72 3ware 9000 series serial ata controller cli guide bbu object commands bbu (battery backup unit) object commands are commands that provide information and perform actions related to a specific bbu installed on a specific controller, such as /c0/bbu . This ob...

  • Page 81

    Bbu object commands www.3ware.Com 73 /cx/bbu show attribute [ attribute ...] this command shows the current setting of the given attribute(s) on the bbu board. One or many attributes can be specified. Specifying an invalid attribute will terminate the loop. Possible attributes are: batinst, bootload...

  • Page 82

    Chapter 2. Primary cli syntax reference 74 3ware 9000 series serial ata controller cli guide /cx/bbu show lasttest this command shows the date the battery capacity was last measured. If the battery capacity test has never been run, then 'xx-xxx-xxxx' will be displayed. Note: the estimated bbu capaci...

  • Page 83

    Bbu object commands www.3ware.Com 75 /cx/bbu show pcb this command shows the pcb revision number on the bbu. /cx/bbu show bootloader this command shows the bbu's boot loader version. /cx/bbu show all this command shows the current settings of all bbu-related attribute: ready, status, batinst, lastte...

  • Page 84

    Chapter 2. Primary cli syntax reference 76 3ware 9000 series serial ata controller cli guide /cx/bbu enable this command enables bbu detection on the controller. If the bbu is ready, the controller will utilize bbu functionality in the event of a power failure. /cx/bbu disable this command disables ...

  • Page 85

    Help commands www.3ware.Com 77 /cx add type=raidtype> disk=p:-p..> [stripe=stripe>] [noscan] [nocache] [group=] [autoverify] [ignoreecc] [name=string (9000 only)] [storsave= (9550sx only)] raidtype = { raid0, raid1, raid5, raid10, raid50, single, spare, jbod (7000/8000 only)} /cx add rebuild=ddd:hh:...

  • Page 86

    Chapter 2. Primary cli syntax reference 78 3ware 9000 series serial ata controller cli guide help this help command provide a table of contents, providing help with the overall navigation of the cli commands. Typical output looks like the following. (details about help commands for the new command s...

  • Page 87

    Help commands www.3ware.Com 79 help flush this command provides specific flush-related help, illustrating various ways to use the flush command. See the section “shell object commands” on page 23 for more information. Help rescan this command provides specific rescan related help, illustrating vario...

  • Page 88

    Chapter 2. Primary cli syntax reference 80 3ware 9000 series serial ata controller cli guide environment variables there are two environment variables: tw_cli_input_style (described below) tw_cli_style is a reporting style variable for the legacy syntax. For details, see “screen reporting style” on ...

  • Page 89

    Return code www.3ware.Com 81 to view the return code for windows, in a command window type tw_cli /c0 show (c0 info displayed here) if errorlevel 0 echo 0 0 tw_cli /c7 show error.... If errorlevel 1 echo 1 1 this example fails (returns 1) because there is no controller 7..

  • Page 90

    Chapter 2. Primary cli syntax reference 82 3ware 9000 series serial ata controller cli guide.

  • Page 91

    Www.3ware.Com 83 3 legacy cli syntax reference this chapter provides detailed information about using the legacy syntax for the 3ware cli, using the commands info, maint, sched, alarms, set, and help. Support for the legacy syntax is available only for a limited time. Note: information contained in ...

  • Page 92

    Chapter 3. Legacy cli syntax reference 84 3ware 9000 series serial ata controller cli guide in addition, 3ware also includes on the 3ware cd a utility named tw_sched(1), which is a wrapper around tw_cli(1). Used in conjunction with a time-driven scheduler such as crond(1d), it provides background ta...

  • Page 93

    Screen reporting style www.3ware.Com 85 brackets indicate that you may omit the controller id, to rescan all controllers, and the noscan parameter, so that the operation will be reported to the operating system. Screen reporting style in the previous version of the cli, 3ware has changed the default...

  • Page 95

    Info commands www.3ware.Com 87 the port summary section lists all present ports specifying the port number, disk status, unit affiliation, size (gb), blocks (of 512 bytes), and the serial number assigned by the disk vendor. Additional attributes about units, ports and disks can be obtained by queryi...

  • Page 96

    Chapter 3. Legacy cli syntax reference 88 3ware 9000 series serial ata controller cli guide /c0 model = 7506-12 info cid firmware this command reports the firmware version of controller cid. Example: //localhost> info c0 firmware /c0 firmware version = fgxx 2.01.00.025 info cid bios this command rep...

  • Page 97

    Info commands www.3ware.Com 89 info cid serial this command reports the serial number of the specified controller cid. Example: //localhost>//localhost> info c0 serial /c0 serial number = f12705a3240009 info cid pcb this command reports the pcb (printed circuit board) revision of the specified contr...

  • Page 98

    Chapter 3. Legacy cli syntax reference 90 3ware 9000 series serial ata controller cli guide info cid numdrives this command reports the number of drives currently managed by the specified controller cid. This report does not include units that have been removed (placed off-line) with the maint remov...

  • Page 99

    Info commands www.3ware.Com 91 info cid drivestatus this command presents a list of port assignments, status, unit affiliation, size in gb, the number of blocks of 512 bytes, and the disk’s serial number. Example: //localhost> info c0 drivestatus port status unit size blocks serial -----------------...

  • Page 100

    Chapter 3. Legacy cli syntax reference 92 3ware 9000 series serial ata controller cli guide info cid stagger this command shows the delay between drive groups that spin up at one time on this controller example: //localhost> info c0 stagger /c0 spinup stagger time policy (sec) = 2 info cid uid this ...

  • Page 101

    Info commands www.3ware.Com 93 info cid uid rebuildstatus this command presents the rebuild status (if any) of the specified unit. Example: //localhost> info c0 u5 rebuildstatus /c0/u5 is not rebuilding. Or, when the unit is rebuilding: //localhost> info c0 u5 rebuildstatus /c0/u5 is rebuilding with...

  • Page 102

    Chapter 3. Legacy cli syntax reference 94 3ware 9000 series serial ata controller cli guide info cid pid status this command presents the status of the specified port. Example: //localhost> info c0 p5 status /c0/p5 status = ok info cid pid model this command presents the model of the specified port....

  • Page 103

    Info commands www.3ware.Com 95 info cid diag this command extracts the internal log of diagnostic events of controller cid, controller diagnostics suitable for technical support usage. Note that some characters might not be printable or rendered correctly (human readable). It is recommended to save ...

  • Page 104

    Chapter 3. Legacy cli syntax reference 96 3ware 9000 series serial ata controller cli guide maint commands the maint command lets you perform maintenance operations on the controller, its units, and drives. It is recommended that you use the info command first to verify the controller information be...

  • Page 105

    Maint commands www.3ware.Com 97 rescan imports jbod units only when attached to either a 7000 or 8000 controller, unless you reboot. All other raid types can be imported when attached to the 9000 series. Warning! Adding any drive requires use of an approved hot swap carrier. If you do not have such ...

  • Page 106

    Chapter 3. Legacy cli syntax reference 98 3ware 9000 series serial ata controller cli guide [maint] remove cid pid [noscan] this command allows you to remove (or export) a port (or drive). Exporting a port instructs the firmware to remove the specified port from its poll of managed ports, but retain...

  • Page 107

    Maint commands www.3ware.Com 99 [maint] createunit cid rraidtype pid_list [kstripe] [noscan] [gdsk_grp] [nocache] [autoverify] [ignoreecc] this command allows you to create a unit on the specified controller cid, of type rraidtype, optional stripe size of kstripe, using one or many disks specified b...

  • Page 108

    Chapter 3. Legacy cli syntax reference 100 3ware 9000 series serial ata controller cli guide gdsk_grp indicates the number of disks per group for a raid 50 type. A raid 50 is a multi-tier array. At the most bottom layer, n number of disks per group are used to form the raid 5 layer. These raid 5 arr...

  • Page 109

    Maint commands www.3ware.Com 101 examples: to create a 12-member raid-0 array with 128k stripe size on controller 0: cli> maint createunit c0 rraid0 k256 p0-11 to create a hot spare using a drive on port-2 controller-0 for automatic rebuilds: cli> maint createunit c0 rspare p2 alert! When creating a...

  • Page 110

    Chapter 3. Legacy cli syntax reference 102 3ware 9000 series serial ata controller cli guide [maint] rebuild cid uid resume this command allows you to resume the rebuild operation on the specified unit. See “[maint] rebuild cid uid pause” on page 101 for more details. [maint] flush cid [ uid ...] th...

  • Page 111

    Maint commands www.3ware.Com 103 (including ups post failure automations). This command expedites the process by instructing the controller to finish pending requests and clear the dcbs in-transaction flag as the disk is going down. Note that block devices (cooked devices) do not require this comman...

  • Page 112

    Chapter 3. Legacy cli syntax reference 104 3ware 9000 series serial ata controller cli guide sched commands sched commands are applicable for 9000-series controllers to schedule background tasks to occur at a later time or day, when peak performance is not required. When the schedule is disabled, by...

  • Page 113

    Sched commands www.3ware.Com 105 sched rebuild cid this command displays the current rebuild background tasks as illustrated below. //localhost> tw_cli sched rebuild c1 rebuild schedule for controller /c1 ======================================================== slot day hour duration status --------...

  • Page 114

    Chapter 3. Legacy cli syntax reference 106 3ware 9000 series serial ata controller cli guide sched rebuild cid enable this command enables all rebuild background tasks on controller cid. Sched rebuild cid disable this command disables all rebuild background tasks on controller cid. Sched verify cid ...

  • Page 115

    Sched commands www.3ware.Com 107 sched verify cid remove slot_id this command removes (or unregisters) the verify background task in slot slot_id. For example: //localhost> tw_cli sched verify c1 remove 3 removes the verify background task in slot 3. Warning: if all timeslots are removed, be sure to...

  • Page 116

    Chapter 3. Legacy cli syntax reference 108 3ware 9000 series serial ata controller cli guide sched selftest cid add d day h hour this command adds a new background selftest task to be executed on day (range 0 .. 6, where sunday is zeroth day of the week), at hour (range 0 .. 23). Notice that selftes...

  • Page 117

    Alarms commands www.3ware.Com 109 sched selftest cid disable selftest_task_id this command disables a particular selftest task (udma or smart). For the selftest_task_id, s0 is interpreted as udma, s1 is interpreted as smart. For example: //localhost> tw_cli sched selftest c1 disable s1 disables smar...

  • Page 118

    Chapter 3. Legacy cli syntax reference 110 3ware 9000 series serial ata controller cli guide syntax alarms alarms c [c ...] warning! 3ware does not recommend installing both 3dm and cli. Conflicts may occur. If both are installed, alarms will be captured only by 3dm. Warning! 3dm and cli handle alar...

  • Page 119

    Set commands www.3ware.Com 111 set commands these commands allow you to set certain controller and unit specific parameters as described below. The set command can be used to set its rebuild rate, and enable or disable cache. For information about viewing information about the controller and units, ...

  • Page 121

    Help commands www.3ware.Com 113 help commands this command set provides brief on-line help. Help this command provides a table of contents, providing brief descriptions of the help sub-commands. Typical output looks like: copyright (c) 2003 3ware, inc. All rights reserved. List of commands ---------...

  • Page 122

    Chapter 3. Legacy cli syntax reference 114 3ware 9000 series serial ata controller cli guide help quit this command provides information about the cli quit command. For example: //localhost> help quit this command quits the cli quit synonyms: q exit return code while informative messages are written...