MATLAB: If I change the hostname of the license server, what changes will I have to make to the server and client installations

MATLAB

The hostname of my license server will be changed soon. I would like to know if I have to make any changes to the installation or license file of the license manager or client installations of MATLAB.

Best Answer

If you change the hostname of the license server, you will not need to generate a new license file, but you may need to update the SERVER line in the existing client and server license files, or environment variables. The license file is locked to either the MAC address or IP address of the server, so it is not necessary to activate and generate a new license file.

The second entry in the SERVER line of the license file identifies the license server by hostname or IP address. Any license file that references the hostname must be updated to the new hostname. Similarly, any client that uses the "LM_LICENSE_FILE" (or "MLM_LICENSE_FILE") environment variable with the "port@hostname" notation must be updated to use the new hostname.

For instructions on how to update the client license file, see the Related Solution listed below.

Related Solutions

MATLAB: Do I receive the message “Not a valid server hostname, exiting.” in the license manager log file

This error message indicates that the hostname specified in the license file the license manager is using does not match the hostname of the computer trying to start the license manager. For example, one may see:

14:59:21 (lmgrd) "matlab-server-01": Not a valid server hostname, exiting.
14:59:21 (lmgrd) Valid license server system hosts are: "ml-license-serv-01"

In this instance, ml-license-serv-01 is recorded in the license file, but matlab-server-01 is the computer's hostname. To resolve this problem, you will need to change the server line from:

SERVER ml-license-serv-01 1111222233334444 27000

SERVER matlab-server-01 1111222233334444 27000

Once you have updated the server's license file, be sure to restart the license manager and update the license file for each client accordingly. If you are unable to resolve this error, please contact MathWorks Licensing and Installation Support.

MATLAB: What are the differences between the license.lic, license.dat, network.lic, and license_info.xml license files

There are four different types of license file:

license.lic

For Individual or Designated Computer licenses, this is a standard license file generated from the MathWorks License Center. If this license is automatically generated during installation, it will also contain the hostname, license number and release in the filename.
For Concurrent or Network Named User licenses, this is an unprocessed license file used to install the network license manager. It is also generated on the MathWorks License Center. On network licenses, the license.lic file is *only *used for the installation of the network license manager.

license_info.xml

The license_info.xml file is used for Individual licenses with Login Named User enabled.
This type of license file is common for trial licenses and licenses being used on cloud compute services.
The license_info.xml file contains no license data; rather it instructs MATLAB to connect to MathWorks on launch to authenticate the license.
If a license_info.xml file is in place, you will be prompted to enter your MathWorks Account credentials upon launching MATLAB.

license.dat

The license.dat is a processed license file that is created during the installation of the network license manager on the license server. When the network license manager is installed using the MATLAB installer, the license.dat is placed in the $MATLAB/etc folder (where $MATLAB is the installation directory).
The license.dat contains two additional lines at the top of the file, the SERVER line and the DAEMON line. These lines are generated by the installer and contain information specific to the machine the installer was run on.
The license.dat is used during the installation of MATLAB on network clients.
You can manually convert a license.lic to a license.dat by adding the SERVER and DAEMON lines and changing the file extension from .lic to .dat.
The syntax for the SERVER and DAEMON lines is as follows:

SERVER {hostname} {HostID} 27000
DAEMON MLM {$MATLAB}/etc/MLM

network.lic

The network.lic is created when a license.dat is provided during installation of a network client installation. Similarly, when a network client installation is activated using the MATLAB activation client, the network.lic is placed in the $MATLAB/licenses folder (where $MATLAB is the installation directory).
The network.lic contains two lines, a SERVER line and the USE_SERVER directive.
You can manually convert a license.dat to a network.lic by deleting everything but the first line and replacing it with the USE_SERVER directive.
The network.lic can be used instead of the license.dat for activation of a network client installation.
The network.lic is only used on network client computers.
The syntax for the file is as follows:

SERVER {hostname} {HostID} 27000
USE_SERVER

Please note that with the exception of the license_info.xml license file, these names are conventions, not rules. The exact names and functions of these files may vary depending on your local MATLAB configuration. Any questions related to your specific usage should be directed to your license administrator.

Best Answer

Related Solutions

MATLAB: Do I receive the message “Not a valid server hostname, exiting.” in the license manager log file

MATLAB: What are the differences between the license.lic, license.dat, network.lic, and license_info.xml license files

Related Question