Version 4.

Ref: VTL40BE-1005

Time Navigator Virtual Li brary Manager

Atempo retains all property rights concerning the documentation of Time Navigator
software.

Your right to copy the Time Navigator software documentation is limited by the
legislation on copyright. Copies or adaptations without Atempo’s prior written consent are
forbidden by law and constitute a reprehensible breach.

This documentation is provided "as is" without any warranty of any kind, either expressed
or implied, including (but not limited to) the implied warranties or conditions of
merchantability or fitness for a particular purpose. Atempo shall not be liable for loss of
profits, decreasing or interrupted business activity, for loss of data or data use, nor for any
indirect, special or consequential damages whatsoever, even if Atempo has been advised
of the possibility of such damages arising out of a fault or an error in the documentation or
in Time Navigator software.

Atempo retains all rights to modify this documentation periodically without notice. No part
of this guide may be reproduced or transmitted, for any purpose, by any means, electronic
or mechanical, without Atempo’s express and written permission.

Atempo, Atempo’s logo and Time Navigator are registered trademarks of Atempo.

All brand or product names mentioned in this guide are trademarks or registered
trademarks of their respective companies or organizations.

Copyright © 1992-2005 Atempo. All rights reserved.

Time Navigator Virtual Library Manager
 Table of Contents i

Table of Contents

Introduction
Supported Operating Systems . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Time Navigator Documentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Time Navigator Release Notes . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .2
Time Navigator Getting Started Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Other Guides . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Time Navigator Online Help . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3
Time Navigator Tutorials . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .3
Technical Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Web Support . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Generating the Environment Report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Your Comments are Welcome . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6

Virtual Library Manager for ACSLS or LibraryStation

Presentation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
Time Navigator Virtual Library Manager Components . . . . . . . . . . . . . . 8
VTL Directory Content . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Installation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Administration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Moving cartridges . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Putting a cartridge online/offline. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .13
Upgrading Time Navigator . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
From Version 3.1 to 4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
From Version 3.5, 3.6 or 3.7 to 4.0 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Using tina_stk in command line . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .16
Troubleshooting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18

Appendix A
$TINA_HOME/VTL Directory Content for Unix . . . . . . . . . . . . . . . . . . . . . . . . . .23
%TINA_HOME%\VTL Directory Content for Windows . . . . . . . . . . . . . . . . . . . . 24
Configuration File Description . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
tina_stk.env File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
tina_stk.conf File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
ii Time Navigator Virtual Library Manager

tina_vtl.env File. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
vtl_config.txt File . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

Appendix B
ACSLS and LibraryStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Principles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .31
Configuration of the ACSLS Server . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
Configuration of a LibraryStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
Pool Management . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
Management of the vtl_info file by tina_stk . . . . . . . . . . . . . . . . . . . . . . . . . .34
ACSLS Quick Reference Guide . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .36

Appendix C
CentricStor . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
Principles . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Time Navigator Configuration . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .43
Restore Performances . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45

Index
 Introduction 1

Introduction

Time Navigator Virtual Library Manager is a set of programs allowing

Time Navigator to interact with various proprietary library driver interfaces.
Time Navigator Virtual Library Manager is used to control libraries lacking a SCSI
command path. With Time Navigator Virtual Library Manager, the communication
between Time Navigator and the library is handled by a series of scripts rather than the
SCSI commands.

Supported Operating Systems

Please consult the Time Navigator Compatibility Guide (Silo Support section) on Atempo’s web
site for up-to-date information about the operating systems supported by Time Navigator
Virtual Library Manager.

The Time Navigator Virtual Library Manager program available is tina_stk for the
93XX and 97XX StorageTek libraries.
The 93XX Libraries are controlled by an ACSLS (Automated Cartridge System Library
Software) administration software or a LibraryStation software.

On Windows, you will have to install StorageTek Library Attach on the platform hosting
Time Navigator Virtual Library Manager.

Conventions
This guide uses conventions to make information easy to access and understand.
■ Text in Time Navigator graphical application windows is displayed in the following
font:
Window text.
■ Time Navigator commands and scripts related to the different operating systems
(Unix, Windows, etc.) are displayed in the following font:
scripts and commands.
2 Time Navigator Virtual Library Manager

■ Cross-references to further information are indicated by the ☞symbol.

■ Procedures indicating the steps to follow to perform an action with Time Navigator
are presented as follows:

➤ Procedure title
1. First step.
2. Next step, etc.
■ Command syntax is presented as follows:
■ Square brackets [ ] indicate an option.
■ The - sign refers to a parameter. The parameter is either followed by the type
of information to provide, or is self-sufficient.
■ The | sign indicates a choice between several parameters.

Time Navigator Documentation

Time Navigator documentation consists of a series of PDF format files located on the
delivery CD-ROM.

The PDF format requires the use of Adobe Acrobat Reader, which can be downloaded from
the Adobe web site, at www.adobe.com.

Note The Time Navigator Release Notes and Time Navigator Getting Started
Guide manuals are also available in print format.

Time Navigator Release Notes

The Time Navigator Release Notes contain Time Navigator version-specific

information such as new features, new behaviors and performance improvements.

Time Navigator Getting Started Guide

The Time Navigator Getting Started Guide is an introductory guide to familiarize users
with Time Navigator. This guide contains information concerning Time Navigator
Server and Agent installation, backup configuration and restore methods.
 Introduction 3

Other Guides

The Reference guides (Time Navigator Installation Guide, Time Navigator

Administration Guide and Time Navigator Restore Guide) describe the installation,
administration and use of the software for backing up and restoring file systems.
The Specific guides describe installation, configuration and use of Time Navigator options,
such as Time Navigator Archiving Server, Time Navigator for Oracle, Time Navigator
for MS-SQL Server, Time Navigator for NDMP, etc.

Time Navigator Online Help

All the Time Navigator graphical interfaces now include a new context-sensitive online
help system available for:
■ Windows (HtmlHelp format),
■ Unix (HTML format). This format is compatible with the Netscape Navigator 4.0
browser, or any other compatible browser.

This online help system allows you to find the information you need easily and quickly:
■ From any dialog box within the application, click on Help to access context-sensitive
information describing the parameters of the dialog box.
■ From any graphical interface, choose Help - Help Topics to get the online help for this
interface. You can also search for information through the Contents tab, the Index tab
or the Search tab that offers a powerful full-text search.

Time Navigator Tutorials

Discover Time Navigator through the Flash-based Tutorials delivered with the product:
■ Backup Tutorial: How to configure an automatic backup.
■ Restore Tutorial: How to restore missing files or previous versions of existing files.
■ Monitoring Tutorial: How to monitor your backups and analyze problems.
■ Architecture Tutorial: How Time Navigator can be integrated with various
architectures (Client/Server, Multi-site, Secured, Firewall and SAN Architectures).
■ Archiving Tutorial: How to use Time Navigator for long-term storage and
classification of your file sytems.
4 Time Navigator Virtual Library Manager

To access these tutorials, choose Help-Tutorial from the Time Navigator Administration
Console or Time Navigator Restore & Archive Manager. The tutorials are also
available from the Autorun (Windows) or from the CD-ROM index.htm file (Unix).

To view these tutorials, you need:

■ A web browser.
■ A Shockwave Player (or Macromedia Flash Player) program. If needed, download the
program corresponding to your machine’s operating system from:

http://www.macromedia.com/shockwave/download/alternates/

Note The Shockwave Player and Macromedia Flash Player programs are not
available for IBM AIX and VMS.

Technical Support

Web Support
If you have subscribed a maintenance contract and you encounter a problem with
Time Navigator, consult the Atempo Web Support at:

