Quantum Administrative Tasks User Manual

Administrative Tasks

VolServ Version 5.2

November 2003

6-01003-01 Rev A

Trademark Notice

AMASS, DataMgr, EMASS, FileServ, and VolServ are either trademarks or registered
trademarks of ADIC, Advanced Digital Information Corporation. DAS is a trademark of
Grau, an ADIC subsidiary. All other product names and identifications are trademarks or
registered trademarks of their respective manufacturers.

Copyright Notice

© 1996-2003 ADIC®. All rights reserved. This document is the property of ADIC. No part
of this document may be reproduced, transmitted, transcribed, stored in a retrieval system,
or translated into any language or computer language in any form or by any means,
electronic, mechanical, magnetic, optical, chemical, manual, or otherwise, without the
express written permission of:

ADIC USA
Tel.: [phone]
Fax: [phone]
ATAC: 1-800-827-3822
http://www.adic.com

ADIC Europe
ZAC des Basses Auges
1, rue Alfred de Vigny
78112 Fourqueux, France
Tel.: [phone]
Fax: [phone]

ADIC Germany Beteiligungs
GmbH, KG
Eschenstraße 3
D-89558 Böhmenkirch, Germany
Tel:[phone]

U.S. Government Rights Restricted

Use, duplication, or disclosure of either the software or documentation is subject to
restrictions set forth by the U.S. Government in FAR 52.227-19(c)(2) and subparagraph
(c)(1)(ii) of the Rights in Technical Data and Computer Software clause at DFARS 52.227­7013 and/or in similar or following clauses in the FAR, DoD, or NASA FAR Supplement.

Technical Assistance

ADIC Technical Assistance Center:

• In the USA and Canada, call 1-800-827-3822

• Outside the USA or Canada, call 303-874-0188 or toll-free 00800-9999-3822.

• Send e-mail to: [e-mail]

Documentation

Although the material contained herein has been carefully reviewed, ADIC does not
warrant it to be free of errors or omissions. We reserve the right to make corrections,
updates, revisions, or changes to the information contained herein.

• Send e-mail to: [e-mail]

READER COMMENT FORM

ADIC includes this Form in an effort to provide the best possible documentation to our
customers. Please take a few moments to mail or FAX your response to:

ADIC USA
Tel.: [phone]
Fax: [phone]
ATAC: 1-800-827-3822
http://www.adic.com

ADIC Europe
ZAC des Basses Auges
1, rue Alfred de Vigny
78112 Fourqueux, France
Tel.: [phone]
Fax: [phone]

ADIC Germany Beteiligungs
GmbH, KG
Eschenstraße 3
D-89558 Böhmenkirch, Germany
Tel:[phone]

Question Circle One

Information was complete. Agree Disagree
Information was easy to find. Agree Disagree
Information was easy to follow. Agree Disagree

Is there anything you especially like or dislike about the organization, presentation,
or writing in this manual?______________________________________________
___________________________________________________________________
___________________________________________________________________
___________________________________________________________________
_____________________________________________________________________

Book Title Document Number
Customer Name Telephone
E-mail Address
Company Name
Address
City, State, Zip

NOTES

Administrative Tasks

Preface

Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3

Who Should Read This Book . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3

How This Book is Organized . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-3

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-4

Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-5

Online Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-5

Related Publications . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-6

Contact Publications Department . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-6

Secured Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . P-6

Getting Started 1

Command Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

CLI and API Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3

GUI Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-6

Environment Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-12

Control Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13

Software Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-15

System Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-16

Configuration Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-17

Library Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-18

Archive Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-19

GUI Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-20

Process Server Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21

VolServ Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21

6-01003-01 Rev A Contents i

Administrative Tasks

CiReply Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-22

Archive Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-23

Configuration Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-24

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-25

VolServ Database . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-25

TCP/IP Interface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-25

printers.

config Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-27

Other .config Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-27

Start-up and Shutdown 2

Start-Up Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3

Start-Up VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-3

Start the System Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-5

Recovery Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6

Backup VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6

Shutdown Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7

Shutdown System Console . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7

Shutdown VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-8

Gracefully Terminate VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-9

Initial Configuration 3

Configure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3

Configure an Automated Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-4

Auto Check-in . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-9

Auto Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-12

ii Contents 6-01003-01 Rev A

