ADIC 6-00028-01 Rev A 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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446

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 6-00028-01 Rev A. 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 6-00028-01 Rev A 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 6-00028-01 Rev A 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 6-00028-01 Rev A devrait contenir:
- informations sur les caractéristiques techniques du dispositif ADIC 6-00028-01 Rev A
- nom du fabricant et année de fabrication ADIC 6-00028-01 Rev A
- instructions d'utilisation, de réglage et d’entretien de l'équipement ADIC 6-00028-01 Rev A
- 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 6-00028-01 Rev A 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 6-00028-01 Rev A 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 6-00028-01 Rev A, 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 6-00028-01 Rev A, 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 6-00028-01 Rev A. À 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

    Mana ging the AMASS ® File System AMASS V er sion 5.3 A ugust 2002 6-00028-01 Re v A[...]

  • Page 2

    Trad emark Notice ADIC, AMASS, CentraVision, DAS, DataMgr, FileServ, and VolServ are either trademarks or re gistered trademarks of A D IC, Advanced Digital Information Corporation. All other product names and identifications are tr ademarks or registere d trademarks of their respective owners. Copyright Notice Copyright © 1996-2002 by Advanced Di[...]

  • Page 3

    ADIC includes this Form in an effort to provide the best possible documentation to our customers. Please take a few mome nts to mail or FAX your response to: ADIC Technical Public ations 8560 Upland Drive Englewood, CO 80112 FAX: 303-792-2465 Email: techdocs@adic.com Question Cir c le One Inf or mation w as complete Agree Disag ree Inf or mation w [...]

  • Page 4

    NOTES[...]

  • Page 5

    P Preface[...]

  • Page 6

    Managing th e AMASS File System P-2 Pr eface 6-00028-0 1 Rev A NO TES[...]

  • Page 7

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Preface P-3 Purpose of This Book This book describes the manageme nt tasks, commands, util ities, and troubleshooting tools used to operate AMASS and manage the AMASS file system. Who Shou ld Read This Book This book is written for the system administrators who u se the command line to operate a[...]

  • Page 8

    Managing th e AMASS File System P-4 Pr eface 6-00028-0 1 Rev A • Reading of fline media • Adding space to v olume groups • Acti v ating and inactiv ating the file system Chapter 3: C ommand Reference — Alphabetical list of AMASS commands Chapter 4: Utility Reference — Alphabetical list of AMASS utilities Chapter 5: T r oubleshooting T ool[...]

  • Page 9

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Preface P-5 Con ventions The con v entions used throughout the AMASS technical books are listed below: Con vention Example The word “li brar y” usuall y incl udes “jukebox” and “stand alone dri v e” and is a gener ic wa y to ref erenc e a storage device. If using HP SunSpot j ukebo x[...]

  • Page 10

    Managing th e AMASS File System P-6 Pr eface 6-00028-0 1 Rev A Books The CD contains the AMASS books formatted as PDF documents. The books described belo w are part of the technical documentation set: Contact Publ ications T o make corrections or to comment on AMASS publicati ons, please contact T e chnical Public ations at techdocs@adic.com. AMASS[...]

  • Page 11

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Preface P-7 Related Publ ications The publications described in the following table are created and distribut ed on an as-needed basis: Secured Web Site T o receiv e access to the secured site on the ADIC home page containing technical product in formation (Release Notes, Product Alerts, Product[...]

  • Page 12

    Managing th e AMASS File System P-8 Pr eface 6-00028-0 1 Rev A NO TES[...]

  • Page 13

    6-0002 5-01 Rev A Contents ix Contents Preface Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3 How This Book is Organized . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 14

    Accessing Storage Devices xC o n t e n t s 6-0 0025-01 R ev A Operati onal Ta sks 2 Database and Journal Backups . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3 Automatic Backups Via Cron Job . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-4 Assign Backup Volume . . . . . . . . . . . . .[...]

  • Page 15

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xi Add Space to Volume Group . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Add Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-29 Create Space Pool . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 16

    Accessing Storage Devices xii Co ntents 6-0002 5-01 Rev A amassstat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24 Shutdown Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-24 Options . . . . . . . . . . . . . . . . . .[...]

  • Page 17

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xiii Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-47 Outlet Volumes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-48 Unsuccessful Ejects . . . . . . . . . . . . . . . . . .[...]

  • Page 18

    Accessing Storage Devices xiv Co ntents 6-0002 5-01 Rev A fileonmedia . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-79 File States . . . . . . . . . . . . . [...]

  • Page 19

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xv Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-107 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-109 vgimport . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 20

    Accessing Storage Devices xvi Cont ents 6-00025-01 Rev A Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-135 Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-136 Example . . . . . . . . . . . . . . . . . . . .[...]

  • Page 21

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xvii Configure Compression . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-164 volgroup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-166 Options . . . . . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 22

    Accessing Storage Devices xviii C ontent s 6-00025-01 R ev A voloutlet . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-194 Tasks . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-194 Options . . . . . . . . . . . .[...]

  • Page 23

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xix Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-7 amass_snap . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-9 When to Use Script . . . . . . . . . .[...]

  • Page 24

    Accessing Storage Devices xx Contents 6-0002 5-01 Re v A Options . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-30 Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-31 medialist . . . . . . . . . . . . . . . . . . . .[...]

  • Page 25

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xxi dbcheck . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4 -55 When to Use Utility . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-55 Options . . . . . . . . . . . . . . . . . . [...]

  • Page 26

    Accessing Storage Devices xxii Conte nts 6-00025-01 Rev A Example . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74 Output Fields Defined . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4-74 writecachemru . . . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 27

    Accessing Storage Devices 6-0002 5-01 Rev A Contents xxiii Messages Generated by AMASS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30 Operator Interactive Messages . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5-30 Technical Support Messages . . . . . . . . . . . . . . . . . . . . . . . [...]

  • Page 28

    Accessing Storage Devices xxiv Conte nts 6-00025-01 Rev A Output . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-6 setcbwght . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . C-7 Options . . . . . . . . . . . . . . . . . . . . . .[...]

  • Page 29

    1 Initial Setup Ta s k s[...]

  • Page 30

    Managing th e AMASS File System 1-2 Initial Setup T asks 6-00028-0 1 Rev A NO TES[...]

  • Page 31

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-3 Prepare Media to be the Ba c kup V olume Running the installation script created a Backup V olume entry in the AMASS File System Data base. T o prepare media to be the specified Backup V olume, perform the steps in the follo wing table. The Backup V olume must be ident[...]

  • Page 32

    Managing th e AMASS File System 1-4 Initial Setup T asks 6-00028-0 1 Rev A 2 Ph ysical ly designa te the m edia as the B ackup V olume i n some out ward wa y . See the f ollowin g e xamples: • Wr ite the words “ Backup V olum e” on the media. • Color c ode the me dia so it can be identifi ed as a Ba ck up Vo l u m e . • Make a note of eit[...]

  • Page 33

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-5 F or networ k-attache d libraries : bulkinlet Create an entr y in the AMAS S File Sys tem Databas e. Loads volume through mailbox. AMASS : • G iv es media a uni que v olume numb er . • Mark s the volume ONLINE in th e AMAS S File System Database. • Gives this fir[...]

  • Page 34

    Managing th e AMASS File System 1-6 Initial Setup T asks 6-00028-0 1 Rev A Step Command Description Now, the V olume Label field displ ays the p repri nted num be r ( 112102 ). # vollabel V olume label printed on media V olume number assigned by bulkinlet 1 112102 # vollist VOL NUM VOL GRP JUKE NUM POS VOL LABEL FLAGS USED (MB) AVAIL (MB) DEAD (%) [...]

  • Page 35

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-7 5 volformat NO TE: N ot applic able f o r CDs . F or mat the Backup V olume. If you are usin g a sta ndalone dri v e, you must form at the volume from the sysop interface. F o r informati on on this in terface, Interface to Standal one Drives chapter in Access ing Stor[...]

  • Page 36

    Managing th e AMASS File System 1-8 Initial Setup T asks 6-00028-0 1 Rev A Create File System Organization The follo wing tasks are presented as guidelines only since the actual setup required for your specific site is u nique. Step 1. Decide how you want to or ganize the AMASS f ile system. For e xample, what directories should be under the / arch[...]

  • Page 37

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-9 Create Entries in Database for Y our Media Make AMASS aw are of your media by creating an entry for each volum e in the AMASS File System Database by performing the s teps in the fol lowing table. Note F or deta iled infor mation on the AM ASS com mands, see th e "[...]

  • Page 38

    Managing th e AMASS File System 1-10 Init ial Set up T as ks 6-00028-0 1 Rev A F or example: volinlet 33 NO TE: Not applic able f o r v olumes destined f o r librar ies without a mailbox. vgimport Impor t m etadata fil e for v olume that alre ady has d ata on it. NO TE: Must ha ve us ed vgexport to e xpor t m etadata file. volloc Mark the volume (3[...]

  • Page 39

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-11 2B F or networ k-attache d libraries : bulkinlet F or example: bulkinlet 4 Create an entr y in the AMA SS File System Database for each vo l um e. If desir ed, assign a volume to a v olume gro up (4). Load mult iple volumes th rough the mailbox. AMAS S: • Gives each[...]

  • Page 40

    Managing th e AMASS File System 1-12 Init ial Set up T as ks 6-00028-0 1 Rev A 2C bulkload F or example: bulkload -s Y ou ha ve just insta lle d AMASS and must create many ent ries i n the AM ASS File System Database a nd mar k them ONLI NE. The -s opti on synchron iz es both the AM ASS File System Database a nd the librar y’ s int erface. vollab[...]

  • Page 41

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-13 V olu me Gr oups Defin ed A volum e group is a method for partitioning the volum es in AMASS. Y ou can assign the following types of v olume groups: • Media verif ica tion group (MV) for the optional Inf inite File Life feature For mo re information abou t IFL, see [...]

  • Page 42

    Managing th e AMASS File System 1-14 Init ial Set up T as ks 6-00028-0 1 Rev A The follo wing figure ill ustrates these volume groups. Unif orm Media in Numeric and Cleanin g Gr ou ps Both numeric vol ume groups and the cleaning group must contain a homogeneous type of media. At a site using both WORM and erasable optical platters, for example, v o[...]

  • Page 43

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-15 Like wise, the cleaning group must contain volumes with uniform, dri ve-specif ic a ttrib utes. For cleaning volume groups, see “Create a Cleaning V olume Gr oup” on page 1-20. Disparate Medi a in the Space P ool The space pool can contain volume s with a v ariety[...]

  • Page 44

    Managing th e AMASS File System 1-16 Init ial Set up T as ks 6-00028-0 1 Rev A By allocating project f iles from a subdirectory to specif ic volum es, the data generated by the project can easily be added and remov ed from the library without af f ecting data generated by other projects. Or , you can m ark the v olumes OFFLINE and remov e them from[...]

  • Page 45

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-17 • The projects directory , is the root directory for v olume group 0. - If new fi les or new direct ories are added unde r archive , they belong to v olume group 0, unless you assign them to a specif ic vo lume group. • The amass_nt directory is the root directory[...]

  • Page 46

    Managing th e AMASS File System 1-18 Init ial Set up T as ks 6-00028-0 1 Rev A Instead, AMASS generates an out-of-space message, and you must assign more v olumes to the v olume group. • If ne w directories are a dded under amass_nt or production directories, they belong t o those directories’ volum e groups, either volume group 33 or 6.[...]

  • Page 47

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-19 Assign Directory to a V olum e Gr ou p T o assign an existing directory to a v o lume group and enable the volum e group to use the space pool if it runs out of space, perform the steps in t he follo wing table. Note F or deta iled infor mation on the AM ASS com mands[...]

  • Page 48

    Managing th e AMASS File System 1-20 Init ial Set up T as ks 6-00028-0 1 Rev A Create a Cleaning V olume Gr oup T o create a volume group used solely for cleaning cartridges, use the procedure in the following table. Currently the CL v olume group can contain only one type of cleaning cartridge. For example, if you ha ve both a DTF driv e and a 359[...]

  • Page 49

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Init ial Se tup Ta sks 1-21 3 volclattr Define dr ive-specifi c attri b utes to the clean ing volume (23). F or e xample: volclattr -t 6 23 4 vollist -g CL View attr ibutes for the clean ing group . Step Command Description[...]

  • Page 50

    Managing th e AMASS File System 1-22 Init ial Set up T as ks 6-00028-0 1 Rev A NO TES[...]

  • Page 51

    2 Operational Ta s k s[...]

  • Page 52

    Managing th e AMASS File System 2-2 Ope rational T asks 6-00028-0 1 Rev A NO TES[...]

  • Page 53

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operationa l Tasks 2-3 Database and Jo urnal Bac kups File Sy stem Dat abase —The File System Database contains tables of attrib utes—or metada ta—representing the directory structure and media mounted under the AMASS file system. The metadata includes: media ID, media type, media loca tio[...]

  • Page 54

    Managing th e AMASS File System 2-4 Ope rational T asks 6-00028-0 1 Rev A The Journal tells AMASS what transactions—what entries—hav e acted upon a f i le stored on a v olume in a library . It is a daily diary of logged e vents. Both the Database and Journal can be backed up automatically and manually . Both types of backups are described belo [...]

  • Page 55

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operationa l Tasks 2-5 The “full backup” (backs up the D atabase and Journal) and “partial backups” (backs up just the Journal) will allo w you to successfully restore your File System Database (and, ther efore, allo w you to know where data is located on what piece of media) if your cur[...]

  • Page 56

    Managing th e AMASS File System 2-6 Ope rational T asks 6-00028-0 1 Rev A 0 3 1 * * /usr/amass/bin/amassbackup -fv 0 3 2-31 * * /usr/amass/bin/amassbackup -v minute hour day of m onth mont h day of week Step Command Description 4 0 3 * * 0 /usr/amass/bin/ama ssbackup -fv 0 3 * * 1-6 /usr/amass/bin/ama ssbackup -v In our exam ple, we edit the file s[...]

  • Page 57

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operationa l Tasks 2-7 Manual Bac kup Manually back up the Database and Journal under the follo w ing conditions prior to: • updating your operating system • updating AMASS • making any major change to your system • replacing the hard disk on the UNIX server How to Use Back up Comma nd T[...]

  • Page 58

    Managing th e AMASS File System 2-8 Ope rational T asks 6-00028-0 1 Rev A 4 amassbackup -u As appr opriate, per f or m either a: • Full (- f) backup with the v erbos e (-v) opti on. • P ar tial ba ck up with the v erbose o ption. 5 Check the syste m log for a “Backup was successf ul” message. Step Command Description[...]

  • Page 59

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operationa l Tasks 2-9 Replace a Full Backup V olu me AMASS issues a w arning message when the Backup V olume is almost ful l. If you receiv e a “95% full” mes sage befor e a backup starts, initialize a ne w Backup V olume and perform a full bac kup as described in the follo wing table. Ho w[...]

  • Page 60

    Managing th e AMASS File System 2-10 Operational T asks 6-00028-0 1 Rev A Restore AMASS Database T o restore the AMASS File System Database and journal if the original f iles on the UNIX server becomes lost or corrupt, use the procedure in the following table. T o reco ver the A MASS Fi le Syst em Database if the da tabase becomes corrupt, see “ [...]

  • Page 61

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-11 Restore wi th Earlier AMASS V ersion T o recove r data on a Backup V olume containing a backup from an earlier version of AMASS, make sure the current MAXIOSIZE parameter on AMASS is conf igured to the same v a lue as when the Backup V olume was made. For example, your cur[...]

  • Page 62

    Managing th e AMASS File System 2-12 Operational T asks 6-00028-0 1 Rev A Reinitia lize Database T o empty the exi sting AMASS File System Database and reinitialize it, use the procedure in t he follo wing table. Caution All fil e and dir ector y entr ies as well as li brary , dri v e, and media informati on are deleted. Note F or detail ed informa[...]

  • Page 63

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-13 4 # cd # /usr/amass/utils/initamass Change direc tor y and reini tiali z e the Fi le Syste m Da tabase . CA UTION : All file and directo ry entries as well as li brary , drive, and me dia inform ation are dele ted. Step Command Description[...]

  • Page 64

    Managing th e AMASS File System 2-14 Operational T asks 6-00028-0 1 Rev A Back Up Media in Library There are a variety of ways to back up the data residing in the library . Even though a library is in volv ed, the backup issues are fundamentally the same as for hard disks. The main dif ference is the amount of data contained in the library . The so[...]

  • Page 65

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-15 This solution pro vides faster backups than if the data is accessed randomly because it requires f e wer volume swaps. W ith this solution you can do full or incremental backups. Use Redundant Media A third solution is to use a second set of media stored of fline, or outsi[...]

  • Page 66

    Managing th e AMASS File System 2-16 Operational T asks 6-00028-0 1 Rev A T ake a Drive Out of Service T o take a dri ve out of service — whe ther because of excessi ve failures or for maintenance — use the procedure in the follo wing table. If all dri ves are out of service, AMASS suspends requests until a driv e is returned to ser vice. Note [...]

  • Page 67

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-17 Return a Driv e to Service T o return a driv e to service, use the procedur e in the follo wing table. Note F or detail ed information on the command s used in thes e steps, see the "Comm and Reference" chap ter . Step Command Description 1 L og in as am ass or r[...]

  • Page 68

    Managing th e AMASS File System 2-18 Operational T asks 6-00028-0 1 Rev A Delete Files and V olume Numbe r T o delete: • All f i les on a v olume • V olume number from the AMASS File System Database Use the procedure in the following table. Note F or detail ed information on the command s used in thes e steps, see the "Comm and Reference&q[...]

  • Page 69

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-19 3B For networ k-attac hed librar ies: bulkoutlet -u F or e xample: bulkoutlet 1,2-10,21,23 Or , ej ect multiple volume s from the lib rary . AMASS m arks th e media OFFLINE i n the datab ase. Step Command Description[...]

  • Page 70

    Managing th e AMASS File System 2-20 Operational T asks 6-00028-0 1 Rev A Delete V olu me Gr ou p T o delete a V olume Group, use the procedure in the following table. Note F or detail ed information on the command s used in thes e steps, see the "Comm and Reference" chap ter . Step Command Description 1 Log in as amass or root . 2 adf -u[...]

  • Page 71

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-21 Recyc le a V olume T o perform the following tasks, use the procedure described in the table: • Mov e non-contiguous data onto other v olumes • Rec ycle v olumes Note F or deta iled infor mation on the co mmands used in the se steps, se e the "Comm and Reference&q[...]

  • Page 72

    Managing th e AMASS File System 2-22 Operational T asks 6-00028-0 1 Rev A 4 volformat vo lumenumb er F or e xample: volformat 3 Reformat t he now-empty v ol ume. NO TE: Not applica b le for CDs. 5 volstat -a vo lumenumb er F or e xample: volstat -a 3 A CTIV A TE v olume so AMAS S can re ad and wr ite to it. Step Command Descripti on[...]

  • Page 73

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-23 Remo ve Media From Library The follo wing steps describe how to remo ve a volu me after it has been written to b y AMASS. Note F or detail ed information on the command s used in thes e steps, see the "Comm and Reference" chap ter . Step Command Description 1 Whe[...]

  • Page 74

    Managing th e AMASS File System 2-24 Operational T asks 6-00028-0 1 Rev A 5C If — for some reaso n — you manually remove a volume from the l ibrary : volloc -o volumenumb er F or e xample: volloc -o 47 Mar k the volume OFFLINE( -o ) in th e AMASS Fi le Syst em Databa se. Step Command Description[...]

  • Page 75

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-25 Read Offlin e V olume Of fline Media Manager (OMM) provi des read- acce ss to volum es that hav e been rem oved from the library . These v olumes hav e a status of A CTIVE but OFF LINE in the AMASS File System Database. Optional Feature Prer equisi tes T o access offline m[...]

  • Page 76

    Managing th e AMASS File System 2-26 Operational T asks 6-00028-0 1 Rev A • Use the Standalone Operator Interface to monitor load requests. For information on this int erface, see “sysop” on page 3-93 . Read Offline V olumes The follo wing steps describe how to read an of fline volume: Note F or detai led inf ormatio n on t he c omman ds u se[...]

  • Page 77

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-27 The syso p int erfac e us ed b y OMM c reates a /tmp/sysop.out f ile that contains en tries similar t o those show n in the followi ng example. A customer can link their o wn functions into O MM to perform additional processing on each mount call by using either the s ysop[...]

  • Page 78

    Managing th e AMASS File System 2-28 Operational T asks 6-00028-0 1 Rev A Return Media W ithout Star ting AMASS T o return media in a dri ve to its home storage slot without starting AMASS, perform the steps in the follo wing table. Note F or deta iled inf ormatio n on th e com man ds us ed i n thes e steps , see t he "Co m ma nd Re f erence&q[...]

  • Page 79

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-29 Add Space to V olume Gr oup T o add space to a volume group so AMASS can continue to write to the volume group, do one of the follo wing: • Add v olumes to the v olume group. • Create a space pool and ena ble the v olume group to use the space pool so AMASS can automat[...]

  • Page 80

    Managing th e AMASS File System 2-30 Operational T asks 6-00028-0 1 Rev A Create Space P ool Step Command Description 1 Log in as amass or root . 2 volgroup volumenumb er SP F or e xample: volgroup 24 25 SP Assi gn a f or ma tted v o lume to the spa ce pool. V o lume num bers 24 and 25 are assi gned to the space pool. 3 vgpool -e vol ume gro up F o[...]

  • Page 81

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-31 Reassign V olume Group T o reassign ne w files in the amass_nt directory , as illust rated in the follo wing figure, to another volum e group, use the procedure in the following table. Note F or detail ed information on the command s used in thes e steps, see the "Com[...]

  • Page 82

    Managing th e AMASS File System 2-32 Operational T asks 6-00028-0 1 Rev A Step Command Description 1L o g i n a s amass or root . 2 vollist -g vol um egr ou p F or e xample : vollist -g 33 List the volumes in a volume group (33). The outpu t lists volumes 2 and 4 in volume group 33 . 3 vgroot vol ume gr ou p F or e xample : vgroot 33 List the root [...]

  • Page 83

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-33 Activate the File System T o activ ate the AMASS file system, which allo ws AMASS file system fil es to be accessed, use the proce dure in the follo w ing table. Inactiv ate the File System T o deacti v ate the AMASS f ile system, which allo ws you to perform maintenance w[...]

  • Page 84

    Managing th e AMASS File System 2-34 Operational T asks 6-00028-0 1 Rev A 2 amassstat -u For e xa mple: amassstat -i -t 600 AMASS i nactivate in 600 secon ds, 10 m inutes. INACTIV A T E the AM ASS fil e system. AMASS ge ner ates an er ror if a client attempts to ac cess file s while th e file sy stem is INACTIVE. If files were waiting in the cache [...]

  • Page 85

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-35 Modify Conf iguration File Change the AMASS library confi guration in response to the follo wing circ umstances if you: • change a library’ s SCSI or RS-232 address • upgrade or do wngrade a library to a dif ferent model or vendor and you receiv e a ne w authorizatio[...]

  • Page 86

    Managing th e AMASS File System 2-36 Operational T asks 6-00028-0 1 Rev A Step Command Description 1L o g i n a s amass or root . 2 sysperf [ upda teint erv al ] T o m ake sure there ar e no pending w rite requests in the AM ASS que ue, view the queue with the sysperf comman d. Log i n as root and en ter the command as shown in t he following steps[...]

  • Page 87

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Operational Tasks 2-37 MAXIOSZ Changes If you want to change the MAXIOSZ , perform the follo w ing steps: Step Command 1 Log in as amass or root . 2 Remov e your current B ackup V olume (containi ng a backup of the AMA SS File S ystem Da tabase and transaction file) from the l ibrar y , label it[...]

  • Page 88

    Managing th e AMASS File System 2-38 Operational T asks 6-00028-0 1 Rev A NO TES[...]

  • Page 89

    3 Command Ref erence[...]

  • Page 90

    Managing the AMA SS File System 3-2 Co mmand R eference 6-00028-0 1 Rev A NO TES[...]

  • Page 91

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3- 3 Commands The commands described in this chapter are located in the directories listed in the follo w ing table. Specify this path in the system admi nistrator’ s login PATH variable. Synt ax The command syntax is the same as standard UNIX style commands. The options sho[...]

  • Page 92

    Managing the AMA SS File System 3-4 Co mmand R eference 6-00028-0 1 Rev A Return Code Des cription -1 error all other values succ ess[...]

  • Page 93

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3- 5 adf V iew statistics for all v olume groups in the AMASS File System Database. Options /usr/amass/bin ./adf [-u] [-hrV] Option Descript ion -h Display a mess age desc ribin g the ou tput -r (defaults to list t he first pa th encounter ed in the Database) View all relati v[...]

  • Page 94

    Managing the AMA SS File System 3-6 Co mmand R eference 6-00028-0 1 Rev A Exam ple Step 1. Log in as either amass or root . Step 2. See an example of the output in the follo wing illustration: Output Fie lds Defined The follo wing fi elds are generated by this command. # su root # adf -r Volume Group Size Used Avail Volumes Rooted On ------------ -[...]

  • Page 95

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3- 7 A vail Amount of space, in MB, a vaila b le in this v olume gro up V ol umes Number of volumes as signed t o this volume gro up Rooted On Directo r y assigne d to this volume group Field Descript ion[...]

  • Page 96

    Managing the AMA SS File System 3-8 Co mmand R eference 6-00028-0 1 Rev A amassbackup Back up to a Backup V olume in either a library or a standalone dri ve the follo wing f iles: • File System Database ( /usr/filesysdb ) • Journal (/ usr/filesysdb/journal ) While the backup is being completed, the Database is locked. Therefore, client re ques [...]

  • Page 97

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3- 9 Prerequisites Before using this command, use the vollis t c ommand to make sure the Backup V olume has th e followin g characteristics: • V olume number 1 • Formatted (not marked “U” for unformatted) • Ina cti ve “I ” status •I n t h e last home storage sl[...]

  • Page 98

    Managing the AMA SS File System 3-10 Command R eference 6-00028-0 1 Rev A Exam ple Step 1. Log in as either amass or root . Step 2. T o perform a full bac kup to a v olume with v erbose information, enter the follo wing options: Op tion Defi nition For libr aries onl y: no options Pe r f o r m a pa rt ial ba ck up; back up ju st the Jour nal fi le [...]

  • Page 99

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-1 1 Addit ional Inform ation For more information, see “Databa se and Journal Backups” on page 2-3.[...]

  • Page 100

    Managing the AMA SS File System 3-12 Command R eference 6-00028-0 1 Rev A amassrepor t Report f ile system information. The follo w ing types of reports can be generated: • F o rmatted Column titles are printed at the top of each page. • Raw Although titles a re not printed, data appe ars in the sam e sequence as found in the forma tted re port[...]

  • Page 101

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-1 3 Options Last Modi fied Date an d time showin g date the fi le was last mod ified V ol File is l ocated on this volume number T opics Description /usr/amass/bin ./amassreport [-dfPRS] [-a date time ] [-e errnumber ] [-g gid ] [-L lengt h ] [-l date time ] [-m mode ] [-n n[...]

  • Page 102

    Managing the AMA SS File System 3-14 Command R eference 6-00028-0 1 Rev A Option Descript ion no options Gene rate f orm atted repo r t -d Only li st dire ctories -f Only l ist file s -P List fil es with an absolute path, star t ing from mou nt point. For example, /archive/pubs/amass/v49/fileA -R Generate raw repor t -S Displays in the La st Access[...]

  • Page 103

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-1 5 -e errnumber -e “< errnumber ” -e “> errnumber ” Only l ist files t hat have a: • Specif ied err or number . Ent er fo r examp le, -e 49 to select all files with an error of 49. • Lo wer or higher error number . Enter a string that con tains less than ([...]

  • Page 104

    Managing the AMA SS File System 3-16 Command R eference 6-00028-0 1 Rev A -m mode List only those f iles having one of the following per missio n IDs: • rwxrwxrwx • r--r--r-- • rwxr-xr-x -n name -n “ * name ” Only l ist files t hat have a: • Specif ic name • Specif ic group of letters some where in the name. Enter a s tring that conta[...]

  • Page 105

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-1 7 Exam ple Step 1. Log in as either amass or root . Step 2. Enter the following options to see f ile access and modif ication times in seconds : Step 3. See an example of the output for the LAST MODIFIED and LAST A CCESSED in sec onds since 1970 in the follo wing illustrat[...]

  • Page 106

    Managing the AMA SS File System 3-18 Command R eference 6-00028-0 1 Rev A Step 5. See an ex ampl e of the dates output in the follo wing illustration: NAME FILEID P ARENT UID GID LA ST MODIFIED LA ST A C CESSED MODE V OL SIZE fna me 6084 30 1 Sept 16 08:44 Sept 16 08:44 -rw-- ----- 4 85899345 9[...]

  • Page 107

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-1 9 amassrestore Restore from a Backup V olume loca ted in either a library or a standalone dri ve t he follo wing f iles: • File System Da tabase • Journal Options Caution Do no t us e this co mmand when AMASS is runni ng. T o shutd own AMASS, refer to the Site-Spec ifi[...]

  • Page 108

    Managing the AMA SS File System 3-20 Command R eference 6-00028-0 1 Rev A Op tion Defi nition -t View files on the Backup V olume Does not resto re an y files -u Usage st atement -v V er bose messages -e date time Restore files from t he Backup V ol ume with a timest amp eq ual to a spe cified date and time . F orm at is MM/ DD/YYYY hh:mm:s s. The [...]

  • Page 109

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-2 1 Exam ple Step 1. Log in as either amass or root . Step 2. Inactiv ate the AMASS f ile s ystem with the follo wing command: Step 3. Check the integrity of the file syst em by running the UNIX fsck command. For bar code-reading librari es: -L label Enter th e prepr inted a[...]

  • Page 110

    Managing the AMA SS File System 3-22 Command R eference 6-00028-0 1 Rev A Step 4. Make sure the Backup V olume is in the cor rect driv e in the library . If there is another volume in the dri ve, return it to its home slot b y using the follo wing utility . where: Step 5. Restore the File System Database and Journal by entering the follo wing optio[...]

  • Page 111

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-2 3 where: V alue Description -v V erbos e messa ges -d /dev/rst12 Backup V o lume is on t his standal one drive -L 12N6J P reprin ted barcode[...]

  • Page 112

    Managing the AMA SS File System 3-24 Command R eference 6-00028-0 1 Rev A amassstat V i e w and change the current status—Activ e or Inactiv e —of AMASS. Shutdown T asks Prior to shutting do wn, AMASS performs the following tasks : • Pre ve nts ne w f iles from being opened • W aits f iv e minutes (default) to a llo w all files to close - I[...]

  • Page 113

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-2 5 Options /usr/amass/bin ./amassstat [-uy] [-acfisvw] [-f -t secon ds ] Op tion Defi nition no options View the status of AMASS When AM ASS a sks if you want to togg le the st atus, type y for yes and n for n o. -a Activate AMASS -c View status, on ly -f F orce AMA SS to i[...]

  • Page 114

    Managing the AMA SS File System 3-26 Command R eference 6-00028-0 1 Rev A -w Inactivate AMASS NO TE : Cl ients read from open files, only . -y Suppres s interactive mess ages but retur n a code as defined below: •0 = A c t i v e •1 = I n a c t i v e Op tion Defi nition[...]

  • Page 115

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-2 7 astats V i e w the status and attributes of the library , driv es, and media. /usr/amass/utils ./astats [-chjuvw] [-A] [-s seconds ] Op tion Defi nition no options Lists the number of librar ies co nfigured, the number o f drives, the media suppor ted, the volume ID of t[...]

  • Page 116

    Managing the AMA SS File System 3-28 Command R eference 6-00028-0 1 Rev A Exam ples The follo wing exam ples show the output generated by the command with v arious options to obtain information and st atus of the libraries configured al ong with the dri ves and media supported. The output indicates the number of libraries, number of drives. type of[...]

  • Page 117

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-2 9 The follo wing output is generated when the astats command is run with the -c option: Stat e De vic e Stat us Fl ags: • Admi nJob - do admin job pointed to by ad mjob • Assig ned - ne xt job already assi gned • Clean-Bus y - sysreq is servicing a d ri ve clean a nd[...]

  • Page 118

    Managing the AMA SS File System 3-30 Command R eference 6-00028-0 1 Rev A astat s -c Out put Fields Defined The follo wing output is generated when the astats command is run with the -j option. # su root # astats -c Library Drive Type Volume State 1 1 Tape 3 UnAvailable,InUse,Writing , Conf igBlkSiz,Con f igComprs,SI O-OK Fields Desc ription State [...]

  • Page 119

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-3 1 astats -j Output Fields Defined The follo wing output is generated when the astats command is run with the -v option. Fields Descript ion State Lib rary System Flags: • AsyncEjectSupport - s upport for asynchronous eject • BackingUp - a backup is in pro gress • NoR[...]

  • Page 120

    Managing the AMA SS File System 3-32 Command R eference 6-00028-0 1 Rev A astat s -v Out put Fields Defined The follo wing output is generated when the astats command is run with the -w option. Fields Descripti on State V olume Sy stem Flags : • AsyncEjectDone - eject of v olume f inished • AsyncEjectPending - eject of volume started • AsyncE[...]

  • Page 121

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-3 3 astats -w Output Fields Defined Fields Descript ion State Device I/O mode f lags: • BlankSearch - search for blank write mo de • EraseWrite - erase befo re write mode • IFL-ExtendedStatus - g et log sense data after each I/O • IFL- Sup pr esse d Logg ing - su ppr[...]

  • Page 122

    Managing the AMA SS File System 3-34 Command R eference 6-00028-0 1 Rev A b ulkinlet Load multiple v olumes through the mailbox and mark online. This command is only v alid for multislot mailbox libraries. Netw ork Libraries This command is v alid for the follo wing network-attached librar ies: • ADIC AML • IBM 3494 • Storage T echnology T as[...]

  • Page 123

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-3 5 Options Note F or trac king purposes , AMASS assi gns each new volume a uni que v olume num ber . Tip T o c reate File S ystem Dat abase entr ies for v olumes already residing in the lib rary (bypass the ma ilbox), use the bulk load comm and. /usr/amass/bin ./bulkinlet [[...]

  • Page 124

    Managing the AMA SS File System 3-36 Command R eference 6-00028-0 1 Rev A Load New V olumes Step 1. Log in as either amass or root . Step 2. Place volumes in the mailbox. Step 3. Enter the command as sho wn in the followi ng illustration. In our e xample, all the vol umes are assigned to volum e group 101. AMASS assigns a unique volume number to ea[...]

  • Page 125

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-3 7 Step 4. All ne w volumes in the Fil e System Database hav e an initial status of unformatted (U) and inactiv e ( I). T o further prepar e the volumes so AMASS can read or write to them, use the commands listed in the follo wing table. SCSI, M ultislot Libr aries The foll[...]

  • Page 126

    Managing the AMA SS File System 3-38 Command R eference 6-00028-0 1 Rev A Unsuccessful L oads If you attempt to load se veral v olumes at one time and one v olume fa ils to load, AMASS will not load the rema ining volum es after the first failure. F or example, if you load volum es 1 through 6 and vol ume 3 is unsuccessful, AMASS successfully loads[...]

  • Page 127

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-3 9 Reload Existing V olumes Step 1. Log in as either amass or root . Step 2. Place seve ral v olumes in the multislot mailbox. volumenumb er Enter the uni que volume number s you w ant t o unload fr om the librar y an d mar k Online i n the Database. T o li st more tha n on[...]

  • Page 128

    Managing the AMA SS File System 3-40 Command R eference 6-00028-0 1 Rev A Step 3. Enter the command as sho wn in the followi ng illustration. In our e xample, we reload three vol u me s . The picker reads the barcode and returns the volumes to their home storage position. # bulkinlet -e 126, 134, 137[...]

  • Page 129

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-4 1 b ulkload Suppor ted Netw ork Libraries This command is v alid for the follo wing network-attached librar ies: • ADIC AML • IBM 3494 • Storage T echnology T asks The follo wing tasks are v alid only for network-attached librar ies: Create entrie s and mark v olumes[...]

  • Page 130

    Managing the AMA SS File System 3-42 Command R eference 6-00028-0 1 Rev A For tracking purposes, AMASS assigns each v olume a unique volum e number . Librar y Interfaces AMASS manages the network-a ttached libraries through the library inte rfaces liste d in the follo wing tabl e. For spe cifi c library information, refer to Acce ssing Stor age Dev[...]

  • Page 131

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-4 3 Option Descript ion no options Create e ntri es and mar k multiple volumes Online in the F ile Sy stem Da tabase base d on an inventor y of the librar y -s NO TE: Us e this option if you hav e not recently upd ated the librar y’s interface. Besides creating entri es an[...]

  • Page 132

    Managing the AMA SS File System 3-44 Command R eference 6-00028-0 1 Rev A Create Entries f or Existing V olumes Y ou have just i nstalled AMASS b ut your library already contains media known to your library’ s interface D AS. Y ou must “introduce” this exis ting media to the File System Database by performing the following procedure: Step 1. [...]

  • Page 133

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-4 5 Manually Load New V olumes Introduce ne w v olumes to both the File Syst em Database and to the library interface by performing the follo wing procedur e: Step 1. Make sure the po wer is of f . Step 2. Log in as either amass or root . Step 3. Manually load media direc tl[...]

  • Page 134

    Managing the AMA SS File System 3-46 Command R eference 6-00028-0 1 Rev A Step 6. New v olumes in the Database ha ve an initia l status of unformatted (U) a nd inacti ve (I). T o make the ne w v olumes usable, de fi ne attrib utes and initialize the media with the co mmands listed i n the follo wing table: Command Characteristi c v ollabe l En ter [...]

  • Page 135

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-4 7 bul k o u tl e t Eject multiple v olumes to the mailbox and mark of f-line. This command is v a lid for mutualist mail box libraries only . This command is v alid for the follo wing network-attached librar ies: • ADIC AML • IBM 3494 • Storage T echnology T asks The[...]

  • Page 136

    Managing the AMA SS File System 3-48 Command R eference 6-00028-0 1 Rev A Outlet V olumes Step 1. Log in as either amass or root . . Step 2. See the following e xa mple: a total of 12 volum es—1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 21, and 23—are ejected from the library . Step 3. Remove the volumes from the mailbox. Option Descri ption -u Usage s tate[...]

  • Page 137

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-4 9 Unsuccessful Eje cts If you attempt to eject se veral volumes at one time and one vo lume fails to e ject, after the f irst failure, AMASS will not eject the rema ining v olumes. For e x ample, if you eject v olumes 1, 2, 3, 4, and 5 and volume 3 is unsuccessful, AMASS s[...]

  • Page 138

    Managing the AMA SS File System 3-50 Command R eference 6-00028-0 1 Rev A cdimpor t Import data from CDs forma tted by the standards prescribed by: • High Sierra • ISO 9660 • Rockridge (an ISO 9660 format with extensions) Optional Featur e Pre vent Mount of Inter nal CD Drive T o pre vent the serv er from mounting an internal CD dri ve, perfo[...]

  • Page 139

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-5 1 Solar is Step 1. Use the UNIX vi editor or a similar produ ct to edit the /etc/vold.con f f ile. Step 2. Comment out the internal CD driv e entry as shown in the follo wing illustration. The entry with the asteri sk in the name id entif ies the internal CD dri ve. Replac[...]

  • Page 140

    Managing the AMA SS File System 3-52 Command R eference 6-00028-0 1 Rev A Step 3. Reboot the SGI machine fo r the changes to take effect. Options # /dev/scsi/ sc3d5l0 /CDROM iso9660 mon=off 00 # /dev/scsi/ sc3d4l0 /CDROM2 iso9660 mon=off 00 # /dev/scsi/ sc3d1l0 /CDROM4 iso9660 mon=off 00 /usr/amass/bin ./cdimport [-uv] [-lLrRU] [-n userlable ] [-p [...]

  • Page 141

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-5 3 Exam ple Step 1. Log in as either amass or root . Step 2. Create a direc tory (for example, cdpubs ) under the AMASS mount point (def ault is / archive ) for the f iles on the CD. -R (defaults to Read -Onl y) Mar k the volume group available f o r both Reads an d Write s[...]

  • Page 142

    Managing the AMA SS File System 3-54 Command R eference 6-00028-0 1 Rev A Step 3. Use the A MASS vo ln ew command to crea te an entry in the Fi le System Databa se fo r the CD. AMASS assigns the CD a unique volume number (49) and asks for confirmation of the process. Your response in bold is shown in the following illustration: Step 4. Use the cdim[...]

  • Page 143

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-5 5 If this operation is unsuccessful, the CD may be left in the drive. If this happens, manually remove the CD.[...]

  • Page 144

    Managing the AMA SS File System 3-56 Command R eference 6-00028-0 1 Rev A dirfilelist V i e w , recursiv e ly , files under a directory , one entry per line. Options /usr/amass/bin ./dirfilelist [-uv] [-h] [ path ] Option Descript ion StorageT ek drives: -h View star t o f the file’s block address as a hexadecimal value en closed in par ent hes e[...]

  • Page 145

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-5 7 V erbose Exam ple The follo wing example assum es we: • Use Storage T echnology driv es (-h) • W ant to se e the absolute path for all the f iles (-v) • W ant to vie w all files under the / archive / prodcode directory Nonv erb ose Ex ample The follo wing example a[...]

  • Page 146

    Managing the AMA SS File System 3-58 Command R eference 6-00028-0 1 Rev A • W ant to vie w all the files under the / prodcode directory Output Fie lds Defined The follo wing fi elds are generated by the v erbose option: # su root # dirfilelist /prodcode /prodcode /prodcode/ntsave ~ 0 0 Directory name File name Zero designates a directory Logical [...]

  • Page 147

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-5 9 TIME F orm at The Access_time and Modif ied_time v alues hav e the following format: yyyymmddhhmmss . F or e xam ple, t he v alu e 19980307114408 = 1998, March 07, 11:44:08 a.m. This format allo w s you to sort b y time, which is usef ul when creating a list of f iles cr[...]

  • Page 148

    Managing the AMA SS File System 3-60 Command R eference 6-00028-0 1 Rev A # cd /archive/accting # dirfilelist . | sort -n +1 +2 | awk ’ {print $1} ’ | cpio -oc | (cd /archive/fian; cpio -icdvum) Lists files. The cd command insures the data will go to the correct s ource director y . Backs up the files. T o speed up the backup process, we use t[...]

  • Page 149

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-6 1 driveclean Mount a cleaning volume in a tape dri ve, clean the driv e , and eject the cleaning volume. Prerequisites T o prepare for tape drive cleaning, p erform the following steps: Step 1. Assign a cleaning volume to the cleaning group (CL) with the vol n ew command f[...]

  • Page 150

    Managing the AMA SS File System 3-62 Command R eference 6-00028-0 1 Rev A Options Exam ple Step 1. Log in as either amass or root . /usr/amass/bin ./driveclean [-uy] [-V vol u menu mber ] [ driv enumber ] [ jukeboxn umb er ] Option Descript ion -u Usage st atement -y Suppres s interacti v e message s -V volumenumb er Enter the un ique volume numbe [...]

  • Page 151

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-6 3 Step 2. Assign a cleaning volume to the cleaning group. For SCSI-attached storage devices, use the vo ln ew command. For network-attache d storage devices, use the b ulkinlet co mman d. where: AMASS assigns thi s media a unique volum e number, for example, 49. Step 3. De[...]

  • Page 152

    Managing the AMA SS File System 3-64 Command R eference 6-00028-0 1 Rev A where: Step 4. T o view t he current attributes of our cleaning volum e and verify that we ha v e done this ex ercise correctl y , use vollist with the -g option to vie w the attributes of the cleaning group. Cleaning volumes must be: unformatted “U,” Inactive “I,” an[...]

  • Page 153

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-6 5 Step 5. Standalone driv e only: Because we are using a standalone driv e, we ne ed to run the Standalone Operator Inter face so enter the comm and in the follo wing illustration. For more information about this interface , Interface to Standalone Drives chapte r in Acces[...]

  • Page 154

    Managing the AMA SS File System 3-66 Co mmand Reference 6-0002 8-01 Rev A The drive ejects the cleaning volume afte r the specified amount of time (120 seconds in our example) has elapse d. To exit the sysop interface, use <Control-C>. Step 8. After clea ning, use the AMASS drivesta t -a driv enumb er c ommand to reacti v ate the dri ve. AMAS[...]

  • Page 155

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-6 7 ADIC Scalar 1000 AMASS does not support automatic dri ve cleaning on the ADIC Scalar 1000 with firmw are earlier than lev el 2.10. Consequently , the Cleaning Mode must be disabled as follows: Step 1. From the operator panel, enter the Main menu by pressing Escape . Step[...]

  • Page 156

    Managing the AMA SS File System 3-68 Co mmand Reference 6-0002 8-01 Rev A drivededicate Dedicate a driv e ’ s use to one of the follo w ing: • Write-Only • Read and Write Options Tip If your clie nt applicati ons use many write- intensive appli cations, dedicati ng a dr iv e to Write- Only may improve perf or mance. /usr/amass/bin ./drivededi[...]

  • Page 157

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-6 9 -d Dedicate the dr ive f or W rit e-Only requ ests NO TE: If al l drives in the lib rary are mar ked as Wri te-Only , AM ASS arbitrar ily pi ck s a dr ive f o r read re quests. -n Mar k the dr ive f or bo th read an d write request s -u Usage st atement -y Suppres s inte[...]

  • Page 158

    Managing the AMA SS File System 3-70 Co mmand Reference 6-0002 8-01 Rev A drivelist V i e w condition and err ors for dri ves. Options /usr/amass/bin ./drivelist [-uy] [ driv enumber ] [ jukeboxn umb er ] Option Descript ion no options View co ndition o f all dr ives in all l ibrarie s -u Usage st atement -y Suppres s interacti v e message s driv e[...]

  • Page 159

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-7 1 Reset to Ze ro Use the setdrverr command to reset the error counts reported by the dri velist command to zero. For syntax, see “setdrverr” on page 3-86. Exam ple Foll ow ing is an example of output generated b y this command to obtain status on library number 3, whic[...]

  • Page 160

    Managing the AMA SS File System 3-72 Co mmand Reference 6-0002 8-01 Rev A Status Drive stat us: • A = Acti ve dri ve used by AMASS • I = Inacti ve d ri ve no t currently u sed by AMASS • D = Dri ve d edicated to writes reques ts Errors Number o f errors on th e dri v e NO TE: Dr ives that have e x cessive error s should b e taken offline f o [...]

  • Page 161

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-7 3 drivestat V i e w and cha nge the status of driv es. Options Note If media i s in a dr ive when you INA CTIV A TE the d rive, AMASS retur ns the volume to i ts home stora ge slot. /usr/amass/bin ./drivestat [-uy] [-e secs drivenumber ] [-a driv enumber ] [-i driv enumber[...]

  • Page 162

    Managing the AMA SS File System 3-74 Co mmand Reference 6-0002 8-01 Rev A Output E xamples Foll o wing is an example of output generated b y using no options: IDLETIME The IDLETIME parameter—configured during AMASS installation—def ines the length of time in seconds a dri v e will remain idle before AMAS S will remo ve tape m edia from the dri [...]

  • Page 163

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-7 5 The idle ej ect drivestat -e s ecs driv enumb er c ommand will ov erride the global IDLETIME setting on a per dri ve basis. The follo w ing f igure illustrates ho w both the global IDLETIME parameter and the per dr i ve drivestat command option af fects your driv es: T o[...]

  • Page 164

    Managing the AMA SS File System 3-76 Co mmand Reference 6-0002 8-01 Rev A Output E xamples Foll ow ing are examples of output generated b y the idle eject option. Eject V alue for A Dr ive In the follo wing example, we set the tape dri ve to eje ct idle volum es after 480 seconds: Eject V alue for All Dr ives In the follo wing example, w e set the [...]

  • Page 165

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-7 7 Disable F eature f o r A Drive-Succeed s In the follo wing e xample, we set the dri ve to zero time out; the idle ej ect featur e will be di sable d for the specified driv e. Disable F eature f o r A Drive-F ails In the follo wing e xample, we set the dri ve to zero time[...]

  • Page 166

    Managing the AMA SS File System 3-78 Co mmand Reference 6-0002 8-01 Rev A View Current V a lues T o vie w a list of current v alues, enter a question mark ( ? ): # drivestat -e “?” all DRIVE JUKE IDLETIME 11 480 210[...]

  • Page 167

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-7 9 fileonmedia Reports whether a file has been completely stored on media. Options /usr/amass/bin ./fileonmedia [-uv] [ filename ] Option Description -u Usage statemen t -v V erb ose m essag es fil en a m e Enter the fu ll path to file you want inform ation on. For e x ampl[...]

  • Page 168

    Managing the AMA SS File System 3-80 Co mmand Reference 6-0002 8-01 Rev A File Stat es A f ile in the AMASS f ile system can ha ve the fol lo wing stat es: Example s Foll owing are e xamples of the output generated by using the fileonmedia command: State Desc ription Located The file is totall y stored on media, the re are n o dir ty cache blo cks [...]

  • Page 169

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-8 1 healthchec k T est sev eral AMASS components. The command does not correct any malfunction that it encounters, it just advises you that a test failed. Options Note Run the healthcheck co mmand on a q uiescen t system , otherwis e the tests may f ail be cause o f a lack o[...]

  • Page 170

    Managing the AMA SS File System 3-82 Co mmand Reference 6-0002 8-01 Rev A Option Description -i T est integrit y of the Dat abase using the dbcheck utility . F or informa tion on this utili ty , see “d bcheck” on page 4- 55. T o p re vent requests f rom usi ng the Databa se while A MASS is runnin g this tes t, the Databa se is locked. AMAS S tr[...]

  • Page 171

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-8 3 Option Descri ption -f path T est the fi le transfer procedure. • Enter the absolute path (beg inning with the mount point) of the file y ou want AMASS to use for this test. F or examp le, /archive/test/ jasonfile . • The vo lume where the file r esides must be Onlin[...]

  • Page 172

    Managing the AMA SS File System 3-84 Co mmand Reference 6-0002 8-01 Rev A Exam ple Step 1. Log in as either amass or root . Step 2. The following e xa mple runs all of the tests. If a test fails AMASS will continue running the other tests ( -C ). A summary report ( -s ) is returned to the screen. (continue d) -l juke boxn umbe r driv enumb er volum[...]

  • Page 173

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-8 5 Step 3. An example of a summary report ( -s ) generated by this command is sho wn in the follo wing illustration. --- healthcheck summary --- dbcheck was successful. library was successful. file transfer was successful. read 10485760 bytes in 39 seconds. write resources [...]

  • Page 174

    Managing the AMA SS File System 3-86 Co mmand Reference 6-0002 8-01 Rev A setdrverr Resets the error counts to zero repor ted b y the dr i velist command. Options /usr/amass/bin ./setdrverr [-uy] [ jukeboxn umb er ] [ driv enumber ] Option Descript ion -u Usage st atement -y Suppres s interacti v e message s juke boxn umbe r (defaults to 1) Enter t[...]

  • Page 175

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-8 7 setv olerr Resets the error counts to zer o reported by the v ollist comma nd. Options /usr/amass/bin ./setvolerr [-uy] vol u menu mber [ jukeboxn umb er ] Option Descript ion -u Usage st atement -y Suppres s interacti v e message s volumenumb er Reset erro r counts on t[...]

  • Page 176

    Managing the AMA SS File System 3-88 Co mmand Reference 6-0002 8-01 Rev A setv olgrp Assign direc tories and subdire ctories to a specif ied vo lume group. This assignment allo ws you to restrict the a llocation of space for the direct ory and its subdirectories to a specified set of vol u me s . The process recursiv ely descends through the specif[...]

  • Page 177

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-8 9 [-f] path vol umegroup Option Description -f F orce the assignm ent of new files to a specifi ed volume group, e ven if ther e are e xisting files under th e path tree. NO TE: This option work s only six lev els deep.Therefore, run it as many times as nece ssar y . -u Us[...]

  • Page 178

    Managing the AMA SS File System 3-90 Co mmand Reference 6-0002 8-01 Rev A Initial File System Step 1. See the follo wing figu re, which illustrates an initia l f ile system. All directories and fil es are in volume group number 0, which is the def a ult v olume group. Assign New Director y to V olume Group T wo Step 2. Log in as either amass or roo[...]

  • Page 179

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-9 1 The following figure shows that all new subdirectories or files created unde r the amass_nt directory belong to volume group 2. Assign Any New Files to V olume Group On e Step 5. T o assign any “new” f iles under the / archive/projects/amass_unix directory to volum e[...]

  • Page 180

    Managing the AMA SS File System 3-92 Co mmand Reference 6-0002 8-01 Rev A The -f option is used beca use there are exis ting files under the amass_unix directory and we want to “force” all new f iles to belong to volum e group 1. V olume Group 1 aix Any “new” files created under /archive or /archive/projects are assigned to v olum e group 1[...]

  • Page 181

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-9 3 sysop System administrators must use the Standalone Operator Interfa ce to ha ve full re ad-access and write -access to media i n standalone dri ves. The standalone driv e must be daisy-cha ined to a library . AMASS conside rs multiple standalone dri ves as one virtual l[...]

  • Page 182

    Managing the AMA SS File System 3-94 Co mmand Reference 6-0002 8-01 Rev A Ta s k s Use the Standalone Inte rface for the follo wing tasks: • All management operations for the AMASS f ile system • I/O requests • Back up the File System Database with the amassb ackup command -l En ab le e xternal prog ram -f fil en a m e Log inform ation to spe[...]

  • Page 183

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-9 5 Running the Interface Run the Standalone Interface from either a standar d shell tool windo w or basic ASCII terminal. Normally , the interf ace is run from one window or terminal while AMASS is run from another window or terminal. T o run the Standalone Interface, perfo[...]

  • Page 184

    Managing the AMA SS File System 3-96 Co mmand Reference 6-0002 8-01 Rev A Step 3. The interface prompts you to load a volume into a specific dri ve. The prompt always specif i es a volum e number , a volume side, and the v olume label. For e xample, if a request requires you to load side A of v olume number 2, te xt similar to the follo wing appe a[...]

  • Page 185

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-9 7 sysperf V i e w AMAS S I/O acti vity . T o exi t this program, use <Control-C>. Options /usr/amass/bin ./sysperf [-cku] [-f filename ] [ updateinterval ] Option Description -c Display cache block que ue informa tion -k Displ a y kernel inf ormation -u Usage s tatem[...]

  • Page 186

    Managing the AMA SS File System 3-98 Co mmand Reference 6-0002 8-01 Rev A Exam ple Output from the sysperf comma nd is sho w n in the foll o wing table: # su root # sysperf 5 -k -c SYSTEM STATISTICS - Mon Feb 2 10:04:40 UPDATE INTERVAL - 5 SEC AVERAGE THROUGHPUT - 9216 KBYTES/SEC READ REQUESTS # OF VOLUMES 0 0 WRITE REQUESTS # OF VOLUME GROUPS 111 [...]

  • Page 187

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-9 9 Output Fie lds Defined The follo wing fi elds are generated by this command: Fields Descri ption Update Inter v al Ho w o ften, in seconds, AMASS upd ates the scr een A verage Throug hput Num ber of KB transferred since th e last snapsho t. This value first ap pears a s [...]

  • Page 188

    Managing the AMA SS File System 3-100 Comma nd Refere nce 6-00028-01 R ev A V olFlags F or mo re in forma tio n, see “V olF lags Defined” on page 3-1 02. Status of v olum e: • A = A c tive vo l um e u se d by A MA SS • C = V olume is being v olcomped or a vo lcomp proced ure has abo rted • I = Inacti ve volu me not currently u sed by AMAS[...]

  • Page 189

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-101 Fields Descript ion Appears onl y if the -k opt ion is used: Cache B locks • T otal = total number of cache blocks • Free = number of cache blocks a vailable • DIR TY_BLOCKS = number of cache b locks filled with data that has not yet written to the media NFNODES ?[...]

  • Page 190

    Managing the AMA SS File System 3-102 Comma nd Refere nce 6-00028-01 R ev A V olF lags Defin ed The follo wing table describes the Acti ve, Inacti ve, Online, and Of fline v alues a volume c an ha ve in t he V olFlags fi eld: Online O = Of fline A = Active Vo l u m e i s in librar y . AMASS can read and wr ite to volume. Vo l u m e i s not in libr [...]

  • Page 191

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-103 tapelength Define the length of unformatted tape to the F ile System Database for the Stora ge T e chnology Redwood SD-3 dri v e. Options /usr/amass/bin ./tapelength [-uy] vol u menu mber lengthcode Option Descri ption -u Usage st atement -y Suppres s interacti v e messa[...]

  • Page 192

    Managing the AMA SS File System 3-104 Comma nd Refere nce 6-00028-01 R ev A Create a T emplate File If you use tape volumes of dif ferent lengths, crea te a template f ile that imbeds a spe cifi e d tape length in the barc ode in the File System Database. When AMASS reads the Database, it kno ws the media length and can accurately display capaci ty[...]

  • Page 193

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-105 Step 1. Use an edi tor , such as vi , to create a t emplate f ile similar to the f ile sho wn in the follo wing example: Step 2. The D=n string, indicates the tape length value. To define a 50 GB length for a tape, enter a value of C as shown in the follo wing example: S[...]

  • Page 194

    Managing the AMA SS File System 3-106 Comma nd Refere nce 6-00028-01 R ev A vgexpor t Export data and attributes (metadata file) for a volume group to another AMASS f ile system. The metadata f ile contains th e directory structure and media attributes (such as media type, ownership, and t imestamp) for a volum e group. The metadata is pa rt of the[...]

  • Page 195

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-107 Limitations The follo wing limitat ions apply to the export process: • Hard links and soft links are not exported. If the v olume group being exported contains th ese f ile types, a warning message appears, but the e xpor t continues. • Only v olumes formatted with A[...]

  • Page 196

    Managing the AMA SS File System 3-108 Comma nd Refere nce 6-00028-01 R ev A [-uy] [-dgq] -f meta filep ath vol umegroup Option Descri ption -d Remove all entries associat ed with the expor ted volume group from the Databas e on the source ser ver -g Ignore volume verificati on -q (defaults to mount v olum es f o r header v er ification) Do not mo u[...]

  • Page 197

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-109 Exam ple This e xample assumes we ha v e tw o AMASS installations, one in Den ver and one in T exas, that need to share da ta. The Den ver site colle cts data used b y the T exas site. At the Source Si te Step 1. In Den ver , collect data and write it to vol ume group 3 [...]

  • Page 198

    Managing the AMA SS File System 3-110 Comma nd Refere nce 6-00028-01 R ev A Step 5. AMASS marks the vo lume group Read-Only to pre vent t he files from being changed. Step 6. Use FTP (File T ransfer Protocol) or something similar to send the ne wcustomers metadata f ile to T exas. The fol lo wing f igure illustra tes our exa mple to this point in t[...]

  • Page 199

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-111 vgimpor t Import data and attributes (met adata f ile) for a volume group from another AMASS f ile system. Optional Feature Name Contention HP-UX only: Because AMASS and HP-UX both hav e a vgimport command, make sure you use the full path to dif f erentiate which command[...]

  • Page 200

    Managing the AMA SS File System 3-112 Comma nd Refere nce 6-00028-01 R ev A Options /usr/amass/bin ./vgimport [-uy] [-p path ] -v vol u menu mber metafilepath Option Descripti on -u Usage sta tement -y Suppres s interactive messa ges -p path (defaults to path at so urce si te) Enter a path r elative to the mount p oint wher e you w ant to put the f[...]

  • Page 201

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-113 Exam ple The follo wing steps outline the same scenario we be gan with the vgexport command. -v volumenumb er Enter the volume numb er— not the volume group—assoc iated with the metadata file. T o li st more tha n one volume, separat e the numbers with a comma or wit[...]

  • Page 202

    Managing the AMA SS File System 3-114 Comma nd Refere nce 6-00028-01 R ev A Step 1. T o begin, see the vgexport command. The f ollo wing f igure illustrates our example: At the Destinati on Site Step 2. For bar code-reading libraries: Open the /usr/amass/.juke/media_file_ juk ebox- number file to v erify that the ba rcode on the imported v olume (6[...]

  • Page 203

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-115 Step 3. For network- attached storage devices: Use the b ulkinlet com mand to load v olume 67 into the mailbox, assign it to v olume group 3, mark it Online, and mov e it to a home storage slot. ( F or SCSI-attached storage devices: Use the volnew , v olinlet , and vollo[...]

  • Page 204

    Managing the AMA SS File System 3-116 Comma nd Refere nce 6-00028-01 R ev A[...]

  • Page 205

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-117 vglist V i e w attributes for a vol ume group. Options Note By default, the v iew will not in clude block size or compr ession attri butes, unless specifi cally re quested wi th the -a opti on. /usr/amass/bin ./vglist [-uy] [-a] [ vol umegroup ] Option Descript ion no op[...]

  • Page 206

    Managing the AMA SS File System 3-118 Comma nd Refere nce 6-00028-01 R ev A Exam ple Step 1. Log in as either amass or root . Step 2. T o view attrib utes, including tape block size and compression, for volume group 801, enter the options sho wn in the follo wing table: Output Fie lds Defined The follo wing fi elds are generated by this command: vo[...]

  • Page 207

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-119 Flags Status of v olume, not volume group : • full = space on volum e group is full • worm = Media type • rw = Read and Write • T APE = Media ty pe • cdrom = Media type • SP = space pool • ro = Read-Only V ol ume Number o f v olumes assigned t o the volume [...]

  • Page 208

    Managing the AMA SS File System 3-120 Comma nd Refere nce 6-00028-01 R ev A vgpo ol Define media for an out-of-space volume group to one of the follo wing: • Use the space pool. • Use specific media (re writable , WORM, tape, CD) from the space pool. • Look for the space pool on a specific library or on any librar y . When a volum e group run[...]

  • Page 209

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-121 [-cdeirstw] [-j juk eboxnumber ] vol umegroup Option Descript ion -c Limits t he specifie d volume group to use only CD m edia -d Disable space p ool -e Enable space pool -i Vie w wheth er or not th e sp ecifi ed vo lume group can use the spac e pool. When AMASS asks if [...]

  • Page 210

    Managing the AMA SS File System 3-122 Comma nd Refere nce 6-00028-01 R ev A Enab le V olume Gr oup to use Space P ool Step 1. Log in as either amass or root . Step 2. For more information about enabling volume groups to use the space pool, see “V olume G roups Defined” on page 1-13. Step 3. T o enable volume group 6 in juk ebox 1 to use the spa[...]

  • Page 211

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-123 Limit M edia Us age an d Locati on of Space P ool Step 1. Log in as either amass or root . Step 2. T o enable space pool, use re writable optical platter , and use the space pool located on library 2, enter the command as show n in the follo wing example. Your input is s[...]

  • Page 212

    Managing the AMA SS File System 3-124 Comma nd Refere nce 6-00028-01 R ev A Enab le V olume Group to use T ape Media Step 1. Log in as either amass or root . Step 2. T o define media for an out-of-space volume group that currently is without vol umes in it, AMASS defaults to optical media. If you w ant tape, you must use the -t option with the vgpo[...]

  • Page 213

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-125 vgreadonly Define a v olume group a s one of the follo w ing: •R e a d - O n l y • Read and Write Characteris tics A volum e group with Read-Only media has the follo wing characte ristics: • V olume group is not a v a ilable for writes, deletes, volcomps, or v olcl[...]

  • Page 214

    Managing the AMA SS File System 3-126 Comma nd Refere nce 6-00028-01 R ev A [-uy] [-rw] vol umegroup Option Descript ion no options View status for the s pecified volume group When AM ASS as ks if you want to tog gle the status, type y for yes and n fo r no. -r Mar k a specif ied volume group as Read-On ly -u Usage s tatement -w Mar k a specif ied [...]

  • Page 215

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-127 vgr oot V i e w the direc tories assigned to a v olume group. If you hav e assigned more than one directory to the same volum e group, AMASS returns the relativ e paths for all the directories. The path is relativ e to the AMASS mount point (the default is /archive ). Op[...]

  • Page 216

    Managing the AMA SS File System 3-128 Comma nd Refere nce 6-00028-01 R ev A Exam ple Step 1. Log in as either amass or root . Step 2. T o view t he relativ e paths for f iles a ssigned to volum e group 674, enter the command as shown in the following e xample. The following output shows that two directories have been assigned to volume group 674: S[...]

  • Page 217

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-129 v olclattr Define attrib utes for c leaning v olumes. For more information on dri ve cleaning, see the driv eclean command. Prerequisites T o prepare for either automatic or manual dr i ve cleaning, perform the follo wing steps: Step 1. Assign a clea ning vol ume to the [...]

  • Page 218

    Managing the AMA SS File System 3-130 Comma nd Refere nce 6-00028-01 R ev A Step 3. V ie w cleaning attribut es with the vollist -g CL command, if desired. Cleaning vol umes must be: unformatted (U), Inactiv e (I), and Online. Options /usr/amass/bin ./volclattr [-uy] [-c currentusage ] [-e errorcount ] [-m maxusage ] [-t cleaningt ime ] vol u menu [...]

  • Page 219

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-131 -m maxusage Enter the maxi mum number of time s this cleaning volume can be used, ev en if the error co unt remai ns at zero -t cleaningtime Enter the tim e—in secon ds— that th is cleaning volume shoul d remain in the dr ive before AMASS stop s the cle aning pr oces[...]

  • Page 220

    Managing the AMA SS File System 3-132 Comma nd Refere nce 6-00028-01 R ev A v olclean Delete: All the f iles on a volume , b ut not the volume number from the File Syste m Database. Prerequisites Prior to using this command, make sure the v olume is in its home storage slot. The volume must be Online ( volloc -n ), readable, writable, and Ina cti v[...]

  • Page 221

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-133 Options /usr/amass/bin ./volclean [-uy] vol u menu mber Option Descript ion -u Usage st atement -y Suppres s interacti v e message s volumenumb er Enter the un ique volume numbe r[...]

  • Page 222

    Managing the AMA SS File System 3-134 Comma nd Refere nce 6-00028-01 R ev A vo l c o m p Recov er dead space by rewriting remaining data on a v olume to a dif ferent volum e in the same volum e group. Dead space is space that has been previously written to by AMASS. A v olume that contains scattered files separated b y great expanses of dead space [...]

  • Page 223

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-135 After the volcomp process completes, the original v olume is without data so AMAS S marks it Inacti ve in the File System Database. T o reuse the v olume, format it with the v olformat command. Prerequisites Before using this command: • Mark the tar get volume Acti ve [...]

  • Page 224

    Managing the AMA SS File System 3-136 Comma nd Refere nce 6-00028-01 R ev A Options Exam ple Step 1. Log in as either amass or root . Step 2. In the following e xa mple, we used the vol s p ac e command to li st all v olumes th at ha v e more than one-third (33%) dead space . The output shows that volume number 2 meets this requirement. /usr/amass/[...]

  • Page 225

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-137 Step 3. Run the v olcomp command on specif ied v olume number (2) as sho wn in the following example: The few files on volume number 2 are moved to another volume in the same volume group. While the original volume is being volcomped, AMASS marks the volume, shown in the[...]

  • Page 226

    Managing the AMA SS File System 3-138 Comma nd Refere nce 6-00028-01 R ev A vo l c o py Copy data from a source v olume to a destination v olume. If the original vol ume is lost, destroyed, or damaged, you can use the duplicate volume e xac tly like you w ould the original. AMASS supports volcopy on the follo wing media: •W O R M • Re w ritable[...]

  • Page 227

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-139 Requireme nts Before using this command: • T wo dri ves are required—one dri ve to read the source volum e and one driv e to write to the destination media. The dri ves can be either standalone or in a library . - Although a standalone driv e can be used, it is tedio[...]

  • Page 228

    Managing the AMA SS File System 3-140 Comma nd Refere nce 6-00028-01 R ev A • Both source and destination m edia must be of the same type and ha ve the same block size and capacity . Requirements are illustrated by the follo wing f i gure: Tip Manufacturing variati ons make “equal” tapes hav e variable lengths. Cons equently , AMASS d oes not[...]

  • Page 229

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-141 Name Contention Solaris and HP-UX only: Because AMASS, Solaris, and HP-UX all hav e a volcopy command, mak e sure you use the full path to dif ferentiate w hich command you want to use. F or example, to use the AMASS command, enter it as sho wn in the follo wing example:[...]

  • Page 230

    Managing the AMA SS File System 3-142 Comma nd Refere nce 6-00028-01 R ev A Opti on Defi niti on type Enter one of the f o llowing copy types : • -c = Copy s our cevolume data to destsl ot media • -v = V erify copy pro cess b y reading and comparing the dup licate copy with the original vol um e • -cv = C opy a nd ver if y NO TE: V alid only [...]

  • Page 231

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-143 Exam ple T o perform a v olume copy , follow the ste ps belo w . Step 1. Log in as either amass or root . dest slott ype Enter th e home sto rage slot wher e the destinat ion media reside s and wher e it will be retur ned. D estinatio n media is u nknown to the Database?[...]

  • Page 232

    Managing the AMA SS File System 3-144 Comma nd Refere nce 6-00028-01 R ev A Step 2. If the so urce volume is not in its home storage slot, use the mediamove utility to mo ve the source v olume to its slot in the library . When the volcopy process starts, the source volume must be in its home storage slot. Step 3. T o mov e the destination media to [...]

  • Page 233

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-145 • After the copy has completed, AMASS returns the destination media to its original location. In our example, AMASS returns it t o the standalone. Because the copy procedure depends on the amount of data on the source volume, the process can take as long as an hour to [...]

  • Page 234

    Managing the AMA SS File System 3-146 Comma nd Refere nce 6-00028-01 R ev A v oldelete Delete: • All the f iles on a v olume • V olume number from the File System Database Before a v olume is delete d, AMA SS checks to se e if any f il es exi sts on the volume and asks you to confirm their deletion. If a f ile spans v olumes, designate d by an [...]

  • Page 235

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-147 Options Additio n al Inf or matio n For more i nformation on deleting a v olume, see “Delete F iles and V olume Number” on page 2-18. /usr/amass/bin ./voldelete [-uy] vol u menu mber Option Descript ion -u Usage st atement -y Suppres s interacti v e message s volumen[...]

  • Page 236

    Managing the AMA SS File System 3-148 Comma nd Refere nce 6-00028-01 R ev A v oldir Vi e w : • All f i les on a v olume (Files that span media are ma rked with an aster isk) • T ime and date the f ile wa s last accesse d Options Note If you create a zer o length fi le within an AMASS d irector y , ex. "touch fi lename", the file is no[...]

  • Page 237

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-149 Exam ple Foll ow ing is an example of output generated b y this command for volume 3. The def ault AMASS mount point is / archi ve . Option Descript ion -u Usage st atement volumenumb er Enter the un ique volume numbe r where you want to view director ies # voldir 3 -rw-[...]

  • Page 238

    Managing the AMA SS File System 3-150 Comma nd Refere nce 6-00028-01 R ev A v olfilelist V iew all f iles on a volume , one f ile per line . Options Note If you create a zer o length fi le within an AMASS d irector y , ex. "touch fi lename", the file is not asso ciated wit h a volume or volume group . This comm and will igno re such files[...]

  • Page 239

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-151 V erbose Exam ple The follo wing exam ple illustrates output for: • Storage T echnology driv es (-h) • Absolute paths (-a) • V er bose messages (-v) Storag eT ek drives: -h View star t o f the file’s block address as a hexadecimal value en closed in par ent hes e[...]

  • Page 240

    Managing the AMA SS File System 3-152 Comma nd Refere nce 6-00028-01 R ev A • Files on v olume number 2 Nonv erb ose Ex ample The follo wing exam ple illustrates output for: • Relative paths (-r) # su root # volfilelist -hav 2 /archive/prodcode 19980207114408 19980307142206 /archive/dirname/filename 2 71 (0x021001e6) 10 010770 1 0 1 19980207114[...]

  • Page 241

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-153 • Files on v olume number 2 Output Fie lds Defined The follo wing fi elds are generated by this command. # su root # volfilelist 2 /dirname /dirname/filename ~ 0 0 Director y name File name Zero designates a director y Logical block address Lo g ical block address V ol[...]

  • Page 242

    Managing the AMA SS File System 3-154 Comma nd Refere nce 6-00028-01 R ev A TIME F orm at The Access_time and Modif ie d_time v alues hav e the following format: yyyymmddhhmmss . F or e xam ple, t he v alue 19980307114408 = 1998, March 07, 11:44:08 a.m. This format allo w s you to sort b y time, which is usef ul when creating a list of f iles creat[...]

  • Page 243

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-155 File Names Last Exa mple The following output sho ws an example of the f ile names in the last f ield position: # volfilelis t -l 2 2 204801 /vg800/bg1 2 977033 /vg800/01Mar182007 V olume Number Logical Block Address File Name[...]

  • Page 244

    Managing the AMA SS File System 3-156 Comma nd Refere nce 6-00028-01 R ev A Pra ctical A pplicat ion The follo wing e xample uses this command to back up fil es, in optimized order , from a volume to a tape. AMASS backs up entire f iles, e ven if they span media. Both scenarios assumes the AMASS mount point is / a rchive . Using cpio C omman d Step[...]

  • Page 245

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-157 Using tar Comma nd Step 1. Log in as either amass or root . Step 2. Enter the commands as sho wn in the follo w ing example. Step 3. T o back up the files on v olume 2 to your magnetic disk, substitu te / mydir / vol2.tar for /dev/rmt/0m # su root # cd /archive # tar -cv[...]

  • Page 246

    Managing the AMA SS File System 3-158 Comma nd Refere nce 6-00028-01 R ev A vo l f o r m a t Forma t media with specif ied attributes. Prerequisites Before using this command, the v olume must hav e the follo wing characteristics: • Be Online (Use the vo ll o c command to vie w and toggle status.) • Contain no data that you want to k eep • No[...]

  • Page 247

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-159 Options /usr/amass/bin ./volformat [-uy] [-pq] [-b blocksize ] [-c {on|off}] [-d num] [ vol u menu mber ] Option Descript ion no options NO TE: Not v alid fo r W O R M because the v olume c annot be erased. For optical platter s: P erform a full f or mat that inc ludes t[...]

  • Page 248

    Managing the AMA SS File System 3-160 Comma nd Refere nce 6-00028-01 R ev A volumenumb er Enter the uni que volume number of the med ia you are formatti ng T o lis t more than one volume, separate the numbers w ith a space. For e xample: volformat 6 12 47 49 f ormats v olumes 6, 12, 47, a nd 49. In additio n, to list more than one volume as a range[...]

  • Page 249

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-161 Option Descript ion For tape drives: -b bloc ksize (defaults are dri v e- dependen t) NO TE: V ali d only for specifi ed drives, see “Configu re Block Size” on page 3-164. Enter th e tape’ s bloc k size. V al id values are: •I f MAXIOSZ is 1024 (HP , IBM, SGI, an[...]

  • Page 250

    Managing the AMA SS File System 3-162 Comma nd Refere nce 6-00028-01 R ev A F orma t a New V olu me Step 1. Log in as either amass or root . Step 2. T o make the initial entry in the File System Dat abase and recei ve from AMASS a unique volume number , use the vo l new command. Step 3. T o load the specif ied v olume number in a libra ry , use the[...]

  • Page 251

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-163 Step 7. T o furthe r prepare the volume so AMASS can r ead or write to it, use the commands list ed in the follo wing table. Attr ibutes Within V ol ume Groups Each volum e’ s attribut es within a numerical volum e group must be uniform. For e xa mple, if the f irst vo[...]

  • Page 252

    Managing the AMA SS File System 3-164 Comma nd Refere nce 6-00028-01 R ev A attributes of the second v olume group. If the values do not match, AMASS issues an erro r and does not complete the reassignment. For information on num erical volume groups, s ee “V olume Groups Defined” on page 1-13. Config ure Block Size Thoroughly understand what t[...]

  • Page 253

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-165 Example Config urin g Block Size a nd Compre ssion Step 1. Log in as either amass or root . Step 2. The following e xa mple formats v olume number 1 with a block size of 128 KB and compression is enable d. T ool s that Dis play Block Size and C ompress ion The follo wing[...]

  • Page 254

    Managing the AMA SS File System 3-166 Comma nd Refere nce 6-00028-01 R ev A vo l g r o u p Assign a v olume to one of the follo w ing groups: • Numeric vo lume group numbered 1 through 2047 • Space pool A volum e with fil es on it cannot be assigned to the space pool (SP). When a volume group runs out of space AMASS assigns a compatible volume [...]

  • Page 255

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-167 Options /usr/amass/bin ./volgroup [-uy] [-f] vol u menu mber vol umegroup Option Descripti on -f F orc e the ass ignm ent of a v olum e to a v olume group, e ven if files e xist on the media NO TE : This optio n does no t cha ng e the assignme nt for the director ies and[...]

  • Page 256

    Managing the AMA SS File System 3-168 Comma nd Refere nce 6-00028-01 R ev A Attr ibutes Within V ol ume Groups Each volum e’ s attribut es within a numerical volum e group must be uniform. For e xa mple, if the f irst volume in a numerical volum e group has been formatte d with compression ON and a block size of 64 KB, all the v olumes in that vo[...]

  • Page 257

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-169 AMASS asks for confirmation of the process. Step 3. Use the setvolgrp command to update the directories and f iles with the ne w volume number . Assi gn V olu me to Space P ool Step 1. Log in as either amass or root . Step 2. T o assign volume n umber 10 to the space poo[...]

  • Page 258

    Managing the AMA SS File System 3-170 Comma nd Refere nce 6-00028-01 R ev A v olinlet Load pre viously def ined volume th rough the mailbox and mark online. Options Tip This com mand i s v alid onl y for SCSI-atta ched stora ge devices. Note This command is not valid for libraries without a mailbox. /usr/amass/bin ./volinlet [-uy] vol u menu mber O[...]

  • Page 259

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-171 Load a New V olume Step 1. Log in as either amass or root . Step 2. T o make the initial entry in the File System Dat abase and recei ve from AMASS a unique volume number , use the vo l new command. Step 3. T o load volum e number 33 in a library , enter the command as s[...]

  • Page 260

    Managing the AMA SS File System 3-172 Comma nd Refere nce 6-00028-01 R ev A Step 5. T o furthe r prepare the volume so AMASS can r ead or write to it, use the commands list ed in the follo wing table: Command Description vo l l o c NO TE: Not v alid f or librari es without a mailb o x. Mar k the volume Online in the Database Online = media i s in s[...]

  • Page 261

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-173 v ollabel Reassign AMASS v olume to media with a dif fere nt label or change the v olume label (-r). Options /usr/amass/bin ./vollabel [-uyr] vol u menu mber newv olumelabel Option Descripti on -r Change v olume l abel after it was physically replaced o n media -u Usage [...]

  • Page 262

    Managing the AMA SS File System 3-174 Comma nd Refere nce 6-00028-01 R ev A Change V olume Lab el Step 1. Log in as either amass or root . Step 2. T o change a volume label on v olume number 2 to pubsvolume , enter the comm and as sho wn in the follo wing example. AMASS asks for confirmation of the process. newvol umel abe l Enter on e of the follo[...]

  • Page 263

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-175 v olleft Write ho w much space—in kilobytes—re mains on a v olume to standard out ( stdout ) . Options Exam ple Foll ow ing is an example of output generated b y this command for volume 2. /usr/amass/bin ./volleft [-uy] vol u menu mber Option Descri ption -u Usage s [...]

  • Page 264

    Managing the AMA SS File System 3-176 Comma nd Refere nce 6-00028-01 R ev A There is 338,652 KB of space remaining on this volume. 338652[...]

  • Page 265

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-177 v ollist V i e w attributes for: • One v olume • All v olumes • A v olume group If you think there may be a discrepancy between what is in your library and the File System Database or if you want to ve rify what is actually in the home storage slots, use the medial[...]

  • Page 266

    Managing the AMA SS File System 3-178 Comma nd Refere nce 6-00028-01 R ev A Reset to Ze ro Use the setvolerr command to reset the error counts re ported by the v ollist command to zero. F or syntax, see “setvolerr” on page 3-87. Option Descript ion no options View attributes for all volumes -u Usage s tatement -y Sup press inte ractive messag e[...]

  • Page 267

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-179 Vie w Attributes f o r On e V olume Foll ow ing is an example of the output for v olume number 2. View Att ributes f or All V olumes Foll ow ing is an example of the output for all v olumes in a library:. # su root # vollist 2 VOL NUM VOL GRP JUKE POS VOLLA BEL FLAGS USE[...]

  • Page 268

    Managing the AMA SS File System 3-180 Comma nd Refere nce 6-00028-01 R ev A Vie w Attribut es f or Cleaning Group Foll o wing is an example of status output for the volum es in the cleaning group: Output Fie lds Defined The follo wing fi elds are generated by this command: 5 MV 1 net data5 I 0 43007 0 0 5 volumes in filesystem # vollist -g CL NUM G[...]

  • Page 269

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-181 V ol ume Label Eithe r : • User-assig ned name • Prepr inted barcod e Field Descript ion Field Descript ion Flags Fo r m o r e informati on, se e “Fla gs Defi ned” on page 3-183. Status of v olum e: • A = A c tive vo l um e u se d by A MA SS • C = V olume is [...]

  • Page 270

    Managing the AMA SS File System 3-182 Comma nd Refere nce 6-00028-01 R ev A A vail Amount of space, in MB, available on the vo l u m e NO TE : AMASS assu mes a c o mp ressed capaci ty of 2:1 rati o , but som e newer drives may ha v e a com pressed c apacity of 3 :1. Consequen tly , the c apacity dis play ed by the vollist comma nd after a volformat[...]

  • Page 271

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-183 Flags Defined The follo wing table describes the Acti ve, Inacti ve, Online, and Of fline v a lues a volume can ha ve in the Flag field: On line O = O ffline A = Act iv e Vo l u m e i s in libr ary AMAS S can read and wr ite to volume. Vo l u m e i s not in libr ar y AMA[...]

  • Page 272

    Managing the AMA SS File System 3-184 Comma nd Refere nce 6-00028-01 R ev A v olloc Mark a v olume in the File S ystem Database a s either: • -n (Online) = Inside the libra ry • -o (Of fline) = Outsi de the li brary Options Note Use this com mand if you had to use the mediamove utility to move a volume thus t he File Sy stem Datab ase did n ot [...]

  • Page 273

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-185 Mark New V olume Online Step 1. Log in as either amass or root . Step 2. T o make the initial entry in the File System Dat abase and recei ve from AMASS a unique volume number , use the vo l new command. Step 3. T o load the specif ied v olume number in a libra ry , use [...]

  • Page 274

    Managing the AMA SS File System 3-186 Comma nd Refere nce 6-00028-01 R ev A Step 5. T o furthe r prepare the volume so AMASS can r ead or write to it, use the commands list ed in the follo wing table. Command Description StorageT ek R ed w ood tape drives onl y : tapelength Enter th e length of tape in the Database v olforma t Form at the volume v [...]

  • Page 275

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-187 vo l n e w Create an entry in the File System Database for new , unknown media. Options Note F or tracking pur poses, AMAS S assi gns the new v olume a unique v olume num ber . /usr/amass/bin ./volnew [-uy] vol umegroup slot volumelabel [ jukeboxn umb er ] Option Descrip[...]

  • Page 276

    Managing the AMA SS File System 3-188 Comma nd Refere nce 6-00028-01 R ev A Create Database Entry for Ne w V olume The follo wing exam ple illustrate s ho w to create an entry in t he File System Database for a new v olume, assign it to volum e group 4, slot 0A64 in library number 2, and label it with a volum e label of “test.” volume gr oup En[...]

  • Page 277

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-189 Step 1. Log in as either amass or root . Step 2. T o cr eate an entry in th e File System Data base and receive a unique volume number from AMASS, enter t he command a s sho wn in the foll o wing example. AMASS asks for confirmation of the process. New volumes have an in[...]

  • Page 278

    Managing the AMA SS File System 3-190 Comma nd Refere nce 6-00028-01 R ev A Command Description vo l i n le t NO TE: Not v alid f or librari es without a mailb o x. Load volume in to the librar y vo l l o c NO TE: Not v alid f or librari es without a mailb o x. Mar k the volume Onli ne in the Database • Online = media is in s torage de vice Stora[...]

  • Page 279

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-191 vo l n o t e Enter a user-def ined 255-c haracter description for a volume. Options /usr/amass/bin ./volnote [-uy] vol u menu mber vol umenumbe r “text” -d vol u menu mber Option Descript ion no options Gene rates a list o f all volumes and their corresp onding desc [...]

  • Page 280

    Managing the AMA SS File System 3-192 Comma nd Refere nce 6-00028-01 R ev A The follo wing exam ple genera tes a list o f all v olumes and their descriptions: The follo wing example generates the description for volum e #2: The following e xample a llo ws you to create the description for volume #4. Using the -y opti on suppresses the conf irmation[...]

  • Page 281

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-193 For of fline volume s, the Of fline Media Mana ger , run with the sysop command, displays the v olume de scription as part of the mount request if the notation is at least eight b ytes long and contains no unprintable characters that would corrupt the display . For more [...]

  • Page 282

    Managing the AMA SS File System 3-194 Comma nd Refere nce 6-00028-01 R ev A v olout let Eject volume to the mailbox and mark of fline. Ta s k s The follo wing tasks are v alid for libraries with a mailbo x: • Ejects a v olume from home storage slot to the mailbox • Marks the v olume Offline in the File System Dat abase If media is current ly in[...]

  • Page 283

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-195 Option Descript ion -u Usage sta tement -y Supp ress inte ract iv e mess ages volumenumb er Enter the uni que volume number you want to outlet fro m the librar y and mark O ffline in th e Database[...]

  • Page 284

    Managing the AMA SS File System 3-196 Comma nd Refere nce 6-00028-01 R ev A v olreadon l y Mark v olume eithe r: •R e a d - O n l y • Read and Write Options Note This com mand is n ot valid f or volumes in the space pool or in the cleanin g group. /usr/amass/bin ./volreadonly [-uy] [-rw] vol u menu mber Option Descri ption no options View statu[...]

  • Page 285

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-197 -w Mark volume Read and W rite -y Supp ress inter activ e messag es volumenumb er Enter the uni que volume number Option Descri ption[...]

  • Page 286

    Managing the AMA SS File System 3-198 Comma nd Refere nce 6-00028-01 R ev A v olslot Change a v olume’ s home storage slot in the File System Database, b ut the volum e is not physically mo ved. This command can also be used to assign an of fline volume to a standalone dri ve i f you hav e Of fline Media Ma nager (OMM). For OMM information, see ?[...]

  • Page 287

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-199 Change Slot Ass ignmen t T o change the home storage slot number for v olume number 15 from slot 0A02 to 0A56 in library number 1, perform the follo wing steps: Step 1. Log in as either amass or root . Step 2. Outlet volume number 15 as sho wn in the following example. U[...]

  • Page 288

    Managing the AMA SS File System 3-200 Comma nd Refere nce 6-00028-01 R ev A Step 3. Change the volume’ s home storage slot number to 0A56 with the follo wing options and va lues: Step 4. Insert the volume into the mailbox and enter the follo wing option and values: The library moves volume number 15 to slot 0A56. # volslot -y 15 0A56 # volinlet -[...]

  • Page 289

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-201 v olspace V i e w all volumes with a specif ied percentage of dead space. Dead space is space that has been previously written to by AMASS. A v olume that contains scattered files separated by great expanses of dead space is a waste of media. See the volcomp command. Opt[...]

  • Page 290

    Managing the AMA SS File System 3-202 Comma nd Refere nce 6-00028-01 R ev A Exam ple Foll owing is a n example of output generated with a dead space percentage grea ter than or equal to 33 percent. AMASS asks for conf irmation of the process. Output Fie lds Defined The follo wing fi elds are generated by this command: # su root # volspace 33 Retrie[...]

  • Page 291

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-203 P osi tion Home storage slo t. V alid entr ies are: • 4-alphanumeric designation = SCSI-attached storage de vice • n/a = standalone dri ve • NET = netw ork-attached st orage de vice V ol ume Label Eithe r : • User-assig ned name • Prepr inted barcod e Flags Fo [...]

  • Page 292

    Managing the AMA SS File System 3-204 Comma nd Refere nce 6-00028-01 R ev A Field Descript ion Dead Am ount of spac e no longe r referenced by files Express ed as a percentage of the total volume space; t he higher the percent age, the greater the amount of dead space NO TE: V olumes with hig h percentag es are good can didates for the volcomp pr o[...]

  • Page 293

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-205 Flags Defined The follo wing table describes the Acti ve, Inacti ve, Online, and Of fline v alues a volume can ha ve in the Flags field: Online O = Offline A = Active Vo l u m e i s in li brar y AMASS ca n read and wr ite to volume. Vo l u m e i s not in libr ar y AMASS [...]

  • Page 294

    Managing the AMA SS File System 3-206 Comma nd Refere nce 6-00028-01 R ev A vo l s t a t V i e w and change the current status—Activ e or Inactiv e—of a vol u me . Name Contention hp T ru64 UNIX only: Because both AMASS and hp T ru64 UNIX hav e a volstat command, make sure you use the full path to dif fe rentiate which command you want to use. [...]

  • Page 295

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-207 Activa te New V olum e Step 1. Log in as either amass or root . Step 2. T o cr eate an entry in th e File System Data base and receive from AMASS a uni que volume number , use the vol n ew command. Step 3. T o load specified the v olume number in a library , use the voli[...]

  • Page 296

    Managing the AMA SS File System 3-208 Comma nd Refere nce 6-00028-01 R ev A Step 4. T o mark the specif ied volume number Online in the Database, use the volloc com mand. Step 5. StorageT ek Redwoo d tape drives: Enter the length of tape in the Database with the tapelength command. Step 6. T o format the specified v olume number , use the volforma [...]

  • Page 297

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-209 vo l u s a g e V iew st atistics for all v olumes in the AMASS fil e system. Options Exam ple Step 1. Log in as either amass or root . /usr/amass/bin ./volusage [-u] [-hHV] Option Descript ion -h Display a mess age desc ribin g the ou tput -H (defaults to pr int and unde[...]

  • Page 298

    Managing the AMA SS File System 3-210 Comma nd Refere nce 6-00028-01 R ev A Step 2. An example of the output is sho wn in the following illustration. Output Fie lds Defined The follo wing fi elds are generated by this command. # su root # volusage Vol Slot Mounts R+W(MB) Err Last Mounted 1 NET 1 0 0 Fri Aug 29 03:00:15 1998 2 NET 0 0 0 --- 3 NET 15[...]

  • Page 299

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Command Referen ce 3-211 Last Mounted Date and tim e this volume was last moun ted in a dr ive • Hyph en (—) = V ol ume ha s not be en moun ted Field Descripti on[...]

  • Page 300

    Managing the AMA SS File System 3-212 Comma nd Refere nce 6-00028-01 R ev A NO TES[...]

  • Page 301

    4 Utility Ref erence[...]

  • Page 302

    Managing th e AMASS File System 4-2 Utili ty Refer ence 6-00028-0 1 Rev A NO TES[...]

  • Page 303

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Re feren ce 4- 3 Utilities The utilities des c ribed in this cha pter are locate d in the directori es listed in the follo wing table. Sp ecify these directories in the system administrator’ s login PATH vari a bl e . T ool(s) Login P ath scripts roo t /usr/amas s/tools Hardware Utilit[...]

  • Page 304

    Managing th e AMASS File System 4-4 Utili ty Refer ence 6-00028-0 1 Rev A Scripts in /usr/amass /tools The follo wing AMASS scripts help to identify and resolve operation problems: Operation Script P age amass_a tboot 4-5 amass_l og 4- 7 amas s_snap 4- 9 amas s_sta r t 4-10 amass_te sts 4-12 install_t ests 4-16 killdaem ons 4-22[...]

  • Page 305

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Re feren ce 4- 5 amass_atboot Define st atus of AMASS startup commands. Options Exam ple Step 1. Log in as root . /usr/amass/tools ./amass_atboot [-de] Option Descript ion no option View cu rrent sta tus of AMA SS at reboot -d Do not start AMASS up on reboot -e Enable AMA SS upon reboot [...]

  • Page 306

    Managing th e AMASS File System 4-6 Utili ty Refer ence 6-00028-0 1 Rev A Step 2. If AMASS is hung, disable AMASS at reboot by entering the follow ing path, script name, and option: Step 3. Reboot the system. # cd /usr/amass/tools # ./amass_atboot -d[...]

  • Page 307

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Re feren ce 4- 7 amass_log Redirect the AMASS system log messages to the console. AMASS sends messages to the system log. F or a numerical list of AMASS system log messages and correctiv e a ction, refer to Err ors and Corr ective Action . When to Use Script For an e xa mple of when to u[...]

  • Page 308

    Managing th e AMASS File System 4-8 Utili ty Refer ence 6-00028-0 1 Rev A Example Step 1. Log in as root . Step 2. Follo wing the path and scr ipt name, enter the path to your system log. F or default system log locations, refer to Err ors and Corr ective Action . Because the log will probably have several days’ worth of messages. Make sure the m[...]

  • Page 309

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Re feren ce 4- 9 amass_snap Collect system information after a problem occurs. When to Use Script For an e xa mple of when to use this script, see “A M A S S Appears Hung” on page -3. Exam ple Step 1. Log in as root . Step 2. Follo wing the path and sc ript name, enter the process ID[...]

  • Page 310

    Managing th e AMASS File System 4-10 U tility Refe rence 6-00028-0 1 Rev A amass_star t Perf orms the fol lowin g tas ks: • Start the AMASS daemons. • Mount the AMASS f ile system. When to Use Script For an e xa mple of when to use this script, see: • “ AMASS Does Not Start” on P age -16 • “UNIX Server’ s Partitions C rash” on Pag[...]

  • Page 311

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-11 List of S tar tup Da emons The startup daemons are loca ted in / usr/amass/daemons and are li sted in the fol lo wing tabl e: Daemon Description amassmai n AMASS database manager a nd pare nt of other daemo ns amassreco very AMASS startup and recovery pro gram lm_ip AMASS [...]

  • Page 312

    Managing th e AMASS File System 4-12 U tility Refe rence 6-00028-0 1 Rev A amass_tests AMASS must be running prior to e x ecuting the test: • Storage device h ardware • AMASS File System Dat abase, volumes, syst em f i les, and message files • No output means that ama ss_tests wa s successful. Prer equisi tes AMASS must be running prior to e [...]

  • Page 313

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-13 List of T ests The script runs the tests listed in the follo wing table: Gro up T est Name Definit ion Backup Scheduled Makes sure th at backup s are sc hedule d in cron Volume Makes s ure a Back up Volu me exist s and is forma tted, an other volu me is assign ed to that h[...]

  • Page 314

    Managing th e AMASS File System 4-14 U tility Refe rence 6-00028-0 1 Rev A Example Step 1. Log in as root . Group T est Name D efinit ion System Amassuse rid Makes sure AMASS user ID a nd group ID are in the password and group file Confi gdump Dumps co nfigura tion for de bugging Daemons Checks to s ee if corre ct dae mons are running Devel opmen t[...]

  • Page 315

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-15 Step 2. Enter the path and script name. Step 3. Because the util ities are opera tor interacti ve, the y use standard in ( stdin ) and standard error ( stderr ) . Lists are written to standard out ( stdout ), which you can redirect to either a f ile or a printer . # cd /us[...]

  • Page 316

    Managing th e AMASS File System 4-16 U tility Refe rence 6-00028-0 1 Rev A install_tests Perf orms the fol lowin g tas ks: • T est storage device hardware. • Modify AMASS sta rtup script to a utomatically sta rt AMASS at bootup (uses the amass_atboot script). • Run the amass_start script. • Run the amass_tests script. When to Use Script For[...]

  • Page 317

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-17 Prer equisi tes Before running this script, the follo wing conditions must be met: • AMASS must not be running when you run install_tests . • The driv es must be empty but Activ e . • At least one tape or optical platter must be in a home storage slot; this v olume s[...]

  • Page 318

    Managing th e AMASS File System 4-18 U tility Refe rence 6-00028-0 1 Rev A List of Hardw are T ests The script runs the tests liste d in the foll o wing table. The se tests can take a long time to complete if the storage de vice is lar ge . Example Make sure all the libraries are connected to the system and running. Step 1. Log in as root . Group T[...]

  • Page 319

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-19 Step 2. If AMASS is acti ve, inacti vate i t with the option sho wn in the following e xample. For command information, see “amassstat” on page 3-24. Step 3. Enter the following path and script name: The following output shows typical messages for a successful test of [...]

  • Page 320

    Managing th e AMASS File System 4-20 U tility Refe rence 6-00028-0 1 Rev A Step 7. For instructions on resolving other problems, see “amass_log” on page 4-7. Step 8. After corr ecting any problems, run install_tests again. User Defined T est V olume Capabil ity T o def ine th e vo lume(s) to use to test e ach library , create the f ile /usr/ama[...]

  • Page 321

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-21 None # T est v olume for jukebox 1 None # " " " " 2 None # " " " " 3 None # " " " " 4 None # " " " " 5 None # " " " " 6 None # " " " " 7 None # " &q[...]

  • Page 322

    Managing th e AMASS File System 4-22 U tility Refe rence 6-00028-0 1 Rev A killdaemo ns Perf orms the fol lowin g tas ks: • Inactiv ate AMASS by running the amassstat -i command. • Unmount the AMASS f ile system. • Kill the AMASS daemons. When to Use Script For an e xa mple of when to use this script, see: • “ AMASS Database is Bad” on [...]

  • Page 323

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-23 Exam ple T o run killdaemons , perform the following s t eps: Step 1. Log in as root . Option Descript ion no option s Brings AMASS down, if there are no outstandi ng IO req uests -f Forces AMASS do wn, cancels all ou tstanding IO reques ts -t seconds AMAS S will c ome do [...]

  • Page 324

    Managing th e AMASS File System 4-24 U tility Refe rence 6-00028-0 1 Rev A Step 2. T o make sure there are no pending write re quests in the AMASS queue, vie w the queue with the sysperf command. T o stop the sysperf command, use <Control-C>. Step 3. T o bring AMASS down immediat ely , enter the -f (force) option: Step 4. Or , to bring AMASS [...]

  • Page 325

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-25 Har dware Utilities in /usr/amass/ut ils The follo wing AMASS utiliti es help to ident ify , diagnose, and possibly correct hardware problems: Hardware Util ity P age init_elem ent 4-26 me diaej ect 4-28 me diaera se 4-30 me diali st 4-33 me diamove 4-36 me diare ad 4-39 m[...]

  • Page 326

    Managing th e AMASS File System 4-26 U tility Refe rence 6-00028-0 1 Rev A init_element Run the element_status command that physically scans the library then updates the libra ry’ s database ( not the A MASS Fi le System Database). Prerequisites Before using this utility: • Ina cti vate AMASS . • Make sure all operations hav e ceased on the l[...]

  • Page 327

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-27 Step 2. Enter the follo wing: # cd /usr/amass/utils # init_element 1[...]

  • Page 328

    Managing th e AMASS File System 4-28 U tility Refe rence 6-00028-0 1 Rev A mediaeject Eject media f rom a specified dri ve. Option s Exam ple Step 1. Log in as root . /usr/amass/utils ./mediaeject driv enumb er [ juke boxn umbe r ] Option Descript ion drivenumb er Enter th e drive nu mber whe re the m edia is mount ed jukebo xnumber (defaults to 1)[...]

  • Page 329

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-29 Step 2. T o eject media from driv e 1 in library 2: Step 3. If a hardware error occurs, ref er to your hardware manuals. # cd /usr/amass/utils # mediaeject 1 2[...]

  • Page 330

    Managing th e AMASS File System 4-30 U tility Refe rence 6-00028-0 1 Rev A mediaerase Erase media starting at a specif ic block address through to one of the follo w ing: • ending block address • end of the media Options Caution This ut ility dest ro ys data ! Do not use this utili ty on medi a that contains data you want to keep. Note This u t[...]

  • Page 331

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-31 Exam ple Step 1. Log in as root . Step 2. T o erase da ta on a standalone driv e and stop at the end of the media, e nter t he path, utility , and options similar to what is sho wn in the following e xample: Option Descript ion drivenumb er Enter th e drive nu mber whe re [...]

  • Page 332

    Managing th e AMASS File System 4-32 U tility Refe rence 6-00028-0 1 Rev A where: Step 3. If a hardware error occurs, ref er to your hardware manuals. V alue Description /dev/rst 12 Driv e number for a standalone drive where th e media i s mounte d 6 Start at this b lock address -1 Erase data un til yo u reach the end of the medi a[...]

  • Page 333

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-33 medialist Perf orms th e fol lo wing t a sks : • Read the library’ s database ( not the AMASS File System Database). • Display t he status of elements. Options /usr/amass/utils ./medialist -j juke boxn umbe r -s element Option Descript ion -j juke boxn umbe r (def au[...]

  • Page 334

    Managing th e AMASS File System 4-34 U tility Refe rence 6-00028-0 1 Rev A View Statu s f o r All Ele ments Step 1. Log in as root . Step 2. T o display the status for all elements in library number 2, enter the path, utility , a nd options similar to what is sho wn in the following e xample: Step 3. If you hav e a SCSI-attached library , the outpu[...]

  • Page 335

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-35 View Status for One El ement Be careful when you ask for the status for a single element because the output could be misleading, as illustrated in this example. T o display the in ventory for one elemen t, perform the follo w ing steps: Step 1. Log in as root . Step 2. Usi[...]

  • Page 336

    Managing th e AMASS File System 4-36 U tility Refe rence 6-00028-0 1 Rev A mediamove Mov e volumes from and to the locations listed in the foll o wing table: Options Librar y Descriptio n ADIC FastStor The AMASS medialist utilit y outp ut dis plays “FU LL ” to indic ate me dia in a h ome storage s lot f or SCSI-attac hed libr ar ies . How ev er[...]

  • Page 337

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-37 sour ce destination [0|1] [ juke boxn umbe r ] Option Description sour ce Enter one of the followi ng eleme nts ident ified on the source librar y: • xxxx = Home s torage slot or barcode. • x = Drive number . NO TE: This numb er identi fies the d rive in the librar y ,[...]

  • Page 338

    Managing th e AMASS File System 4-38 U tility Refe rence 6-00028-0 1 Rev A Exam ple Step 1. Log in as root . Step 2. In the fo llo win g e xampl e, AMAS S ins tructs t he dri ve to mo ve the media in home storage slot 0A03 to dri ve tw o, and flip it to side B: Step 3. In the second example, AMASS mo ves the media (0) from the third mailbox (m3) to[...]

  • Page 339

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-39 mediaread Perf orms the fol lowin g tas ks: • Read a specif ic bloc k of data. • Write the data to /tmp/mediaread . When to Use Utility Use this utility t o: • Read corrupted data blocks. • V er ify tha t a mediawrite has been successful. Options /usr/amass/utils .[...]

  • Page 340

    Managing th e AMASS File System 4-40 U tility Refe rence 6-00028-0 1 Rev A Example Step 1. Log in as root . Step 2. T o read block six on dri ve 2, enter t he path, utility , and options simil ar to what is sho wn in the follo wing example: AMASS writes the data in block six to /tmp/mediaread . Step 3. T o display the output to the screen, enter th[...]

  • Page 341

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-41 mediawrit e W rite a predet ermined line beginning at EOD for tape or at a specified block number for optical media. Options Caution This util ity destroy s data on optical media. Do not us e this util ity on op tical media th at con tains data you wa nt to k eep. /usr/ama[...]

  • Page 342

    Managing th e AMASS File System 4-42 U tility Refe rence 6-00028-0 1 Rev A Exam ple Step 1. Log in as root . Step 2. T o hav e driv e two write to block six, enter the path, utility , and options sim ilar to what i s sho wn in the follo wing example: AMASS writes the foll owing text to block number 6 : Step 3. If a hardware error occurs, ref er to [...]

  • Page 343

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-43 printjournal Print to stdout the contents of the journal , which is the daily transaction log for the AMASS File System Da tabase. F or more informat ion about this journa l , refer to “Journa l” in Installing AMASS . Options /usr/amass/utils ./printjournal [ -d did] [[...]

  • Page 344

    Managing th e AMASS File System 4-44 U tility Refe rence 6-00028-0 1 Rev A -n drive dri v e number to us e (1 relat ive) -P positio n bac ku p volume is in this sl ot -s date starting date of print (M M/DD/YYYY hh:mm:s s) -t print journ a l dir ectory -v vid specifi c volum e id to print Option Descript ion[...]

  • Page 345

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-45 quedisplay Display what is in the queues. The queues consists of a sna pshot of the follo wing items: • An I/O queue of READ and WRITE requests • An admin queue of AMASS administration commands • List of libraries, dri ves, and what v olumes they manage Prerequisites[...]

  • Page 346

    Managing th e AMASS File System 4-46 U tility Refe rence 6-00028-0 1 Rev A When to Use Util ity Use this utility , to diagnose the follo wing problems: • Y ou write to a file but the dri ve li ght does not come on. • The system is slo wing down. • An AMASS command does not com plete. Supported Driv es The following table lists tape dri v es t[...]

  • Page 347

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-47 Example Step 1. Log in as root . Step 2. Enter the path and utility as sho wn in the follo wing example: Step 3. For help in reading the output, see “Pre pare to Contact T echnical Support ” on page -32. The output looks sim ilar to the example shown in the follo wing [...]

  • Page 348

    Managing th e AMASS File System 4-48 U tility Refe rence 6-00028-0 1 Rev A Output for streaming tape I/O ( quedisplay -c ) looks similar to the exa mple shown in the followin g example: # quedisplay -c VOLUME vid=7, num_reads=0, num_writes=30 WRITEQ rid=27931, fptr=0xc00000000031c078, vol=3, fnode_flags=0xb040804 Request Cache blocks: ~ cbq_ptr: 0x[...]

  • Page 349

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-49 sl_logger The sl_logger utility allo ws you to re direct messages to a location other than to the system log. Options /usr/amass/utils ./sl_logger [-u] [-n path name ] [-f f ilenam e ] [-p priority ] [-t tag ] [ location ] Option Descript ion -u Usage sta tement -n pathna [...]

  • Page 350

    Managing th e AMASS File System 4-50 U tility Refe rence 6-00028-0 1 Rev A location (defaults to stdin ) Specify w here message shou ld be re directed Option Descript ion[...]

  • Page 351

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-51 Database U tilities The follo wing AMASS utiliti es help diagnosis problems with the AMASS File System Da tabase: Database Uti lity P age amassrec ov er y 4-52 dbchec k 4-55 fileincac he 4- 57 filepat h 4-59 fileprint 4-61 initamas s 4-64 initjo urnal 4-65 keybu il d 4-66 [...]

  • Page 352

    Managing th e AMASS File System 4-52 U tility Refe rence 6-00028-0 1 Rev A amassrecovery Perf orms the fol lowin g tas ks: • Rec ov er the AMA SS f ile s ystem. • Initialize the checkpoint. When to Use Utility This utilit y automatica lly runs e very time the system is rebooted. For an example of when to use this ut ility: • see “ AMASS Dat[...]

  • Page 353

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-53 Exam ple Step 1. Log in as root . Step 2. If AMASS is acti ve, inacti vate i t as sho wn in the follo wing example. For command information, see killdaemons . Option Descript ion no opt ions Start AMASS Reco ver fil es in cache, i t com pletes writ e operation s. These f i[...]

  • Page 354

    Managing th e AMASS File System 4-54 U tility Refe rence 6-00028-0 1 Rev A Step 3. Enter the path as sho wn in the follo wing ex ample: # su amass Password: # /usr/amass/daemons/amassrecovery[...]

  • Page 355

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-55 dbchec k T est integrity of the AMASS F ile System Database. This test can be time consuming, because the follo wing components are checked: • V olume tables • Da ta tab les •K e y t a b l e s • T imestamp for rec ords and database When to Use Utility For an exampl[...]

  • Page 356

    Managing th e AMASS File System 4-56 U tility Refe rence 6-00028-0 1 Rev A Exam ple Step 1. Log in as root . Step 2. From the AMASS File Syst em Database directory , enter t he path, utility , and options similar to what i s sho wn in the following e xample: Option Descript ion -a databa sename (defaults to /usr/fil esysdb) Check int egrity of t he[...]

  • Page 357

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-57 fileincache Report on the status of a specified f ile in the AMASS cache. Exit codes follo w: Options Exit Code Description 1 Specified file i s complete ly reside nt in cac he 2 Spec ifie d file is part ially resid ent in cache 3 Specified file i s not res ident in c ache[...]

  • Page 358

    Managing th e AMASS File System 4-58 U tility Refe rence 6-00028-0 1 Rev A Option Descript ion -u Usage statement -v Verbose m essages fullpath _filename Specify t he full path t o the file you wan t statu s on[...]

  • Page 359

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-59 filepath Display the full path for the f ile indicated b y the record ID ( rid). If the ri d appears in an AMASS error message, use thi s utility to vie w the full pa th for the fi le. Options Exam ple Step 1. Log in as root . Step 2. Enter the recor d ID number as show n [...]

  • Page 360

    Managing th e AMASS File System 4-60 U tility Refe rence 6-00028-0 1 Rev A Step 3. AMASS returns the f ile’ s full path as sho wn in the follo wing example: # /archive/swpubs/amass/chap2.fm6[...]

  • Page 361

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-61 fileprint Print the AM ASS File Syst em Databas e entry information for one of the follo wing: • File • Directory • Symbolic link The File System Database information includes: type of entry, field values, start of logical bloc k address, start of device block addres[...]

  • Page 362

    Managing th e AMASS File System 4-62 U tility Refe rence 6-00028-0 1 Rev A Example Step 1. The follo wing path and ut ility ex ample displa ys File System Database information for a file named testplan . -u Usage sta tement Print entry for the spec ified file. Ent er one of the followi ng: filename • A file name #rid • Or , the AMAS S database[...]

  • Page 363

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-63 The output looks similar to the display shown in the follo wing example: Step 2. The following path and utili ty example dis plays the same File System Dat abase information for the same file named testplan b ut instead uses its AMASS rid number . Or: # /usr/amass/utils/fi[...]

  • Page 364

    Managing th e AMASS File System 4-64 U tility Refe rence 6-00028-0 1 Rev A initamass Clear the e xisting AMASS File Syst em Database b y reinitializing it to an empty dat a base. T ypically , this is done only for disaster recovery . Options None Example Step 1. Log in as root . Step 2. If AMASS is activ e, run the command with the option sho wn in[...]

  • Page 365

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-65 initjournal Clear the e xisting tra nsaction log b y reinitia lizing it to an empty journal. T ypically , this is done only for disaster recov e ry . Exam ple Step 1. Log in as root . Step 2. If AMASS is acti ve, inacti va te AMASS with the option sho wn in the follo wing [...]

  • Page 366

    Managing th e AMASS File System 4-66 U tility Refe rence 6-00028-0 1 Rev A keyb uild Rebuil d the AMASS File System Database ke y tables. When to Use Utility For an example of when to use this ut ility , see “A M A S S Database is Bad” on page -6. Options Caution Use this utility onl y when AM ASS is not runni ng! /usr/amass/utils ./keybuild da[...]

  • Page 367

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-67 Exam ple Step 1. Log in as root . Step 2. If AMASS is acti ve, inacti va te AMASS with the option sho wn in the follo wing example. For command information, refer to killdaemons . Step 3. From the AMASS File Syst em Database directory , enter t he path, utility , and optio[...]

  • Page 368

    Managing th e AMASS File System 4-68 U tility Refe rence 6-00028-0 1 Rev A sysdbchk Sysdbchk is an AMAS S utility th at ve rif ies the consiste ncy of the AMA SS f ile sy stem an d either : •D i s p l a y s e r r o r s • Corrects error s When to Use Utility For an example of when to use this ut ility , see “A M A S S Database is Bad” on pag[...]

  • Page 369

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-69 Options /usr/amass/utils ./sysdbchk [-c dir ] [-d] [-h] [-i] [-l dir] [-q] [-y] Op tion Des crip tion no option Check onl y — do not correc t — errors -c dir Set dire ctory for tem porary cac he files to 'dir' (specifi ed directory) (new option) -d Check file[...]

  • Page 370

    Managing th e AMASS File System 4-70 U tility Refe rence 6-00028-0 1 Rev A Exam ple Step 1. Log in as root . Step 2. Because this utili ty modif ies the AMASS File System Database, first make a cop y of the AMASS database, /usr/filesysdb . Step 3. Enter the path and utility sho wn in the follo w ing example: # su root # /usr/amass/utils/sysdbchk No[...]

  • Page 371

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-71 The following figure illustrates the hierarchy that is created because AMASS found a lost file named “ misplaced_file .” The mountpoint is / archive . Step 4. For help in interpreti ng the sysdbchk output, see “Prepare to Contact T echnical Suppor t” on page -32. l[...]

  • Page 372

    Managing th e AMASS File System 4-72 U tility Refe rence 6-00028-0 1 Rev A vo l p r i n t Display the attributes for one of the follo wing: • One v olume • All v olume s Name Contention hp T ru64 UNIX only: Because AMASS and hp T ru64 UNIX both hav e a volprint utility , make sure you use the full path to dif f erentiate whose tool you want to [...]

  • Page 373

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-73 Options /usr/amass/utils ./volprint [-a] [-u] [-y] volumenumb er Option Descript ion no opt ions Displa y info rmatio n for all v olume s -a Display b oth tap e bloc k size and co mpressi on value s NOTE: By defaul t, tape blo ck siz e and compres sion a ttributes will no [...]

  • Page 374

    Managing th e AMASS File System 4-74 U tility Refe rence 6-00028-0 1 Rev A Exam ple Step 1. Log in as root . Step 2. T o display tape block size and compression values for v olume six, enter t he path, utility , and options sho wn in the following e xample: The output is illust rated in the follo wing example : Output Fie lds Defined The follo wing[...]

  • Page 375

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-75 Flags Status of volum e, not v olume group : • A = V olume is Acti v e • C = V olum e is being volcompr essed o r a volcompress pr ocedure has a bor ted. A fter volcompress ion complete s, the volume is mar ked Inactive . • I = V olum e is Inacti v e • K = Reser ve[...]

  • Page 376

    Managing th e AMASS File System 4-76 U tility Refe rence 6-00028-0 1 Rev A Field Descript ion Dead Blocks Amoun t of previously w ritten space on the vol ume that is no lo nger refe renced by files This is expresse d as a percentag e of th e total vo lume space; t he hig her the percentage , the g reater th e amount o f dead space. NO TE: Volumes w[...]

  • Page 377

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Utility Reference 4-77 writecachemru Allo w AMASS to use WRITE ca che blocks before READ cache blocks. Consequently , READ cache blocks are used last. Options /usr/amass/bin ./writecachemru [-de] [-u] Option Descript ion -d (default) AMASS reu ses non-dirty or empty (data h as already b een writ[...]

  • Page 378

    Managing th e AMASS File System 4-78 U tility Refe rence 6-00028-0 1 Rev A[...]

  • Page 379

    5 T r ouble- shooting T ools[...]

  • Page 380

    Managing th e AMASS File System -2 T rouble shooting T ools 6-00028-0 1 Rev A NO TES[...]

  • Page 381

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools - 3 AMASS Appears Hung There is no AMASS activi ty , incl uding: • All dri ves in all libraries a re inacti v e • All v olume s are inacti ve T o correct, perform the f ollo wing steps: Step 1. Log in as root . Step 1. Run amass_tests script to identify storage de vice[...]

  • Page 382

    Managing th e AMASS File System -4 T rouble shooting T ools 6-00028-0 1 Rev A Cancel Outstand ing Requests Y ou ca n cancel an outstanding READ or WRITE request to the AMASS f ile system by using <Control C>, which is the standard UNIX interrupt signal. This can be used during normal AMASS operation. When there has been a f atal error in AMAS[...]

  • Page 383

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools - 5 Operating Issu es The follo wing table lists operating issues: Operating Sy stem Issues All AMASS suppor ts a file p athname li mit of 102 3 characters. For example, if files are goin g under /archiv e/oursitefile s on AMAS S, then the lengt h of this stri ng (21 chara[...]

  • Page 384

    Managing th e AMASS File System -6 T rouble shooting T ools 6-00028-0 1 Rev A AMASS Database is Bad An error message occurs that points to an AMASS File System Database problem. T o correct, perform the f ollo wing steps: Step 1. Log in as root . Step 2. Shut down AMAS S with the killdaemon script. Step 3. Lock the AMASS File Syst em Database: Step[...]

  • Page 385

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools - 7 Step 5. Check the inte grity of the AMASS Fil e System Database by running the dbcheck util ity: where: If dbcheck reports errors, proce ed to Step 6. , Ste p 7. , Step 8. , or Step 9. Otherwise, go to Step 10. # /usr/amass/utils/dbcheck -a /usr/filesysdb/filesv N # /u[...]

  • Page 386

    Managing th e AMASS File System -8 T rouble shooting T ools 6-00028-0 1 Rev A Step 6. T o resolve database key errors, run the AMASS keybuild utility . Examples of these errors a re illustrated i n the foll o wing ex ample: Run keybuild as follows: where: After running keybuild , rerun dbcheck on the affected database to make sure that all problems[...]

  • Page 387

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools - 9 Step 7. T o fix bad chain errors or deleted File System Database records, r un dchain . Examples of these errors are illustrat ed in the follo wing example : Run dchain as follo ws: * record is deleted, but is not on the delete chain Problems at record 0: *delete chain[...]

  • Page 388

    Managing th e AMASS File System -10 Troubleshoot ing T ools 6-00028-0 1 Rev A where: After running dchain , rerun dbcheck on the affected database to make sure that all problems are fixed. If successful, reboot the system so AMASS can sta rt. Step 8. T o resolve -907 T AF/log f ile errors (database will not lock), follo w the suggestion in thi s st[...]

  • Page 389

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -11 Verify that the lock has been set by using the ls -la /usr/amass/fslock1 command. After the problem has been resolved, rerun dbcheck on the affected databa se to make sure that all problems are fixed. If succe ssful, reboot the system so AMASS can start. Step 9. T o re[...]

  • Page 390

    Managing th e AMASS File System -12 Troubleshoot ing T ools 6-00028-0 1 Rev A A) Generate the PID of the lm_ip process b y using the UNIX ps command. If the lm_ip process is running, stop the process by using the kill -9 comma nd with the pid option, which is the number from the second column (915) shown in the above example. If the lm_ip process i[...]

  • Page 391

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -13 B) Run ifconfig adapt er and compare th e inet address to the expec ted IP address. Use the following table to dete rmine th e default prima ry Ethernet adapte r: C) If you are using Domain Name Service (DNS), is the DNS running? D) If you are using DNS, is there a rou[...]

  • Page 392

    Managing th e AMASS File System -14 Troubleshoot ing T ools 6-00028-0 1 Rev A Rerun the sysdbchk utili ty without the -y opt ion to make sure that all errors have be en fixed. Examples of errors re turned by this utility are i llustrated in the follo wing example. Step 11. If the above procedures are not able to fix the database problems, restore t[...]

  • Page 393

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -15 • Make sure the Backup V olume is in the correc t dri ve in the library . If there is another volume in the drive, return it to its home slot by using the following utility. where: Step 12. Restore the AMASS File System Database and journal by entering the follo wing[...]

  • Page 394

    Managing th e AMASS File System -16 Troubleshoot ing T ools 6-00028-0 1 Rev A AMASS Does Not Star t AMASS does not start. T o correct, perform the f ollo wing steps: Step 1. Log in as root . Step 2. Use the amass_log script to display t he system log messages. For more information on t his script, see “amass_log” on page 4-7. Make sure the mess[...]

  • Page 395

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -17 UNIX Serve r’ s P artitions Cras h An AMASS partition on the UNIX server’ s hard disk crashes. T o correct, perform the a ppropriate steps in the follo wing procedure. If Jo urnal P ar titio n Crashes If the journal ( /home/filesysdbjournal ) partition c rashes, pe[...]

  • Page 396

    Managing th e AMASS File System -18 Troubleshoot ing T ools 6-00028-0 1 Rev A Step 5. T o restore the File System Database and journal, from the Backup V olume enter the follow ing command and options: where: Step 6. Copy your intact AMASS Fi le System Database ( /home/filesysdb ) from Step 2. to the database partition. # amassrestore -v -D drivenu[...]

  • Page 397

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -19 Step 7. Start AMASS using amass_start as sho wn in the following e xample: If Database P ar tition Crashes If the AMASS File Syste m Database ( /usr/filesys db ) partition cras hes, perform the follo wing steps: Step 1. Log in as root . Step 2. Copy the journal ( /home[...]

  • Page 398

    Managing th e AMASS File System -20 Troubleshoot ing T ools 6-00028-0 1 Rev A Step 5. T o restore the database and journal from the Bac kup V olume, enter the follo wing command and options: where: Step 6. Copy your intact AMASS journal ( /home/filesysdb/journal ) from Step 2. to the journal partition. # amassrestore -v -D drivenumber -P slot V alu[...]

  • Page 399

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -21 Step 7. Start AMASS using amass_start as sho wn in the following e xample: If Cac he P ar tition Crashes Y ou have lost all write transactions that were pending in the cache when t he crash occurred. # /usr/amass/tool/amass_start /ar chive[...]

  • Page 400

    Managing th e AMASS File System -22 Troubleshoot ing T ools 6-00028-0 1 Rev A Requests Not Getting to Librar y AMASS is running b ut is not beha ving as e xpected, for example, I/O requests are not going to the library . T o correct, perform the f ollo wing steps: Step 1. Log in as root . Step 2. Use the amass_log script to display the system log m[...]

  • Page 401

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -23 System P anics If a process causes a system panic, dump information to the core (memory) fi le. Sa ve this f ile because it contains clues about what was going wrong when system came do wn. T o set your server to automatically dum p data to the core fi le, perform the [...]

  • Page 402

    Managing th e AMASS File System -24 Troubleshoot ing T ools 6-00028-0 1 Rev A IBM Step 1. When the AIX operating system was installed, a dump de vic e is automati cally configured. The default on most m odels is /dev/hd7 . Step 2. When the system panics, it automatically dumps information to the cor e file and the LEDs on the front of the processor[...]

  • Page 403

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -25 Step 3. After information has bee n dumped, enter the follo wing: Step 4. The / dir direc tory should contai n entries similar to those sho wn in the following e xa mple. If more than one core has been dumped, there will be files with extensio ns greater than ze ro. Th[...]

  • Page 404

    Managing th e AMASS File System -26 Troubleshoot ing T ools 6-00028-0 1 Rev A Command Gives U ne xpected Results A command gi ves an une xpe cted result. T o correct, perform the f ollo wing steps: Step 1. Log in as root . Step 2. Use the quedisplay utility t o make sure the command is sho wing up in the queue. For more information on this util ity[...]

  • Page 405

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -27 Step 7. If the problem persists, run the script command, which prints a line sim ilar to the foll o wing: Try th e com mand agai n. After typing exit , a line similar to the following is printed: A file called typesc ript is created i n the curre nt directory that cont[...]

  • Page 406

    Managing th e AMASS File System -28 Troubleshoot ing T ools 6-00028-0 1 Rev A Librar y or Drive is Nonfunct ional A library or driv e does not function as expected. T o correct, perform the f ollo wing steps: Step 1. Ensure that power is ON for the library and the communicati ons cables are securely a ttached to t he library and to the server where[...]

  • Page 407

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -29 P ower F ailu re After a system is rebooted because of a power failure, AMASS attempts t o automat ically run t he amassrecovery utility , which starts AMASS and reco vers an y files in the cache. Instead, AMASS displays an “fil ename has append record flags set but [...]

  • Page 408

    Managing th e AMASS File System -30 Troubleshoot ing T ools 6-00028-0 1 Rev A Messages Generated by AMASS AMASS generates the foll owing types of messages: • Operator Inter activ e Me ssages • T echnical Support Messages • Customer-specif ic Messages These messages types are desc ribed belo w . Operator In teractive Messages Because mos t AMA[...]

  • Page 409

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -31 These system log messages help you to: assess system operation, resolve problems, check system health, and monitor performance. For location of the system log and correcti ve action for messages, refer to Err ors and Corr ective Action .[...]

  • Page 410

    Managing th e AMASS File System -32 Troubleshoot ing T ools 6-00028-0 1 Rev A Prepare to Contac t T echnical Suppor t Depending on how you purchased technical support, telephone support is provided either through your reseller or directly through ADIC. The ADIC T echnic al Assistance Center in Den ver , Colorado provides world-wide service and supp[...]

  • Page 411

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Troubleshoo ting Tools -33 Step 4. Obtain the follo wing information: • AMASS Serial Number: _________________ • Site ID: ______________________________ Step 5. Contact technical support and be prepared to suppl y the above information to t hem.[...]

  • Page 412

    Managing th e AMASS File System -34 Troubleshoot ing T ools 6-00028-0 1 Rev A NO TES[...]

  • Page 413

    A Bac kup Scripts f or HP-UX[...]

  • Page 414

    Managing th e AMASS File System A-2 Backup Sc ripts for HP- UX 6-0 0028-01 R ev A NO TES[...]

  • Page 415

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Bac kup Scripts for H P-UX A -3 Backup Example f or Small File Syste ms The script below performs: • A complete backup ev ery Friday (day 5) of all the files in a specified v olume group. • A partial backup ev ery other da y of the week (Monday through Thursday) of the files in the specified[...]

  • Page 416

    Managing th e AMASS File System A-4 Backup Sc ripts for HP- UX 6-0 0028-01 R ev A # # Shell variables: # TEMPFILE - temporary location for # file listing # MOUNTPT - the directory where the # amass is mounted # # Output: # A set of tapes the can be used to # restore user files to an AMASS system # # Warning: # This process can take a very long time[...]

  • Page 417

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Bac kup Scripts for H P-UX A -5 then if [ -f /etc/archivedate ] then /bin/mv /etc/archivedate ŽŽŽŽŽ /etc/archivedate.AMASS fi >/etc/archivedate TEMPFILE=/tmp/FILES$$ for disk in `/usr/amass/bin/vollist | awk ’ $2==’$VOLNUM’ {print $1}’` do /usr/amass/bin/volfilelist $disk ?[...]

  • Page 418

    Managing th e AMASS File System A-6 Backup Sc ripts for HP- UX 6-0 0028-01 R ev A Backup Example f or Large File System s The follo wing script backs up data on lar ge file sys tems. Consequently , a full backup comp letes ov er an extended per iod of time, usually one month. Step 1. On the first day of the month (day 1) the script generates tw o l[...]

  • Page 419

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Bac kup Scripts for H P-UX A -7 #!/bin/sh set -a # abackup # # Purpose: # Store AMASS file system to tape. # Create a complete filelist of a given # volume group in units of N volumes on # an amass system for any streaming # backup utility/peripheral that can # accept filename data to stdin such[...]

  • Page 420

    Managing th e AMASS File System A-8 Backup Sc ripts for HP- UX 6-0 0028-01 R ev A # # Output: # A set of tapes the can be used to # restore user files to an amass system # # Warning: # The output filelists can be very # large. # Estimate 1 mb per 15,000 files. # This script uses the day of the # month to index the appropriate file # to be stored an[...]

  • Page 421

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Bac kup Scripts for H P-UX A -9 >${TEMPFILE} >/tmp/BACKUPFILES cd / cd ${MOUNTPT} if [ -f /etc/archivedate ] then # find . -newer /etc/archivedate -print >/tmp/BACKUPFILES echo “ ” else >/etc/archivedate fi if [ ${DAYTYPE} = 1 ] then /bin/mv /etc/archivedate /etc/archivedate.AMAS[...]

  • Page 422

    Managing th e AMASS File System A-10 Backup Scripts for HP-UX 6-00028-0 1 Rev A done if [ -f ${TEMPFILE} ] then cat ${TEMPFILE} | sort +1n +2n | awk ’{print $1}’ > /tmp/AMASSOUT${FILEINDEX} rm ${TEMPFILE} fi else find . -newer /etc/archivedate -print >/tmp/BACKUPFILES fi if [ -f /tmp/AMASSOUT${DAYTYPE} ] then cat /tmp/AMASSOUT${DAYTYP[...]

  • Page 423

    B Fine-tune Bloc k Siz e[...]

  • Page 424

    Managing th e AMASS File System B-2 Fine- tune Block Size 6-0 0028-0 1 Rev A NO TES[...]

  • Page 425

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Fine -tune Blo ck Size B-3 Optimiz e T ape B loc k Siz e Overall system performance is generally improv ed by conf iguring the block size that AMASS uses to write to a tape dri ve. T ape block size is conf igured with the volformat -b blocksize command. Y ou ca nnot change block size on exist in[...]

  • Page 426

    Managing th e AMASS File System B-4 Fine- tune Block Size 6-0 0028-0 1 Rev A • Read the dri ve manufacturers published data on yo ur dri v e’ s performance and block size Some of these pa ramete rs are described belo w . Correlate with File Size T o improv e performance on file sy ste ms with lar ge files , it is generally better to ha ve AMASS[...]

  • Page 427

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Fine -tune Blo ck Size B-5 Correlate with READ-BLOCK LIMIT A SCSI dri ve writes to tape in a fix ed block segment determined by t h e READ-BLOCK LIMIT of t he driv e. This means th at at the end of e very write, the last block se gment may hold less than one full block of data. Although this may[...]

  • Page 428

    Managing th e AMASS File System B-6 Fine- tune Block Size 6-0 0028-0 1 Rev A T o dete rmine t he READ-BLOCK LIMIT v alue, refer to your dri ve’ s manual. Y our goal is to ha ve a c omplete f ile fit into a tape block segment, without having partially fil led segments as illustrated abo ve. T o calculate vali d bloc k size v alues, multiply the mi[...]

  • Page 429

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Fine -tune Blo ck Size B-7 Each tape block can be configured as: MAXIOS Z = 256 KB 16 KB 16 KB 16 KB 16 KB 32 KB 32 KB 32 KB 32 KB 64 KB 64 KB 64 KB 64 KB 128 KB 128 KB 128 KB 128 KB 256 KB 256 KB 256 KB 256 KB Minimum = 16 KB 16 x 2 = 32 KB 32 x 2 = 64 KB 64 x 2 = 128 KB 128 x 2 = 256 KB Driv e[...]

  • Page 430

    Managing th e AMASS File System B-8 Fine- tune Block Size 6-0 0028-0 1 Rev A NO TES[...]

  • Page 431

    C Cache Commands[...]

  • Page 432

    Managing th e AMASS File System C-2 Cache Comma nds 6-00028-0 1 Rev A NO TES[...]

  • Page 433

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Cache Co mmand s C-3 Cache Commands Using ne w AMASS commands, you can no w a ssign cache block list v alues for reads and writes per volume group. If you do not use the Enhanced Cache C ontrol feature, AMASS reuses the cache block at the hea d of the free list, which is the oldest cache block i[...]

  • Page 434

    Managing th e AMASS File System C-4 Cache Comma nds 6-00028-0 1 Rev A Options /usr/amass/bin ./setcblist -uy [-r read_list volumegroup ] [-w write_list volume group ] Option Descript ion -u Usage st atement -y Suppres s confir mati on and informati onal m essages -r r ead_list volume gr oup (defaults to 1 cac he list va l ue ) Assig n the specifi e[...]

  • Page 435

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Cache Co mmand s C-5 Output The example belo w illustrates how to assi gn volume group 126 both a read and write cac he block list v alue of 2: The follo wing e xample illustrates ho w to assign v olume gr oup 52 a write cache block list value of 6: cblist Displays the read and write cache block[...]

  • Page 436

    Managing th e AMASS File System C-6 Cache Comma nds 6-00028-0 1 Rev A Options Output The example belo w illustrates how to display cache block list v a lues for volume group 52: /usr/amass/bin ./cblist -uy vo lumegr oup Option Descript ion -u Usage statement -y Suppres s confir mati on and in f o rm ational message s volume gr oup Enter a spec ific[...]

  • Page 437

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Cache Co mmand s C-7 The example belo w illustrates how to display cache block list v a lues for v olume groups 121 through123: setcbwght Assigns weight factor v alues to the cache block list numbers. AMASS uses this weight factor to determine which cache block to reuse next and reuses the cache[...]

  • Page 438

    Managing th e AMASS File System C-8 Cache Comma nds 6-00028-0 1 Rev A Options /usr/amass/bin ./setcbwght -uy cachelist_number weight_factor Option Descript ion -u Usage statement -y Suppres s confir mati on and in f o rm ational message s cachelist_number Enter a cache block list value from 1 through 8 . weight _facto r (defaults to 1) Enter a weig[...]

  • Page 439

    Mana ging th e AMAS S F ile S yst em 6-00028-01 Rev A Cache Co mmand s C-9 Output The example belo w illustrates how to set cache block list 8 for a weight factor of 100: cbwghtlist Displays the weight factor v alues for e ach cache block list. Output The follo wing exam ple illustrate s a sample out put: # su root # setcbwght 8 100 Changing weight[...]

  • Page 440

    Managing th e AMASS File System C-10 C ache Comma nds 6-00028-0 1 Rev A NO TES[...]

  • Page 441

    6-0002 8-01 Rev A Inde x INX- 1 Inde x Symbols /usr/amass/bin . . . . . . . . . . . . . . . . . . 3-3 /usr/amass/daemons . . . . . . . . . . . . . . 4-3 /usr/amass/tools . . . . . . . . . . . . . . . . . 4-3 /usr/amass/utils. . . . . . . . . . . . . . . . . . 4-3 A ACSLS library interface . . . . . . . . . . . . . 3-42 adf Command . . . . . . . . .[...]

  • Page 442

    Manag ing the A MASS File System INX-2 Ind ex 6-0002 8-01 Rev A cdimport . . . . . . . . . . . . . . . . . . . 3-50 dirfilelist . . . . . . . . . . . . . . . . . . . 3-56 driveclean . . . . . . . . . . . . . . 3-61 , 3-66 drivededicate . . . . . . . . . . . . . . . 3-68 drivelist . . . . . . . . . . . . . . . . . . . 3-70 drivestat . . . . . . . . [...]

  • Page 443

    Managing the AMASS File System 6-0002 8-01 Rev A Inde x INX- 3 Drive function not as expected . . . . . . 5-28 Redwood tape length . . . . . . . . 3-103 return to service . . . . . . . . . . . . . 2-17 standalone interface . . . . . . . . . . 3-93 take out of service . . . . . . . . . . . 2-16 tape . . . . . . . . . . . . . . . . . . . . . . . 4-46[...]

  • Page 444

    Manag ing the A MASS File System INX-4 Ind ex 6-0002 8-01 Rev A offline . . . . . . . . . . . . . . . . . . . . . 2-25 recycle . . . . . . . . . . . . . . . . . . . . 2-21 redundant for backup . . . . . . . . . 2-15 remove from library . . . . . . . . . . 2-23 return to slot . . . . . . . . . . . . . . . . 2-28 mediaeject Uti lity . . . . . . . . .[...]

  • Page 445

    Managing the AMASS File System 6-0002 8-01 Rev A Inde x INX- 5 AMASS path . . . . . . . . . . . . . . . . 4-3 amass_atboot . . . . . . . . . . . . . . . . 4-5 amass_log. . . . . . . . . . . . . . . . . . . 4-7 amass_snap . . . . . . . . . . . . . . . . . 4-9 amass_start . . . . . . . . . . . . . . . . . 4-10 amass_tests . . . . . . . . . . . . . . [...]

  • Page 446

    Manag ing the A MASS File System INX-6 Ind ex 6-0002 8-01 Rev A V vgexport Command . . . . . . . . . . . . 3-106 vgimport Command . . . . . . . . . . . . 3-111 vglist Command . . . . . . . . . . . . . . . 3-117 vgpool Command . . . . . . . . . . . . . . 3-120 vgreadonly Command . . . . . . . . . . 3-125 vgroot Command . . . . . . . . . . . . . . 3-[...]