![]() |
![]() |
Use this command to define a library. A library is a collection of one or more drives, and possibly robotic devices (depending on the library type), which can be used to access storage volumes.
A library can only be accessed by one source. This can be either a Tivoli Storage Manager server or a data mover . However, the drives in a library can be accessed by multiple sources.
This section includes syntax diagrams for a number of different library
configurations:
Configuration Task | Syntax Diagram |
---|---|
LAN -- Define a library (MANUAL, SCSI, 349X, EXTERNAL, ACSLS). For a SCSI library that will be used for NDMP operations, see Syntax. | Syntax (Define a Library in Local Area Network) |
SAN -- Define a library ( SCSI, 349X, FILE) to a library manager server. | Syntax (SAN -- Define a Library to a Library Manager) |
SAN -- Define a library (SHARED) to a library client server. | Syntax (SAN -- Define a Library to a Library Client) |
SAN or LAN -- Define a SCSI library that will be accessed by a NAS data mover and directly controlled by Tivoli Storage Manager. | Syntax (Define a Library Controlled Directly by Tivoli Storage Manager) |
SAN or LAN -- Define a SCSI library to be accessed by NAS data mover and controlled through a NAS file server. | Syntax (Define a Library Controlled Through a NAS File Server) |
SAN -- Define an EXTERNAL library to be shared with storage agents. | Syntax (SAN -- Define an EXTERNAL Library Shared with Storage Agents) |
Privilege Class
To issue this command, you must have system privilege or unrestricted storage privilege.
Define a Library in a Local Area Network |
>>-DEFine LIBRary--library_name---------------------------------> .-LIBType--=--MANUAL-----------. >--+------------------------------+---------------------------->< '-LIBType--=--+-MANUAL-------+-' +-SCSI---------+ +-349X--| A |--+ +-EXTernal-----+ '-ACSLS--| B |-' A (349X) .-SCRATCHCATegory--=--301----. |--+----------------------------+-------------------------------> '-SCRATCHCATegory--=--number-' .-PRIVATECATegory--=--300----. >--+----------------------------+-------------------------------| '-PRIVATECATegory--=--number-' B (ACSLS) |--ACSID--=--number---------------------------------------------| |
Library Sharing in a Storage Area Network (but NOT for NDMP
Operations)
SAN -- Define a Library to a Library Manager |
>>-DEFine LIBRary--library_name---------------------------------> .-SHAREd--=--No------. >----LIBType--=--+-349X--| A |-+----+--------------------+----->< +-SCSI--------+ '-SHAREd--=--+-Yes-+-' '-FILE--------' '-No--' A (349X) .-SCRATCHCATegory--=--301----. |--+----------------------------+-------------------------------> '-SCRATCHCATegory--=--number-' .-PRIVATECATegory--=--300----. >--+----------------------------+-------------------------------| '-PRIVATECATegory--=--number-' |
SAN -- Define a Library to a Library Client |
>>-DEFine LIBRary--library_name---------------------------------> >--LIBType--=--SHAREd--PRIMarylibmanager--=--server_name------->< |
Libraries in a Local Area Network or a Storage Area Network and Used
for NDMP Operations
Define a Library Controlled Directly by Tivoli Storage Manager |
>>-DEFine LIBRary--library_name--LIBType--=--SCSI---------------> .-SHAREd--=--No------. >--+--------------------+-------------------------------------->< '-SHAREd--=--+-No--+-' '-Yes-' |
SAN -- Define a Library Controlled Through a NAS File Server |
>>-DEFine LIBRary--library_name--LIBType--=--SCSI---------------> >--SHAREd--=--No----------------------------------------------->< |
SAN -- Define an EXTERNAL Library Shared with Storage Agents |
>>-DEFine LIBRary--library_name--LIBType--=--EXTernal-----------> .-OBEYMOUNTRetention--=--Yes-----. >--LANFree--=--Yes--+--------------------------------+--------->< '-OBEYMOUNTRetention--=--+-Yes-+-' '-No--' |
Parameters
Because Tivoli Storage Manager uses decimal values for the category number and the 349X uses hexadecimal values, both values are provided in the following descriptions.
For more information on specifying a category number, see Administrator's Guide.
In a Managed System for SAN environment, this parameter specifies that STK Automated Cartridge System Library Software (ACSLS) or Library Station software controls the library. The third-party software such as Gresham EDT-DistribuTAPE allows multiple servers to share the library. The drives in this library are not defined to Tivoli Storage Manager. ACSLS identifies the drive for media operations.
See your STK documentation for more information.
When support for 3590 drives in 349X libraries is enabled (by the ENABLE3590LIBRARY server option), Tivoli Storage Manager creates two scratch categories when the library is defined. The first category is for 3490 scratch volumes, and is either the value specified with this parameter, or the default 301 (X'12D'). The second scratch category is for 3590 scratch volumes, and is one greater than the value specified with the SCRATCHCATEGORY parameter. The default value for this second category is 302 (X'12E').
Attention: When you enable 3590 support for a 3494 library shared between Tivoli Storage Manager and other applications, data loss can occur if Tivoli Storage Manager creates a duplicate category for 3590 scratch volumes.
Examples
Task - MANUAL Library
Define a library named MANUALMOUNT with the library type of MANUAL.
Task - SCSI Library in a LAN
Define a library named SCSILIB with a library type of SCSI and a device name of /dev/lb0.
define library scsilib libtype=scsi
define path server1 scsilib srctype=server desttype=library device=/dev/lb0
Task - SCSI Library in a SAN
In a Storage Area Network, two Tivoli Storage Manager servers must share a SCSI library. Define a SCSI library named LTOLIB on a library manager server named CASTOR. The device name of the library is /dev/smc0. Then define the same library on a library client server named POLLUX.
define library ltolib libtype=scsi shared=yes
define path castor ltolib srctype=server desttype=library device=/dev/smc0
On the library client, POLLUX:
define library ltolib libtype=shared primarylibmanager=castor
Task - ACSLS Library
Define a library named ACSLIB with a library type of ACSLS and an acsid of 1.
define library acslib libtype=acsls acsid=1
Task - SCSI Libraries Used for NDMP Operations
A SCSI library named TSMLIB is connected to a Tivoli Storage Manager server. Define that library so that it will be directly controlled by Tivoli Storage Manager and used for NDMP operations.
define library tsmlib libtype=scsi
define path server1 tsmlib srctype=server desttype=library device=/dev/lb0
A SCSI library named NASLIB is connected directly to a NAS file server. Define that library so that it will be controlled by Tivoli Storage Manager through the NAS data mover and used for NDMP operations.
define library naslib libtype=scsi
define path nasdm naslib srctype=datamover desttype=library device=/dev/lb1
Task - EXTERNAL Library in a Managed System for SAN
For a Managed System for SAN configuration, define a library named STKLANFREE with the library type of EXTERNAL. The external library manager executable is located in the /usr/lpp/dtelm/bin/elm directory. Use the mount retention value set in the device class associated with this library.
define library stklanfree libtype=external lanfree=yes obeymountretention=yes
define path server1 stklanfree srctype=server desttype=library externalmanager=/usr/lpp/dtelm/bin/elm
Related Commands
Table 69. Commands Related to DEFINE LIBRARY
Command | Description |
---|---|
AUDIT LIBRARY | Ensures that an automated library is in a consistent state. |
DEFINE DRIVE | Assigns a drive to a library. |
DEFINE PATH | Defines a path from a source to a destination. |
DELETE DRIVE | Deletes a drive from a library. |
DELETE PATH | Deletes a path from a source to a destination. |
DELETE LIBRARY | Deletes a library. |
QUERY DRIVE | Displays information about drives. |
QUERY LIBRARY | Displays information about one or more libraries. |
QUERY PATH | Displays information about the path from a source to a destination. |
UPDATE DRIVE | Changes the attributes of a drive. |
UPDATE LIBRARY | Changes the attributes of a library. |
UPDATE PATH | Changes the attributes associated with a path. |