English dropdown-ico

AMCC 3WARE 9500S manual

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

Go to page of

Similar user manuals

A good user manual

The rules should oblige the seller to give the purchaser an operating instrucion of AMCC 3WARE 9500S, along with an item. The lack of an instruction or false information given to customer shall constitute grounds to apply for a complaint because of nonconformity of goods with the contract. In accordance with the law, a customer can receive an instruction in non-paper form; lately graphic and electronic forms of the manuals, as well as instructional videos have been majorly used. A necessary precondition for this is the unmistakable, legible character of an instruction.

What is an instruction?

The term originates from the Latin word „instructio”, which means organizing. Therefore, in an instruction of AMCC 3WARE 9500S one could find a process description. An instruction's purpose is to teach, to ease the start-up and an item's use or performance of certain activities. An instruction is a compilation of information about an item/a service, it is a clue.

Unfortunately, only a few customers devote their time to read an instruction of AMCC 3WARE 9500S. A good user manual introduces us to a number of additional functionalities of the purchased item, and also helps us to avoid the formation of most of the defects.

What should a perfect user manual contain?

First and foremost, an user manual of AMCC 3WARE 9500S should contain:
- informations concerning technical data of AMCC 3WARE 9500S
- name of the manufacturer and a year of construction of the AMCC 3WARE 9500S item
- rules of operation, control and maintenance of the AMCC 3WARE 9500S item
- safety signs and mark certificates which confirm compatibility with appropriate standards

Why don't we read the manuals?

Usually it results from the lack of time and certainty about functionalities of purchased items. Unfortunately, networking and start-up of AMCC 3WARE 9500S alone are not enough. An instruction contains a number of clues concerning respective functionalities, safety rules, maintenance methods (what means should be used), eventual defects of AMCC 3WARE 9500S, and methods of problem resolution. Eventually, when one still can't find the answer to his problems, he will be directed to the AMCC service. Lately animated manuals and instructional videos are quite popular among customers. These kinds of user manuals are effective; they assure that a customer will familiarize himself with the whole material, and won't skip complicated, technical information of AMCC 3WARE 9500S.

Why one should read the manuals?

It is mostly in the manuals where we will find the details concerning construction and possibility of the AMCC 3WARE 9500S item, and its use of respective accessory, as well as information concerning all the functions and facilities.

After a successful purchase of an item one should find a moment and get to know with every part of an instruction. Currently the manuals are carefully prearranged and translated, so they could be fully understood by its users. The manuals will serve as an informational aid.

