unixadmin.free.fr Handy Unix Plumbing Tips and Tricks

Redefine Library and Drives on Windows TSM server

Problem
Drives not working after system, library or cabling reconfiguration.
Cause
There are times, especially when a system has been rebuilt, that it is necessary to remove & redefine the library & the drive(s). Sometimes there are specific errors associated with this as well (see Problem Abstract for example).
Resolving the problem

Common errors that may be encountered after a library or recabling configuration may be:
ANR8300E I/O error on library (OP=xx CC=xx KEY=xx ASC=xx ASCQ=xx SENSE=xx)
ANR8441E Initialization failed for SCSI library
ANR8301E I/O Error on library

NOTE: These steps apply to libraries of LIBTYPE=SCSI or (with the library path definition step removed) LIBTYPE=MANUAL. For libraries of LIBTYPE=ACSLS or LIBTYPE=EXTERNAL, refer to the TSM Server Administrator's Guide and the Storagetek (in the case of ACSLS) or External Media Management software vendor (in the case of EXTERNAL, e.g. Gresham) documentation for configuration information. This technote does not account for library client servers or storage agents in a library sharing environment. Additional steps will be needed to redefine drive paths for the library client servers and/or storage agents to the same drive definitions for which the library manager server's drive paths point to the same physical device.

This is specific to Microsoft Windows Operating Systems. These steps should only be used, after attempts to update the drive and paths using autodetect features have been exhausted.

1. Run the 'TSMDLST' command to produce a list of the configured OS devices. This command is located in the following directory of a standard install and should be run from a MS-DOS prompt:
C:\program files\tivoli\tsm\console\

This information is usually (although not always) also viewable from the TSM Management Console's "Device Information" window under TSM Device Driver for the machine on which the TSM server is running.

2. Write down the 'TSM Name' for the library and drives:
Library=lb#.#.#.#
Drives=mt#.#.#.#

3. Gather the output of the following for a reference:
QUERY LIBRARY
QUERY DRIVE F=D
QUERY PATH F=D

4. First the drive and library paths must be deleted.

Do this for all drives:
DELETE PATH SRCTYPE=SERVER DESTTYPE=DRIVE
LIBRARY=

Do the following for the library:
DELETE PATH SRCTYPE=SERVER DESTTYPE=LIBRARY

5. Now the device reference must be deleted.
Do the following for all drives:
DELETE DRIVE

Then for the library:
DELETE LIBRARY

6. Now the devices can be redefined to TSM. Use the query outputs from step 3 as a guide for the device names. First, redefine the library:
DEFINE LIBRARY LIBTYPE=
(NOTE: If this is a shared library, add SHARED=YES to the above definition)

7. Next, redefine the path to the library. Often, drive and drive path definitions cannot be created until the TSM server is able to communicate with the library in which the drives exist.

Redefine path to library using the library device value from step 2:
DEFINE PATH SRCTYPE=SERVER DESTTYPE=LIBRARY DEVICE=lb#.#.#.#

8. Redefine the drives:
DEFINE DRIVE

9. Redefine the paths to the drives. Use the information gathered from the 'tsmdlst' in step 2 for the device parameter. Use the query outputs from step 3 as a guide for the device names.

Redefine paths to all drives:
DEFINE PATH SRCTYPE=SERVER DESTTYPE=DRIVE LIBRARY= DEVICE=mt#.#.#.# AUTODETECT=YES

NOTE: For multivendor libraries (as in libraries whose drives are not from the same vendor, e.g. a Dell Powervault 136T with IBM LTO drives), the autodetect feature may not function in such a way to automatically detect the drive's element and serial numbers. In that event, refer to the device's worksheet (often found by going to www.ibm.com/support and searching on the make & model of the library itself) to obtain a list of valid drive element numbers. This information may also be available through the use of vendor-specific library querying utilities (the vendor equivalent of the IBMTape utility "ntutil.exe").

8. Check all of the Scratch volumes back in.
IMPORTANT - you MUST check in the Scratch volumes first or ALL volume will be marked as "Private."
CHECKIN LIBVOL SEARCH=YES CHECKLABEL=BARCODE STATUS=SCRATCH

9. Check in the Private volumes as well.
CHECKIN LIBVOL SEARCH=YES CHECKLABEL=BARCODE STATUS=PRIVATE