Administrative Tasks

Configure a Manual Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-15

Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16

Register Archive with VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-18

Define a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-18

Create a Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-19

Media Class Name . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20

Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20

Class Capacity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20

Mountable By Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-22

High Mark Notification . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-22

Use Callbacks and Callback Information . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-23

Create an Archive Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-24

Archive Class Percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-24

Action Mode, Low Mark, High Mark . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-26

Migration Priority and Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-31

Preferred Media Placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-31

Create a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-32

Associate a Drive with an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-33

Define a Label Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-34

Add Media to an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-35

Normal Operations 4

Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4

Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4

Command Priorities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5

Command Cancellation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5

6-01003-01 Rev A Contents iii

Administrative Tasks

Archive Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6

Configure/ Reconfigure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6

Delete an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6

Change Archive Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7

Vary Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-7

Vary Archive Component . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

Redefine a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8

Create/Modify/ Delete a Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9

Create/Modify an Archive Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-9

Delete an Archive Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-10

Define Media Migration Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-10

Modify Media Migration Policy . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-12

Add Archive to Existing Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-14

Audit an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-14

Drive Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16

Create and Associate a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16

Disassociate and Delete a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-16

Create or Modify a Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-17

Delete a Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-18

Mount Media on a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-18

Dismount Media from a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-21

Intransit Media (Mount) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

Lock a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

Unlock a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

Vary Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22

Media Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-24

Enter Unknown Media into an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-24

Enter Known Media into an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-29

iv Contents 6-01003-01 Rev A

Administrative Tasks

Remove Media from an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31

Clear Eject List Entries . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-33

Move Media to Another Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Intransit Media (Move) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Modify Media Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34

Define a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-35

Reclassify Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-36

Define or Delete a Label Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-37

Reprint a Media Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-37

System Reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-39

Query Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-39

Query Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-42

Query Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-44

Query Mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-46

Query Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-46

Query Media Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-49

Query Intransit Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-51

Query Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-52

Query Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-57

Query Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-58

Query Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-59

CIient Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

Disconnect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

Multimount Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61

6-01003-01 Rev A Contents v

Administrative Tasks

Archive Operations 5

Automated Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3

Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-4

Eject Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6

Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7

Unsolicited Enter Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-10

Manual Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11

Enter Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-11

Eject Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

Mount Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

Dismount Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12

Reprint Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13

Troubleshoot 6

Troubleshoot Resources . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-3

User Environment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-5

Initialization/Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-9

Archive Specific Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-13

General Database Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-15

Printer Issues . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .6-16

vi Contents 6-01003-01 Rev A

Preface

Purpose of This Book . . . . . . . . . . . . . . . . . . . . . . .P-3

Who Should Read This Book . . . . . . . . . . . . . . . .P-3

How This Book is Organized . . . . . . . . . . . . . . . .P-3

Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-4

Books . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .P-5

Online Books . . . . . . . . . . . . . . . . . . . . . . . . . . .P-5

Related Publications . . . . . . . . . . . . . . . . . . . .P-6

Contact Publications Department . . . . . . . . .P-6

Secured Web Site . . . . . . . . . . . . . . . . . . . . . . .P-7

P

Preface

Administrative Tasks

NOTES

P-2 Preface 6-01003-01 Rev A

Administrative Tasks

Preface

Purpose of This Book

Who Should Read This Book

How This Book is Organized

This book describes the management tasks used to operate
VolServ.

This book is written for the system administrator who is
operating and troubleshooting VolServ.

It assumes the administrator has a strong familiarity with:

• UNIX operating systems

• Applications running in their site environment

This book contains the following chapters:
Chapter 1: Getting Started — Introduces the document and it’s

conventions. Also contains general software installation information.

Chapter 2: Start-up and Shutdown — A discussion of VolServ

system operation pertaining to equipment and software start-up and
shutdown

.

Chapter 3: Initial configuration —

system operations pertaining to initial software and site-dependant
parameter definition.

Chapter 4: Normal Operations — A discussion of normal

VolServ system operations including environment management,
archive management, drive management, media management,
system queries, and database maintenance.

Chapter 5: Archive Operations — A discussion of the VolServ

Archive Operator and applicable capabilities.

6-01003-01 Rev A Preface P-3

A discussion of VolServ

Administrative Tasks

Chapter 6: Troubleshoot — Troubleshooting tips for VolServ