http://support.atempo.com
Complete information on Atempo Web Support, including how to get a login, the range of
tools and services available and how to use each of them, can be found in the Troubleshoot-
ing Guide, on your Time Navigator delivery CD-ROM.
The Knowledge Base includes:
■ Time Navigator PDF documentation.
■ Time Navigator patches.
■ Time Navigator Known Issues.
■ Technical Notes.
If you are unable to solve your problem or find the information you need, Atempo and its
partners will help you. Web support includes an interactive interface through which you can
log your inquiries directly and follow them up. Support is also available by email and by
phone.
 Introduction 5

When calling the Atempo Technical Support team, please provide your maintenance con-
tract number. We also recommend that for all Support inquiries you generate the
Time Navigator Environment Report as summarized in the next section, and explained ex-
haustively in the Troubleshooting Guide.

Generating the Environment Report

The report is generated by the Time Navigator Environment Reporter which retrieves the
information that is essential to address your problems as quickly as possible:
■ Time Navigator version installed.
■ Operating system related information.
■ Type of platforms and storage devices used.
■ Configuration and status of all your Time Navigator catalogs.
■ Time Navigator Events and operating system logs.
To automatically generate the environment report, run the Time Navigator Environment
Reporter as follows:
■ On Unix systems, run the $TINA_HOME/tina_env_report.sh script.
■ On Windows systems, the user must be part of the Administrator group and choose
Start-Programs-Time Navigator-Utilities-Time Navigator Environment Reporter.
The retrieved information is gathered in a compressed file
tina_env_report_date_time.tar.gz.uu on Unix and
tina_env_report_date_time.zip on Windows. This file is located in the Adm direc-
tory of Time Navigator installation directory. You must send it to support@atempo.com.
A README file describing the operating mode is available at the following FTP address:

ftp://ftp.atempo.com/private/tina_env_report/README.txt

Note Updating the Time Navigator Environment Reporter

The Time Navigator Environment Reporter is subject to frequent updates.

Please regularly download the latest version from the following FTP address:
For Unix:
ftp://ftp.atempo.com/private/tina_env_report/tina_env_report.sh.Z
For Windows:
ftp://ftp.atempo.com/private/tina_env_report/tina_env_report.exe
6 Time Navigator Virtual Library Manager

Your Comments are Welcome

We value and appreciate your opinion as a Time Navigator user and reader of our
documentation. As we write, revise and evaluate our guides, your comments are the most
important input we receive. Please do not hesitate to send us any remarks you have to the
following address: documentation@atempo.com
 Virtual Library Manager for ACSLS or LibraryStation 7

C HA PT ER 1

Virtual Library Manager for 1

ACSLS or LibraryStation

Presentation
Time Navigator Virtual Library Manager is installed on an ACSLS or LibraryStation
client. It communicates with the server over the network via two interfaces: the Storage
Server Interface (SSI) located on the client, and the Client System Interface (CSI) located
on the server.
8 Time Navigator Virtual Library Manager

Time Navigator Virtual Library Manager Components

Files
When you create a Virtual Library, the following files are created:

File Description
vtl_config.txt Specifies the script extension to be used.
vtl_info.txt Virtual view of the library contents: slots, drives and cartridges.
tina_stk.conf Contains drives and mailbox slots addresses, the pool and the barcode
range in the library.

The vtl_info file is a text file which is initialized either manually or via the run -C
command (when supported). The file is updated by Time Navigator.

☞ For more information about the use of the run command, see “Using tina_stk in command
line”, page 16.

VTL Directory Content

The $TINA_HOME/VTL directory is created during the Time Navigator Virtual Library
Manager installation. It contains the <Virtual Library> directory created
automatically during the creation of a library in Time Navigator Administration
Console. Its name corresponds to the concatenation of the name of the catalog and the
name of the virtual library (catalogname_libraryname).

Warning It is highly recommended to keep a copy of the $TINA_HOME/Vtl directory

on a different disk so that the virtual library can still be used, should an incident
occur.

☞ For more details about the directory content, see “Appendix A”, page 23.
 Virtual Library Manager for ACSLS or LibraryStation 9

Installation
➤ To install Time Navigator Virtual Library Manager
1. On Windows, install the LibAttach software from StorageTek.

☞ For more information concerning LibAttach, see the Installation and Operations
Guide of LibAttach by StorageTek.

2. Run the Time Navigator installation program on the machine where you want the
virtual library to be hosted.
3. Complete the installation.

☞ For more information concerning the installation procedure, see the Time Navigator
Installation Guide.

Configuration

Note Only the steps related to Time Navigator Virtual Library Manager are
described below. See the Time Navigator Administration Guide for more
information.

When the Time Navigator Virtual Library Manager installation is completed, you
must:
■ Make sure you know the cartridge pool number and the barcodes of all the cartridges
contained in the library.

☞ For more information, see Appendix A in this document, page 23 and StorageTek
documentation.

■ In Time Navigator Administration Console, create the drives that you are going to
use.

☞ For more information, see the Time Navigator Administration Guide.

■ Create a virtual library in Time Navigator Administration Console.

10 Time Navigator Virtual Library Manager

➤ To create a virtual library in Time Navigator

1. On Unix, set the DISPLAY environment variable.
2. Open Time Navigator Administration Console on the host where the virtual library
is going to be installed.
3. Select the host icon and choose Library-Create. A library list appears.
4. Select Special and Virtual library. The Create Library window appears.

The name of the host you selected in Step 1 above appears in the Host Name field.
5. Enter a name for the virtual library.
The Device Descriptor field is automatically entered. It consists of the catalog name
concatenated with the virtual library name (catalogname_libraryname).
6. In the Library Management Software field, choose STK ACSLS/LibraryStation.
7. If you have already created the drives in Time Navigator, associate them to the
library by clicking on Add.
8. Click on Library Properties to set the library parameters.
In the Specific tab, the VTL only: use "Info" File must be checked.
The VTL only: self correcting drive status parameter must be checked only if the drives
are likely to be emptied without Time Navigator being aware of it.
 Virtual Library Manager for ACSLS or LibraryStation 11

☞ For more information concerning library properties, see Chapter 3 and Appendix 1 of
the Time Navigator Administration Guide.

9. Click on Configuration. The Parameters window appears.

10. Fill in the following fields:

Server Name (Unix only): Name of the ACSLS or LibraryStation server.
Server Socket (Unix only): ACSLS or LibraryStation server socket number.
Number of Drives: Number of drives that will be used by Time Navigator.
Number of Mailboxes: Number of mailboxes that will be used by Time Navigator.
Barcode Range: Barcodes of the cartridges that will be used by Time Navigator.
The syntax rules are as follows:
■ Items in a list are separated by a comma ",".
■ The beginning and end of an array is separated by a hyphen "-".

Example C00300-C00400,C00403-C00406,C00425 means that the library contains the

C00300 to C00400 barcodes, the C00403 to C00406 barcodes, as well as the C00425
barcode.
Number of Cartridges: Maximum number of cartridges that you are likely to use. By
default, the maximum number is 300.
12 Time Navigator Virtual Library Manager

Example If you only need 50 cartridges at first but you know that you will probably need 100
more in the future, enter 150 as the maximum number of cartridges.

Note The maximum number of cartridges you can set is 6000.

11. Click on OK. The VTL configuration window appears. It contains the list of the VTL
parameters corresponding to the values you entered in the previous window. Some of
them are already associated to a value.