Table of contents for the manual

  • Page 1

    3w ar e ® Serial A T A RAID Contr oller Command Line Interface Support s the 9000 Series (9500S, 9550SX, 9590SE, 9650SE) PN: 720-0145-00 October 20 06 CLI Guide[...]

  • Page 2

    www.3ware.com ii Cop yright ©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. This publication may be co pied or reproduced for reference purposes only . All other purposes require the express written consent of AMCC, 215 Mof fett Park Drive, Sunnyvale, CA 94089. AMCC shall not be responsible or liable for , and shall be h[...]

  • 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 4

    iv 3ware Serial ATA RAID Controller CLI Guide /c x show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33 /c x show numport s . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 /c x show numunit s . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 5

    www.3ware.com v /c x /u x show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /c x /u x show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 62 /c x /u x show storsave . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 6

    vi 3ware Serial ATA RAID Controller CLI Guide /c x /bbu test [quiet] . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /c x /bbu enable . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 86 /c x /bbu disable [quiet] . . . . . . . . . . . . . . . [...]

  • Page 7

    www.3ware.com 1 About this CLI Guide 3war e Serial A T A Contr oller CLI Guide provides instructio ns for configuring and maintaining your 3ware controller using 3ware’ s command line interface (CLI). There are often multiple ways to acc omplish the same configuration and maintenance tasks for your 3ware cont roller . While this manual includes i[...]

  • Page 8

    2 3ware Serial ATA RAID Controller CLI Guide 1 Intr oduction to the 3w ar e Command Line Interf ace The 3ware SA T A RAID Controller Command Line Interface (CLI) for Linux, W indows, and FreeBSD is provided to manage 7000, 8000, and 9000-series 3ware A T A and Serial A T A RAID controllers. Multiple 3ware RAID controllers can be managed using the C[...]

  • Page 9

    Supported Operating Systems www.3ware.com 3 Y ou can use the CLI to view unit status and version information and perform maintenance functions su ch as adding or removing drives. 3ware CLI also includes advanc ed features for creating and deleting RAID units online. For a summary of what you can do using the CLI, see “Common T asks Mapped to CLI [...]

  • Page 10

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 4 3ware Serial ATA RAID Controller CLI Guide Installing the 3ware CLI Installing the 3ware CLI on W indows 3ware CLI can be installed or run direc tly from the 3ware so ftware CD, or the latest version can be downlo aded from the 3ware web site, http://www .3ware.com . Online manual[...]

  • Page 11

    Installing the 3ware CLI www.3ware.com 5 If you are uncertain whether you hav e th e correct permissions , contact your network administrator . T o st art CLI, do one of the following: • Start the 3ware CD and at the 3ware Escalade menu, click Run CLI. • Or , open a console window , change to the directory where tw_cli is located, and at the co[...]

  • Page 12

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 6 3ware Serial ATA RAID Controller CLI Guide W or king with 3ware CLI Y ou can work with the 3ware CLI in different ways: • Interactively , entering co mmands at the main prompt • As a series of single commands • By creating a script—an input file with mu ltiple commands The[...]

  • Page 13

    Working with 3ware CLI www.3ware.com 7 Using a single command with output Y ou can use 3ware CLI with line argume nts, processing a single command at a time. T o do so, simply enter the command and the arguments. Single commands can be useful when you want to perform a task such as redirecting the output of the command to a file. It also allows you[...]

  • Page 14

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 8 3ware Serial ATA RAID Controller CLI Guide Outputting the CLI to a T e xt File Y ou can have the output of the 3ware CLI, including errors, sent to a text file by adding 2>&1 to the end of the line. This could be useful, for example, if you want to email the output to AMCC [...]

  • Page 15

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 9 Under standing RAID Le v els and Concepts 3ware RAID controllers u se RAID (Redundant Array of In expensive Disks) to increase your storage system’ s pe rformance and provide fault tolerance (protection against data loss). This section organizes information ab out RAID concepts and config[...]

  • Page 16

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 10 3ware Serial ATA RAID Controller CLI Guide • Array Roaming. The process of removing a unit from a controller and putting it back later , either on the sa me controller , or a dif ferent one, and having it recognized as a un it. The di sks may be attached to dif ferent ports tha[...]

  • Page 17

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 11 RAID 1 RAID 1 provides fault tolerance and a speed advantag e over non-RAID disks. RAID 1 is also known as a mirrored array . Mirroring is done on pairs of drives. Mirrored disk arrays write the sam e data to two dif ferent drives using RAID 1 algorithms (see Figure ?). This gives your sys[...]

  • Page 18

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 12 3ware Serial ATA RAID Controller CLI Guide Figure 3. RAID 5 Configuration Example RAID 6 RAID 6 requires a 3ware 9650SE RAID controller . RAID 6 provides greater redund anc y and fa ult tolerance than RAID 5. It is similar to RAID 5, but has two blocks of parity information (P+Q)[...]

  • Page 19

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 13 Figure 4. RAID 6 Configuration Example RAID 10 RAID 10 is a combination of striped and mirrored arrays for fault tolerance and high performance. When drives are configured as a striped mirrored array , the disks are configured using both RAID 0 and RAID 1 techniqu es, thus the name RAID 10[...]

  • Page 20

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 14 3ware Serial ATA RAID Controller CLI Guide Figure 5. RAID 10 Configuration Example RAID 50 RAID 50 is a combination of RAID 5 wi th RAID 0. This array type provides fault tolerance and high performance. RAID 50 requires a minimum of six drives. Several combinations are available [...]

  • Page 21

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 15 Figure 6. RAID 50 Configuration Example Single Disk A single drive can be configured as a unit through 3ware software. (3BM, 3DM 2, or CLI). Like disks in other RAID configurations, single disk s contain 3ware Disk Control Block (DCB) information a nd are seen by the OS as available units.[...]

  • Page 22

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 16 3ware Serial ATA RAID Controller CLI Guide Hot S pare A hot spare is a single drive, available online, so that a redundant unit can be automatically rebuilt in case of drive failure. Deter mining W hat RAID Le vel to Use Y our choice of which type of RAID un it (array) to create [...]

  • Page 23

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 17 Using Drive Cap acity Efficiently T o make the most efficient use of drive capacity , it is advisable to use drives of the same capacity . This is because th e capacity of each drive is limited to the capacity of the sma llest drive in the unit. The total array capacity is defined as follo[...]

  • Page 24

    Chapter 1. Intr od uc tio n to the 3w ar e Command Line Interfa ce 18 3ware Serial ATA RAID Controller CLI Guide Through drive coercion, the capac ity us ed for each drive is rounded down so that drives from dif fering manufacturers ar e more likely to be able to be used as spares for each other . The capacity used for each drive is rounded down to[...]

  • Page 25

    www.3ware.com 19 2 CLI Syntax R eference This chapter provides deta iled information about us ing the command syntax for the 3ware CLI. Throughout this chapter the examples reflect the interactive method of executing 3ware CLI. Common T asks Mapped to CLI Commands The table below lists many of the task s pe ople use to manage their RAID controllers[...]

  • Page 26

    Chapter 2. CLI Syntax Reference 20 3ware Serial ATA RAID Controller CLI Guide Enable/disable unit write cache /cx/ux set cache 68 Set the queue policy /cx/ux set qpolicy 70 Set the storsave profil e /cx/ux set storsave 70 Unit Configuration Changes Change RAID level /cx/ux migrate 72 Change stripe size /cx/ux migrate 72 Expand unit capaci ty /cx/ux[...]

  • Page 27

    Syntax Overview www.3ware.com 21 Syntax Ov er view The command syntax uses the general form: Object Command Attributes Object s are shell commands, controllers, units, ports (drives), BBUs (battery backup units), and enclosures. Commands can either select (show , get, present, read) attributes or alter (add, change, set, write) attributes. Enable/d[...]

  • Page 28

    Chapter 2. CLI Syntax Reference 22 3ware Serial ATA RAID Controller CLI Guide Attributes are either Boolean Attribut es or Name-V alue Attributes. • The value of a boolean attribute is deduced by presence or lack of—that is, the attribute is either specified , or not. For example, the command show alarms by default lists alarms wit h the most r[...]

  • Page 29

    Shell Object Commands www.3ware.com 23 Enclosure Ob je ct C omm an ds. Enclosure object commands provide information and perform ac tions related to a par ticular en clo s ure . For example, you can use enclos ure object c ommands to see information about an enclosure and its elements (slots, fan, and temp erature sensor elements). Help Commands. H[...]

  • Page 30

    Chapter 2. CLI Syntax Reference 24 3ware Serial ATA RAID Controller CLI Guide //hostname specifies the root of host h ostname . .. specifies one level up (the parent ob ject). / specifies the root at the current focused hostname. ./ object specifies the next level of the object. /c0/bbu specifies a relative path with respect to the current focused [...]

  • Page 31

    Shell Object Commands www.3ware.com 25 background tasks. (Defin itions of the unit statuses are available in the 3war e Serial A T A RAID Contr oller User Guide .) For a system with an enclosure un it that includes support for an EPCT (Enclosure Port Configuration T able), applicable firmware and software, and an appropriate controller (9550SX, 95 [...]

  • Page 32

    Chapter 2. CLI Syntax Reference 26 3ware Serial ATA RAID Controller CLI Guide sho w alar ms [r e v er se] This command shows the alarms or AEN messages of all controllers in the system. The default is to display the most re cent message first. The reverse attribute displays the most recent message last. sho w dia g This command shows the diagnostic[...]

  • Page 33

    Shell Object Commands www.3ware.com 27 sho w verify This command displays all verify sche dules for the 9000 controllers in the system. Example: //localhost> show verify Verify Schedule for Controller /c0 ==================================== ==================== Slot Day Hour Duration Status ------------------------------------ -----------------[...]

  • Page 34

    Chapter 2. CLI Syntax Reference 28 3ware Serial ATA RAID Controller CLI Guide flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 44. rescan This command sends a rescan command to all 3ware controllers in the system. For more information, see “/cx rescan [noscan]” on[...]

  • Page 35

    Controller Object Commands www.3ware.com 29 Contr oller Object Commands Controller object co mmands provide in formation and perform actions related to a specific controller , such as /c0 . For example, you u se controller object commands to see alarms sp ecific to a controller , to create schedules for when background tasks are run, and to set po [...]

  • Page 36

    Chapter 2. CLI Syntax Reference 30 3ware Serial ATA RAID Controller CLI Guide /c x set autorebuild=on|off (9550SX, 9590SE , 9650SE) /cx set autodetect=on|off disk=<p:-p>|all /c x set verify=enable|disable|1..5 (9000 only) /c x set selftest=enable|disable [task=UDMA|SMART](9 000 only) /c x flush /c x update fw= filename_with_path [force] (9000[...]

  • Page 37

    Controller Object Commands www.3ware.com 31 backup the controller cache in the event of power loss ), temperature, voltage, readiness, and so forth. Additional attributes about controllers, units, ports and disks can be obtained by querying for them explicitly . For de tails, see the other show subcommands. T ypical output looks like: //localhost&g[...]

  • Page 38

    Chapter 2. CLI Syntax Reference 32 3ware Serial ATA RAID Controller CLI Guide /c x show driv er This command reports the device driver version associated with controller /c x . Example: //localhost> /c0 show driver /c0 Driver Version = 2.x /c x sho w model This command reports the cont roller model of controller /c x . Example: //localhost> /[...]

  • Page 39

    Controller Object Commands www.3ware.com 33 /c x show serial This command reports the serial num ber of the specif ied controller /c x . Example: //localhost> /c0 show serial /c0 Serial Number = F12705A3240009 /c x sho w pcb This command reports the PCB (Printed Circui t Board) version of the specified controller /c x . Example: //localhost> [...]

  • Page 40

    Chapter 2. CLI Syntax Reference 34 3ware Serial ATA RAID Controller CLI Guide /c x show numpor ts This command reports the port capacity (number of physical ports) of t he specified controller /c x . Example: //localhost> /c0 show numports /c0 Number of Ports = 12 /c x show numunits This command reports the number of un its currently managed by [...]

  • Page 41

    Controller Object Commands www.3ware.com 35 /c x sho w spinup This feature only applies to 9000 series controllers. This command reports the number of conc urrent disks that will spin up when the system is powered on, after waiting for the number of seconds specified with the set stagger comma nd. Example: //localhost> /c0 show spinup /c0 Disk S[...]

  • Page 42

    Chapter 2. CLI Syntax Reference 36 3ware Serial ATA RAID Controller CLI Guide For operating systems that support units la rger than 2TB, there is no need to set the policy to on unless you want the operati ng system to have multiple smaller volumes. If you use a 32-bit operating system, it is recommended that you keep the policy on unless you know [...]

  • Page 43

    Controller Object Commands www.3ware.com 37 /c x sho w autor e build This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This command shows the Au to-Rebuild policy . If the policy is enabled, the firmware will select drives to use for rebuilding a degraded unit using the following priority order . For mo re information, se[...]

  • Page 44

    Chapter 2. CLI Syntax Reference 38 3ware Serial ATA RAID Controller CLI Guide /c x sho w allunitstatus This command presents a count of tota l and Not Optimal units managed by the specified controller /c x . For more about the mean ing of Not Optimal, see “Shell Object Commands” on page 23. Example: //localhost> /c0 show allunitstatus /c0 To[...]

  • Page 45

    Controller Object Commands www.3ware.com 39 /c x sho w all This command shows the cu rrent setting of all of the following attributes on the specified controller: driver , model, memory , firmware, bios, monitor , serial, pcb, pchip, achip, n umports, numunits, numdrives, unitstatus, drivestatus, allunitstatus, exportjbo d, ondegrade, spinup, stagg[...]

  • Page 46

    Chapter 2. CLI Syntax Reference 40 3ware Serial ATA RAID Controller CLI Guide /c x add type =<RaidT ype> disk =<p:-p> [stripe= Stripe ] [noscan] [g r oup= <3|4|5|6|7|8> ] [nocac he] [auto v erify] [noqpolic y][ignor eECC] [name= string ] [stor sa v e=<pro tect|balance|perf or m>] This command allows you to create a ne w unit[...]

  • Page 47

    Controller Object Commands www.3ware.com 41 stripe= St r i p e consists of the stripe size to be used. The following table illustrates the supported an d applicable stripes on unit types and controller models. Stripe size units are in K (kiloby tes). If no stripe size is specified, 64K is used by default, if applicable. If you need to change the st[...]

  • Page 48

    Chapter 2. CLI Syntax Reference 42 3ware Serial ATA RAID Controller CLI Guide grouped into grou ps of 3 or 5 drives. For 16 disk s, the disks can be grouped into groups of 4 or 8 drives. noscan attribute instructs CLI not to no tify the operating system of the creation of the new unit. By default CLI will inform the operating system. One applicatio[...]

  • Page 49

    Controller Object Commands www.3ware.com 43 name= string attribute allows you to name th e new unit. (This feature is for 9000 series and above controllers.) The st ring can be up to 21 characters and cannot contain spaces. In order to use r eserved characters (‘<‘, ‘>’, ‘!’, ‘&’, etc.) put double quotes (" ") ar[...]

  • Page 50

    Chapter 2. CLI Syntax Reference 44 3ware Serial ATA RAID Controller CLI Guide /c x commit This command only applies to the W ind ows operating system . It commits all changes if a faster shutdown method is needed w hen run n ing certain database applications. Linux and FreeBSD file systems do not requ ire this command since they have their own ways[...]

  • Page 51

    Controller Object Commands www.3ware.com 45 Given the above recommendation... Do you want to continue ? Y|N [N]: y Downloading the firmware from file /tmp/prom0006.img ... Done. The new image will take effect after reboot. force attribute is optional. If you incl ude it, the compa tibility checks are bypassed. /c x sho w alar ms [r e v erse] Asynch[...]

  • Page 52

    Chapter 2. CLI Syntax Reference 46 3ware Serial ATA RAID Controller CLI Guide /c x show dia g This command extracts controller diag nostics suitable for technical support usage. Note that some characters might not be printable or rendered correctly (human readable). It is recommended to save the out put from this command to a file, where it can be [...]

  • Page 53

    Controller Object Commands www.3ware.com 47 A status of “disabled” indicates that the task schedule is disabled. In this case, the controller will not use the define d schedule timeslots. If the rebuild command is entered manually , rebuilding w ill start within 10 to 15 minutes. It will begin automatically if a rebuild is needed and a proper s[...]

  • Page 54

    Chapter 2. CLI Syntax Reference 48 3ware Serial ATA RAID Controller CLI Guide --------------------------------------------------------- ----------------- u0 RAID-5 INITIALIZING 0 - 64K 521 .466 ON OFF Port Status Unit Size Blocks Serial --------------------------------------------------------- ------ p0 NOT-PRESENT - - - - p1 OK u0 76.33 GB 1600865[...]

  • Page 55

    Controller Object Commands www.3ware.com 49 //localhost> /c1 show verify Verify Schedule for Controller /c1 =================================== ===================== Slot Day Hour Dur ation Status ----------------------------------- --------------------- 1 Mon 2:00am 4 hr(s) disabled 2 - - - disabled 3 Tue 12:00am 24 hr(s) disabled 4 Wed 12:00am[...]

  • Page 56

    Chapter 2. CLI Syntax Reference 50 3ware Serial ATA RAID Controller CLI Guide The show selftest command displays the current selftest background task schedule as illustrated below . Selftest s do not have a time du ration since they are completed momentarily . //localhost> /c1 show selftest Selftest Schedule for Controller /c 1 =================[...]

  • Page 57

    Controller Object Commands www.3ware.com 51 3U s e t h e /c x add rebuild co mmand to create the rebuild schedule slots you want (described above.) 4 Use the /c x set rebuild=enable command to enable the schedule (this enables all rebuild schedule slots). (For details, see page 53.) /c x add v erify= dd d:hh:duration This command adds a ne w bac kg[...]

  • Page 58

    Chapter 2. CLI Syntax Reference 52 3ware Serial ATA RAID Controller CLI Guide /c x add selftest= ddd: hh This command adds a new backgr ound selftest task to b e ex ecuted on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at hour hh (range 0 .. 23). Notice that selftest ru ns to completion and as such no duration is provided. A[...]

  • Page 59

    Controller Object Commands www.3ware.com 53 /c x del r e build= 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. /c x del v erify= slot_id This command removes the ve rify background task in slot slot_id . Example : //localhost> /[...]

  • Page 60

    Chapter 2. CLI Syntax Reference 54 3ware Serial ATA RAID Controller CLI Guide The priority of rebuild versus I/ O operations is specified with 1..5 , where 1 is more resources and 5 the least. Setting the value to 1 gives maximum processing time to rebuilds rather th an I/O. Setting the value to 5 gi ves maximum processing time to I/ O rather than [...]

  • Page 61

    Controller Object Commands www.3ware.com 55 /c x set e xpor tjbod=on|of f This command allows you to set the JBOD Export Policy to on or off . By default, exportjbod is off . If the JBOD export policy is off, CLI will not be able to create JBODs. During reboot, firmware will not export JB OD units to the operating system. The JBOD Export Pol icy is[...]

  • Page 62

    Chapter 2. CLI Syntax Reference 56 3ware Serial ATA RAID Controller CLI Guide /c x set sta g ger= nn This command is only fo r 9000 series controllers. This command allows you to set a cont roller-based Disk Spinup S tagger T ime Policy that specifies the de lay between spin-ups. The value must be a positive integer between 0 to 60 seconds. This po[...]

  • Page 63

    Controller Object Commands www.3ware.com 57 /c x set autorebuild=on|of f This command is only for 9 550SX , 9590SE, and 9650SE con trollers. This command turns the Auto-Rebuild policy on or off. By default, autorebuild is on. If the policy is on the firmware will select drives to use for rebuilding a degraded unit using the fo llowing priority orde[...]

  • Page 64

    Chapter 2. CLI Syntax Reference 58 3ware Serial ATA RAID Controller CLI Guide autodetect=on|off enables or disables automatic detection of drives on the controller ’ s ports fo r staggered spin-up. disk=<p:-p>|all specifies one or many disks (that is, drives or ports). If a port is empty (no drive is inserted), this featur e is disabled for[...]

  • Page 65

    Unit Object Commands www.3ware.com 59 /c x stop mediascan This command appli es only to 7000/8000 co ntrollers. This commands stops a media scan op eration on the specifie d controller /cx . (Media scans are started using /c x s tart mediascan .) Unit Object Commands Unit Object commands pr ovide information and perfo rm actions related to a specif[...]

  • Page 66

    Chapter 2. CLI Syntax Reference 60 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w This command shows summary info rmation about the specified unit /c x /u x . If the unit consists of sub-units as with the case of RAID-1, RAID-5, RAID-10, RAID-50, then each sub- unit is further presented. If the Auto-Carving policy was on at the time the[...]

  • Page 67

    Unit Object Commands www.3ware.com 61 /c x /u x sho w at tr ib u te [ a ttribute ...] This command shows the cu rrent setting of the specif ied attri but es. One or many attributes can be requested. Specifying an invalid attribute will terminate the loop. Possible attributes ar e: i nitializestatus, name (9000 series), qpolicy (9550SX, 9590SE, a nd[...]

  • Page 68

    Chapter 2. CLI Syntax Reference 62 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w initializestatus This command reports the initializestat us (if any) of th e specified unit. Example: //localhost> /c0/u5 show initialize status /c0/u5 is not initializing, its cur rent state is OK /c x /u x sho w name This feature only applies to 9000 [...]

  • Page 69

    Unit Object Commands www.3ware.com 63 /c x /u x sho w stor sav e This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This command reports the storsave policy on the unit. For more information see, “/cx/ux set storsave=protect|balance|perform [quiet]” on page 70. Example: //localhost> /c0/u5 show storsave /c0/u5 Comma[...]

  • Page 70

    Chapter 2. CLI Syntax Reference 64 3ware Serial ATA RAID Controller CLI Guide /c x /u x sho w ignor eECC This feature only applies to 9000 series controllers. This command shows the current setting of the ignoreECC policy for the specified unit. Example: //localhost> /c0/u0 show ignoreECC /c0/u0 Ignore ECC policy = off /c x /u x sho w volumes Th[...]

  • Page 71

    Unit Object Commands www.3ware.com 65 Unit UnitType Status %RCmpl %V/I/M Port S tripe Size(GB) --------------------------------------------------------- --------------- u1 RAID-0 OK - - - 6 4K 3576.06 u1-0 DISK OK - - p0 - 298.01 u1-1 DISK OK - - p1 - 298.01 u1-2 DISK OK - - p2 - 298.01 u1-3 DISK OK - - p3 - 298.01 u1-4 DISK OK - - p4 - 298.01 u1-5[...]

  • Page 72

    Chapter 2. CLI Syntax Reference 66 3ware Serial ATA RAID Controller CLI Guide /c x /u x del [noscan] [quiet] This command allows you to delete a unit. Deleting a unit not only removes the specified unit from the c ontroller's list of managed units, but al so destroys the DCB (Disk Configuration Block) meta data. After deleting a unit, ports (o[...]

  • Page 73

    Unit Object Commands www.3ware.com 67 /c x /u x star t v eri fy This command starts a backgr ou nd veri fication process on the specified unit /c x /u x . The following table shows the supported matrix as a function of the controller model and logical unit type. N/A (Not Applicable) refers to cases wh ere the given logical unit type is not supporte[...]

  • Page 74

    Chapter 2. CLI Syntax Reference 68 3ware Serial ATA RAID Controller CLI Guide functionality with use of Linux-provided schedulers such as cron(8) or at(1), or user supplied programs. /c x /u x stop v erify This command stops a bac kground veri fication process on the specified unit /c x /u x . T able 9 on page 6 7 sh ows the supported matrix as a f[...]

  • Page 75

    Unit Object Commands www.3ware.com 69 The quiet attribute turns of f interactive mode. /c x /u x set identify=on|of f This feature only app lies to 9550SX, 9590SE, and 9650 SE model controllers. This feature requires an enclosure that use s an integrated AMCC/3ware CCU (chassis control unit). (Check the 3ware web site for a list of chassis vendors [...]

  • Page 76

    Chapter 2. CLI Syntax Reference 70 3ware Serial ATA RAID Controller CLI Guide /c x /u x set name= string This command allows you to name the unit with an arbitrary name. Y ou can use this name in conjunction with th e unit serial number to cross-reference with the unit. The system does not check to ensure uniqueness of names, so be careful to assig[...]

  • Page 77

    Unit Object Commands www.3ware.com 71 protect provides the maximum data protec tion among the controller settings. When storsave is set to prot ect mode, it means : • When the unit becomes degraded, the write cache will be disabled. • W rite journaling is enabled. All data flushing from controller cache will be flushed to media. • Incoming FU[...]

  • Page 78

    Chapter 2. CLI Syntax Reference 72 3ware Serial ATA RAID Controller CLI Guide /c x /u x migr a te type= RaidT ype [disk= p:-p ] [g roup=3|4|5|6|7|8] [stripe= Stripe ] [noscan] [nocac he] [auto v erify] This feature only applies to 9000 series controllers. This command allows you to change th e existing configuration of a unit with type= RaidT ype .[...]

  • Page 79

    Unit Object Commands www.3ware.com 73 : disk= p:-p.. consists of a list of ports (disks) to be used in addition to the source disks in the construction of the destination unit. One or more ports can be specified. Multiple ports can be spec ified using a colon (:) or a dash (-) as port index separators. A dash indicates a ra nge and can be mixed wit[...]

  • Page 80

    Chapter 2. CLI Syntax Reference 74 3ware Serial ATA RAID Controller CLI Guide the best of net capacity and performan ce). For 15 disks, the disks can be grouped into grou ps of 3 or 5 drives. For 16 disk s, the disks can be grouped into groups of 4 or 8 drives. Note that RAID-10 always has gr ou p=2 , so an attribute specifying it’ s group is not[...]

  • Page 81

    Unit Object Commands www.3ware.com 75 autoverify attribute enables the autoverify a ttribute on the unit that is to be migrated. For more details on this feat ure, see “/cx/ux set autoverify=on|of f” on page 68. Migration Process In all cases of migration, the background migration process must be completed before the new ly sized unit is availa[...]

  • Page 82

    Chapter 2. CLI Syntax Reference 76 3ware Serial ATA RAID 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/u3 is a migrating unit with 39% completion. The report also indicate that Source Unit su0 is of type RAID-1 and Destination Unit [...]

  • Page 83

    Port Object Commands www.3ware.com 77 P or t Object Commands Port Object Messages are commands th at provide information and perform actions related to a specific disk, attached to a port, such as /c0/p0 . Y ou use port object commands for such tasks as seeing the status, model, or serial number of the drive. Synt ax /c x /p x s h o w /c x /p x sho[...]

  • Page 84

    Chapter 2. CLI Syntax Reference 78 3ware Serial ATA RAID Controller CLI Guide /c x /p x sho w status This command displays the status of th e drive attached to the specified port. (Definitions of the drive statuses are available in the 3war e Serial A T A RAID Contr oller User Guide .) Example: //localhost> /c0/p5 show status /c0/p5 Status = OK [...]

  • Page 85

    Port Object Commands www.3ware.com 79 /c x /p x sho w ncq This command appli es only to 9550SX, 9590SE, an d 9650SE model controllers. This command displays the NCQ (Nat ive Command Queuei ng) information for the drive attached to the specified port, in cluding whether NCQ is supported by the drive , and whet her it is enabled at the drive. For que[...]

  • Page 86

    Chapter 2. CLI Syntax Reference 80 3ware Serial ATA RAID Controller CLI Guide Example: //localhost> /c0/p5 show smart /c0/p5 Drive SMART Data: 10 00 01 0B 00 C8 C8 00 00 00 00 00 00 00 03 07 00 9A 96 BC 14 00 00 00 00 00 04 32 00 64 64 7A 00 00 00 00 00 00 05 33 00 C8 C8 00 00 00 00 00 ... 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 2C /c x /p [...]

  • Page 87

    Port Object Commands www.3ware.com 81 /c x /p x remo v e [noscan] [quiet] This command allows yo u to remove (or export) a port (or drive) /c x /p x . Exporting a port instructs the firmware to remove the spec ified port from its pool of managed ports, but does no t retain the DCB (D isk Configuration Block) metadata on the at tached disk . Y ou ca[...]

  • Page 88

    Chapter 2. CLI Syntax Reference 82 3ware Serial ATA RAID Controller CLI Guide BB U Object Commands BBU (Battery Backup Unit) Object Commands are commands that provide information and perform ac tions related to a specific BBU installed on a specific controller , such as /c0/bbu . This object is only available o n 9000 series controllers on which a [...]

  • Page 89

    BBU Object Commands www.3ware.com 83 /c x /bbu sho w at tr ib u te [ at tr ib u te ...] This command shows the current setting of the given attribute(s) on the BBU board. One or many attributes can be sp ecified. Specifying an invalid attribute will terminate the loop. Possible attribut es are: batinst, bootloader , cap, fw , lasttest, pcb, ready ,[...]

  • Page 90

    Chapter 2. CLI Syntax Reference 84 3ware Serial ATA RAID Controller CLI Guide /c x /bbu sho w batinst This command shows the date when the current battery was installed. /c x /bbu sho w lasttest This command shows the date the battery capacity was last measured. If the battery capacity test has n eve r been run, then 'xx-xxx-xxxx' will be[...]

  • Page 91

    BBU Object Commands www.3ware.com 85 /c x /bbu show serial This command shows the BBU serial number . /c x /bbu sho w fw This command shows the BBU firmware version number . /c x /bbu sho w pcb This command shows the PCB revision number on the BBU. /c x /bbu sho w bootloader This command shows the BBU's boot loader version. /c x /bbu sho w all[...]

  • Page 92

    Chapter 2. CLI Syntax Reference 86 3ware Serial ATA RAID Controller CLI Guide /c x /bbu test [quiet] This command starts the battery capacity test. The test may take up to 24 hours to complete. During the test, the BBU is not capable of backup operation and the write cache of all un its attached to that controller is disabled. Once the test is comp[...]

  • Page 93

    Enclosure Object Commands www.3ware.com 87 Enc losure Object Commands Enclosure obje ct commands provide in formation and perform actions related to a specific enclosure, such as /e0 and its elements, such as /e0/slot0 . Enclosure obje ct elements inclu de slot , fan, and temperature sensor elements. These commands are support ed on the 9550SX, 959[...]

  • Page 94

    Chapter 2. CLI Syntax Reference 88 3ware Serial ATA RAID Controller CLI Guide T ypical output looks like: //localhost> /e0 show Encl Controllers ------------------------- e0 /c0 Fan Status ---------------------- fan0 OK TempSensor Temperature ------------------------------- temp0 24~C(75~F) Slot Status Port Identify -----------------------------[...]

  • Page 95

    Enclosure Object Commands www.3ware.com 89 /e x sho w slots This command reports the slots in enclosure /ex and their associated information. Example: //localhost> /e0 show slots Slot Status Port Identify ----------------------------------- ----------------- slot0 OK /c0/p0 No slot1 OK /c0/p1 Yes slot2 NO-DEVICE - No slot3 NO-DEVICE - No /e x sh[...]

  • Page 96

    Chapter 2. CLI Syntax Reference 90 3ware Serial ATA RAID Controller CLI Guide /e x/slotx sho w This command shows inform ation about the specified /slot x on the specified enclosure /e x . The slot name is followed by its status. If a slot has been inserted with a drive and no fault has been detected, the status is OK. If the slot is empty the stat[...]

  • Page 97

    Help Commands www.3ware.com 91 /e x/fanx sho w This command shows the informatio n about the specified fan element /fan x in the specified enclosure /e x . The fan name is followed by its status. If a fan is on and no fault has been detect ed, the status would indicate OK. Example: //localhost> /e0/fan0 show Fan Status ------------------- fan0 O[...]

  • Page 98

    Chapter 2. CLI Syntax Reference 92 3ware Serial ATA RAID Controller CLI Guide //localhost> help /cx /cx show /cx show attribute [ attribute ...] where attribut e is: achip|allunitstatus|autocarve|autorebuild (9550SX, 9590SE, 9650SE only)|bios|carvesize(9000 series)| ctlbus (9550SX, 9590SE, 9650SE)|driver|drivestatus| exportjbod|firmware|memory|m[...]

  • Page 99

    Help Commands www.3ware.com 93 Help with a ttributes As you work with specific object s or commands, you can also use ? to get help. For example: If you enter the command /c0 show and then need help on what specific attribute syntax is possible, you can use ? to get help as following: //localhost> /c0 show ? /cx show /cx show attribute [ attribu[...]

  • Page 100

    Chapter 2. CLI Syntax Reference 94 3ware Serial ATA RAID Controller CLI Guide Certain commands are qualified with constraints of control ler type/model support. Please consult the tw_cli documentation for expla nation of the controller-qualifiers. The controller-qualifiers of the Enclosure commands (/ex) also apply to Enclosure Element specific com[...]

  • Page 101

    Help Commands www.3ware.com 95 help fo cu s This command provides sp ecific focus related help , illustrating various ways to use the focus command. See the section “Shell Object Commands” on page 23 for more information. help /c x This command provide s specific controller /c x related help, illustrating various commands associated with the co[...]

  • Page 102

    Chapter 2. CLI Syntax Reference 96 3ware Serial ATA RAID Controller CLI Guide help /e x /fan x This command provides specific fan /e x /fan x related help, illustrating various ways to use the /e x /fan x command. See the section “Enclosure Object Commands” on page 87 for more information. help /e x /temp x This command provides spec ific tempe[...]

  • Page 103

    Return Code www.3ware.com 97 For example, if you had a 3ware cont roller with an ID of 0, you could type this command: tw_cli /c0 show (c0 information displayed here) echo $? 0 If you type: tw_cli /c7 show error: (CLI003) specified controller does not exist. echo $? 1 This example fails (returns 1) b ecause there is no controller 7. T o view the re[...]