Tivoli Header

Administrator's Reference

REGISTER LICENSE (Register a New License)

Use the REGISTER LICENSE command to register a new license with the Tivoli Storage Manager server or to change the quantity of registered licenses. You should always specify the entire number of registered licenses when issuing this command. Licenses are stored in files that are called enrollment certificate files. These certificates are files that contain licensing information for the server product.

When registered, the licenses are stored in a file named NODELOCK in the current directory that the server was started from.

Privilege Class

To issue this command, you must have system privilege.

Syntax

>>-REGister LICense--FILE--(license_file)----------------------->
 
   .-Number--=--1------------------.
>--+-------------------------------+---------------------------><
   '-Number--=--number_of_licenses-'
 
 

Parameters

FILE(license_file)
Specifies the name of the enrollment certificate file containing the license to be registered. The specification can contain a filename wildcard (*). Enter the complete file name or a wildcard in place of the file name.
Note:
The names of the files are not case-sensitive.

To register additional clients, specify the names of the following enrollment certificate files:

mgsyslan.lic
To license Managed System for LAN. Tivoli Storage Manager requires this license for each managed system that moves data to and from storage over a local area network (LAN).

mgsyssan.lic
To license Managed System for SAN. This license is required for each storage agent. The Tape Library Sharing feature is required on the server. Tivoli Storage Manager requires this license for each client using server-free data movement.

spacemgr.lic
To license each managed system that uses Tivoli Space Manager. A Managed System for LAN license is also required if you use a communication protocol other than shared memory. Tivoli Storage Manager requires only one Managed System for LAN license if an HSM client and backup-archive client are on the same system with the same node ID.

domino.lic
To license each managed system that uses Tivoli Data Protection for Lotus(R) Domino. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

ess.lic
To license each managed system that uses Tivoli Data Protection for ESS. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

essr3.lic
To license each managed system that uses Tivoli Data Protection for ESS R/3. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

emcsymm.lic
To license each managed system that uses Tivoli Data Protection for EMC Symmetrix. TSM also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

emcsymr3.lic
To license each managed system that uses Tivoli Data Protection for EMC Symmetrix R/3. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

informix.lic
To license each managed system that uses Tivoli Data Protection for Informix. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

lnotes.lic
To license each managed system that uses Tivoli Data Protection for Lotus Notes(R). Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

mssql.lic
To license each managed system that uses Tivoli Data Protection for MS SQL Server. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

msexch.lic
To license each managed system that uses Tivoli Data Protection for MS Exchange. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

oracle.lic
To license each managed system that uses Tivoli Data Protection for Oracle. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

r3.lic
To license each managed system that uses Tivoli Data Protection for R/3. Tivoli Storage Manager also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

drm.lic
To license Tivoli Disaster Recovery Manager (this includes server-to-server virtual volumes for database and storage pool backup). Tivoli Storage Manager requires this license on a source server and not on a target server.

library.lic
To license a Managed Library. This is required for each library in the Extended Device Category or the Advanced Managed Library category, that is managed by a Tivoli Storage Manager server.

Additional information on device categories can be found at the Tivoli Storage Manager Web site: http://www.tivoli.com/support/storage_mgr/tivolimain.html. Follow the links to device information.

libshare.lic
To license the Tape Library Sharing feature. This is required on a Tivoli Storage Manager server that can access a shared library, including the library manager. The Managed Library license is only needed on the library manager.

ndmp.lic
To license Tivoli Data Protection for NDMP. This is required on a server that performs backup and restore operations of a NAS file server that uses Network Data Management Protocol.

Number
Specifies the total number of registered licenses. The default number of licenses is 1. If you enter number=0 for a particular license, the license is unregistered.
Note:
Check the documentation that comes with your server for additional license file names.

Examples

Task

Register the Tivoli Disaster Recovery Manager support

Command:
register license file(drm.lic)

Task

Register all files using a wildcard. The default number of licenses is 1.

Command:
register license file(*.lic)

Task

Register the change in the number of Managed Library licenses from 10 to 20

Command:
register license file(library.lic) number=20

Task

Register Tivoli Storage Manager for 10 Tivoli Data Protection for Lotus Notes clients that will move data over a LAN. Tivoli Storage Manager also requires a Managed System for LAN license.

Command:
register license file(10lnotes.lic)
register license file(10mgsyslan.lic)

Related Commands

Table 229. Commands Related to REGISTER LICENSE

Command Description
AUDIT LICENSES Checks for compliance with defined licenses.
QUERY LICENSE Displays information about licenses and audits.
QUERY STATUS Displays the settings of server parameters, such as those selected by the SET commands.
SET LICENSEAUDITPERIOD Specifies the number of days between automatic license audits.


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