Documentation

License Manager Tasks

Start the License Manager

To start MATLAB® software on a client computer, the license manager must be running on the server. On Windows systems, the installer configures the license manager to start automatically when you start your system. (On Linux systems you must edit the system boot scripts–see Configuring the License Manager to Start Automatically on Linux Systems .) If you accepted this default configuration, the easiest way to start the license manager is to restart the computer on which you installed the license manager. There are several other ways to start the license manager, depending on your platform. The following section describes these methods.

    Note:   The user name associated with the license manager process should be a user that is defined locally on the system, not defined on a network. The license manager starts up properly only if the user name can be found during the startup process on the computer, before network users are available.

Windows Systems

You can start the license manager on Windows systems using any of the following methods:

  • Use the Windows Services control panel to start or stop the license manager, if you chose to configure it as a service during installation. On the Windows Start menu, select Settings > Control Panel > Administrative Tools > Services

  • Use the license management utility, lmtools.exe, included in your MATLAB installation in the matlabroot\etc\$ARCH folder, where $ARCH is a platform-specific subfolder. Start the lmtools.exe application and select the Start/Stop/Reread tab.

Linux and Mac OS X Systems

To start the license manager daemons on a Linux or Mac OS X system, execute the lmstart script (located in the matlabroot/etc folder), where matlabroot represents the name of your top-level MATLAB installation folder. The lmstart script stops any currently running daemons and starts new ones.

To run lmstart on a Mac OS X system, open a terminal window using the Terminal application (found in /Applications/Utilities) and navigate to the /etc folder in your MATLAB installation folder:

cd /Applications/MATLAB_R2015a.app/etc

    Note   A user other than root should run the lmstart script because it is a security risk to run any program as root that does not require root permissions. The license manager (lmgrd) does not require root permissions. If you must start the license manager as root, use the su command to start lmgrd as a nonprivileged user:

    su username -c "lmgrd -c license_file -l /var/tmp/LM_TMW.log"
    
    where username is a nonprivileged user.

Configuring the License Manager to Start Automatically on Linux Systems

To configure the license manager to start automatically at boot time on Linux® systems, use the standard method for starting services automatically on your Linux distribution.

Start the lmboot_TMW service with the -u username option, where username represents a valid user name other than root. For security reasons, superuser cannot be an owner of the license manager daemons.

Make sure that the license manager starts at the very end of the system boot sequence. For the license manager to start correctly, the network must already be running. Use whatever mechanism your version of Linux provides to configure the boot sequence.

Manage the License Manager

This section describes several utilities provided by FlexNet® licensing that you can use to manage the 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).

Using LMTOOLS (Windows Systems Only)

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

  • Getting the status of the license manager

  • Starting and stopping the license manager

  • Configuring the license manager as a service

To illustrate, the following example shows how to use LMTOOLS to see the current status of the 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.

Using the License Manager Command-Line Utilities

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

On Windows systems, 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 license manager, open a DOS command window and run lmutil specifying lmstat as an argument:

lmutil lmstat -a -c "C:\Program Files\MATLAB\R2015a\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 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\R2015a\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;

lmutil lmstat -h

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

lmstat -a

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

License server status: 27000@ah-jcustomer
License File(s) on customerj: /user/local/MATLAB/R2015a/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;

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 license manager daemon 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 FlexNet options file take effect after a 15-minute delay.

lmstat

Display the status of all network licensing activities.

lmswitchr

Switch the report log file.

lmver

Determine the version of a library or binary file.

Was this topic helpful?