Adaptec RAID 2230SLP manual

C OMMAND L INE U TIL ITY U SER ’ S G UIDE[...]

[...]

● 2 Copyright ©2005 A daptec, Inc. All rights reser ved. N o part of this publication may be repr oduc ed, stored in a retrieval system, or tr ansmitted in an y form or by any means, electronic, mechan ical, photoc opying, recor ding or othe rw ise, w ithout the prior wr itten c onsent of A daptec, Inc ., 691 South Milpitas Blv d., Milpitas, CA [...]

● 3 Software License Agreement PLEASE READ CAREFULL Y : THE USE OF THIS SOFTW ARE IS SUBJECT T O THE SOFTW ARE LICENSE TERMS OF AD APTEC, INC. AND O THER LICENSORS WHOSE SOFTW ARE MA Y BE BUNDLED WITH THIS PRODUCT . BY Y OUR USE OF THE SOFT W ARE INCL UDED WITH THIS PRODUCT Y O U A GREE T O THE LICENSE TERMS REQUIRED BY THE LICENSOR OF THA T SOFT[...]

● 4 Confide ntiality . Y ou agree to maintain th e Softwar e in c onfidenc e and that y ou will not disclose the Software to an y thir d part y without the express w ritten consent of A daptec. Y ou furt her agree to tak e all reasonable pr ecautions to preclu de access of unau thorized persons to the Software. T erm. This lice nse is effectiv e [...]

● 5 Export. Y ou acknowledge that the la ws and regulations of the U nited States and other coun tr ies m ay restric t the exp or t and re-ex por t of the Software. Y ou ag ree that you will not expor t or re-export the Software or documentation in any form in violation of applicabl e U nited States and for eign law . Gov ernment R estricted Righ[...]

Contents Getting Started with the Command Line Utility Installing the Command Line Utility ........... ............ ........... ...... 8 Installing on Windows ......... ........... ........... ........... ............ ... 8 Installing on Linux .......... ........... ............ ........... ........... ......... 8 Installing on NetWare .......... .[...]

1 Getting Star ted with the Command Line Utility In this chapter ... Installing the Command Line U tility .................... .............................. 8 Star ting the Command Line U tility ...................... .............................. 9 This chapte r explains ho w your A daptec product suppor ts the use of one of these command line u[...]

Getting Star ted with the Command Line Utility ● 8 Installing the Command Line Utility Both command line u tilities are pr ovided on the A daptec Storage M anager CD . The utilit y ( ARCCONF or HRCONF ) is aut omatically installed in the same directory as Adapt ec Storage M anager and must rem ai n th ere . Installing on Windows To i n s t a l l [...]

Getting Star ted with the Command Line Utility ● 9 Installing on NetW are To i n s t a l l ARCCONF or HRCONF on N etW are: Y ou need the latest Support P ack fo r y our operating system so y ou can run the suppor ted J a va V irtual Machine ( JVM). Y ou need JVM version 1.3 or later . T o check y our JVM v ersion, load JVM, t y pe JAVA - VERSION [...]

2 Using the Command Line Utility In this chapter ... AR CCONF Commands ...................... ............................................... 11 HR CONF Commands ....................................................................... 27 This chapte r explains ho w to use the c ommand line utility interactively or in batc h mode. W ith interactiv e [...]

Using the Command Line Utility ● 11 ARCCONF Commands P erform the following functions from the c ommand line: Command arcconf copyback Wh a t i t d o e s T oggles the controller c opyback featur e, which att empts to k eep driv es in the or ig inal slot order after rebuil ds. Enables or disables the cop yback featu re. Sy n t ax arcconf copyback [...]

Using the Command Line Utility ● 12 Command arcconf create Wh a t i t d o e s Cr eates a new logical driv e. Y ou must pr ovide the channel and device ID of the ph ysical drives. On redundant logic al drives, ARCCONF performs autosynchr onization. Sy n t ax arcconf create CREATE <Co ntroller#> LOGICALDRIVE [Options] <Si ze> <RAID#&[...]

Using the Command Line Utility ● 13 RVOLUME: RAID Lev el for a RAID volume logical drive. LD#: Logical drive n umbers for the 2 or more logical drives t o be co ncatenat ed into the RAID v olume. CHANNEL# DRIVE#: List of space- delimited c hannel number and dev ice number pai rs for each de vi ce t o add to the log ical dr ive. noprompt: N o prom[...]

