Troubleshooting (MATLAB Installation Guide for Unix)

MATLAB Installation Guide for Unix

License Manager Error Messages

Some common license manager error messages are listed below. The error messages are listed in alphabetical order and appear in bold followed by suggested troubleshooting steps.

Cannot connect to license server. This error is displayed when starting MATLAB.

Determine whether the license manager daemons are running on the license server by running $MATLAB/etc/lmstat on the license server. If the license daemons are not running, execute $MATLAB/etc/lmstart. If the license manager does not start, check the log file, usually /var/tmp/lm_TMW.log, for diagnostic messages.
If the license manager is running on the license server and this message is displayed on your host, ensure that the TCP/IP network software is running on the computer. Even for stand-alone computers, the license manager requires TCP/IP. Enter the UNIX telnet hostname command where hostname is the name of the license server. If telnet does not return a successful session on hostname, there is a problem with your network configuration. You must resolve this problem before you can run MATLAB. Contact your local system administrator for help.

Encryption code in license file is inconsistent. . See the log file (usually
/var/tmp/lm_TMW.log). It should indicate the specific INCREMENT line where it found bad codes in your License File (usually $MATLAB/etc/license.dat).

Check the 20-digit license passcode closely for typographical errors. This is most likely the problem. Make sure that zeros are not the letter O. Make sure Bs are not 8s, and so on.

Also, the date format in your License File may be incorrect; e.g., 01-mar-99 instead of 01-mar-2000. The date format should always match the passcodes that were sent by e-mail or faxed to you.

Environment variable LM_LICENSE_FILE is not defined and the default license file, $MATLAB/etc/license.dat, does not exist. Check to make sure that MATLAB has been properly installed on your machine.. This error is displayed when starting MATLAB.

Check the directory where you are running MATLAB. Make sure that you are running the script $MATLAB/bin/matlab.
Check that you are running the correct version of the operating system as specified in System Requirements.

Feature not yet available.. Feature ... is not enabled yet (Logfile version of message).. Check for typographical errors in the 20-digit license passcode of the INCREMENT lines in your License File. The date on your system may be incorrect. To check the date, use the UNIX date command at the UNIX prompt.

Invalid returned data from license server.. This error occurs when incompatible daemons are running. Most often this error is due to an installation update of MATLAB (in the same directory as the previous version) where the daemons were not shut down before the update was installed. If the daemons are not shut down, then an update of MATLAB will not replace the daemon files.

To fix this problem, shut down the currently running daemons and reinstall only the license manager files.

Invalid hostid for this CPU.. If you receive this error:

Make sure the hostid on the fax or e-mail matches the hostid on the SERVER line in your License File.
Make sure the hostid on the SERVER line is correct for the hostname that is on the SERVER line in your License File.
Execute the $MATLAB/etc/lmhostid command to make sure that the hostid given to The MathWorks is correct. If the hostid given is incorrect, contact The MathWorks for new passcodes. See Obtaining Your License File from The MathWorks for more information.

License.dat is corrupted.. For more information, see the error message Encryption code in license file is inconsistent..

(lmgrd) License manager: Not a valid server host, exiting.. This message is displayed in the log file (usually /var/tmp/lm_TMW.log).

Make sure that the hostname in the SERVER line of the License File (usually $MATLAB/etc/license.dat) is correctly spelled and resolvable. See also the error message MLM: cannot find SERVER hostname in network database.

MATLAB cannot be started. Invalid returned data from license server.. This error is displayed when starting MATLAB. It occurs if you are running incompatible versions of the license manager daemon.

You need to execute $MATLAB/etc/lmstart to start the license manager and vendor daemons corresponding to the current version of MATLAB.

MATLAB cannot be started. License server does not support this feature.. This error is displayed when starting MATLAB.

Check that the license manager was restarted after making changes to your License File.
See if there is a typographical error in a FEATURE or INCREMENT line of your License File.

MATLAB is not allowed on this host.. This error is displayed when starting MATLAB.

Run $MATLAB/etc/lmhostid and make sure that the hostid matches the passcodes.
Make sure your computer is running TCP/IP, which is the network software required by the license manager. Even for stand-alone computers, the license manager requires TCP/IP. Enter the UNIX telnet hostname command where hostname is the name of the license server. If telnet does not return a successful session on hostname, there is a problem with your network configuration. You must resolve this problem before you can run MATLAB. Contact your local system administrator for help.

See the error message Invalid hostid for this CPU..