software problems.

Conventions

The conventions used throughout the VolServ technical books
are listed below:

Convention Example

Screen text, file names, program names, and
commands are in Courier font.

The root prompt is shown as a number
symbol.

What you should type in is shown in Courier
bold font.

Site-specific variables are in a Times italics
font.

A backward slash ( \ ) denotes the input is
continued onto the next line; the printed page
is just not wide enough to accommodate the
line.

Pressing <Return> after each command is
assumed.

Request to add a new volume:
Volume group will be “20”
Volume position will be “A123”.

# su root

vsarchiveqry

tar -xvf tapedevicename

#

remsh nodename -n dd if=/dev \

/tapedevicename/bs=20b | tar xvfb \

- 20

(You should type the entire command witho ut
the backward slash.)

A menu name with an arrow refers to a
sequence of menus.

P-4 Preface 6-01003-01 Rev A

Config-->MediaType-->Redefine

Administrative Tasks

Preface

Books

The books described below are part of the technical
documentation set, and are shipped on CD along with the
VolServ software:

Overview

Provides an ov erview of VolServ . Co ntains a
glossary.

Installing VolServ
Describes server requirements, installation
instructions, troubleshooting procedures,
and configuration parameters.

Using the VolServ GUI

Describes how to perform system
administrative tasks using th e graphical user
interface.

API Guide

Provides a list of API functions.

Administrative Tasks

Describes how to perform system
administrative tasks using VolServ
commands.

Command Reference

Contains a list of VolServ commands

Error Messages

Provides corrective action f or system log
errors.

Quick Reference Card

Summarizes commands.

Online Books

The documentation CD contains VolServ book files and
requires the Adobe® Acrobat® Reader to view the

accompanying electronic documentation. The Reader allows
you to view and navigate the electronic documentation files yet
preserves the page design and graphics from the printed books.

6-01003-01 Rev A Preface P-5

Administrative Tasks

Related Publications

Related Publications Description

“Release Notes” For each version of VolServ, the “Release Notes” contain:

“Product Alerts” Informs customers of technical problems and solutions.
“Product Bulletins” Conveys technical information—not problems—to

The publications described in the table below are created and
distributed on an as-needed basis.

• Summary of enhancements

• Describes:

- Fixed problems

- Known problems

- Installation and configuration issues

•Lists:

- Operating system patches

- System requirements

customers.

Contact Publications Department

Secured Web Site

To make corrections or to comment on VolServ publications,
please contact Software Technical Publications at our e-mail
address: [e-mail].

To receive access to the secured site on our home page
containing technical product information (Release Notes,
Product Alerts, Product Bulletins, FAQs), visit
http://partners.adic.com/ and follow the password request
procedure. In return, ADIC will send you instructions and a
password.

P-6 Preface 6-01003-01 Rev A

Command Access . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3

CLI and API Access Control . . . . . . . . . . . . . . 1-3

GUI Access Control . . . . . . . . . . . . . . . . . . . . . 1-6

Environment Management . . . . . . . . . . . . . . . . .1-12

1

Control Access . . . . . . . . . . . . . . . . . . . . . . . .1-13

Software Protection . . . . . . . . . . . . . . . . . . . . 1-15

System Logging . . . . . . . . . . . . . . . . . . . . . . .1-16

Configuration Environment . . . . . . . . . . . . . 1-18

Library Defaults . . . . . . . . . . . . . . . . . . . . . . . 1-19

Archive Dispatcher . . . . . . . . . . . . . . . . . . . . 1-20

GUI Environment . . . . . . . . . . . . . . . . . . . . . . 1-21

Process Server Defaults . . . . . . . . . . . . . . . . .1-22

VolServ Defaults . . . . . . . . . . . . . . . . . . . . . . 1-23

CiReply Environment . . . . . . . . . . . . . . . . . .1-23

Archive Defaults . . . . . . . . . . . . . . . . . . . . . . 1-24

Configuration Logging . . . . . . . . . . . . . . . . . 1-27

Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-27

VolServ Database . . . . . . . . . . . . . . . . . . . . . . 1-28

TCP/IP Interface . . . . . . . . . . . . . . . . . . . . . . 1-28

printers.config Files . . . . . . . . . . . . . . . . . . . . . . . 1-29

