ADIC 601354 manuel d'utilisation

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. Copyright Notice © [...]

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.com Is there anything you especially like or dislike about the organization, pr[...]

NOTES[...]

601354 Rev A i Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

Administ rative Task s ii Contents 601354 Rev A Process Server Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 VolServ Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-21 CiReply Environment . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Administrative Tasks 601354 Rev A Contents iii Auto Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Configure a Manual Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-15 Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Administ rative Task s iv Contents 601354 Rev A Archive Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Configure/ Reconfigure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-6 Delete an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Administrative Tasks 601354 Rev A Contents v Remove Media from an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 Clear Eject List Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-33 Move Media to Another Archive . . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

Administ rative Task s vi Contents 601354 Rev A Archive Operations 5 Automated Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Eject 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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-4 Books . . . . . . . . . . . . . . . . . . . . . . . . . . . [...]

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 . It assumes the administrator h as a strong familiarity with: • UNIX operati[...]

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. Request to add a new volume[...]

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 . The Reader allows you to vie w and navig ate the online documen[...]

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.co[...]

Getting Started 1 Getting Star ted Command Access . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 CLI and API Access Control . . . . . . . . . . . . . . 1-3 GUI Access Control . . . . . . . . . . . . . . . . . . . . . 1-6 Environment Management . . . . . . . . . . . . . . . . . 1-12 Control Access . . . . . . . . . . . . . . . . . . . . . .[...]

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 archive s an d drives 3 Daily operations 4 Archive operation and configuration 5 T roubleshooting tips and solution s 6[...]

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. The follo w ing[...]

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 . Expor t Media Remov es media from the system and an y kno[...]

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. Lock Drive Obtains e xclusive use of one or mo[...]

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.config f ile, which is located in the $VS_DIR/config directory . There are entries i[...]

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. config file and the SO will hav e CLI access to the com[...]

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 . XX Reclassify Media Changes the Media Class nam[...]

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. X Delete Drive Remov es dr ive from [...]

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. XX Queries Quer y Arc hive Repor t showing i[...]

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. XX Capability Description SA SO[...]

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 . Control Access These tw o fi les are used to cont rol access to CLI, API, and [...]

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. Refer to the appropriate V olServ software ma nual. Clicking the right mouse button when using the Cha nge Ar chi ve Parameters co mmand displays the console names contai ned in this f ile, all[...]

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. V olServ must be cyc[...]

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. V ariable Name Default Description NUM_LOG_DAYS 3 The maximum n umber of days of log files [...]

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.. PROCSERV_SYSLOG_LEVEL 6 Process Ser v er MONITOR_SYSLOG_LEVEL 6 Monitor ARCMAN_CAPA[...]

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. DELETE_ARCHIVE_MEDIA_ACTI ONSTATE INTRANSIT This v alue is use[...]

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. LIB_IPC_WAIT_TIME 5 Number of seconds this process pauses between at tempts to[...]

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. V olServ must be cycled for the changes to become ef fectiv e. ARCDISP_IPC[...]

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. V o lServ Defaults The follo wing table shows the v ari ables that can be[...]

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. V olServ must be cycled for the changes to becom[...]

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. V olServ must be cycled for the changes to become ef fecti ve. V ariab[...]

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. V olServ must be recycled fo r the changes to become ef fecti v[...]

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. Use the V olServ installation script for this purpose . V o lServ Database The follo w ing table sho ws the V o lServ database variables that are to be establ[...]

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.g., ps1 pos tscript.The label printers m[...]

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 . . . . . . . . . . . . . . . . . . . . 2-6 Backup VolServ . . . . . . . . . . . [...]

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. 3 Daily operations 4 Archive operation and configuration 5 T roubleshooting tips and solution s 6[...]

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 . Perform start-up of all equipment in accordance with the appropriate host computer ,[...]

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. The volserv -s command starts VolServ in[...]

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. Each V olServ Archiv e Operat or position is indicated by the presence of [...]

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 the DISPLAY environment variable: After a moment, the Volume Server System console appears as shown in the following screen display: Reco ver y Pr oces[...]

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. Shutdown System Console A V olume Server System console need not be brought do wn before shutting do wn V olServ[...]

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. Shutdo wn Vo l S e r v T wo ways exist to bring do wn V olServ: gracefully a[...]

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. The V olume Server System console is not brought do wn by this procedure. The conso[...]

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.0 for ## ## (#.#) -- Copyright (c) 1992 - 2001 - ADIC, Inc. Initiating VolServ sh[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . 3-12 Configure a Manual Archive . . . . . . . . .[...]

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 r ation of archives an d drives 3 Daily operations 4 Archive operation and configuratio n 5 T roubleshoot ing tips and solut ions 6[...]

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. The fol[...]

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. The manual archi ves supported b y V olServ include the DataShelf archi ve and[...]

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. After an archi ve is conf igured a nd registered with V olServ , the archi ve Console displays at the specified location, refer to the Start-up and Shutdo wn chapter for an[...]

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. When this ov erride parameter is specified, media mov ement requiring human intervention i[...]

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. Ho we ver , when the num ber of media of the specified media type reaches the[...]

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. Media type migration occurs onl y if the Media Class t[...]

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. Any inte ger value between 0 and 100, inclusi ve, can b[...]

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. When an archi ve audit is performed, the archi ve control software reports the media contents of the archi ve to [...]

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. • If the auto check-in option[...]

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. The auto import parameter sp ecif ies what action V olServ initiates when an unkno wn me[...]

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). • If the auto impo rt option is not enabled, V olServ initiates the ejection of the unkno wn medi a from the V olServ system by placing the media on t[...]

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. A uto Impor t During Enter All archi ves support t[...]

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 CS Product Family archi ves) When an intransit medium ( due to an incomplete mount command) is imported or entered, V olServ software attempts to com[...]

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 per ro w , the shelves are labeled sequentially as follo ws: Ro w 1 Shelf 1, …, Row 1 She lf4, Ro w 2 Shelf 1, … Row 2 Shelf 4, Ro w 3 Shelf 1, …[...]

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. A uto Impor t The auto import 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 . Perf[...]

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. Media Classes provide logical organization of media into smal[...]

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. Basic Media Class parameters include the Media Class name, media type, class capacity , mountable by class, h[...]

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. Although not necessary , there are tw o restrictions that should be applied to Media Class capaciti e[...]

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. These are: • Mount by media identif ier • Mount b[...]

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. This can be achieve d by ejecting media, using the Reclassify Media command to move media into another media class, or raising the class capacity using the Modify Media Clas[...]

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. Archi ve media classes are created using the Create Ar chive Media[...]

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. When the Media Class Grou[...]

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. Using the figure in “A r c h i v e Class Percentage” on page 3-24 [...]

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. Mig ration continues until the lo w mark is reached, provided that enough space exists in the dest inatio[...]

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. Such media enter the intransit state. There are two reasons for remo vi n[...]

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 . Both sets of marks are independe[...]

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. If the subject archi ve media class f ill lev el is above its lo w mark, some of its media is place[...]

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. When media type migration be gins, media from [...]

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. These are [...]

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. Associate a Drive with an Ar chive After all dri ves are successfully defined, the y must be associa[...]

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. Entries match the dri v e names that a re conf igured for the Scalar DLC dri ves, for e xample, PDR25[...]

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. Four basic methods are used to add media to most [...]

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 . . . . . . . 4-6 Delete 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 . . . . . . . . . 4-31 Clear Eject List Entries . . . . . . . . . . . . . . . . . . 4-33 Move Media[...]