12. Select a parameter which is not associated to a value and click on Edit. The Edit
Parameter window appears.
13. Choose the appropriate value in the list and click on OK.
-or-
For the DRIVE, MAILBOX or POOL parameters, click on the Browse button on the
right of the Value field. The list of the components that are available on the ACSLS or
LibrayStation server appears:
■ Drive addresses are displayed in ALPD format (ACS, LSM, PANEL, DRIVE).
The number at the end of the drive variable name represents the drive logical
index.
■ Mailbox addresses are displayed in ALC format (ACS, LSM, CAP number).
■ Cartridge pools are represented by their number.
 Virtual Library Manager for ACSLS or LibraryStation 13

14. Once each parameters has been set, click on OK in the Create Library window. The
virtual library appears in Time Navigator Administration Console.

Administration

Moving cartridges

Moving cartridges in Time Navigator Library Manager does not necessarily imply that
the cartridges will be physical moved in the library. Only "slot to drive" and "drive to slot"
operations lead the cartridges to be actually moved. Other moving operations are
simulated.

Warning To move a cartridge from a drive to another drive, you need to move it to a slot
first, and then from the slot to the other drive.

Putting a cartridge online/offline

In order to bring a cartridge on/offline, you need to:
■ Perform the procedure in Time Navigator Library Manager.
■ Run a command to send the order to the library.

☞ For more information about Time Navigator Library Manager, see chapter 4 in the
Time Navigator Administration Guide.

➤ To put a cartridge online

1. Run the following command:
Bin/tina_stk -l catalogname_libraryname -g [-n cap_number].
The mailbox (CAP) can be accessed. Enter your cartridge and close the mailbox.

Note The tina_stk -g command returns control only when the cartridge is
physically inside the library.

2. In Time Navigator Library Manager, choose Cartridge-On-line to put the cartridge

online.
3. Choose Library-Reinitialization-Full-Bar Code to reinitialize the library.
14 Time Navigator Virtual Library Manager

➤ To put a cartridge off-line

1. In Time Navigator Library Manager, choose Cartridge-Off-line to put the cartridge
off-line.
2. Run the following command:
Bin/tina_stk -l catalogname_libraryname -j all [-n cap_number]
The mailbox (CAP) can be accessed. Take your cartridge out and close the mailbox.

Note The tina_stk -j all command returns control only when the cartridge is
physically outside the library.

3. Choose Library-Reinitialization-Full-Bar Code to reinitialize the library.

Upgrading Time Navigator

From Version 3.1 to 4.0

➤ To upgrade Time Navigator Virtual Library Manager from version 3.1 to 4.0
1. Copy the $TINA_HOME/Vtl/<Virtual Library>/vtl_info.txt file in
another directory.
2. Perform the Time Navigator upgrade with the setup program.
3. In Time Navigator Administration Console, delete the previously created virtual
library and create a new one using the configuration procedure described page 9.

Note Virtual drives do not exist anymore. Replace them with physical drives. Refer
to the Time Navigator Library Sharing Manager guide for more details.

4. If you need to use the previous version of the vtl_info.txt file, replace the new
version of the $TINA_HOME/Vtl/<Virtual Library>/vtl_info.txt file by
the vtl_info.txt file that you have previously copied.
5. Manually change all occurences of "VIDE" into "EMPTY" and "NIHIL" to "N/A".
6. Add the mailbox slots as described below:
#Component simulated cartridge
#number address barcode

#slot[0, n-1]
s[0] N/A CLN182
 Virtual Library Manager for ACSLS or LibraryStation 15

s[1] N/A C00373

s[2] N/A C00350
s[3] N/A C00361
s[4] N/A C00360
s[5] N/A EMPTY
s[6] N/A EMPTY

#drive[0, n-1]
d[0] N/A EMPTY
d[1] N/A EMPTY
d[2] N/A EMPTY
d[3] N/A EMPTY

#mailbox[0, n-1]
m[0] N/A EMPTY

#END_OF_TEXT

From Version 3.5, 3.6 or 3.7 to 4.0

➤ To upgrade Time Navigator Virtual Library Manager from version 3.5, 3.6 or 3.7 to 4.0
1. Copy the $TINA_HOME/Vtl/<Virtual Library>/vtl_info.txt file in
another directory.
2. Perform the Time Navigator upgrade with the setup program.
3. In Time Navigator Administration Console, delete the existing virtual library and
create a new one using the configuration procedure described page 9.
4. If you need to use the previous version of the vtl_info.txt file, replace the new
version of the $TINA_HOME/Vtl/<Virtual Library>/vtl_info.txt file by
the vtl_info.txt file that you have previously copied.
5. Choose Library-Reinitialization-Full-Bar Code to reinitialize the library.
16 Time Navigator Virtual Library Manager

Using tina_stk in command line

Syntax

Compatibility with earlier versions

The run.sh script on Unix and run.cmd script on Windows located in the $TINA_HOME/
Vtl/Bin directory can still be used for compatibility reasons to send commands to the
library. In earlier Time Navigator versions, this script has been used to call the tina_stk
program.

Unix Syntax: ./run.sh catalogname_libraryname options

Windows Syntax: run.cmd catalogname_libraryname options

tina_stk command

The tina_stk command must always be used with the -l option.

OPTIONS:

-l catalogname_libraryname
-c Show the library contents in vtl_info format using pool definition
-C Create or overwrite the vtl_info file
-d DRIVEN Where DRIVEN is the name of the variable corresponding to the drive
-f Force cartridge unmount
-g Make CAP ready to enter cartridges
-h Display help
-i Display server information in tina_stk.conf format
-I Create tina_stk.conf
-j all Eject cartridges displayed in the mailbox
-m Put a cartridge in the drive
-n CAP (mailbox) number
-s Associate cartridge barcode range to the pool
-u Unmount
-v volume Barcode of the cartridge

Available Commands
Bin/tina_stk -l catalogname_libraryname -m -v volume -d DRIVEN
Bin/tina_stk -l catalogname_libraryname -u -v volume -d DRIVEN [-f]
Bin/tina_stk -l catalogname_libraryname -c
Bin/tina_stk -l catalogname_libraryname -C
Bin/tina_stk -l catalogname_libraryname -j all [-n mbx_number]
Bin/tina_stk -l catalogname_libraryname -i
Bin/tina_stk -l catalogname_libraryname -I
Bin/tina_stk -l catalogname_libraryname -g [-n mbx_number]
Bin/tina_stk -l catalogname_libraryname -s
Bin/tina_stk -l catalogname_libraryname -h
 Virtual Library Manager for ACSLS or LibraryStation 17

Example
Mounting a cartridge:
Bin/tina_stk -l bill_library1 -m -v TMF192 -d DRIVE1

Dismounting a cartridge:

Note Dismounting a cartridge is only possible if the cartridge is offline.

Bin/tina_stk -l bill_library1 -u -v TMF192 -d DRIVE1

18 Time Navigator Virtual Library Manager

Troubleshooting
Events (logs) of Error and Fatal types are displayed in Time Navigator Event Manager
via Time Navigator Administration Console (Monitoring-Time Navigator Event Manager menu).

It is advisable to consult the other types of logs in the $TINA_HOME/Vtl/Log directory:

■ install file (installation logs),
■ event.log file (ssi logs, ACSLS client),
■ tina_stk.log file (tina_stk logs).

Note The run.sh (Unix) or run.cmd (Windows) script is still supported for
compatibility reasons.

Bar code reinitialization failed

First method (advisable)

1. From Time Navigator Administration Console, delete the library.
2. Recreate the library.

Second method
1. Verify the ACSLS pool on the ACSLS server by using the commands:
query pool all and query scratch all
or by using the command:
Bin/tina_stk -l catalogname_libraryname -c. command.
2. Use the Bin/tina_stk -l catalogname_libraryname -C command.
3. Perform another barcode reinitialization by choosing Library-Operations-Reinitialization-
Barcode in Time Navigator Administration Console.