Other .config Files . . . . . . . . . . . . . . . . . . . . . 1-29

Getting Started

Getting

Started

Administrative Tasks

Roadmap

Topic

General software access information 1
Hardware and software start-up 2
Site-specific configuration of archives and drives 3
Daily operations 4
Archive operation and configuration 5
Troubleshooting tips and solutions 6

Refer To
Chapter

1-2 Getting Started 6-01003-01 Rev A

Administrative Tasks

Command Access

CLI and API Access Control

After VolServ is installed, the VolServ System Administrator
(SA) configures the VolServ environment to control Command
Line Interface (CLI), Application Program Interface (API), and
Graphical User Interface (GUI) access to the VolServ system.
The following sections provide a recommended plan for
controlling access to specific VolServ software commands.

The commands available to any application via CLI or API are
controlled by the command.config file, which is located in
the directory $VS_DIR/config. There are entries in the

command.config file for each command available over the

CLI or API. The SA can control access to individual commands
by editing the command.config file and commenting out the
command not authorized. Individual commands can also be
disallowed by using the GUI Client Commands windo w. Refer
to the Using the VolServ GUI or the appropriate VolServ
software manual.

A client application is a hardware/software package performing
data management service for the user or as an intermediary to
other client programs. Although the CLI may be used, client
applications primarily interact with VolServ through the API.
Each client application generates volume server requests
through the API for selected VolServ software commands.

Getting Started

6-01003-01 Rev A Getting Started 1-3

Administrative Tasks

The commands available to a client application are sho wn in the
following table.

Capability Description

Media Operations

Import Media Inserts media into the system and update the VolServ

database with the new media identifiers.

Export Media Removes media from the system and any knowledge of the

media identifier from the VolServ database.

Check-in Media Logically checks media into the VolServ system that were

checked out.
Check-out Media Checks media out of an archive.
Clear Eject Removes the specified media from the archive’ s Eject list.
Mount Media Mounts a medium into a drive.
Multimount Media Allows multiple mount requests for multiple drives.
Dismount Media Dismounts a medium from a drive.
Modify Media Allows the addition of media statistics, manufacturer, and

batch information to be associated with a medium or media.
Move Media Moves media from one archive to another.
Reclassify Media Changes the media class group name of a medium or med ia.

Administration

Audit Performs an archive inventory verification.
Connect Allows request status to be routed to a different location

using the enterprise identifier for location.
Disconnect Removes the location established by the connect command.
Vary Archive Changes the state of the archive from On-Line, Off-Line, or

Diagnostic.

1-4 Getting Started 6-01003-01 Rev A

Administrative Tasks

Capability Description

Vary Drive Changes the state of the archive from On-Line, Off-Line,

Diagnostic, or On-Line/Clear.
Cancel Request Cancels requests based on request identifier.
Reprioritize Request Changes the priority level of a request.
Lock Drive Obtains exclusive use of one or more drives.
Unlock Drive Releases exclusive use of one or more drives.

Configure

Create Drive Pool Associates a group of drive types having the same

characteristics with a logical group name.
Modify Drive Pool Changes the parameters associated with a drive pool.
Delete Drive Pool Removes a drive pool from the system.
Create Media Class Creates a Media Class in the VolServ system.

Getting Started

Modify Media Class Modifies a Media Class’ parameters.
Delete Media Class Removes a Media Class from the VolServ system.
Create Archive Media Class Associates a Media Class with an archive.
Modify Archive Media Class Modifies the parameters associated with an archive Media

Class.
Delete Archive Media Class Removes an archive Media Class from the VolServ system.

Queries

Query Archive Repor t showing information about an archive.
Query Drive Report showing information about a drive or drives.
Query Driv e Pool Report showing inf ormation about a specified drive pool or all

drive pools known to the VolServ system.
Query Mount Report showing information about drives that could be used

in a subsequent mount of a specified medium .

6-01003-01 Rev A Getting Started 1-5

Administrative Tasks

Capability Description

Query Media Report showing the attributes of one or more specified

media.

Query Intransit Media Report showing information about media that are in the

Intransit state.

Query Media Class Report showing the attributes of a specified Media Class or