Administrative T asks 601354 Rev A Normal Operations 4-3 Normal Operation CIient Operations . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-61 Multimount Media . . . . . . . . . . . . . . . . . . . . .[...]

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 ications to the existing site conf iguration, changing pri vileges for a client application or V olServ System Operator (SO), or responding to a client a p[...]

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 . Note that each command is ass ociated with an ex ecution priority that ranges from 0 to 32 (high to lo[...]

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. The Configure Archi ve command is used to create an archi ve def inition and is cov ered in[...]

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. The archi ve mode attended [...]

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. That is, this state applies to archi ve components when the archi ve is mo ved[...]

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. Refer to “Create a Media Class” on page 3-19 for a description of the cr eate medi[...]

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. Delete an Ar chive Media Class When an archi v[...]

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 Archi ve Y • 20 percent of Media Class Group A is associated with archi ve Z • High mark and lo w mark for Archive Media Class AX is 80percent and[...]

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 %). In this case, 16 media are migrated to Archi ve Media Class A Y . No w assume that[...]

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). For e xample, if the high mark is ra[...]

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 . Ho wever , only certain archiv es may be conf igured. When V olServ software is i[...]

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. The r esult of this audit is sent to V olServ , which compares t[...]

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. The Create Dri ve command is used to create a dri ve def inition and is cov ered in t[...]

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 . Create or Modify a Drive Po o l When an SA, SO, or clie[...]

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. The Modify Dri ve Pool command allo ws dri ves to be [...]

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. Therefore, a user[...]

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. The medium selection algorithm used is similar to that of t[...]

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. Basic mount parameters are dri ve identif ier o[...]

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. This state indicates that media are [...]

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. Refer to “Create a Dri v e” on page 3-32 for more information about dri ve statistics. A dr[...]

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. Unknown media are those that were ne ver introduced into a V o lServ [...]

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. Th e Reprint Media Label command can also be used to print in[...]

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. Intransit Media (Impor t) After media[...]

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. The audit is performed to logically enter the med[...]

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. An unsolic[...]

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. • The auto import destinati on[...]

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. Refer to “Reprint a Media Label” on page 4-37 or use the Print Label optio[...]

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. Refer to “Reprint a Media Label” on page 4-37 for more information. • If the[...]

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. No format requirements exist, othe r than [...]

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 . Unlike the e xport media command, m[...]

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. Also, media that are in the intransit state can be reentered [...]

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. This option allo ws [...]

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. • It can remo ve 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. Refer to “Define a Label Pattern” on page 3-34 . Pre viously-defin[...]

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 . It must be attached to the V o[...]

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. All system queries and report operations can be [...]

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.25, NCTP , RF5.25, ST -[...]

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 . Media Cl[...]

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 . The default report produce[...]

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. V alid v alues are Mounted or Unmounted . Mounted Medi a ID Shows which me dium is[...]

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. A report is generated and can be sent to the screen, a specified f ile, or printer . The report can be tailored to include only the dri ve identif iers associated with the dri v e pool or a de[...]

