Adaptec AAR-21610SA manual

R Command Line Interface Ref erence Guide[...]

ii Cop yright ©2000 – 2004 Adap tec, In c. All righ ts reserved. No p art of this p ublica tion m ay be repr oduc ed, stored in a r etrie val syst em, or tra nsmit ted in an y form or by any mean s, el ectr o nic, mechan ic al, ph otoc opy ing, re cor din g or oth erw ise, witho ut the prior wri tten c onse nt o f Ad apte c, I nc., 691 S outh Mi[...]

iii Contents 1 Intr oduc tion Audi e nc e 1 -1 Access ing th e CLI 1-2 Access ing the CL I fr om th e MS-DOS Prompt 1-2 Access ing the CLI i n Win dows 1-2 Access ing CLI i n Li nux and UNIX 1-2 Accessing CLI in NetW ar e 1-3 Term inol ogy 1-3 Conventions 1-4 Command Sy nt ax 1 -5 Class 1-5 Act i on 1- 6 Object 1-6 Switch 1-6 Value 1-6 Parameter 1-[...]

iv Cont ents 2 General C ontro l Comma nds close 2-2 exit 2-3 hel p, ? 2 -4 hist or y_si ze 2 -5 open 2 -6 reset_window 2-8 toggl e_mor e 2-9 3 container Commands contain er add_level 3-3 container create mirror 3-5 cont ai ner cr eat e mmi rr or 3 -8 container create ms tripe 3-12 container create mvolume 3-17 container create raid5 3-21 container[...]

v Cont ents container set failover 3-95 contain er set global_ failover 3-97 contain er set io_delay 3 -99 contain er set label 3-101 container show cache 3-103 contain er show fai lover 3-108 container spli t 3-109 contain er unlock 3-112 contain er unmirror 3-114 4 con troller Co mmands co ntro ller de tails 4-2 controller fi rmware compare 4-6 c[...]

vi Cont ents disk sho w space 5-26 disk verify 5-29 dis k ze r o 5- 31 6 diagnosti c Commands diagno stic clear boo t_parameters 6 -2 diagnostic dump structur es 6-3 diagno stic dump text 6-4 diagno stic load_ arrays 6-6 diagno stic moderation set count 6-7 di agno stic mo der ation se t ti me r 6-8 diagno stic moderation show count 6-9 diagno stic[...]

vii Cont ents enclosure s et power 9-19 enclosur e set scsi id 9- 21 enclosur e set temperat ure 9- 24 enclosure s how fan 9-26 enclosure s how power 9-29 enc losure sh ow slot 9-3 2 enclosur e s how status 9-36 enclosure s how temperature 9 -41 A Automate d Scrip ts Crea ti ng an Aut omat e d Scr ipt A-1[...]

1-1 1 Intr oduction In this Chapt er The CLI provides a command lin e alternat ive to Adap t ec Sto r ag e Manager . Th rough the CLI, you perform most of the storage managem ent task s that you can perfor m with the Ada ptec Storage Mana ger GUI and, in addition, some tasks not avai lable in Storage Manager . W ith CLI, you can also use the CLI co[...]

1-2 Introd uct ion Accessi ng the CLI This sectio n discu sses accessi ng the CL I in variou s operatin g sy stem s. Access ing the CLI from the MS-DOS Prompt T o access the CLI fr om the MS-DOS pr ompt, move to the dir ectory cont ain ing t he afacli e xecutable and then type afacli , as in the following example: C:>cd Program Files Adaptec_S[...]

1-3 Introd uct ion Accessing CLI in NetW are T o access the CLI from the NetW a r e server console, type aaccli at the pro mpt. When the system displays the CLI> pr ompt, which indicates that you can now use CLI comma nds. Te r m i n o l o g y This section d iscusses terminolo gy used in this Appe ndix . Adaptec 241 0SA/2810SA Co ntrollers Onl y[...]

1-4 Introd uct ion ■ Str i pe, ch un k — Contiguo us set of data distributed across all the disks in a n array . A striped array dis tributes data evenly a cr oss all mem bers in equal- sized section s called stri pe s . ■ Free o r avai lable spa ce —Space on an initia lized disk tha t is not in use. ■ Part ition —Con tigu ous ar ea of [...]

1-5 Introd uct ion T o exit subcomman d mode, press Enter . (Y ou may have to pr ess Enter mor e than once to exit subcommand mode.) ■ CLI-unique co mmands For NetW are systems, the following commands ar e unique to the CLI in that y ou use th ese comman ds when accessing th e CLI fr om the NetW are server con sole: ■ open ■ close ■ exit ?[...]

1-6 Introd uct ion Action An act ion specifies an operation to be performed by the CLI, s uch as open, cr eate, list, exit, or show . An action is a r equired element, except in subcommand mode. In m ost cases, actions ar e pr eceded by a class a nd followed by an object, switches , and parameters. Object An object describes what to use in an actio[...]

1-7 Introd uct ion P arameter Alth oug h some c omman ds hav e op tion al para mete rs, parame ters are usually mandato ry . Y ou must place optional parameters after mandatory parameters at the end of the command. For example, the array remove failover command has one r equire d scsi_device parameter and addition al optional scsi_device parameter [...]

1-8 Introd uct ion integer An integer is a positive or negative number that has a value between –2 63 and (2 63 – 1). Although the valid range is usually much sm aller , all integers h ave 64 bits of precision an d do not contain decimal points. Y ou can specify an integer as a mathem atical equa tion that uses a n ast erisk ( * ) to multip ly [...]

1-9 Introd uct ion Ta b l e 1 - 2 list s examples o f valid integers and th eir corr espondi ng values: string Yo u c a n s p e c i f y a t e x t stri ng with or witho ut quota tion marks . If spaces ar e needed, however , the string must be specified with quota tion marks; oth erwise, th e CLI interprets spaces as delimiters. A string can use eith[...]

1-10 Introd uct ion scsi _d evice Specifies a SCSI device. SCSI d evice descripti ons have t hree pa rts: SCSI chann el number , SCS I device ID, an d SCS I device logica l unit number (LUN). The follow ing syntax d efines the scsi_device parameter: ({integer},{integer},{integer}) Each integer corr esponds to one component of a SCSI de vice descrip[...]

