Tivoli Storage Manager for Windows: Administrator's Reference

REGISTER LICENSE (Register a New License)

Use the REGISTER LICENSE command to register a new license with the TSM server. Licenses are stored in files 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.

Attention: With the exception of the |ndmp.lic, drm.lic and libshare.lic, you can specify license files in increments of 1, 5, 10, or 50. For example, 10mgsyslan.lic. Use the number parameter to increase the licenses over these specified limits. The nodelock file contains an entry for each license file you register. For performance purposes, register the license files using the increments to minimize the number of license statements in the nodelock file.

Privilege Class

To issue this command, you must have system privilege.

Syntax

                     .-FILE--(license_file)-.
>>-REGister LICense--+----------------------+------------------->
                     '-productpassword------'
 
   .-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 (*). For example, to register all files, enter:
register license file(*.lic)

Note:
The names of the files are not case-sensitive.

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

1mgsyslan.lic, 5mgsyslan.lic, 10mgsyslan.lic, or 50mgsyslan.lic
To license Managed System for LAN. TSM requires this license for each managed system that moves data to and from storage over a local area network (LAN).

1mgsyssan.lic, 5mgsyssan.lic, 10mgsyssan.lic, or 50mgsyssan.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.

1spacemgr.lic, 5spacemgr.lic, 10spacemgr.lic, or 50spacemgr.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. TSM 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.

1domino.lic, 5domino.lic, 10domino.lic, or 50domino.lic
To license each managed system that uses Tivoli Data Protection for Lotus Domino. TSM also requires a Managed System for LAN license if you use a communication protocol other than shared memory.

1ess.lic, 5ess.lic, 10ess.lic, or 50ess.lic
To license each managed system that uses Tivoli Data Protection for ESS. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1essr3.lic, 5essr3.lic, 10essr3.lic, or 50essr3.lic
To license each managed system that uses Tivoli Data Protection for ESS R/3. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1emcsymm.lic, 5emcsymm.lic, 10emcsymm.lic, or 50emcsymm.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.

1emcsymr3.lic, 5emcsymr3.lic, 10emcsymr3.lic, or 50emcsymr3.lic
To license each managed system that uses Tivoli Data Protection for EMC Symmetrix R/3. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1informix.lic, 5informix.lic, 10informix.lic, or 50informix.lic
To license each managed system that uses Tivoli Data Protection for Informix. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1lnotes.lic, 5lnotes.lic, 10lnotes.lic, or 50lnotes.lic
To license each managed system that uses Tivoli Data Protection for Lotus Notes(R). |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1mssql.lic, 5mssql.lic, 10mssql.lic, or 50mssql.lic
To license each managed system that uses Tivoli Data Protection for MS SQL Server. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1msexch.lic, 5msexch.lic, 10msexch.lic, or 50msexch.lic
To license each managed system that uses Tivoli Data Protection for MS Exchange. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1oracle.lic, 5oracle.lic, 10oracle.lic, or 50oracle.lic
To license each managed system that uses Tivoli Data Protection for Oracle. |TSM also requires a Managed System for LAN license if you use a |communication protocol other than shared memory.

1r3.lic, 5r3.lic, 10r3.lic, or 50r3.lic
To license each managed system that uses Tivoli Data Protection for R/3. |TSM 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). TSM requires this license on a source server and not on a target server.

1library.lic or 5library.lic
To license Managed Library. This is required for each library in the Extended Device Category that is managed by a TSM server.

libshare.lic
To license the Tape Library Sharing feature. This is required on a TSM 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.

productpassword
Specifies the product password from the enrollment certificate for the selected feature to be registered.

Number
Specifies the number of licenses. The default number of licenses is 1.
Note:
Check the documentation that comes with your server for additional license file names.

Examples

Tasks

Register the Tivoli Disaster Recovery Manager support

Command:
register license file(drm.lic)

Register TSM for 510 managed systems that move data over a local area network. Use the license increments together with the NUMBER parameter to have TSM create only 11 entries in the nodelock file instead of 510 individual entries.

Command:
register license file(50mgsyslan.lic) number=10
register license file(10mgsyslan.lic) 

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

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

Related Commands

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