Unable to connect to the ACSLS or LibraryStation server

You should verify that the server RPC component is accessible on the network.
1. Execute the following command on the machine where Time Navigator Virtual
Library Manager is installed:
rpcinfo -p <ACSLS_server> | grep 300031
The command should return two lines similar to:
 Virtual Library Manager for ACSLS or LibraryStation 19

300031 1 tcp????????
300031 1 udp????????
Even though the tcp and udp port information is correct, it may still be impossible
for tina_stk and the ACSLS or LibraryStation server to communicate. In that case,
try to set the CSI_TCP_RPCSERVICE or CSI_UDP_RPCSERVICE parameters to
"False".
2. Run the following command to display server information:
Bin/tina_stk -l catalogname_libraryname -i
If you get error messages such as cl_select_input: select () failed,
errno=0, it means that the virtual library cannot communicate with SSI. Make sure
that SSI is started.

Unable to restart the ACSLS or LibraryStation server after a shutdown

The ACSLS contains an Oracle database. After a shutdown, this database may not
automatically restart. Call StorageTek technical support to restart the database.

The ACSLS or LibraryStation Server is down and must be reinstalled

1. Configure the ACSLS server or the LibraryStation and create the same pool that was
defined before the server crash (same pool number).
2. Run the Bin/tina_stk -l catalogname_libraryname -s command to
associate the cartridges to the pool.
3. Run the Bin/tina_stk -l catalogname_libraryname -c command to
display the library contents and verify that the cartridges are detected.

The run -c command does not display cartridges

1. Check whether the pool is defined on the ACSLS or LibraryStation Server. Define a
pool if needed.
2. Run the Bin/tina_stk -l catalogname_libraryname -s command to
associate the cartridges to the pool.

There is no empty slot to add cartridges

1. In Time Navigator Administration Console, select the virtual library and choose
Library-Edit.
2. Click on Configuration. Select the MAX_NB_CARTRIDGES parameter and click on Edit.
3. Modify the parameter value.
20 Time Navigator Virtual Library Manager

Warning Make sure that there is no enter/eject operation in progress.

4. Run the Bin/tina_stk -l catalogname_libraryname -s command.

5. Run the Bin/tina_stk -l catalogname_libraryname -C command.

The tina_stk.conf file is lost

1. Make sure that a pool is declared on the ACSLS or LibraryStation server and that you
know the cartridge barcodes.
2. Create a $TINA_HOME/Vtl/<virtual library>/tina_stk.conf file.
3. Run the tina_stk -i > $TINA_HOME/Vtl/<virtual library>/
tina_stk.conf command to redirect the tina_stk -i output to the
tina_stk.conf file.

The vtl_info file is lost

1. Make sure that the tina_stk.conf file is correct.
2. Run the Bin/tina_stk -l catalogname_libraryname -s command.
3. Run the Bin/tina_stk -l catalogname_libraryname -C command.
4. Perform a barcode reinitialization by choosing Library-Operations-Reinitialization-
Barcode in Time Navigator Administration Console.

ACSLS: Inconsistency between the drive contents displayed and the

actual contents

With ACSLS, the actual content of a drive can be different from the displayed status.
1. Compare the results of the following commands to detect such inconsistency:
Bin/tina_stk -l catalogname_libraryname -c
Bin/tina_stk -l catalogname_libraryname -i
2. If the results show that the drive status is inconsistent, run the
Bin/tina_stk -l catalogname_libraryname -u -f -d DRIVEN
command.
3. Compare the results of the commands specified in step 1 to check whether the
inconsistency has been removed.
 Virtual Library Manager for ACSLS or LibraryStation 21

Example The Bin/tina_stk -l fdl_test -c command returns:

s[0] N/A C00373 #STATUS_VOLUME_HOME

s[1] N/A 000399 #STATUS_VOLUME_HOME
............
s[29] N/A EMPTY
d[0] N/A EMPTY
m[0] N/A EMPTY

The Bin/tina_stk -l fdl_test -i command returns

# DRIVE DEFINITION
# driven=a,l,p,d
DRIVE0=0,0,1,3 #status=STATUS_DRIVE_IN_USE

The first command indicates that the drive is empty. The second command indicates
that the drive is in use. This is an example of an inconsistency between the actual
content of the drive and its displayed status.

LibraryStation: Cartridge mount fails with STATUS_DRIVE_IN_USE

error

When attempting to mount a cartridge, the following error may be raised even though the
drive is physically empty:
Failure of acs_mount() status=STATUS_DRIVE_IN_USE
There is an inconsistency between the physical and logical status of the drive.
1. Put a cartridge in the drive via MVS.
2. Run the Bin/tina_stk -l catalogname_libraryname -u -v barcode -f
-d DRIVEN command.
3. Try to mount the cartridge again to check whether the problem still occurs.

Timeout Error Due to Network Problems

If you have problems on your network causing timeout errors, you can modify the value of
the TINA_OPEN_TIMEOUT and TINA_REQ_TIMEOUT variables:
1. Edit the $TINA_HOME/<catalogname_libraryname>/tina_stk.env.
2. Remove the comment character # at the beginning of the lines containing the
variables and set their values to "-1" so that the timeouts be infinite.
######## tina_stk network configuration
#ACSAPI_SSI_SOCKET=enter_the_new_ssi_socket
TINA_OPEN_TIMEOUT=-1
TINA_REQ_TIMEOUT=-1

3. Save the file.

22 Time Navigator Virtual Library Manager

Warning These variables should only be modified temporarily to allow you to correct
your network problems. They must be reset to their original values as soon as
possible.

ACSLS Server cannot Reach Time Navigator Host

If your configuration is the following:

■ The machine hosting Time Navigator has two network cards: one of them is
dedicated to Time Navigator and the other one to ACSLS.
■ The network card dedicated to ACSLS is not associated with the default host name of
the machine.

You may get the following logs on the ACSLS server:

RPC TCP client connection failed, RPC: Rpcbind failure
Set the SSI_HOSTNAME environment variable to fix the problem:
1. Edit the $TINA_HOME/<catalog_libraryname>/tina_stk.env file.
2. Add the SSI_HOSTNAME variable below the CSI_HOSTNAME variable. Its value must
be the host name associated with the network card dedicated to ACSLS:
#### Server name
CSI_HOSTNAME=ACSLS_server_name
SSI_HOSTNAME=hostname_for_ACSLS_network_card

3. Save the file.

4. Stop and restart the SSI process.
 23

Appendix A
$TINA_HOME/VTL Directory Content for Unix

Directories Files Description

Vtl Bin run.sh Scripts used to control the library. Only used for
vtl_close.sh compatibility with earlier Time Navigator versions.
vtl_move.sh
vtl_open.sh

Bin/ACSLS ssi ACSLS client library

mini_el Generates ssi logs
start.sh ssi and mini_el starting scripts
Install Unix_install.sh Script executed to create a Virtual Library
tina_stk.conf
tina_stk.env
tina_vtl.env Sample Files
vtl_config.txt
vtl_info.txt

Log Contains the logs.

Tmp Contains temporary files, such as lock files.
<Virtual tina_stk.conf There are as many directories as there are virtual
Library> tina_stk.env libraries.
tina_vtl.env
vtl_config.txt
vtl_info.txt

Warning It is highly recommended to keep a copy of the $TINA_HOME/Vtl directory

on a different disk so that the virtual library can still be used, should an incident
occur.
24 Time Navigator Virtual Library Manager

%TINA_HOME%\VTL Directory Content for Windows

Directories Files Description

