AdaptecメーカーAAR-21610SAの使用説明書/サービス説明書
ページ先へ移動 of 278
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.
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 Acces.
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 cr.
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 contain.
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 s.
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 .
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 .
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 om.
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 .
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.
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 comman.
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.
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.
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.
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.
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).
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 ).
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.
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 .
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.
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).
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}] [paramet.
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.
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 .
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 .
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.
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.
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.
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-.
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 .
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.
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>con.
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.
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.
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&.
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.
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.
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.
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.
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.
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 .
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).
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: .
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 .
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 .
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.
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).
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 .
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 .
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 .
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 .
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.
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.
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 .
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.
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 lis.
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.
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.
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).
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.
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>containe.
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 sho.
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.
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).
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 ) ■ conta.
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.
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 .
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.
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.
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 .
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 c.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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).
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%.
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.
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.
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 e.
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.
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.
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 .
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.
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.
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.
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 t.
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 .
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,.
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.
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.
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.
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 .
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 .
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.
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 .
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.
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.
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}.
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 infor.
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 .
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 a.
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}.
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 infor.
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.
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: containe.
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.
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.
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 ) ■ contain.
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 .
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 .
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.
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 .
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) .
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.
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) .
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 .
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: .
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 .
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.
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.
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.
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.
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 .
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.
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 ble.
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 .
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.
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.
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.
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.
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 exa.
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.
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.
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- 1.
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.
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 .
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.
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 .
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.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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 .
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 .
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.
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 .
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.
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.
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 .
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.
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.
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.
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.
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 lis.
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 .
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.
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 ) ■ d.
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.
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 .
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 .
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 .
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.
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.
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.
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.
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.
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.
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 .
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 .
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% .
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.
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.
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 .
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.
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.
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.
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.
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.
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.
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.
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.
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.
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 slo.
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.
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.
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 ).
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.
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 .
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.
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: AA.
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.
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.
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.
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.
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.
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 .
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.
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.
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.
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.
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.
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 perat.
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.
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.
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.
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.
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.
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.
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 s.
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).
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 .
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 .
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 En.
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.
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.
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 .
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.
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.
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.
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.
デバイスAdaptec AAR-21610SAの購入後に（又は購入する前であっても）重要なポイントは、説明書をよく読むことです。その単純な理由はいくつかあります：
Adaptec AAR-21610SAをまだ購入していないなら、この製品の基本情報を理解する良い機会です。まずは上にある説明書の最初のページをご覧ください。そこにはAdaptec AAR-21610SAの技術情報の概要が記載されているはずです。デバイスがあなたのニーズを満たすかどうかは、ここで確認しましょう。Adaptec AAR-21610SAの取扱説明書の次のページをよく読むことにより、製品の全機能やその取り扱いに関する情報を知ることができます。Adaptec AAR-21610SAで得られた情報は、きっとあなたの購入の決断を手助けしてくれることでしょう。
Adaptec AAR-21610SAを既にお持ちだが、まだ読んでいない場合は、上記の理由によりそれを行うべきです。そうすることにより機能を適切に使用しているか、又はAdaptec AAR-21610SAの不適切な取り扱いによりその寿命を短くする危険を犯していないかどうかを知ることができます。
ですが、ユーザガイドが果たす重要な役割の一つは、Adaptec AAR-21610SAに関する問題の解決を支援することです。そこにはほとんどの場合、トラブルシューティング、すなわちAdaptec AAR-21610SAデバイスで最もよく起こりうる故障・不良とそれらの対処法についてのアドバイスを見つけることができるはずです。たとえ問題を解決できなかった場合でも、説明書にはカスタマー・サービスセンター又は最寄りのサービスセンターへの問い合わせ先等、次の対処法についての指示があるはずです。
