lmadmin License Administration Functions

lmadmin provides some of the license administration functions previously provided by the command-line based license administration utilities or lmtools on the Windows platform. The following table lists functions provided within lmadmin that replace those provided by the license administration utilities.

lmadmin License Administration Functions

lmadmin Function

Description

Replaces Utility

Dashboard - Licenses

Displays details of licenses rights available and in use.

lmstat

Vendor Daemon Configuration - Administer - Stop

Stops the vendor daemon.

lmdown (in some usage cases)

Vendor Daemon Configuration - Administer - Reread License Files

Rereads license rights from license files included in the lmadmin configuration. Required only when the content of a license file is updated.

lmreread (see also Changes in lmreread Behavior when Using lmadmin)

Vendor Daemon Configuration - Administer - Rotate Report Logs

Switches the report log to a new file name.

lmswitchr

Server Configuration - Stop Server

Stops the license server. Note that lmadmin’s default setting enables this button. To disable the button, start lmadmin with the -allowStopServer No argument.

lmdown (in some usage cases)

The following table details which command-line utilities may no longer be required and which utilities are required when using lmadmin.

lmadmin Use of License Administration Utilities

Utility

Required when using lmadmin

lmborrow

Yes, if using license rights in license files and borrow capability.

lmdiag

Yes, to diagnose license checkout problems.

lmdown

Not normally required.

lmhostid

Not normally required for lmadmin as it displays information about the system it is running on that includes the various identities normally used as hostids. Required for determining the hostids of client systems.

lminstall

Yes, converts license files between different formats.

lmlicvalidator

Not normally required.

lmnewlog

Yes, if you use this function instead of lmswitchr to change to a new report log because you do not want to edit the report log file name in the options file.

lmpath

Yes, allows users direct control over license file path settings.

lmremove (in License File–Based Licensing)

Yes, releases a hung license to the pool of free licenses. Note that lmadmin’s default setting disables the operation of lmremove. To enable lmremove, start lmadmin with the ‑allowLicenseReclaim argument.

lmreread

Not normally required. See also Changes in lmreread Behavior when Using lmadmin.

lmstat

Only required to show additional information (such as borrow or reservations).

lmswitch

Yes, controls debug log location and size.

lmswitchr

Not required.

lmver

Yes, reports the version of a library or binary file. Note that you can determine the version of lmadmin by starting it with the -version argument.

Changes in lmreread Behavior when Using lmadmin

Normally lmreread is not required when using lmadmin, however if you use lmreread with lmadmin the following use cases are not supported:

Using lmreread to restart a vendor daemon—When using lmgrd you can shut down a vendor daemon using lmdown and then use the lmreread command to restart the vendor daemon. The following sequence of commands will result in an error when using lmadmin:

lmdown -vendor demo

lmreread -vendor demo

Using lmreread to load and start a new vendor daemon—You can start lmgrd with a license file that specifies a vendor daemon and then replace this license file with one that includes information about a second vendor daemon. When lmreread is run, this second vendor daemon will be started. Using lmreread in this way with lmadmin will not load or start the vendor daemon. When using lmadmin, load and start a new vendor daemon as follows:
1. To import a license file for the vendor daemon, go to the Administration page, open the Vendor Daemon Configuration tab, and click Import License.
2. To start the vendor daemon, go to the Administration page, open the Vendor Daemon Configuration tab, and click Administer for the specific vendor daemon. Click Start.