Tivoli Header

Administrator's Reference

REGISTER LICENSE (Register a New License)

Use this command to register new licenses 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 enrollment certificate files. The enrollment certificate files contain licensing information for the server product.

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
Specifies the name of the enrollment certificate file containing the license to be registered. The specification can contain a wildcard (*). Enter the complete file name or a wildcard in place of the file name.
Note:
The file names are case-sensitive.

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

drm.lic
License for Tivoli Disaster Recovery Manager (this includes server-to-server virtual volumes for database and storage pool backup). This is required on a source server and not on a target server.

spacemgr.lic
To license each managed system that uses Tivoli Space Manager. Tivoli Storage Manager also requires a Managed System for LAN license 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.

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. Tivoli Storage Manager requires this license for each storage agent. The Tape Library Sharing feature is required on the Tivoli Storage Manager server.

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.

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.

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.

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.

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.

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.

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. Tivoli Storage Manager 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.

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.

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.

Examples

Task

Register Tivoli Storage Manager for Tivoli Disaster Recovery Manager

Command:
register license file=drm.lic

Task

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

Command:
register license file=*

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 20 managed systems that move data over a local area network.

Command:
register license file=mgsyslan.lic number=20

Task

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

Command:
register license file=lnotes.lic number=10
register license file=mgsyslan.lic number=10

Related Commands

Table 225. 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 ]