Main Content

Start Network License Manager

The network license manager manages the licenses available for checkout so that end users in your organization can use MathWorks® products. The procedure to start the license manager depends on your operating system.

Prerequisites

  • You installed the network license manager. See Install License Manager on License Server.

  • The username associated with the network license manager is defined locally on the computer, not on a network. The license manager starts correctly only if the startup process finds the username on the local computer, before network users are available.

Start on Windows

To start the network license manager on Windows®, use one of the following options.

Start Interactively Using lmtools.exe

The lmtools.exe license management utility is included in your network license manager installation.

  1. In File Explorer, navigate to the lmroot\etc\win64 folder, where lmroot is the location where you installed the network license manager. For example, this sample path uses the default installation location for the current release:

    C:Program Files\MATLAB\R2023b\etc\win64
  2. Double-click lmtools.exe to open the network license manager.

  3. On the Start/Stop/Reread tab, click Start Server.

To stop the network license manager, click Stop Server on this tab.

Start as Windows Service

If you configured the network license manager as a service during installation, then you can start the manager using the Windows Services control panel.

  1. On the Windows Start menu, search for Services and select the Services app.

  2. In the Services window, select the network license manager service. By default, this service is named MATLAB License Server.

  3. Double-click the service name, and then click Start in the Properties dialog box.

To stop the network license manager, click Stop in this dialog box.

When you restart the computer, the service starts the network license manager automatically, so you need to start the service manually only if you have not restarted since installation.

Start as Application from Command Prompt

From the Windows command prompt, you can start the network license manager by using the lmgrd.exe license manager binary file. This file is included with your network license manager installation.

To prevent unwanted access to the network license manager, do not expose this binary file to the internet or an untrusted network.

  1. From the Windows command prompt, navigate to lmroot\etc\arch folder, where lmroot is the location where you installed the network license manager and arch is the platform-specific architecture, such as win64. For example:

    cd "C:\Program Files\MATLAB\R2023b\etc\win64"
  2. Start the network license manager.

    lmgrd.exe -c licFile -l logFile

    • licFile is the path to the license file, such as license.dat.

    • logFile is the path to the log file for the network license manager, such as lmlog.txt.

To stop the network license manager, enter this command:

lmgrd.exe -c licFile lmdown -q

Start on Linux or macOS

On Linux® and macOS systems, you can start the network license manager only from the command line, using either the lmstart script or the license manager binaries.

Start Using lmstart Script

The lmstart script is available in your installation only if you installed the network license manager using the MathWorks installer available from the Downloads page.

  1. From the command prompt for your operating system, navigate to the lmroot\etc folder, where lmroot is the location where you installed the network license manager.

    Operating SystemExample
    Linuxcd ~/MATLAB/R2023b/etc
    macOS (Intel® processor or Apple silicon)cd /Applications/MATLAB_R2023b.app/etc
  2. Start the network license manager. The lmstart script stops any currently running daemons and starts new ones.

    ./lmstart

Start Using License Manager Binaries

The license manager binaries are available for download from the License Manager Download page. After downloading and unzipping the binary files, you can use the lmgrd binary to start the network license manager.

To prevent unwanted access to the network license manager, do not expose this binary file to the Internet or an untrusted network.

  1. If possible, log in as a user other than root. The network license manager (lmgrd) does not require root permissions, and logging in as root might present a security risk.

    If you must start the license manager as the root user, then use the su command to start lmgrd as a nonprivileged user, specified by username.

    su username -c "lmgrd -c license_file -l /var/tmp/LM_TMW.log"
    
  2. Navigate to the lmroot/etc/arch folder, where lmroot is the location where you installed the network license manager.

    Operating SystemExample
    Linuxcd /usr/local/MATLAB/R2023b/etc
    macOS (Intel processor)cd /Applications/R2023b/etc/maci64
    macOS (Apple silicon)cd /Applications/R2023b/etc/maca64
  3. Start the network license manager.

    lmgrd.exe -c licFile -l logFile

    • licFile is the path to the license file, such as license.dat.

    • logFile is the path to the log file for the network license manager, such as lmlog.txt.

To stop the network license manager, enter this command:

lmgrd.exe -c licFile lmdown -q

Configure Network License Manager to Start Automatically (Linux Systems Only)

On Linux systems, to configure the network license manager to start automatically during the startup process, 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 username other than the root user.

The network license manager must start at the end of the system startup 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 startup sequence.

Related Topics