Using the Command Line Utility ● 14 Re t u r n v a l u e s SUCCESS: 0x00 suc cessful t ermination FAILURE: 0x01 bad arguments or int ernal error Command arcconf driverupdate Wh a t i t d o e s U pdates W indow s dev ice driv ers. A utomatically updat es a W indows driver t o the v ersion found in the given dir ector y . Note: A v ailable on W ind[...]

Using the Command Line Utility ● 15 Command arcconf getconfig Wh a t i t d o e s Lists information about the contr ollers, logical driv es, and ph ysical driv es. This information can incl ude (but is not limit ed to) the follo wing items: ● Cont rol le r t y pe ● BIOS, boot block, device drive r , and firm war e ve rsions ● Logical dr iv e[...]

Using the Command Line Utility ● 16 Command arcconf getlogs Wh a t i t d o e s Obtains contr oller log information. P ro vides access t o the status and ev ent logs of a co ntroller . Y ou can retrieve four different ty p es of logs: ● DEVICE : Lists an y de v ice errors the c ontroller has encount er ed. ● DEAD : R ec or ds an y occurre nces[...]

Using the Command Line Utility ● 17 Command arcconf getstatus Wh a t i t d o e s The GETSTATUS function displa ys the stat us of an y background command that is curr ently running. Display s information about the most rece nt rebuild, synchr onization, logical-driv e migration, and co mpac tion/expansion. The information includes the ty p e of op[...]

Using the Command Line Utility ● 18 Command arcconf getversion What it does Lists ver sion informatio n for all c ontroller s or a specific co ntroller’ s softwar e c omponents, inc luding in formation about the BIOS, dr iv er , firm war e currently running, and firmwar e that will run after a reboot. Note: The firm war e v ersion that will run[...]

Using the Command Line Utility ● 19 Pa r a m e t e r s Controller# is the contro ller number Example arcconf rescan 1 Re t u r n v a l u e s SUCCESS: 0x00 ind ic a tes th e com ma nd com p le te d s ucce s sf ul l y FAILURE: 0x01 indica tes the comm and failed Command arcconf romupdate Wh a t i t d o e s Al l ows n ew f ir mwa re a nd B IO S to b[...]

Using the Command Line Utility ● 20 Re t u r n v a l u e s SUCCESS: 0x00 ind ic a tes th e com ma nd com p le te d s ucce s sf ul l y FAILURE: 0x01 indica tes the comm and failed Command arcconf setalarm Wh a t i t d o e s Sets the state of the contr oller audible alarm, if pr esent. Sy n t ax arcconf setalarm <Control ler#> <on|off|sile[...]

Using the Command Line Utility ● 21 Sy n t ax arcconf setcache <Controll er#> DEVICE <Channel> <ID> <options> Pa r a m e t e r s Controller# is the controller nu mber LogicalDrive# is the numbe r of the logical dr iv e whose cache will be alte red ● Log ical dr iv e options: ● ron : R ead cache enabled ● roff: R ead [...]

Using the Command Line Utility ● 22 arcconf setconfig <Contro ller#> DEFAULT [noprompt] Pa r a m e t e r s Controller# is the controller nu mber Default: R esets the contr oller's c onfiguration. Logical dr iv es are de le te d, ha rd dr ive s are res e t to t he rea dy st a te, a nd any co nt ro ll e r settings are r eset to default v[...]

Using the Command Line Utility ● 23 FAILURE: 0x01 indica tes the command failed[...]

Using the Command Line Utility ● 24 Command arcconf setstate Wh a t i t d o e s R edefine the state of a ph ysical dev ice fr om its current state t o the designated state (H otspar e). Sy n t ax arcconf setstate <Control ler#> <Channel#> <Device#> <State> [LOGICALDRIVE <LD#>[LD#] ... ] Pa r a m e t e r s Controller#[...]

Using the Command Line Utility ● 25 Sy n t ax arcconf snapshot SNAPSHOT <Controller#> <COMMAND> ... [noprompt] Pa r a m e t e r s Controller# is the controller nu mber Commands: ● map: Displa y logical dr iv es and an y snapshot state. ● stop <Logicaldrive#>: R emov e the snapshot associated w ith the g iv en Log ical dr ive[...]