Vtl Bin run.cmd Script used to control the library. Only used for com-
patibility with earlier Time Navigator versions.
Install tina_stk.conf Sample files
vtl_config.txt
vtl_info.txt
tina_stk.env

Log Contains the logs for the various scripts.

Tmp Contains temporary files, such as lock files.
<Virtual tina_stk.conf There are as many directories as there are virtual li-
Library> vtl_config.txt braries.
vtl_info.txt
tina_stk.env

Note <Virtual Library> is a directory created automatically during the creation of

a library in Time Navigator Administration Console. The name corresponds to
the concatenation of the name of the catalog and the name of the virtual library
(catalogname_libraryname).

Warning It is highly recommended to keep a copy of the $TINA_HOME/Vtl directory

on a different disk so that the virtual library can still be used, should an incident
occur.
 Appendix A 25

Configuration File Description

The Virtual Library configuration files located in the $TINA_HOME/
<catalogname_libraryname> directory are described below. You may need to edit
them in order to manually configure a Virtual Library.

tina_stk.env File

The tina_stk.env file contains the connection parameters.

tina_stk.env
######## ssi and mini_el configuration

#### Server name

CSI_HOSTNAME=enter_your_server_name_here

#### Default values (do not modify)

ACSAPI_PACKET_VERSION=4
CSI_CONNECT_AGETIME=172800
CSI_RETRY_TIMEOUT=8
CSI_RETRY_TRIES=15
CSI_TCP_RPCSERVICE=TRUE
CSI_UDP_RPCSERVICE=TRUE
TRACE_VALUE=800000

######## tina_stk network configuration

#ACSAPI_SSI_SOCKET=enter_the_new_ssi_socket
#TINA_OPEN_TIMEOUT=30
#TINA_REQ_TIMEOUT=300

export CSI_HOSTNAME ACSAPI_PACKET_VERSION CSI_CONNECT_AGETIME CSI_RETRY_TIMEOUT

export CSI_RETRY_TRIES CSI_TCP_RPCSERVICE CSI_UDP_RPCSERVICE TRACE_VALUE
export ACSAPI_SSI_SOCKET

CSI_HOSTNAME: Name of your ACSLS or LibraryStation server.

Example: If the server name is "Flash", the entry should be CSI_HOSTNAME=Flash
ACSAPI_SSI_SOCKET: Number of your ACSLS or LibraryStation server socket.
Example: If the server socket number is 50004, the entry should be
ACSAPI_SSI_SOCKET=50004
TINA_OPEN_TIMEOUT: Timeout for library opening. This variable must not be modified
unless you are experiencing network problems. See “Timeout Error Due to Network
Problems”, page 21.
TINA_REQ_TIMEOUT: Timeout for mounting and unmounting requests. This variable
must not be modified unless you are experiencing network problems. See “Timeout
Error Due to Network Problems”, page 21.
26 Time Navigator Virtual Library Manager

Note If you have more than one ACSLS or LibraryStation server, set the
ACSAPI_SSI_SOCKET variable in your environment.

tina_stk.conf File

The tina_stk.conf file contains the drive, mailbox and cartridge parameters. This file
can be generated via the tina_stk -i command, which allows to prefill the file with
some information retrieved from the ACSLS or LibraryStation Server.

tina_stk.conf
######### See Virtual Library Manager manual for details.#########

# DRIVE DEFINITION
# driven=a,l,p,d
DRIVE0=0,0,1,0 #status=STATUS_DRIVE_AVAILABLE
DRIVE1=0,0,1,1 #status=STATUS_DRIVE_AVAILABLE
DRIVE2=0,0,1,2 #status=STATUS_DRIVE_IN_USE
DRIVE3=0,0,1,3 #status=STATUS_DRIVE_AVAILABLE
DRIVE4=1,0,0,0 #status=STATUS_DRIVE_IN_USE
DRIVE5=1,0,0,1 #status=STATUS_DRIVE_IN_USE

# CAP DEFINITION
# mailbox=a,l,c:number_of_mailbox_slots
MAILBOX0=0,0,0:1 #cap[0]mode=MANUAL status=STATUS_CAP_AVAILABLE
MAILBOX1=1,0,0:10 #cap[1]mode=MANUAL status=STATUS_CAP_AVAILABLE

# POOL DEFINITION (pool number must be different from 0)

# POOL=Number
POOL1=111 #vol_count=2 status=STATUS_SUCCESS(0,1125)
POOL2=123 #vol_count=5 status=STATUS_SUCCESS(0,2147483647)
POOL3=124 #vol_count=3 status=STATUS_SUCCESS(0,1000)

# RANGE DEFINITION
# RANGE=Barcode
# RANGE=C00000-C00099,000034

# MAXIMUM NUMBER OF CARTRIDGES DEFINITION

# MAX_NB_CARTRIDGES=Number
MAX_NB_CARTRIDGES=300

DRIVE DEFINITION section

■ Time Navigator detects the drives declared on the ACSLS or LibraryStation
Server, and enters their addresses in ALPD format (ACS, LSM, PANEL, DRIVE).
The drives are represented with the driven=a,l,p,d format where n is the drive
logical index.
You must remove the lines corresponding to the drives that are not used by this
particular virtual library and modify the logical indexes if needed.
■ The status field indicates the current statuses of the drives. The drives must be
available. If the status is STATUS_DRIVE_IN_USE, you must empty the drive
before proceeding with the configuration.
 Appendix A 27

CAP DEFINITION section

■ The CAPs (Cartridge Access Ports) correspond to the mailboxes. Time Navigator
detects the mailboxes and records their addresses in ALC format (ACS, LSM,
CAP number).
You must remove the lines corresponding to the mailboxes that are not used by
this particular virtual library.
■ The CAP mode must be MANUAL. If it is AUTOMATIC, change the mode of your
CAP before proceeding with the configuration.

POOL DEFINITION section

■ Remove the lines describing the pools that are not used by this particular virtual
library.

RANGE DEFINITION section

You must replace the sample barcode values C00000-C00099, 000034 by your
own barcode values. The syntax rules are the following:
■ Items in a list are separated by a comma ",".
■ The beginning and end of an array is separated by a hyphen "-".
Example
C00000-C00099, 000034, 000038 means that the library contains the C00000
to C00099 barcodes, as well as the 000034 and 000038 barcodes.
You must then remove the # character (comment) from the beginning of the line.

MAXIMUM NUMBER OF CARTRIDGES DEFINITION section

Define the maximum number of cartridges that you are likely to use. By default, the
maximum number is 300. Replace the default value by your own value.
Example: If you only need 50 cartridges at first but you know that you will probably
need 100 more in the future, enter 150 as the maximum number of cartridges.

Note The maximum number of cartridges you can set is 6000.

28 Time Navigator Virtual Library Manager

tina_vtl.env File

The tina_vtl.env file contains Time Navigator environment variables.

tina_vtl.env

######## Vtl configuration file ###############

# platform (Solaris, IbmRs, HpV10, HpV11, SgiV5, SgiV6)

TINA_SYSTEM=Solaris

# module name ( stk, grau, ..)

TINA_MODULE=tina_stk

# tina home
TINA_INST=~tina

# catalog name
TINA_CATALOG=fdl

# log level(0->4)
TINA_LOG=0

export TINA_SYSTEM TINA_MODULE TINA_INST TINA_CATALOG

. "$TINA_VTLHOME/$TINA_ROBNAME/${TINA_MODULE}.env"

Environment Variables Description

TINA_SYSTEM Operating system of the machine controlling the library
TINA_MODULE tina_stk

TINA_INST Time Navigator installation directory

