Utility: licman

Syntax

licman -c -s server_host_id -m server_machine_type

licman -i -p product -v version -k license_keys
   {-n host_id -m machine_type}

licman -i -p product -v version -z license_keys
   {-n host_id -m machine_type}

licman -d -k license_keys

licman -d -z license_keys

licman -l

licman -L

licman -u

Description

A utility program for creating and maintaining Fire license files.

Parameters

None

Switches

Notes

A host id is a number which uniquely identifies a workstation. The utility getnodeid, supplied with the installation, may be used to determine the host id for a particular workstation.

Machine types currently recognized are:

Upper or lower case machine types are accepted.

License keys consist of hexadecimal numbers which are obtained from licensing authorities. When license keys are issued, they will normally be accompanied by the licman command to be used for insertion into the license file. Keys may be specified with or without spaces between the groups of numbers.

If the network license server (mxserver) is running when the license file is updated, it will not know of any changes made to the license file because it pre-processes the license file when it starts. Once changes to a license file have been made, the command licman -u should be issued to inform the server that it should reprocess the license file.

Listings are output to stdout.

Examples

The following will create a license file ($MXSITE/fire.lic) and initialize it for the network license server host (a SUN Sparc) whose host ID is 510006d9.

licman -c -s 510006d9 -m sparc

The following commands add 2 licenses, the first insertion being node-locked to a Sun 4 workstation.

licman -i -p mxserver -v 2 -n 57a603c5 -m sun4 \ 
    -k 1234 5678 9abc def0 4321
licman -i -p fire -v 2 -k dead beef feed 90a0 abbe

The following will produce a full license file contents listing on stdout.

licman -l

The following enables easy reconstruction of the license file in case of accidental deletion, by directing output of licman commands to a backup shell script file

licman -L > licenses_backup.bat

This would be appropriate for a Windows system. We would use a .sh extension on a Unix system.

The following would rebuild the license file again from the script.

licenses_backup.bat

The following will send a message to the running server that the license file has been updated, and any changes will then come into effect.

licman -u

The following will delete a license form the license file and send an update message to the running server.

licman -d -k 1234 5678 9abc def0 4321
licman -u

See Also

Utilities:

applib, getnodeid, mxman, mxserver