Documentation

Install Network License Manager Offline

Use a File Installation Key (FIK) to install the network license manager on a machine that is not connected to the internet. You must download the installer and the FIK from a computer that does have an internet connection.

To avoid any potential issues with License File operation, consider upgrading the 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 and File Installation Key or receive them in email. Click Continue.

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

  • If you are installing the network license manager only, run the installer from the MathWorks website.

  • To install the network license manager and the rest of your MathWorks products at the same time, the MathWorks products must be available on your computer. Use the MathWorks installer to download products without installing them.

  • Make sure that you have the correct permissions to install the software. 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, you need superuser status 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.

    • 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 need to install the network license manager only 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 Use a File Installation Key

Select Use a File Installation Key and click Next.

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: Specify the File Installation Key

Select the I have the File Installation Key for my license option, enter the File Installation Key, and click Next.

Step 6: Specify the Installation Folder

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

After making your selection, click Next.

Step 7: Select the 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 network 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.

Note

If you plan to install other MathWorks products when you install the network license manager, the products must be available locally on your computer. For additional information about downloading products to your computer, see Download Products Without Installation (Installation, Licensing, and Activation).

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 8: 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

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.

  • Stores the processed license file in matlabroot/etc, where matlabroot is your MATLAB installation folder.

Step 9: 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 10: 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.

Step 11: Complete the Installation

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

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

Related Topics