English dropdown-ico

AMCC 9590SE-4ME 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

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 9590SE-4ME, 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 9590SE-4ME 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 9590SE-4ME. 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 9590SE-4ME should contain:
- informations concerning technical data of AMCC 9590SE-4ME
- name of the manufacturer and a year of construction of the AMCC 9590SE-4ME item
- rules of operation, control and maintenance of the AMCC 9590SE-4ME 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 9590SE-4ME 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 9590SE-4ME, 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 9590SE-4ME.

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 9590SE-4ME 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 9590SE-4ME for the Power Mac® G5 PN: 720-0140-00 Septembe r 2006 CLI Guide for the Power Mac G5[...]

  • Page 2

    www.3ware.com ii Cop yright ©2003-2006 Applied Micro Circuits Corporation (AMCC). All rights reserved. Th is 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 [...]

  • Page 3

    www.3ware.com iii Table of Contents Chapter 1. Introduction to the 3ware Co mmand Line Interf ace . . . . . . . 3 Features of the CLI . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 T erminolo[...]

  • Page 4

    iv 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x show numdrives . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29 /c x show numports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 /c x show numunits . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 5

    www.3ware.com v /c x /u x show name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 /c x /u x show serial . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55 /c x /u x show qpolicy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 6

    vi 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /bbu show pcb . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 /c x /bbu show bootloader . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77 /c x /bbu show all . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 7

    www.3ware.com 1 About this CLI Guide 3war e Serial AT A RAID Contr oller CLI Guide for the Power Mac G5 provides instructions for configuring and main taining 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 . Whi[...]

  • Page 8

    2 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5[...]

  • Page 9

    www.3ware.com 3 1 Intr oduction to the 3war e Command Line Interf ace 3ware RAID controllers can be managed using the CLI via a command line or script. This chapter includes th e following sections: • “Features of the CLI” on page 3 • “Installing the 3ware CLI on Mac OS X” on page 5 • “W orking with 3ware CLI” on pa ge 5 • “Un[...]

  • Page 10

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 4 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Suppor ted Oper a ting Systems The 3ware CLI is supported under the following oper ating systems: •M a c O S X , running in a Power Mac® G5 (PowerPC™-based) with PCI Express®. •W i n d o w s ® . W indows 2[...]

  • Page 11

    Installing the 3ware CLI on Mac OS X www.3ware.com 5 Installing the 3ware CLI on Mac OS X 3ware CLI can be installed from the 3war e software CD, or the latest version can be downloaded from the 3w are web site, http://www .3ware.com/support/ download.asp. T o inst all 3ware CLI on Mac OS X • Run the installer and select CLI as the software to be[...]

  • Page 12

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 6 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Using the command interface interactiv el y Y ou c an use 3ware CLI inte ractively , entering commands at the main prompt and observing the results on the screen. T o use the CLI interactively 1 Enter the following[...]

  • Page 13

    Working with 3ware CLI www.3ware.com 7 Using an input file to e xecute a script Y ou can operate 3ware CLI scripts by executing a file. The file is a text file containing a list of CLI command s which you have entered in ad vance. Each command must be on a s eparate line. Synt ax tw_cli -f <filename> Where <filename> is the name of the [...]

  • Page 14

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 8 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Con ventions The following co nv en tio ns ar e used through this guide: • In text, monospace font is used for code and for things you type. • In descriptions and expl anations of commands, a bold fo nt indicat[...]

  • Page 15

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 9 RAID Concepts The following concepts are important to understand when working with a RAID controller: • Arrays and Unit s . In the storage industry , the term “array” is used to describe two or more disk drives that appear to the operating system as a single unit. When you work with 3[...]

  • Page 16

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 10 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 A v ailable RAID Configur ations The following RAID levels and config urations are available for drives attached to a 9590SE-4ME 3ware RAID controller: • RAID 0 • RAID 1 • RAID 5 • RAID 10 • Single Disk [...]

  • Page 17

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 11 Figure 1. RAID 0 Configuration Example RAID 1 RAID 1 provides fault tolerance and a speed advantag e over non-RAID disks. Also known as a mirrored array . Mirroring is done on pairs of dri ves. Mirrored disk arrays write the same data to two different drives using RAID 1 algorithms (see Fi[...]

  • Page 18

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 12 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Figure 3. RAID 5 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 a[...]

  • Page 19

    Understanding RAID Levels an d Co nc ep ts www.3ware.com 13 Single Disk A single drive can be configured as a unit through 3ware software. (3DM 2 or CLI). Like disks in other RAID config urations, single disks contain 3ware Disk Control Block (DCB) information and are seen by the OS as available units. Single drives are not fault tolerant an d ther[...]

  • Page 20

    Chapter 1. Intr od uc tio n to the 3w ar e Command Li ne Int er fa ce 14 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 [...]

  • Page 21

    www.3ware.com 15 2 CLI Syntax R ef er ence 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 th eir RAID controll[...]

  • Page 22

    Chapter 2. CLI Syntax Refere nce 16 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 T able 4: Common T asks Mapped to CLI Commands T a sk CLI Command Page Controller Co nfiguration T a sks View information about a controller /cx show 26 View controller policies /cx show [attribute] [attribute] 27 Set policies for a controller • Ex[...]

  • Page 23

    Common T asks Mapped to CLI Commands www.3ware.com 17 Add a time slot to a verify schedule /cx add verify 46 Add a time slot to a selftest schedule /cx add selftest 47 Enable/disable the rebui ld/migrate schedule and set the task rate /cx set rebuild 48 Enable/disable the verify schedule and set the task rate /cx set verify 49 Enable/disable the se[...]

  • Page 24

    Chapter 2. CLI Syntax Refere nce 18 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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)[...]

  • Page 25

    Shell Object Commands www.3ware.com 19 Port Object Commands. Port object commands provide information and perform actions related to a drive on a specific port. For example, you use port object commands for such tasks as seeing the status, model, or serial number of the drive. For details, see “P ort Object Comm an ds” on page 69. BBU Object Co[...]

  • Page 26

    Chapter 2. CLI Syntax Refere nce 20 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 if you set the focus to //hostname /c0/u0 , the prompt changes to reflect that, and you only have to type show . The conce pt is similar to being in a particular location in a file system and requesting a listing of the current directory . object can[...]

  • Page 27

    Shell Object Commands www.3ware.com 21 (Not Optimal) state, RRate (Rebuild Ra te) of 2, VRate (V erify Rate) of 5, BBU of '-' (Not Applicable). Not Optimal refers to any state except OK and VERIFYING . Other states include VERIFY -P AUSED, INITIALIZING , INIT - P AUSED, REBUILDING , REBUILD-P AUSED, DEGRADED, MIGRA TING , MIGRA T E-P AUSE[...]

  • Page 28

    Chapter 2. CLI Syntax Refere nce 22 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 comman[...]

  • Page 29

    Shell Object Commands www.3ware.com 23 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 30

    Chapter 2. CLI Syntax Refere nce 24 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 flush This command sends a flush command to all 3ware controllers in the system. For more information, see “/cx flush” on page 39. rescan This command sends a rescan command to all 3ware controllers in the system. For more information, see “/cx[...]

  • Page 31

    Controller Object Commands www.3ware.com 25 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 crea te schedules for when background tasks are run, and to set po[...]

  • Page 32

    Chapter 2. CLI Syntax Refere nce 26 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 filename_with_path [force] (9000 only) /c x commit (Windows only. Also known as sh utdown) /c x start mediascan (700[...]

  • Page 33

    Controller Object Commands www.3ware.com 27 T ypical output looks like: //localhost> /c0 show Unit UnitType Status %Cmpl Stripe Size(GB) Cache AVerify IgnECC ---------------------------------------------------------- ---------------- u0 RAID-1 OK - - 149.05 ON OFF OFF u1 RAID-5 OK - 64k 298.22 ON OFF OFF u2 SPARE OK - - 149.05 ON OFF - Port Stat[...]

  • Page 34

    Chapter 2. CLI Syntax Refere nce 28 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 . Exam[...]

  • Page 35

    Controller Object Commands www.3ware.com 29 /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 36

    Chapter 2. CLI Syntax Refere nce 30 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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[...]

  • Page 37

    Controller Object Commands www.3ware.com 31 /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 38

    Chapter 2. CLI Syntax Refere nce 32 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 poli[...]

  • Page 39

    Controller Object Commands www.3ware.com 33 /c x sho w autor ebuild This feature only applies to 955 0SX an d 9590SE 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, see “/cx s[...]

  • Page 40

    Chapter 2. CLI Syntax Refere nce 34 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 19. Example: //localhost> /c0 sho[...]

  • Page 41

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

  • Page 42

    Chapter 2. CLI Syntax Refere nce 36 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x add type =<RaidT ype> disk =<p:-p> [stripe= Stripe ] [noscan] [g r oup= <3|4|5|6> ] [nocac he] [auto verify] [ignoreECC] [name= string ] [stor sav e=<pr otect|balance|perfor m>] This command allows you to create a ne w un[...]

  • Page 43

    Controller Object Commands www.3ware.com 37 group= 3|4|5|6 indicates the number of disks p er group for a RAID 50 type. (This attribute can only be used when type=raid50.) Recall that a RAID 50 is a multi-tier array . At the bottom-most la yer , N number of disks per group are used to form the RAID 5 layer . These RA ID 5 arrays are then integrated[...]

  • Page 44

    Chapter 2. CLI Syntax Refere nce 38 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 (‘<‘, ‘>’, ‘!’,[...]

  • Page 45

    Controller Object Commands www.3ware.com 39 /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 of notifying the controller to do[...]

  • Page 46

    Chapter 2. CLI Syntax Refere nce 40 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 Recommendation: No need to update. 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 afte r reboot. force attribute is optional. If you[...]

  • Page 47

    Controller Object Commands www.3ware.com 41 In order to redirect the output you must run the following command from a command line, not from within the tw_cli shell. tw_cli /c0 show diag > diag.txt /c x show r ebuild 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . Rebuild is one of th [...]

  • Page 48

    Chapter 2. CLI Syntax Refere nce 42 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 If the rebuild schedule is enabled while a rebuild process is underway , the rebuild will pause until a scheduled time slot. Example: If a unit is in the initial ization state at noon on W ednesday and the rebuild schedule sh ow n above is in use (wi[...]

  • Page 49

    Controller Object Commands www.3ware.com 43 p9 OK u0 74.53 GB 156301488 3JV3WRHC p10 OK u0 74.53 GB 156301488 3JV3WQLQ p11 OK u0 74.53 GB 156301488 3JV3WQLZ /c x show v e rify 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . V erify is one of the su pported backgro und tasks. Rebuild and s[...]

  • Page 50

    Chapter 2. CLI Syntax Refere nce 44 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x show selftest 9000 series controllers support backgrou nd tasks and allow you to schedule a regular time when they occur . Selftest is one of the supported backgro und tasks. Rebuild and verify are other background tasks for which there are sepa[...]

  • Page 51

    Controller Object Commands www.3ware.com 45 /c x add r ebuild= dd d:hh:dur ation This command adds a new backgr ound rebu ild task to be executed on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at the hour hh (range 0 .. 23), for a duration of duration (range 1 .. 24) hours. A maximu m of seven rebuild tasks can be scheduled.[...]

  • Page 52

    Chapter 2. CLI Syntax Refere nce 46 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x add v erify= dd d:hh:dur a tion This command adds a ne w bac kground verify task to be executed on the day ddd (where ddd is Sun, Mon, T ue, W ed, Thu, Fri, and Sat), at hour hh (range 0 .. 23), for a duration of duration (range 1 .. 24) hours. [...]

  • Page 53

    Controller Object Commands www.3ware.com 47 /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 maximum of seven selftest tasks c[...]

  • Page 54

    Chapter 2. CLI Syntax Refere nce 48 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x del v e rify= slot_id This command removes the ve rify background task in slot slot_id . Example : //localhost> /c1 del verify=3 removes verify background task in slot 3. /c x del selftest= slot_id This command removes (or unregisters) the se[...]

  • Page 55

    Controller Object Commands www.3ware.com 49 /c x set v e rify=ena ble|disable|1..5 This command enables or disables al l verify background task slots on controller /c x and (when enabled ) sets the priority of verification versus I/O operations. When enabled, verify tasks will only be run during the time slots scheduled for verifies. If a verify is[...]

  • Page 56

    Chapter 2. CLI Syntax Refere nce 50 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x set onde g r ade=cacheoff|follo w This command is only for 9500S controllers. This command allows you to set a cont roller -based write cache policy . If the policy is set to cacheoff and a unit degrades, the firmware will disable the write-cach[...]

  • Page 57

    Controller Object Commands www.3ware.com 51 volume. Each volume can then be treated as an individual disk with its own file system. The default carvesize is 2 TB. This feature is useful for operating systems limited to 2TB file systems. For example, using the 2 TB default car vesize, a 3 TB unit will be confi gured into one 2 TB volume and one 1 TB[...]

  • Page 58

    Chapter 2. CLI Syntax Refere nce 52 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 having to specify it as a spare. It also means that if you accidentally disconnect a drive (causing the controller to see it as a failed drive) and then reconnect it, the controller will au tomatically try to use it again. If the policy is off, spare[...]

  • Page 59

    Unit Object Commands www.3ware.com 53 Unit Object Commands Unit Object commands pr ovide information and perfo rm actions related to a specific unit, such as /c0/u1 (unit 1 on contro ller 0). For example, yo u use logical disk object commands for such tasks as seeing the rebuild, verify , or initialize status of a unit, starting, stopping, and resu[...]

  • Page 60

    Chapter 2. CLI Syntax Refere nce 54 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 One application of the /c x /u x show command is to see which sub-unit of a degraded unit has caus ed the unit to degrade and which disk within that sub- unit is the source of degradation. Anot her application is to see the source and destination uni[...]

  • Page 61

    Unit Object Commands www.3ware.com 55 /c x /u x sho w r ebuildsta tus This command reports the rebuildstatus (if any) of the specified unit. Example: //localhost> /c0/u5 show rebuildsta tus /c0/u5 is not rebuilding, its curre nt state is OK If the unit is in the process of migrating, the command will return the following: //localhost> /c0/u5 [...]

  • Page 62

    Chapter 2. CLI Syntax Refere nce 56 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /u x sho w qpolicy This feature only applies to 955 0SX an d 9590SE model controllers. This command reports the queue policy of the firmware. If the queue policy is on, the firmware utilizes th e drive queueing pol icy . If some drives in the un[...]

  • Page 63

    Unit Object Commands www.3ware.com 57 /c x /u x sho w cache This command shows the current write cach e stat e of the specified unit. Example: //localhost> /c0/u0 show cache /c0/u0 Cache State = on /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 t[...]

  • Page 64

    Chapter 2. CLI Syntax Refere nce 58 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 u1-2 DISK OK - - p2 - 298.20 u1-3 DISK OK - - p3 - 298.20 u1-4 DISK OK - - p4 - 298.20 u1-5 DISK OK - - p5 - 298.20 u1-6 DISK OK - - p6 - 298.20 u1-7 DISK OK - - p7 - 298.20 u1-8 DISK OK - - p8 - 298.20 u1-9 DISK OK - - p9 - 298.20 u1-10 DISK OK - - [...]

  • Page 65

    Unit Object Commands www.3ware.com 59 noscan is used to not inform the operatin g system of this cha nge. The default is to inform the operating system. quiet is used for non-intera ctive mode. No confirma tion is given and the command is executed immediately . This is useful for scripting purpos es. Example of interactive mode: //localhost> /c0[...]

  • Page 66

    Chapter 2. CLI Syntax Refere nce 60 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 When you issue this comman d, the specified verify w ill begin if schedules are disabled; otherwise it will pause until the next scheduled verify . V erify will also pause if a rebuild or initializ ation is currently in progress. /c x /u x pause rebu[...]

  • Page 67

    Unit Object Commands www.3ware.com 61 /c x /u x flush This command allows yo u to flush th e write cache on the specified unit /u x associated w ith controller /c x . Note that this command does not apply to spare unit types. /c x /u x set auto v erify=on|of f This feature only applies to 9000 series controllers. This command allows you to turn on [...]

  • Page 68

    Chapter 2. CLI Syntax Refere nce 62 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /c x /u x set identify=on|of f This feature only applies to 955 0SX an d 9590SE model controllers. This command allows yo u to identify a unit withi n an enclosure. When that the EPCT (Enclosure Port Configuration T able) equates identify with blinki[...]

  • Page 69

    Unit Object Commands www.3ware.com 63 By default, qpolicy is off. Example: //localhost> /c0/u5 set qpolicy = on Setting Command Queuing Policy for unit /c0/u5 to [on] ... Do ne. /c x /u x set stor sav e=pr otect|balance|perfor m [quiet] This command appli es only to 9550SX and 9 590SE model controllers. This command sets the storsave policy to b[...]

  • Page 70

    Chapter 2. CLI Syntax Refere nce 64 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 • W rite journaling is disabled, if no BBU is present, and is enabled, if a BBU is present. All data flushing from controller c ache will be flushed to media if a BBU is installed and enabled. Otherwise, data will be flushed to disk only . • Inco[...]

  • Page 71

    Unit Object Commands www.3ware.com 65 type= RaidT ype specifies the RAID type of th e destination unit. Possible unit types include raid0 , raid1 , raid5 , raid10 , raid50 , or single . For example, type=raid5 indicates the destina tion unit is RAID-5. The type=single is a special case of the migrate command. It splits the source unit RAID-1 or TWI[...]

  • Page 72

    Chapter 2. CLI Syntax Refere nce 66 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 group= 3|4|5|6 indicates the number of disks p er group for a RAID 50 type. (This attribute can only be used when type=raid50.) Recall that a RAID 50 is a multi-tier array . At the bottom-most la yer , N number of disks per group are used to form the[...]

  • Page 73

    Unit Object Commands www.3ware.com 67 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|off” on page 61. Migration Process In all cases of migration, the background migration process must be completed before the new ly sized unit is availa [...]

  • Page 74

    Chapter 2. CLI Syntax Refere nce 68 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 //localhost> /c0/u0 migrate type=raid10 disk=2-3 stripe=16 Sending migration message to /c0/u0 ... Done. 3ware CLI> /c0 show Unit UnitType Status %Cmpl Stripe Size(GB) Cache AVerify IgnECC -------------------------------------------------------[...]

  • Page 75

    Port Object Commands www.3ware.com 69 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 76

    Chapter 2. CLI Syntax Refere nce 70 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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 Us er Guide .) Example: //localhost> /c0/p5 show sta[...]

  • Page 77

    Port Object Commands www.3ware.com 71 /c x /p x sho w ncq This command appli es only to 9550SX and 9 590SE 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 queuing to b[...]

  • Page 78

    Chapter 2. CLI Syntax Refere nce 72 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 0[...]

  • Page 79

    Port Object Commands www.3ware.com 73 /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 80

    Chapter 2. CLI Syntax Refere nce 74 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 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 c[...]

  • Page 81

    BBU Object Commands www.3ware.com 75 /c x /bbu sho w at t r i b u t e [ at t r i b u t e ...] 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, r[...]

  • Page 82

    Chapter 2. CLI Syntax Refere nce 76 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /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-[...]

  • Page 83

    BBU Object Commands www.3ware.com 77 /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 84

    Chapter 2. CLI Syntax Refere nce 78 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 AEN (Asynchronous Event Notification) messages are also generated by controllers to notify the us er of the command status. Check for AENs with the alarms command /c x show alarms [reverse] . Using the “reverse” attribute dis p lays the most rece[...]

  • Page 85

    Enclosure Object Commands www.3ware.com 79 Enc losur e Object Commands Enclosure obje ct commands prov ide in formation and perform actions related to a specific enclosure, such as /e0 and its elements, such as /e0/slot0 . Enclosure obje ct elements in clude slot , fan, and temperature sensor elements. These commands suppor t the 9550SX and 9590SE [...]

  • Page 86

    Chapter 2. CLI Syntax Refere nce 80 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 TempSensor Temperature ------------------------------- temp0 24~C(75~F) Slot Status Port Identify ----------------------------------- ----------------- slot0 OK /c0/p0 No slot1 OK /c0/p1 Yes slot2 NO-DEVICE - No slot3 NO-DEVICE - No /e x sho w a ttri[...]

  • Page 87

    Enclosure Object Commands www.3ware.com 81 /e x show fans This command lists the fans in enclosure /e x and shows their status. Possible statuses are OK and Unknown. Example: //localhost> /e0 show fans Fan Status ---------------------- fan0 OK /e x sho w temp This command lists the temperature sensors in enclosure /e x and the current temperatur[...]

  • Page 88

    Chapter 2. CLI Syntax Refere nce 82 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /e x /slot x sho w identify This command shows the identify status of the specified slot. The status can be either on or off . Example: //localhost> /e0/slot1 show identify /e0/slot1 Identify status = on /e x /slot x set identify=on|of f This comm[...]

  • Page 89

    Help Commands www.3ware.com 83 Help Commands The Help commands provid es brief on-line help. Y ou can get overview help by typing Help at the top-level prompt. This displays a brief definition of commands in both the new synt ax and the legacy syntax. (For an example, see the di scussion of the co mmand “help” on page 85.) Y ou can also get hel[...]

  • Page 90

    Chapter 2. CLI Syntax Refere nce 84 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 /cx del selftest= slot_id (9000 only) /cx set exportjbod=on|off (9000 only) /cx set ondegrade=cacheoff|follow (9500S only) /cx set spinup= nn (9000 only) /cx set stagger= nn (9000 only) /cx set autocarve=on|off (9000 only) /cx set rebuild=enable|disa[...]

  • Page 91

    Help Commands www.3ware.com 85 help This help command provide a table of contents, providin g help with the overall navigation of the CLI comman d s. T ypical output looks like the following. //localhost> help Copyright(c) 2004, 2005 Applied Micr o Circuits Corporation (AMCC). All rights reserved. AMCC/3ware CLI (version 2.x) Commands Descriptio[...]

  • Page 92

    Chapter 2. CLI Syntax Refere nce 86 3ware Serial ATA RAID Controller CLI Guide for the Power Mac G5 help res can This command provides spec ific rescan related help, illustrating various ways to use the rescan command. See the section “Shell Object Commands” on page 19 for more information. help upda te This command provides specific u pdate-re[...]

  • Page 93

    Return Code www.3ware.com 87 help /c x /bbu This command provides specific /c x /bbu related help, illustrating various ways to use the /c x /bbu command. Se e the section “BBU Object Com mands” on page 74 for mo re information. help /e x This command provide s specific enclosure /e x related help, illustrating various commands associated with [...]