Documentation

Install Network License Manager Online

Install the network license manager on a computer connected to the internet. You must install the license manager and have it up and running before you install MATLAB® software on client systems.

To avoid any potential issues with License File operation, consider upgrading the network license manager software whenever you upgrade MATLAB software.

Note

Starting with R2013b, network License Files have a new format. As a result, R2013b and later releases require an update to the latest version of the network license manager that ships with R2013b or later. You can continue to use older License Files and previous versions of the MATLAB software if you decide not to upgrade to R2013b or a later release.

Step 1. Get Ready to Install

  • Obtain the Host ID of the computer on which you intend to run the network license manager.

    • Windows® Systems — The Host ID can be the MAC Address (Physical Address) or the IP Address of the first Ethernet adapter. To obtain the MAC Address, open a Command Prompt window, and run the command:

      getmac

      Use the first Physical Address listed (for example. 00-11-22-aa-bb-cc).

      To obtain the IP address, open a Command Prompt window, and run the command:

      ipconfig

    • Linux® Systems — The Host ID is the MAC Address of the eth0 device (first Ethernet device). In a Terminal window, run following command:

      /sbin/ifconfig eth0

      The Host ID is the value listed next to the tag "HWaddr".

    • macOS Systems — The Host ID is the MAC Address of the built-in Ethernet device (en0). Use Terminal in /Applications/Utilities and run the command:

      netstat -I en0

      The Host ID is listed in the first row of the output, under the "Address" column.

  • Activate the license, or obtain the License File, if you activated the license previously:

    1. Visit the License Center at the MathWorks® website.

    2. Select the license to activate.

    3. Select the Activation and Installation tab and click Activate.

    4. Specify the operating system type and Host ID of the computer on which you intend to run the network license manager. You can optionally assign a descriptive label to the activation as well. Click Continue.

    5. Choose whether to download the License File or receive it in email. Click Continue.

  • If it is running, shut down the network license manager. See Start the Network License Manager (Installation, Licensing, and Activation) for more information.

  • Make sure that you have your email address and your MathWorks Account password handy. You will need them to log in to your account during installation. If you have multiple licenses linked to your account, know the number of the license you want to install.

    If you do not have a MathWorks Account, you can create one during installation. However, you must have an Activation Key. An Activation Key is the unique code that identifies a license. It is used to activate the license. The Activation Key also allows licensed end users to link their MathWorks Account with a license. Ask the administrator of the license for the Activation Key.

  • Make sure that you have the correct permissions to run the installer. If you have questions about permissions, ask your system administrator.

    • Windows Systems — Get the name and password of the administrator account on your computer.

    • Linux Systems — Get the root password. You can install MATLAB software without superuser privileges, however, it limits certain installation options. For example, if you want to set up symbolic links to the matlab command, install product files in a protected folder, or edit the system boot script, you must have superuser status.

    • macOS Systems — Get the name and password of an administrator account on your computer. The administrator account is the user account you set up when you configured your macOS system; this account is not your MathWorks Account. During installation, you must enter this name and password in the Authenticate dialog box,

  • Consider disabling virus checking software and Internet security applications on your system for the duration of the installation process. These applications can slow down or cause the installation process to appear to become unresponsive (hang).

You only need to install the network license manager one time at a site. For information about installing MathWorks software on clients, see Install MathWorks Software on Client Systems (Installation, Licensing, and Activation).

Step 2: Start the Installer

  1. Download the installer from the MathWorks website.

    When you select an installer on the website, you receive the files that the installer needs in order to run on your selected platform, not the product files. Run the installer to select products that you want to install on the computer where you are logged in. The installer downloads the products that it needs from MathWorks, if necessary.

  2. Start the installer. The method you use to start the installer depends on your platform.

    • Windows

      If you click Run when you select the installer on the MathWorks website, the installer starts automatically. If you saved the installer instead, double-click the self-extracting installer file in the folder where you saved it. The name of the self-extracting installer file is matlab_release_$ARCH, where release is the release you are installing (for example R2019b) and $ARCH is the selected architecture.

      The installer should start automatically after file extraction is complete.

      To restart the installer later, click setup.exe. This file is located in the top level of the folder where you extracted the files.

    • macOS

      Double-click the dmg file that you downloaded from the MathWorks website. Double-click InstallForMacOSX.app.

    • Linux

      Use the unzip command to extract the files from the archive file that you downloaded from the MathWorks website. After extracting the files, execute the installer command:

      ./install
      

Step 3: Select Log in with a MathWorks Account