MLM: cannot find SERVER hostname in network database.. This error commonly occurs when the license server and the client running MATLAB are in different domains. The local hostname listed in the License File cannot be resolved on the remote domain. To allow access across separate domains, do the following:

Place an alias in the license server's local host table for the fully qualified name, since all domains (including the license server) must be able to resolve the fully qualified name for the license server through the host table, DNS, or Yellow Pages.
Verify that the server name can be resolved by using telnet to log in remotely to the server computer (using the fully qualified name) from itself and from a client. If the telnet connection succeeds, then the fully qualified name is resolvable.
Insert the fully qualified name for the server on the SERVER line of the License File.
Invoke $MATLAB/etc/lmstart to force the license manager to reread the License File.

No features to serve! MLM daemon found no features. Please correct license file and re-start daemons. This may be due to the fact that you are using a different license file from the one you expect. Check to make sure that: "/var/tmp/lm_TMW.dat" is the license file you want to use.. This message is displayed in the log file, usually /var/tmp/lm_TMW.log. In most instances, this error can be ignored. The error message there are truly no features to serve means that the number of keys on each INCREMENT line is zero. You should still be able to run MATLAB successfully.

No TCP license server exists.. This error is displayed when starting MATLAB.

Ensure that the TCP/IP network software is running on your computer. The license manager requires TCP/IP even for stand-alone computers. Use the UNIX telnet hostname command where hostname is the name of the computer running the license server. If the telnet command does not connect to the specified hostname computer, there is a problem with your network configuration. You must resolve this problem before you can run MATLAB.
A TCP port number such as 27000 may be missing at the end of the SERVER line in your License File, or your /etc/services file may not be configured correctly.

Not a valid server host.. See the error message Invalid hostid for this CPU..

Socket bind error.. This error can have either of the following causes.

lmdown did not work correctly, and not all license daemons were killed. Manually kill these daemons as outlined in Checking the License Manager Daemons, and then restart the daemons with $MATLAB/etc/lmstart.
The TCP port number 27000 may be in use by some other program, including another license manager. The TCP port number 27000 is at the end of the SERVER line in the your License File. Check with your system administrator for another port number that you can use in your License File.

xxx is not currently licensed.. This error message is displayed when attempting to access a MATLAB toolbox, where xxx is the name of the toolbox or feature name; e.g., Signal_Toolbox.

There may be a typographical error in the INCREMENT line indicated by the error. For example, this error will occur if Signal_Toolbox is entered as signal_toolbox. Check the error message for typographical errors and case sensitivity, specifically in the feature name. Make sure the INCREMENT line matches the passcodes as generated by The MathWorks.

License Manager Error -39: No License for Feature. You may encounter the following license manager error:

License Manager Error -39
User/host not on INCLUDE list for feature
Feature: MATLAB

This table lists a typical cause of this error with possible solutions.

Possible Problem
Resolution

You are not listed as a user in your options file.
Check your options file and make sure your username is on the INCLUDE line for the product you are trying to use.
On UNIX computers, the installer creates the options file, named $MATLAB/etc/MLM.opt.

Possible Problem	Resolution
You are not listed as a user in your options file.	Check your options file and make sure your username is on the `INCLUDE` line for the product you are trying to use. On UNIX computers, the installer creates the options file, named `$MATLAB/etc/MLM.opt`.

License Manager Error -84: Missing Options File. You may encounter the following license manager error:

License Manager Error -84
USER_BASED license has no specified users -- see server log

This table lists typical causes of this error with possible solutions.

Possible Problem
Resolution

You do not have an options file.
Make sure the installer created an options file during the installation procedure. The full path of the options file is $MATLAB/etc/MLM.opt, where $MATLAB is your MATLAB installation directory. See Creating a License Options File for more information.

The DAEMON line in your License File does not include the path to the options file.
Add the full pathname of your options file to the DAEMON line in your License File.

You are trying to use a product for which you are not listed as a valid user.
Make sure you are listed properly in the options file for all the products for which you are licensed.

Possible Problem	Resolution
You do not have an options file.	Make sure the installer created an options file during the installation procedure. The full path of the options file is `$MATLAB/etc/MLM.opt`, where `$MATLAB` is your MATLAB installation directory. See Creating a License Options File for more information.
The `DAEMON` line in your License File does not include the path to the options file.	Add the full pathname of your options file to the `DAEMON` line in your License File.
You are trying to use a product for which you are not listed as a valid user.	Make sure you are listed properly in the options file for all the products for which you are licensed.

Obtaining a Diagnostic Report MATLAB Directory Structure