Personal tools
Document Actions
chap6.htm
Table of Contents * Index * Previous Chapter * Next Chapter
Chapter 6 License Administration Tools
FLEXlm provides utilities for the license administrator to help manage the licensing activities on the network. These utilities are:
- lmcksum (v2.4 or later) - prints license checksums. (page 42)
- lmdiag (v4.0 or later) - diagnoses license checkout problems. (page 42)
- lmdown - gracefully shuts down all license daemons (both lmgrd and all vendor daemons) on the license server node (or on all three nodes in the case of redundant servers). (page 43)
- lmgrd - the main daemon program for FLEXlm. (page 44)
- lmhostid - reports the hostid of a system. (page 45)
- lminstall - install a decimal format license. (page 45)
- lmremove - removes a single user's license for a specified feature. (page 46)
- lmreread - causes the license daemon to reread the license file and start any new vendor daemons. (page 47)
- lmstat - helps you monitor the status of all network licensing activities. (page 47)
- lmswitch (VMS only) -switches the debug logfile. (page 48)
- lmswitchr - switches the report log file. (page 48)
- lmver - reports the FLEXlm version of a library or binary file. (page 49)
Beginning in
FLEXlm v2.4, all
FLEXlm utility programs (except
lmgrd) are packaged
as a single executable called
lmutil. lmutil can either be installed as the individual
commands (either by creating links to the individual command names, or making
copies of lmutil as the individual command names), or the commands can be run as
`lmutil command', e.g. `lmutil lmstat', or `lmutil lmdown'. On Windows or
Windows/NT systems, the `lmutil command_name' form of the commands are
available. There is also a Windows version of these commands - see
Section 6.13.1,
`License Administration Tools - LMTOOLS for Windows,
The
lmcksum program (FLEXlm v2.4 or later) will perform a checksum of a license
file. This is useful to verify data entry errors at your location.
lmcksum will print a line-by-line checksum for the file as well as an overall file checksum.
lmcksum takes the
`-k' switch to force the encryption key checksum to be case-sensitive.
lmcksum will ignore all fields that do not enter into the encryption key computation;
thus the server node name and port number, as well as the daemon pathname and
options file names are not checksummed. In addition,
lmcksum will treat non-case
sensitive fields correctly (in general,
lmcksum is not case-sensitive).
lmcksum takes an optional daemon name; if specified, only license file lines for the
selected daemon are used to compute the checksums.
For FEATURE lines that contain
ck=nnn, lmcksum prints simply OK or BAD.
Usage is:
Example output is:
189: SERVER speedy 08002b32b161 2837
166: DAEMON xyzd C:\flexlm\xyzd.exe
8: FEATURE f1 xyzd 1.000 01-jan-99 0 3B2BC33CE4E1B8F3A0BF""
OK: 231: FEATURE f2 xyzd 1.0 01-jan-0 1 8B1C30015351B7737F5E \
DUP_GROUP=HD ck=231
109: (overall file checksum)
lmdiag (FLEXlm v4.0 or later) allows
you to diagnose problems when you cannot
check out a license.
Usage is:
If no
feature is specified,
lmdiag will operate on all features in the license file(s)
in your path.
lmdiag will first print information about the license, then attempt to
check out each license. If the checkout succeeds,
lmdiag will indicate this. If the
checkout fails,
lmdiag will give you the reason for the failure. If the checkout fails
because
lmdiag cannot connect to the license server, then you have the option of
running `extended connection diagnostics'.
These extended diagnostics attempt to connect to each port on the license server node,
and can detect if the port number in the license file is incorrect.
lmdiag will indicate
each port number that is listening, and if it is an
lmgrd process,
lmdiag will indicate
this as well. If
lmdiag finds the vendor daemon for the feature being tested, then it
will indicate the correct port number for the license file to correct the problem.
See Also:
Appendix B, `FLEXLM_DIAGNOSTICS' on page 56.
The
lmdown utility allows for the graceful shutdown of all license daemons (both
lmgrd and all vendor daemons) on all nodes.
Usage is:
You may want to protect the execution of
lmdown, since shutting down the servers
causes users to lose their licenses. See the `-p
See Also:
Section 6.8, `lmreread,
The -x lmdown and -x lmremove options are available in
FLEXlm v4.0 and later.
The
lmhostid utility reports the hostid of a system.
Usage is:
The output of this command looks as follows:
With the `-n' argument, no header is printed; only the hostid.
See
Appendix A, `Hostids for FLEXlm-Supported Machines'.
New in version 6,
lminstall is designed primarily for typing in
decimal format licenses
to generate a readable format license file.
Usage is:
Normally, lminstall is used with no arguments; you are prompted for the name of the
output license file. The default name is today's date in
yyyyddmm.lic format. The file
should be moved to the application's default license file directory, if specified by the
software vendor. Otherwise, use LM_LICENSE_FILE or
VENDOR_LICENSE_FILE
to specify the directory where the *.lic files are located.
Decimal format input is verified by checksum of each line.
To finish entering, type `q' on a line by itself, or enter 2 blank lines.
If
infile is a dash (
lminstall can alternatively be used to convert licenses between decimal and readable
format, and between different versions of
FLEXlm license formats.
To convert from readable to decimal:
To convert to
FLEXlm Version 2 format:
Conversion errors are reported as necessary. lminstall has a limit of 1000 lines of input.
The
lmremove utility allows you to remove a single user's license for a specified
feature. This is only needed when a client node crashes, since that's the only condition
where a license is not automatically freed. If the application is active, it will re-checkout the license after it is freed by lmremove.
Usage is:
The
user host display port and handle
information must be obtained from the output
of
lmstat -a.
lmremove removes all instances of
user on
host on
display from usage of
feature. If the
optional `-c
file' is specified, the indicated file is used as the license file.You should
protect the execution of
lmremove,
since removing a user's license can be disruptive.
See the `-p
or
When removing by handle, if licenses are grouped as duplicates, all duplicate licenses
will also be removed.
The
lmreread utility causes the license daemon to reread the
license file and start
any new vendor daemons that have been added. In addition, all running daemons will
be signaled to reread the license file for changes in feature licensing information.
Usage is:
The license administrator may want to protect the execution of
lmreread. See the `-p
lmreread does not cause the vendor daemon to reread the options file. For options file
changes to take effect, lmgrd must be stopped (lmdown) and restarted.
See Also:
Section 6.8, `lmreread,' on page 47.
The
lmstat utility helps you monitor the status of all network licensing activities.
Usage is:
The
lmswitch command is available on VMS only.
The
lmswitch utility switches the debug log file for the daemon serving the specified
feature while the daemon is running.
Usage is:
Of course, for this syntax to work,
lmswitch needs to be installed as a foreign
command.
The new logfile will be opened for write, rather than append, so it is possible to
`switch' to the same filename in order to be able to view the old log file.
The
lmswitchr utility switches the report writer (REPORTLOG) log file. It will also
start a new REPORTLOG file if one does not already exist.
Usage is:
lmswitchr does not work with
FLEXlm v3.0 vendor daemons. Ask your vendor for a
later version of their vendor daemon.
The
lmver utility reports the
FLEXlm version of a library or binary file.
Usage is:
For example if you have an application called `spell' type:
Alternatively, on Unix systems, you can use the following commands to get the
FLEXlm version of a binary:
For the 32 Bit Windows Platforms, an
LMTOOLS.EXE Windows program is
provided. It has the same functionality as listed in the previous sections but is
graphically-oriented. Simply run the program and choose a button for the functionality
required. Refer to the previous sections for information about the options of each
feature. The command line interface is replaced by pop-up dialogs that can be filled
out. The central EDIT field is where the license file path is placed. This will be used
for all other functions and replaces the `-c
license_file' argument in lmutil.
The HOSTID button displays the hostid's for the computer on which the program is
running. The TIME button prints out the system's internal time settings, intended to
diagnose any time zone problems. The TCP Settings button is intended to fix a bug in
the Microsoft TCP protocol stack which has a symptom of very slow connections to
computers. After pressing this button, the system will need to be rebooted for the
settings to become effective.
The
FLEXlm control panel, FLEXLM.CPL, is an applet that installs into the Control
Panel of Windows and is used to control the execution of the
FLEXlm license manager.
If the software you are installing includes the Control Panel, it will be installed in your
Windows System Directory.
The library LMGR325B.DLL needs to be available for FLEXLM.CPL. In this
example it is placed in the same directory, but it could be placed anywhere in the
system search path.
LMGRD.EXE can be run manually or using the Control Panel.
FLEXlm for Windows
comes with a Control Panel applet for controlling LMGRD.EXE without using the
DOS prompt.
To start the
FLEXlm Control Panel, open the Control Panel and double-click on the
FLEXlm License Manager icon
From the Control tab you can start, stop, and check the status of your license server.
Select the Setup tab to enter information about your license server.
The Service Name of `FLEXlm License Manager' is the default (for backwards
compatibility). You should change this to a name that your vendor recommends.
Complete the form to configure
lmgrd to serve licenses.
The information you enter is stored in the registry under the service name you created:
Select the
Control tab and click the
Start button to turn on your license server.
LMGRD.EXE will be launched as a background application with the license file and
debug log file locations passed as parameters.
If you want LMGRD.EXE to start automatically, select the `Use NT Services' box and
LMGRD.EXE will be installed as an NT service. You can then use the NT's Services
control panel to adjust the start/stop behavior of LMGRD.EXE. Since NT services do
not have command line parameters, LMGRD.EXE, when started as a service, locates
its service name under `FLEXlm License Manager' in the registry and from there
recovers the license file and log file locations. Multiple instances of LMGRD.EXE can
be run as services provided each occurrence has a different service name.
You can switch back and forth between different instances of LMGRD.EXE by using
the
Setup tab and changing the selection in `Service Name'. This is only necessary if
you have more than one product licensed with
FLEXlm.
The remaining tabs in the control panel allow you a subset of control similar to the
LMUTIL.EXE program. The Licenses tab provides information about the license file
and the Advanced tab allows you to perform diagnostics and check versions.
The behavior of the control panel applet FLEXLM.CPL is almost identical under
Windows 95 and NT. FLEXLM.CPL is located in the Windows\System directory. If
you are starting LMGRD.EXE manually from the
Control tab, there is no difference
between the two. But, since services are not available on Windows 95, the
Use NT
Service check box is not available. Instead a
Start Server at Power-UP check box
gives you the option to start the server when the system is booted.
On Windows 95,
FLEXlm makes use of a registry feature that launches programs
automatically. The `Microsoft\Windows\CurrentVersion\RunServices' registry is
used to launch the program LMGRD95.EXE at power-on. This program scans the
`FLEXlm License Manager' area of the registry and launches an instance of
LMGRD.EXE for each service-name it finds.
If someone switches users (i.e. selects `shutdown' and chooses `close all programs
and log on as a different user') on Windows 95, all instances of LMGRD.EXE will
be terminated (see Microsoft documentation). This is one of the reasons we do not
recommend using Windows 95 as a license server.
Table of Contents
* Index
* Previous Chapter
* Next Chapter
on page 49</a>.<p>
<h4>Arguments valid for all lmutil utilities</h4>
<dl><dt>-c
<I>license_file</I><dd>Most
<I>lmutil</I> utilities need to know the path to the license
file. This can be specified with a `-c
<I>license_file</I> argument,
or by setting the LM_LICENSE_FILE environment
variable. Otherwise, the default location is used.6.1 lmcksum
lmcksum [-c license_file]
lmcksum - Copyright (C) 1989, 1997 GLOBEtrotter Software, Inc.
lmcksum: using license file"/usr/local/flexlm/licenses/license.dat"
6.2 lmdiag
lmdiag [-c license_file] [-n] [feature]
6.3 lmdown
lmdown [-c license_file] [-vendor name] [-q]
or the `-x options in
Section 6.4,
`lmgrd, on page 44</a> for details about securing access to
<TT>lmdown</TT>.<p>
<p>
If lmdown encounters more than one server (for example if -c specifies a directory with
many *.lic files) a choice of servers to shutdown is presented.<p>
<p>
To stop and restart a single vendor daemon, use lmdown -vendor name, then, use
lmreread -vendor name, which restarts the vendor daemon.<p>
<p>
When shutting down redundant servers, there is a one-minute delay before the servers
shut down. Do
<B>not</B> use `kill -9 to shut down the license servers. on page 47</a>.<p>
<a name="14947: 1head: 6.1 lmgrd"></a><a name="_IX_100"></a><a name="6.4"></a><h2>6.4 lmgrd</h2>
<p>
<TT>lmgrd</TT> is the main daemon program for
FLEXlm<I></I>. When you invoke
lmgrd<I></I>, it looks
for the license file which contains the information about vendors and features. On Unix
systems, it is strongly recommended that lmgrd be run as a non-privileged user (not
<I>root</I>).<p>
<p>
Usage is:<p>
<pre>lmgrd<I></I> [<I> -</I>app ] [ -c <I>license_file</I> ] [ -t <I>timeout_interval</I> ] [ -l <I>logfile </I>]
[ -s <I>timestamp_interval</I> ] [ -2 -p ] [ -v ] [ -x lmdown ] [ -x lmremove ]</pre>
</ol></ul><p>
<p>
<dl><dt>-app<dd>Required for Windows/NT systems when run as a
command, but not used when run as a service.<dt>-c
<I>license_file</I><dd>Use the license file named.<dt>-t
<I>timeout_interval</I><dd>Sets a timeout interval, in seconds, during which redundant
daemons must complete their connections to each other.
The default value is 10 seconds. A larger value may be
desirable if the daemons are being run on busy systems or
a very heavily loaded network.<dt>-l
<I>logfile</I><dd>Write the debug log to
<I>logfile</I>.<dt> -s
<I>timestamp_interval</I><dd>Specifies the logfile timestamp interval, in minutes. The
default is 360 minutes.<dt>-2 -p<dd>Restricts usage of
<TT>lmdown</TT>,
<TT>lmreread</TT>, and
<TT>lmremove
</TT>to a
FLEXlm<I></I> administrator who is by default root. If there
a
<I>Unix</I> group called `lmadmin then use is restricted to
only members of that group. If root is not a member of this
group, then root does not have permission to use any of the
above utilities. The `-p' option is available in
FLEXlm
v2.4 and later.s version number and copyright and exits.<dt>-x lmdown<dd>Disallow the lmdown command (no user can run lmdown).
If lmdown is disabled, you will need to stop lmgrd via
`<TT>kill
</TT><I>pid</I> (Unix) or CTRL-ALT-DEL and stop the
lmgrd and vendor daemon processes (Windows 95). On
Unix, be sure the kill command does not have a -9
argument.6.5 lmhostid
lmhostid [-n]
lmhostid - Copyright (c) 1989, 1997 Globetrotter Software, Inc.
The FLEXlm hostid of this machine is"69021c89"
6.6 lminstall
lminstall [-i {infile | -}] [-o outfile] \
[-overfmt {2 | 3 | 4 | 5 | 5.1 | 6}] [-odecimal]
-), it takes input from stdin.When -i is used, default output is
stdout; otherwise if -o is not specified, lminstall prompts the user for an output file
name.lminstall As A Conversion Tool:
% lminstall -i infile -o outfile -odecimal
% lminstall -i infile -o outfile -verfmt 2
6.7 lmremove
lmremove [ -c file ] feature user host display
or
lmremove [ -c file ] -h feature host port handle
or the `-x options in
Section 6.4, `lmgrd, on page 44</a> for details about
securing access to
<TT>lmremove</TT>.<p>
<p>
The
<TT>-h</TT> variation uses the serverhost, port, and license handle, as reported by
<TT>lmstat -a</TT>. Consider this example
<TT>lmstat
-a</TT> output:<p>
<pre>joe cloud7 /dev/ttyp5 (v1.000) (cloud9/7654 102), start Fri 10/29 18:40</pre>
</ol></ul><p>
In this example, the serverhost is `cloud9, the port is `7654' and the license handle
is 102. To remove this license, issue the following command:lmremove -h f1 cloud9 7654 102
lmremove f1 joe cloud7 /dev/ttyp5
6.8 lmreread
lmreread [-c license_file] [-vendor name]
and `-x
options in
Section 6.4, `lmgrd, on page 44</a> for details about securing
access to
<TT>lmreread</TT>.<p>
<p>
To stop and restart a single vendor daemon, use
<TT>lmdown</TT> -vendor
<I>name</I>, then use
<TT>lmreread</TT> -vendor
<I>name</I>, which restarts the vendor daemon.<p>
<p>
If you use the `<TT>-c</TT> option, the license file specified will be read by
lmreread, not
by
lmgrd;
lmgrd rereads the file it read originally. Also,
lmreread cannot be used to
change server node names or port numbers. Vendor daemons will not reread their
option files as a result of
lmreread.6.9 lmstat
lmstat [-a] [ -A ] [-c license_file] [-f feature] [-i [feature]]
[-S vendor] [-s hostname] [-t value]
s features.<dt>-s
<I>hostname</I><dd>Display status of clients running on
<I>hostname</I>.<dt>-t
<I>value</I><dd>Set
<TT>lmstat</TT> timeout to `value.6.10 lmswitch
lmswitch feature new-file
6.11 lmswitchr
lmswitchr [-c license_file] feature new-file
lmswitchr [-c license_file] vendor new-file [v5.0+ only]
6.12 lmver
lmver filename
% lmver spell
strings file | grep Copy
6.13 License Administration Tools for Windows
6.13.1 License Administration Tools - LMTOOLS for Windows
6.13.2 The
FLEXlm
Control Panel
6.13.3 Controlling LMGRD with the Windows Control Panel
6.13.4 Using The Control Panel on
NT
.
HKEY_LOCAL_MACHINE\SOFTWARE\FLEXlm License Manager\Service-Name\...
6.13.5 Using the
Control Panel on
Windows 95