Using the Command Line Utility ● 26 Sy n t ax arcconf task TASK START <Controller#> LOGICALDRIVE <LogicalDrive#> <options> [noprompt] TASK STOP <Controller#> LOGICALDRIVE <LogicalDrive#> TASK START <Controller#> DEVICE <Channel> <ID> <options>[noprompt] TASK STOP <Controller#> DEVICE <[...]

Using the Command Line Utility ● 27 HRCONF Commands P erform the following functions from the c ommand line: Command hrconf Backup Wh a t i t d o e s F or large-scale deployments, st ores the current c ontr oller and disk drive configuration setting to a specific fi le. Stor ed files can be used w ith the RESTORE c ommand to r estore t o another [...]

Using the Command Line Utility ● 28 Command hrconf create Wh a t i t d o e s Cr eates logical drives. Y ou m ust pro vide the channel and dev ice ID of the ph ysical drive s. On redundant logical drives, HR CONF p erforms autosynchronization. Sy n t ax hrconf create <Controller #> LOGICALDRIVE [Options] <Size> <RAID#> <CHANNE[...]

Using the Command Line Utility ● 29 Re t u r n v a l u e s SUCCESS: 0x00 suc cessful t ermination FAILURE: 0x00 bad arguments or int ernal error Command hrconf delete Wh a t i t d o e s Deletes a logical dr iv e. All data stored on the logical drive will be lost. Spanned driv es can ’ t be delet ed with this function. Sy n t ax hrconf delete &l[...]

Using the Command Line Utility ● 30 ● Cont rol le r t y pe ● BIOS, boot block, device drive r , and firm war e ve rsions ● Logical dr iv e status, RAID level, and size ● Ph ysical driv e ty p e, dev ice ID , pr esence of PF A ● Ph ysical driv e state Sy n t ax hrconf getconfig <Control ler#> [AD/LD/PD/AL] Pa r a m e t e r s Contro[...]

Using the Command Line Utility ● 31 Example hrconf getstatus 1 Re t u r n v a l u e s SUCCESS: 0x00 suc cessful t ermination FAILURE: 0x01 bad arguments or int ernal error Command hrconf getversion Wh a t i t d o e s R eturns the version inf ormation for all c ontrollers. Sy n t ax hrconf getversion Pa r a m e t e r s n/a Example hrconf getversio[...]

Using the Command Line Utility ● 32 Pa r a m e t e r s Controller# is the controller nu mber Example hrconf rescan 1 Re t u r n v a l u e s SUCCESS: 0x00 indica tes the comm and co mpleted FAILURE: 0x01 indica tes the comm and failed Command hrconf restore Wh a t i t d o e s R est ores the c ontr oller c onfiguration b y import ing it ’ s co nf[...]

Using the Command Line Utility ● 33 BAD_PATH: 0xFF indicat es that the path pro vided is incorrect FAILURE: 0xFE indicat es an erro r occurred writing the configuration file Command hrconf romupdate Wh a t i t d o e s U pdat es the contr oller or enc losure firm war e. The R OM image file must be in the same dir ectory pr ior to in voking hrconf [...]

Using the Command Line Utility ● 34 Pa r a m e t e r s Controller# is the controller nu mber Default: R esets the contr oller's c onfiguration. Logical dr iv es are de le te d, ha rd dr ive s are res e t to t he rea dy st a te, a nd any co nt ro ll e r settings are r eset to default values. noprompt: N o prompt for confirmation. Example hrco[...]

Using the Command Line Utility ● 35 Example hrconf setstate 1 0 1 HSP hrconf setstate 1 0 2 RDY hrconf setstate 1 0 2 RBL Re t u r n v a l u e s SUCCESS: 0x00 ind ic a tes th e com ma nd com p le te d s ucce s sf ul l y FAILURE: 0x01 indica tes the comm and failed[...]

[...]

A daptec, Inc. 691 South Milpitas Boulevard Milpitas, CA 95035 USA ©2005 Adaptec, Inc. All rights reserved. Adaptec and the Adaptec logo are trademarks of Adap tec, Inc. which may be registered in some jurisd ictions. Part Number: CDP-00092-01-A, Rev. A JB 09/05[...]