Tivoli Storage Manager for Windows: Administrator's Reference

UPDATE LIBRARY (Update a Library)

Use this command to update a library.

|This section includes syntax diagrams for a number of different |library configurations:
|

Configuration Task Syntax Diagram
LAN -- Update a library ( SCSI, 349X, EXTERNAL, ACSLS, RSM). For a SCSI library that will be used for NDMP operations, see Syntax. Syntax ( Update a Library on a Local Area Network)
SAN -- Update a library ( SCSI, 349X, FILE) defined to a library manager server. Syntax (SAN -- Update a Library Defined to a Library Manager)
SAN -- Update a library (SHARED) defined to a library client server. Syntax (SAN -- Update a Defined Library to a Library Client)
SAN or LAN -- Update a SCSI library that will be accessed by a NAS data mover and directly controlled by Tivoli Storage Manager. Syntax (Update a Library Controlled Directly by Tivoli Storage Manager)
SAN or LAN -- Update a SCSI library to be accessed by NAS data mover and controlled through a NAS file server. Syntax (Update a Library Controlled Through a NAS File Server)
SAN -- Update an EXTERNAL library to be to be shared with storage agents. Syntax (SAN -- Update an EXTERNAL Library Shared with Storage Agents)

Privilege Class

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

Syntax



Update a Library on a LocalArea Network

>>-UPDate LIBRary--library_name----+-| A (SCSI) |-----+--------><
                                   +-| B (349X) |-----+
                                   +-| C (EXTERNAL) |-+
                                   '-| D (ACSLS) |----'
 
A (SCSI)
 
|--+------------------------+-----------------------------------|
   '-DEVIce--=--device_name-'
 
B (349X)
 
|--+---------------------------------+--------------------------|
   |                 .-,-----------. |
   |           (1)   V             | |
   '-DEVIce--=---------device_name-+-'
 
C (EXTERNAL)
 
|--+-------------------------------+----------------------------|
   '-EXTERNALManager--=--path_name-'
 
D (ACSLS)
 
|--+------------------+-----------------------------------------|
   '-ACSID--=--number-'
 
 

Notes:

  1. Specify one to eight device names.

Syntax

Library Sharing in a Storage Area Network but Not for NDMP Operations

SAN -- Update a Library Definedto a Library Manager

>>-UPDate LIBRary--library_name--+--------------------+--------->
                                 '-SHAREd--=--+-Yes-+-'
                                              '-No--'
 
>----+-| A (SCSI) |-+------------------------------------------><
     '-| B (349X) |-'
 
A (SCSI)
 
|--+------------------------+-----------------------------------|
   '-DEVIce--=--device_name-'
 
B (349X)
 
|--+---------------------------------+--------------------------|
   |                 .-,-----------. |
   |           (1)   V             | |
   '-DEVIce--=---------device_name-+-'
 
 

Notes:

  1. Specify one to eight device names.



SAN -- Update a Library Definedto a Library Client

>>-UPDate LIBRary--library_name--------------------------------->
 
>--+-----------------------------------+-----------------------><
   '-PRIMarylibmanager--=--server_name-'
 
 

|Syntax

|Libraries in a Local Area Network or a Storage Area Network and Used |for NDMP Operations
|
|

Update a Library ControlledDirectly by Tivoli Storage Manager

>>-UPDate LIBRary--library_name--+------------------------+----->
                                 '-DEVIce--=--device_name-'
 
>--+--------------------+--------------------------------------><
   '-SHAREd--=--+-No--+-'
                '-Yes-'
 
 


|
|

SAN -- Update a Library ControlledThrough a NAS File Server

>>-UPDate LIBRary--library_name--+---------------+-------------><
                                 '-SHAREd--=--No-'
 
 

|Syntax


|
|

SAN -- Update an EXTERNAL Library Sharedwith Storage Agents

>>-UPDate LIBRary--library_name--+---------------------+-------->
                                 '-LANFree--=--+-Yes-+-'
                                               '-No--'
 
>--+--------------------------------+--------------------------->
   '-OBEYMOUNTRetention--=--+-Yes-+-'
                            '-No--'
 
>--+-------------------------------+---------------------------><
   '-EXTERNALManager--=--path_name-'
 
 

Parameters

library_name (Required)
Specifies the name of the library to be updated.

DEVIce
Specifies the new names of the devices that access the library's robotic mechanism. For example, you might specify lb3.0.0.0 as the device name. This parameter is not valid for MANUAL, EXTERNAL, or ACSLS libraries. If the library type is SCSI, only one device name is allowed. If the library type is 349X, 1-8 device names are allowed. For additional information, see the Administrator's Guide.

|To remove an existing device name, specify a null string ("") for |the name. If a null string is specified, the library cannot be accessed |from the server. However, if a path is defined with the DEFINE PATH |command, the library can be accessed. You cannot remove an existing |device name by specifying a null string if SHARED=YES is defined for the |library.

Note:
|You cannot update the device name if a path from a data mover to the |library already exists. |

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. The possible values are:

Yes
Specifies that this library is shared with other servers.

No
Specifies that this library is not shared with other servers.
Note:
|You cannot change the SHARED attribute from YES to NO if the library |contains private volumes that are owned by other servers. You cannot |change the SHARED attribute from NO to YES unless the server can access the |library. |If a library has only a path from a data mover (such as a NAS file |server) and no connection to the server, the library cannot be shared with |another TSM server over a SAN. |

PRIMarylibmanager
Specifies the name of the server that is responsible for controlling access to library resources. You must define this server with the DEFINE SERVER command before you can use it for a primary library manager.

EXTERNALManager
Specifies a new path name for an external library manager. This parameter is optional and only applies to the EXTERNAL library type.

ACSID
Specifies the number of this STK library assigned by the ACSSA (Automatic Cartridge System System Administrator). This can be a number from 1 to 64. Issue QUERY ACS on your system to get the number for your library ID. See your STK documentation for more information.

|LANFree
|Specifies whether the external library is used for LAN-free |operations. The default is NO. |

|Yes
|Specifies that this library is used for LAN-free data movement.

|No
|Specifies that this library is not used for LAN-free data movement. |

|OBEYMOUNTRetention
|Specifies whether the server uses the value set for mount retention in the |device class associated with this library. The default is NO. |

|Yes
|Specifies that the device class mount retention specification is valid and |that the mounted volume should be retained for the specified period.

|No
|Specifies that the device class mount retention specification is to be |ignored. |

Examples

Task

Update a SCSI library named SCSILIB with a new device name.

Command:
update library scsilib device=lb4.0.0.0

Task

Update a 3494 shared library named 3494LIB2 with new device names.

Command:
update library 3494lib shared=yes device=lb3.0.0.0,lb4.0.0.0,lb5.0.0.0

Task

Update an ACSLS library named ACSLSLIB with a new ID number.

Command:
update library acslslib acsid=1

Task

Update an external library named EXTLIB with a new media manager path name.

Command:
update library extlib externalmanager=c:\server\mediamanager

Related Commands

Table 321. Commands Related to UPDATE LIBRARY

Command Description
AUDIT LIBRARY Ensures that an automated library is in a consistent state.
DEFINE DRIVE Assigns a drive to a library.
DEFINE LIBRARY Defines an automated or manual library.
DELETE DRIVE Deletes a drive from a library.
DELETE LIBRARY Deletes a library.
QUERY DRIVE Displays information about drives.
QUERY LIBRARY Displays information about one or more libraries.
UPDATE DRIVE Changes the attributes of a drive.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]