TINA_CATALOG Catalog name
TINA_LOG Event log level (0: no log to 4: all logs activated)
The logs are located in the $TINA_HOME/Vtl/log directory
 Appendix A 29

vtl_config.txt File

The vtl_config.txt file contains the script extension to be used.

vtl_config.txt
##V To activate the verbose mode, put "#V" at the beginning of the first line
#
# One declaration per line and the last one is prior
#
# " = are the separators:
#
# NT shell = "bash.exe" is OK
# NT shell bash.exe is OK
# NT shell = bash.exe is OK
# NT shell = "C:\Program Files\Tools\bash.exe" is OK
#
# NT shell = ""bash.exe"" is not supported
# NT shell = C:\Program Files\Tools\bash.exe is not supported

# Variables
# For UNIX : UNIX shell, UNIX extension
# For NT : NT shell, NT extension

UNIX extension = "sh"

NT shell = "tina_stk.exe"

Add the following line at the end of the file:

Unix shell = tina_stk_path
where tina_stk_path is the absolute path of the tina_stk.conf file.

Note After modifying the configuration files, you must reinitialize the virtual library. In
Time Navigator Administration Console, right click on the virtual library icon
and select Library-Operations-Reinitialization-Barcode.
30 Time Navigator Virtual Library Manager
 31

Appendix B
ACSLS and LibraryStation

Principles

ACSLS and LibraryStation do not allow to easily view the actual contents of the library.
However, it is possible to know the list of the barcodes associated with a "pool" and to
simulate the contents of the library as with an SCSI library (except for the number of
available slots which remains unknown).

It is impossible to know the contents of the mailbox with ACSLS and LibraryStation.
However, it is possible to simulate the functionalities of putting cartridges online/offline
with the help of a mailbox as described in the vtl_info file.

Therefore, one is able to put cartridges online/offline with Time Navigator in the same
way as with a SCSI library.
32 Time Navigator Virtual Library Manager

Definition of Pools

A pool is a group of blank cartridges that you must define on the ACSLS or LibraryStation
server. It is identified by a number.

The pool is associated with the data storage elements. It corresponds to the library slots with-
out the drives and the mailbox. It is used in tina_stk and is declared in the
tina_stk.conf.

Warning A pool must be defined by the ACSLS or LibraryStation administrator before

creating the virtual library in Time Navigator.

Warning Every operation of mounting/dismounting a cartridge must be performed via

Time Navigator and thetina_stk command.

Configuration of the ACSLS Server

➤ To configure an ACSLS server and define a pool
1. Connect to the ACSLS server using the acsss user.
2. Launch the command:
cmd_proc

3. Define the pool.

For example:
ACSSA> define pool 0 2147483647 123
Define: Pool 123 created
Define: Define completed, Success.
ACSSA> q pool all
2001-08-24 13:48:20 Pool Status
Identifier Volume Count Low Water Mark High Water Mark Attributes
0 0 0- 2147483647
123 0 0 2147483647
ACSSA>
 Appendix B 33

Configuration of a LibraryStation

LibraryStation is a software communication interface feature of the StorageTek Host

Software Component (HSC) MVS/ESA implementation. It resides on the MVS host
system.

The LibraryStation emulates an ACSLS. Below are examples of LibraryStation

configurations.

Example
BROWSE $BASEPRO.BASEPRPO.SLS.PARMLIB(SLSPARMP)- Line 00000000 Col 001 080
Command -> _________________________________________________ Scroll ==> CSR
*********************************** Top ot Data *****************************
/* PARAMETRE DE LANCEMENT SLS: NE PAS SUPPRIMER CETTE CARTE */
CDSDEF DSN1 ($BASEPRO.BASEPRPS.SLS.CNTL1), -
DSN2 ($BASEPRO.BASEPRPS.SLS.CNTL2)
/* EXECP MSGPRFX(Y),E(08-),F(23) */
MNTD AU(ON),D(A),MAX(100),MO(R),S(M),VOLW(ON),F(OFF)
OPT O(M),ENT(M),V (10) , DISCMSG (SUPPRESS)
CAPPREF 9 000:00
ALLOC G(SEP)
ALLOC X02SUB(HONOR)
ALLOC XO8SUB(HONOR)
SCRPOOL NAME=HOSTDMVS,RANGE(OC0000-0C0499),LABEL=SL
SCRPOOL NAME=HOSTPROD,RANGE(N00000-N10999),LABEL=SL
SCRPOOL NAME=HOSTPRIA,RANGE(N50000-N50299),LABEL=SL
SCRPOOL NAME=POOL,RANGE(N7000-N70299,N90000-N90199),LABEL=SL
W SCR 00 SUB(HOSTDMVS) THRES(100)
W SCR 00 SUB(HOSTPROD) THRES(200)
W SCR 01 SUB(HOSTPRA) THRES(80)

/* DEMARRAGE DE LS */
LSINIT NETHOST(UNLS) COMMONSP (POOL) -
COMMTYPE(RPC) -
CREQLOG(YES) -
PDF(PPRODUIT.NCS400.PDF) -
PDFX(PPRODUTT.NCS400.PDF.PATH.NAME) -
LSDEF('$BASEPRO.BASEPRPO.SLS.PARMLIB(LSDEF)')
TCPNAME(TCPIP)

/* UEXIT 01 LOAD=SLSUX01,ENABLE */
/* UEXIT 02 LOAD=SLSUXO2,ENABLE */

TREQDEF DSN('$BASEPRO.BASEPRPO.SLS.PARMLIB(TAPEREQ)')
UNITDEF DSN('$BASEPRO.BASEPRPO.SLS.PARMLIB(UNITATTR)')
VOLDEF DSN('$BASEPRO.BASEPRPO.SLS.PARMLIB(VOLATTR)')
***************** Bottom of Data ********************************
34 Time Navigator Virtual Library Manager

Example
EDIT$BASEPRO.BASEPRPO.SLS.PARMLIB(VOLATTR) 01,01 Columns 00001 00072
*********************************** Top ot Data *****************************
==MSG> Warning- The UNDO command is not available until you change
==MSG>your edit profi1e using the command RECOVERY ON.
000001 VOLATTR SER(0C0000-000499)MEDIA(EGART)
000002 VOLATTR SER(N00000N-10999)MEDIA(ECART)
000003 VOLATTR SER(N50000-N50999)MEDIA(STK1R)
000004 VOLATTR SER(N70000-N70299)MEDIA (STK1R)
000005 VOLATTR SER(N90000-N90199)MEDIA (STK1R)
***************** Bottom of Data ********************************

Example
EDIT$BASEPRO.BASEPRPO.SLS.PARMLIS(LSDEF) - 01.01Columns 00001 00072
*********************************** Top ot Data *****************************
==MSG> -Warning-The UNDO command le not available until you change
your edit profile using the command RECOVERY ON.
000001 SPNUM NUM(123) SPNAME(POOL)
********************************** Bottom of Data ****************************

Pool Management

All memberships to the pool are erased by ACSLS or LibraryStation if:

■ The cartridge is mounted in a drive
■ The cartridge is ejected from the library.

A cartridge is added to a pool by tina_stk in shell mode during a cartridge movement if

the destination is a slot.

☞ See “Putting a cartridge online/offline”, page 13 for more information about the procedure.

Management of the vtl_info file by tina_stk

The vtl_info file must be generated by tina_stk. To generate the vtl_info file, run
the following command:
Bin/tina_stk -l catalogname_libraryname -C

☞ For more information concerning this command, see “Using tina_stk in command line”,
page 16.

The vtl_info file is edited by tina_mount during:

 Appendix B 35

■ An insertion of a cartridge, adding the barcode at the level of the mailbox.