all Media Class known to the VolServ system.
Query Media Type Report showing the attributes of one or more media types.
Query Request Report showing inform ation about a specified request.
Query Connect Report showing enterprise connection information.

The client application permissions can be changed at any time.
To make the changes effective, VolServ must be cycled.

GUI Access Control

The commands available via the GUI are controlled by the

operator.config file, which is located in the
$VS_DIR/config directory. There are entries in the
operator.config file for each command available through

the GUI. The SA can control access to individual GUI
commands by editing the operator.config file and
commenting out the command not authorized. Individual
commands can also be disallowed by using the GUI Operator
Commands window. Refer to Using the VolServ GUI or the
appropriate VolServ software manual.

Although the CLI can be used, the System Operator (SO)
primarily uses the GUI to access VolServ software commands.

The SO may have the same privileges as the SA or a subset of
the privileges as determined by the SA.

1-6 Getting Started 6-01003-01 Rev A

Administrative Tasks

Separate access for the SA and SO is maintained through the
use of group permissions. If the SO’s user ID is defined in the

vsadmin group, the SO will have GUI access to the commands

defined by the SA in the operator.config file and the SO
will have CLI access to the commands def ined b y the SA in the

command.config file.

The following table shows the commands available to the SA
and the recommended commands for a SO.

Capability Description SA SO

Media Operations

Getting Started

Import Media Inserts media into the system

and updates the VolServ
database with the new media
identifiers.

Export Media Removes media from the

system and any knowledge of
the media identifier from the
VolServ database.

Check-in Media Logically checks media into the

VolServ system that were
checked out.

Check-out Media Checks media out of the

VolServ system.

Manual Eject Updates the VolServ database

for problem or jammed media
physically removed from the
VolServ system.

Clear Eject Removes the specified media

from the archive’s Eject list.

Mount Media Mounts a medium or media into

a drive.

XX

X

XX

XX

XX

XX

XX

6-01003-01 Rev A Getting Started 1-7

Administrative Tasks

Capability Description SA SO

Dismount Media Dismounts a medium from a

drive.

Modify Media Allows the addition of media

statistics, manufacturer, and
batch information to be
associated with a medium or
media.

Move Media Moves media from one archive

to another.

Reclassify Media Changes the Media Class

name of a medium or media.

Administration

Change Archive
Parameters

Performs an archive inventory
verification.

Vary Archive Changes the state of the

archive from On-Line, Off-Line,
or Diagnostic.

Vary Archive
Component

Changes the state of an archiv e
component from On-Line,
Off-Line, or Diagnostic.

XX

XX

XX

XX

XX

XX

XX

Vary Drive Changes the state of the

XX
archive from On-Line, Off-Line,
Diagnostic, or On-Line/Clear.

Cancel Request Cancels requests based on

XX
request identifier.

Reprioritize
Request

Unlock Drive Releases exclusive use of one

Changes the priority level of a
request.

XX

XX
or more drives.

Reprint Media
Label

1-8 Getting Started 6-01003-01 Rev A

Reprints media label for a
specific medium or media.

XX

Administrative Tasks

Capability Description SA SO

Configure

Configure Archive Adds an archive to the VolServ

system.

Create Drive Adds a drive to the VolServ

system.

Associate Drive Associates a drive with an

archive.

Disassociate Drive Disassociates a drive from an

archive.

Delete Drive Removes drive from the

VolServ system.

Create Drive Pool Associates a group of drives

types having the same
characteristics with a logical
group name.

Modify Drive Pool Changes the parameters

associated with a drive pool.

Delete Drive Pool Removes a drive pool from the

system.

Create Media
Class

Creates a Media Class in the
VolServ system.

X

X

Getting Started

X

X

X

X

X

X

X

Modify Media Class Modifies a Media Class’

X

parameters.

Delete Media Class Removes a Media Class from

X

the VolServ system.

Create Archive
Media Class

Modify Archive
Media Class

Associates a Media Class with
an archive.

Modifies the parameters
associated with an archive

X

X

Media Class.

6-01003-01 Rev A Getting Started 1-9

Administrative Tasks

Capability Description SA SO

Delete Archive
Media Class

Removes an archive Media
Class from the VolServ system.

Define Media Type Defines a me dia type to be

used within the VolServ system.

Define Label
Pattern

