Administrative Tasks
VolServ Version 5.0
September 2001
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
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
Software Documentation
10949 East Peakview Ave.
Englewood, CO 80111
FAX: 303-792-2465
E-mail: [email protected]
Question
Information was complete.
Circle One
Disagree
Agree
Agree
Agree
Information was easy to find.
Information was easy to follow.
Disagree
Disagree
Is there anything you especially like or dislike about the organization, presentation,
or writing in this manual?______________________________________________
___________________________________________________________________
___________________________________________________________________
___________________________________________________________________
_____________________________________________________________________
Book Title
Document Number
Telephone
Customer Name
E-mail Address
Company Name
Address
City, State, Zip
Download from Www.Somanuals.com. All Manuals Search And Download.
NOTES
Download from Www.Somanuals.com. All Manuals Search And Download.
Contents
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
Command Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-3
GUI Access Control . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-6
Control Access . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-13
Software Protection . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-15
System Logging . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-16
Library Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-18
Archive Dispatcher . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-19
601354 Rev A
i
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
VolServ Defaults . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .1-21
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
Recovery Processing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
Backup VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-6
Shutdown Software . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-7
Gracefully Terminate VolServ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2-9
Configure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-3
ii
Contents
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Auto Import . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-12
Configure a Manual Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-15
Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-16
Define a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-18
Create a Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-19
Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20
Class Capacity . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-20
Mountable By Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-22
Create an Archive Media Class . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-24
Archive Class Percentage . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-24
Migration Priority and Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-31
Preferred Media Placement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-31
Associate a Drive with an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-33
Define a Label Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-34
Add Media to an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3-35
Overview . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4
Backup . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-4
Command Priorities . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5
Command Cancellation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-5
601354 Rev A
Contents
iii
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Archive Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6
Configure/ Reconfigure an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-6
Redefine a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-8
Create/Modify/ Delete a 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
Delete a Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-18
Intransit Media (Mount) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22
Lock a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22
Unlock a Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-22
iv
Contents
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Remove Media from an Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-31
Intransit Media (Move) . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34
Modify Media Criteria . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-34
Define a Media Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-35
Define or Delete a Label Pattern . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-37
Query Archive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-39
Query Drive . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-42
Query Drive Pool . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-44
Query Mount . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-46
Query Request . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-58
Query Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-59
Connect . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .4-61
601354 Rev A
Contents
v
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Automated Archive Operations . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-3
Eject Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-6
Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-7
Eject Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
Mount Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
Dismount Media . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
Audit . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-12
Reprint Label . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .5-13
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
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
P-2
Preface
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This book describes the management tasks used to operate
VolServ.
Purpose of
This Book
This book is written for the system administrator who is
operating and troubleshooting VolServ.
Who Should
Read This
Book
It assumes the administrator has a strong familiarity with:
•
•
UNIX operating systems
Applications running in their site environment
This book contains the following chapters:
How This
Book is
Chapter 1: Getting Started — Introduces the document and it’s
conventions. Also contains general software installation information.
Organized
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 — A discussion of VolServ
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.
601354 Rev A
Preface
P-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Chapter 6: Troubleshoot — Troubleshooting tips for VolServ
software problems.
The conventions used throughout the VolServ technical books
are listed below:
Conventions
Convention
Example
Screen text, file names, program names, and Request to add a new volume:
commands are in Courierfont.
Volume group will be “20”
Volume position will be “A123”.
The root prompt is shown as a number
symbol.
# su root
What you should type in is shown in Courier vsarchiveqry
bold font.
Site-specific variables are in a Times italics
tar -xvf tapedevicename
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.
# remshnodename -n dd if=/dev \
/tapedevicename/bs=20b | tar xvfb \
- 20
(You should type the entire command without
the backward slash.)
Pressing <Return> after each command is
assumed.
A menu name with an arrow refers to a
sequence of menus.
Config-->MediaType-->Redefine
P-4
Preface
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The books described below are part of the technical
documentation set, and are shipped on CD along with the
VolServ software:
Books
Overview
Administrative Tasks
Provides an overview of VolServ. Contains a
glossary.
Describes how to perform system
administrative tasks using VolServ
commands.
Installing VolServ
Describes server requirements, installation
instructions, troubleshooting procedures,
and configuration parameters.
Command Reference
Contains a list of VolServ commands
Error Messages
Using the VolServ GUI
Provides corrective action for system log
errors.
Describes how to perform system
administrative tasks using the graphical user
interface.
Quick Reference Card
Summarizes commands.
API Guide
Provides a list of API functions.
The documentation CD contains VolServ book files and
Online Books
®
®
Adobe Acrobat Reader. The Reader allows you to view and
navigate the online documentation files yet preserves the page
design and graphics from the printed books.
601354 Rev A
Preface
P-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The publications described in the table below are created and
distributed on an as-needed basis.
Related
Publications
Related Publications
Description
“Release Notes”
For each version of VolServ, the “Release Notes” contain:
• Summary of enhancements
• Describes:
- Fixed problems
- Known problems
- Installation and configuration issues
• Lists:
- Operating system patches
- System requirements
“Product Alerts”
Informs customers of technical problems and solutions.
“Product Bulletins”
Conveys technical information—not problems—to
customers.
To make corrections or to comment on VolServ publications,
please contact Software Technical Publications at our e-mail
address: [email protected].
Contact
Publications
Department
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.
Secured Web
Site
P-6
Preface
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
System Logging . . . . . . . . . . . . . . . . . . . . . . . 1-16
Configuration Environment . . . . . . . . . . . . . 1-18
VolServ Database . . . . . . . . . . . . . . . . . . . . . . 1-28
Other .config Files . . . . . . . . . . . . . . . . . . . . . 1-29
1
Getting
Started
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Roadmap
Refer To
Chapter
Topic
General software access information
Hardware and software start-up
Site-specific configuration of archives and drives
Daily operations
1
2
3
4
5
6
Archive operation and configuration
Troubleshooting tips and solutions
1-2
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
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.
Command
Access
The commands available to any application via CLI or API are
controlled by the command.configfile, which is located in
the directory $VS_DIR/config. There are entries in the
command.configfile for each command available over the
CLI or API. The SA can control access to individual commands
by editing the command.configfile and commenting out the
command not authorized. Individual commands can also be
disallowed by using the GUI Client Commands window. Refer
to the Using the VolServ GUI or the appropriate VolServ
software manual.
CLI and API
Access Control
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.
601354 Rev A
Getting Started
1-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The commands available to a client application are shown 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
Clear Eject
Checks media out of an archive.
Removes the specified media from the archive’s Eject list.
Mounts a medium into a drive.
Mount Media
Multimount Media
Dismount Media
Modify Media
Allows multiple mount requests for multiple drives.
Dismounts a medium from a drive.
Allows the addition of media statistics, manufacturer, and
batch information to be associated with a medium or media.
Move Media
Reclassify Media
Administration
Audit
Moves media from one archive to another.
Changes the media class group name of a medium or media.
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
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Description
Vary Drive
Changes the state of the archive from On-Line, Off-Line,
Diagnostic, or On-Line/Clear.
Cancel Request
Reprioritize Request
Lock Drive
Cancels requests based on request identifier.
Changes the priority level of a request.
Obtains exclusive use of one or more drives.
Releases exclusive use of one or more drives.
Unlock Drive
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.
Removes a drive pool from the system.
Delete Drive Pool
Create Media Class
Modify Media Class
Delete Media Class
Create Archive Media Class
Modify Archive Media Class
Creates a Media Class in the VolServ system.
Modifies a Media Class’ parameters.
Removes a Media Class from the VolServ system.
Associates a Media Class with an archive.
Modifies the parameters associated with an archive Media
Class.
Delete Archive Media Class
Queries
Removes an archive Media Class from the VolServ system.
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.
601354 Rev A
Getting Started
1-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Description
Query Media
Report showing the attributes of one or more specified
media.
Query Intransit Media
Query Media Class
Report showing information about media that are in the
Intransitstate.
Report showing the attributes of a specified Media Class or
all Media Class known to the VolServ system.
Query Media Type
Query Request
Query Connect
Report showing the attributes of one or more media types.
Report showing information about a specified request.
Report showing enterprise connection information.
The client application permissions can be changed at any time.
To make the changes effective, VolServ must be cycled.
The commands available via the GUI are controlled by the
operator.configfile, which is located in the
GUI Access
Control
$VS_DIR/configdirectory. 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.configfile 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
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
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
vsadmingroup, the SO will have GUI access to the commands
defined by the SA in the operator.configfile and the SO
will have CLI access to the commands defined by the SA in the
command.configfile.
The following table shows the commands available to the SA
and the recommended commands for a SO.
Capability
Description
SA SO
Media Operations
Import Media
Inserts media into the system
and updates the VolServ
database with the new media
identifiers.
X
X
X
X
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.
X
Check-out Media
Manual Eject
Checks media out of the
VolServ system.
X
X
X
X
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.
X
X
X
X
Mount Media
Mounts a medium or media into
a drive.
601354 Rev A
Getting Started
1-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Description
SA SO
Dismount Media
Dismounts a medium from a
drive.
X
X
X
X
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.
X
X
X
X
Reclassify Media
Changes the Media Class
name of a medium or media.
Administration
Change Archive
Parameters
Performs an archive inventory
verification.
X
X
X
X
Vary Archive
Changes the state of the
archive from On-Line, Off-Line,
or Diagnostic.
Vary Archive
Component
Changes the state of an archive
component from On-Line,
Off-Line, or Diagnostic.
X
X
X
X
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.
X
X
X
X
X
X
X
X
Reprioritize
Request
Changes the priority level of a
request.
Unlock Drive
Releases exclusive use of one
or more drives.
Reprint Media
Label
Reprints media label for a
specific medium or media.
1-8
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Configure
Description
SA SO
Configure Archive
Adds an archive to the VolServ
system.
X
X
X
X
X
X
Create Drive
Adds a drive to the VolServ
system.
Associate Drive
Disassociate Drive
Delete Drive
Associates a drive with an
archive.
Disassociates a drive from an
archive.
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
Delete Drive Pool
Changes the parameters
associated with a drive pool.
X
X
X
X
X
X
X
Removes a drive pool from the
system.
Create Media
Class
Creates a Media Class in the
VolServ system.
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.
601354 Rev A
Getting Started
1-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Description
SA SO
Delete Archive
Media Class
Removes an archive Media
Class from the VolServ system.
X
Define Media Type
Defines a media type to be
used within the VolServ system.
X
X
X
X
Define Label
Pattern
Adds a label pattern to the
VolServ system.
Queries
Query Archive
Report showing information
about an archive.
X
X
X
X
X
X
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
X
X
X
Query Media
Location
Report showing where a
specific medium or media are
located in the VolServ system.
Query Media
Report showing the attributes of
one or more specified media.
X
X
X
X
Query Intransit
Media
Report showing information
about media that are in the
Intransitstate.
Query Media Class Report showing the attributes of
a specified Media Class or all
Media Classes known to the
X
X
VolServ system.
1-10
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Capability
Description
SA SO
Query Media Type
Report showing the attributes of
one or more media types.
X
X
X
X
X
X
Query Request
Query Connect
Report showing information
about a specified request.
Report showing enterprise
connection information.
601354 Rev A
Getting Started
1-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
VolServ uses global variables that help define the system
environment. These variables are located in the *.configfiles
located in the $VS_DIR/config directory. The VS_DIR
environment variable contains VolServ home directory and is
defined during installation. These files include:
Environment
Management
•
•
•
•
•
•
•
•
•
command.config
operator.config
console.config
console_locations.config
envvar.config
label_printers.config
printers.config
process.config
servers.config
The environment variables contained in the *.configfiles 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 *.configfiles 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
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
These two files are used to control access to CLI, API, and GUI
Control Access
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 the envvar.configfile variable
SYSLOG_DISK_LEVEL
The console.configfile, 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.configfile. By default, all log files are located in
the $VS_DIR/logsdirectory. If the log file specified in the
console.configfile does not exist, it is automatically
created.
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.configfile located in the
$VS_DIR/configdirectory is a reference file for console
names; e.g., Workstation:0used in the VolServ system.
601354 Rev A
Getting Started
1-13
Download from Www.Somanuals.com. All Manuals Search And Download.
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 Archive 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, but it does not
appear when the right mouse button is clicked.
envvar.config File
The envvar.configfile contains variables that control
general VolServ activities. Refer to text contained in the
envvar.configfile 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 deleting
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
VolServ Defaults
Modified as required for software
communications.
Modified as required for software
activation and termination.
1-14
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
CiReply Environment
Archive Defaults
Configuration Logging
Installation
Established at the time of system
installation.
Modified as required for each
archive (robotic and manual).
Modified as required for
debugging of interfaces.
Established at the time of system
installation.
VolServ Database
Established at the time of system
installation.
The software protection variables contained in the following
tables allow VolServ and associated archives to operate. These
variables should not be modified unless directed by ADIC
Technical Assistance Center (ATAC) personnel. VolServ must
be cycled for the changes to become effective.
Software
Protection
Variable Name
Default
Description
VOLSERV_LICENSE_STRING
Unique text string
Unique text string
Allows VolServ software to run.
<ARCTYPE>_LICENSE_STRING
Allows VolServ software to run
with a specific archive type.
601354 Rev A
Getting Started
1-15
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The following table illustrates the variables that can be
modified, as required, to choose logging levels for each site.
VolServ must be cycled for the changes to become effective.
System
Logging
Variable Name
Default
Description
NUM_LOG_DAYS
LOG_BACKUP_TIME
VS_LOG_SIZE
3
The maximum number of days of log files that
are saved by the movelog.shscript.
6
The number of hours between log backup
attempts.
5120
The size, in kilobytes, above which the VolServ
log files are saved and truncated by the
movelog.shscript.
SYSLOG_DISK_LEVEL
7
Two purposes:
All messages between this level and zero are
automatically routed to the file vslogfile. All
messages that are not routed elsewhere are
sent to this file. Used to catch messages that
are generated before routing has been
established. This is the first filter of messages,
it overrides the settings in console.config.
No messages with a greater level value are
able to be routed elsewhere. Used as an upper
limit to reduce message traffic.
Upper limit for the level of syslog messages that are generated for each software function.
LIB_SYSLOG_LEVEL
6
6
6
6
6
6
6
6
Library Scheduler
LIBMAN_SYSLOG_LEVEL
ARCDISP_SYSLOG_LEVEL
ARCMAN_SYSLOG_LEVEL
VSWIN_SYSLOG_LEVEL
CONSOLE_SYSLOG_LEVEL
CIREPLY_SYSLOG_LEVEL
CIREQUEST_SYSLOG_LEVEL
Library Manager
Archive Display
Archive Manager.
VolServ Administration GUI
Archive Console
Client Interface Reply (CiReply)
Client Interface Request (CiRequest)
1-16
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
PROCSERV_SYSLOG_LEVEL
MONITOR_SYSLOG_LEVEL
ARCMAN_CAPACITY_DELTA
6
Process Server
Monitor
6
10
The difference between this value and the full
capacity of an archive is used as an alarm
zone that notifies the operator that the archive
is close to becoming full. (This parameter is
based on type, not class). A syslog message is
generated to indicate the absolute capacity of
an archive is imminent. The message is a level
critical message and is generated each time
the fill level for the archive is incremented until
the fill level is decreased.
QUERYCOMP_SYSLOG_LEVEL
6
QueryComp utility
The following table illustrates the variables that can be
modified, as required, to delete archives. VolServ must be
cycled for the changes to become effective..
Configuration
Environment
Variable Name
Default
Description
DELETE_ARCHIVE_WITH_
MEDIA
N
This value is used when deleting an
archive. The correct values are:
N - Do not delete the archive if media are in
it.
Y - Delete the archive even if media is in it.
601354 Rev A
Getting Started
1-17
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
DELETE_ARCHIVE_MEDIA_ACTI INTRANSIT
ONSTATE
This value is used when deleting an
archive and when DELETE
_ARCHIVE_WITH_MEDIAis Y. The correct
values are:
INTRANSIT - Place any media in the
archive to be deleted into the intransit
state.
EXPORT - Export any media that remain in
the archive to be deleted.
If DELETE_ARCHIVE_WITH
_MEDIAis N, then this environment
variable is not used.
The query process variables shown below can be modified, as
required. These variables should not be modified unless
directed by ATAC personnel. VolServ must be cycled for the
changes to become effective.
Library Defaults
Library Scheduler
Variable Name
Default
Description
LIB_MAX_TASKS
5
The maximum number of query requests
that may be spawned consecutively.
Others are queued until this parameter
value falls below this number. Adjust this
parameter based on the number of queries
normally used at one time.
LIB_ALARM_TIME
60
60
Number of seconds between each internal
alarm. The alarm is for internal
housekeeping. It checks for inactive
processes. Each inactive process that is
encountered is terminated.
LIB_INTERFACE_TIME
Number of seconds this process waits to
receive expected status over IPC. Increase
if IPC traffic is extremely heavy.
1-18
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Library Scheduler
Variable Name
Default
Description
LIB_IPC_WAIT_TIME
5
Number of seconds this process pauses
between attempts to send information over
IPC. Increase this parameter if IPC traffic is
extremely heavy.
LIB_IPC_RETRIES
30
Maximum number of times this process
attempts to send information over IPC.
Increase if IPC traffic is extremely heavy.
Library Manager Variables
LIBMAN_INTERFACE_TIME
60
5
Number of seconds this process waits to
receive expected status over IPC. Increase
if IPC traffic is extremely heavy.
LIBMAN_IPC_WAIT_TIME
LIBMAN_IPC_RETRIES
Number of seconds this process pauses
between attempts to send information over
IPC. Increase this parameter if IPC traffic is
extremely heavy.
30
Maximum number of times this process
attempts to send information over IPC.
Increase if IPC traffic is extremely heavy.
The following table lists the variables that can be modified, as
required, to modify archive communication times. VolServ
must be cycled for the changes to become effective.
Archive
Dispatcher
Variable Name
Default
Description
ARCDISP_IPC_RETRIES
10
The number of retries that the archive
dispatcher tries to connect to the VolServ
process before failing.
601354 Rev A
Getting Started
1-19
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
ARCDISP_IPC_WAIT_
TIME
1
The amount of time in seconds between
each retry that the archive dispatcher waits
before trying to connect to the VolServ
process. Increase this value if syslog
message V360 with an error of 9 is
received.
The GUI environment variables in the following table can be
modified, as required, to define specific GUI parameters. These
variables should not be modified unless directed by ATAC
personnel. VolServ must be cycled for the changes to become
effective.
GUI
Environment
Variable Name
Default
Description
VS_DEF_PRIORITY
15
The request priority for operations that do
not have a variable priority scale for setting
the priority.
VS_MAX_LIST_LENGTH
VS_MAX_TEXT_LENGTH
1000
The maximum number of items that can
populate the media list for a media filter. If
more than this number are selected, the
filter search fails and asks for a more
narrow description of the media IDs
required.
20000
The maximum number of characters
allowed to fill a status window. Once
reached, the status messages are
removed in FIFO order. If this number is
too large, system performance is
degraded.
VSWIN_IPC_RETRIES
3
The number of times vsadmattempts to
connect over IPC.
VSWIN_IPC_RETRY_TIME
180
Number of seconds vsadmattempts to
reconnect to processes over IPC after a
connection to those processes is lost.
1-20
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
XAPPLRESDIR
default path
(identified by
The path to the defaults for all of the GUI
windows is defined by this variable. If this
$VS_DIR/default variable is not set, the defaults must be put
s)
in the /usr/lib/X11/app-defaults
directory.
VSRPT_PAGE_LENGTH
0
The page length for the query report in
vsadm. If set to 0, no page breaks and
subsequent page headers are inserted.
Typical page length is 66.
The following table shows the variables that can be modified, as
required, to change the software communications. VolServ must
be cycled for the changes to become effective.
Process Server
Defaults
Variable Name
Default
Description
PROCSERV_TIMEOUT_VALUE
4
Number of seconds this process pauses
between attempts to communicate with the
processes initiated by bringing up or
terminating VolServ. Increase if the processing
speed of the system is extremely slow.
The following table shows the variables that can be modified, as
required, to change the time associated with activating and
terminating VolServ. VolServ must be cycled for the changes to
become effective.
VolServ
Defaults
Variable Name
Default
Description
VOLSERV_START_TIMEOUT
VOLSERV_QUIT_TIMEOUT
600
300
Timeout, in seconds, to wait for VolServ to start.
Timeout, in seconds, to wait for VolServ to
terminate immediately.
601354 Rev A
Getting Started
1-21
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
VOLSERV_TERM_TIMEOUT
600
Timeout, in seconds, to wait for VolServ to
terminate gracefully.
The following table shows the variables that can be modified, as
required, to change the time associated client, status, and RPC
commands. These variables should not be modified unless
directed by ATAC personnel. VolServ must be cycled for the
changes to become effective.
CiReply
Environment
Variable Name
Default
Description
CIREPLY_RETRY_INTERVAL
120
Wait interval in seconds for trying to
re-send status.
CIREPLY_MAX_RETRY
1
The number of times to retry before
giving up on a client. An infinite number
of retries can be commanded by setting
this value to -1.
CIREPLY_RPC_TIMEOUT
CIREPLY_RPC_RETRY
5
The RPC timeout value.
1
The number of RPC retries allowed.
CIREPLY_COMMANDS_TO_
RETRY
4
The maximum number of commands to
attempt within one try interval.
ENTERPRISE_ROUND_
SCHEDULING
Y
The type of scheduling for sending
status/callbacks to enterprises. Answer
Y or N. For round robin scheduling,
answer Y. For first received first
scheduled, answer N.
1-22
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This table shows the variables associated with each type of
archive supported by VolServ. Only those variables associated
with the site’s archive configuration should be modified.
VolServ must be cycled for the changes to become effective.
Archive
Defaults
Variable Name
Default
Description
AMTask Environment Variables
ARCHIVE_CMD_WAIT_TIME
600
3
Maximum wait time in seconds to wait for queued
primitives.
CLM_DISMOUNT_RETRIES
CLM_DISMOUNT_RETRIES
The maximum wait time in seconds for queued
primitives.
3
The number of times a dismount is retried to
allow the CLM to finish moving the medium from
the recorder to the CLM bin. VolServ waits for the
amount of time specified in
CLM_DISMOUNT_WAIT_TIMEbefore retrying.
This is only valid for a DataTower archive.
CLM_DISMOUNT_WAIT_TIME
1
The number of seconds to wait on a dismount
move retry to allow the CLM to finish moving the
medium from the recorder to the CLM bin before
retrying the dismount move. Recommended time
is 0 seconds. This is valid for a Tower system.
TowerAMTask Environment Variables
CAS_MEDIA_PAD_SIZE
0
Tower media ID pad. Used if VolServ is
interfaced with a Cray tpdaemonand using
media identifiers longer than 6 characters.
The default value is based on the total number of
characters in the medium identifier - 6. (e.g
mediaID = LOT0008, 7 characters -6 = 1)
CRITICAL_PROCESSING
TOWER_MAX_WAIT_TIME
1
Determines whether or not to continue
processing when tower hardware errors are
received.
0-DO NOT 1-DO
15
Maximum wait time in seconds for nonqueued
primitives.
601354 Rev A
Getting Started
1-23
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
SiloAMTask Environment Variables
SILO_MAX_WAIT_TIME
10
Maximum time in seconds for non queued
primitives.
DRIVE_MAX_ERROR_COUNT
1
Number of errors encountered by a drive before a
message is logged.
AMLAMTask Environment Variables
AML_MAX_WAIT_TIME
30
Maximum wait time in seconds to wait for
nonqueued primitives.
AML_MOUNT_RETRIES
1
The number of retries that the archive tries to
connect to the VolServ process before failing.
Retries are only performed if the following are
used: mount by drive pool, Media Class, media
list, or multiple media.
The following table shows the variables that can be modified as
required for debugging software interfaces. To enable these
variables, remove the comment line indicators from the
applicable variable. VolServ must be recycled for the changes to
become effective.
Configuration
Logging
Variable Name
Default
Description
CONFIG_SYSLOG_LEVEL
6
All messages between this level and zero
are written to CONFIG_SYSLOG_FILE.
CONFIG_SYSLOG_FILE
MACRO/VS_DIR/ Syslog file of messages pertaining to
logs/vsconfig mounts, dismounts, and varies.
log
1-24
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This table shows the system variables that are to be established
at the time of the system installation. Use the VolServ
installation script for this purpose.
Installation
Tip
As a general rule, do not modify these variables unless the system
is completely reinitialized and reinstalled.
Variable Name
Default
Description
VS_ADMIN
VS_GROUP
vsadm
vsadmin
VolServ administrator identifiers
Primary group files. Any user associated with
this group will be able to perform operator
functions.
The following table shows the VolServ database variables that
are to be established at the time of the system installation. Use
the VolServ installation script for this purpose. As a general
rule, do not modify these variables unless the system is
completely reinitialized and reinstalled.
VolServ
Database
Variable Name
Default
Description
DatabaseName
RetryLimit
voldb
The VolServ database name.
Number of database retries.
3
This table shows the variables that control some aspects of the
TCP/IP interface to VolServ. As a general rule, do not modify
these variables.
TCP/IP Interface
601354 Rev A
Getting Started
1-25
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Variable Name
Default
Description
TCPIP_CONNECT_WAIT_TIME
1
Number of times to try to connect to a socket
over TCP/IP.
TCPIP_CONNECT_RETRIES
5
Amount of time in seconds to wait between
retries to connect to a socket over TCP/IP.
1-26
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The label_printers.config file located in the $VS_DIR/config
directory is used as a reference file for the label printers in the
VolServ system. The printer name and type of printer are
entered in this file; e.g., ps1 postscript.The label printers must
be contained in this file to be accessed by VolServ.
printers.confi
g Files
The printers.configfile located in the $VS_DIR/config
directory is used as a reference file for all the printers used in
the VolServ system; e.g., lp1, bc1, ps1, etc.
Maintaining this file ensures all printer names are accessible to
the Printer pop-up window. Refer to the appropriate VolServ
Software Manual. By placing the cursor in the Printer Name
entry box and clicking the right mouse button, a pull-down
menu containing all printer names will be displayed allowing
one to be selected and automatically entered.
Any printer not entered in the printers.configfile can still
be accessed, but its name is not shown in the Printer pop-up
window.
Other .config
Files
Caution
Do not modify these files unless directed by ATAC personnel.
The process.configand servers.configfiles located in
the $VS_DIR/configdirectory defines the resident VolServ
processes and the arguments the processes use. These processes
are necessary for VolServ operations.
601354 Rev A
Getting Started
1-27
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
1-28
Getting Started
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Roadmap
Refer To
Chapter
Topic
General software installation information
Hardware and software start-up
Site-specific configuration of archives/drive.
Daily operations
1
2
3
4
5
6
Archive operation and configuration
Troubleshooting tips and solutions
2-2
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
This chapter contains information to power-up the hardware
components of a VolServ system and information and
procedures to start-up and shutdown VolServ.
Start-Up
Equipment
Perform start-up of all equipment in accordance with the
appropriate host computer, archive, and tape drive manufacturer
manuals.
There is no required sequence of power application for the
hardware components of the VolServ system with one
exception; power must be applied to the ER90 transport units
before power is applied to the ER90 electronic units.
Archive configuration can be performed from the Volume
Server System Console without VolServ running. Note,
however, that VolServ software initialization terminates if an
archive is being reconfigured when VolServ software
initialization is begun.
Start-Up
VolServ
The user initializing VolServ must have root or vsadm
privileges.
Step 1.
Login as vsadm, either remotely or locally, on the
VolServ host computer.
Note
Remote login requires that the environment where
the command is executed be properly set up as
described in the Installing VolServ book for the
appropriate host platform.
Step 2.
Type volserv or volserv -s at the command line.
hostname% volserv
601354 Rev A
Start-up and Shutdown
2-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
The volserv command starts VolServ in the
multiuser mode. Client interface commands are
accepted after initialization completes. Commands
received prior to initialization completion are failed
and the error, ERR_SOFTWARE_NOT_READY, is
returned.
hostname% volserv -s
The volserv -s command starts VolServ in the
single-user mode. Only commands from the vswin
module are accepted. Client interface commands are
refused and the error,
ERR_NOT_ACCEPTING_COMMANDS, is returned.
Successful VolServ software start-up is indicated by
the display of the Volume Server SysLog Console.
The Volume Server SysLog Console displays on the location
specified in the console.configfile. The console.config
file also specifies which logging levels are displayed on the
Volume Server Syslog Console.
2-4
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
After an archive is configured, its archive Console displays at
the location specified during the configuration process. If no
archives are configured, no archive Console is displayed. Each
VolServ Archive Operator position is indicated by the presence
of this display.
The figure shown below is an example of an AML
archive Console.
This procedure is performed to allow the Volume Server
System console window to display.
Start the
System
Console
Step 1.
Type vswin & and press <RETURN> to display
the Volume Server System console:
hostname% vswin &
601354 Rev A
Start-up and Shutdown
2-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Or, use the -d option of the vswin command to
display the Volume Server System console on a
workstation other than that identified by the
DISPLAY environment variable:
hostname% vswin -d consolename:0 &
After a moment, the Volume Server System console
appears as shown in the following screen display:
Recovery processing is performed automatically during
initialization. Recovery processing is initiated for any
commands that were not complete when VolServ last
terminated. Incomplete commands are not automatically
reissued. These commands are failed and an error message
(ERR_COMMAND_IN_UNKNOWN_STATE) is sent to the
originating client process.
Recovery
Processing
VolServ is backed up using standard UNIX backup procedures.
Backup VolServ
2-6
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
This section provides the proper sequence of procedures to
perform when all or part of the software and equipment is to be
shutdown.
Shutdown
Software
Shutdown
System
Console
Note
To bring down all Volume Server System consoles, this
procedure must be run for each console.
A Volume Server System console need not be brought down
before shutting down VolServ. However, unless VolServ is
active, the only operation available via the Volume Server
System console is archive configuration.
This procedure must be performed from the workstation where
the Volume Server System console is displayed.
Step 1.
Select Exit from the Options pull-down menu in the
upper left corner of the Volume Server System
console window.
601354 Rev A
Start-up and Shutdown
2-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Step 2.
A Question box appears that contains the question
“OK to exit vswin?”..
Step 3.
Click the OK button in the Question box. The
Question box and the Volume Server System
console windows close.
Two ways exist to bring down VolServ: gracefully and
immediately.
Shutdown
VolServ
A graceful shutdown terminates VolServ after all command
processing ceases. Executing commands that are in a state that
allows them to be cancelled are aborted. Executing commands
that cannot be cancelled are allowed to process to completion.
Client requests received after termination processing begins and
all pending requests are failed.
An immediate shutdown results in the immediate termination of
VolServ, without waiting for any command processing to
complete and without cancelling any commands. Any
commands executing at the time of termination must be cleaned
up when VolServ software is restarted. VolServ software
automatically performs recovery processing during the start-up
processing as discussed in “Recovery Processing” on Page 2-6.
Note
Do not attempt to bring down VolServ while an archive is being
configured or reconfigured.
2-8
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Make sure that an archive is not being reconfigured before an
attempt is made to bring down VolServ. VolServ aborts a
termination request if an archive is being reconfigured.
The Volume Server System console is not brought down by
this procedure. The console display can remain in place
throughout a VolServ software termination and restart. When
VolServ is terminated, the only operation available via the
Volume Server System console is the configure/reconfigure
archive operation.
Step 1.
Step 2.
Login as vsadmor as root.
Gracefully
Terminate
VolServ
Send a warning message to all users to inform them
of an impending VolServ software shutdown.
It is recommended that the message specify the time
when VolServ will be shutdown.
Step 3.
Issue volserv -tfrom the command line at or
later than the time specified in the earlier warning
message.
Note
New client interface commands are not accepted after
the termination sequence starts.
% volserv -t
601354 Rev A
Start-up and Shutdown
2-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Step 4.
Enter y to continue with shutdown.
VolServ Version 5.0 for #### (#.#) --
Copyright (c) 1992 - 2001 - ADIC, Inc.
Initiating VolServ shutdown
Are you sure you wish to continue? (y/<n>) y
Setup environment variables ok
4
Shutting down VolServ system processes..Done
System processes shut down ok
Shutting down VolServ servers...........Done
Servers shut down ok
Shutting down VolServ process server.... Done
Process server shut down ok
VolServ shut down completed
The Volume Server SysLog Console and each
archive Console disappear from the terminals on
which they are displayed.
Step 5.
Logout as vsadm.
2-10
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
NOTES
601354 Rev A
Start-up and Shutdown
2-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
NOTES
2-12
Start-up and Shutdown
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Roadmap
Refer To
Chapter
Topic
General software installation information
Hardware and software start-up
Site-specific configuration of archives and drives
Daily operations
1
2
3
4
5
6
Archive operation and configuration
Troubleshooting tips and solutions
3-2
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
A VolServ system includes VolServ, archives, drives, and
Configure an
Archive
media. After VolServ is installed, the site-specific configuration
of archives, drives, and media must be input into VolServ
before normal VolServ operations can begin.
The following list identifies the actions to perform that
configure a VolServ system.
•
•
•
Configure the archives to be supported.
Define the necessary Media Classes.
Associate the defined Media Classes with the appropriate
configured archives.
•
•
•
•
•
Define the drives to be used in the configured archives.
Associate the drives with the appropriate archives.
Define label patterns.
Print media labels, if appropriate.
Add media to the configured archives.
Note
VolServ does not have to be running to configure an archive.
Before VolServ software can manage archive operations, the
software must have access to specific parameters pertaining to
each managed archive. This is performed via the Configure
Archive command.
Managed archives are either automated or manual. An
automated archive uses a mechanical robot to perform media
movement operations. A manual archive requires human
intervention to perform media movement operations.
601354 Rev A
Initial Configuration
3-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Automated archives supported by VolServ include the
DataTower archive; the StorageTek ACS archive; the AML/2,
AML/E, and AML/J archive; and the ADIC Scalar 100, Scalar
1000, and Scalar 10K archives.
The manual archives supported by VolServ include the
DataShelf archive and the Stage archive.
Some of the configuration parameters required by VolServ are
archive-type dependent and are identified in the appropriate
section of the Using the VolServ GUI manual. The archive
parameters common to multiple archive types are discussed in
this chapter.
Except for the AML/E archive, configuration parameters can
only be input to VolServ via the Graphical User Interface
(GUI). An interactive script is executed to perform AML/E
archive configuration.
Basic automated archive parameters include the archive type,
an archive name, the display host for the archive Console, the
archive mode, and the media type supported.
Configure an
Automated
Archive
Archive Type
The archive type parameter identifies the type of archive being
configured and enables VolServ to execute appropriate
archive-type specific logic. The valid archive types are
displayed on the Configure Archive window. The user selects
the appropriate type for the archive being configured.
Archive Name
The archive name parameter is a user-specified name by which
the archive is known to the user. Valid archive names may
contain up to 16 characters, including spaces. Leading and
trailing spaces are not permitted.
3-4
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Archive Console
Display Host
This parameter determines where the archive Console displays.
After an archive is configured and registered with VolServ, the
Start-up and Shutdown chapter for an example of an archive
Console. This archive Console example is for an AML/E
archive. All archive Console displays are similar.
The archive Console alerts the VolServ Archive Operator (AO)
when human intervention is required for media movement
operations. For example, the Check-out Media, Export Media,
and Move Media operations require that a medium or media be
ejected (physically removed) from an archive. The Move Media
operation further requires that the ejected medium or media be
entered into another archive. Also, the Mount Media operation
can require that a medium be ejected from one archive and
entered into another archive for mounting on a specific drive.
Archive Mode
The archive mode parameter indicates whether a human is
available to perform media eject and enter operations for the
archive. There are two archive mode settings: attended and
unattended.
Attended
The archive mode attended option indicates that a human is
available to perform media eject and enter operations prompted
by the archive Console.
Unattended
If the archive mode unattended option is selected, VolServ
software fails commands that require human intervention to
move media out of or into an archive. These commands are the
Check-out Media, Export Media, Move Media, and (sometimes)
Mount Media associated commands.
601354 Rev A
Initial Configuration
3-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Move Media and Mount Media associated commands
provide an override parameter that allows the user to prevent
the failing of the command when the Archive Mode unattended
option is selected. When this override parameter is specified,
media movement requiring human intervention is queued until
a human completes the media movement request.
Media Type
VolServ supports both system-defined (default) and
user-defined media types. The system-defined media types, and
the archives supported by the system-defined media types, are
discussed in the VolServ Overview book. User-defined media
types are not supported in automated archives.
After the supported media type is specified, capacity is
automatically calculated. Media type specific information is
entered next. This information includes action mode, low mark,
high mark, auto check-in, and auto import.
Capacity
The capacity of an automated archive is automatically
calculated for each supported media type by VolServ.
Action Mode
The action mode parameter specifies what action, if any,
VolServ initiates when the number of media of the specified
media type reaches the calculated high mark threshold or drops
to the calculated low mark threshold. There are three action
mode settings: none, notify, and migrate.
3-6
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
None
When the action mode none option is specified, VolServ
initiates no automatic action when the number of media of the
specified media type reaches the calculated high mark
threshold. However, when the number of media of the specified
media type reaches the archive capacity minus the
ARCMAN_CAPACITY_DELTA(default is 10) value, VolServ
software generates notification to the Volume Server SysLog
Console.
Notify
When the action mode notify option is specified, VolServ
generates notification to both the Volume Server SysLog
Console and archive Console when the number of media of the
specified media type reaches the calculated high mark threshold
or drops to the calculated low mark threshold.
It is the responsibility of the VolServ System Administrator
(SA) or VolServ System Operator (SO) to take whatever action
is appropriate in response to the notification.
If the number of media has reached the calculated media-type
high threshold, the SA or SO selects media for removal from
the archive.
If the number of media has dropped to the calculated
media-type low threshold, the SA, SO, or AO may import
additional media into the archive.
Migrate
When the action mode migrate option is specified, VolServ
automatically initiates migration of media out of the archive
when the number of media of the specified media type reaches
the calculated high mark threshold.
VolServ continues to mark media for migration until the
number of unmarked media reaches the calculated low mark
threshold for the specified media type.
601354 Rev A
Initial Configuration
3-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The selection of media for migration is dependent on both
Media Classes and media types. Refer to VolServ: Introduction,
60023A for additional information on media class migration.
Media type migration occurs only if the Media Class to which
the media selected for migration belong is associated with both
the source and destination archives. Archive media class
Low Mark
The low mark parameter is a user-specified percentage.
VolServ software applies the low mark percentage to the
archive media-type capacity to calculate a media-type specific
low mark threshold.
Any integer value between 0 and 100, inclusive, can be
specified as the low mark percentage. The specified low mark
percentage cannot be greater than the specified high mark
percentage.
When the notify action mode option is specified, VolServ
software generates a message to both the Volume Server
SysLog Console and archive Console when the number of
media of the specified media type drops to the calculated low
mark threshold.
When the migrate action mode option is specified, VolServ
software marks media for migration out of the archive until the
number of unmarked media drops to the calculated low mark
threshold.
3-8
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
High Mark
The high mark parameter is a user-specified percentage.
VolServ software applies the high mark percentage to the
archive media-type capacity to calculate a media-type specific
high mark threshold.
Any integer value between 0 and 100, inclusive, can be
specified as the high mark percentage. The specified high mark
percentage cannot be less than the specified low mark
percentage.
When the notify action mode option is specified, VolServ
software generates a message to both the Volume Server
SysLog Console and archive Console when the number of
media of the specified media type reaches the calculated high
mark threshold.
When the migrate action mode option is specified, VolServ
software automatically begins marking media for migration out
of the archive when the number of media of the specified media
type reaches the calculated low mark threshold.
The VolServ system provides the capability to check media out
of the system. This functionality is similar to checking a book
out of a public library. Although checked-out media are
physically located outside the control of the VolServ system,
VolServ maintains information on these media and identifies
them as checked-out.
Auto Check-in
If the VolServ system detects the physical presence of a
medium that is identified as checked-out, VolServ either
initiates the physical ejection of the medium from the VolServ
system or automatically checks the medium into the VolServ
system.
There are three operations that can detect the physical presence
of checked-out media: audit, unsolicited media enter, and enter.
601354 Rev A
Initial Configuration
3-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Auto Check-in During
Audit
An archive audit is executed to synchronize the information in
the VolServ database with the actual media contents of a
specified archive.
When an archive audit is performed, the archive control
software reports the media contents of the archive to VolServ.
When the archive audit detects the physical presence of media
that are shown as checked-out by VolServ, the setting of the
auto check-in parameter determines the action taken by
VolServ.
•
If the auto check-in option is enabled, VolServ
automatically checks the located media into the VolServ
system. These media remain in the Media Class to which
they were associated when checked-out.
•
If the auto check-in option is not enabled, VolServ initiates
the ejection of the media from the VolServ system by
placing the media on the archive eject list. In the
DataTower, the media thus found are also moved to the
eject port.
Auto Check-in
During Unsolicited
Media Enter
DataTower Archive Only
The DataTower archive supports the unsolicited media enter
operation. An unsolicited media enter operation is performed
without VolServ system GUI interaction.
During an unsolicited media enter operation, media are placed
in the DataTower load port, followed by pushing a button above
the load port. The archive robot reads the media labels and
sends the media identifiers to VolServ. If any of the media in
the load port are shown as checked-out by VolServ, the setting
of the auto check-in parameter determines the action taken by
VolServ.
3-10
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
•
If the auto check-in option is enabled, checked-out media
are automatically checked in to the VolServ system. The
automatically checked-in media remain in the Media Class
to which they were associated when they were checked-out.
If the auto check-in option is not enabled, VolServ leaves
the checked-out media in the load port.
Auto Check-in During
Enter
All archives support the enter operation. An enter operation is
performed via interaction of the AO with the appropriate
archive Console. For more information about the enter
When the AO performs an enter operation on automated
archives, the archive robot reads the media labels and sends the
media identifiers to VolServ. If any of the media in the load port
are shown as checked-out by VolServ, the setting of the auto
check-in parameter determines the action taken by VolServ.
•
If the auto check-in option is enabled, checked-out media
are automatically checked in to the VolServ system. The
automatically checked-in media remain in the Media Class
to which they were associated when they were checked-out.
•
If the auto check-in option is not enabled, VolServ performs
actions that depend on the archive type. VolServ software:
-
leaves the check-out media in the load port without
placing them on the eject list (DataTower archive)
-
moves the media into the archive and places them on
the eject list (AML/E, AML/2, AML/J, or StorageTek
ACS Product Family archives)
601354 Rev A
Initial Configuration
3-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
During either an archive audit, unsolicited media enter, or enter
operation, the VolServ system may detect the physical presence
of media that are unknown to the VolServ system.
Auto Import
The auto import parameter specifies what action VolServ
initiates when an unknown medium is detected within a
controlled archive.
When the auto import option is enabled, the target Media Class,
manufacturer name, and batch identifier to be assigned to the
automatically imported media must be specified.
Auto Import During
Audit
An archive audit is executed to synchronize the information in
the VolServ database with the actual media contents of a
specified archive.
When an archive audit is performed, the archive control
software reports the media contents of the archive to VolServ.
When the archive audit detects the physical presence of media
that are unknown by VolServ or are in the intransit state, the
setting of the auto import parameter determines the action taken
by VolServ. Refer to the Glossary for a definition of intransit
state.
•
If the auto import option is enabled, VolServ automatically
imports unknown media into the VolServ system. The
automatically imported media are assigned the auto import
target Media Class, manufacturer name, and batch identifier
specified during archive configuration or reconfiguration.
3-12
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
•
If the auto import option is enabled, VolServ automatically
enters intransit media (refer to the glossary).
Note
Unknown media located in the DataTower archive during an
audit operation are moved to the eject port.
If the auto import option is not enabled, VolServ initiates
the ejection of the unknown media from the VolServ system
by placing the media on the archive eject list. In the
DataTower, the media thus found are also moved to the
eject port.
Auto Import During
Unsolicited Media
Enter
The DataTower archive supports the unsolicited enter of media
into DataTower archive. An unsolicited media enter operation
is performed without VolServ system GUI interaction.
During an unsolicited media enter operation, media are placed
in the DataTower load port, followed by pushing a button above
the load port. The archive robot reads the media labels and
sends the media identifiers to VolServ. If any of the media in
the entry port are unknown to VolServ or are in the intransit
state, the setting of the auto import parameter determines the
action taken by VolServ.
•
If the auto import option is enabled, VolServ automatically
imports the unknown or intransit media into the VolServ
system. The automatically imported media are assigned the
target Media Class, manufacturer name, and batch identifier
specified during archive configuration or reconfiguration.
•
If the auto import option is enabled, VolServ automatically
enters intransit media (refer to the glossary) if the subject
DataTower archive contains the target media class.
601354 Rev A
Initial Configuration
3-13
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
If the auto import option is not enabled, VolServ leaves the
unknown media in the load port.
When an intransit medium (due to an incomplete mount
command) is imported or entered, VolServ software attempts to
complete the mount.
Auto Import During
Enter
All archives support the enter operation. An enter operation is
performed via interaction of the AO with the appropriate
archive Console. For more information about the enter
When the AO performs an enter operation on automated
archives, the archive robot reads the media labels and sends the
media identifiers to VolServ. If any of the media in the entry
port are unknown to VolServ or are in the intransit state, the
setting of the auto import parameter determines the action taken
by VolServ.
•
If the auto import option is enabled, unknown media are
automatically imported in to the VolServ system. The
automatically imported media are assigned the target Media
Class, manufacturer name, and batch identifier specified
during archive configuration or reconfiguration.
•
•
If the auto import option is enabled, VolServ automatically
enters intransit media (refer to the glossary) if the subject
archive contains the target media class.
If the auto import option is not enabled, VolServ performs
actions that depend on the archive type. VolServ software:
-
Leaves the subject media in the load port without
placing them on the eject list (DataTower archive)
3-14
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
-
moves the subject media into the archive and places
them on the eject list (AML/E, AML/2, AML/J, or
StorageTek ACS Product Family archives)
When an intransit medium (due to an incomplete mount
command) is imported or entered, VolServ software attempts to
complete the mount.
VolServ supports two manual archives: the DataShelf archive
and the Stage archive.
Configure a
Manual Archive
Configuring a manual archive is identical to configuring an
automated archive with the following exceptions.
Fill Mode
When media are added to a DataShelf archive, VolServ must
assign an empty storage bin for each new media.
To minimize database access activity, VolServ software caches
information about an entire shelf of bins in memory. As long as
an available bin exists in the cached shelf, VolServ software
assigns storage bins from the cached shelf to new media.
When no additional bins are available in the cached shelf,
VolServ software writes the cached information about the shelf
to the database and scans the shelves in the DataShelf archive
sequentially until another shelf with an available storage bin is
located.
Two algorithms are available to determine where VolServ
begins its scan for a shelf with an available storage bin. These
algorithms, called fill modes, are wrap and first fill.
601354 Rev A
Initial Configuration
3-15
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Shelves within a DataShelf archive are numbered within Row.
For example, if a DataShelf archive has three rows with four
shelves per row, the shelves are labeled sequentially as follows:
Row 1 Shelf 1, …, Row 1 Shelf4, Row 2 Shelf 1, … Row 2
Shelf 4, Row 3 Shelf 1, …, Row 3 Shelf 4.
First Fill
Wrap
When the first fill mode option is specified, VolServ always
begins its scan for a shelf with available storage bins with the
first shelf in the archive, i.e. Row 1 Shelf 1.
When the wrap fill mode is specified, VolServ software begins
its scan for a shelf with an available storage bin with the shelf
immediately after the shelf just filled. For example, if the last
assigned bin was in Row 2 Shelf 3, the next shelf scanned is
Row 2 Shelf 4.
If VolServ does not find an available storage bin by the time it
has scanned the last physical shelf in the archive (Row 3 Shelf
4), the search for an available storage bin wraps to the first
physical shelf in the archive (Row 1 Shelf 1). VolServ software
continues scanning the shelves sequentially until a shelf with an
available storage bin is found.
The manual archives support up to 16 user-defined media types
in addition to the system-defined media types that are supported
by the automated archives.
Media Type
A user-defined media type must be defined to the VolServ
can be specified as a supported media type for a manual archive.
Capacity
The capacity of a Stage archive is entered during the
configuration of the archive. The capacity of a Shelf archive can
be modified by reconfiguring the archive.
3-16
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
DataShelf archive capacity is a calculated value based on the
number of shelves configured.
Auto Check-in
Auto Import
The auto check-in functionality is not supported for manual
archives.
The auto import functionality is not supported for manual
archives.
601354 Rev A
Initial Configuration
3-17
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After an archive is successfully configured, it must be
registered with VolServ. This is done via two methods:
Register
Archive with
VolServ
Perform an archive reconfiguration without changing any
archive parameters. Refer to the Using the VolServ GUI manual
for specific information concerning this method.
When the default media types supported by VolServ software
are not sufficient, a new media type may be defined and
registered with VolServ using the
Define a Media
Type
Media Type…/Define GUI window.
VolServ software acquires media type parameters via the GUI.
Basic media type parameters consist of the media type name,
number of sides, and capacity in megabytes.
Note
Media types cannot be deleted. They may be defined or redefined.
Once specified, newly defined media types may be selected
during configuration of a manual archive. The list of media
types allowed for automated archive configuration is controlled
by VolServ software.
3-18
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After an archive is successfully configured and registered with
VolServ, at least one Media Class must be created. Media
Classes are created using the Create Media Class command.
Create a
Media Class
Media Classes provide logical organization of media into
smaller groups. For more information about Media Classes,
refer to the VolServ Overview manual.
Media Classes are central building blocks to media class and
media type migration processes. They are also used by one of
the optional forms of the Mount Media command.
Note
VolServ has to be running to create a Media Class.
•
VolServ software acquires media class parameters via the
GUI and API. Basic Media Class parameters consist of the
class name, media type used, class capacity, mountable by
class option, high mark, notification comment, use
callbacks option, and callback information.
•
•
Media Classes have several important characteristics:
When a medium is entered into an archive, it is also entered
into a Media Class. The medium can be in one, and only
one, Media Class.
•
Once a medium in entered into a group, it can only be
moved into another group by the Reclassify Media
command or a Mount Media command with the reclassify
option selected.
•
•
Only one media type can exist within a group.
Media Classes can be associated with more than one
archive.
601354 Rev A
Initial Configuration
3-19
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
A Media Class is an integral part of the media migration
philosophy. When media type migration or media class
migration occur, media must stay within the same media
class.
Basic Media Class parameters include the Media Class name,
media type, class capacity, mountable by class, high mark,
notification comment, and use callbacks and callback
information.
The Media Class name parameter is a user-specified name by
which the Media Class is known to the user. Valid Media Class
names may contain up to 16 characters, including spaces.
Leading and trailing spaces are not permitted.
Media Class
Name
The media type parameter identifies the type of media used in
the Media Class. As noted before, only one media type can be
specified for a Media Class.
Media Type
Media Classes are designed to be associated with multiple
archives. Media migration cannot occur unless a media class
spans at least two archives. However, a media class can be
wholly associated with one archive.
Class Capacity
Therefore, plan Media Class capacities to cover the expected
size of the archives configured earlier. See the following page
for an example of two media classes associated with two
archives.
3-20
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Manual
Library
Automated
Library
Blank Media
Class
Media Class
No software restriction is placed on the media class capacity.
Class capacity can exceed the total combined capacity of all
archives, or can be as small as one.
Although not necessary, there are two restrictions that should be
applied to Media Class capacities when media migration is
planned:
•
Total capacity should equal the amount of bins in the
archives
•
There should be no Media Class overlap
As an example, refer to the illustration shown above. Suppose
the Automated Archive and Manual Archive have 100 and 1000
bins, respectively. The Blank Media Class and the Media Class
capacities should total 1100.
Also, the Blank Media Classes should have a capacity less than
the Automated Archive capacity. The remaining Automated
Archive bins can then be associated with the Media Class
capacity.
601354 Rev A
Initial Configuration
3-21
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Selecting the mountable by class option sets a flag for the
subject Media Class. This flag is used by the Mount Media
command.
Mountable By
Class
The Mount Media command provides four ways in which
media may be selected for mounting. These are:
•
•
•
•
Mount by media identifier
Mount by media list
Mount by media class
Mount by criteria
VolServ software supports the mount by media class method
for the subject Media Class only if the mountable by class
option is selected. When not selected, the Mount Media
command cannot use the mount by media class option for the
subject Media Class. Refer to “Mount Media on a Drive” on
page 4-18 for more information.
The media class high mark indicates a capacity break point that
is calculated as a percentage of class capacity. After the high
mark capacity is reached, a notification is logged and displayed
on the Volume Server SysLog Console.
High Mark
Notification
Note
The notification is displayed at the “alert” level in the system log.
When entered, a notification comment accompanies the syslog
message. The syslog message occurs each time media are added
to the media class. No more media may be entered into the
media class when class capacity is reached, regardless of which
archive it is associated with.
3-22
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Syslog notification messages stop whenever the amount of
media drops below the high mark. This can be achieved by
ejecting media, using the Reclassify Media command to move
media into another media class, or raising the class capacity
using the Modify Media Class command.
VolServ can generate unsolicited status messages called media
class callbacks. When enabled during media class
configuration, media class callbacks are returned to client
software after certain commands affect any medium within the
media class. These commands are:
Use Callbacks
and Callback
Information
•
•
•
•
•
•
•
•
•
Import Media
Export Media
Check-in Media
Check-out Media
Mount Media
Dismount Media
Reclassify Media
ENTER (from the archive Console)
EJECT (from the archive Console)
When the use callbacks option is enabled, the destination of
media class callbacks can be directed to either a specific RPC
address or to an Internet address associated with a specific
client at its Enterprise ID location. No Enterprise ID location
exists until a client establishes an enterprise using the Connect
For further information refer to the VSCMD_Connect
commands in the MSTM-V21-010-API Programmer’s Guide.
601354 Rev A
Initial Configuration
3-23
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After a media class is successfully configured and registered
with VolServ, it must be associated with one or more archives.
This association is referred to as an archive media class.
Archive media classes are created using the Create Archive
Media Class command.
Create an
ArchiveMedia
Class
VolServ software acquires archive media class parameters via
the GUI and API. Basic archive media class parameters consist
of archive name, media class name, archive class percentage,
action mode, high mark, low mark, migration priority,
migration archive, and preferred media placement.
See the following subsections for detailed discussions
concerning the archive class percentage, action mode, high
mark, low mark, migration priority, migration archive, and
preferred media placement.
A percentage of the media class capacity can be associated with
an archive based on this parameter. Refer to the Using the
VolServ GUI book and note that the entry method uses a slide
bar. As the slide is moved, the actual quantity of media to be
associated with the archive is displayed in a text area just above
the slide bar. Note that the quantity will not exceed the lesser of:
Archive Class
Percentage
•
•
The amount of bins in the archive
The amount of unassociated media remaining in the Media
Class
3-24
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Use the figure shown below. Assume that the Automated
Archive has a capacity of 100 bins and Media Class Group A
has a capacity of 200. Also assume that Media Class Group A is
associated with the Automated Archive and Manual Archive.
When the Media Class Group A archive class percentage slide
bar is moved from 0 percent to 100 percent, the actual quantity
displayed above the slide bar increases. When the 50 percent
level is reached, the quantity remains at 100, regardless of the
other 100 media remaining in the Media Class Group A.
Manual
Library
Automated
Library
Blank Media
Class Group
Media Class Group A
Media Class Group B
As a further example, assume that the Manual Archive has a
capacity of 1000. When the Media Class Group A archive class
percentage slide is moved from 0percent toward 100 percent,
the actual quantity displayed above the slide bar will increase.
When the 10 percent level is reached, the quantity will stop
incrementing and remain at 100, regardless of the other 900
slots remaining in the Manual Archive.
601354 Rev A
Initial Configuration
3-25
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Although not enforced by VolServ software, there is one
restriction that should be applied to archive class percentage
when media migration is planned. This restriction is there
should be no Media Class overlap. Using the figure in “Archive
Class Percentage” on page 3-24, the capacity of the Automated
Archive should equal the total capacity of the Blank Media
Class Group and portions of Media Class Groups A and B that
are associated with the Automated Archive.
The specification of action mode, low mark, and high mark is
made for each archive media class, as well as for each media
type in a configured archive. As suggested by low mark and
high mark, action may or may not be triggered when the amount
of media in an archive media class reaches a calculated low
mark or high mark threshold.
Action Mode,
Low Mark, High
Mark
The SA can choose action modes of none, notify, or migrate.
Depending on the action mode option selected, either no
notification, or migration of media from one archive to another
occurs when the archive media class high mark threshold is
reached.
During some operations, media are removed from an archive.
When this occurs, the media removed from an archive may
cause an archive media class fill level to reach its low mark
threshold. If the notify action mode is selected, a notification is
sent to the Volume Server SysLog Console and appropriate
archive Console.
A few operations result in adding media to an archive and result
in exceeding the high mark threshold for the archive media
class fill level. When the fill level reaches the high mark
threshold and:
•
The notify action mode is selected, a notification is sent to
the Volume Server SysLog Console.
3-26
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
The migrate action mode is selected, media within an
archive media class are subject to migration to another
archive associated with the same media class. Migration
continues until the low mark is reached, provided that
enough space exists in the destination archive media class to
accept the migrated media. Notification is also sent to the
Volume Server SysLog Console.
At this point, it is important to describe the media class
migration and media type migration processes.
Media Class
Migration
Media class migration is a process directed by VolServ
software. The process begins if a media class migrate action
mode was selected during archive media class creation and the
media class fill level reaches the media class high mark
threshold.
Several operations can cause a Media Class fill level to exceed
its high mark threshold. Some of these are import, reclassify, or
bulk loading operations.
When media class migration starts, VolServ software places
media from the source media class on its archive eject list. The
quantity of eject list entries equals the difference between the
actual fill level that triggered the process minus the media class
low mark threshold. The archive Console display EJECT
button of the source archive is then highlighted.
The media selected for ejection are those with the oldest access
date. This value correlates to the last time the medium was
entered, mounted, or dismounted.
When a medium is ejected by the AO, the migration archive
enter list is appended with that same medium. The archive
Console display ENTER button of the migrations archive is
highlighted.
601354 Rev A
Initial Configuration
3-27
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After media class migration starts, migration continues until
one of the following occur:
•
•
The media class fill level reaches the media class low mark.
The AO removes the media from the Eject list. Such media
enter the intransit state.
Note
No media are accepted by the destination archive when its
absolute capacity is reached.
There are two reasons for removing such media from the source
archive Eject list. One is that the destination archive media fill
level may reach the destination archive high mark when media
are entered as a result of migration. If media are entered into the
destination archive and its high mark is exceeded, media type
migration begins for that archive (unless the destination
archive’s action mode migrate option is not selected).
Note
No media are accepted by the destination archive when the
destination media class capacity is reached.
Another reason to remove media from the source archive eject
list is when the destination archive media class fill level reaches
the destination archive media class high mark. Otherwise,
media class migration from the destination archive to some
other archive may be triggered. No media are accepted by the
destination archive media class when its absolute capacity is
reached.
Note that the archive media class high mark and low mark are
used to determine when to start and halt media class migration.
These marks apply only to an archive media class fill level and
is designated during archive media class creation.
3-28
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
During archive configuration, a different set of high and low
marks are entered. These marks are used to determine when to
start and stop media type migration. Refer to “High Mark” on
independent from each other.
Media Type
Migration
are migrated to another archive once a media type fill level
reaches the media type high mark because of media entry. The
media type high mark is distinct from the media class high
mark.
Each medium selected for media type migration must conserve
its media class. Although media type migration causes media to
be migrated to another archive, each selected medium must also
remain in its present media class. Furthermore, a medium is not
migrated unless its media class migrate action mode is selected.
When these two preconditions exist, that medium can be
migrated via the media type migration process.
After media type migration starts, the number of media required
to reach the media type low mark is calculated. This value is
equal to the difference between the media type fill level
threshold minus the media type low mark threshold. The
amount of media of that media type present on the Eject list is
also subtracted from the media type fill level.
Next, the archive media class with the highest migration
priority is first selected for migration. Refer to “Migration
Priority and Archive” on page 3-31. If the selected archive
media class fill level is below its low mark threshold, the
archive media class with the next highest priority is selected.
VolServ software then places media from the source archive
media class on the archive eject list. The source archive
Console display EJECT button is then highlighted.
601354 Rev A
Initial Configuration
3-29
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
If the media type low mark threshold is not reached after the
first iteration, the process continues by selecting the next
eligible archive media class and testing its fill level. If the
subject archive media class fill level is above its low mark,
some of its media is placed on the source archive eject list.
When the AO ejects a medium from the source archive, the
destination archive enter list is appended with that same
medium. Then the destination archive Console display ENTER
button is highlighted.
Media type migration continues until one of the following
occurs:
•
•
•
The media type fill level reaches the media type low mark
threshold.
All archive media classes are exhausted of their supply of
eligible media (that is, all of their low marks are reached).
The AO removes the media from the eject list.
The reasons for discontinuing media type migration are the
same as for media class migration.
Intransit Media
(Migrate)
During migration, media that are ejected from the source
archive but not entered in the target archive are placed in the
intransit state. This state indicates that media are known by
VolServ software but are not actually resident in an archive.
3-30
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
When the archive media class action mode migrate option is
selected, a migration priority is assigned to the archive media
class. This value is used only during media type migration.
When media type migration begins, media from the highest
priority archive media class are first moved to the source
archive Eject list. If additional media must be ejected to meet
the media type low mark, the media class with the next highest
migration priority is chosen for processing.
Migration
Priority and
Archive
The migration archive is the target archive for all media ejected
because media class migration or media type migration. As a
medium or media are removed from the source archive for the
purpose of migration, the destination archive (or migration
archive) Console ENTER button is highlighted.
When preferred media placement entries (DataShelf archive
only) are defined for a Media Class, VolServ directs placement
of media entered into that media class to a particular area in an
archive.
Preferred Media
Placement
When a medium is entered into an archive for any reason
(import, checkin, move, migrate) or dismounted from a drive,
VolServ software checks if its media class is configured for
preferred placement. If it is, VolServ software directs
placement to a specific area in the archive. Note that preferred
placement values override the archive fill mode made during
archive configuration.
Entries in this field are four integers, separated by commas. Its
form is #,#,#,#. The entries stand for row, column, shelf, and
bin.
The primary use of preferred placement is to ensure that media
in a particular media class are placed near a system resource,
such as drives.
601354 Rev A
Initial Configuration
3-31
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After all archives at a site are successfully configured and
registered with VolServ, at least one drive must be defined and
associated with an archive.
Create a Drive
Note
VolServ has to be running to define a drive.
The Create Drive command is used to define a drive; four
drive statistics are associated with it. These are the usage count,
current usage time, total usage time, and error count. These
built-in statistics are provided by VolServ software, but only the
usage count is automatically updated by VolServ software.
Usage count indicates the number of times that media are
mounted to a drive.
VolServ clients are responsible for keeping the other three
statistics values updated. It is recommended that they be
defined as follows:
•
•
•
Current usage time indicates read/write operation time in
seconds since the latest preventive maintenance
Total usage time indicates the read/write operation time in
seconds since the drive definition
Error count indicates the number of read/write errors
All statistics are initialized to zero when a drive is defined. Two
of these statistics are cleared when a drive is varied to an
Drive definition is performed via the GUI. Its parameters
consist of the drive ID and media type that the drive supports.
After a drive is defined, it cannot be changed. It must be deleted
and defined again.
3-32
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Drives can be defined before the creation of media classes.
However, they ultimately must be associated with an archive
before they can be used to mount media.
After all drives are successfully defined, they must be
associated with an archive before they can be used to mount
media. The Associate Drive command is used to associate a
drive with an archive.
Associate a
Drive with an
Archive
Drive association parameters are acquired by VolServ software
via the GUI. Basic association parameters consist of associate
drive, associate with archive, and CLM/DriveSlot (automated
archive only). The associate drive entry must match a drive ID
entered during drive definition. The associate with archive entry
must match an archive name entered during archive
configuration.
When a drive is associated with an automated archive, the
physical location of the drive must also be specified. This
information is contained in the CLM/DriveSlot entry and
describes the media hand-off location between the robot and the
drive. Entries in this field are four integers, separated by
commas, with the form #,#,#,# for the following archives:
•
•
•
DataShelf archive
DataTower archive
StorageTek ACS product family archives
Entries have the form Dc##010101 for the AML archives. The
“c” character relates to the media type used by the drive. The
“##” characters refer to a logical mapping of the drive slot XYZ
position and is used by the AML archives.
601354 Rev A
Initial Configuration
3-33
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Entries have the form d#t#l0 for the SCSI drives. The first #
indicates the element address of the drive in the library and the
second # indicates the SCSI target id of the drive.
Entries match the drive names that are configured for the Scalar
DLC drives, for example, PDR256.
When the CLM/Drive Slot entry is made, only those drive slots
that interface to installed drives and are not associated are
available for selection.
After a drive is associated with an archive, its parameters
cannot be changed. It must be disassociated and associated
again to change any parameter. Drive parameters can be viewed
using the Query Drive command.
The Import Media command has an option that allows barcode
labels to be printed. Using previously-defined label patterns
allow generation of unique, sequential media identifiers to be
used during import and also to be directed to a barcode label
printer.
Define a Label
Pattern
VolServ software acquires label pattern information only via
the GUI Define Label Pattern window. Basic parameters
consist of label pattern name and label pattern definition. After
a label pattern is defined, its cannot be changed. It must be
deleted and defined again.
Label patterns can be defined at any time that VolServ is
running. However, a label pattern must be unique and must be
defined before printing a label with that particular pattern.
3-34
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
After at least one archive media class is successfully
Add Media to an
Archive
configured, media can be entered into an archive. In fact,
normal operations cannot begin until media are entered into an
archive.
Note
VolServ has to be running to add media to an archive.
Four basic methods are used to add media to most automated
archives. These methods use the Import Media command
unsolicited enter operation (refer to “Unsolicited Entry of
Known Media” on page 4-30), and the enter operation (refer to
To enter media into a DataShelf or Stage archive, only the
Import Media command can be used.
When importing media into an archive, media labels must be
affixed to them. Refer to “Reprint a Media Label” on page 4-37
for more information. Also refer to “Import Media into an
The Import Media command is the preferred method to use
when entering relatively few media into an automated archive.
The bulk loading method is preferred if there are a relatively
large amounts of media to be entered. For specific automated
archives, the enter or unsolicited enter operations are allowed
by VolServ.
601354 Rev A
Initial Configuration
3-35
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
3-36
Initial Configuration
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
4-2
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Roadmap
Refer To
Chapter
Topic
General software installation information
1
2
3
4
5
6
Hardware and software start-up
Site-specific configuration of archives and drive.
Daily operations
Archive operation and configuration
Troubleshooting tips and solutions
601354 Rev A
Normal Operations
4-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Normal operations are functions performed on a daily basis.
Some of functions are routine while others may require making
modifications to the existing site configuration, changing
privileges for a client application or VolServ System Operator
(SO), or responding to a client application request. This chapter
describes these and other operations that are performed on a
daily basis.
Overview
VolServ is backed up using standard UNIX backup procedures.
Backup
4-4
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All VolServ commands are executed as they are sent. However,
a command queue keeps track of commands that arrive when
VolServ resources are busy.
Command
Priorities
Note that each command is associated with an execution
priority that ranges from 0 to 32 (high to low). The default
priority for each command is 15. Unless changed by a client, all
commands have a priority of 15. Commands with equal priority
are executed in a first-come first-served order.
To expedite a particular command in the queue when VolServ
resources are busy, the reprioritize request command is used.
When a command priority is changed to a higher value (that is,
numerically smaller), its position in the queue is moved closer
to first place.
Commands can be reprioritized via the GUI and API. The
reprioritize request parameters are the reprioritize request
identifier and new priority. The new priority replaces the
previous command priority in VolServ execution queue.
Any command in VolServ command queue, except the
dismount command, can be cancelled. Commands can be
cancelled via the GUI and API. The only cancel request
parameter is the cancel request identifier. When executed, the
command is removed from VolServ command queue.
Command
Cancellation
601354 Rev A
Normal Operations
4-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All archive management operations can be performed via the
GUI except where noted.
Archive
Management
An archive can be configured or reconfigured at any time. The
Configure Archive command is used to create an archive
definition and is covered in the initial configuration section of
description of archive configuration.
Configure/
Reconfigure an
Archive
The Reconfigure Archive command allows modification of
most parameters entered during archive configuration. One
exception is the media type entry that is input when an archive
is configured. Modifying the media type could affect the
archive media classes associated with an archive.
If a specific archive is no longer needed, the Delete Archive
command permits removal of an archive from a VolServ
system. An archive can be deleted easily because it contains no
media, but it can also be removed if media are contained in it.
Delete an
Archive
The ability to delete an archive with media in it depends on the
value of the DELETE_ARCHIVE_WITH_MEDIAenvironment
variable. When set to N, any archive containing media can be
deleted. When set to Y, the value of the
DELETE_ARCHIVE_MEDIA_ACTIONSTATE environment
variable determines how media are to be handled when a
populated archive is deleted.
for information about these environment variables.
4-6
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The change archive parameters command allows changing two
archive parameters without requiring that the archive become
unavailable. These parameters are the archive mode and archive
console display host.
Change Archive
Parameters
The archive mode attended option is usually selected. When the
AO or any other attendant is not available to perform media
handling, the archive mode can be changed to unattended.
However, this change can affect the behavior of the move
media, mount media, checkin media, checkout media, import
media, and export media associated commands, as well as the
media migration process.
Whenever necessary, the archive console display host can be
changed without requiring archive reconfiguration.
The change archive parameters include the change archive, new
mode, new console display host, and priority. The priority is
used to determine the command location in VolServ command
queue.
During maintenance operations, it is necessary to make
equipment unavailable for use. The vary archive command is
used to disable or enable an entire archive. It can also be used to
enable local manual control of an archive.
Vary Archive
Archives can be in one of four states: on-line, off-line,
diagnostic, and unavailable. The on-line,
off-line, and diagnosticstates are entered by human
intervention. The on-linestate is the normal operational
state. All archive equipment is inoperable and usually awaiting
maintenance during the off-line state. The diagnostic
state is used to allow local manual control of an archive. This
mode is generally used during archive troubleshooting.
601354 Rev A
Normal Operations
4-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The unavailablestate is a derived state. It is reserved for
lower level equipment and is automatically entered when higher
level equipment goes into the off-line state or is moved
into the diagnosticstate. That is, this state applies to
archive components when the archive is moved to the
off-line or diagnosticstates.
The vary archivecommand is available via the GUI, CLI,
and API. The vary archive parameters are the vary archive, new
state, and priority. The priority is used to determine the
command location in VolServ command queue.
At times during maintenance operations, it is necessary to make
specific components unavailable for use. The vary archive
component command is used to disable portions of an archive.
Vary Archive
Component
Like an archive, archive components can be in one of four
states: on-line, off-line, diagnostic, and
unavailable. The definition of these states are the same as
for the vary archive command.
The vary archive component parameters are the vary
archive, new state, and priority. The priorityis
used to determine the command location in VolServ command
queue.
All parameters of an existing media type can be modified using
the redefine media type command. For more information, refer
media type definition.
Redefine a
Media Type
4-8
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Media classes can be created, modified, or deleted at any time.
media class creation is covered in the initial configuration
section of this manual. Refer to “Create a Media Class” on
page 3-19 for a description of the create media class command.
Create/Modify/
Delete a Media
Class
Using the modify media class command, all media class
parameters defined during media class creation can be
modified, except for the media type used. No mixed media
types are allowed within a media class.
At some time, a media class may no longer be necessary based
on its usage within the context of the VolServ system. When
this happens, it can be deleted using the delete media class
command. However, the archive media class with which the
media class is associated must first be deleted.
The create, modify, and delete media class associated
commands are available via the GUI and API.
An archive media class can be added or modified at any time.
The create archive media class command is covered in the
initial configuration section of this manual. Refer to “Create an
Create/Modify
an Archive
Media Class
After a new archive media class is created, media can be
explicitly moved into it using the import media, move media,
and reclassify media associated commands.
Media can also be implicitly moved into a new archive media
class via the audit and unsolicited enter operations. Population
via these two operations occurs only if the new archive media
class is named as the target class for auto import. The
reconfigure archive command can be used to name the new
class as the auto import target.
601354 Rev A
Normal Operations
4-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Using the Modify Archive Media Class command, all archive
media class parameters defined during archive media class
creation may be modified.
The Create and Modify Archive Media Class associated
commands are available via the GUI and API.
When an archive media class is no longer needed, the Delete
Archive Media Class command permits disassociation of a
Media Class from an archive. It may also be necessary to
reassign a Media Class to a different archive. When this occurs,
an archive media class association can be deleted using the
Delete Archive Media Class command. However, all media
must first be moved out of the archive media class. The
Reclassify Media and Move Media associated commands can
be used to move media. The Export Media command can also
be used, but the media and its media information is totally
removed from the VolServ system.
Delete an
Archive Media
Class
The Delete Archive Media Class command is available via the
GUI and API.
Media migration policy is the combined effect of media class
description of the two varieties of media migration.
Define Media
MigrationPolicy
Refer to the figure on the following page to see an example of
migration class migration, suppose Media Class Group A is
associated with Archive X, Archive Y, and Archive Z. Assume
that the following parameters were defined during archive
configuration, media class creation, and archive media class
association:
•
Media Class Group A has a capacity of 200
4-10
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
•
•
•
•
•
40 percent of Media Class Group A is associated with
Archive X
40 percent of Media Class Group A is associated with
Archive Y
20 percent of Media Class Group A is associated with
archive Z
High mark and low mark for Archive Media Class AX is
80percent and 60 percent, respectively
High mark and low mark for Archive Media Class AY is 70
percent and 60 percent, respectively
Migration archives are defined such that migration proceeds
from left to right(i.e., from AX to AY to AZ).
Z
X
Y
Media Class Group A
Direction of Migration
When the Archive Media Class AX fill level reaches the high
mark threshold of 64 media (= 200 * 0.40 * 0.80 = Media Class
Group A capacity * Archive Media Class AX % * Archive
Media Class AX high mark %), migration begins. Media are
migrated from Archive X into Archive Y. Migration continues
601354 Rev A
Normal Operations
4-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
until the Archive Media Class AX fill level reaches the low
mark threshold of 48 media (= 200 * 0.40 * 0.60 = Media Class
Group A capacity * Archive Media Class AX % * Archive
Media Class AX low mark %). In this case, 16 media are
migrated to Archive Media Class AY.
Now assume that the Archive Media Class AY fill level was at
the low mark threshold of 48 media (= 200 * 0.40 * 0.60). Note
that the Archive Media Class AY high mark threshold is 56
media (= 200 * 0.40 * 0.70). When migration from Archive X
occurs, at least 16 media are transferred. Therefore, migration
from AX to AY causes the Archive Media Class AY fill level to
reach its high mark sleuthed. Migration between Archive Media
Class AY and Archive Media Class AZ begins. In this example,
all 16 media migrated from Archive Media Class AX to
Archive Media Class AY is also migrated to Archive Media
Class AZ, provided enough space is available in Archive Media
Class AZ.
Archive Media Class AZ can contain a maximum of 40 media
(= 200 * 0.20). For media migration to complete, the Archive
Media Class AZ fill level must contain 24 or fewer media.
Otherwise, migration fails for those media that cannot be
transferred.
Media migration descriptions in “Media Type Migration” on
initial media migration planning. However, it may be necessary
to periodically modify parameters that control migration. Such
parameters are the media type high mark and low mark and the
media class percentage, high mark and low mark.
Modify Media
MigrationPolicy
4-12
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Reconfigure Archive command can be used to change the
media type high mark and low mark. Changing these two
factors affect media type migration parameters only (media
type high mark threshold and media type low mark threshold).
For example, if the high mark is raised or lowered, the media
type fill level that triggers media type migration is also raised or
lowered.
Media class migration parameters (media class percentage, high
mark, and low mark) can be changed using the Modify Media
Class or Modify Archive Media Class associated commands.
Note that the media class high mark threshold is equal to the
product of media class capacity, archive media class
percentage, and archive media class high mark. Therefore,
changing any one of these three parameters affects the media
class high mark threshold.
Media migration can be disabled when desired. To disable
media type migration only, use the Reconfigure Archive
command to change the archive action mode to none or notify.
To disable both media class and media type migration, use the
Modify Archive Media Class command to change the archive
media class action mode to none or notify.
601354 Rev A
Normal Operations
4-13
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
When a site requires the addition of another archive, the
operations are almost identical to the operations outlined in the
initial configuration section of this chapter.
Add Archive to
Existing
Installation
However, only certain archives may be configured. When
VolServ software is installed, license strings are input that
allow only specific archives to be configured. To add a new
archive type, call ATAC to obtain a license string for that type
of archive.
•
•
In the USA and Canada, call 1-800-827-3822.
Outside the USA and Canada, call 303-874-0188 or toll-free
00800-9999-3822.
•
ATAC support personnel will request the host identifier or CPU
identifier when a new license string is required. Use the cpuid
or hostid commands to obtain the necessary identifier.
Execute the mk_license utility to enter the license string using
the following command line:
$VS_DIR/utilities/mk_license
Read the instructions provided on the terminal, exit the utility,
and execute the command line using the proper arguments. Any
additional steps are provided by ATAC.
An audit command is used for two reasons. One is to input
relatively large amounts of media into an archive at one time.
to verify consistency between an actual archive’s contents and
for more information about automated archive audits. Manual
Audit an
Archive
4-14
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
In general, a comparison is made between the VolServ database
and the actual media inventory when an Audit command is
executed. The automated archive robot or the manual archive
AO inventories the media. The result of this audit is sent to
VolServ, which compares the actual and logical inventory.
No action is taken when the inventory matches the VolServ
database. However, human intervention is necessary to resolve
some archive discrepancies. For example, an AO may find a
medium during an manual archive audit that is not contained in
the VolServ database listing. The SA must determine whether
this medium belongs in the manual archive. If it does, the
Import command is executed by the SA, followed by an enter
action by the AO.
The Audit command is available via the CLI and API, and also
using the AUDIT option of an archive Console.
601354 Rev A
Normal Operations
4-15
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All Drive Management operations can be performed via the
GUI and API, except where noted.
Drive
Management
A drive can be created and associated with an archive at any
time. The Create Drive command is used to create a drive
definition and is covered in the initial configuration section of
description of drive creation.
Create and
Associate a
Drive
All created drives must be associated with an archive before it
can be used to mount media. The Associate Drive command is
used to associate a created drive with a specific archive. This
command is also covered in the initial configuration section of
this manual. Refer to “Associate a Drive with an Archive” on
The Create Drive and Associate Drive associated commands
are available via the GUI only.
At times, it is necessary to move a drive to another position in
an archive or to another archive. When a drive is moved, it must
be disassociated from an archive using the Disassociate Drive
command before it can be used in its new location. After the
drive is relocated, the drive must be associated with its new
archive.
Disassociate
and Delete a
Drive
If a drive is to be temporarily removed from service, it can be
moved to the off-line or diagnostic state using the Vary Drive
completely removed from a VolServ system using a
combination of the Disassociate Drive and Delete Drive
associated commands. An in-use drive cannot be disassociated
from an archive.
4-16
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The only parameter necessary for the Disassociate Drive and
Delete Drive associated commands is the drive identifier.
The Disassociate Drive and Delete Drive associated commands
are available via the GUI only.
When an SA, SO, or client uses a Mount Media command and
the specified drive is busy, the command is placed in a
command queue or failed. To increase the likelihood of an
available drive, the Mount Media command may specify a
collection of drives on which to perform the mount. This
collection can be a list of specific drives or a named collection
of drives. Such a named collection is defined as a drive pool and
is created using the Create Drive Pool command.
Create or
Modify a Drive
Pool
Features of a drive pool are:
•
•
All defined drives are available for inclusion in a drive pool
A drive does not need to be associated with an archive to be
a drive pool member
•
•
A drive can be a member of multiple drive pools
Any mix of drive types can be included in a drive pool as
long as the subject media types are supported by the
VolServ system
•
A drive pool may contain zero or more drives
Besides increasing the likelihood of a successful mount, drive
pools can also be used to segregate specific drives to particular
user groups. This can reduce the possibility of drive contention
between such groups.
601354 Rev A
Normal Operations
4-17
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
It is also possible that some drives’ data paths at a site may be
connected to computers not associated with one network. In this
case, drive pools can be created to segregate between the drives
connected to different networks.
The Modify Drive Pool command allows drives to be added to
or deleted from an existing drive pool.
Parameters for Create and Modify Drive Pool commands are
drive pool name and a list of drive identifiers to be added to or
removed from a drive pool.
The Delete Drive Pool command removes a drive pool from the
VolServ database. Parameters for the Delete Drive Pool
command are drive pool name and priority. The priority is used
to determine the command location in VolServ command
queue.
Delete a Drive
Pool
In its simplest form, the Mount Media command is issued to
mount a specific medium on a specific drive. However, a
Mount Media command can be specified several different
ways:
Mount Media on
a Drive
•
Mount by (media identifier or media list or media class) and
(drive identifier or drive pool)
•
Mount by criteria and (drive identifier or drive pool)
The simplest method is to mount by media identifier and drive
identifier. When the specified medium or drive is busy, the
Mount Media command waits in a queue until both are
available. When both are available, the Mount Media command
allocates both the drive and media and begins processing of the
physical mount. Mounting by media identifier and drive
identifier allows selection of a drive in another archive, unless
prevented by a Mount Media command option.
4-18
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The mount by media identifier and drive pool method is used
when a higher likelihood of mounting a specific medium
without waiting is desired. It is possible that the specific
medium could be mounted on any one of the drives listed in the
drive pool. Therefore, a user should not use a drive pool if it
contains a drive to which the user does not have access.
A drive selection algorithm is used to select the best drive to
satisfy the command. The algorithm attempts to use a drive in
the same archive as the medium. However, a drive in another
archive can be selected unless prevented by a Mount Media
command option. The resulting medium/drive pair is chosen to
satisfy the command.
The mount by media list and drive identifier method is used
when the specific medium to be mounted is unimportant except
for a specific list of candidates. A medium selection algorithm
is used to first select media that are in the same archive as the
drive. The second criterion is the medium with the lowest
mount count. The resulting medium/drive pair is chosen to
satisfy the command.
The mount by media list and drive pool method can be used
when a specific medium or drive used to satisfy the mount is
not important. A special set of criteria are used to select the best
medium/drive pair from these candidates. The archive
containing the most available drives from the specified drive
pool is selected first. A tie is broken by using the archive with
the largest number of applicable media from the media list. The
media from the media list that are in the selected archive are
then candidates. Other criteria can reduce the selection to one
medium/drive pair but are beyond the scope of this book.
However, a list of all possible medium/drive pairs is eventually
developed and reduced to the most likely candidate. The
resulting medium/drive pair is chosen to satisfy the command.
601354 Rev A
Normal Operations
4-19
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Like the mount by media list and drive identifier method, the
mount by media class and drive identifier method is used when
the specific medium to be mounted is unimportant except that it
be chosen from a specific Media Class. The medium selection
algorithm used is similar to that of the mount by media list and
drive identifier method.
The mount by media class and drive pool method uses the same
selection criteria as the mount by media list and drive pool
method.
Mount by criteria and drive identifier can be used to mount the
best medium based on client-defined criteria fields. Each
medium can specify up to eight criteria for each medium in a
page 4-34. The utility of this method depends on how well these
optional fields are controlled/updated by the user.
The mount by criteria and drive pool method uses the same
selection criteria as the mount by media list and drive pool
method.
A Mount Media command fails for any of the following
reasons:
•
If the specified drive or bin is (are) not in the on-line state.
•
If the mount by media class and drive identifier of the
mount by media class and drive pool method is used and all
candidate media are in a different archive than all candidate
drives (i.e., no cross-archive move is allowed).
•
•
If the reclassify option is selected and the destination media
class capacity is reached or if the destination class is an
incompatible media type.
If a media list contains media with different media types.
4-20
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
If an improper lock identifier is specified.
The Mount Media command is available over the GUI, CLI,
and API. There is a subset of these capabilities available to the
AO using the MOUNT option of an archive Console. Basic
mount parameters are drive identifier or media class or media
criteria, drive identifier or drive pool, and priority. The priority
is used to determine the command location in VolServ
command queue.
Optional parameters include a lock identifier (to allow
allocation of a locked drive), what archive-to-archive mount
option to use, and whether to reclassify the selected medium to
another media class.
A Multimount Media command can be used to select a parallel
mount action that mounts all media specified or is failed. This
command is available only to clients via the API. Refer to
A medium is dismounted from a drive using the Dismount
Media command.
DismountMedia
from a Drive
When the Dismount Media command is executed, VolServ
software updates only the usage count drive statistic. The
current usage time, total usage time, and error count statistics
can be updated by the client during dismount via the API and
CLI only.
The Dismount Media command is available over the GUI, CLI,
and API, and also using the DISMOUNT option of an archive
Console. Dismount parameters are the dismount media
identifier and priority. The priority is used to determine the
command location in VolServ command queue.
601354 Rev A
Normal Operations
4-21
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
In some cases, a medium may be moved to another archive
because of a Mount Media command. Any medium that is
ejected from the source archive by the AO, but not entered into
the target archive, is placed in the intransit state. This state
indicates that media are known by VolServ software and are
destined for entry into an archive, but are not actually resident
in an archive.
Intransit Media
(Mount)
The Lock Drive command is used to reserve a drive, a list of
drives, or a drive pool for exclusive use. Locking a drive
prevents its allocation by any Mount Media command that does
not provide a lock identifier. The lock identifier is contained in
the return status for a Lock Drive command.
Lock a Drive
When reserved drives are no longer needed, the client issues an
Unlock Drive command. The SA or SO may also issue an
Unlock Drive command to free the drive.
For detailed information about this command, refer to the
VSCMD_Lock command in the MSTM-V21-010 API
Programmer’s Guide.
Only a client can issue a Lock Drive command via the API.
command is used to clear a locked drive so that it can be
allocated to another mount.
Unlock a Drive
The unlock drive parameters are the unlock drive identifier and
priority. The priority is used to determine the command location
in VolServ command queue.
At times it is necessary to make a drive unavailable for use. The
Vary Drive command is used to disable a drive.
Vary Drive
4-22
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The vary drive command also allows a drive to be moved to
the on-line state and clear two of four drive statistics. These
statistics are the current usage time and error count. Refer to
“Create a Drive” on page 3-32 for more information about drive
statistics.
A drive can be in one of four states: on-line, off-line,
diagnostic, and unavailable. The first three states are
entered by human intervention. The unavailablestate is
determined by VolServ software.
The on-linestate is the normal operational state. A drive is
inoperable when in the off-line state. The diagnostic
state is used to allow local manual control. This mode is
generally used during troubleshooting.
The unavailablestate is a logical state entered when certain
critical equipment is moved to the off-linestate. For
example, a drive is in the unavailablestate when the
cassette load mechanism (CLM) is off-line.
The vary drive command is available over the GUI, CLI, and
API. The vary drive state parameters are the vary drive, new
state, and priority. The priority is used to determine the
command location in VolServ command queue.
601354 Rev A
Normal Operations
4-23
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All media management operations may be performed via the
GUI, CLI, and API except where noted.
Media
Management
All media can be classified as known or unknown to the
VolServ system. Unknown media are those that were never
introduced into a VolServ system or were removed using the
Export Media command. Known media are contained in an
archive, checked out using the Check-out Media command, or
being transferred to another archive as a result of a Move Media
command, Mount Media command, or media migration.
Enter Unknown
Media into an
Archive
Specific ways exist to enter unknown media or reenter known
media into an archive. Entry of unknown media into an archive
is covered is this subsection.
Three basic ways exist to enter unknown media into an archive.
One way is to use the Import Media command. Another is to
load a large number of media at one time using the bulk load
method. Finally, VolServ software allows some automated
archives to use an unsolicited enter and AutoEnter methods.
Import Media into
an Archive
The Import Media command allows the most direct way to
place unknown media into an archive. When executed, the
media are placed on the Enter list for that archive.
Note
Media migration can occur if an Import command and ensuing
Enter operation results in fill levels exceeding the media type
or archive media class high marks.
4-24
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Appropriate labels must be affixed to all media to be imported.
A GUI option imbedded in the Import window allows the SA
or SO to print multiple barcode media labels or human-readable
paper labels at one time. The Reprint Media Label command
a Media Label” on page 4-37 for more information.
Basic import parameters consist of import media identifier,
destination archive, destination media class, and priority. The
priority is used to determine the command location in VolServ
command queue.
Optional parameters are manufacturer and batch text entries. No
format requirement exists, other than length. If one is specified,
the other also must be specified.
A media identifier can be any pattern of characters or integers.
Each one should be unique. Previously-defined label patterns
can be used during an Import operation to generate unique,
sequential media identifiers. Refer to “Define a Label Pattern”
on page 3-34 for more information. These identifiers can also
be directed to a barcode label printer.
An example of loading blank media is to import the media into
a blank archive media class. When necessary, the Reclassify
Media command can be used to move blank media into another
archive media class. Using the Reclassify Media command in
this way does not require additional handling of the media.
Refer following figure. Of course, media can be imported
directly into any archive media class unless the archive, media
class, or archive media class capacities are reached.
601354 Rev A
Normal Operations
4-25
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Manual
Archive
(Stage)
Automated
Archive
Blank Media
Class Group
Import
Media Class Group A
Reclassify
Media Class Group B
The fill level of the destination archive media class must be low
enough to allow addition of more media.
Archive media class capacity - Fill level = Amount of media that can be entered
Excess media are placed on the Eject list after the audit.
Intransit Media
(Import)
After media are identified for entry by the Import Media
command, but before entry by the AO, the subject media are
placed in the intransitstate. This state indicates that media
are known by VolServ software but are not physically resident
in an archive.
4-26
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Bulk Load Media
The bulk load method is the best way to place a relatively large
quantity of media into an automated archive. The media are
installed by hand into an automated archive and followed by an
audit operation. The audit is performed to logically enter the
media into the VolServ database. This is an AO or client
operation only and cannot be entered using the Volume Server
System console.
Note
If media action modes are set for migrate, media migration can
occur if a bulk load results in fill levels exceeding the media
type or archive media class high marks.
Four prerequisites for using this method include:
•
Each medium must have a barcode label affixed to it. The
Reprint Media Label command can be used to print
on page 4-37 for more information.
•
The archive must be configured with the auto check-in and
auto import options selected. If not, all the subject media are
placed on the Eject list after the audit (except for the
DataTower archive; refer to “Unsolicited Enter of Unknown
•
The auto import destination media class (set up during
archive configuration) must have a capacity low enough to
allow addition of more media. Excess media are placed on
the Eject list after the audit.
Destination media class capacity - Fill level = Amount of media that can be entered
•
The receiving archive media class fill level must be low
enough to allow addition of more media. Excess media are
placed on the Eject list after the audit.
601354 Rev A
Normal Operations
4-27
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Receiving archive media class capacity - Fill level = Amount of media that can be
entered
In the last three cases, the DataTower moves excess media to its
Eject port.
Unsolicited Enter of
Unknown Media
The DataTower archive supports the unsolicited media enter
operation. An unsolicited media enter operation is performed
without VolServ system GUI interaction.
Note
If media action modes are set for migrate, media migration can
occur if an unsolicited enter results in fill levels exceeding the
media type or archive media class high marks.
During an unsolicited media enter operation, media are placed
in the DataTower load port, followed by pushing a button above
the load port. The archive robot reads the media labels and
sends the media identifiers to VolServ. If any of the media in
the load port are shown as checked-out by VolServ, the setting
of the auto check-in parameter determines the action taken by
VolServ.
If media to be entered are not labeled, the Reprint Media Label
command can be used to print individual barcode labels or
smaller, human-readable-only paper labels. Refer to “Reprint a
Media Label” on page 4-37 for more information.
There are four prerequisites for using this method:
•
Each medium must have a barcode label affixed to it. The
Reprint Media Label command can be used to print
on page 4-37 for more information.
4-28
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
•
The target archive must be configured with the auto
check-in and auto import options selected. If not, all the
subject media are left in the load port and a failure message
is logged and displayed at the Volume Server System
console.
The auto import destination media class (set up during
archive configuration) must have a capacity low enough to
allow addition of more media. Excess media are left in the
load port and a failure message is logged and displayed at
the Volume Server System console.
Destination media class capacity - Fill level = Amount of media that can be entered
•
The receiving archive media class fill level must be low
enough to allow addition of more media. Excess media are
left in the load port and a failure message is logged and
displayed at the Volume Server System console.
Archive media class capacity - Fill level = Amount of media that can be entered
All media can be classified as known or unknown. Unknown
media were never introduced into a VolServ system or were
removed using the Export Media command. Known media are
contained in an archive, are checked out using the Check-out
Media command, or are intransit to another archive as a result
of a Move Media command, Mount Media command, or media
migration.
Enter Known
Media into an
Archive
Two basic ways to reenter known media into an archive are: the
Check-in Media command and the unsolicited enter and
AutoEnter methods.
601354 Rev A
Normal Operations
4-29
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Check-in Media into
an Archive
The Check-in Media command enters checked out media into
an archive. These media are placed on the Enter list. If media to
be checked in are not labeled, labels must be provided. Refer to
“Reprint a Media Label” on page 4-37 or use the Print Label
option of the Import Media command.
Note
If media action modes are set for migrate, media migration can
occur if a check-in command results in fill levels exceeding the
media type or archive media class high marks.
Basic check-in parameters are the checkin media identifier,
destination archive, and priority. The priority determines the
command location in VolServ command queue.
Unsolicited Entry of
Known Media
The DataTower archive supports the unsolicited media enter
operation. An unsolicited media enter operation is performed
without VolServ system GUI interaction.
Note
If media action modes are set for migrate, media migration can
occur if an unsolicited Enter operation results in fill levels
exceeding the media type or archive media class high marks.
After media are loaded into the DataTower load port, the AO
pushes the LOAD button on the archive. The archive robot
barcode reader scans the media label, retrieves the media from
the load port, and places the media into bins.
4-30
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Three prerequisites for using this method include:
•
•
•
Each medium must have a barcode label affixed to it. The
Reprint Media Label command can be used to print
on page 4-37 for more information.
If the target archive is not configured with the auto check-in
option selected, all media that are checked out are left in the
load port and a failure message is logged and displayed at
the Volume Server System console.
The medium is returned to its previous archive media class.
The fill level of its archive media class must be low enough
to allow addition of more media. Excess media are left in
the load port and a failure message is logged and displayed
at the Volume Server System console.
Archive media class capacity - Fill level = Amount of media that can be entered
Three basic ways to remove media from an archive include: the
Export Media command, Check-out Media command, and
Manual Eject command.
Remove Media
from an Archive
Export Media from
an Archive
The Export Media command identifies media for removal from
an archive. These media are placed on the Eject list. When the
AO ejects the media, all information about those media is
removed from the VolServ database. These media are then
classified as unknown media.
601354 Rev A
Normal Operations
4-31
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Basic export parameters are the export media identifier, export
comment, and priority. The export comment is optional and
appears on the Eject list. This comment can be used to convey
additional information, such as the source of the command. No
format requirements exist, other than length. The priority is
used to determine the command location in VolServ command
queue.
Check-out Media
from an Archive
The check-out media command is used to temporarily remove
media from an archive. These media are placed on the eject list.
unlike the export media command, media information is
retained in the VolServ database after the AO ejects the media.
These media remain classified as known media.
Basic check out parameters are the checkout media
identifier,checkout comment, and priority. The
checkout comment is optional and appears on the Eject
list. This comment can be used to convey additional
information, such as the source of the command. No format
requirements exist, other than length. The priority is used to
determine the command location in VolServ command queue.
Manual Eject Media
from an Archive
The manual eject command is generally used when media in an
automated archive cannot be retrieved by the robot. However,
the manual eject command can be used for any reason. A
medium cannot be retrieved when:
•
•
•
•
A medium label cannot be read by a robot barcode reader.
A medium has fallen on the archive floor.
A medium becomes jammed in a tape drive.
A medium is unavailable for any reason, such as the
nonoperational robot or archive equipment.
4-32
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
In this operational scenario, the AO varies the archive to the
off-line or maintenance state, opens the archive door, and
removes the media. Then VolServ software is notified that the
media were physically removed by the operator.
Unlike the export media command, media information is
retained in the VolServ database after the Manual Eject
command is executed. These media remain classified as known
media.
The manual eject command is available over the GUI only. The
manual eject parameters are manual eject media identifier and
priority. The priority determines the command location in
VolServ command queue.
The move media command is recommended for reentering
media that were manually ejected. The unsolicited enter of a
known media and bulk load methods can also be used.
Intransit Media
(Manual Eject)
After media are identified using the manual eject command, the
subject media are placed in the intransit state. This state
indicates that media are known by VolServ software but are not
actually physically in an archive.
When media are placed on the eject list, one or more media on
the list can be removed by the SA or SO using the clear eject
command. Clear eject parameters are the clear eject media
identifier and priority. The priority determines the command
location in VolServ command queue.
Clear Eject List
Entries
601354 Rev A
Normal Operations
4-33
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Sometimes media located in one archive must be moved to
another archive. For example, it may be advantageous to move
infrequently accessed media from an automated archive to a
manual archive. Also, media that are in the intransitstate
can be reentered into an archive using the move media
command.
Move Media to
Another
Archive
Basic move parameters are the move media identifier,
destination archive, and priority. The priority
determines the command location in VolServ command queue.
Optional parameters are a wait for status on completed move
option and move media only if both archives are attended
option.
Before media can be moved, the destination archive must be
associated with the same media class as the media.
Media that are ejected from the source archive by the AO but
not entered into the target archive are placed in the
intransitstate. This state indicates that media are known
by VolServ software but are not physically resident in an
archive.
Intransit Media
(Move)
Optional media criteria can be associated with each media using
the modify media command. These are also referred to as user
or client statistics. Examples of user or client statistics are:
amount of usable space left on a medium, the most recent
mount date, and a user name.
Modify Media
Criteria
4-34
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
These user statistics are generally created and modified by
client applications. However, the SA or SO can also create and
change any user statistic. The primary use of user statistics is
for the Mount Media command’s mount by criteria option.
This option allows media to be selected for mounting based on
logical expressions that define a range of acceptable statistics
values.
Implicit in this capability is the need for a client or SA to
establish a policy to maintain a consistent set of criteria. After a
statistic is defined, it should be consistently applied to each
medium. It is the responsibility of each client or SA to establish
such a policy and to update them during operations.
A total of eight user statistics can be specified for each medium.
Four are character-based statistics and four are integer-based.
The Modify Media command is available over the GUI and
API only. Modify media parameters are the media identifier,
field index, and value. The field index entry specifies the target
statistic to create or replace. The value entry is then associated
with this field index number.
When the default media types supported by VolServ software
are not sufficient, a new media type may be defined and
registered with VolServ.
Define a Media
Type
The Define Media Type command is used along with manual
more information.
601354 Rev A
Normal Operations
4-35
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Reclassify Media command moves media from one Media
Class to another. A list of possible reasons for reclassification
include the following:
Reclassify
Media
•
It can move blank media into any media class without
requiring physical handling of the media.
•
It can remove media from an archive media class before
deleting the archive media class.
•
•
A large Media Class can be split into smaller groups.
Older media can be moved into a long-term storage media
class.
Several restrictions apply to the use of the Reclassify Media
command. Refer to the API reference manual for more
information, but a few of the more important ones are repeated
here:
•
Media must be reclassified into another media class that
uses the same media type.
•
When reclassified media are resident in an archive, they are
not moved to another archive. However, reclassified media
do not have to be in an archive.
•
A target archive media class capacity can be exceeded up to
the point where the media class capacity is reached.
However, media class migration results if the media class
migrate option is selected.
Reclassify parameters consist of the reclassify media identifier,
destination media class, and priority. The priority determines
the command location in VolServ command queue.
4-36
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
A label pattern can be created at any time. The define label
pattern command creates a label pattern and is covered in the
initial configuration section of this manual. Refer to “Define a
Define or Delete
a Label Pattern
Previously-defined label patterns can be deleted using the
Delete Label Pattern command. Note that a label pattern
definition cannot be changed. It must be deleted and defined
again.
This command is available only via the GUI. The only
command parameter is a label pattern name.
VolServ software allows media labels to be printed using the
Reprint Media Label command. Both shelf labels and barcode
labels can be printed using this command that is available only
via the GUI.
Reprint a Media
Label
DataShelf or Stage
Archive Labels
The import media command can be used to print
human-readable, paper media labels for the manual archives.
The Import window print labels option is selected to print a
label for each medium to be imported. These labels are intended
for use in a manual archive environment.
The preformatted output is targeted to the Seiko smart label
printer pro printer. The printer must be attached to the VolServ
host computer or on the network to use VolServ to print
barcode labels.
Barcode Labels
The Reprint Media Label command can be used to print labels
for media that can be read by a barcode reader. These labels are
primarily intended for use in labeling D2 media.
601354 Rev A
Normal Operations
4-37
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Import Media command can be used to print barcode
labels for use in automated archives. The Import window print
labels option is selected to print a label for each medium to be
imported.
The preformatted output is sent to the Intermec 4100 label
printer. It must be attached to the VolServ host computer or the
network to use VolServ to print barcode labels. The label stock
is highly resistant to tear and wear.
4-38
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The system queries and reports provides information about the
VolServ configured system. These reports provide
configuration specific information to help manage the VolServ
system for optimal performance.
System
Reports
All system queries and report operations can be performed via
the GUI, CLI, or API, except where noted.
The Query Archive command queries VolServ to obtain
information about an archive and associated parameters. A
report is generated and can be sent to the screen, a specified file,
The default report produces the following information:
Query Archive
Field
Description
Archive
Name of archive
Archive Type
What type of archive the report was
generated for; i.e., AML/E, DataShelf,
Stage.
Current State
Archive Mode
The state of the archive; whether it is
Online, Offline, or Diagnostic state.
Whether an operator is present
(Attended) or not present (Unattended).
Console Display
Location
What workstation the archive Console is
displayed on.
Fill Mode
How the media is placed in the archive.
First fill, Wrap or None.
Configure State
Drive ID
If the archive is configured or not being
configured.
The drive names associated with the
archive.
601354 Rev A
Normal Operations
4-39
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Media ID
The media located in the archive.
Media Class
Media Type
Media Class associated with the archive
The default type of media associated with
the Media Class.
Valid values are AIT, CTIII (DLT), CTIV
(DLT), D2s, D2M, D2L, D3, DTF, DTF-2,
LTO, MO5.25, NCTP, RF5.25, ST-120,
3480, 3490, 3490E, 8590, 9840, 8MM,
4MM, and USERTYPE.
Class Capacity %
Class Capacity
The percent of the Media Class located in
the archive.
The maximum number of media
associated with the Media Class that can
be stored in the archive.
Current Fill Level
Archive Capacity
Current Fill Level
Assigned Locations
The actual number of media associated
with the Media Class located in the
archive.
The maximum number of media
associated with the Media Class the
archive stores.
The actual number of media associated
with the Media Class located in the
archive.
The number of media associated with the
Media Class that are physically in the
archive.
Auto Check-in
Auto Import
Whether or not auto check-in is enabled
or disabled. Valid values are on or off.
Whether or not the auto import option is
enabled or disabled. Valid values are on
or off. If Auto Import is on, the following
additional information is shown:
4-40
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Media Class
The Media Class associated with the
Media Class.
Manufacturer
Batch
The media manufacture name.
The lot or reference number associated
with a group of media from a supplier.
Action
The action associated with the archive
when the archive meets or exceeds the
Low Mark or High Mark parameters. Valid
values are None, Notify, or Migrate.
The Query Archive command can be tailored to show detailed
information for drives, media, Media Classes and/or media type
information associated with the archive. An example showing
only a Media Class and media types is shown in the following
screen display.
----------------------------------------------------------------------------------
Archive Query Report May 24 12:43:18 1999
----------------------------------------------------------------------------------
Archive: shelf1
----------------------------------------------------------------------------------
1
Archive Type:
Current State:
Archive Mode:
Console Display Location:
Fill Mode:
DataShelf
On-Line
Attended
Columbia:0
None
Configure State:
Not Being Configured
MediaClass:
MediaType:
MC-D2M
D2M
50%
40
Class Capacity %:
Class Capacity:
Current Fill Level:
Action:
2
None
601354 Rev A
Normal Operations
4-41
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
MediaType:
D2M
Archive Capacity:
40
Current Fill Level:
Assigned Locations:
Auto Checkin:
Auto Import:
2
2
Off
Off
None
Action:
The Query Drive command obtains information about one or
more drives and associated parameters used in the VolServ
system. A report is generated and can be sent to the screen, a
specified file, or printer as shown in the following screen
display. The default report produces the following information:
Query Drive
Field
Description
Drive ID
The drive identifier number for the drive
being shown.
Drive Type
The type of drive; i.e. Magnetic, Optical,
etc.
Associated Archive
Current State
Archive with which the drive is associated.
The state of the archive whether it is
Online, Offline, Diagnostic, or
Unavailable.
Assignment
If the drive is Allocated for a request or
Free with no request pending.
Usage Count
a definition of this statistic.
Current Usage Time
Total Usage Time
a definition of this statistic.
a definition of this statistic.
4-42
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Error Count
a definition of this statistic.
Mount State
Whether a medium is mounted or not
mounted in the drive when the query was
executed. Valid values are Mounted or
Unmounted.
Mounted Media ID
Shows which medium is mounted in the
drive.
Media Type
Supported
The default type of media associated with
the Media Class.
Valid values are CTIII (DLT), CTIV (DLT),
D2s, D2M, D2L, D3, DTF, DTF-2, LTO,
MO5.25, NCTP, RF5.25, ST-120, 3480,
3490, 3490E, 8590, 9840, 8MM, 4MM,
and USERTYPE.
--------------------------------------------------------
Drive Query Report Mar 10 11:00:32 1999
--------------------------------------------------------
Drive ID: 1
--------------------------------------------------------
Drive Type:
Magnetic
Associated Archive:
Current State:
Assignment:
Stage1
On-line
Free
Usage Count:
0
Current Usage Time:
Total Usage Time:
Error Count:
0
0
0
Mount State:
Unmounted
Mounted Media ID:
Media Type(s) Supported:
D2M
601354 Rev A
Normal Operations
4-43
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Query Drive Pool command obtains information about
one or all drive pools. A report is generated and can be sent to
the screen, a specified file, or printer.
Query Drive
Pool
The report can be tailored to include only the drive identifiers
associated with the drive pool or a detailed report showing each
drives’ parameters associated with the drive pool. An example
of each report is shown in the following screen display, drive
pool query report. The default report produces the following
information:
Field
Description
Drive Pool
The name of the drive pool.
Drive ID
The drives identifiers associated with the
drive pool. For detailed reports, the drive
identifier for the drive being shown.
Drive Type
The type of drive, such as Magnetic,
Optical, etc.
Associated Archive
Current State
Archive with which the drive is associated.
The state of the archive whether it is
Online, Offline, Diagnostic, or
Unavailable.
Assignment
If the drive is Allocated for a request or
Free with no request pending.
Usage Count
Mount State
Number of times the drive is accessed.
Whether a medium is mounted or not
mounted in the drive when the query was
executed. Valid values are Mounted or
Unmounted.
Mounted Media ID
Shows which medium is mounted in the
drive.
4-44
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive Pool Query Report
May 26 15:45:52 1999 1
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive Pool: drvpoolsml
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive ID(s): 2
4
6
7
9
11 13 14
•
Drive Pool: drvpooltwr
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive ID(s): 7
11
•
•
Drive Pool: drvpoolstg
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive ID(s): 1
3
9
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive Pool Query Report
May 25 15:03:52 1999
1
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive Pool: drvpoolsml
-------------------------------------------------------------------------------------------------------------------------------------------------
Drive ID: 4
Drive Type:
Magnetic
Shelf2
Off-line
Free
Associated Archive:
Current State:
Assignment:
Usage Count:
1
Mount State:
Unmounted
Mounted Media ID:
Drive ID: 7
Drive Type:
Magnetic
tower1
On-line
Allocated
1
Associated Archive:
Current State:
Assignment:
Usage Count:
Mount State:
Mounted Media ID:
Mounted
MED041
601354 Rev A
Normal Operations
4-45
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Query Mount command queries drives that can be used in
a subsequent mount of a specified medium.
Query Mount
Upon receipt of the query request, VolServ determines which
archive contains the specified medium. If the medium is in an
archive, VolServ determines which drives in that archive (and
only that archive) are suitable (based on the medium’s type) for
mounting the medium.The drives are listed in order of
preference, based (in order of relative importance) upon their
availability, proximity to the medium, and usage time. If the
medium is not in an archive, no drive list is returned.
The report is sent only to the screen showing the status of the
query request. An example of the query mount report is shown
in the screen display below.
Medium [MED024] can be mounted on the following drives:
1
2
Drive [14]
Drive [12]
The Query Media command obtains information about one or
more media and associated parameters used in the VolServ
system.
Query Media
Note
A report for all media may take some time to run if there are
many media controlled within the VolServ system.
A report is generated and can be sent to the screen, a specified
file, or printer as shown in the following screen display, media
query report.
4-46
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
A query media request can query any media in the VolServ
system. The media specified in a single media query request are
not required to be located in the same archive. The default
report produces the following information:
Field
Description
Media ID
The media identifier number for the
medium being shown.
Media Type
The default type of media associated with
the Media Class.
Valid values are AIT, CTIII (DLT), CTIV
(DLT), D2s, D2M, D2L, D3, DTF, DTF-2,
LTO, MO5.25, NCTP, RF5.25, ST-120,
3480, 3490, 3490E, 8590, 9840, 8MM,
4MM, and USERTYPE.
Media Class
Assignment
Location State
The Media Class with which the medium
is associated.
If the medium is Allocated to be mounted
or Free from pending mount requests.
Where the medium is physically located.
Valid values are Archive, Checkout, or
Intransit.
Current Archive
Pending Archive
Action State
The name of the archive if the medium is
physically located in an archive.
The destination archive of an intransit
medium.
The Action associated with the archive
when the archive meets or exceeds the
Low Mark or High Mark parameters. Valid
values are None, Notify, or Migrate.
Import Date
The date and time the medium was
entered into the VolServ system.
601354 Rev A
Normal Operations
4-47
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Last Access
The date and time the medium was last
mounted.
Mount Count
Move Count
The number of times the medium is
mounted in a drive.
The number of times the media is moved
in and out of its bin location.
Manufacturer
Batch
The media manufacturer’s name.
The lot or reference number associated
with a group of media from a supplier.
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Query Report
May 14 10:34:30 1999
1
------------------------------------------------------------------------------------------------------------------------------------------------
Media ID: MED001
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type:
SRTYPE
Media Class:
Assignment:
edclassstgusr
Free
Location State:
Current Archive:
Pending Archive:
Action State:
Import Date:
Last Access:
Mount Count:
Move Count:
Archive
stage1
None
May 13 12:06:15 1993
May 13 13:12:09 1993
1
2
Manufacturer:
Batch:
4-48
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Media ID: MED015
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type:
D2M
Media Class:
Assignment:
medclassmed
Free
Location State:
Current Archive:
Pending Archive:
Action State:
Import Date:
Last Access:
Mount Count:
Move Count:
Intransit
shelf1
Move
May 13 16:25:39 1993
May 13 16:40:53 1993
0
0
Manufacturer:
Batch:
MediaMaker ABC
1001
The Query Media Location command obtains information
about a specified medium or multiple media used in the
VolServ system. A report is generated and can be sent to the
screen, a specified file, or printer. This query is only available
though the GUI.
Query Media
Location
The report shows the medium’s location state, current archive,
and bin location. If an AML/E archive is shown, an additional
field Location Type, is added to the report as shown in the
default report produces the following information:
Field
Description
Media ID
The medium’s identifier number.
Location State
Current Archive
Where the medium is physically located.
Valid values are Archive, Checkout, or
Intransit.
The name of the archive if the medium is
physically located in an archive.
601354 Rev A
Normal Operations
4-49
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Location Query Report May 25 15:03:52 1999 1
-------------------------------------------------------------------------------------------------------------------------------------------------
Media ID: 0000082
-------------------------------------------------------------------------------------------------------------------------------------------------
Location State:
Current Archive:
Bin Location:
²
Intransit
0,0,0,0
Media ID: 0000083
-------------------------------------------------------------------------------------------------------------------------------------------------
Location State:
Current Archive:
Bin Location:
Archive
DataStage
0,3,1,0
Media ID: 0000086
-------------------------------------------------------------------------------------------------------------------------------------------------
Location State:
Current Archive:
Location Type:
Bin Location:
Archive
AMLE
Storage Unit
T501010101
The Query Intransit Media command obtains information
about media in the Intransitstate.
Query Intransit
Media
A medium is considered to be Intransitif it meets any of
the following conditions:
•
The medium is waiting to be entered into an archive
because of an Import, Mount, Move, Check-out, or
migration activity processing.
•
It was removed using a Manual Eject command or the
Enter operations failed by the AO.
601354 Rev A
Normal Operations
4-51
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The report is sent only to the screen showing the status of the
query request. An example of the query intransit media report is
-------------------------------------------------------------------------------------------------------------------------------------------------
Intransit Query Report
May 14 09:45:57 1999
-------------------------------------------------------------------------------------------------------------------------------------------------
Media ID(s):MED007 MED025 MED040
The Query Media Class command obtains information about a
specified Media Class or all Media Classes used in the VolServ
system. A report is generated and can be sent to the screen, a
specified file, or printer as shown in the media class query
screen display. The report may vary if a Media Class name is
specified or not specified.
Query Media
Class
•
If a Media Class name is specified, the following reports are
available:
-
-
-
A report showing the Media Class name and
associated parameters.
A report showing the Media Class name and a list of
media associated with the Media Class.
A report showing the Media Class name and a detailed
listing of all media associated with the Media Class.
•
If no Media Classes specified, the following reports are
available:
-
A report showing all Media Class names and
associated parameters.
-
A report showing all Media Class names and a listing
of all media associated with each Media Class.
4-52
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
A report showing all Media Class names and a detailed
listing of all media associated with each Media Class.
Note
A report showing Media Classes with a detailed listing of all media
may take some time to run if there are many media controlled
within the VolServ system.
The default report produces the following information:
Field
Description
Media Class
Media Type
The Media Class name.
The default type of media associated with
the Media Class.
Valid values are AIT, CTIII (DLT), CTIV
(DLT), D2s, D2M, D2L, D3, DTF, DTF-2,
LTO, MO5.25, NCTP, RF5.25, ST-120,
3480, 3490, 3490E, 8590, 9840, 8MM,
4MM, and USERTYPE.
Capacity
The maximum number of media defined
for the Media Class.
Current Fill Level
High Mark %
How many Media Class media currently
exist.
A defined Media Class value when met or
exceeded results in a priority level 1
message being sent to the Volume
Server SysLog Console.
Mountable by Class
Notify Comment
A mount option allowing the Media Class
to be mounted by Media Class. Valid
values are Yes or No.
Media Class specific message to be sent
if Media Class High Mark % is met or
exceeded.
601354 Rev A
Normal Operations
4-53
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
RPC Option
The RPC option used by the Media Class
for status. Depending on the option,
additional fields are displayed.
No Callback
When the enterprise callback option is
enabled, media class callbacks are not
returned. Additional fields: None
Enterprise Callback
When the enterprise callback option is
enabled, the destination of media class
callbacks is directed to an Internet
address associated with an enterprise
identifier. Additional fields: Enterprise ID.
Standard Callback
When the standard callback option is
enabled, the destination of media class
callbacks are directed to a specific RPC
address. Additional fields: HostName,
Program Number, Version Number,
Procedure Number, and Protocol.
Media ID
The media identifier number for the
medium being shown.
Media Type
Media Class
The type of media.
The Media Class with which the medium
is associated.
Assignment
If the medium is Allocated to be mounted
or Free from pending mount requests.
Location State
Where the medium is physically located.
Valid values are Archive, Checkout, or
Intransit.
Current Archive
The name of the archive if the medium is
physically located in an archive.
4-54
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Pending Archive
The archive to where the medium is
migrated if migrate was selected under
the Action option of the archive
configuration.
Action State
The Action associated with the archive
when the archive meets or exceeds the
Low Mark or High Mark parameters. Valid
values are None, Notify, or Migrate.
Import Date
Last Access
Mount Count
Move Count
The date and time the medium was
entered into the VolServ system.
The date and time the medium was
mounted.
The number of times the medium is
mounted in a drive.
The number of times the media is moved
in and out of its bin location.
Manufacturer
Batch
The media manufacture name.
The lot or reference number associated
with a group of media from a supplier.
601354 Rev A
Normal Operations
4-55
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Class Query Report
May 14 10:09:11 1999
1
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Class: medclassstgusr
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type:
USRTYPE
Capacity:
20
Current Fill Level:
High Mark %:
2
80%
Mountable by Class:
Notify Comment:
RPC Option:
Yes
Media exceed high mark
No Callback
Media Class: medclasssh2med
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type:
D2M
Capacity:
20
Current Fill Level:
High Mark %:
3
80%
Mountable by Class:
Notify Comment:
RPC Option:
Yes
Media exceed high mark
Enterprise Callback
3
Enterprise ID:
Media Class: medclasssh2sml
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type:
D2S
Capacity:
20
Current Fill Level:
High Mark %:
2
80%
Mountable by Class:
Notify Comment:
RPC Option:
Yes
Media exceed high mark
Standard Callback
HostName:
copper
Program Number:
Version Number:
Procedure Number:
Protocol:
1
1
1
TCP
4-56
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Query Media Type command is used to obtain
Query Media
Type
information about one or more media types used in the VolServ
system. A report is generated and can be sent to the screen, a
specified file, or printer as shown in the screen display below.
The default report produces the following information:
Field
Description
MediaType
The default type of media associated with
the Media Class.
Valid values are AIT, CTIII (DLT), CTIV
(DLT), D2s, D2M, D2L, D3, DTF, DTF-2,
LTO, MO5.25, NCTP, RF5.25, ST-120,
3480, 3490, 3490E, 8590, 9840, 8MM,
4MM, and USERTYPE.
Capacity
The amount of memory in megabytes in
the medium.
Number of Sides
The number of writable surfaces on the
media.
-------------------------------------------------------------------------------------------------------------------------------------------------
Media Type Query Report
May 24 12:43:18 1999
-------------------------------------------------------------------------------------------------------------------------------------------------
MediaType:
D2S
-------------------------------------------------------------------------------------------------------------------------------------------------
Capacity:
Number of Sides:
25000.00 megabytes
1
•
•
•
MediaType:
3480
-------------------------------------------------------------------------------------------------------------------------------------------------
Capacity:
Number of Sides:
200.00 megabytes
1
601354 Rev A
Normal Operations
4-57
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Query Request command is used to obtain information
about a specific request. The request identifier assigned by
VolServ software must be used.
Query Request
Upon receipt of a request query request, VolServ searches its
request queue for the specified request identifier. If the
specified request is not found, status is returned to the requestor
indicating a non-existent request. If the request is found, the
attribute values associated with the request are returned to the
After a request completes, the request shows a state of complete
for a short time. Afterwards, all knowledge of the request is
removed from the VolServ system and any subsequent queries
for the command fails.
The report can be sent to the screen, a specified file, or printer.
The default report produces the following information:
Field
Description
Request ID
The request identifier associated with the
report. The format of the request identifier
is DDD:nnnn
• DDD = Numeric, three digit day (range:
001-365)
• nnnn = Numeric, computer generated
four-digit number
Request Type
Priority
The type of action the request executes.
The execution priority level of the
command. Valid values are 0 to 35.
Time
The date, time, and year the request
query was submitted for the specified
request.
4-58
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Field
Description
Current State
The present state of the request at the
time of the query.
Valid values are: Executing, Waiting, and
Complete.
-------------------------------------------------------------------------------------------------------------------------------------------------
Request Query Report May 24 12:43:18 1999
1
-------------------------------------------------------------------------------------------------------------------------------------------------
Request ID: 93:144:02136
-------------------------------------------------------------------------------------------------------------------------------------------------
Request Type:
Priority:
Move
15
Time:
Current State:
May 24 12:41:54 1999
Executing
The Query Connect command provides a list of all client
internet addresses currently associated with a specified
enterprise identifier. A report is generated and can be sent to the
screen, a specified file, or printer as shown in following screen
display.
Query Connect
The Query Connect command can be executed from either the
CLI or GUI and from the client API. However, only the GUI
allows for all enterprise identifiers to be queried for. From the
client interface, only one enterprise identifier can be specified
within a single command. This restriction prevents any single
client from listing the clients of other enterprises being serviced
by VolServ.
601354 Rev A
Normal Operations
4-59
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The default report produces the following information:
Field
Description
Enterprise ID
The enterprise identifier number
associated with the report.
Client #
The associated Client’s number.
The socket domain.
Socket Family
Socket Port
Internet Address
A 16-bit port number.
A 32-bit network identifier with host
identifier.
Program Number
Version Number
Procedure Number
Number associated to application.
Version of application number.
Internal handling of system calls.
-------------------------------------------------------------------------------------------------------------------------------------------------
Connect Query Report May 24 12:43:18 1999
1
-------------------------------------------------------------------------------------------------------------------------------------------------
Enterprise ID: 3
-------------------------------------------------------------------------------------------------------------------------------------------------
Client #: 1
Socket Family:
Socket Port:
10
1
Internet Address:
Program Number:
Version Number:
Procedure Number:
300
3300016
2
11
4-60
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Three commands are exclusively available via the API. These
are the Connect, Disconnect, and Multimount Media
associate commands.
CIient
Operations
When a client issues a Connect command, the sending host
becomes a member of an Enterprise. An Enterprise is a group of
clients that communicate with the VolServ host computer.
Connect
When a client establishes an Enterprise connection, a unique
address is associated with it. This address is associated with a
parameter called the Enterprise ID. The Enterprise ID may then
be used as a target location for all media class callbacks. Refer
to the VSCMD_Connectcommand in the MSTM-V21-010 API
Information” on page 3-23 for more information.
The Disconnect command destroys a specific Enterprise that
was established with the Connect command. For more detailed
information about this command, refer to the
Disconnect
VSCMD_Disconnect command in the MSTM-V21-010 API
Programmer’s Guide.
Clients use the Multimount Media command to mount one
medium or more at one time. This frees the client from the
requirement of finding available drives, locking the drives,
finding applicable media, mounting the media on the locked
drives, and unlocking those drives.
Multimount
Media
All functionality of the mount command is retained in this
601354 Rev A
Normal Operations
4-61
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
The Multimount Media command fails for the same reasons
that any single Mount Media command fails. In addition, a
Multimount Media command fails for any of the following
conditions:
•
If the number of mount requests exceeds the number of
on-line drives.
•
•
•
If improper syntax is detected.
If deadlock is detected.
If another multimount command is presently executing.
For more detailed information about this command, refer to the
VSCMD_MultiMount command in the API Guide.
4-62
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
601354 Rev A
Normal Operations
4-63
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
4-64
Normal Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Roadmap
Refer To
Chapter
Topic
General software installation information
Hardware and software start-up
Site-specific configuration of archives and drives
Daily operation.
1
2
3
4
5
6
Archive operation and configuration
Troubleshooting tips and solutions
5-2
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This chapter describes the operations performed by the VolServ
Archive Operator (AO) during normal operations. An archive
Console prompts most AO operations. Each configured archive
displays an archive Console. The display location of each is
determined when an archive is configured.
Automated
Archive
Operations
The set of archive Console operations depend on whether the
configured archive is automated or manual. An automated
archive Console contains three operation options: ENTER,
EJECT, and AUDIT. Both manual archive consoles contain
these three plus the MOUNT and DISMOUNT options (and
OTHER for the Shelf archive)
All operations are initiated through the archive Console. Each
automated archive Console has three operation options. See the
following screen display.
601354 Rev A
Archive Operations
5-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Many situations require the AO to perform media handling
operations. Most media handling is required because of
VolServ command execution, such as Import, Export,
Check-in, Check-out, Move, or Mount Media commands.
Media movement triggered by the media migration policy also
requires that an AO perform media handling. Refer to “Define
Media Migration Policy” on page 4-10. With some exceptions,
the audit operation does not require media handling.
An AO is alerted that a medium or media must be entered into
an archive when the ENTER button on the archive Console is
highlighted. When the AO selects the highlighted option, an
Enter window is displayed. Selecting the View/Fail button from
this window displays the Enter list. The media on this list
identifies each medium to be entered into the archive. Media are
identified by media identifier, reason for the enter, previous
archive location (if applicable), and priority.
Enter Media
The AO then locates the media in the Enter list, places them in
the automated archive load port, and completes the command.
Refer to Using the VolServ GUI for specific procedures.
It is best to think of the ENTER button on an archive Console
as an indicator that media are on the Enter list. Five reasons
exist that place media on the list: import, checkin, move, mount,
and migrate.
Media are placed on the Enter list as a direct result of the
Import and Check-in Media commands. As soon as an Import
and Check-in Media commands are executed, the identified
media are placed on the Enter list and the ENTER button
becomes highlighted.
5-4
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Media are placed on the Enter list as an indirect result of Move
and Mount Media commands and media migration movement.
Before a medium is contained in an archive Enter list for the
reasons of move, mount, or migrate, it must first be ejected
from another archive. The ENTER button on the destination
archive Console is highlighted only after these media are
ejected from the source archive.
The previous archive location listed for each medium on the
Enter list is not applicable to imported media. Such media are
unknown to VolServ software.
The Enter list priority entry for each medium indicates a
command priority that is specified by the client. This entry is
not applicable to media that are migrated.
Media on the Enter list can be removed by the AO. Selecting
the View/Fail button of the Enter window allows the AO to
remove some or all media on the Enter list.
To enter media without direction from VolServ software, the
AO selects the ENTER button. The Enter window is then
displayed. The AO inputs the Enter Port ID and Media Type
into the Enter window. Media must be placed in the load port.
The exact method of placing media in this port varies according
to the type of archive being accessed. Refer to the Using the
VolServ GUI book for the appropriate procedures.
When the Enter window ENTER button is selected, the
archive robot reads the labels of the media in the load port and
reports them to VolServ software. If a medium is unknown to
VolServ software, it is imported into the target Media Class
specified when the automatic import option is selected. If a
medium is checked out, the medium is checked in to its default
media class if the automatic checkin option is selected.
601354 Rev A
Archive Operations
5-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All media that are entered or checked in are moved to bins
inside the archive. When either auto check-in or auto import
options are not selected, intransit or checked -out media is left
in the port and/or identified on the Eject list.
An AO is alerted that a medium or media must be removed
from an archive when the EJECT button on the archive
Console is highlighted. When the AO selects the highlighted
option, a list of media is displayed. This Eject list identifies
each medium to be removed from the archive. Media are
identified by media identifier, reason for the eject, destination
archive (if applicable), priority, and comment (if supplied by
client).
Eject Media
The AO selects eject candidates from the Eject list, selects the
eject port identifier, and then executes the command. Then the
AO removes the media from the automated archive unload port
and completes the command. Refer to the Using the VolServ
GUI book for specific procedures.
The EJECT button on an archive Console is considered an
indicator of media on the Eject list. Media are placed on the
Eject list as a direct result of the Export, Check-out, Move, and
Mount Media commands or because of media migration
movement. As soon as media are placed on the Eject list, the
EJECT button highlights.
The destination archive listed for each medium on the Eject list
is not applicable to exported or checked-out media. After media
are ejected, exported media become unknown to VolServ
software. Checked-out media are placed in a checkout state.
The Eject list priority entry for each medium indicates a
command priority that is specified by the client. This entry is
not applicable to media that are migrated.
5-6
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
A comment field lists an optional comment for each medium.
The client defines these comments when the Export or
Check-out Media commands are executed. This field is not
applicable for Move or Mount Media commands.
Media on the Eject list can be removed by the AO. When the
highlighted EJECT button is selected, an Eject window is
displayed. Some or all of the media listed in the Eject window
can be selected. Selecting the Fail button removes the media on
the Eject list.
Commands can also be removed from the Eject list by the
VolServ System Administrator (SA) or VolServ System
Select the AUDIT button when a suspected discrepancy occurs
between the actual inventory of media in an archive and the
inventory contained in the VolServ database.
Audit
Two types of audit operations for automated archives include: a
Standard Audit and a Remap Audit. All automated archives
have a Standard Audit capability. The Remap Audit capability
is supported only by archives with their own internal databases
(DataTower, StorageTek ACS product family, and AML
archives).
When either type of audit completes, VolServ displays the audit
report on the archive Console. If errors are reported during the
audit, the SA or SO performs necessary cleanup actions and
performs a second audit. Refer to “Auto Check-in During
detailed information about audit.
601354 Rev A
Archive Operations
5-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Standard Audit
During a Standard Audit, VolServ commands the robot to look
into each specified bin and to read the external label on any
medium present. Thus, the actual content of each bin is
compared against the VolServ database. Depending on the
number of bins to audit, a Standard Audit can take a long time
to complete.
There are archive-dependent differences that exist in the way a
Standard Audit is performed.
The DataTower archive provides the most autonomous Standard
Audit capability of all supported archives. When a Standard
Audit command is sent, the archive commands a robot to scan
each bin for media, builds a list of media found, and performs a
set of synchronizing operations to update its own database.
Note
When audited, the entire DataTower archive is scanned.
The archives send the list of media found with the results of
their own database synchronization actions to the VolServ host
computer. For the DataTower archive, a list of mounted media is
also appended to the list of media found. VolServ software then
performs its own set of synchronizing operations.
VolServ software performs two operations whenever a
StorageTek ACS product family Standard Audit is requested.
The archives send the cumulative discrepancy report that is used
by VolServ software to update its database. VolServ then sends
a request for a total inventory list (for example, a remap
operation). This information is used to update the VolServ
database, if necessary. That is, a Standard Audit command
results in a discrepancy report and a map list for use by VolServ
software.
5-8
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
When an AML archive Standard Audit is performed, the
archives require that no media be mounted before executing an
audit. If any media are mounted, the audit fails. If a mount
request is issued while an audit is in progress, the mount will
fail.
Under normal conditions, VolServ software begins the audit by
directing the archive to perform a physical audit and report the
results. A mounted medium is not scanned by any automated
archive robot, but the AML AMU does not report the medium
present in the drive. Therefore, VolServ logic assumes the
medium is not present in the archive and logically ejects it from
the VolServ database. However, the medium is still present in
the AML archive and database.
To prevent an audit from occurring when media are mounted,
VolServ uses information from the AML AMU. The AML
database shows mounted media in two tables: one for being in
the archive, another for being mounted. VolServ first retrieves
the mount table information. If any media are in the table, the
audit fails.
Remap Audit
During a Remap Audit, automated archives with their own
internal databases report the contents of their databases. These
archives include the DataTower, StorageTek ACS product
family, and AML archives.
VolServ database is updated to reflect the reported information.
No robotic movement is required when performing a Remap
Audit. This process takes considerably less time to perform than
a Standard Audit. It should be performed when the VolServ
database is suspect but the archive database is intact.
601354 Rev A
Archive Operations
5-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This subject is covered in detail in “Unsolicited Enter of
Unsolicited
Enter Operation
5-10
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
All operations are initiated through the archive console, see the
following two screen displays. The Stage console has five
operation options. The DataShelf console has six operation
options.
Manual
Archive
Operations
The Manual Archive Enter operation is analogous to the
Automatic Archive Enter operation with one exception. The
VolServ AO does not enter media into a load port for either
manual archive type.
Enter Media
601354 Rev A
Archive Operations
5-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
For a DataShelf archive, the AO places each medium into a
specific bin. The Stage archive is unstructured and requires that
the AO locate the media to be entered and acknowledge the
command.
The Manual Archive Eject operation is analogous to the
Automatic Archive Eject operation with one exception. The AO
does not remove media from an unload port for either manual
archive type.
Eject Media
For a DataShelf archive, the AO removes each medium from a
specific bin. The Stage archive is unstructured and requires that
the AO locate the media to be ejected and acknowledge the
command.
All manual archive media mounts are performed by the AO.
Refer to the Using the VolServ GUI book for a detailed
procedure.
Mount Media
Dismount Media
Audit
All manual archive media dismounts are performed by the AO.
Refer to the Using the VolServ GUI book for a detailed
procedure.
As with an automated archive, the AUDIT button is selected
whenever a suspected discrepancy occurs between the actual
inventory of media and the inventory contained in the VolServ
database.
Unlike the automated archive, VolServ software generates an
inventory list of media contained in its database for that archive.
The AO then visually verifies the audit list. Any discrepancies
found must be resolved by the AO.
5-12
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
DataShelf only: It presently contains only one command. This
is the reprint shelf label command.
Reprint Label
This command prints human-readable shelf labels one at a time
on the Seiko Smart Label Pro printer.
601354 Rev A
Archive Operations
5-13
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
5-14
Archive Operations
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Roadmap
Refer To
Chapter
Topic
General software installation information
Hardware and software start-up
Site-specific configuration of archives and drives
Daily operations
1
2
3
4
5
6
Archive operation and configuration
Troubleshooting tips and solutions
6-2
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
This chapter contains troubleshooting tips for problems that
VolServ users have actually experienced. However, before
reviewing this chapter for a solution to a problem, take a
moment to read about some time-saving VolServ resources that
are available.
Troubleshoot
Resources
These resources are:
•
The VolServ logs—usually located in the $VS_DIR/logs
directory, provide many solutions to software problems.
These logs are easy to access and are usually configured to
be readable by the VolServ System Administrator (SA) and
VolServ System Operator (SO). Consult these logs if the
nature or the source of the problem is unclear.
•
The VolServ documentation—is useful when difficulties
occur. For example, each ADIC software product is capable
of generating user messages. The VolServ Error Messages
book provides the added information on the meaning of the
message and what action, if any, is required. The
Administrative Tasks book also contains helpful
information about the ADIC product family, administration,
and operations of the VolServ product.
If these resources cannot help identify and resolve the problem,
contact the ADIC technical assistance center (ATAC). ATAC
provides technical assistance and maintenance for all ADIC
hardware and software products.
Tip
When contacting ADIC technical support, the site license string
may be requested. Please be sure to have it available.
ATAC support is available 24 hours a day, 7 days a week at the
following numbers:
601354 Rev A
Troubleshoot
6-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
•
•
In the USA and Canada, call 1-800-827-3822.
Outside the USA and Canada, call 303-874-0188 or toll-free
00800-9999-3822.
•
Send e-mail to: [email protected].
6-4
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
User
Environment
Problem
Solution
Does a display feature
exist that alerts the user
each time a status or a
message is received?
On all consoles, an Options button is
located in the upper left corner. If
selected, a pull-down menu displays with
Status Beeps. If Status Beeps is
selected, a beep is heard each time status
or a message is received.
Display Features
Label Patterns
How should the NEXTID
for label patterns be
redefined so some media $VS _DIR/utilities/updatepattern.
numbers can be skipped? Note, however, it is important to enter a
NEXTID that matches the defined pattern.
To redefine the NEXTID of the label
patterns for the skip feature, run
How can sweep (i.e.,
A feature on all of the archive Consoles is
highlighting items from list a Sweep Select List toggle under the
boxes by sweeping across Options button in the upper left corner.
the items) of multiple items When activated, all of the lists in the
in an archive Console list archive Console allow sweep selection
List Selections
be done?
instead of the usual one-at-a-time
selection. Toggle this feature again to
return to the one-at-a-time selection mode
601354 Rev A
Troubleshoot
6-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
How can VolServ log files VolServ automatically backs up log files.
be backed up on a regular The time between backups can be set by
basis?
changing the LOG_BACKUP_TIME
environment variable in the
$VS DIR/config/envvar.configfile.
This variable is the amount of time in
hours between backup attempts. Thus, if
VolServ is to back up the logs every day,
the variable is set to 24.
The number of days of logs can be
controlled by modifying the NUM_LOG_DAYS
environment variable in the
$VS_DIR/config/envarr.config file.
This variable tells VolServ how many days
of logs to track. Any logs older than the
number of days are deleted
How can the size of the
VolServ log files be
controlled so they do not
get too big?
VolServ’s automatic backup ensures the
manageability of the log files by
truncating the old ones. However, the size
of the new logs can be controlled by
modifying the VSCLEAN_LOG_SIZE
environment variable in the
Log Files
$VS_DIR/config/envarr.configfile.
This variable tells VolServ how large a log
file can become before it is backed up.
Can the VolServ log files
Caution: Never move or delete log files
be backed up at any time? using UNIX commands while VolServ
software is running.
Yes. Run the movelogsutility. Enter
$VS_DIR/utilities/movelogs. This
performs the same process as the
automated backup. When running the
utility, choose the option that ignores the
size of the logfiles and specifies logfile
backup and old logfile truncation.
6-6
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
The status window
displays all of the
If the right mouse button is pressed with
the cursor in the status window, a menu of
messages when scrolling options displays. Select the Auto Scroll
is performed. When
attempting to scroll up to
read them, as more
messages come in, the
scroll reverts to the
bottom.
toggle button. When the toggle is off, the
status window does not scroll
automatically. When the toggle is on, this
window always scrolls to the bottom when
it receives status.
Status Window
Scrolling
The status window
displays all of the
If the right mouse button is pressed with
the cursor in the status window, a menu of
messages when scrolling options displays. Select the Auto Scroll
is performed. When
attempting to scroll up to
read them, as more
messages come in, the
scroll reverts to the
bottom.
toggle button. When the toggle is off, the
status window does not scroll
automatically. When the toggle is on, this
window always scrolls to the bottom when
it receives status.
How can the width of the
Volume Server SysLog
Console be changed to
ensure that it stays the
same each time VolServ
software starts?
To ensure a consistent console width,
perform the following procedure:
Step 1: Change to the $VS_ DIR/gui
directory.
Volume Server
SysLog Consoles
Step 2: Edit the Sys_ consolefile.
Step 3: Search for the line that starts with
sys_console.\
consoleForm.width.
Step 4: Change the integer value in the
line to the appropriate width.
Step 5: Save the file, then exit.
Step 6: Run volserv -dto redisplay the
Volume Server SysLog Console with
the configuration changes.
601354 Rev A
Troubleshoot
6-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
How can the height of a
Volume Server SysLog
Console be changed to
ensure that it stays the
same each time VolServ
software starts?
To ensure a consistent Sys-Log height,
perform the following procedure:
Step 1: Change to the $VS _DIR/gui
directory.
Step 2: Edit the Sys_ consolefile.
Step 3: Search for the line that starts with
sys_console.\
consoleForm.height.
Volume Server
SysLog Consoles
(continued)
Step 4: Change the integer value in the
line to the appropriate height.
Step 5: Save the file, then exit.
Step 6: Run volserv -dto redisplay the
Volume Server SysLog Console with
the configuration changes.
6-8
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Initialization/
Configuration
Note
The cleanconfigutility can be run for an archive
configure/reconfigure process that has terminated abnormally.
Problem
Solution
During reconfiguration,
configuration in progress
flags are received even
though none is actually
configuring. How can
these flags be cleared?
To clear the Configuration in Progress
flags, run the cleanconfig script in the
$VS DIR/utilitiesdirectory. When the
message Are you sure you want to do
this? is displayed, enter y. All of the
Configuration in Progress flags are
cleared.
Clear
Configuration in
Progress Flags
Why is the vswin software The vswin software does not initialize if
not always able to initialize executed without running the xhost
on a remote terminal?
command. This command enables the
remote computer to act as host for the
local workstation.
To initialize the vswin software, perform
the following procedure:
Step 1: Change to the $VS DIR/logs
directory. Check the vslogfilefile for
clues.
Initialize vswin
Software
Step 2: Enable access to the remote host.
Login to the local workstation. Issue the
xhost remote_host_name command.
Step 3: Set the environment DISPLAY
variable to ensure that the vswin software
appears to initialize when executed on a
remote host. Login to the remote host
computer. Issue the setenv DISPLAY
local_workstation_name:0 command.
601354 Rev A
Troubleshoot
6-9
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
Step 4: Verify ownership and protection
owned by root. Check the binary file to
ensure that the vswin software initializes
when executed on an IBM. Ensure that
vswin in the $VS_DIR/bindirectory has
set the correct ownership and protection.
The ownership should be root and the
protection should be 755.
(continued)
Why does VolServ
VolServ must be cycled to recognize the
software display an invalid newly-configured archive.
archive error message
Invalid Archive
Error Message
when a user tries to assign
a media class (using the
Create Archive Media
Class) to a successfully
configured archive.
What should be done if
If VolServ cannot connect to the archive,
VolServ cannot connect to issue a ping for the host name of that
Software
Connection
the archive?
archive. If the ping is unable to
communicate, a network problem exists
that needs correction.
What should be done if
VolServ does not
initialize?
If VolServ does not initialize, perform the
following procedure:
Step 1: Verify that the login is correct.
Step 2: Ensure the VolServ license string
is correct.
Step 3: Ensure access to the database.
Software
Initialization
Step 4: Verify the system environment
variables.
Step 5: Verify the path.
Step 6: Verify the vslogfile file ownership
and protection.
Step 7: Verify that no subprocesses are
active.
6-10
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
Step 8: Verify the availability of all
executables.
Step 9: Enable access to the remote host.
(continued)
Step 10: Verify ownership and protection.
Note that the vswin software may not
initialize when executed on an IBM if the
binary file is not owned by root.
What is the graceful way
to shutdown a
workstation?
Perform the following procedure. This
procedure assumes that the user is
logged in as vsadm, and VolServ and
vswinare running.
Step 1: From a vsadmshell window,
gracefully shutdown VolServ by entering:
volserv -t.
When VolServ completes its termination
procedures, a VolServ shut down
completed message is displayed and the
vsadm prompt reappears. The Volume
Server SysLog Console window and
archives Console windows disappear
during VolServ termination procedures
Workstation
Shutdown
Step 2: On the Volume Server System
console, select the Options window in the
upper left and select Exit from the
pull-down menu.
Step 3: Verify that it is OK to quit.
Step 4: The VolServ host can now be
gracefully shut down.
601354 Rev A
Troubleshoot
6-11
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
Why doe VolServ not keep Newly created archives remain unknown
a record of newly created to VolServ until the software is cycled after
archives?
the archive is created. If, after creating an
archive, further operations involving the
archive result in error messages (for
example, This archive does not exist.),
cycle VolServ by issuing the volserv -t
command then the volserv command.
After cycling the software, continue
operating as usual.
Newly Created
Archives
What should be done if a
core file exists in the
$VS_DIR/bindirectory
A core file usually exists when a VolServ
software process terminates for an
unknown reason. This termination
indicates that a problem exists in VolServ.
Report the problem to ATAC. To assist
ATAC in solving the problem, perform the
following procedure:
Step 1: Save the core file.
Step 2: Record the time of process
termination.
Unnecessary Core
File
Step 31: Save all of the logs for the time
period in which the problem occurred.
Step 4: If possible, record the steps
followed to produce the core.
Step 5: Identify which VolServ software
process terminated by reviewing the logs.
Step 6: If the information is unavailable in
the logs, issue the following command in
the directory containing the core: adb -
core.Save any information shown.
Step 7: Run $qto exit out of the adb.
6-12
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Archive
Specific
Issues
Problem
Solution
What steps should be
taken when auditing an
entire DataTower archive
and discovering that a
duplicate media identifier
(ID) exists, but the status
and the Media Location
query only list one
To bring the duplicate into the tower
database and to provide a location,
remove the medium from the location
indicated in the status window and the
Media Location query. Then repeat the
audit on the tower archive. This action
brings the duplicate into the tower
database and provides a location.
Audit a DataTower
Archive
location?
A Mount Media command Mount Media commands are suspended
was issued, but a
until executed if a hardware failure occurs.
The second request fails and causes the
Cassette Load Mechanism (CLM) to be
varied OffLine and the drive is unavailable
for other mounts. Use the Manual Eject
hardware error occurred.
After the problem was
corrected, the command
was reissued and failed,
Mount Media
Command
but the medium was found command to remove the medium,
in the drive.
physically remove the medium, and vary
the CLM to the OnLine state. Reenter the
medium using the Unsolicited Enter
operation.
Why does Release 2.0 not It does. However, as media are entered
Support of Priority
and Optional CAP
Audit of
StorageTek ACS
Product Family
Archives
support the priority and
optional CAPs of a
StorageTek ACS product
family archive?
into the StorageTek ACS product family
archive with either of these CAPs, the
media is not recognized as entered until a
remap audit is performed.
601354 Rev A
Troubleshoot
6-13
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
Erratic behavior occurs in The ACS workstation, which is part of all
the archive, but the
VolServ logs do not
indicate any problems.
StorageTek archive systems, receives
unsolicited status directly from its
associated StorageTek ACS product
family archives. Check the logs at the
ACS workstation for any component
status changes. Refer to the StorageTek
equipment books.
Erratic Behavior
An audit operation is
interrupted because of
loss of power or triggering volserv -tcommand, then the volserv
The audit operation l fails until VolServ is
cycled. Cycle VolServ by issuing the
Audit Disaster
Recovery
safety interlocks.
command. After recycling the software,
execute the Audit command again.
6-14
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
For any database questions or general concerns please contact
ADIC technical support.
General
Database
Issues
Problem
Solution
What is dbtest?
The executable dbtestis a utility program
that is delivered with VolServ. It gives
ATAC personnel easy access to VolServ
database when tracking problems. This
utility should NOT be run unless instructed
to by ATAC personnel.
Utility Programs
601354 Rev A
Troubleshoot
6-15
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Printer Issues
Problem
Solution
How can a label printer be If using a Seiko Label Printer (shelf labels)
added to the
/etc/printcapfile?
attached to the VolServ host, the following
example entry in the /etc/printcapfile
can be tried. The lp and sd entries may
have to be modified:
#
shelflabel:\
:lp=/dev/ttya:sd=/var/spool/
lpd:\
:br#9600:ms=litout,-cstopb,-
icrnl:
#
If using an Intermec Label Printer
(barcode labels) attached to the VolServ
host, the following example entry in the
/etc/printcapfile can be tried. The lp
and sd entries may have to be modified:
Add a Label Printer
to the
/etc/printcapFile
#
barcodelabel:\
:lp=/dev/ttyb:sd=/var/spool/
lpd:\
:br#9600:ms=evenp:
#
How can additional
If using a label printer, modify the
$VS_
printers be added to the
GUI pop-up window? This
pop-up window appears
when the right mouse
button is pressed while the
prompt cursor is in the
printer text line.
DIR/config/label_printers.config
file and add the appropriate printer name.
If using other printers, modify the
$VS_ DIR/config/printers.config file
and add the appropriate printer name.
Cycle vswinto make all changes
effective.
Enable Printers to
Pop Up
6-16
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
Problem
Solution
What modifications must
be made to add console
names to the GUI pop-up
window? This pop-up
window appears when the
right mouse button is
pressed while the prompt
cursor is in the New
Console Display Host
text line of the Change
Archive Parameters
window.
Modify the
$VS_DIR/config/console_locations.c
onfig file and add the appropriate
console names. Cycle vswinto make all
changes effective.
Enable Console
Names to Pop Up
How can a request that
To remove the request from the system,
keeps trying to send status turn off the infinite retry mechanism by
to a terminated client be
removed? CiReplyis set
to infinite retries.
performing the following procedure:
Step 1: Modify the
$VS_DIR/config/envvar.configfile and
reset the environmental variable,
CIREPLY_MAX_RETRY, to a small value, for
example, 3.
Step 2: Cycle VolServ.
Remove a Request
When the system restarts, the request
tries to resend its status. After the resend
fails, it is removed from the system when
its retry count exceeds the new value of
CIREPLY_MAX_RETRY.
Step 3: Change the CIREPLY_MAX_RETRY
variable back to signal infinite retries and
recycle VolServ.
601354 Rev A
Troubleshoot
6-17
Download from Www.Somanuals.com. All Manuals Search And Download.
Administrative Tasks
NOTES
6-18
Troubleshoot
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Index
A
Auto import
Access
media class . . . . . . . . . . . . . . . . . 4-41
Automated archive
Archive
unsolicited enter . . . . . . . . . . . . . 5-10
AUDIT
B
Backup
Book
C
Client Operations
disconnect from enterprise . . . . . 4-61
multimount media. . . . . . . . . . . . 4-61
Command
cancel request . . . . . . . . . . . . . . . . 4-5
change archive parameters . . . . . . 4-7
601354 Rev A
INX-1
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
current usage time . . . . . . . . . . . . 4-23
delete drive pool . . . . . . . . . . . . . 4-18
disassociate . . . . . . . . . . . . . . . . . 4-16
modify drive pool . . . . . . . . . . . . 4-17
mount media . . . . . . . . . . . . . . . . 4-18
usage count . . . . . . . . . . . . . . . . . 4-21
usage count . . . . . . . . . . . . . . . . . 3-32
E
Environment Variables
AML_MAX_WAIT_TIME . . . . 1-24
ARCDISP_IPC_RETRIES . . . . . 1-19
ARCDISP_IPC_WAIT_TIME . . 1-20
ARCDISP_SYSLOG_LEVEL . . 1-16
ARCHIVE_CMD_WAIT_TIME 1-23
ARCMAN_CAPACITY_DELTA . .
ARCTYPE_LICENSE_STRING 1-15
CAS_MEDIA_PAD_SIZE . . . . . 1-23
CIREPLY_COMMANDS_TO_RETR
Configuration
Control Access File
D
Drive
CIREPLY_RETRY_INTERVAL1-22
CIREPLY_RPC_RETRY . . . . . . 1-22
CIREPLY_RPC_TIMEOUT. . . . 1-22
CIREPLY_SYSLOG_LEVEL . . 1-16
INX-2
Index
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
CIREQUEST_SYSLOG_LEVEL1-16
CLM_DISMOUNT_RETRIES . 1-23
CLM_DISMOUNT_WAIT_TIME . .
CONSOLE_SYSLOG_LEVEL. 1-16
DELETE_ARCHIVE_MEDIA_ACTI
DELETE_ARCHIVE_WITH_MEDIA
DRIVE_MAX_ERROR_COUNT1-24
ENTERPRISE_ROUND_SCHEDULI
SILO_MAX_WAIT_TIME . . . . 1-24
SYSLOG_DISK_LEVEL. . . . . . 1-16
TCPIP_CONNECT_RETRIES . 1-26
TCPIP_CONNECT_WAIT_TIME . .
TOWER_MAX_WAIT_TIME . 1-23
VOLSERV_QUIT_TIMEOUT . 1-21
VOLSERV_START_TIMEOUT 1-21
VOLSERV_TERM_TIMEOUT. 1-22
VS_DEF_PRIORITY . . . . . . . . . 1-20
VS_GROUP . . . . . . . . . . . . . . . . 1-25
VS_LOG_SIZE . . . . . . . . . . . . . 1-16
VS_MAX_LIST_LENGTH . . . . 1-20
VS_MAX_TEXT_LENGTH . . . 1-20
VSRPT_PAGE_LENGTH . . . . . 1-21
VSWIN_IPC_RETRIES. . . . . . . 1-20
VSWIN_IPC_RETRY_TIME . . 1-20
XAPPLRESDIR . . . . . . . . . . . . . 1-21
LIBMAN_INTERFACE_TIME 1-19
MONITOR_SYSLOG_LEVEL. 1-17
ERR_COMMAND_IN_UNKNOWN
ERR_NOT_ACCEPTING_COMMA
PROCSERV_SYSLOG_LEVEL 1-17
F
PROCSERV_TIMEOUT_VALUE . .
File
QUERYCOMP_SYSLOG_LEVEL .
command.config . . . . . . . . . . . . . . 1-3
console.config. . . . . . . . . . . . . . . . 2-4
601354 Rev A
Index
INX-3
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
L
Label
G
M
Manual Archive
DISMOUNT . . . . . . . . . . . . . . . . 5-12
Media
H
I
clear eject. . . . . . . . . . . . . . . . . . . 4-33
manual eject. . . . . . . . . . . . . . . . . 4-32
action mode . . . . . . . . . . . . . . . . . 3-26
archive percentage. . . . . . . . . . . . 3-24
Initial Configuration
Intransit State
INX-4
Index
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
auto checkin . . . . . . . . . . . . . . . . 4-40
auto import . . . . . . . . . . . . . . . . . 4-40
media class . . . . . . . . . . . . . . . . . 3-27
media type. . . . . . . . . . . . . . . . . . 3-29
O
Operator Commands
Media ID
Media Migration
P
Printcap File . . . . . . . . . . . . . . . . . . . 6-16
Publications
Department . . . . . . . . . . . . . . . . . . P-6
Release Notes . . . . . . . . . . . . . . . . P-6
Q
Query Archive
archive mode. . . . . . . . . . . . . . . . 4-39
601354 Rev A
Index
INX-5
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
mounted media ID. . . . . . . . . . . . 4-44
usage count . . . . . . . . . . . . . . . . . 4-44
Query Connect
Query Drive
action state. . . . . . . . . . . . . . . . . . 4-47
assignment. . . . . . . . . . . . . . . . . . 4-47
current archive. . . . . . . . . . . . . . . 4-47
import date. . . . . . . . . . . . . . . . . . 4-47
last access . . . . . . . . . . . . . . . . . . 4-48
location state . . . . . . . . . . . . . . . . 4-47
manufacturer . . . . . . . . . . . . . . . . 4-48
media type . . . . . . . . . . . . . . . . . . 4-47
mount count. . . . . . . . . . . . . . . . . 4-48
move count . . . . . . . . . . . . . . . . . 4-48
pending archive . . . . . . . . . . . . . . 4-47
media type . . . . . . . . . . . . . . . . . . 4-53
notify comment . . . . . . . . . . . . . . 4-53
RPC option . . . . . . . . . . . . . . . . . 4-54
Query Drive Pool
bin location . . . . . . . . . . . . . . . . . 4-50
current archive. . . . . . . . . . . . . . . 4-49
location state . . . . . . . . . . . . . . . . 4-49
media type . . . . . . . . . . . . . . . . . . 4-57
INX-6
Index
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
Query Request
DataTower archive . . . . . . . . . . . 6-13
display feature. . . . . . . . . . . . . . . . 6-5
in progress flags . . . . . . . . . . . . . . 6-9
label patterns. . . . . . . . . . . . . . . . . 6-5
label printer. . . . . . . . . . . . . . . . . 6-16
lost connection . . . . . . . . . . . . . . 6-10
software initialization . . . . . . . . . 6-10
StorageTeK ACS 440 . . . . . . . . . 6-13
vswin software . . . . . . . . . . . . . . . 6-9
workstation shutdown. . . . . . . . . 6-11
R
Recovery Processing
RPC option
S
Shutdown
Start-up
U
Usage Count
drive statistics . . . . . . . . . . . . . . . 3-32
V
T
VolServ
Terminate VolServ
Troubleshooting tips
graceful shutdown. . . . . . . . . . . . . 2-8
immediate shutdown. . . . . . . . . . . 2-8
volserv Command
601354 Rev A
Index
INX-7
Download from Www.Somanuals.com. All Manuals Search And Download.
Adiministrative Tasks
INX-8
Index
601354 Rev A
Download from Www.Somanuals.com. All Manuals Search And Download.
|
