UPDATE LIBRARY (Update a SCSI library)

Use this syntax to update a SCSI library.

Privilege class

To issue this command, you must have system privilege or unrestricted storage privilege.

Syntax


>>-UPDate LIBRary--library_name----LIBType--=--+-SCSI-+--------->
                                               '-VTL--'     

>--+--------------------+--+-------------------------+---------->
   '-SHAREd--=----Yes---'  '-RESETDrives--=--+-Yes-+-'   
                                             '-No--'     

>--+-----------------------------+------------------------------>
   '-AUTOLabel--=--+-No--------+-'   
                   +-Yes-------+     
                   '-OVERWRITE-'     

>--+----------------------------+------------------------------->
   '-RELABELSCRatch--=--+-No--+-'   
                        '-Yes-'     

>--+------------------------------+----------------------------><
   '-SERial--=--+-serial_number-+-'   
                '-AUTODetect----'

Parameters

library_name (Required)

Specifies the name of the library to be updated.

LIBType (Required)

Specifies the library type that you want to update to. Possible values are:

VTL

Specifies that the library has a SCSI-controlled media changer device that is represented by a Virtual Tape Library. To mount volumes on drives in this type of library, Tivoli® Storage Manager uses the media changer device. This value is effective when specified for libraries with a current library type of SCSI.

Note: Selecting the VTL library type assumes that the following conditions are true:

Your environment does not include mixed-media
Paths are defined between all drives in the library and all defined servers, including storage agents, that use the library

If both conditions are not met, performance can degrade to the same levels as the SCSI library type especially during times of high stress when most drives are in use concurrently.

SCSI

Specifies that the library has a SCSI-controlled media changer device. To mount volumes on drives in this type of library, Tivoli Storage Manager uses the media changer device. This value is effective when specified for libraries with a current library type of VTL.

SHAREd

Specifies that this library is shared with other servers in a storage area network (SAN). You must issue this command from the server defined as the primary library manager for the shared library. This parameter is required for libraries defined to a library manager and for libraries used for NDMP operations. Specify SHARED=YES to update a library that is not currently shared.

Important: If a library has a path from a data mover (such as a NAS file server) but no connection to the server, the library cannot be shared with another server.

RESETDrives

Specifies whether the server preempts a drive reservation with persistent reserve when the server is restarted or when a library client or storage agent reconnection is established.

AIX operating systems Windows operating systems If persistent reserve is not supported, the server completes a reset of the path to the target device.

HP-UX operating systems Linux operating systems Oracle Solaris operating systems If persistent reserve is not supported, the server is not able to reset the path to the target device.

Support for persistent reservation has the following limitations:

If you are using the Tivoli Storage Manager device driver, persistent reserve is only supported on some tape drives. See Technote 1470319 for details.
If you are using the IBM® device driver, persistent reserve must be enabled at the device driver level. See the IBM Tape Device Drivers Installation and User's Guide for information about driver configuration.
If you are using a virtual tape library that is emulating a supported drive, it might not support persistent reserve.

The following table describes the three possible configurations for drives that are attached to NAS devices.

Table 1. Configurations for drives that are attached to NAS devices.
Library device configuration	The behavior for persistent reserve
The library device is attached to the Tivoli Storage Manager server, and the tape drives are shared by the server and the NAS device.	Drive reservation preemption is supported when the NAS device supports persistent reserve and it is enabled. For more information about setting persistent reserve, see the documentation for your NAS device.
The library device is attached to the Tivoli Storage Manager server and the tape drives are accessed only from the NAS device.	Drive reservation preemption is not supported. If you enable persistent reserve on the NAS device for these drives and a reservation is set by the NAS device but never cleared, you must use another method to clear the reservation.
The library device is attached to the NAS device and accessed indirectly by NDMP (network data management protocol), and the tape drives are accessed only from the NAS device.	Drive reservation preemption is not supported. If you enable persistent reserve on the NAS device for these drives and a reservation is set by the NAS device but never cleared, you must use another method to clear the reservation.

Yes: Specifies that drive preemption through persistent reserve or target reset are used.
No: Specifies that drive preemption through persistent reserve or target reset are not used. The RESETDRIVES parameter must be set to YES in a clustered environment when SHARED=NO.

Yes: Specifies that drive preemption through persistent reserve is used.
No: Specifies that drive preemption through persistent preserve is not used.

Note: A library manager will not be able to break a drive reservation if the system that has the drive reservation is not configured to use persistent reservation.

AUTOLabel

Specifies whether the server attempts to automatically label tape volumes.

To use this option, you must check in the tapes with CHECKLABEL=BARCODE on the CHECKIN LIBVOLUME command.

No: Specifies that the server does not attempt to label any volumes.
Yes: Specifies that the server only labels unlabeled volumes.
OVERWRITE: Specifies that the server attempts to overwrite an existing label. The server overwrites existing labels only if both the existing label and the bar code label are not already defined in any server storage pool or volume history list.

SERial

Specifies the serial number for the library being updated. This parameter is optional. The possible values are:

serial_number: Specifies the serial number for the library being updated.
If a path to this library has already been defined, then the number you enter here is compared to the number detected by Tivoli Storage Manager. If the numbers do not match, the command fails. If a path has not been defined, this serial number is verified when a path is defined.
AUTODetect: Specifies that the serial number is automatically detected and used by Tivoli Storage Manager if a path has already been defined to this library.
If a path to this library has not been defined, then the serial number is not detected.

RELABELSCRatch

Specifies whether the server relabels volumes that have been deleted and returned to scratch. When this parameter is set to YES, a LABEL LIBVOLUME operation is started and the existing volume label is overwritten. This parameter is optional and intended for use with a Virtual Tape Library (VTL).

Note: If you have both virtual and real volumes in your VTL, both types are relabeled when this parameter is enabled. If the VTL includes real volumes, specifying this option might affect performance.

No: Specifies that the server does not relabel volumes that are deleted and returned to scratch.
Yes: Specifies that the server relabels volumes that are deleted and returned to scratch.