License Management (MATLAB Installation Guide for Windows)

MATLAB Installation Guide for Windows

Viewing License Manager Status

To view the current status of the license manager, use the lmutil command in a DOS command prompt window or use the lmtools.exe graphical user interface.

Note You must run these tools on the system on which the license manager is running.

Using the lmutil Command

The lmutil command performs many different license management functions. You invoke each function by specify lmutil command line flags.

To use the lmutil command to obtain a status report, open up a DOS command prompt window and enter this command:

lmutil lmstat -a -c C:\matlab6p5\flexlm\license.dat
lmutil - Copywright (C) 1989-2001 Globetrotter Software, Inc.
Flexible License Manager status on Friday 11/1/2002 15:17

License server status: 27000@smithj
    License File(s) on smithj: C:\matlab6p5\flexlm\license.dat:

  smithj: license server UP (MASTER) v.8.0

Vendor daemon status (on smithj):

    MLM: UP v8.0

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)

Note the following:

The example specifies the lmstat command line argument to obtain a status report. The lmutil command can perform many different license management functions. See Performing Other License Management Tasks with lmutil for a complete list.
The example uses the -a argument to get a verbose listing of available licenses.
The example use the -c flag to specify the location of the License File. You must specify this flag with every tool invoked through lmutil.exe.

Performing Other License Management Tasks with lmutil To view a list of all the capabilities of the lmutil.exe utility, open a Command Prompt window, go to the $MATLAB\flexlm directory and type

```
lmutil
```

The following table lists the names of the most useful tools available through lmutil. For more detailed information, see the FLEXlm End User Manual, included in PDF format in your MATLAB installation ($MATLAB\flexlm\enduser.pdf).

Utility
Description

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 license manager daemon reread the License File and start any new vendor daemons

lmstat
Display the status of all network licensing activities

lmswitchr
Switch the report log file

lmver
Determine the FLEXlm version of a library or binary file

Utility	Description
`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 license manager daemon reread the License File and start any new vendor daemons
`lmstat`	Display the status of all network licensing activities
`lmswitchr`	Switch the report log file
`lmver`	Determine the FLEXlm version of a library or binary file

Using the lmtools.exe GUI

FLEXlm provides a graphical user interface (GUI) to its license management tools. To invoke this GUI, double-click on the lmtools.exe file in the $MATLAB\flexlm directory. The GUI uses buttons to provide access to the same set of tools as lmutil.exe and displays the results returned in an integrated display window.

For example, to use the lmtools GUI to monitor the status of network license activity, click the Server Status tab and click the Perform Status Enquiry button. By default, lmtools displays the same information as if you had entered the command lmutil lmstat -a.

Performing Common License Management Tasks Starting and Stopping the License Manager