Administrative T asks 601354 Rev A Normal Operations 4-45 Normal Operation --------------------- ------------------------------------------ -------------------------------------- ------------------------ -------------------- Drive Pool Query Report May 26 15:45:52 1999 1 --------------------- ------------------------------------------ -------------[...]

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. If the medium is in an archi ve, V olServ determines which dri ves in that[...]

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. The def ault report produces the follo wing information: Field Description Media ID The media identi fie[...]

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. Manuf acturer The media m anuf acturer ’ s name. Batch The lot or ref ere[...]

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 . This query is only av ailable though the G[...]

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. Field Description[...]

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. A medium is considered to be Intransit if it meets any of the follo wing conditions: • The medium is waiting to be entered into an archi ve because of an Import,[...]

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 . Query Media Class The Query Media Class command obtains in formation about a specif ied Media Class or all Me dia Classes[...]

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. The default report produces the follo wing information: Note A repor t sho wing Medi a Classes wit h a det ailed listi ng of all me dia ma y take some time to r [...]

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. Additional fields: None Enter prise Callback When the ente r [...]

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. V[...]

Administrative T asks 4-56 Normal Operations 601354 Rev A --------------------- ------------------------------------------ -------------------------------------- ------------------------ -------------------- Media Class Query Report May 14 10:09:11 1999 1 --------------------- ------------------------------------------ -----------------------------[...]

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 . The default [...]

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 . If the [...]

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 . A report is generated and can be sent to the screen, a specif ied f ile, or printe r as sho wn in follow ing screen disp[...]

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 . So cket F a mi ly The sock et domain. So cket P o r t A 16-bit por t n umber . Internet Addres[...]

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. An Enterprise is a g[...]

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. • If improper syntax is dete[...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-7 Unsolicited Enter Operation . [...]

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. 4 Archive operation and configuratio n 5 T roubleshoot ing tips and solut ions 6[...]

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 . Each configured archi ve displays an archi ve Console . The display location [...]

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. Media mov ement triggered by th e media migration policy also requires th[...]

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. Eject Media An A O is alerted that a medium or media [...]

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. Media on the Eject list can be remov ed by the A O. W[...]

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. Depending on the number of bins to audit, a Sta ndar[...]

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. Under normal conditio[...]

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. The DataShelf console has six operation options. Enter Media The Manual Archi ve Enter operation [...]

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. Eject Media The Manual Archi ve Eject operation is analogous to the Automatic Archi ve Eject[...]

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 . . . . . . . . . . . . . . . . . . . . 6 -13 General Database 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 of archives an d drives 3 Daily operations 4 Archive operation and configuratio n 5 T roubleshoot ing tips and solut ions 6[...]

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. Ho we ver , before re viewing this chapter for a solution to a problem, take a moment to read about some ti me-sa ving V olServ resources that are av a[...]

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. • Send e-mail to: support@adic.com.[...]

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 . If selected, a pull-down men u displays with St[...]

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.config file . This v ar iable is the amou nt of time i[...]

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. If the right mouse b utton is pressed with the cursor in t he status [...]

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 the same each t ime V olServ software start s? T o ensure a consistent Sys-Log heig ht , perform the f ollowing proced ure: Step 1: Cha nge to the $VS _[...]

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 . Prob lem Solution Clear Configuration in Progres s Flags During reconfiguration, configurat ion in prog ress flags are received e[...]

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. The ow nership should be root a[...]

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. W orkstati[...]

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. If , after creating an archiv e, fur ther opera tions inv olving the archive result in erro[...]

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 ow er archiv e and disco vering that a duplicate med i a ident i fier (ID) exists, b ut th e status and the Media Lo c a tio n quer y only list one l[...]

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 . Chec[...]

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 . It gives A T AC person nel ea sy acces[...]

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. The[...]

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 window appea rs wh en the right mo us e b utton is pressed while the pr ompt cursor is in the Ne w Console Display Host te xt line of the Change Arc hive [...]

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 . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 API . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3 Archive[...]

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 . . . . . . . . . . . . . . . 4-37 intransit media . . . . . . . . . . . . . . 4-51 modify [...]

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 . . . . 1-23 DatabaseName . . . . . . . . . . . . . . 1-25 DELETE_ARCHIVE_MEDIA_ACTI ONSTATE . . . . . [...]

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 . . . . . . . . . . . . . . . . . . . 6-16 printers.config . . . . . . . . . . 1-27 , 6-16 servers.config . [...]

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 . . . . . . . . . . . . . . . 3-24 current fill level . . . . . . . . . . . . . 4-4[...]

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 . . . . . . . . . . . . . . . . . . . 4-39 fill mode . . . . . . . . . . . . . . . . . . . 4-39 med[...]

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 . . . . . . . . . . . . . . . . . . 4-58 request type . . . . . . . . . . . . . . . . 4-58 time . . . . . . . . . . . . . . .[...]

Adiministrative T asks INX-8 Index 601354 Rev A[...]