■ An ejection of a cartridge, removing the barcode at the level of the mailbox.
A barcode reinitialization must be performed in Time Navigator Administration
Console choosing Library-Operations-Reinitialization-Barcode.
36 Time Navigator Virtual Library Manager

ACSLS Quick Reference Guide

Throughout this quick reference, underlines show valid command and keyword
abbreviations. For example, aud is an abbreviation of the audit command. Brackets []
enclose optional parameters. A vertical bar (|) separates parameter choices.

Glossary

ACS Automated Cartridge System

The library subsystem consisting of one LMU, and one to 24 LSMs connected to that
LMU.

LMU Library Management Unit

The portion of an ACS that manages LSMs, allocates their resources, and communicates
with ACSLS.

LSM Library Storage Module

An ACS structure that provides the storage area for cartridges, cartridge drives, CAPs, and
the library necessary for moving them.

CAP Cartridge Access Port

A bidirectional port built into the door panel of an LSM, which provides for the manual
entry or automatic ejection of tape cartridges (mailbox).

Configure ACSLS

To do this task Use this command or utility

Run the configuration script. acsss_config

Display values of dynamic options dv_print

Display values of static options dv_config -s

Display values of dynamic and static options dv_config -d

Query Status

To do this task Use this command or utility

Display ACSLS and Iibrary status . query server

Displav ACS status query acs acs_ id...| all

Display LSM status query lsm lsm_ id...| all

Display CAP status query cap cap_ id...| all

 Appendix B 37

To do this task Use this command or utility

Display transport status query drive drive_ id...| all

Display LMU and port status for both single- LMU and query lmu lmu_ id...| all
dual-LMU ACS configurations
Display status of media-compatible transports for a query mount vol_id
specified data volume
Display status of media-compatible transports for a query mount * pool_id...[media
specified scratch pool (or volume media type within the media_type|media *]
pool)
Display port status query port port_ id...| all

Display the location of a volume query volume volume_ id...| all

Display cleaning cartridge status query clean vol_ id...| all

Display the status of scratch volumes in a pool query scratch scratch_ id...| all

Display scratch pool attributes query pool pool_ id...| all

Display request status query request request_id...| all

Cancel a current or pending request cancel request_id...| all

Display the lock status of a transport or volume query lock drive | volume
identifier...| all

Manage CAPS

To do this task Use this command or utility

Display CAP status query cap cap_id...| all

Set CAP’s entry mode (manual or automatic) set cap mode manual | automatic
cap_id

Set CAP’s automatic selection priority set cap priority cap_priority cap_id

Make manual mode CAP ready to enter labelled carts enter cap_id

Make CAP ready to enter unlabeled carts into library enter cap_id vol_id | volrange

Manage volumes

To do this task Use this command or utility

Mount a data volume or cleaning cartridge mount vol_id drive_id [bypass][readonl y]

Dismount a data volume or cleaning cartridge dismount vol_id drive_id [force]

Create a volume report volrpt [-s vol | loc | use] [-d] [-f filename]
[-z] [-a | -l | -v identifier list]

Set volume ownership set owner owner_id volume vol_id | vo/range

38 Time Navigator Virtual Library Manager

To do this task Use this command or utility

Eject volumes from the library eject cap_id vol_id | vo/range..

Move volumes to a specified LSM move vol_id Ism_id

Delete a volume in an offline LSM del_vol vol_id -n -q

Manage scratch volumes/pools

To do this task Use this command or utility

Create or modify scratch pools define pool low_water_mark
high_water_mark pool_id [overflow]

Display scratch pool attributes query pool pool_id...| all

Display the status of scratch volumes in a pool query scratch pool_id... | ail

Set volume’s scratch attribute and assign the volume to a set scratch pool_ id vol_id | vo/
scratch pool range...

Change volume from scratch to data set scratch off pool_id vol_id | vo/
range

Delete an empty scratch pool delete pool pool_id... | all

Mount a scratch volume from a specified pool (single media mount * drive_id pool_ id
libraries)
Mount a scratch volume from the common pool(single mount * drive_id
media libraries)
Mount a scratch volume from a specified pool with specific mount * drive_id pool_ id media
media type media_type

Mount a scratch volume from a specific pool, media type mount * drive_id pool_id media *
based on scratch preferences defined
Mount a scratch volume from common pool, media type mount * drive_id media *
based on defined scratch preferences
Mount a scratch volume from common pool with specified mount * drive_id media media_ type
media type
Display status of media-compatible transports for a query mount * pool_id [media *]
specified scratch pool (or volume media type within the media_type| media
pool)

Manage locks

To do this task Use this command or utility

Set your lock ID set lock lock_id

Display your current lock ID or user ID show lock | user

 Appendix B 39

To do this task Use this command or utility

Lock a volume or drive (to your current lockID) lock drive | volume identifier..| all

Remove active locks (to your current lock ID) on specified unlock drive | volume identifier
drives or volumes or all active locks
Remove all active and pending locks on specified drives or clear lock drive | volume identifier
volumes

Clean transports

To do this task Use this command or utility

Set cleaning cartridge attributes set clean max_usage | vol_id |
volrange

Set cleaning attributes back to data cartridges set clean off vol_id | volrange

Display cleaning cartridge attributes query clean vol_id.. | all

Manage a dual-LMU

To do this task Use this command or utility

Display LMU and port status for both single- LMU and query lmu acs_id ... | all
dual-LMU ACS configurations
Manually switch ACS management from the ACS’s master switch lmu acs_id
LMU to the standby LMU

Audit the library

To do this task Use this command or utility

Audit the entire library audit cap_id server

Audit an ACS audit cap_id acs acs_id

Audit an LSM audit cap_id lsm lsm_id

Audit an LSM panel audit cap_id panel panel_id

Audit an LSM subpanel audit cap_id subpane1 subpanel_id

Maintain the database (Unix prompt)

To do this task Use this command or utility

Export database table data and miscellaneous database files db_export.sh -f db_file
to tape or a file. Use when reinstalling ACSLS or upgrading
to a new ACSLS version using the same database.
40 Time Navigator Virtual Library Manager

To do this task Use this command or utility

Import database table data and miscellaneous database files db_import.sh -f db-file
from the export tape or file. Use when reinstalling ACSLS
or upgrading to a new ACSLS version using the same
database.
Back up the database bdb.acsss [--f filenaine |
tapedevice] [-o]

Start up or shuts down the database db_command start | stop | stopforce

Recover the database after a database failure rdb.acsss

Install optional second disk (Unix prompt)

To do this task Use this command or utility

Initialize the second disk sd_mgr.sh

Vary library components

To do this task Use this command or utility

Change the state of an ACS vary acs acs_id... online | offline
| diagnostic [force]

Change the state of an LSM vary lsm lsm_id... online | offline |

diaonostic [force]

Change the state of a CAP vary cap cap_id ... on1ine | offline
| diagnostic [force]

Change the state of a transport vary drive drive_id online | offline

| diagnostic [force]

Change the state of a port vary port port_id online | offline

Command Identifiers

Each command identifier corresponds to a type and consist of one or more components
separated by commas. ACSLS allows a maximum of 42 idenifiers per type.

To do this task Use this command or utility

acs_id acs(0-126)
 Appendix B 41

To do this task Use this command or utility

cap_ id acs(0-126),lsm(O-23),cap(0-2)
An asterisk (*) in a cap_ id does the following:

acs,lsm,* causes ACSLS to select the highest priority available CAP in the LSM.

acs,* causes ACSLS to select the highest priority available CAP in the ACS

* for an enter request causes ACSLS to select the CAP in the ACS with the most free
cells.

* for an eject request causes ACSLS to select the highest priority CAP in each ACS
with a volume designated for ejection.

