Instruction/ maintenance manual of the product 601354 ADIC
Go to page of 196
Administrative T asks V olServ V ersion 5.0 September 2001 601354 Rev A.
Trademark Notice AMASS, DataMgr, EMASS, File Serv, and VolServ are either trademarks or registered trademarks of ADIC, Advanced Digital Info rmation Corporation. DAS is a trademark of Grau, an ADIC subsidiary. All other product na mes and identifications are trademarks or registered trademarks of their respective manufacturers.
ADIC includes this Form in an effort to pr ovide the best possible documentation to our customers. Please take a few moments to mail or FAX your response to: ADIC Software Documentation 10949 East Peakview Ave. Englewood, CO 80111 FAX: 303-792-2465 E-mail: techdocs@adic.
NOTES.
601354 Rev A i Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administ rative Task s ii Contents 601354 Rev A Process Server Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 VolServ Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administrative Tasks 601354 Rev A Contents iii Auto Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Configure a Manual Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administ rative Task s iv Contents 601354 Rev A Archive Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Configure/ Reconfigure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . .
Administrative Tasks 601354 Rev A Contents v Remove Media from an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 Clear Eject List Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Administ rative Task s vi Contents 601354 Rev A Archive Operations 5 Automated Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
Preface P Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . P-3 Conventions . . . . . . . . . . . . .
Administrative T asks P-2 Preface 601354 Re v A NO TES.
Administrative T asks 601354 Rev A Preface P-3 Preface Purpose of This Book This book describes the management tasks used to operate Vo l S e r v . Who Should Read This Book This book is written for the sy stem administrator who is operating and troubleshooting V olServ .
Administrative T asks P-4 Preface 601354 Re v A Chapter 6: T r oubleshoot — Troubleshooting tips for VolServ software problems. Con ventions The con ventions used throughout the V olServ technical books are listed belo w: Con vention Example Screen te xt, file names, pr og ram names, and commands are in Cou rier f ont.
Administrative T asks 601354 Rev A Preface P-5 Preface Books The books described belo w ar e part of the technical documentation set, and are shipped on CD along with the V olServ software: Online Books The documentation CD contains V olServ book fi les and Adobe ® Acrobat ® Reader .
Administrative T asks P-6 Preface 601354 Re v A Related Publications The publications described in th e table belo w are created and distributed on an as-needed basis. Contact Publications Depart ment T o mak e corrections or to comment on V olServ publications, please contact Software T echnical Publications at our e-mail address: techdocs@adic.
Getting Started 1 Getting Star ted Command Access . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 CLI and API Access Control . . . . . . . . . . . . . . 1-3 GUI Access Control . . . . . . . . . . . . . . . . . . . . . 1-6 Environment Management .
Administrative Tasks 1-2 Getting Started 601354 Re v A Roadmap T opic Refer T o Chapter General softw are access inf or mation 1 Hardwa re and soft ware sta r t-up 2 Site-specific configu r ation of a.
Administrative Tasks 601354 Rev A Getting Started 1-3 Getting Started Command Access After V olServ is installed, the V olServ System Administrator (SA) configures the V olServ en vironment to control Command Line Interface (CLI), Applicat ion Program Interface (API), and Graphical User Interface (GUI) access to the V olServ system.
Administrative Tasks 1-4 Getting Started 601354 Re v A The commands av ailable to a client application are sho wn in the follo wing table. Capability Description Media Operations Impor t Media Inser ts media into th e system and update the V olSer v database with the ne w media identifiers .
Administrative Tasks 601354 Rev A Getting Started 1-5 Getting Started V ar y Drive Changes the stat e of the archiv e from On-Line , Off-Line, Diagnostic, or On-Line/Clear . Cancel Request Cancels request s base d on request identifier . Reprioritize Request Change s the priority le vel of a r e quest.
Administrative Tasks 1-6 Getting Started 601354 Re v A The client applicati on permissions can be changed at any time. T o mak e the changes ef fective, V olServ must be cycled. GUI Access Contr ol The commands a v ailable via the GUI are controlled by the operator.
Administrative Tasks 601354 Rev A Getting Started 1-7 Getting Started Separate access for the SA and SO is maintained through the use of group permissions. If the SO ’ s user ID is defined in the vsadmin group, the SO will ha ve GU I access to the commands def ined by the SA in the operator.
Administrative Tasks 1-8 Getting Started 601354 Re v A Dismount Media Dismounts a medium from a drive . XX Modify Media Allo ws the addition of media statistics , manuf acturer , and batch inf or mation to be associated with a medium or media. XX Mov e Media Mov e s media from one archive to another .
Administrative Tasks 601354 Rev A Getting Started 1-9 Getting Started Configure Configure Archiv e Adds an archiv e to the V olServ system. X Create Drive Adds a drive to the V olServ system. X Associate Dr iv e Associate s a dr ive with an archiv e. X Disassociate Dr ive Disassociates a dr ive from an archiv e.
Administrative Tasks 1-10 Getting Started 601354 Re v A Delete Archiv e Media Class Removes an archiv e Me d i a Class from the V olSer v system. X Define Media T ype Defines a media ty pe to be used within the V olServ system. XX Define Label Pa t t e r n Adds a label patte r n to th e V olSer v system.
Administrative Tasks 601354 Rev A Getting Started 1-11 Getting Started Query Media T yp e Repor t showin g the attributes of one or more medi a types. XX Quer y Request Repor t showing inf or mation about a specified request . XX Query Connect Repor t sho wing enterpr ise connection inf or mation.
Administrative Tasks 1-12 Getting Started 601354 Re v A En vironment Management V olServ uses global variables that help def ine the system en vironment. These v ariables are located in the *.config f iles located in the $VS_DIR/config directory . The VS_DIR en vironment variable contains V olServ home directory and is def ined during installation.
Administrative Tasks 601354 Rev A Getting Started 1-13 Getting Started T o c ycle V olServ , use volserv -t ; for information, see “Gracefully T erminate V olServ” on page 2-9 . Also use the volserv command; for information , see “Start Up V olServ” on page 2-3 .
Administrative Tasks 1-14 Getting Started 601354 Re v A W orkstation entries in this f ile are accessible when using the Change Archi ve Parameters command.
Administrative Tasks 601354 Rev A Getting Started 1-15 Getting Started Software Pr otection The software protection v ariable s contained in the follow ing tables allo w V olServ and associated archi ves to operate. These v ariables should not be modified unless directed by ADIC T echnical Assistance Center (A T A C) personnel.
Administrative Tasks 1-16 Getting Started 601354 Re v A System Logging The follo wing table illustrates the variables that can be modif ied, as required, to choo se logging le vels for each site. V olServ must be cycled for the changes to become ef fectiv e.
Administrative Tasks 601354 Rev A Getting Started 1-17 Getting Started Configuration En vir onment The following table illustrates the v ariables that can be modif ied, as required, to delete archiv es. V olServ must be cycled for the changes to become ef fecti ve.
Administrative Tasks 1-18 Getting Started 601354 Re v A Library Defaults The query process v ariables sh ow n belo w can be modified, as required. These v ariables should not be modified unless directed by A T A C personnel. V olServ must be cycled for the changes to become ef fectiv e.
Administrative Tasks 601354 Rev A Getting Started 1-19 Getting Started Ar chive Dispatcher The follo wing table lists the variables that can be modif ied, as required, to modify archi ve communication times. V olServ must be cycled for the ch anges to become ef fectiv e.
Administrative Tasks 1-20 Getting Started 601354 Re v A GUI En vir onment The GUI en vironment variables in the follo w ing table can be modif ied, as required, to def ine specif ic GUI parameters. These v ariables should not be modified unless directed by A T A C personnel.
Administrative Tasks 601354 Rev A Getting Started 1-21 Getting Started Pr ocess Server Defaults The follo wing table shows the v ari ables that can be modif ied, as required, to change the software communications. V olServ must be cycled for the changes to become ef fecti ve.
Administrative Tasks 1-22 Getting Started 601354 Re v A CiRepl y En vir onment The following table s hows the v ari ables that can be modif ied, as required, to change the time ass ociated client, status, and RPC commands. These v ariables s hould not be modified unless directed by A T A C personnel.
Administrative Tasks 601354 Rev A Getting Started 1-23 Getting Started Ar chive Defaults This table sho ws the variables associated with each type of archi ve supported b y V olServ . Only those variables associated with the site’ s archiv e configuration should be modif i ed.
Administrative Tasks 1-24 Getting Started 601354 Re v A Configuration Logging The follo wing table sho ws the v ari ables that can be modified as required for debugg ing software interfaces. T o enable these v ariables, remove th e comment line indicators from the applicable v ariable.
Administrative Tasks 601354 Rev A Getting Started 1-25 Getting Started Installation This table sho ws the system variab les that are to be established at the time of the system installa tion.
Administrative Tasks 1-26 Getting Started 601354 Re v A V ariable Name Default Description TCPIP_CONNECT_WAIT_TIME 1 Number o f times to tr y to conne ct to a socket over TC P/I P . TCPIP_CONNECT_RETRIES 5 Amount of time in seco nd s to wait between retr ies to connect to a sock et over TCP/IP .
Administrative Tasks 601354 Rev A Getting Started 1-27 Getting Started printers.confi g Files The label_printers.conf ig file located in the $VS_DIR/c onfig directory is used as a reference f ile for the label printers in the V olServ system. The printer na me and type of printer are entered in this f ile; e.
Administrative Tasks 1-28 Getting Started 601354 Re v A NO TES.
Start-up and Shutdown 2 Star t-up and Shutdo wn Start-Up Equipment . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Start-Up VolServ . . . . . . . . . . . . . . . . . . . . . . . 2-3 Start the System Console . . . . . . . . . . . . . . . . . 2-5 Recovery Processing .
Adiministrative T asks 2-2 Start-up and Shutdo wn 601354 Re v A Roadmap T opic Refer T o Chapter General software inst allation inf or mation 1 Hardwa re and soft ware sta r t-up 2 Site-specific configu r ation of archive s/ driv e.
Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-3 Start-up and Shutdown Star t-U p Equipment This chapter contains information to power -up the hardware components of a V olServ sy stem and information and procedures to start-up and shutdo wn V olServ .
Adiministrative T asks 2-4 Start-up and Shutdo wn 601354 Re v A The volserv command starts VolServ in the multiuser mode. Client interface commands are accepted after initialization completes. Commands received prior to initialization completion are failed and the error, ERR_SOFTWARE_NOT_READY , is returned.
Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-5 Start-up and Shutdown After an archi ve is conf igured, its archi ve Console displays at the location specified during the conf iguration process. If no archi ves are conf igured, no archi ve Console is displayed.
Adiministrative T asks 2-6 Start-up and Shutdo wn 601354 Re v A Or , use the -d option of the vswin command to display the Volume Server System console on a workstation other than that identified by t.
Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-7 Start-up and Shutdown Shutdown Software This section provides the prope r sequence of procedures to perform when all or part of the so ftware and equipment is to be shutdo wn.
Adiministrative T asks 2-8 Start-up and Shutdo wn 601354 Re v A Step 2. A Questio n box appears that c ontains the question “ OK to exit vswin? ”. . Step 3. Click the OK b utton in the Question box. The Question box and the V olume Server System console windo ws close.
Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-9 Start-up and Shutdown Make sure that an archi ve is not being reconf igured before an attempt is made to bring do wn V olServ . V olServ aborts a termination request if an ar chi ve is being reconfigured.
Adiministrative T asks 2-10 Start-up and Shutdo wn 601354 Re v A Step 4. Enter y to continue with shutdown. The V olume Server SysLog Console and each archive Console disappear from the terminals on which they are displayed. Step 5. Logout as vsadm . VolServ Version 5.
Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-11 Start-up and Shutdown NO TES.
Adiministrative T asks 2-12 Start-up and Shutdo wn 601354 Re v A NO TES.
Initial Configuration 3 Initial Configuration Configure an Archive . . . . . . . . . . . . . . . . . . . . . . 3-3 Configure an Automated Archive . . . . . . . . . 3-4 Auto Check-in . . . . . . . . . . . . . . . . . . . . . . . . . 3-10 Auto Import . .
Administrative T asks 3-2 Initial Configuration 601354 Re v A Roadmap T opic Refer T o Chapter General software inst allation inf or mation 1 Hardwa re and soft w are star t-up 2 Site-specific configu.
Administrative T asks 601354 Rev A Initial Configuration 3-3 Initial Configuration Configure an Ar chive A V olServ system includes V olServ , archi ves, driv es, and media. After V olServ is installe d, the site-specific conf iguration of archi ves, dri ves, and media must be input into V olServ before normal V olServ operations can begin.
Administrative T asks 3-4 Initial Configuration 601354 Re v A Automated archi ves supported b y V olServ include the DataT o wer archiv e; the StorageT ek A CS archiv e; the AML/2, AML/E, and AML/J archi ve; and the ADIC Scalar 100, Scalar 1000, and Scalar 10K archi ves.
Administrative T asks 601354 Rev A Initial Configuration 3-5 Initial Configuration Archiv e Console Displa y Host This parameter determines where the archiv e Cons ole displays.
Administrative T asks 3-6 Initial Configuration 601354 Re v A The Move Media and Mount Media associated commands provide an o verride parameter that allo ws the user to prev ent the failing of the command when the Archi v e Mode unattended option is selected.
Administrative T asks 601354 Rev A Initial Configuration 3-7 Initial Configuration None When the action mode none option is specif ied, V olServ initiates no automatic action when the number of media of the specif ied media type reaches the calculated high mark threshold.
Administrative T asks 3-8 Initial Configuration 601354 Re v A The selection of media for mi gration is dependent on both Media Classes and media types. Refer to V o lServ: Introduction, 60023A for additional information on media class migration. Also refer to Media T ype Migration on page 3-29.
Administrative T asks 601354 Rev A Initial Configuration 3-9 Initial Configuration High Mark The high mark parameter is a user-specif ied percentage. V olServ software applies the high mark percentage to the archi ve media-type capacity to calculate a medi a-type specif ic high mark threshold.
Administrative T asks 3-10 Initial Configuration 601354 Re v A A u to Check-in During Au di t An archiv e audit is executed to synchronize the information in the V olServ database with the actual media contents of a specif ied archi ve.
Administrative T asks 601354 Rev A Initial Configuration 3-11 Initial Configuration • If the auto check-in option is enabled, checked-out media are automatically checked in to the V olServ system. The automatically checked-in media remain in the Media Class to which they were associated when the y were checked-out.
Administrative T asks 3-12 Initial Configuration 601354 Re v A A uto Impor t During either an archiv e audit, uns olicited media enter , or enter operation, the V olServ system may detect the phys ical presence of media that are unkno wn to the V olServ system.
Administrative T asks 601354 Rev A Initial Configuration 3-13 Initial Configuration • If the auto impo rt option is enabled, V olServ automatically enters intransit media (refer to the glossary).
Administrative T asks 3-14 Initial Configuration 601354 Re v A • If the auto import op tion is not enabled, V olServ leav es the unkno wn media in the load port. When an intransit medium (due to an incomplete mount command) is imported or entered, V olServ software attempts to complete the mount.
Administrative T asks 601354 Rev A Initial Configuration 3-15 Initial Configuration - moves the subject media into the archi ve and places them on the eject list (AML/E, AML/2, AML/J, or StorageT ek A.
Administrative T asks 3-16 Initial Configuration 601354 Re v A Shelves within a DataShelf arch i ve are numb ered within Ro w . For e xample, if a DataShelf archiv e has three rows with four shelves p.
Administrative T asks 601354 Rev A Initial Configuration 3-17 Initial Configuration DataShelf archi ve capacity is a calculated v alue based on the number of shelves conf igured. A uto Check-in The auto check-in functionality is not supported for manual archi ves.
Administrative T asks 3-18 Initial Configuration 601354 Re v A Register Ar chive with Vo l S e r v After an archi ve is successfully conf igured, it must be registered with V olServ . Th is is done via two methods: Cycle V olServ; for information see “Gracefully T erminate V olServ” on page 2-9 and see “Start Up V olServ” on page 2-3 .
Administrative T asks 601354 Rev A Initial Configuration 3-19 Initial Configuration Create a Media Class After an archi ve is successfully conf igured and registered with V olServ , at least one Media Class must be created. Media Classes are created using the Create Media Class comman d.
Administrative T asks 3-20 Initial Configuration 601354 Re v A • A Media Class is an integral part of the media migration philosophy . When media type migration or media class migration occur , media must stay within the same media class.
Administrative T asks 601354 Rev A Initial Configuration 3-21 Initial Configuration No software res triction is plac ed on the media class capacity . Class capacity can exceed the total combined capacity of all archi ves, or can be as small as one.
Administrative T asks 3-22 Initial Configuration 601354 Re v A Mountable By Class Selecting the mountable by class option sets a flag for the subject Media Class. This flag is used by the Mount Media command. The Mount Media command provides four ways in which media may be selected for mounting.
Administrative T asks 601354 Rev A Initial Configuration 3-23 Initial Configuration Syslog notification messages st op whene ver the amount of media drops belo w the high mark.
Administrative T asks 3-24 Initial Configuration 601354 Re v A Create an Ar chive Media Class After a media class is successfull y conf igured and registered with V olServ , it must be associated with one or more archiv es. This association is referred to as an archi ve media class.
Administrative T asks 601354 Rev A Initial Configuration 3-25 Initial Configuration Use the figure sho wn belo w . Assume that the Automated Archi ve has a capacity of 100 bins and Media Class Group A has a capacity of 200. Also assume that Me dia Class Group A is associated with the Automated Archi ve and Manual Archi ve.
Administrative T asks 3-26 Initial Configuration 601354 Re v A Although not enforced by V olServ software, there is one restriction that should be applied to archiv e class percentage when media migration is planne d. This restriction is there should be no Media Class ov e rlap.
Administrative T asks 601354 Rev A Initial Configuration 3-27 Initial Configuration • The migrate action mode is selected, media within an archi ve media class are subject to migration to another archi ve associated with the same media class.
Administrative T asks 3-28 Initial Configuration 601354 Re v A After media class migration star ts, migration continues until one of the follo wing occur: • The media class fi ll le vel reach es th e media class lo w mark. • The A O removes the media from th e Eject list.
Administrative T asks 601354 Rev A Initial Configuration 3-29 Initial Configuration During archi ve conf iguration, a different set of high and lo w marks are entered. These marks are used to determine when to start and stop media type migration. Refer to “High Mark” on page 3-9 and “Lo w Mark” on page 3-8 .
Administrative T asks 3-30 Initial Configuration 601354 Re v A If the media type lo w mark thre shold is not reached after the f irst iteration, the process con tinues by selecting the ne xt eligible archi ve media class and testing its f ill lev el.
Administrative T asks 601354 Rev A Initial Configuration 3-31 Initial Configuration Migration Priority and Ar chive When the archi ve media class action mode migr ate option is selected, a migration priority is assigned to the archi ve media class. This v alue is used onl y during media type migration.
Administrative T asks 3-32 Initial Configuration 601354 Re v A Create a Drive After all archi ves at a site ar e successfully configured and registered with V olServ , at leas t one dri ve must be defined and associated with an archi ve. The Create Dri ve command is used to define a dri ve; four dri ve statistics are associated wi th it.
Administrative T asks 601354 Rev A Initial Configuration 3-33 Initial Configuration Dri ves can be def ined before the creation of media classes. Ho wev er, the y ultimately must be associated with an archi ve before they can be used to mount media.
Administrative T asks 3-34 Initial Configuration 601354 Re v A Entries hav e the form d#t#l0 for the SCSI driv es. The first # indicates the element a ddress of the dri ve in the library and the second # indicates the SCSI tar get id of the dri ve.
Administrative T asks 601354 Rev A Initial Configuration 3-35 Initial Configuration Add Media to an Ar chive After at least one archi ve media class is successfully conf igured, media can be entered into an archi ve. In f act, normal operations cannot begin unt il media are entered into an archi ve.
Administrative T asks 3-36 Initial Configuration 601354 Re v A NO TES.
Normal Operations 4 Normal Operations Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-4 Command Priorities . . . . . . . . . . . . . . . . . . . . . . . 4-5 Archive Management . . . . . . . . . . . . . . . . . . . . . . 4-6 Configure/ Reconfigure an Archive .
Administrative T asks 4-2 Normal Operations 601354 Re v A Media Management . . . . . . . . . . . . . . . . . . . . . . . 4-24 Enter Unknown Media into an Archive . . . 4-24 Enter Known Media into an Archive . . . . . 4-29 Remove Media from an Archive .
Administrative T asks 601354 Rev A Normal Operations 4-3 Normal Operation CIient Operations . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Disconnect . . . . . . . . . . .
Administrative T asks 4-4 Normal Operations 601354 Re v A Overview Normal operations are functions performed on a daily basis. Some of functions are routine while others may require making modif icati.
Administrative T asks 601354 Rev A Normal Operations 4-5 Normal Operation Command Priorities All V olServ commands are ex ecuted as they are sent. Ho wev e r , a command queue keeps track of commands that arri ve when V olServ resources are busy .
Administrative T asks 4-6 Normal Operations 601354 Re v A Ar chive Management All archi ve management operati ons can be performed via the GUI except where noted. Configure/ Reconfigure an Ar chive An archi ve can be conf igured or reconfigured at an y time.
Administrative T asks 601354 Rev A Normal Operations 4-7 Normal Operation Change Arc hive Pa r a m e t e rs The change archiv e parameters command allows changing tw o archi ve parameters witho ut requiring that the archiv e become unav a ilable. These parameters ar e the archi v e mode and archi ve console display host.
Administrative T asks 4-8 Normal Operations 601354 Re v A The unavailable state is a deri ved state. It is reserved for lo wer lev el equipment and is au tomatically entered when higher le vel equipment goes into the off-line state or is mo ved into the diagnostic state.
Administrative T asks 601354 Rev A Normal Operations 4-9 Normal Operation Create/Modify/ Delete a Media Class Media classes can be created, modi f i ed, or deleted at an y time. media class creation is cov ered in the initial configuration section of this manual.
Administrative T asks 4-10 Normal Operations 601354 Rev A Using the Modify Archi ve Media Class command, all archi ve media class parameters def ined during archiv e media class creation may be modif ied. The Create and Modify Archi ve Media Class associated commands are av ailable via the GUI and API.
Administrative T asks 601354 Rev A Normal Operations 4-11 Normal Operation • 40 percent of Media Class Group A is associated with Archi ve X • 40 percent of Media Class Group A is associated with .
Administrative T asks 4-12 Normal Operations 601354 Rev A until the Archi ve Media Class AX f ill lev el reaches the low mark threshold of 48 media (= 200 * 0.40 * 0.60 = Media Class Group A capacity * Archi ve Media Class AX % * Archi ve Media Class AX lo w mark %).
Administrative T asks 601354 Rev A Normal Operations 4-13 Normal Operation The Reconf igure Archi ve command can be used to change the media type high mark and lo w mark. Changing these two factors af fect media type mig ration parameters only (media type high mark threshold and me dia type lo w mark threshold).
Administrative T asks 4-14 Normal Operations 601354 Rev A Add Ar chive to Existing Installation When a site requires the addition of another archi ve, the operations are almost identical to the operations outlined in the initial configuration section of this chapter .
Administrative T asks 601354 Rev A Normal Operations 4-15 Normal Operation In general, a comparison is made between the V olServ database and the actual media in ventor y when an Audit command is ex ecuted. The automated archiv e robot or the manual archive A O in ventories the media.
Administrative T asks 4-16 Normal Operations 601354 Rev A Drive Management All Dri ve Management operations can be performed via the GUI and API, except where noted. Create and Associate a Drive A dri ve can be created and associated with an archi ve at an y time.
Administrative T asks 601354 Rev A Normal Operations 4-17 Normal Operation The only parameter necessary for the Disassociate Dri ve and Delete Dri ve associated comma nds is the dri ve identifier . The Disassociate Dri v e and Delete Driv e associated commands are av ailable via the GUI only .
Administrative T asks 4-18 Normal Operations 601354 Rev A It is also possible that some dri v es’ data paths at a site may be connected to computers not associ ated with one network. In this case, dri v e pools can be created to segre g ate between the dri ves connected to dif ferent networks.
Administrative T asks 601354 Rev A Normal Operations 4-19 Normal Operation The mount by media identifi er and drive pool method is used when a higher likelihood of mounting a specif i c medium without waiting is desired. It is possible that the specif ic medium could be mounted on any one of the dri v es listed in the dri ve pool.
Administrative T asks 4-20 Normal Operations 601354 Rev A Like the mount by media list and drive identif ier method, the mount by media class and drive identif ier method is used when the specifi c medium to be mounte d is unimportant e xcept that it be chosen from a specif ic Media Class.
Administrative T asks 601354 Rev A Normal Operations 4-21 Normal Operation • If an improper lock identif ier is specif ied. The Mount Media command is av ailable ov er the GUI, CLI, and API. There is a subset of these capabilities a v ailable to the A O using the MOUNT option of an archiv e Console.
Administrative T asks 4-22 Normal Operations 601354 Rev A Intransit Media (Mount) In some cases, a medium may be mov ed to another archive because of a Mount Media command. Any medium that is ejected from the source archi ve by the A O, b ut not entered into the target archi ve, is placed in the intransit state.
Administrative T asks 601354 Rev A Normal Operations 4-23 Normal Operation The vary drive command also allows a dri ve to be mov ed to the on-line state and clear two of four dri ve statistics. These statistics are the current usage time and error count.
Administrative T asks 4-24 Normal Operations 601354 Rev A Media Management All media management operations may be performed via the GUI, CLI, and API except where noted. Enter Unknown Media into an Ar chive All media can be classified as kno wn or unkno wn to the V olServ system.
Administrative T asks 601354 Rev A Normal Operations 4-25 Normal Operation Appropriate labels must be af f i xed to all media to be imported. A GUI option imbedded in the Import windo w allows the SA or SO to print multiple barcode media labels or human-readable paper labels at one time.
Administrative T asks 4-26 Normal Operations 601354 Rev A The f ill le v el of the destinati on archi v e media class must be lo w enough to allo w addition of more media. Archive media class capacity - Fill le vel = Amount of media that can be entered Excess media are placed on the Ej ect list after the audit.
Administrative T asks 601354 Rev A Normal Operations 4-27 Normal Operation Bulk Load Media The bulk load method is the best w ay to place a relati vely large quantity of media into an automated archi ve. The media are installed by hand into an automa ted archi ve and follo wed by an audit operation.
Administrative T asks 4-28 Normal Operations 601354 Rev A Receiving archive media class capacity - F ill le vel = Amount of media that can be entered In the last three cases, the Data T o wer mo v es e xcess media to its Eject port. Unsolicited Enter of Unknown Media The DataT ower archi ve supports the unsolicited media enter operation.
Administrative T asks 601354 Rev A Normal Operations 4-29 Normal Operation • The target archi ve must be conf igured with the auto check-in and auto import opti ons selected. If not, all the subject media are left in the load port and a failu re message is logged and displayed at the V olume Server System console.
Administrative T asks 4-30 Normal Operations 601354 Rev A Check-in Media into an Archiv e The Check-in Media command enters checked out media into an archi v e. These media are placed on the Enter list. If media to be checked in are not labeled, labels must be pro vided.
Administrative T asks 601354 Rev A Normal Operations 4-31 Normal Operation Three prerequisites for us ing this method include: • Each medium must hav e a barc ode label aff ixed to it. The Reprint Media Label command can be used to print indi vidual barcode labels.
Administrative T asks 4-32 Normal Operations 601354 Rev A Basic export parameters are the e xport media identifier , export comment, and priority . The export comment is optional and appears on the Eject list. This co mment can be used to con ve y additional information, such as th e source of the command.
Administrative T asks 601354 Rev A Normal Operations 4-33 Normal Operation In this operational scenario, the A O varies the archi ve to the of f-line or maintenance state, opens the archive door , and remov es the media. Then V olServ software is notif ied that the media were physically remov ed by the operator .
Administrative T asks 4-34 Normal Operations 601354 Rev A Mo ve Media to Another Ar chive Sometimes media located in one archiv e must be moved to another archi ve. F or example, it may be adv antageous to move infrequently accessed me dia from an automated archi ve to a manual archi ve.
Administrative T asks 601354 Rev A Normal Operations 4-35 Normal Operation These user statistics are genera lly created and modified b y client applications. Ho wev e r , th e SA or SO can also create and change any user statistic. The pr imary use of user statistics is for the Mount Media command’ s mount by criteria option.
Administrative T asks 4-36 Normal Operations 601354 Rev A Rec lassify Media The Reclassify Media command moves media from one Media Class to another . A list of po ssible reasons for reclassification include the follo w ing: • It can mov e blank media into any media class without requiring physical handling of the media.
Administrative T asks 601354 Rev A Normal Operations 4-37 Normal Operation Define or Delete a Label P attern A label pattern can be created at any time. The def ine label pattern command creates a label pattern and is cov ered in the initial configuration section of this manual.
Administrative T asks 4-38 Normal Operations 601354 Rev A The Import Media command can be used to print barcode labels for use in automated archi ves. The Import windo w print labels option is selected to print a label for each medium to be imported. The preformatted output is sent to the Intermec 4100 label printer .
Administrative T asks 601354 Rev A Normal Operations 4-39 Normal Operation System Repor ts The system queries and reports pro vides information about the V olServ configured system. These reports provide conf iguration specif ic informati on to help manage the V olServ system for optimal performance.
Administrative T asks 4-40 Normal Operations 601354 Rev A Media ID The media located in the ar chive. Media Class Media Class assoc iat ed with th e ar ch ive Media T ype The def ault type of media associated with the Media Class. V alid values are AIT , CTIII (DL T) , CTIV (DL T), D2s, D2M, D2L, D3, DTF , DTF-2, L T O , MO5.
Administrative T asks 601354 Rev A Normal Operations 4-41 Normal Operation The Query Archi ve command can be tailored to show detailed information for dri ves, media, Media Classes and/or media type information associated with th e archiv e. An example sho wing only a Media Class and media t ypes is sho wn in the following screen display .
Administrative T asks 4-42 Normal Operations 601354 Rev A Query Drive The Query Drive command obtains information about one or more dri ves and associated pa rameters used in the V olServ system. A report is generated and can be sent to the screen, a specif ied file, or printer as sho wn in the follo wing screen display .
Administrative T asks 601354 Rev A Normal Operations 4-43 Normal Operation Error Count Refer to “Create a Drive” on page 3-32 fo r a definition of this statistic. Mount State Whether a medium is mo unt ed or not mounted in the driv e when the query was e xecuted.
Administrative T asks 4-44 Normal Operations 601354 Rev A Query Drive Po o l The Query Driv e Pool command obtains information about one or all dri ve pools.
Administrative T asks 601354 Rev A Normal Operations 4-45 Normal Operation --------------------- ------------------------------------------ -------------------------------------- ---------------------.
Administrative T asks 4-46 Normal Operations 601354 Rev A Query Mount The Query Mount command queries driv es th at can be used in a subsequent mount of a specif ied medium. Upon receipt of the query request, V olServ determines which archi ve contains the specified me dium.
Administrative T asks 601354 Rev A Normal Operations 4-47 Normal Operation A query media request can query any media in the V olServ system. The media specified in a single media query request are not required to be located in the same archi ve.
Administrative T asks 4-48 Normal Operations 601354 Rev A Last Access The dat e and time the medium w as last mounted. Mount Count The numb er of times t he me dium is mounted in a driv e. Mov e Count The number of times t he media is mov ed in and out of its bin locat ion.
Administrative T asks 601354 Rev A Normal Operations 4-49 Normal Operation Query Media Location The Query Media Location command obtains information about a specif ied medium or multiple media used in the V olServ system. A report is generated and can be sent to the screen, a specif ied f ile, or printer .
Administrative T asks 4-50 Normal Operations 601354 Rev A Bin Location The location of the medium in the archiv e. If the med ium is in the intransit state, the Bin Location shows all zer os.
Administrative T asks 601354 Rev A Normal Operations 4-51 Normal Operation Query Intransit Media The Query Intransit Media command obtains information about media in the Intransit state.
Administrative T asks 4-52 Normal Operations 601354 Rev A The report is sent only to the screen sho wing the status of the query request. An example of the query intransit media report is sho wn in the screen display page 4-51 .
Administrative T asks 601354 Rev A Normal Operations 4-53 Normal Operation • A report sho wing all Media Class names and a detailed listing of all media associated with each Media Class.
Administrative T asks 4-54 Normal Operations 601354 Rev A RPC Option The RPC optio n used b y the Media Class f or status. De pending on the option , additional fields ar e displa yed. No Callback When the enter prise callbac k option is enab led, media class callbac ks are not returned.
Administrative T asks 601354 Rev A Normal Operations 4-55 Normal Operation P ending Archiv e The archiv e to where th e medium is migr ated if migrate w as selected under the Action option of th e archive configuratio n. Action State The Ac tion associated wit h the archive when the archiv e meets or e xceeds the Low Mark or High Mark parameters.
Administrative T asks 4-56 Normal Operations 601354 Rev A --------------------- ------------------------------------------ -------------------------------------- ------------------------ -------------.
Administrative T asks 601354 Rev A Normal Operations 4-57 Normal Operation Query Media Ty p e The Query Media T ype command is used to obtain information about one or more me dia types used in the V olServ system. A report is generated and can be sent to the screen, a specif ied f ile, or printer as sho wn in the screen display below .
Administrative T asks 4-58 Normal Operations 601354 Rev A Query Request The Query Request command is used to obtain information about a specif ic request. The request identifier assigned b y V o lServ softwa re must be used. Upon receipt of a request query request, V olServ searches its request queue for the specif ied request identifi er .
Administrative T asks 601354 Rev A Normal Operations 4-59 Normal Operation Query Connect The Query Connect command pro vides a li st of all client internet addresses currently associated with a specif ied enterprise identif ier .
Administrative T asks 4-60 Normal Operations 601354 Rev A The default report produces the follo wing information: Field Description Enter prise ID The ente r prise identifier n umber associated with the report. Client # The associated Client’ s number .
Administrative T asks 601354 Rev A Normal Operations 4-61 Normal Operation CIient Operations Three comman ds are exclusiv ely av ailable via the API. These are the Connect , Disconnect , and Multimount Me dia associate commands. Connect When a client issues a Connect command, the sending host becomes a member of an Enterpri se.
Administrative T asks 4-62 Normal Operations 601354 Rev A The Multimount Media command fails for the s ame reasons that any single Mount Media command f ails. In addition, a Multimount Media command fails for any of the follo wing conditions: • If the number of mount reque sts e xceeds the number of on-line dri ves.
Administrative T asks 601354 Rev A Normal Operations 4-63 Normal Operation NO TES.
Administrative T asks 4-64 Normal Operations 601354 Rev A NO TES.
Archive Operations 5 Ar chive Operations Automated Archive Operations . . . . . . . . . . . . . 5-3 Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Eject Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-6 Audit .
Administrative T asks 5-2 Archive Operations 601354 Re v A Roadmap T opic Refer T o Chapter General software inst allation inf or mation 1 Hardwa re and soft w are star t-up 2 Site-specific configu r ation of archives an d drives 3 Daily operation.
Administrative T asks 601354 Rev A Arc hive Operations 5-3 Archive Operations A utomated Ar chive Operations This chapter describes the operations performed by the V olServ Archi ve Operator (A O) during normal operations. An archi ve Console prompts most A O operations .
Administrative T asks 5-4 Archive Operations 601354 Re v A Many situations require the A O to perform media handling operations. Most media handling is required because of V olServ command execution, such as Import, Export, Check-in, Check-out, Mov e, or Mount Media commands.
Administrative T asks 601354 Rev A Arc hive Operations 5-5 Archive Operations Media are placed on the Enter list as an indirect result of Move and Mount Media commands and medi a migration mo v ement. Before a medium is contained in an archi ve Enter list for the reasons of mov e, mount, or migrat e, it must firs t be ejected from another archi ve.
Administrative T asks 5-6 Archive Operations 601354 Re v A All media that are entered or checked in are mo ved to bins inside the archi ve. When either auto check-in or auto import options are not selected, intransit or checked -out media is left in the port and/or identif ied on the Eject list.
Administrative T asks 601354 Rev A Arc hive Operations 5-7 Archive Operations A comment fi eld lists an optio nal comment for each medium. The client def ines these comments when the Export or Check-out Media commands are e xecuted. This field is not applicable for Mov e or Mount Media commands.
Administrative T asks 5-8 Archive Operations 601354 Re v A Standard A udit During a Standard Audit, V olServ commands the robot to look into each specif ied bin and to read the external label on an y medium present. Thus, the act ual content of each bin is compared against the V olSer v database.
Administrative T asks 601354 Rev A Arc hive Operations 5-9 Archive Operations When an AML archi ve Standard Audit is performed, the archi ves require that no media be mounted before e xecuting an audit. If any media are mounte d, the audit fails. If a mount request is issued while an audit is in progress, the mount will fai l.
Administrative T asks 5-10 Archiv e Operations 601354 Re v A Unsolicited Enter Operation This subject is cov ered in detail in “Unsolicited Enter of Unkno wn Media” on page 4-28 and “Unsolicited Entry of Kno wn Media” on page 4-30 .
Administrative T asks 601354 Rev A Arc hive Operations 5-11 Archive Operations Manual Ar chive Operations All operations are initia ted through the archi ve console, see the follo wing two screen displays. The Stage console has fi ve operation options.
Administrative T asks 5-12 Archiv e Operations 601354 Re v A For a DataShelf archi ve, the A O places each medium into a specif ic bin. The Stage archi ve is unstructured a nd requires that the A O locate the media to be entered and acknowledge the command.
Administrative T asks 601354 Rev A Arc hive Operations 5-13 Archive Operations Reprint Label DataShelf only : It presently contains only one command. This is the reprint s helf label command. This command prints human-readabl e shelf labels one at a time on the Seiko Smart Label Pro printer .
Administrative T asks 5-14 Archiv e Operations 601354 Re v A NO TES.
T roub l eshoot 6 T r oub leshoot Troubleshoot Resources . . . . . . . . . . . . . . . . . . . . 6-3 User Environment . . . . . . . . . . . . . . . . . . . . . . . . . 6-5 Initialization/Configuration . . . . . . . . . . . . . . . . 6-9 Archive Specific Issues .
Administrative T asks 6-2 T roubleshoot 601354 Re v A Roadmap T opic Refer T o Chapter General software inst allation inf or mation 1 Hardwa re and soft w are star t-up 2 Site-specific configu r ation.
Administrative T asks 601354 Rev A Troubleshoot 6-3 T roub l eshoot T roubleshoot Resour ces This chapter contains troubles hooting tips for problems that V o lServ users ha ve actually experienced.
Administrative T asks 6-4 T roubleshoot 601354 Re v A • In the USA and Canada, call 1-800-827-3822. • Outside the USA and Canada , call 303-874-0188 or toll-free 00800-9999-3822.
Administrative T asks 601354 Rev A Troubleshoot 6-5 T roub l eshoot User En vironment Prob lem Solution Display F eatures Does a displa y fe ature e xis t tha t ale r ts the user each time a st atus or a message is received? On all consoles, an Options b u tto n is located in th e upper left cor ner .
Administrative T asks 6-6 T roubleshoot 601354 Re v A Log Files How can V olServ log files be bac ked up on a regu lar basis? V olSer v automatically bac ks up log files. The time bet ween bac kups can be set b y changing th e LOG_BACKUP_TIME envir onment v ar iable in the $VS DIR/config/envvar.
Administrative T asks 601354 Rev A Troubleshoot 6-7 T roub l eshoot Status Window Scr olling The status windo w displa ys all of the messages wh en scrolling is perf or med. When attempting to scroll up to read them, as mor e messages com e in, th e scroll re verts to the bottom.
Administrative T asks 6-8 T roubleshoot 601354 Re v A Vo l u m e S e r v e r SysLog Consoles (continued) How can the he ight of a V olume Ser v er SysLog Console be changed to ensure that it sta ys th.
Administrative T asks 601354 Rev A Troubleshoot 6-9 T roub l eshoot Initialization/ Configuration Note The cleanconfig utility can be run for an archiv e configure/reco nfigure process that has te r minated a bnormally .
Administrative T asks 6-10 T roubleshoot 601354 Re v A (continued) Step 4: V erify owner ship and protection owned b y root. Check the binar y file to ensure that th e vswin softw are initializes when e xecuted on an IBM. Ensure that vswin in the $ VS_DIR/bin director y has set the corr ect ownership and pr otection.
Administrative T asks 601354 Rev A Troubleshoot 6-1 1 T roub l eshoot (continued) Step 8: V erify the av ailability of all e xecutab les. Step 9: Enable access to the remote host. Step 10: V erify ownership and prote ction. Note that the vswin software ma y not initialize when e xecuted on an IBM if the binar y file is not owned by root.
Administrative T asks 6-12 T roubleshoot 601354 Re v A Newl y Created Arc hives Wh y doe V olSer v not k eep a record of ne wly created archives? Newly created archiv es remain unknown to V olSer v until the software is cycle d after the archiv e is created.
Administrative T asks 601354 Rev A Troubleshoot 6-1 3 T roub l eshoot Ar chive Specific Issues Prob lem Solution A udit a DataT ower Arc hive What steps should be tak en when auditing an entire Da taT.
Administrative T asks 6-14 T roubleshoot 601354 Re v A Erratic Behavior Erratic behavior occurs in the archive, b ut the V olServ logs do not indicate any pr oblems . The A CS workstation, which is par t of all Storage T ek archiv e syste ms, receiv es unsolicited status d irectly from it s associated StorageT ek ACS product f amily archives .
Administrative T asks 601354 Rev A Troubleshoot 6-1 5 T roub l eshoot General Database Issues For any database questions or general concerns please contact ADIC technical support. Prob lem Solution Utility Programs What is dbtest ? The ex ecutab le dbtest is a utility program that is delivered with V olSer v .
Administrative T asks 6-16 T roubleshoot 601354 Re v A Printer Issues Prob lem Solution Add a Label Printer to the /etc/printcap File How can a label printer be added to the /etc/printcap file? If using a Seik o Label Printer (shelf labels) attached to th e V olSer v host, the f oll owing e xample entr y in the / etc/printcap file can be tried.
Administrative T asks 601354 Rev A Troubleshoot 6-1 7 T roub l eshoot Enable Console Names to P op Up What modificati ons must be made to add co nsole names to th e GUI pop-up window? This pop-up wind.
Administrative T asks 6-18 T roubleshoot 601354 Re v A NO TES.
601354 Rev A INX-1 Inde x A Access system administrator . . . . . . . . . . 1-7 system operator . . . . . . . . . . . . . . 1-7 ADIC technical assistance center . . . 6-3 Adobe Acrobat Reader . . . . . . . . . . . . P-5 AO . . . . . . . . . . . . . . .
Adiministrative T asks INX-2 Index 601354 Rev A define label pattern . . . . . . . . . . . 4-37 disconnect . . . . . . . . . . . . . . . . . 4-61 dismount media . . . . . . . . . . . . . 4-21 hostid . . . . . . . . . . . . . . . . . . . . . 4-14 import media .
Adiministrative T asks 601354 Rev A Index INX-3 CIREQUEST_SYSLOG_LEVEL 1-16 CLM_DISMOUNT_RETRIES . 1-23 CLM_DISMOUNT_WAIT_TIME . . 1-23 CONFIG_SYSLOG_FILE . . . . . 1-24 CONFIG_SYSLOG_LEVEL . . 1-24 CONSOLE_SYSLOG_LEVEL . 1-16 CRITICAL_PROCESSING . . .
Adiministrative T asks INX-4 Index 601354 Rev A console_locations.config . . . . . . 6-17 envvar.config . . . . . . . . . . . . . . . 6-17 label_printers.config . . . . . 1-27 , 6-16 operator.config . . . . . . . . . . . . . . . 1-6 printcap . . . . .
Adiministrative T asks 601354 Rev A Index INX-5 capacity . . . . . . . . . . . . . . . . . . . 3-20 class capacity . . . . . . . . . . . . . . . 4-40 class capacity % . . . . . . . . . . . . . 4-40 create . . . . . . . . . . . . . . . . . . 3-19 , 4-9 create archive .
Adiministrative T asks INX-6 Index 601354 Rev A archive type . . . . . . . . . . . . . . . . 4-39 configure state . . . . . . . . . . . . . . 4-39 console display location . . . . . . . 4-39 current state . . . . . . . . . . . . . . . . 4-39 drive ID .
Adiministrative T asks 601354 Rev A Index INX-7 number of sides . . . . . . . . . . . . . 4-57 Query Request current state . . . . . . . . . . . . . . . . 4-59 priority . . . . . . . . . . . . . . . . . . . . 4-58 request ID . . . . . . . . . . . . . .
Adiministrative T asks INX-8 Index 601354 Rev A.
An important point after buying a device ADIC 601354 (or even before the purchase) is to read its user manual. We should do this for several simple reasons:
If you have not bought ADIC 601354 yet, this is a good time to familiarize yourself with the basic data on the product. First of all view first pages of the manual, you can find above. You should find there the most important technical data ADIC 601354 - thus you can check whether the hardware meets your expectations. When delving into next pages of the user manual, ADIC 601354 you will learn all the available features of the product, as well as information on its operation. The information that you get ADIC 601354 will certainly help you make a decision on the purchase.
If you already are a holder of ADIC 601354, but have not read the manual yet, you should do it for the reasons described above. You will learn then if you properly used the available features, and whether you have not made any mistakes, which can shorten the lifetime ADIC 601354.
However, one of the most important roles played by the user manual is to help in solving problems with ADIC 601354. Almost always you will find there Troubleshooting, which are the most frequently occurring failures and malfunctions of the device ADIC 601354 along with tips on how to solve them. Even if you fail to solve the problem, the manual will show you a further procedure – contact to the customer service center or the nearest service center
