A.9.1. License administration tools

The lmdown, lmremove, and lmreread commands are privileged. If you started lmgrd with the -p 2 switch then you must be a license administrator to run any of these three utilities.

A license administrator is a member of the UNIX lmadmin group or, if that group does not exist, a member of group 0.

In addition, lmgrd -x can disable lmdown and/or lmremove.

All utilities take the following arguments:

-v

print version and exit.

-c license_file

operate on a specific license file.

lmchecksum

lmchecksum [-k] [-c license_file_name]

The lmchecksum utility performs a checksum of a license file. Use it to check for data entry errors in your license file. lmcksum prints a line-by-line checksum for the file as well as an overall file checksum. If the license file contains cksum=nn attributes, the bad lines are indicated automatically.

This utility is particularly useful if you received your license by Fax and typed the file, because of the possibility of data entry errors.

Use the -k switch to force the checksum to be case-sensitive.

By default lmchecksum checks the contents of license.dat in the current directory. Use the -c switch to check a different file.

lmdiag

lmdiag [-c license_file_list] [-n] [feature]

This utility allows you to check for problems, when you cannot check out a license.

-c license_file_list

Path to file(s) to check. If more than one file, use a colon separator.

-n

Run in non-interactive mode.

feature

Diagnose this feature only. If you do not specify a feature, all lines of the license file are checked.

The lmdiag program first tries to check the feature. If this fails, the reason for failure is printed.

If the check failed because lmdiag could not connect to the license server then you can run extended connection diagnostics. These diagnostics try to check the validity of the port number in the license file. lmdiag displays the port numbers of all ports that are listening, and indicates which ones are lmgrd processes. If lmdiag finds the armlmd daemon for the for feature being tested, it displays the correct port number to use in the license file.

lmdown

lmdown [-c license_file_list] [-vendor name] [-q]

The program allows you to shut down gracefully all license daemons on all nodes (both lmgrd and all vendor daemons).

-c license_file_list

Path to file(s) to be shut down. If more than one file, use a colon separator.

-vendor name

If you specify a vendor name, only that vendor daemon is shut down, and lmgrd is not shut down.

-q

Do not issue the Are you sure? prompt.

You should restrict the execution of lmdown to license administrators, by starting lmgrd with the -p -2 switch, as shutting down the server causes loss of licenses.

To disable lmdown, the license administrator can use lmgrd -x lmdown.

To stop and restart a single vendor daemon, use lmdown -vendor name, then lmreread -vendor name.

lmhostid

lmhostid

This program returns the correct host ID on any computer supported by FlexLM.

lmremove

lmremove [-c license_file_list] feature user host display

This utility allows you to remove a single user license for a specific feature. For example, when a user is running the software and the host crashes, the user license is sometimes left checked out and unavailable to other users. lmremove frees the license and makes it available to other users.

-c license_file_name

The full pathname of the license file to be used. If this is omitted the LM_LICENSE_FILE environment variable is used instead.

feature

The name of the feature the user has checked out.

user

The name of the user.

host

The name of the host the user was logged into.

display

The name of the display where the user was working.

You can obtain the user, host, and display information from the output of lmstat -a.

If the application is active when its license is removed by lmremove, it checks out the license again at the next application heartbeat.

lmreread

lmreread [-vendor name] [-c license_file_list]

This utility causes the license daemon to reread the license file, and start any new vendor daemons that have been added. All the existing daemons are signalled to reread the license file to check for any changes in their licensing information.

-vendor name

If you specify a vendor name, only that vendor daemon rereads the license file. If the vendor daemon is not running, lmgrd starts it.

To disable lmreread, the license administrator can use lmgrd -x lmreread.

lmreread does not cause server host names or port numbers to be reread from the license file. To make any changes to those items effective, you must restart lmgrd.

To stop and restart a single vendor daemon, use lmdown -vendor name, then lmreread -vendor name.

lmstat

lmstat [-a] [-A] [-c license_file_list] [-f [feature]] [-i [feature]] [-s [server]] [-S [daemon]] [-t value]

This utility helps you to monitor the status of all network licensing activities, including:

  • which daemons are running

  • users of individual features

  • users of features served by specific daemons.

The optional arguments are:

-a

Displays all information.

-A

Lists all active licenses.

-c license_file_list

Uses all the license files listed.

-f [feature]

List users of a specific feature.

-i [feature]

Print information about the named feature, or all features if feature is ommitted.

-s [server]

Display status of server node(s).

-S [daemon]

List all users and features of a specific daemon.

-t value

Set the lmstat timeout to value.

lmver

lmver [filename]

This utility reports the FlexLM version of a specific library or binary file.

Copyright © 1997, 1998 ARM Limited. All rights reserved.ARM DUI 0040D
Non-Confidential