Network License Manager Tools

This topic describes several utilities provided by FlexNet® licensing that you can use to manage the network license manager. For detailed information about these utilities, see the License Administration Guide, included in PDF format in your MATLAB® installation (matlabroot\etc\LicenseAdministration.pdf).

LMTOOLS is available for Windows® computers only. All operating systems can use the command line utilities.

Using LMTOOLS (Windows Only)

On Windows computers, FlexNet Publisher licensing includes a tool, called LMTOOLS. Using LMTOOLS, you can perform many license management tasks, such as:

  • Get the status of the network license manager.

  • Start and stop the network license manager.

  • Configure the network license manager as a service.

To illustrate, the following example shows how to use LMTOOLS to see the current status of the network license manager:

  1. Start LMTOOLS by double-clicking the lmtools.exe file in the matlabroot\etc\$ARCH folder, where matlabroot is your MATLAB installation folder and $ARCH is a platform-specific subfolder, such as win64.

  2. Select the Server Status tab.

  3. Click the Perform Status Enquiry button. LMTOOLS displays the same information as if you had entered the command lmutil lmstat -a.

    LMTOOLS dialog box, displaying the status of the license manager

Using Command-Line Utilities

FlexNet licensing includes a set of license management utilities that you can use to start, stop, and monitor the network license manager.

On Windows computers, FlexNet packages all the utilities in a single, command-line executable called lmutil.exe. This program is available in the matlabroot\etc\$ARCH folder, where matlabroot is your MATLAB installation folder and $ARCH is a platform-specific subfolder, such as win64. For example, to run a status check of the network license manager, open a DOS command window and run lmutil specifying lmstat as an argument:

lmutil lmstat -a -c "C:\Program Files\MATLAB\R2020a\etc\license.dat"

The -a option requests a verbose listing. You must also include the-c option to specify the license file to use. You must use this option with every lmutil option. If your installation path contains spaces, enclose the path in quotes. The following listing is a portion of the information returned.

lmutil - Copyright (c) 1989-2014 Flexera Software Inc. All Rights Reserved.
Flexible License Manager status on Tue 11/5/2014 10:11

[Detecting lmgrd processes...]
License server status: 27000@ah-jcustomer
License File(s) on customerj: C:\Program Files\MATLAB\R2020a\etc\license.dat:

  customerj: license server UP (MASTER) v.11.9

Vendor daemon status (on ah-jcustomer):

    MLM: UP v11.9

Feature usage info:

Users of MATLAB: (Total of 5 licenses available)

Users of SIMULINK: (Total of 5 licenses available)

Users of Control_Toolbox: (Total of 5 licenses available)

Users of Identification_Toolbox: (Total of 5 licenses available). 

To view a list of all the utilities in the lmutil package, type:

lmutil -h

To get help for a particular utility, type the name of the utility with the -h option, as in the following example:

lmutil lmstat -h

On Linux and macOS computers, these license management utilities are individual executables, available in the matlabroot/etc folder. For example, to view the status of the network license manager, use the lmstat utility, as follows:

lmstat -a

lmutil - Copyright (c) 1989-2016 Flexera Software Inc. All Rights Reserved.
Flexible License Manager status on Fri 11/4/2016 10:11

License server status: 27000@ah-jcustomer
License File(s) on customerj: /user/local/MATLAB/R2020a/etc/license.dat:

  customerj: license server UP (MASTER) v.11.9

Vendor daemon status (on customerj):

    MLM: UP v11.9

Feature usage info:

Users of MATLAB: (Total of 5 licenses available)

Users of SIMULINK: (Total of 5 licenses available)

To get help for a particular utility, use the -h option, as in the following example:

lmstat -h

The following table lists the names of the most useful license management tools included.

UtilityDescription

lmdiag

Diagnose license checkout problems.

lmdown

Shut down all license daemons (both lmgrd and all vendor daemons) on the license server node.

lmhostid

Report the host ID of a system.

lmreread

Make the network license manager reread the license file and start any new vendor daemons.

Note

When you use lmreread to reprocess a license file for a user-based license, changes to INCLUDE statements in the associated network license manager options file take effect after a 15-minute delay.

lmstat

Display the status of all network licensing activities.

lmswitchr

Switch to another report log file.

lmver

Determine the version of a library or binary file.

Acknowledgments

This topic lists the copyright owners of content used in the network license manager vendor daemon.

MD5

MD5 derived from RSADSI MD5 Message-Digest Algorithm.Copyright (C) 1991-2, RSA Data Security, Inc. Created 1991. All rights reserved.

License to copy and use this software is granted provided that it is identified as the "RSA Data Security, Inc. MD5 Message-Digest algorithm" in all material mentioning or referencing this software or this function.

License is also granted to make and use derivative works provided that such works are identified as "derived from the RSA Data Security, Inc. MD5 Message-Digest Algorithm" in all material mentioning or referencing the derived work.

RSA Data Security, Inc. makes no representations concerning either the merchantability of this software or the suitability of this software for any particular purpose. It is provided "as is" without express or implied warranty of any kind.

These notices must be retained in any copies of any part of this documentation and/or software.

Related Topics