Documentation

Start the Network License Manager

To start MATLAB® software on a client computer, the network 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 Configure the Network License Manager to Start Automatically on Linux Systems (Installation, Licensing, and Activation).) If you accepted this default configuration, the easiest way to start the network 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 network 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.

Note

Follow these recommendations when using the network license manager:

  • Do not expose lmgrd or mlm to the internet or an untrusted network.

  • Start lmgrd with the options -2 -p local so that local administrator access is required to run lmdown.

Windows Systems

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

  • Use the Windows Services control panel to start or stop the network 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 macOS Systems

To start the network license manager daemons on a Linux or macOS 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 macOS 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_R2019b.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 network 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.

Configure the Network License Manager to Start Automatically on Linux Systems

To configure the network 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 network license manager 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 network 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.

Related Topics