cell_ id acs(0-126),lsm(0-23),panel(0-19),row(0-41),column(0-23)

drive_id acs(0-126),lsm(0-23),panel(0-19),drive(0-19)

drive_type 10 characters transport type identifier; can be any combination

of numbers (0-9) or letters (A-Z).

lock_id decimal number (0-32767)

lsm_ id acs(0-126),lsm(0-23)

media_type 10 character media type identifier; can be any combination of numbers (0 9) or letters
(A Z). Spaces are not allowed. Two common media types are 3480 and 3490E.

paneli_ id acs(0-126),lsm(0-23),panel(0-19)

pool_ id decimal number (0-65534) Specifying an asterisk (*) for the

pool_ id reassigns a volume to its current pool_id

ports_ id acs(0-126),port(0-23)

request_ id unique decimal number (0-65535) assigned by the ACSLS.

sub panel_ id aes(0-126),lsm(0-23),panel(0-19),startrow(0-41),startcolumn(0-23), endrow(0-

41),endcolumn(0-23)

vol_ id Six-character identifier consisting of any combination of numbers (0-9), letters (A-Z, a-z, or
mixed case (except for use in volrpt)), dollar sign ($), pound sign (#), and spaces ( ).Use
single or double quotes to enclose vol_ ids with leading or trailing spaces. Do not specify
vol_ ids with embedded spaces.

volrange Specifies an ascending range of volumes separated by a dash. Specify only the right-most
numeric portions of the vol_ ids as the range. All preceding characters must be identical.
42 Time Navigator Virtual Library Manager
 43

Appendix C
CentricStor

Principles

With CentricStor, a virtual backup system is installed upstream of the library with the
physical drives and data cartridges. The virtual backup system contains a series of logical
drives and volumes. At its heart is a data buffer, known as the disk cache, in which the
logical volumes are made available. This guarantees extremely fast access to the data, in
most cases allowing both read and write operations to be performed much more efficiently
than in conventional operation.

Time Navigator Configuration

CentricStor requires specific VTL configuration.

Warning Drive cleaning must not be automatically performed by Time Navigator.

Uncheck the Cleaning Managed by Time Navigator box in the Edit Drive window.

➤ To configure Time Navigator to back up on CentricStor

1. On Unix, set the DISPLAY environment variable.
2. Open Time Navigator Administration Console on the host where the virtual library
is going to be installed.
44 Time Navigator Virtual Library Manager

3. Follow steps 3. to 9. of “To create a virtual library in Time Navigator”, page 10. The
VTL Parameters window appears.

4. Provide the necessary information:

Server Name (Unix only): Network Name of the CentricStor server.
Server Socket (Unix only): Socket on which SSI listens for requests from
Time Navigator.

☞ The other fields in this window must be filled as for an ACSLS virtual library.

5. Complete the virtual library configuration by following steps 10. to 14. of “To create
a virtual library in Time Navigator”, page 10.
6. Edit the $TINA_HOME/Vtl<catalogname_libraryname>/vtl_config.txt
file.
7. Add the following line at the end of the text file:
TRUNCATE_CARTRIDGE="yes"
 Appendix C 45

Example
##V To activate the verbose mode, put "#V" at the beginning of the first line
#
# One declaration per line and the last one is prior
#
# " = are the separators:
#
# NT shell = "bash.exe" is OK
# NT shell bash.exe is OK
# NT shell = bash.exe is OK
# NT shell = "C:\Program Files\Tools\bash.exe" is OK
#
# NT shell = ""bash.exe"" is not supported
# NT shell = C:\Program Files\Tools\bash.exe is not supported

# Variables
# For UNIX : UNIX shell, UNIX extension
# For NT : NT shell, NT extension

UNIX extension = "sh"

NT shell = "tina_stk.exe"
TRUNCATE_CARTRIDGE="yes"

Warning The TRUNCATE_CARTRIDGE variable is mandatory if a pool (POOL) has been

defined when configuring the virtual library. This variable allows
Time Navigator to support the CentricStor migration from tape to disk.

8. Save the file.

Warning If the TRUNCATE_CARTRIDGE variable has not been set, migrated data cannot
be restored normally. Follow the procedure below restore migrated data:
- Set the TRUNCATE_CARTRIDGE variable.
- Mount and then unmount the cartridge to remove it from the pool.
- Run the vlmcmd prefetch -v lv command. See the command description
in the CentricStor documentation.

Restore Performances

Due to the CentriStor data migration process, data needed for a restore may not be readily
available if it has been migrated, which might slow the restore operation.

To improve performances, you should use the tunable Script to Run during Cartridge Allocation
on Restore. This tunable allows to run a script before launching the restore, following the
cartridge allocation phase. The tunable must be set on the host where the restore is
performed. The value of the tunable is the absolute name and path of the script.
46 Time Navigator Virtual Library Manager

The script can launch any operation that the user needs to perform prior to restoring files,
but after the directory structure has been restored.

The script can use the following environment variables:

■ TINA_HOME: Directory where Time Navigator is installed.
■ TINA_CATALOG: Name of the catalog you are restoring from.
■ TINA_DEST_FOLDER: Name of the restore destination folder, either host.xyz for a
host or appl.xyz for an application, where "xyz" is the folder name.

The list of cartridges required for the restore is sent to the script using stdin.

In the script, one cartridge label and barcode are defined per line, using the CSV format.
Example :

nm00001,C00002

This script returns 0, when the restore is successfully performed. Any other value indicates
that the restore is aborted.

centricstor_prefetch.sh script

The centricstor_prefetch.sh script is provided as a sample script. It pre-launches

the migration from tape to disk of all the data to restore, in order to improve restore
performances.

The script is located in the directory TINA_HOME/Vtl and must be configured as follows:
■ The value of the variable CENTRICSTOR_VLP must be set to the hostname of the
CentricStor disk array
■ The default access method is rsh. If you want to use ssh instead, modify that value
directly into the body of the script
 Index 47

Index pool 27
Directory Content
TINA_REQ_TIMEOUT, variable 21
tina_stk.conf, file 8, 26
Unix 23 tina_stk.env, file 25
Windows 24 tina_vtl.env, file 28
Drive definition 26 Troubleshooting 18

I U
Installation Upgrading
A graphical mode 9 Time Navigator 3.1 to 3.7 14
ACSLS Time Navigator 3.5/3.6 to 3.7 15
general issues 31
Quick Reference Guide 36 L
references 36 Library Station V
ACSLS server configuration 33 VTL Directory Content 8
configuration 32 general issues 31 vtl_config, file 8, 29
pool definition 32 Logs 18 vtl_info.txt 8
Administration 13 file management 34
ALPD format 26 updating 14, 15
M
Mailbox
B definition
Barcode manual/automatic mode 27
range definition 27 Management
reinitialization failed 18 pool 34
Bringing on/offline of cartridge 13 vtl_info file 34
Manual configuration 25
C
CAP, See Mailbox O
Cartridges Operating Systems supported 1
bringing on/offline 13
maximum number 27 P
CentricStor, configuring 43
Pool 32
Checking logs 18
definition 27
Client System Interface 7
management 34
Command line
using tina_stk 16
Configuration 9 R
ACSLS server 32 Robot Properties 10
Library Station 33 run, script 16
Configuration files 8, 25
Create a Virtual Library 10
CSI, See Client System Interface
S
Scripts
run 16
D SSI, See Storage Server Interface
Definition Storage Server Interface 7
barcode range 27
drive 26
mailbox
T
TINA_OPEN_TIMEOUT, variable
maximum number of cartridges
21
27
48 Time Navigator Virtual Library Manager