ADIC 601354 manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation ADIC 601354. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel ADIC 601354 ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation ADIC 601354 décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation ADIC 601354 devrait contenir:
- informations sur les caractéristiques techniques du dispositif ADIC 601354
- nom du fabricant et année de fabrication ADIC 601354
- instructions d'utilisation, de réglage et d’entretien de l'équipement ADIC 601354
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage ADIC 601354 ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles ADIC 601354 et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service ADIC en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées ADIC 601354, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif ADIC 601354, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation ADIC 601354. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    Administrative T asks V olServ V ersion 5.0 September 2001 601354 Rev A[...]

  • Page 2

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

  • Page 3

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

  • Page 4

    NOTES[...]

  • Page 5

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

  • Page 6

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

  • Page 7

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

  • Page 8

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

  • Page 9

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

  • Page 10

    Administ rative Task s vi Contents 601354 Rev A Archive Operations 5 Automated Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-3 Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-4 Eject Media . . . . . . . . . . . . . . . . . [...]

  • Page 11

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

  • Page 12

    Administrative T asks P-2 Preface 601354 Re v A NO TES[...]

  • Page 13

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

  • Page 14

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

  • Page 15

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

  • Page 16

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

  • Page 17

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

  • Page 18

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

  • Page 19

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

  • Page 20

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

  • Page 21

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

  • Page 22

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

  • Page 23

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

  • Page 24

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

  • Page 25

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

  • Page 26

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

  • Page 27

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

  • Page 28

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

  • Page 29

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

  • Page 30

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

  • Page 31

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

  • Page 32

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

  • Page 33

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

  • Page 34

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

  • Page 35

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

  • Page 36

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

  • Page 37

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

  • Page 38

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

  • Page 39

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

  • Page 40

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

  • Page 41

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

  • Page 42

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

  • Page 43

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

  • Page 44

    Administrative Tasks 1-28 Getting Started 601354 Re v A NO TES[...]

  • Page 45

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

  • Page 46

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

  • Page 47

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

  • Page 48

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

  • Page 49

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

  • Page 50

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

  • Page 51

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

  • Page 52

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

  • Page 53

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

  • Page 54

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

  • Page 55

    Adiministrative T asks 601354 Rev A Start-up and Shutdown 2-11 Start-up and Shutdown NO TES[...]

  • Page 56

    Adiministrative T asks 2-12 Start-up and Shutdo wn 601354 Re v A NO TES[...]

  • Page 57

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

  • Page 58

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

  • Page 59

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

  • Page 60

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

  • Page 61

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

  • Page 62

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

  • Page 63

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

  • Page 64

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

  • Page 65

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

  • Page 66

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

  • Page 67

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

  • Page 68

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

  • Page 69

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

  • Page 70

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

  • Page 71

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

  • Page 72

    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, …[...]

  • Page 73

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

  • Page 74

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

  • Page 75

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

  • Page 76

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

  • Page 77

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

  • Page 78

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

  • Page 79

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

  • Page 80

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

  • Page 81

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

  • Page 82

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

  • Page 83

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

  • Page 84

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

  • Page 85

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

  • Page 86

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

  • Page 87

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

  • Page 88

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

  • Page 89

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

  • Page 90

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

  • Page 91

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

  • Page 92

    Administrative T asks 3-36 Initial Configuration 601354 Re v A NO TES[...]

  • Page 93

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

  • Page 94

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

  • Page 95

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

  • Page 96

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

  • Page 97

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

  • Page 98

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

  • Page 99

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

  • Page 100

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

  • Page 101

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

  • Page 102

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

  • Page 103

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

  • Page 104

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

  • Page 105

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

  • Page 106

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

  • Page 107

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

  • Page 108

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

  • Page 109

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

  • Page 110

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

  • Page 111

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

  • Page 112

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

  • Page 113

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

  • Page 114

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

  • Page 115

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

  • Page 116

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

  • Page 117

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

  • Page 118

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

  • Page 119

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

  • Page 120

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

  • Page 121

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

  • Page 122

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

  • Page 123

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

  • Page 124

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

  • Page 125

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

  • Page 126

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

  • Page 127

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

  • Page 128

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

  • Page 129

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

  • Page 130

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

  • Page 131

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

  • Page 132

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

  • Page 133

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

  • Page 134

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

  • Page 135

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

  • Page 136

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

  • Page 137

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

  • Page 138

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

  • Page 139

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

  • Page 140

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

  • Page 141

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

  • Page 142

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

  • Page 143

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

  • Page 144

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

  • Page 145

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

  • Page 146

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

  • Page 147

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

  • Page 148

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

  • Page 149

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

  • Page 150

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

  • Page 151

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

  • Page 152

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

  • Page 153

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

  • Page 154

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

  • Page 155

    Administrative T asks 601354 Rev A Normal Operations 4-63 Normal Operation NO TES[...]

  • Page 156

    Administrative T asks 4-64 Normal Operations 601354 Rev A NO TES[...]

  • Page 157

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

  • Page 158

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

  • Page 159

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

  • Page 160

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

  • Page 161

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

  • Page 162

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

  • Page 163

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

  • Page 164

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

  • Page 165

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

  • Page 166

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

  • Page 167

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

  • Page 168

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

  • Page 169

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

  • Page 170

    Administrative T asks 5-14 Archiv e Operations 601354 Re v A NO TES[...]

  • Page 171

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

  • Page 172

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

  • Page 173

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

  • Page 174

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

  • Page 175

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

  • Page 176

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

  • Page 177

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

  • Page 178

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

  • Page 179

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

  • Page 180

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

  • Page 181

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

  • Page 182

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

  • Page 183

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

  • Page 184

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

  • Page 185

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

  • Page 186

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

  • Page 187

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

  • Page 188

    Administrative T asks 6-18 T roubleshoot 601354 Re v A NO TES[...]

  • Page 189

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

  • Page 190

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

  • Page 191

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

  • Page 192

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

  • Page 193

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

  • Page 194

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

  • Page 195

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

  • Page 196

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