1-11 Introd uct ion Ta b l e 1 - 5 d isplays vali d SCSI device specifiers. The seco nd tw o examples contain a def ault LUN numb er , and the last two exam ples co ntain default c hanne l and L UN numb ers. Y ou ca n specify these defaults using the disk set default command (see page 5-1 1 ). free _spac e Fr eespace (also kno wn as available space[...]

1-12 Introd uct ion Ta b l e 1 - 6 list s valid free_space spe cif ier s. Note: When specif ying freespace during an array create volume op eration, you mu st explicitly speci fy the SCSI device’s channel, device ID, a nd logical unit number . Y ou cannot use any defa ult values for the SCSI device. In addit ion, you m ust also specif y the siz e[...]

1-13 Introd uct ion Status In f ormat ion Whe n invok ed fr om t he MS- DOS pr om pt or t he W indows Start button, the CLI displa ys status in formatio n in the title bar of a DOS command pr ompt window as it executes a n asynchronous command. On NetW are, the status information appears in a dif ferent window . On UNIX systems, the CLI displays th[...]

1-14 Introd uct ion The Ctr and State Ite ms The Ctr item displays the ID number of the array a ssociated with the task. In the example, the arra y’s ID is 0 (zer o). The State item displays the state of the task along with a run ning per centage value that i ndicates the progr ess of the currently running task. The item shows the per centage in [...]

1-15 Introd uct ion Ta b l e 1 - 8 describes the state values that the State item can display . T a ble 1- 8 St ate V al ue s State Mea ning BAD Th e tas k fail ed and i s no lo ng er ru nni ng . DNE The ta sk succes sfully c omplete d or the tas k is no long er r unning ( that is, th e tas k is done). RUN The task is run ning. SUS The task was sus[...]

2-1 2 General Contr ol Comm ands In this Chapt er The CLI general control comm ands are discusse d in alphabetical or der and use the followi ng syntax: command [subcommand] [/switch{=value}] [parameter] clos e 2-2 ex i t 2-3 help , ? 2-4 histo r y _size 2-5 open 2-6 rese t_window 2-8 to ggl e_m ore 2-9[...]

2-2 General Contro l Commands clo se T o close the currently opened contr oller when all access is completed, use the close co mmand . Syntax close[...]

2-3 General Contro l Commands ex i t T o close the currently opened controller and exit the CLI, use the exit command. Syntax exit[...]

2-4 General Contro l Commands help , ? T o invoke general or topica l Help comman ds, use the help command or the ? (que st ion mar k). Syntax ? [{command}] {command} ? help [/full] [{command}] help [/full} {command subset} P arameters If the c omman d h as mo re sub comma nds , help lists th e su bcom mands and the ir f unct ion s. I f a c ompl et[...]

2-5 General Contro l Commands history_si ze T o set the size of th e command history buffer , use th e history_size command. Command Av ailability This command is supported only on UNIX. Syntax history_size {buffer_size} P arameters {buffer_size} Specifies the s ize of the command history buffer . The default size i s 200.[...]

2-6 General Contro l Commands open T o open a contr oller , use the open comm and. The open command pr epares a particular contr oller for access by the CLI. If you specify this command w hen another controller is open du ring a particular command session, the CLI closes the curr ently opened controller and then opens the specified con tr oller . S[...]

2-7 General Contro l Commands /doma in{=strin g} Specifies the domain (the local domain or a trusted domain) in which the specified computer that contains the contr oller r esi des. If you do not spe cify thi s switch, the CLI assum es the local do main. This switch is supported on W indows only . Note: Y ou can open controllers for read- write acc[...]

2-8 General Contro l Commands reset_wi ndo w T o r eset the windo w , use the reset_window comman d. Command Av ailability This command is supported only on UNIX. Syntax reset_window[...]

2-9 General Contro l Commands togg le_m or e T o turn on or of f the <Press any key to con tinue> fu nctionalit y , use the toggle_more command. After you type toggle_more on the NetW ar e console, the comman d displa ys an appr opriat e mess age indica ting whether th e <Press any key to conti nue> functio nalit y is on or off. Command[...]

3-1 3 container Commands In this Chapt er contai ner a dd_lev el 3-3 contai ner cr eate m irro r 3-5 contai ner cr eat e mmir ror 3-8 contai ner cr eate m str ipe 3-12 contai ner cr eate m v olum e 3-17 contai ner cr eate rai d5 3-21 contai ner cr eate s tr ipe 3-27 contai ner cr eat e volume 3-32 contai ner d elete 3-37 contai ner extend fi le_s y[...]

3-2 container Commands The arr ay commands ar e dis cussed in alpha betical or der a nd use the follow ing syn tax: container action [object] [/switch{=value}] [parameter] Note: The exampl es in this chapter assu me that you have first opened the contr oller befor e executing the container command . The initi al step of openi ng the controller is n[...]

3-3 container Commands cont ainer ad d_le ve l T o cr eate a mul tilevel volum e set from an existing a rray by addin g a volume set on top of the array , use the container add_level command. The existing array cann ot be a multilevel array . The container add_level com mand enables dynamic expansion o f an array and ca n be executed even while an [...]

3-4 container Commands Use the container list command af ter using the container add_level co mmand to display info rmatio n about the mul tilevel volume set, as in the f ollowing example: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------[...]

3-5 container Commands cont ainer creat e mirr or T o create a mirro r set fr om a single-partition volume set and fr eespace, use the container create mirror command. Any data on the origin al volume set remains inta ct during mirror cr eation and the user sees no interr uption in service. If you crea ted a mirr or set on a NetW ar e server , you [...]

3-6 container Commands Switches /wait{=boolean} Specifies wh ether to create the mirr or set sync hronously . If you set thi s switch to TRUE , the command pr om pt does not r eturn unt il the mirror -set cr eation co mpletes. If you set th is switch to FALSE , the mirror-set creation starts asyn chrono usl y an d the com man d promp t return s imm[...]

3-7 container Commands Use the container list command after the container create mirror comman d com pletes execution to display information about the mirr or set, as in the f ollowi ng example: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ [...]

3-8 container Commands cont ainer cr eate mmirr or T o cr eate a m ultilevel ar ray of mirror sets from a mul tilevel array of single-partition volume sets and fr eespace, use the container create mmirror command. T ypically , you use this command after promoting a volum e set built from multiple pa rtitions with the container promote co mm a nd . [...]

3-9 container Commands {scsi_device} Specif ies the ID for the SCSI device whos e fr eespace you want to use to cr eate the m ultilevel array of mirr or sets. The s ize of this fr eespace should be gr eater than or equal to the size o f the first unde rlying volum e set. A SCSI ID consists of a SCSI bus number (e.g., 0, 1, 2, 3, etc.), SCSI device [...]

3-10 container Commands Examples Befor e cr eating a multilevel array of mirror sets, use the container list command to obtain in format ion ab out an y existing arrays. A s the following example shows, arra y 0 is a volume set that consists of two underlyi ng volume sets cr eated with th e container promote comman d: AAC0>container list Executi[...]

3-11 container Commands The follow ing list describ es the cha nge to the disp lay as the result of cr eating a multilevel array of mirr or sets with the container create mmirror command: ■ The Dr column is blank to indicate that the newly cr eated mirr or s ets (63 and 62) do no t have a d rive let ter as signed to them. ■ The Ty p e colu mn d[...]

3-12 container Commands cont ainer cr eate mstr ipe T o cr eate a mul tilevel stripe set from equall y sized arra ys, use the container create mstripe command. The top level of a multilevel s tripe array can on ly be a stripe set. Y ou can create the followi ng types of mu ltilevel stripe set: ■ Stripe set of mirro r sets ■ Stripe set of volume[...]

3-13 container Commands {container}... Specifies the ID number or numbers (0 to 63) of one or mor e arrays from wh ich you want to create t he multilevel stri pe set. Y ou can use up to 16 arrays to cr eate a multilevel stripe set. All specified arrays must be the same size as the first container para meter and separated by blank spaces. Switches /[...]

3-14 container Commands The follow ing example sho ws how to create a multilevel stri pe set from two equally siz ed arrays, usi ng the default s tripe size of 64 KB . In this example, the tw o equally s ized array s are mirr or sets: AAC0>container create m stripe 0 1 Executing: container cr eate mstripe 0 1 container 0 created On UNIX systems,[...]

3-15 container Commands ■ The To t a l S i z e column disp lays the total siz e for the multilevel stripe set. This si ze is the total of all the un derlying arrays. In the example, the total size f or array 0 (th e multilevel stripe set) is the sum of th e two underlyi ng array s (30 M B). The To t a l S i z e column also displays the sizes of a[...]

3-16 container Commands Related Comm ands container commands: ■ container create mirror ( page 3 -5 ) ■ container list ( page 3-50 ) ■ container set label ( page 3 -101 )[...]

3-17 container Commands cont ainer creat e mv ol ume T o cr eate a mul tilevel volume set, use the container create mvolume command. Y ou can cr eate the following types of multilevel vo lume sets: ■ V olume se t of stri pe sets ■ V o lume set of mi rr or sets ■ V olume set of RAID 5 arrays ■ V olume set of volum e sets Notes When cr eating[...]

3-18 container Commands {container}... Specifies the ID (0 to 6 3) of one or m or e additional a rrays fr om which you want to creat e the multilev el volume set. Y ou can use up to 1 6 arrays . T ypically , the addi tional ar rays you s pecify ar e the sam e type as the first array . For examp le, if the first ar ray is a strip e se t the n an y s[...]

3-19 container Commands Use the container list command after using the container create mvolume comm and to d isplay info rmation about the multilevel array of volu me sets after you create it, as in the following example: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L [...]

3-20 container Commands ■ The Stripe Size c o l u m n d i s p l a y s t h e s t r i p e s i z e f o r e a c h o f t h e arrays that make up the multilevel volume set. Y ou specify the stripe size when you cr eate stripe sets an d RAID 5 arrays. In the example, the s tripe size is 32 KB. ■ The Usage column displays None to indicate tha t the new[...]

3-21 container Commands cont ainer cr eate raid5 T o create a R AID 5 array , use the container create raid5 comm and . The RAID 5 array must have a mi nimu m of t hr ee disks. When creating the RAID 5 array , you mu st initializ e the array parity by using the scrub method (the /scrub swit ch). Notes If you crea ted a RAID 5 array you can run the [...]

3-22 container Commands Switches /cache{=boolean} Specifies whether to enable the array’s raw arra y cache. Y ou can use this sw itch onl y if a nati ve operating s ystem’s file system ( for W i ndows, the NTFS or F A T file syst em) resides on the array . If you do not w ant to enable the RAID 5 array’s raw array cache when you cr eate it, y[...]

3-23 container Commands /clear{=boolean} Specifies w hether to set up t he parity durin g RAID-5 cre ati on by clearing the entir e RAID 5 array . If you specify TRUE , the command sets up the parity durin g RAID-5 creation by clear ing the RAID 5 ar ray . The default is FALSE ; the command does n ot clear the entire RAI D 5 a rra y . If you use n [...]

3-24 container Commands /scrub{=boolean} Specifies w hether to set up t he parity durin g RAID-5 cre ati on by scrubbing the RA ID 5 a rray . If you set thi s switch to TRUE , the command sets up th e parity by scrubbing the RAID 5 array . Although the drive is im mediately ava ilable, it is not parity-protected until the ba ckground scrub actio n [...]

3-25 container Commands As the command executes, note that the title bar of the MS- DOS window displays the status of the command. For example: Stat:OK!Task:101,Func:R 5S Ctr:0,State:RUN 84.6% For further deta ils on status info rmation, see page 1- 13 . On UNIX systems, the message d isplayed after you execute the container create raid5 command in[...]

3-26 container Commands ■ The Usag e co lumn displ ays None to indicate tha t the newly cr eated RAID 5 a rray does not have a f ile system on it.T o cr eate an NTFS or F A T file system on an array , use the container format command. ■ The State c olumn dis plays the state of an array , which in the exam ple sh ows Unprot t o i ndic ate th at [...]

3-27 container Commands cont ainer cr eate stri pe T o create a s tripe set fro m freespace , use the container create stripe command. Notes If you cr eated a stripe set you can run the list devices command on the NetW ar e console to verify its cr eation and then cr eate the necessary NetW are disk pa rtitions and volumes. For information on how t[...]

3-28 container Commands Switches /cache{=boolean} Specifies whether to enable the array’s raw arra y cache.Y ou can use this sw itch onl y if a nati ve operating s ystem’s file system ( for W i ndows, the NTFS or F A T file syst em) resides on the array . If you do not want to enable the stripe set’s raw array cache when you cr eate it, you c[...]

3-29 container Commands /label{=string} Specifies a label to be assigned to the newly created array . Y ou can specify a maximum of sixteen character s for the label. If you do not specify the sw itch, it defaults to no label. If you do not specify a la bel, you can do so later by usi ng the container set label command. Note tha t this label is not[...]

3-30 container Commands Use the container list command af ter using the container create stripe comm and to dis play info rmatio n about th e array , as in the following example: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- -----[...]

3-31 container Commands ■ The Parti tion Of fset: Si ze column displa ys the partition of fset(s) and the size (s) fo r the disk(s) w hose ass ociated fr eespaces you used to cr eate the array . In this example, the display shows 64 .0KB:15MB, 6 4.0KB:15.0MB, and 64.0KB:1 5.0MB. Related Comm ands container commands: ■ container create mstripe ([...]

3-32 container Commands cont ainer creat e v olume T o create a vo lume set fr om fr eespace, use the container create volume command. Notes If you cr eated a volume set you can run the list dev ices command on the NetW ar e console to verify its cr eation and then cr eate the necessary NetW are disk pa rtitions and volumes. For information on how [...]

3-33 container Commands {scsi_device},{free_space}... Speci fies an y addition al SCS I device s and a ssociate d fr eespaces used to cr eate the volume set. A volume set can have a maximum of 1 6 partitions (or fr eespaces, since ea ch fr eespace becomes a partition). Note that you must explicitl y specify the entire ID for any additiona l SCSI de[...]

3-34 container Commands /label{=string} Specifies a la bel to be assign ed to the new ly created volume set. Y ou can sp ecify a maxim um of sixte en chara cters for the label. If you do not specify the sw itch, it defaults to no label. If you do not specify a la bel, you can do so later by usi ng the container set label command. Note tha t this la[...]

3-35 container Commands Use the container list command after executing the container create volume comma nd to display information about the volume set, as in th e followin g example: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- [...]

3-36 container Commands ■ container list ( page 3-50 ) ■ container promote ( page 3 -63 ) ■ container set cache ( page 3 -91 ) ■ container set label ( page 3 -101 ) disk commands: ■ disk show space ( page 5-26 )[...]

3-37 container Commands cont ainer delet e T o delete an array fr om the curr ently opened contr oller , use the container delete command. Notes If you ar e deleting an array o n a NetW ar e system, you must firs t go to the NetW ar e consol e and r emove the corr espon ding volume and partition. For information on how to perform these operations, [...]

3-38 container Commands /unconditional{=boolean} Specifies whether to delete the array , even if the array has open files on it. If you specif y TRUE , th e c omm and del ete s th e array even if it has open files on it. The switch defaults t o FALSE (that is, the container delete comman d does no t delete an array t hat has open files on it). W A [...]

3-39 container Commands Related Comm ands container commands: ■ container create mirror ( page 3 -5 ) ■ container create mmirror ( page 3 -8 ) ■ container create mstripe ( page 3 -12 ) ■ container create mvolume ( page 3 -17 ) ■ container create raid5 ( page 3 -21 ) ■ container create stripe ( page 3 -27 ) ■ container create volume ( [...]

3-40 container Commands cont ainer e xt end file_sy stem T o extend a file system so that it uses all of the space in an array , use the container extend file_system comman d. This command allows you to extend the NTFS file system. T y pically , you use thi s comman d after extending an array (by adding a level to it with the container add_level co[...]

3-41 container Commands P arameters {container} Specifies the ID number (0 to 63) o f the array whose file system you want to extend. Examples T y pically , you w ould us e the container extend file_system com mand af ter a dd ing a le ve l to an arr ay an d, perhap s, a fter extending a multilevel volume set . Befor e extending a file system, use [...]

3-42 container Commands The follow ing example extend s the NTFS file system to mak e use of the additiona l arrays: AAC0>container extend f ile_system 0 Executing: container ex tend file_system 0 The system has been mar ked to expand the file system on the next reboot. Reboot the system to ge t the file system to expand to show the new space. U[...]

3-43 container Commands cont ainer e xtend mv olume T o exten d a mult ilevel volume set by adding one o r more arrays to it, use the container extend mvolume comman d. Any file system on the multilevel volume set remains intact, an d can be extended to include the added space. Command and Switch Av ailability This command is suppor ted on W indows[...]

3-44 container Commands Examples Before extending a multilevel vo lume set, use the container list command to obtain informat ion abo ut any existin g arrays. As the follo wing example shows, ther e is an array 0 (a multilevel volume se t) on this controller . In additio n, the example s hows array 1 and array 2 (both volume sets created with the c[...]

3-45 container Commands The follow ing list describ es the cha nge to the disp lay as the result of extending a multilevel a rray with the container extend mvolume command: ■ The Num Label colum n continu es to disp lay t he ID num ber (0) of the v olume se t previousl y created with t he cont aine r crea te volu me command and the ID num ber (63[...]

3-46 container Commands Related Comm ands container commands: ■ container add_level ( page 3 -3 ) ■ container create mvolume ( page 3 -17 ) ■ container create volume ( page 3 -32 ) ■ container extend file_system ( pa ge 3-40 ) ■ container list ( page 3-50 ) disk commands: ■ disk remove dead_partitions ( pa ge 5-10 )[...]

3-47 container Commands cont ainer e xtend v olume T o extend a volum e set by adding fr eespace to it, use the container extend volume command. The f ile system on the volume set remain s intact and can be extended to include the added space. Command and Switch Av ailability This command is suppor ted on W indows. Syntax container extend volume {c[...]

3-48 container Commands Befor e extending th e volume set, you might want to us e the dis k show space co mm and t o d ispl ay sp ace us ag e i nfor mat ion on th e SCSI devices from which you plan to a dd freespace. The followin g example extends a volum e set by adding fr eespace fr om two SCSI devices: AAC0>container extend v olume 1 ((2,0,0)[...]

3-49 container Commands ■ The Parti tion Of fset:Si ze column dis plays th e partition offset(s) and si ze(s) for the partitio n(s) associa ted with the extended volume set. In th e example the partit ion offsets and sizes ar e 64.0 KB a nd 32. 0 MB. If a partition is dead, the “:” (colo n) in the Partition Offset:Size column chan ges to a ?[...]

3-50 container Commands cont ainer l ist T o display i nformation about one or all a rrays on th e controller , use the container list command. The display conta ins such information as the containe r ’s ID number and other useful informa tion. T ypicall y , you u se the container list command to obtain specif ic informatio n about arrays prior t[...]

3-51 container Commands Examples The follow ing exam ple shows how to list no ndetailed in formatio n about all a rrays on the system: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- ------ ------- ------ ---------- --- 0 Volume 15.[...]

3-52 container Commands This colu mn also display s the label assi gned to the array wh en the array was created. If no label w as assign ed to the array th en no label appears in the column . Y o u can assig n labels w ith the followi ng comm and s: ■ container create mstripe ■ container create mvolume ■ container create raid5 ■ container [...]

3-53 container Commands The Reconf arr ay type does not appear on UNIX systems. The T otal Size Column This colu mn displays th e size of the array . Y ou speci fy this size when cr eating the array with one of the container create - r elated commands. The Stripe Size Colu mn This colu mn displays th e stripe size for the a rray . Y ou specify the [...]

3-54 container Commands The Scsi C :ID:L Colu mn This colu mn displays th e SCSI chan nel number , the SCSI ID, an d the SCSI logical unit number for the SCSI disk or disks on which the array wa s created . The P artition Offset:Size Col umn This colu mn displa ys the offset and size for th e underlying partitio ns. If a partition is dead, the “:[...]

3-55 container Commands The R O Column This colu mn displays th e letters RO if the array i s read-only . Otherwis e, if the array is read-write the column dis plays a blan k space. Y o u can explicitl y make an array read-only a nd r ead-write with th e container readonly and container readwrite commands. Some CLI commands cause an array to tempor[...]

3-56 container Commands Rebuild A r ebuild task is ru nning on the specified a rray . T ypica lly , the reb uil d t as k run s w he n t he co nt rol le r is in a reb u ild for a redundant array (RAID 5 array , m irror set, or m ultilevel array of mir ro r sets). Reconfg An array reconfigure task is running on the specified array . When the array re[...]

3-57 container Commands The Done % Column This column dis plays a runni ng percentage value that ind icates the pr ogress of the curr ently running task. The display shows the per centage in tenths of a per cent incr ements. The curr ently running task is complete when the Done % column displays 100%. The Ent Column This column displays the number [...]

3-58 container Commands The Boot Devic e Column This colu mn displays a value tha t indicates whether the a rray r esides on the boot device. An X appears in the column if the array r esides on the boot device. Otherwise, if the array does not resi de on the boot device, no value appea rs in the column. The Boot Devi ce column does not appear on UN[...]

3-59 container Commands cont ainer l oc k Caution: Us e the container lock com mand only under the direction of technical support. T o lock an array into volatile memory space on the curr ently opened contr oller , use the container lock co mmand. When an array is locked in to volatile mem ory space, the container reconfigure command has no ef fect[...]

3-60 container Commands Use the container list command (with the /full switch) after using the container lock command to displa y informa tion about the array yo u just lock ed, as in the foll owing example: AAC0>container list /fu ll Executing: container li st /full=TRUE Num Total Oth Stripe Scsi Dr Label Type Size Ctr Size Usage C:ID:L Lk -- -[...]

3-61 container Commands cont ainer mo ve T o renumber a n array , use the container move co mmand. If another array alr eady has the new number , the command returns an err or . Notes A contr oller curr ently supports 24 visible arrays. A visible arr ay is an array that is visible to the operating system and users. V isible arrays ar e identified w[...]

3-62 container Commands Examples Befor e r enumbering an array , use the container list command to obtain informa tion about any existing arrays. As the followi ng exam ple shows, there is an a rray 0 (a volum e set) on this controller: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size[...]

3-63 container Commands cont ainer pr omot e T o create a multilevel volume set fro m a stripe set or volume set, use the container promote command. In this case, the r esu lting array is an array of sin gle-pa rtition volum e sets, each of which has a singl e partition from the orig inal array . T y pically , you use the container promote command [...]

3-64 container Commands A s t h e f o l l o w i n g e x am p l e s h o w s , t h er e i s a n a r r a y 0 ( a s t r i p e s e t ) o n this controller: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- ------ ------- ------ ---------- [...]

3-65 container Commands ■ The Scsi C:ID:L column displays th e SCSI chan nel number , SCSI device ID, an d SCSI logical unit number for the underlying arrays. In the example, array 6 3 res ides on disk 0:02: 0, array 62 r esides o n disk 0:0 3:0, and array 61 re sides on disk 0:04:0. ■ The Part ition Of fset: Size co lumn displays the of fset a[...]

3-66 container Commands cont ainer re adonl y T o change an array’s r ead- write s tatus to r ead- only st atus, u se the container readonly comman d. Subs equ ent mod ifica tions to the data on the arra y are prohibited. T o use the container readonly command, the ar ray cannot be in use by any applica tion. Syntax container readonly {container}[...]

3-67 container Commands Use the container list co mmand (with the /full switch) after using the container readonly command to display informa tion ab out the array yo u just ma de read-only , a s in the following example: AAC0>container list /fu ll Executing: container li st /full=TRUE Num Total Oth Stripe Scsi Dr Label Type Size Ctr Size Usage [...]

3-68 container Commands cont ainer re ad write T o change an array ’s r ead-onl y statu s to r ead-wri te stat us, use the container readwrite comm and. Subs equen t mo difi cati ons to the data on the arra y are allowed. T o use the container readwrite comma nd, no ne of the arr ay’s file s can be open . Syntax container readwrite {container} [...]

3-69 container Commands Note that the exam ple elimin ates some items in the container list display so that you can see an example of the RO co lumn. As a result of ma king an array (in th is example, array 0) read-write with th e container readwrite comman d, the RO column displays bla nk (instead of an RO) to indicate that the specified array is [...]

3-70 container Commands cont ainer re configur e T o change the configuration of an array , use the container reconfigure command. The container reconfigure command a llows you to perform th e follow ing operatio ns: ■ T ransf orm an arra y fr om one ty pe t o anot her ty pe Y ou can transform an arr ay from one type to a nother type. For exam pl[...]

3-71 container Commands ■ Move partitions to other di sks Y ou can move an array’s partitions to other disks by specifying th e appropriate switches with a valid partition o r partitions. For example, you can move thr ee entries of a RAID 5 ar ray to ne w di sks. Y ou can combine the previously lis ted operations. Notes Some reconfigure operati[...]

3-72 container Commands {scsi_device}... Spe cif ies on e o r mor e SC SI devi ces. T ypical ly , yo u sp ec ify one or mor e SCSI de vices when adding mor e driv es to an array o r moving an array’s partitions. A SCSI ID consists of a SCSI channel number (fo r example, 0, 1, 2, 3, etc.), a SCSI device ID (0 thro ugh 1 5 inclusive), and a SCSI de[...]

3-73 container Commands /extend_fs{=boolean} Specifies whether to extend the file system s o that it occupies the entir e r econfigured array . If you specify TRUE , the command adds no new fr eespace and extend s the file system so that it occupies the entir e r econfigured array . (The command extends the file sys tem after compl eting the r econ[...]

3-74 container Commands /raid5{=boolean} Specifies whether to rec o nfigure the existing array into a RAID 5 array . If you specify TRUE , the command reconfigures the existing array into a RAID 5 array . If you specif y FALSE , the comman d does no t r econf igure the existing array into a RAI D 5 a rra y . Th is s wit ch defa ults to F ALSE . /ra[...]

3-75 container Commands Examples Use the container list co mma nd to obtain in formati on abou t any existing arrays. As th e following example shows, ther e is an array 0 (a mirro r set) and an array 1 (a volume set) on this controller: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Siz[...]

3-76 container Commands ■ container extend file_system ( pa ge 3-40 ) ■ container list ( page 3-50 )[...]

3-77 container Commands cont ainer re lease_c ache T o release the cache buffers associated with a specific array , use the container release_cache com mand. When a disk fail s or you rem ove a disk, the cache buf fers associated with specific arra ys r emain locked on the cont r oller . This all ows th e opportuni ty for the disk to come back onli[...]

3-78 container Commands cont ainer re mo ve drive _letter T o r emove a drive letter , use the container remove drive_letter command. T o use the container remove drive_letter command, none of the arr ay’ s files can be o pen. Command Av aila bility This command is suppor ted on W indows. Syntax container remove drive_letter {string} P arameters [...]

3-79 container Commands As the result of re mov ing a drive letter from an arra y (in this example, array 0) with the container remove drive_letter command: ■ The Dr colum n no longer d isplays the d rive letter assigned in a previo us use of the container assign drive_letter command. In this exam ple, the letter F no longer appears in the Dr col[...]

3-80 container Commands cont ainer re mo ve fail o ver T o remove one or mor e failover disks that wer e assigned to an array using the container set failover c omma nd, use the container remove failover co mmand. Syntax container remove failover {container} {scsi_device} [{scsi_device}...] P arameters {container} Sp eci fi e s th e I D nu mb er (0[...]

3-81 container Commands Use the container show failover co mman d af ter removi ng a failover disk from an array’s f ailover d isk list wit h the container remove failover comm and to disp lay informa tion abo ut the array’s failo ver disk list, as in the follow ing exam ple: AAC0>container show fai lover Executing: container sh ow failover [...]

3-82 container Commands cont ainer re mo ve file_sy stem T o remove the file sy stem fr om an array , use the container remove file_system command. Use this command when the file system on the arra y is no longer needed. This command fa ils if ther e are o pen files on the arra y . Command Av aila bility This command is suppor ted on W indows. Synt[...]

3-83 container Commands The following example r e moves the file system fr om array 0: AAC0>container remove f ile_system 0 Executing: container re move file_system 0 Use the container list co mm an d aft er rem ovin g a fil e syst em from an array with the container remove file_system command to display in formati on abou t the container , as i[...]

3-84 container Commands cont ainer re mo ve global_f ailo ver T o remove one or mor e failover disks that wer e assigned to all arrays through the container set global_failover command, use the cont ainer remove global_failover command. Syntax container remove global_failover {scsi_device} [{scsi_device}...] P arameters {scsi_device} Specifies the [...]

3-85 container Commands Use the container show failover co mman d af ter removi ng a failover disk from an array’s f ailover d isk list wit h the container remove failover comm and to disp lay informa tion abo ut the array’s failo ver disk list, as in the follow ing exam ple: AAC0>container show fai lover Executing: container sh ow failover [...]

3-86 container Commands cont ainer re store RAID5 T o restor e a RAID 5 array , use the container restore RAID5 command. T ypically , you use th is comm and to r est ore a RAID 5 array that co ntain s one or more dead partitio ns. Th is comman d does not always succeed; ther efore, use it only if all other measur es fail. One situation wher e the c[...]

3-87 container Commands Use the container list comm and af ter using the container restore RAID5 comm and to dis play info rmatio n about th e RAID 5 ar ray: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- ------ ------- ------ ----[...]

3-88 container Commands cont ainer scr ub T o scrub a r edundant array , use the container scru b command. A mirror set, a multilevel array of mirror sets, and a RAID 5 array ar e examples of redun dant arrays. For a m irr or set o r a multilevel array of mirr o r sets, this mean s the command r econstructs the data o n both mirror halves (part iti[...]

3-89 container Commands /wait{=boolean} Specifies whether the command pe rforms the scrub action synchronous ly or asy nchronously . If you s et this swit ch to TRUE , the command performs the scrub action synchron ously , whic h me ans the c omm and prompt doe s not r eturn unt il the scrub action completes. If you set this swit ch to FALSE , the [...]

3-90 container Commands Related Comm ands container commands: ■ container create mirror ( page 3 -5 ) ■ container create mmirror ( page 3 -8 ) ■ container create raid5 ( page 3 -21 ) ■ container list ( page 3-50 )[...]

3-91 container Commands cont ainer set cac he T o set cache parameters for a specific array , use the container set cache co mman d. Y ou can u se t his co mmand on ly if a na tive operatin g syste m’s file sys tem (f or W ind ows, NTF S, or F A T) resides on the ar ray . The CLI prevents you from sett ing cache parameters if t he array i s invol[...]

3-92 container Commands Switches /read_cache_enable{=boolean} Specifies whether to ena ble the read -ahead cache. If you set this sw itch to TRUE , the co mmand en ables the r ead-ahead cache for the specified ar ray . This switch should always be enabled to optimize perfo rmance, unless your application-- which is unlikely --is doing completely ra[...]

3-93 container Commands Ta b l e 3 - 5 summarizes the values for the /write_cache_enable and /unprotected swi tche s: Examples Befor e setti ng cache para meters for a specif ic array , use the container list command to obtain in formatio n abou t an y existing arrays. As the follo wing example shows, ther e is an array 0 (a volume set) on this con[...]

3-94 container Commands The following example sets cache par ameters for array 0 by accepting all of the defaults: AAC0>container set cach e 0 Executing: container se t cache 0 After setting cache para meters for a specific array , use the container show cache command to display cache parameter informa tion, as in the follo wing example: AAC0>[...]

3-95 container Commands cont ainer set failo ver T o assign an a utomatic failover disk (s) for a sin gle array , use the container set failover comm and . If th e arr ay wa s alread y assigned a fai lover disk(s), the com mand adds the specified dis k(s) to the ar ray’s lis t of failover d isk(s) . Althou gh al l array t ypes accept failove r as[...]

3-96 container Commands As the follo wing example shows, ther e is an arra y 0 (a mirr or set) on this controller: AAC0>container list Executing: container li st Num Total Oth Stripe Scsi Partition Dr Label Type Size Ctr Size Usage C:ID:L Offset:Size -- ----- ------ ------ --- ------ ------- ------ ---------- --- D: 0 Mirror 10.0MB NTFS 0:02:0 6[...]

3-97 container Commands cont ainer set global_f ailo ver T o assign an autom atic failover disk( s) for all arra ys, use the container set global_failover command. If the array was already as signe d a f ailov er d isk (s) , the com mand add s t he specified disk (s) to the array’ s list of failover disk(s) . Altho ugh al l array types accept fai[...]

3-98 container Commands The follow ing exam ple assign s two SC SI failover dis ks to al l arrays. I f you as sign o nly one SCS I disk a s a failo ver device, ensure that ther e is sufficien t fr eespace. If you assign more th an one SCSI disk as failover devices , you need ensure that only one of these disks ha s sufficient space . The reason for[...]

3-99 container Commands cont ainer set io_dela y T o set the I/O delay for an array , use the container set io_delay comm and. Y ou can s pecify an I/O delay fo r the followi ng array -related tasks: ■ Cr eating a mirr or set ■ Cr eating a multilevel array of mirr or sets fro m a multilevel array of vo lume sets ■ Scrubbing a redundan t array[...]

3-100 container Commands The follow ing exam ple cr eate s a mirror set asynch ronously an d sets an I/O dela y of 20 m illisecond s for array 0. Y ou need to perform the cr eate mirr or task asyn chr onously . Otherwise, yo u cannot chan ge the I/O delay: container create mirror /io_delay=20 0 (0,2,0) Executing cont ainer create mirror /io_delay=2[...]

3-101 container Commands cont ainer set label T o assign a new label to the specified array or to assign a la bel to an array that has no label, use the container set label command. The followin g commands have a /label sw itch t hat al low s you t o assign a label to the arra y when you create it: ■ container create mstripe (a multilevel stripe [...]

3-102 container Commands Examples Before assigning a label to a specif ic array , use the container list command to obtain informat ion abo ut any existin g arrays. As the follo wing example shows, ther e is an array 0 (a volume set) on this controller with no label assigned to it (as evidenced by no label in the Num Label column): AAC0>containe[...]

3-103 container Commands cont ainer sho w cache T o display th e curr ent cache pa rameters as sociat ed with a specific array , use the container show cache command. T ypicall y , you use this command after setting cache parameters for a specific array using the container set cache command. Syntax container show cache {container} P arameters {cont[...]

3-104 container Commands The follow ing list provides a brief des cription of th e items that app ear as a resu lt of us ing the container show cache command: ■ Glob al ar ray R ead Ca che S ize This item indicates th e number of blocks devoted to the read cache. ■ Global arra y W rite Ca che Size This item in dicates t he num ber of bl ocks de[...]

3-105 container Commands ■ W rite Cache Status This item indicates the curr ent status of the write cache for the array an d, wher e appropria te, the status of the battery . Ta b l e 3 - 7 displays the values for W r ite Cache Status: T ab le 3-7 V alues f or Wr ite Ca che Sta tus V alu e Meaning Active, not pr otected The status of the write c [...]

3-106 container Commands Active, not protected, battery reconditioning The status of the write cache for this array is a s fol low s: ■ Active – The write c ache can ac cept write o per- ations from the array . ■ Not pr otected – The write cache is force- enabled. Thus, the write cache accepts write operations even if write data could be lo[...]

3-107 container Commands Related Comm ands container commands: ■ container list ( page 3-50 ) ■ container set cache ( page 3 -91 ) ■ container show cache ( page 3 -103 ) Inactive, cache disa bled The status of the write c ache for this array is a s fol low s: ■ Inactiv e – T he wr ite cache canno t acce pt writ e operations fr om the arra[...]

3-108 container Commands cont ainer sho w failo ver T o display a list of failo ver dis ks assigne d to an array , use the container show failover comm and . Y o u as sig n fail over disks to a n array w ith the container set failover command. Syntax container show failover [{container}] P arameters {container} Sp eci fi e s th e I D nu mb er (0 to[...]

3-109 container Commands cont ainer spl it T o split a mirror set or a multil evel array of mirror sets into two separate singl e-partiti on volum e sets or two multilevel arrays of single-pa rtition volum e sets, use the container split command. Once this command completes execution, the two volume sets cannot be mer ged. Befor e using this comman[...]

3-110 container Commands Examples Befor e splitting a mi rr or set or a m ultilevel array of mirror sets, use the container list command to obtain i nformati on abo ut any existing arrays. As the following example shows, ther e is one existing array (arra y 0, a mirr o r set) on this contr oller at the time the mirror set is split: AAC0>containe[...]

3-111 container Commands ■ The Usage colum n display s NTFS to ind icate that f ile system s exist on both arrays . Y ou can create an NTFS or F A T file system on an array by using the container format command. ■ The Scsi C:ID:L column displays th e SCSI device IDs for the disk on which the split mirror set (now two vo lume sets) r eside. In t[...]

3-112 container Commands cont ainer unloc k Caution: Us e the container unlock comma nd only under the dir ection of T echnical Support. T o unlock an array so it can be moved, deleted , made read-only , and used to create a multilevel array , use th e container unlock command. Syntax container unlock {container} P arameters {container} Specifies t[...]

3-113 container Commands Use the container list co mmand (with the /full switch) after using the container unlock command to dis play informa tion about the unlocked a rray , as in th e followin g example: AAC0>container list /fu ll Executing: container li st /full=TRUE Num Total Oth Stripe Scsi Dr Label Type Size Ctr Size Usage C:ID:L Lk -- ---[...]

3-114 container Commands cont ainer unmirr or T o unmirror a mirror set, resulting in a sing le-partit ion volu me set and fr eespace, use the containe r unmirror command. N ote that ther e is no equivalent command for a multilevel array of mirro r sets. T o unmirror a m ultilevel array of mirror sets, use this command for each underlying mirror se[...]

3-115 container Commands The follow ing list de scribes the ch anges to the display as a result of using the container unmirror comma nd: ■ The Ty p e colu mn displays Vo l u m e , which indicates th at the mirr or set was cr eated fr o m a V olume set. ■ The State c olumn dis plays a bla nk space instea d of Normal. The Normal state is display[...]

4-1 4 contr oller Commands In this Chapt er con tro ller det ail s 4-2 cont roller fi r mwa re compar e 4-6 cont roller fi r mwa re sa v e 4-7 contr oller f ir mware update 4-9 cont roll er li st 4- 10 contr olle r paus e_io 4-12 cont roller rescan 4-14 contr olle r reset _scsi_ chann el 4-15 contr olle r resum e_io 4-16 contr olle r set automat ic[...]

4-2 contro ller Comm ands cont r oller det ails T o display deta ils abou t the curr ently o pened controller , use the controller details co mman d. These deta ils include th e controller type and softwa r e revision levels. Syntax controller details Examples The follow ing example sho ws sample ou tput as a r esult of using the controller details[...]

4-3 contro ller Comm ands The Contr oller type I tem The Controller type: item displays the contro ller type. In the example, the contr oller type is Adaptec 5400S . The Acces s Mode Item The Access Mode: item displays the access mode of the controller . The comma nd displays th e value READ-WRITE if you opened the contr o ller for r ead-write oper[...]

4-4 contro ller Comm ands The Contr oller CPU Speed and Controlle r Memory Items The Controller CPU Speed: item (if available) displays the clock spee d (in mega hert z) of the CPU that resides on th e contr o ller . In the example, the speed is 233 Mhz. The Controller Memory: item displays th e total amou nt of memory on the contr o ller that pro [...]

4-5 contro ller Comm ands Related Comm ands Gen e ral co nt rol c om m and s: ■ open ( page 2-6 ) Servic e: Displa ys th e rev ision level of the network serv ices soft ware . This item displays only if the open cont ro ller re sides on a remot e computer . In the example, the r evision le vel is 2.1-0 (B uild #28 81). Remote API: Display s the r[...]

4-6 contro ller Comm ands cont rol ler firmware compa re T o compare the contents of each of the flash components on a contr oller to the corr esponding image in a pair of user flash image (UFI) files and in dicate whether they match, use the controller firmware compare command. Syntax controller firmware compare [/C[{controller_ID}][{controller_ID[...]

4-7 contro ller Comm ands cont rol ler firmware sa ve Note: This command is n ot supported in Linux. T o save the contents of a contr o ller ’s flash in a pa ir of user flash imag e (UFI) files, use the controller firmware save command. The na mes of the pair of UFI files ar e based on the contr o ller type and cannot be chan ged. Syntax controll[...]

4-8 contro ller Comm ands Related Comm ands controller commands: ■ controller firmware compare ( page 4-6 ) ■ controller firmware update ( page 4-9 )[...]

4-9 contro ller Comm ands cont rol ler firmware upd ate T o update a controller ’s flash com ponents from the flash im age data in a pair of user fl ash imag e (UFI) fi les, use the controller firmware update command. This command can update the flash com ponent s on a single co ntroller or multiple con trollers. Syntax controller firmware update[...]

4-10 contro ller Comm ands cont r oller li st T o list all controllers on a specif ied computer or dis play specific informatio n about the curr ently o pened controller , use the controller list command. Syntax controller list [/domain{=string}] [{string}] P arameters {string} Specifi es the comput er name from which you w ant to dis play a list o[...]

4-11 contro ller Comm ands The Adapter Type item displays the contr oller type. In the example, the contr oller type is Adaptec 5400S . The A vailability Item The Availability item displays the ava ilability of the controller . Ta b l e 4 - 4 list s the values th at can displa y in this item. T ab le 4-4 C ontroll er A v ailabili ty Status Related [...]

4-12 contro ller Comm ands cont rol ler pau se_io T o pause all I/O a ctivity o n the currently opened con tr oller , use the controller pause_io command. While I/O activity is paused, you can m ake changes to devi ces attached to the controller without r ebooting. For example, you can add , re move, or change SCSI channe l assig nm ents. Before us[...]

4-13 contro ller Comm ands Notes The contro ller automatically performs a r escan of the SCSI channel befor e the I/O is resumed. Using thi s command w hen there is a pagefile on an array could cause unexpected behavior . Use of the controller pause_io co mmand is n ot permitted while an array ta sk is running on the controller . ( Use the task lis[...]

4-14 contro ller Comm ands cont ro ller re scan T o rescan the SCSI channels on the currently opened controller and update all underlying st ructur es, use the controller rescan command. The ef fect of this comm and is to verify curr ently connected di sks or to r ecognize new disks add ed to the channel. This comman d r escans the di sks for the a[...]

4-15 contro ller Comm ands cont rol ler reset_scs i_c hannel T o r eset a specific SCSI ch annel, use the controller reset_scsi_channel command. Syntax controller reset_scsi_channel {integer} P arameters {integer} Specif ies the con tro ller ch annel (for exampl e, 0, 1, 2 , 3, e tc.) on which yo u want to reset this SCSI chan nel. See the insta ll[...]

4-16 contro ller Comm ands cont rol ler re sume_io T o rescan the SCSI channels and r es ume all I/O activity on the curr ently opened, previously paused contr oller , use the controller resume_io command. Y ou u se this command after pausing the co ntroller with the controller pause_io command. Syntax controller resume_io Examples The follow ing e[...]

4-17 contro ller Comm ands cont rol ler set aut omatic_ failo ver Automa tic failover al lows yo u to replace a failed dis k with a r eplacement disk. The contro ller then automatically assign s the disk yo u inse rt as a fa ilover disk wi thou t your having t o firs t assi gn it with the array set failover or array set global_failover command. Not[...]

4-18 contro ller Comm ands Syntax controller set automatic_failover [/failover_enabled{=boolean}] /failover_enabled{=boolean} Speci fies wh ethe r to tu rn on or off automa tic fai lover on the specified controller . Y ou m ust set this s witch to TRUE if you want to turn on automatic f ailover on the sp ecified controller . T o turn off automatic [...]

4-19 contro ller Comm ands cont rol ler set arra y_verif y T o enable or disable the array verify operation, use th e controller set verify command. This com mand allo ws you to enable or disable the ar ray verify operation for all arrays controlled by the specified controller . Syntax controller set array_verify [/verify_enabled{=boolean}] /verify[...]

4-20 contro ller Comm ands Related Comm ands controller commands: ■ controller show array_verify ( page 4-25 )[...]

4-21 contro ller Comm ands cont rol ler sho w automatic_fa ilo ver T o display the aut omatic failover status (enabl ed or disabl ed) for the specified contr oller , use the controller show automatic_failover command. Syntax controller show automatic_failover Examples The follow ing example sho ws that the co ntroller ’s au tomatic failover is cu[...]

4-22 contro ller Comm ands cont rol ler sho w channels T o show all of the channels on a contr oller and the associated characteristics of each ch annel, use t he controller show channels command. See the instal lation guide for your controller to determine th e number o f channels it actual ly supports . Syntax controller show channels Examples In[...]

4-23 contro ller Comm ands The T argets and T ype Items The T argets item displays the number of SCSI device IDs not includin g the controller ID, which in the exam ple is 15 for all channels. The T ype item displays th e SCSI channel type the cha nnel is capable of supporting, which in the exam ple is NoInfo for all channels. The controller show c[...]

4-24 contro ller Comm ands Related Comm ands controller commands: ■ controller details ( page 4-2 )[...]

4-25 contro ller Comm ands cont rol ler sho w arra y_verif y T o display the array verify status (enabled or disabled) f or the specified controller , use the controller show array_verify command. Syntax controller show array_verify Examples Befor e turning the array verify featur e on or of f, check its status by using the controller show array_ve[...]

5-1 5 disk Commands In this Chapt er Use the follow ing syn tax for disk comman ds: disk command [object] [/switch{=value}] [parameter] disk blink 5-2 dis k init iali ze 5-3 disk list 5-5 disk r emov e dead _pa r tition s 5-10 disk s et d ef ault 5-11 dis k set sm ar t 5-13 disk s how default 5-16 dis k sho w def ects 5-17 disk show pa r titio n 5-[...]

5-2 disk Com mands disk bli nk T o cause a S CSI disk access ligh t to blin k (or stop bli nking), use the disk blink command. Syntax disk blink [/wait{=boolean}] {scsi_device} {integer} P arameters {scsi_device} Specif ies the ID for the S CSI disk yo u want t o blink. A SCSI ID consists of a S C SI channel number (for exa mple, 0, 1, 2, 3 , etc.)[...]

5-3 disk Com mands disk in itia liz e T o i nitiali ze a SCSI disk fo r use with the currently opened controller , use th e disk initialize command . Thi s comman d wri tes data str uctur es to the dis k so tha t the co ntro ller ca n use th e disk. Syntax disk initialize [/always{=boolean}] [/unconditional{=boolean}]{scsi_device} P arameters {scsi[...]

5-4 disk Com mands /unconditional{=boolean} Specifies whether to initialize the disk even if ar rays on the disk have open f iles. If you specif y TRUE for this switch, the command initializes the disk even if the disk has open files. The default is FALSE ; that is, the disk initialize comman d does not in itialize a disk that has open f iles o n i[...]

5-5 disk Com mands disk list T o display a list of the disks available o n the currently opened contr oller , use the disk list command. Syntax disk list [/all{=boolean}] [/full{=boolean)] [{scsi_device}] P arameters {scsi_device} Specifies the ID f or a specific SCSI device for which you want to displa y informa tion. A SCSI device cons ists of a [...]

5-6 disk Com mands Examples The follow ing exam ple shows how to displa y nondeta iled informa tion for all of the S CSI disks on the currently opened controller: AAC0>disk list Executing: disk list C:ID:L Device Type Blocks Bytes/Block Usage Shared Rate ------ ---------- --------- ----------- ----------- ----- - ---- 2:00:0 Disk 8887200 512 Ini[...]

5-7 disk Com mands The De vice T ype Column The Devic e T ype c o l u m n di s p la y s t h e S C S I d e vi c e t yp e. T he disk list command ca n display one of th e values list ed in Ta b l e 5 - 1 . T ab le 5-1 De vice T ype V alues The Remo vable media Column The Removable media column displays the value Y if th e media in the device is r em [...]

5-8 disk Com mands The Re v Column The Rev column displays the r evision number of the SCSI device. The Bloc k Column The Bl ock column display s the num ber of blocks availa ble on the SC SI de vi ce . The Bytes/ Block C olumn The Byte s/Bloc k colum n displays the number of bytes for each block on the SCSI device. The Usa ge Column The Usage colu[...]

5-9 disk Com mands The Rate Column The Ra te column displays the n egotiated speed of the SCSI device, in megabytes per seco nd. Related Comm ands disk commands: ■ disk initialize ( page 5-3 ) ■ disk show partition ( page 5 -19 ) ■ disk show space ( page 5-26 )[...]

5-10 disk Com mands disk remo ve dead_pa r titio ns T o remove al l dead partitions fr o m a SCSI disk, use the disk remove dead_partitions command . A dead pa rtition is a partitio n that is no longer used by an y array . T y pically , you use thi s comman d only under specif ic cir cumst ances. Fo r example, if you remove a disk f r om a redund a[...]

5-11 disk Com mands disk set default T o set the default SCSI ID for use in subsequent CLI commands, use the disk set default command. This command allows you to set defaults for a sp ecific SCSI device’s SCSI device chan nel number and SCSI device logical unit nu mber . Then, in subsequent commands, you need only specify the SCSI d evice ID on t[...]

5-12 disk Com mands Related Comm ands disk commands: ■ disk list ( page 5-5 ) ■ disk show default ( page 5-16 )[...]

5-13 disk Com mands disk set smart T o change a device’s S.M.A.R .T . configuration, use the disk set smart com mand. The acr onym S.M.A. R.T . stands for Sel f- Monitori ng, Analys is and Rep orting T echnolog y . This techno logy is an industry standard for hard drives that monito rs a variety of disk parameters, s uch as the rate of r e ad-wri[...]

5-14 disk Com mands Specifies whether to enable S.M.A.R.T . configuratio ns (enable exception reporting) f or all disks o n the s ystem. If y ou specify TRUE for this s witch, the command enables S.M.A.R.T . configura tions for a ll dis ks on the sy stem . The default is FALSE; the disk set smart comma nd doe s not enable S.M .A.R.T . conf iguratio[...]

5-15 disk Com mands /mrie={integer} <?> /perf{=boolean} Spe cifies whether to r eport except ions acc or ding t o the MR IE mode tak ing into acco unt performanc e. If you specify TRUE for this switch, the command performs exception reporting as long as performance is not an issue. If performance is an issue, the command doe s not repo rt exc[...]

5-16 disk Com mands disk sho w defaul t T o display the current default for the SCSI device ID, use the disk show default comman d. Y ou previously set this d efault usi ng the disk set default command. Syntax disk show default Examples The fol lowing example shows the default for a SCSI device ID t hat was set in a previous use of the disk set def[...]

5-17 disk Com mands disk sho w def ects T o show the number of defects and/or th e defect lis t for a speci fic SCSI disk drive, use the disk show defects com mand. Syntax disk show defects [/full{=boolean}]{scsi_device} P arameters {scsi_device} Specifies the ID for the SCSI device for which you want to display def ect info rmation. A SCS I device[...]

5-18 disk Com mands The items in the displ ay are described as f ollows : ■ Number of P RIMAR Y defects on dri ve: This item sho ws the detail s r egarding any primary disk defects. In the example, the re ar e two defects. ■ Defect 1 at cylinder 1 2, head 5, secto r 59 This item shows wher e defect 1 occurr ed. In the example, the defect occurr[...]

5-19 disk Com mands disk sho w partition T o display a list of partiti ons on the disks at tache d to the currently opened contr oller , use the disk show partition command. Syntax disk show partition Examples The following example shows a s ample output from the disk show partition command: AAC0>disk show partitio n Executing: disk show pa rtit[...]

5-20 disk Com mands The Arra y Num and Arra y T ype Columns The Arra y Num column displays th e ID of the prima ry array in the partition. In the example, the array ID is 0 . The Arra y Ty p e co lumn disp lays the type of a rray in which the partitio n r es ides. Ta b l e 5 - 3 lists the possible values that the command can display in the T ype co[...]

5-21 disk Com mands The R/W Column The R/W column displa ys whet her the partitio n is read-only or r ead-w rite. Specifically , the col umn ca n disp lay the valu es listed in Ta b l e 5 - 5 . T ab le 5 -5 R/W Arr a y V alues Va l u e M e a n i n g RO The partition is read-o nly . R W The partition is re ad-wri te.[...]

5-22 disk Com mands disk show smart T o display S. M.A.R.T . con figuratio n informatio n for one or a ll disk s, use the disk show smart command. The acr onym S.M.A.R.T . sta nds for Self-Mo nitorin g, Analysi s and Repo rting T ech nology . This techno logy is an in dustry stan dard for hard drives that monitors a variety of disk param eters, suc[...]

5-23 disk Com mands /full{=boolean} Spe cifies whet her to displ ay deta iled S.M.A .R.T . configuratio n informa tion for o ne or all SCSI disks. If you specify TRUE , the com mand displa ys detailed S.M.A.R.T . configura tion info rmation. If you specify FALSE , th e command does not display detailed S .M.A.R.T . confi guration informa tion. Th i[...]

5-24 disk Com mands The C:ID:L Column The C:ID:L colum n display s the SCSI chann el number , the SCSI device ID, and the SCSI devi ce logical unit number for each disk on the curren tly opened controller . (The display shows only one disk if you specif ied a particular disk.) In the example, the co mmand displays the SCSI channel number , the SCSI[...]

5-25 disk Com mands The Log Err ors Column The Log Errors column displays th e value Y if you enabl ed log err ors or N if you did not enabl e log errors. Y ou enable lo g err ors by using the disk set smart comm and’s /logerr switch. If you spe cifie d t he /view_ changeable switch , the command display s an X in this column for thos e disks on [...]

5-26 disk Com mands disk sho w spa ce T o display space usage information on a SCSI disk , use the disk show space command. Syntax disk show space [/all{=boolean}] [{scsi_device}] P arameters {scsi_device} Specifies the ID for the SCSI device for which you want to display sp ace usage informa tion. A SCS I ID consi sts of a SCSI channel number (fo [...]

5-27 disk Com mands The following example shows space usage information for SCSI disk device (0,2,0): AAC0>disk show space (0 ,2,0) Executing: disk show sp ace (ID=2) Scsi C:ID:L Usage Size ----------- --------- ------------- 0:02:0 Array 64.0KB: 20.0MB 0:02:0 Free 20.0MB: 29.0MB The follow ing sectio ns provide mor e inf ormation on the columns[...]

5-28 disk Com mands The Size Column The Size column displays the of fset (in bytes) into the SCSI device and the size of the partition or space (in bytes). In the example, the of fs et and sizes for the f irst two dis ks ar e as fo llows: ■ For the 0:02:0 disk The off s et is 64.0 K B for the partition and 20 .0 MB for the unused space. The size [...]

5-29 disk Com mands disk veri fy T o verify all blocks on a SCSI disk device and, optionally , repair any bad b locks, use the disk verify command. Syntax disk verify [/repair{=boolean}] [/wait{=boolean}] {scsi_device} P arameters {scsi_device} Specifies the ID for the SCSI disk device that you want to verify . A SCSI ID co nsists o f a SCSI chan n[...]

5-30 disk Com mands Examples The follow ing example syn chronously verif ies and repairs all blocks on disk (0,2,0) : AAC0>disk verify /repai r=TRUE /wait=TRUE (0,2,0) Executing: disk verify (CHANNEL=0,ID=2,LUN=0) As the command executes, note the title bar of the DOS window displays the status of the command. For example: Stat:OK!Task:100,Func:[...]

5-31 disk Com mands disk zero T o clear an entir e SCSI disk, use the disk zero comman d. When you clear a disk, all da ta is erased and cannot be recover ed. Command and Switch Av ailab ility This command is suppor ted on W indows. Syntax disk zero [/always{=boolean}] [/wait{=boolean}] {scsi_device} P arameters {scsi_device} Specif ies the ID for [...]

5-32 disk Com mands /wait{=boolean} Specifies whether to clear the disk synchr onously or asyn chr ono usly . If yo u set this sw itch to TRUE , the command clea rs th e disk sync hronously a nd the c omm and p rompt d oes not return until the clear disk ta sk compl etes. The default is FALSE; the command clears the disk asyn chrono usl y an d the [...]

6-1 6 diagnostic Commands In this Chapt er The diagnostic commands are use d to help fix problems that can occur during contr oller operation. The diagnostic commands should be used only under the dir ection of technical support. Use the follow ing syn tax for diagnostic comman ds: diagnostic command [/switch{=value}] [parameter] diagno stic clea r[...]

6-2 dia gnos tic Comman ds dia gnostic clea r boot_pa rameter s T o clear all boot-time parameters co ntained in the cu rr ently opened contr oller ’s parameters, use the diagnostic clear boot_parameters com mand. Unde r normal con ditions, no boot- time parameters are set. Caution: Use this command only under the direction of technical support. [...]

6-3 dia gnos tic Comman ds dia gnostic dump struct ures T o save internal data structures to a file for use by technical support, use the diagnostic dump structures com mand . Caution: Use this command only under the direction of technical support. Syntax diagnostic dump structures P arameters {string} Specifies the nam e of the file to contain the[...]

6-4 dia gnos tic Comman ds dia gnost ic du mp te xt T o display diagn ostic i nformation on the co nsole display for use by technical suppo rt during bug reporting, use the diagnostic dump text com man d. Caution: Use this command only under the direction of technical support. Notes Before using this command in DOS, verif y that the win dow is set [...]

6-5 dia gnos tic Comman ds Related Comm ands diagnostic commands: ■ diagnostic dump structures ( page 6-3 )[...]

6-6 dia gnos tic Comman ds dia gnost ic load _arra ys T o load arrays when the system is in maintenance mode, use the diagnostic load_arrays command. This command differ s fr om controller rescan in that it does not r e scan the SCSI channel. Caution: Use this command only under the direction of technical support. Syntax diagnostic load_arrays Exam[...]

6-7 dia gnos tic Comman ds dia gnost ic modera tion set count T o set the default interrupt coun t on the controller , use the diagnostic moderation set count comm and. Caution: Use this command only under the direction of technical support. Syntax diagnostic moderation set count {integer} P arameters {integer} Specifies the value (f or example, 70[...]

6-8 dia gnos tic Comman ds dia gnost ic modera tion set ti mer T o set the default interrupt timer on th e contro ller , use the diagnostic moderation set timer comm and. Caution: Use this command only under the direction of technical support. Syntax diagnostic moderation set timer {integer} P arameters {integer} Specifies the value (f o r example,[...]

6-9 dia gnos tic Comman ds dia gnostic modera tion sho w count T o display the number of outstanding I/Os necessary to allow the delay of I/O r equest responses to the host computer , use the diagnostic moderation show count co mmand. Y o u may have pr eviously specified the default interrupt count (the number of outsta nding I/ Os) wi th the diagn[...]

6-10 dia gnos tic Comman ds dia gnost ic modera tion sho w timer T o display th e time in 100 m icrosecond units that th e controller batche s I/O request response s before issu ing an interrupt to th e host computer , use the di agnostic moderation show timer command. Y ou may have previously specified the default interrupt timer (the time in 100 [...]

6-11 dia gnos tic Comman ds dia gnost ic se t boo t_para meter T o set boo t-time pa rameters that a technica l support r epresentative might need, use the diagnostic set boot_parameter command. Caution: Use this command only under the direction of technical support. Syntax diagnostic set boot_parameter P arameters {string} Specifies the name of th[...]

6-12 dia gnos tic Comman ds dia gnost ic sh ow boot_ paramete r T o display a specific boo t-time para meter (if one exists) that a technical support r epresentative might need, use the diagnostic show boot_paramter command. Caution: Use this command only under the direction of technical support. Syntax diagnostic show boot_parameter P arameters {s[...]

6-13 dia gnos tic Comman ds dia gnost ic sh ow history T o display an in ternal history log of operati ons kept in the curr ently opened controller that a technical support repr esentative might need, use the diagnostic show history co mmand. Syntax diagnostic show history [/old{=boolean}] [/current{=boolean}] Switches /old{=boolean} Specifie s whe[...]

7-1 7 logfile Commands In this Chapt er Use the follow ing syn tax for logfile comman ds: logfile command [/switch{=value}] [parameter] logfi le end 7-2 logfi le sta r t 7-3[...]

7-2 logfile Comm ands logfi le end T o end the logging o f all output, us e the logfile end comma nd. Syntax logfile end Examples The follow ing example sto ps log ging info rmation to the file aac0log17Nov01.txt (which was pr eviously started with the logfile start com man d ): AAC0> logfile end Executing: logfile end Log file closed. Related C[...]

7-3 logfile Comm ands logfi le star t T o begin the l ogging of all CLI com mand line a ctivity to a specif ied file, use the logfile start comman d. CLI command line act ivit y i nclu des the as soc iat ed o utp ut th e C LI comm and disp lay s. The CLI contin ues to log comm and outp ut unt il you clos e the CLI or you explicit ly end the logfil [...]

7-4 logfile Comm ands Related Comm ands logfile commands: ■ logfile end ( page 7-2 )[...]

8-1 8 task Commands In this Chapt er Use the follow ing syn tax for task comman ds: task command [/switch{=value}] [parameter] task l ist 8-2 task r e sume 8-8 task s top 8-10 task su spend 8-12[...]

8-2 task Com mands task list T o display a list o f one or all tasks runni ng on the currently opened contr oller , use the task list command. A task is an oper ation that occurs only on the controller , asyn chr onous to all other operations. Clearing a disk, creating a file system, an d cr eating a mirr or set ar e examples of tasks do ne on the [...]

8-3 task Com mands As the example shows, the typical display shows the following column s of in formatio n: ■ Ta s k I d ■ Functio n ■ Done% ■ Array ■ Stat e ■ Spe cific 1 ■ Spe cific 2 The following sections describe each column that the task list command di splays. The T ask ID Column The Ta s k I D column displays the ID number ass[...]

8-4 task Com mands NTFSfm t An arra y forma t NTFS file system task is runn ing on the specified ar ray . The format NTFS file system t ask run s as a res ult of u sing the array format comma nd with the / file_system sw itch se t to NTFS . Rebuild A rebu ild task is r unning o n the spec ified arra y . T ypically , the r ebuild task run s when the[...]

8-5 task Com mands The Done% Column The Done% co lumn display s a running per centage va lue that indicates the pr ogress of the curr ently running task. The display shows the per cen tage in tenths of a per cen t increm ents. The curr ently runn ing task is co mplete when the Done % co lu m n display s 10 0% . The Arra y Column The Arra y column d[...]

8-6 task Com mands The State Colu mn The Stat e Colu mn displ ays th e state of the task. Ta b l e 8 - 2 describes the state values that the task list command can display . The Speci fic1 Column The Specific1 column displays additiona l informatio n for certain tasks th at appear in t he Ta s k I d column. Ta b l e 8 - 3 lists t he task s for which[...]

8-7 task Com mands The Speci fic2 Column The Specific2 column displays additiona l informatio n for certain tasks th at appear in t he Ta s k I d column. Ta b l e 8 - 4 lists t he task s for which th e task list command ca n displ ay addition al informa tion. Ta b l e 8 - 4 also describes the a dditional info rmation that task list can display . T [...]

8-8 task Com mands task resume T o resume one or all tasks previously su spende d on the curr ently opened contr oller , use the task resume command. Y ou suspend tasks w ith t he t ask suspend command. Syntax task resume [/all{=boolean}] [{integer}] P arameters {integer} Specifies the ta sk ID for the task to r esume . Perform a task list /all to [...]

8-9 task Com mands Use the task list co mmand after using the task resume command to displ ay inf ormation a bout th e task , as i n the followi ng example: AAC0>task list Executing: task list TaskId Function Done% Array State Specific1 Specific2 ------ -------- ----- --------- ----- --------- --------- 101 Scrub 24.6% 0 RUN 00000000 00000000 As[...]

8-10 task Com mands task stop T o stop on e or all tasks running on th e curr ently o pened controller , use the task stop co mmand . Syntax task stop [/all{=boolean}] P arameters {integer} Specifies the ta sk ID for the task to stop. Perform a task list /all to d is pla y th e ta sk ID s for al l ta sks cu rr entl y running on the open con troller[...]

8-11 task Com mands Use the task list co mmand after using the task stop command to displ ay inf ormation a bout th e task , as i n the followi ng example: AAC0>task list Executing: task list No tasks currently runn ing on controller. Related Comm ands task commands: ■ task list ( page 8-2 )[...]

8-12 task Com mands task suspen d T o suspend one or all tasks running on the currently opened contr oller , use the task suspend command. Syntax task suspend [/all{=boolean}] P arameters {integer} Specifies the ta sk ID for the task to suspend. Perfo rm a ta sk list /all to d is pla y th e ta sk ID s for al l ta sks cu rr entl y running on the ope[...]

8-13 task Com mands Use the task list co mmand after using the task suspend command to displ ay inf ormation a bout th e task , as i n the followi ng example: AAC0>task list Executing: task list TaskId Function Done% Array State Specific1 Specific2 ------ -------- ------ --------- ---- --------- --------- 101 Scrub 24.6% 0 SUS 00000000 00000000 [...]

9-1 9 enclosur e Commands In this Chapt er These enclosure comman ds operate on enclosur e management devices tha t support V e rsion 1. 0 of the SCS I Accessed Fault- T o lerant Enclosures (SAF-TE) specificatio n. Use the follow ing syntax fo r enclosure comma nds: enclosure command [/switch{=value}] [parameter] enclosu re ac tivate slot 9-2 enclo[...]

9-2 enclosure Commands enc losure act iv ate slot T o activate a device in a s pecified slot of the specified S AF-TE enclosure management device, use the enclosure activate slot c omman d. S pec ific al ly , thi s co mman d mak es the devi ce th at r esides in the slot available on the SCSI ch annel. Syntax enclosure activate slot {enclosure} {slo[...]

9-3 enclosure Commands The follow ing example sho ws how to activa te a device in slot 0 of enclosure management device 0 using the enclosure acti vate sl ot command: AAC0>enclosure activate slot 0 0 Executing: enclosure ac tivate slot 0 0 Y ou m ay want to use the enclosure show slot command again to see the change in the device slot’s status[...]

9-4 enclosure Commands enc losure ide ntify slo t T o identify a slo t on a specified SA F-TE enclosure managemen t device, use the enclosure identify slot command. T y pically , an enclosure m anagement device indicates to the operator which slot is curr en tly being identified by flashing an adjacent light. Syntax enclosure identify slot {enclosu[...]

9-5 enclosure Commands Related Comm ands enclosure commands: ■ enclosure activate slot ( page 9 -2 ) ■ enclosure list ( page 9-6 ) ■ enclosure prepare slot ( page 9 -1 1 ) ■ enclosure show slot ( page 9 -32 )[...]

9-6 enclosure Commands enc losure li st T o display the list of co mponents a ssociated w ith on e or al l SA F-TE enclosure management devices connected to the controller , use the enclosure list command. Syntax enclosure list [/all{=boolean}] [/full{=boolean}] [{enclosure}] P arameters {enclosure} Specifies the ID as sociated with the enclosure m[...]

9-7 enclosure Commands Examples The follo wing exam ple show s a non -detailed list of compo nents fo r enclosure management devices 0 and 1 : AAC0>enclosure list /al l=TRUE Executing: enclosure li st /all=TRUE Enclosure Fan Power Slo t Sensor Door ScsiId Speaker Standa rd Diagnostic --------- - -- ----- ---- ------ ---- ------ ---- ---- -------[...]

9-8 enclosure Commands The Enc losure Column The Enclosure co lumn displays the ID of a specific enclosure management device. This is the ID that you specify for the enclosure parameter on the comm and line. In the example, the enclosure list command displays enclosure management device IDs 0 and 1 (because the /all sw itc h wa s spe ci fied ). The[...]

9-9 enclosure Commands The Door Column The Door co lumn displays the number of doors on the enclosure management device. T y pically , enclosure m anagement devices support a maximum of sixteen d oors. In the example, enclosur e manage ment d evices 0 and 1 each have five doors. The ScsiI d Column The ScsiId column displa ys the SCSI ch annel numbe[...]

9-10 enclosure Commands Specifically , the colu mn can di splay th e items l isted in Ta b l e 9 - 2 . T able 9-2 Diagnostic St atus The Enc losureId, V endorId, and Pr oductId Columns The Encl osure Id col umn displays an identificatio n number that is unique for each en closure m anagement device product sold by a particular manufa cturer . The V[...]

9-11 enclosure Commands enc losure pre pare slot T o indicate to the SAF-TE enclosure man ageme nt device that it should take the appr opriate action to pr epare the device in a specific slot for removal or insertio n, use the enclosure prepare slot command. T h i s c o m m a nd m ay pe r fo r m s u ch o pe r a t i o ns as s h u tt i n g o ff p o w[...]

9-12 enclosure Commands The following example pr epares the devic e in slot 0 on enclosur e manage ment d evice 0 for insertion or removal as a r es ult of using the enclosure prepare slot command: AAC0>enclosure prepare slot 0 0 Executing: enclosure pr epare slot 0 0 Y ou m ay want to use the enclosure show slot comman d again to see the change[...]

9-13 enclosure Commands enc losure set alar m T o turn the audible alarm on a specific SAF-TE enclosur e management device on or off , use the enclosure set alarm command. Syntax enclosure set alarm [/on{=boolean}] {enclosure} P arameters {enclosure} Specifies the ID as sociated with the enclosure management device whos e audible alarm you want t o[...]

9-14 enclosure Commands enc losure set door T o lock or unlock a specific door on a specif ic SAF-TE enclosure manage ment d evice, use the enclosure set door comm and. Syntax enclosure set door [/lock{=boolean}] {enclosure} {door} P arameters {enclosure} Specifies the ID as sociated with the enclosure management device on whi ch you want to lock t[...]

9-15 enclosure Commands enc losure set fan T o set the speed of a specific fan on a s pecific SAF-TE enclosur e manage ment d evice, use the enclosure set fan comm and. Syntax enclosure set fan [/off{=boolean}] {enclosure} {fan} [{speed}] P arameters {enclosure} Specifies the ID as sociated with the enclosure management device on which you want to [...]

9-16 enclosure Commands Switches /off{=boolean} Specifies wh ether to turn off the fan asso ciated with the specified unit num ber . If you set this sw itch to TRUE , the command turns o ff the fan associated wit h the specified unit number . Y ou mu st turn on th e fan if you wa nt to set its speed. Th is s wit ch defa ults to F ALSE , wh ich mea [...]

9-17 enclosure Commands enc losure set int erv al T o set the monitor reporting in terval for a specif ic SAF-TE enclosure management device, use the enclosure set interval command. The m onitor reporting in terval indica tes how often the controller checks the statu s of the enclosu re management device and its associated components. In setting th[...]

9-18 enclosure Commands The follow ing example sets the mon itor reporting interval for enclosure management devices 0 and 1 to 20 secon ds: AAC0>enclosure set inte rval 20 Executing: enclosure se t interval 20 Y ou m ay want to use the enclosure show status command again to see the change in the power supply’s status, as in the following exam[...]

9-19 enclosure Commands enc losure set po wer T o turn the power of a specific power supply on a specific SA F -TE enclosure management device on or off, use the enclosure set power command. T ypically , most enclosure m anagement devices turn on their associated power suppli es by default after power up. Syntax enclosure set power [/off{=boolean}][...]

9-20 enclosure Commands Examples Befor e turning a power supply on o r of f, you migh t want to use the enclosure show power command to determine the current setting for the power su pply or suppl ies. As the followi ng example show s, p ower su pply 0 on enc losure man ageme nt dev ice 1 is off and opera tiona l: AAC0>enclosure show pow er Exec[...]

9-21 enclosure Commands enc losure set scsiid T o set the SCSI de vice ID for a specific de vice slot on a specific SAF- TE enclosure management device, use the enclosure set scsiid command. A s discussed in other chapters , a SCSI ID consists of a SCSI channel number ( for example, 0, 1 , 2, 3, and so on), SCSI d evice ID (0 thro ugh 15 inclusive)[...]

9-22 enclosure Commands Examples Befor e se tting a device slot to a speci fic SCSI ID, y ou mi ght want to use the enclosure show slot command to determine the curr ent SCSI ID setting for the device slots, as in the following example: AAC0>enclosure show slo t Executing: enclosure sh ow slot Enclosure Slot scsiId Insert Status --------- ---- -[...]

9-23 enclosure Commands Related Comm ands controller commands: ■ controller pause_io ( page 4-12 ) enclosure commands: ■ enclosure list ( page 9-6 ) ■ enclosure show slot ( page 9 -32 )[...]

9-24 enclosure Commands enc losure set temper ature T o set the temperature thr eshold on a specific SAF-TE enclosur e manage ment d evice, use the enclosure set temperature command. T ypically , an enclosur e management device contains individual temp erature sens ors. W ith th is comm and, you can set a temperature thr eshold so th at the enclosu[...]

9-25 enclosure Commands Y ou m ay want to use the enclosure show temperature command again to see the ch ange in threshold temperatur e, as in the follow ing exam ple: AAC0>enclosure show tem perature 0 Executing: enclosure sh ow temperature 0 Enclosure Sensor Temper ature Threshold Status --------- ------ ------ ----- --------- -------- 0 0 70 [...]

9-26 enclosure Commands enc losure sho w fan T o display th e status of a specific fan on a specific S AF-TE enclosure management device, use the enclosure show fan command. Y ou can also use this command to display the status of all fans on the enclosur e management device or devices. Syntax enclosure show fan [{enclosure}] [{fan}] P arameters {en[...]

9-27 enclosure Commands As the example s hows, the fan status display contains the followi ng colum ns: ■ Enclosur e ■ Fan ■ Stat us The follow ing sectio ns describe the inf ormation that the enclosure show fan command can display in these colum ns. The Enc losure and Fa n Columns The Enclosure column displays the I D associated wit h the en[...]

9-28 enclosure Commands Related Comm ands enclosure commands: ■ enclosure list ( page 9-6 ) ■ enclosure set fan ( page 9-15 ) ■ enclosure show status ( page 9 -36 )[...]

9-29 enclosure Commands enc losure sho w power T o display the stat us of a specif ic power supply on a specific SAF- TE enclosure management device, use the enclosure show power command. Y ou can also use this comman d to display the status of all power su pplies on th e enclosure manag ement device or dev ices. Syntax enclosure show power [{enclo[...]

9-30 enclosure Commands As the example s hows, the power supply status display contains the follow ing column s: ■ Enclosur e ■ Power ■ Stat e ■ Stat us The follow ing sectio ns describe the inf ormation that the enclosure show power comman d can di splay in t hese columns. The Enc losure and P ower Columns The Enclosure co lumn displays th[...]

9-31 enclosure Commands Related Comm ands enclosure commands: ■ enclosure list ( page 9-6 ) ■ enclosure set power ( page 9 -19 ) ON BAD The power supply is on and not working pr operly . OFF BAD The power supply is off and not working pr operly . INST ALLED UNKN OWN The power supply is installed and its stat us is no t repor table or unknown. N[...]

9-32 enclosure Commands enc losure sho w slot T o display the stat us of a specif ic device slot on a specific SAF- TE enclosure management device, use the enclosure show slot command. Y ou can also use this command to display the status of all device slots on the en closure management device o r devices. Syntax enclosure show slot [{enclosure}] [{[...]

9-33 enclosure Commands Examples The foll owing example displays t he status of a ll de vice sl ots o n enclosure management devices 0 and 1 : AAC0>enclosure show slo t Executing: enclosure sh ow slot Enclosure Slot scsiId Insert Status --------- ---- ------ - ------ ----------------------------- ------ 0 0 0:00:0 4 OK 0 1 0:01:0 0 UNCONFIG 0 2 [...]

9-34 enclosure Commands The scs iId Column The scsiId column displays the S CSI ID associated with the device slot. A SCSI ID consists of a SCSI ch annel number (for example, 0, 1, 2, 3, etc.), SCSI device ID (0 thro ugh 15 inclusive), and SCSI device logical unit number (0 thr ough 7 inclusive). In the exam ple, the enclosure show slot comman d di[...]

9-35 enclosure Commands Related Comm ands enclosure commands: ■ enclosure list ( page 9-6 ) ■ enclosure set scsiid ( page 9 -21 ) UNCON FIG The d evice th at resid es in this slot is no t curr ently configured as a member of a device array or as a hot spare . HOT F AIL OV ER The dev ic e t hat reside s i n th is s lo t is c on fig ured as a hot[...]

9-36 enclosure Commands enc losure sho w status T o display the general status o f a specific SAF-TE enclos ure manage ment d evice, use the enclosure show status command. Y ou can also use this command to display the general status of all enclosur e m anagement devices connected to the controller . In addition to ge neral status in formation, this[...]

9-37 enclosure Commands Examples The follow ing example displa ys status in formatio n for enclos ure manage ment d evices 0 and 1 : AAC0>enclosure show sta tus Executing: enclosure sh ow status Enclosure UpTime D:H:M PowerCycle Interval Door Alarm --------- ------------- - ---------- -------- -------- ----- -- 0 0:04:2 5 2 20 UNLOCKED OFF Enclo[...]

9-38 enclosure Commands The general statu s of an enclo sure management de vice is encapsulated in the following columns: ■ Enclosur e ■ UpT ime D:H:M ■ PowerCycle ■ Interval ■ Door ■ Alar m The follow ing sectio ns describe the inf ormation that the enclosure show status comm and can dis play in t hese column s. For inform ation abo ut[...]

9-39 enclosure Commands The Interv al Column The Interva l colu mn displa ys the mo nitor int erval. Y ou can s et the moni tor interval w ith the enclosure set interval command. In the example, the monitor interval r eporting level for both enclosure managem ent devices is 20 se cond s. The Door and Ala rm Columns The Door co lumn displays the sta[...]

9-40 enclosure Commands ■ enclosure show power ( page 9 -29 ) ■ enclosure show slot ( page 9 -32 ) ■ enclosure show temperature ( page 9 -41 )[...]

9-41 enclosure Commands enc losure sho w temperatur e T o display the temperature status of a s pecific temperature sensor on a specific SAF-TE enclosur e management device, use the enclosure show temperature command . Y ou can also use this command to display the te mperature status of all temperature sensors on the enclosur e management device or[...]

9-42 enclosure Commands As the example s hows, the temperature sen sor status display contains the followi ng colum ns: ■ Enclosur e ■ Sens or ■ Te m p e r a t u r e ■ Threshold ■ Stat us The follow ing sectio ns describe the inf ormation that the enclosure show temperature command can dis play in these columns. The Enc losure Column The [...]

9-43 enclosure Commands The Thresh old Column The Thr esho ld col umn di splays the temperat ure at which an alarm will be soun ded if the temperature goes above th e thre shold. In th e example, the temperature thr es hold is 120 degr ees Fahr en heit. Y ou can change the tempera ture threshold by usin g the enclosure set temperature command. The [...]

A-1 A Automated Scripts This append ix describes how to write DOS bat ch files a nd CLI command scri pts to perform the controller details task. Y ou can use the CLI commands alone in CLI command scripts or in combin ation with DOS com mand s in DOS bat ch files. A lso, you can invoke CL I command s cripts in a DO S batch file. Y ou sh ould alread [...]

R Ad a p t e c , I n c . 691 South Milpitas Bou levard Milpitas, CA 95035 USA ©2000 – 2004 Adaptec, Inc. All rights reserved. Adaptec and the Adaptec logo are tr ademark s of Adap tec, Inc. wh ich m ay be regist ered in some jurisdic tions. Part Number: 513852-06, Ver. AA 03/04[...]