Adds a label pattern to the
VolServ system.

Queries

Query Archive Report showing information

about an archive.

Query Drive Report showing information

about a drive or drives.

Query Drive Pool Report showing information

about a specified drive pool or
all drive pools known to the
VolServ system.

Query Mount Report showing information

about drives that could be used
in a subsequent mount of a
specified medium.

X

XX

XX

XX

XX

XX

XX

Query Media
Location

Report showing where a
specific medium or media are

XX
located in the VolServ system.

Query Media Report sho wing the attributes of

XX
one or more specified media.

Query Intransit
Media

Report showing information
about media that are in the

XX
Intransit state.

Query Media Class Report showing the attributes of

XX
a specified Media Class or all
Media Classes known to the
VolServ system.

1-10 Getting Started 6-01003-01 Rev A

Administrative Tasks

Capability Description SA SO

Query Media T ype Report sho wing the attributes of

one or more media types.

Query Request Report showing information

about a specified request.

Query Connect Report showing enterprise

connection information.

XX

XX

Getting Started

XX

6-01003-01 Rev A Getting Started 1-11

Administrative Tasks

Environment Management

VolServ uses global variables that help define the system
environment. These v ariables are located in the *.config f iles
located in the $VS_DIR/config directory. The VS_DIR
environment variable contains VolServ home directory and is
defined during installation. These files include:

• command.config

• operator.config

• console.config

• console_locations.config

•envvar.config

• label_printers.config

• printers.config

• process.config

• servers.config
The environment v a riables contained in the *.config files are

edited by the SA to customize the software for a particular site
using a text editor. Default values containing embedded spaces
must be enclosed within double quotes. For example,

This value has embedded spaces: “4 2 6”
This value does not: 421

VolServ must be cycled when

*.config files are modified.

Upon restart, a service utility is called by various
processes/routines to establish the environment variable values
within the VolServ environment.

1-12 Getting Started 6-01003-01 Rev A

Administrative Tasks

To cycle VolServ, use volserv -t; for information, see

“Gracefully Terminate VolServ” on page 2-9. Also use the

volserv command; for information, see “Start-Up VolServ” on

page 2-3.

Control Access

These two files are used to control access to CLI, API, and GUI
commands. For information about these files, see “CLI and API

Access Control” on page 1-3 and see “GUI Access Control” on
page 1-6.

console.config File Messages are generated by VolServ to notify the user or SA of

VolServ software’s actions. Messages are displayed in response
to a command or when certain events occur.

Note

This file does not affect t he envvar.config file variable

SYSLOG_DISK_LEVEL

The console.config file, located in the $VS_DIR/config
directory, allows various system log messages to be saved to a
particular file. The log messages that are saved are based on
priority levels (i.e., trace, debug, error, etc.) set in the

console.config file. By default, all log files are located in

the $VS_DIR/logs directory. If the log file specified in the

console.config file does not exist, it is automatically

created.

Getting Started

The priority levels and formats used for system log messages
are described in the VolServ Error Messages book.

console_locations. config File

The

console_locations.config file located in the

$VS_DIR/config directory is a reference file for console

names; e.g., Workstation:0 used in the VolServ system.

6-01003-01 Rev A Getting Started 1-13

Administrative Tasks

Workstation entries in this file are accessible when using the
Change Archive Parameters command. Refer to the
appropriate VolServ software manual. Clicking the right mouse
button when using the Change Archiv e Parameters command
displays the console names contained in this file, allowing one
to be selected and automatically entered as the location for the
archive Console.

Any console not in this file can still be accessed, b ut it does not
appear when the right mouse button is clicked.

envvar.config File The envvar.config file contains variables that control

general VolServ activities. Refer to text contained in the

envvar.config file for more detailed information. The

variables in this file are grouped into the following categories:

Variable Description

Software Protection Established at the time of system

installation.

System Logging Modified as required for site

logging levels.

Configuration Environment Modified as required for de leting

an archive.
Library Defaults Default for query processing.
Archive Dispatcher Modified as required for archive

communications.
GUI Environment Established at the time of system

installation.
Process Server Default Modified as required for software

communications.
VolServ Defaults Modified as required for software

activation and termination.

1-14 Getting Started 6-01003-01 Rev A