Leave the Log In with a MathWorks Account option selected (the default), and then click Next. During installation, you log in to your MathWorks Account, select the license you want to install, and follow the prompts in the installer.

If your Internet connection requires a proxy server, click Connection Settings. Enter the server name, port, and password in the Connection Settings page. MathWorks supports Basic authentication and Digest authentication proxy configurations.

Note

On Windows systems, the installer uses your system proxy settings, by default. If your proxy server requires you to log in, the installer prompts you for your login information.

Step 4: Review the Software License Agreement

Review the software license agreement and, if you agree with the terms, select Yes and click Next.

Note

To view the end user license agreement at any time after installation, execute the following command in the MATLAB command window:

>> edit( fullfile(matlabroot, 'license_agreement.txt') )

Step 5: Log in to Your MathWorks Account

To log in to your MathWorks Account, enter your email address and password, and click Next. The installer contacts MathWorks to retrieve information about the licenses linked to your account. If you have enabled Two-Step Verification on your account, a verification code is sent to your primary method.

If you do not have a MathWorks Account, select the Create a MathWorks Account (requires an Activation Key) option and click Next. You are prompted to enter the data needed to create the account.

Step 6: Enter Two-Step Verification Code

If you have Two-Step Verification enabled (in your MathWorks Account), you will be prompted to enter the verification code sent to your primary method when you signed in to your MathWorks Account. If you do not have Two-Step Verification enabled, you can go directly to the next step.

Enter the verification code sent to your primary method.

Click Next to proceed with installation.

Step 7: Choose Install Option

Leave the Install option selected (the default) and click Next.

Step 8: Select the License You Want to Install

Select a license with one of the network license options from the list of licenses linked with your MathWorks Account and click Next. The list contains the following information about the licenses:

  • License number.

  • An optional descriptive text label that can help identify the license.

  • Information identifying the license options. For server installation, select a license with one of the network license options.

If you want to install products on a license that is not linked to your MathWorks Account, select the Enter an Activation Key for a license not listed option, enter an Activation Key, and click Next. An Activation Key is the unique code that identifies a license.

Note

Entering dashes or spaces for the Activation Key is optional.

Step 9: Specify the Installation Folder

Specify the name of the folder where you want to install MathWorks products. Accept the default installation folder, or click Browse to select a different one. If the folder does not exist, the installer creates it.

When specifying a folder name, you can use any alphanumeric character and some special characters, such as underscores. If you make a mistake while entering a folder name and want to start over, click Restore Default Folder. After making your selection, click Next.

Step 10: Select Network License Manager for Installation

Select the network license manager in the product list. By default, it is not selected for installation.

If you are only installing the license manager on your server, clear the check boxes next to the other products. If you are setting up a remote access configuration where users will run MathWorks products on a central server, and this central server is your license server, leave all the other products in the list selected for installation.

After making your selections, click Next to proceed with the installation. After clicking Next, you might receive a message telling you that one or more of the products you selected depend on other products.

Step 11: Specify the Location of the License File

In the text box, enter the full path of the License File you retrieved from the License Center at the MathWorks website. Then, click Next.

License File Processing on Server

When you install the network license manager, the installer performs the following processing of this License File:

  • Makes a copy of your License File, naming it license.dat, and puts this copy in the \etc folder of your MATLAB installation folder.

  • Adds a SERVER line and a DAEMON line to the file. The SERVER line identifies the server (host and port number). The DAEMON line identifies the name of the network license manager daemon.

Step 12: Configure the Network License Manager: Windows Systems Only

Configuring the network license manager service provides automatic startup at system boot time and centralizes administration of the license manager through the Windows Services control panel. To review the default network license manager configuration settings, click View Default Settings. If you choose not to configure the network license manager service, you can do it later.

Note

If you have an existing network license manager that you want to continue to use until you install the new one, select the Do NOT configure license manager as a service (files will still be installed) option. The installer still installs the network license manager files. After installation, you can stop your existing license manager and start your new license manager.

Step 13: Confirm Your Choices

Before it begins copying files to your hard disk, the installer displays a summary of your installation choices. To change a setting, click Back. To proceed with the installation, click Install.

As it copies files to your hard drive, the installer displays a status dialog box to show the progress of the installation.

Read Product Configuration Notes

The installer includes information about how to start the network license manager on your server. If you installed other products, you might also see some additional product configuration and product update information.

Click Next to proceed with the installation.

Step 14: Complete the Installation

When the installer finishes, click Finish to exit the installer.

If you installed the network license manager as a service, you should restart your computer after completing the installation. The license manager must be running to start MATLAB on client systems. As a service, the license manager gets started automatically at system boot time.

Related Topics