Installation Guide for Windows Previous page   Next Page

License Manager Error Messages

This section provides brief descriptions of some common license manager errors, listed in order by error number. For more complete diagnostic information about an error message, go to the MathWorks Web site, www.mathworks.com, and click Support. See Getting Help with License Manager Problems for more information.

License Manager Error
License Manager Error -2: License Checkout Failed. Invalid License File Syntax
License Manager Error -3: License Checkout Failed. Cannot Connect to a License Server
License Manager Error -5: License Checkout Failed. No Such Feature Exists.
License Manager Error -8: License Checkout Failed. Encryption Code in License File Is Inconsistent
License Manager Error -9: License Checkout Failed. Invalid Host.
License Manager Error -10: License Checkout Failed. Feature Has Expired
License Manager Error -12: License Checkout Failed. Invalid Return Data from License Server.
License Manager Error -13: License Checkout Failed. No SERVER Line in License File
License Manager Error -14: License Checkout Failed. Cannot Find SERVER Hostname in Network Database
License Manager Error -15: License Checkout Failed. Cannot Connect to License Server
License Manager Error -16 License Checkout Failed. Cannot Read Data from License Server
License Manager Error -18: License Checkout Failed. License Server Does Not Support This Feature.
License Manager Error -21: License Checkout Failed. License File Does Not Support This Version
License Manager Error -25: License Checkout Failed. License Server Does Not Support This Version of This Feature
License Manager Error -31: License Checkout Failed. Feature Not Yet Available
License Manager Error -39: User/Host Not on INCLUDE List for Feature
License Manager Error -83: License Checkout Failed. FLEXlm Version of Client Newer Than Server
License Manager Error -84: USER_BASED license has no specified users
License Manager Error -96: License Checkout Failed. Server Node is Down or Not Responding
License Manager Error -97: License Checkout Failed

License Manager Error -2: License Checkout Failed. Invalid License File Syntax

This error typically indicates that there is a problem in your License File. On client systems, make sure your License File ($MATLAB\bin\win32\license.dat) has the following format.

Note that there should be a carriage return immediately following the USE_SERVER line.

License Manager Error -3: License Checkout Failed. Cannot Connect to a License Server

This error can indicate that the SERVER or DAEMON lines in your License File is incorrect or missing. To remedy this error, try the following:

License Manager Error -5: License Checkout Failed. No Such Feature Exists.

This error usually indicates that you are trying to use a product for which you are not licensed.

License Manager Error -8: License Checkout Failed. Encryption Code in License File Is Inconsistent

This error typically indicates that you are running the license manager on a host that has a different host ID than the one for which your License File was generated.

License Manager Error -9: License Checkout Failed. Invalid Host.

If you get this error on a system running an individually licensed MATLAB, this error typically indicates that you are not running MATLAB on the same system it was installed on. You can also get this error if you

To remedy this situation, rerun the installer. At Step 2: Start the Installer, select the Update license option. This option lets you update your license without requiring that you reinstall MATLAB.

License Manager Error -10: License Checkout Failed. Feature Has Expired

This error indicates that one or more of your license keys has expired.

Verify that the expiration date on each of the INCREMENT lines in your License File ($MATLAB\bin\win32) is still current. If the dates have already passed, contact the Customer Service department at The MathWorks (through the Web or through e-mail at service@mathworks.com). When contacting The Mathworks, include your License Number and the Host ID of your license server.

If none of your product licenses has expired, verify that the system date and time on your computer are correct:

  1. Click the Start menu.
  2. Choose Settings.
  3. Click Control Panel.
  4. Choose Date/Time.

License Manager Error -12: License Checkout Failed. Invalid Return Data from License Server.

This error can be caused by your network setup. When the license manager tries to connect to the server, the DNS Server does not find the server because it does not add the domain name suffix into the search.

If all of your client systems are having this problem, change the name of the server in the SERVER line in the License File on client systems (located in $MATLAB\bin\win32) to the fully qualified name and restart the license manager on the server. (See Starting and Stopping the License Manager.)

If only some of the clients in your network installation are having this problem, add the hostname of your license server to the TCP/IP Hosts file on your client systems:

  1. Open the file, C:\WINNT\system32\drivers\etc\hosts
  2. Add the hostname of your license server to this file. You can find your license server information in the SERVER line of your license.dat file.
  1. For example, if your SERVER line looks like this,

    Add the following line to your TCP/IP hosts file.

  1. Save the changes to the TCP/IP hosts file.

License Manager Error -13: License Checkout Failed. No SERVER Line in License File

This error indicates that your License File is missing the SERVER line, DAEMON line, or both. These lines should be added to the License File by the MathWorks Installer during the installation process.

To remedy this problem, run the installer again or manually edit the License File, $MATLAB\flexlm\license.dat, adding the SERVER line. See Licensing Information for information about the format and contents of the SERVER and DAEMON lines.

Before modifying your License File, verify that the HostID of your license server matches the HostID given in the commented line of the file. If your system's HostID does not match the HostID used to generate your License file, contact The MathWorks; you will need your license regenerated for the correct HostID

License Manager Error -14: License Checkout Failed. Cannot Find SERVER Hostname in Network Database

If this error occurs on a client system, make sure that the hostname on the SERVER line in the license.dat file on your client system matches the hostname on the SERVER line in the license.dat file on your license server. Edit the SERVER line in the client license.dat file, if necessary.

Also, make sure that the server's hostname included in the SERVER line is listed in the C:\WINNT\system32\drivers\etc\hosts file.

License Manager Error -15: License Checkout Failed. Cannot Connect to License Server

This error indicates that MATLAB cannot connect to the license server.

For additional suggestions, go to the Support page on the MathWorks Web site, www.mathworks.com and search for this license manager error number.

License Manager Error -16 License Checkout Failed. Cannot Read Data from License Server

This error indicates that the path to the MATLAB vendor daemon on the DAEMON line in your License File is incorrect. The DAEMON line can vary depending on your license type. See Licensing Information for an examples.

License Manager Error -18: License Checkout Failed. License Server Does Not Support This Feature.

This error typically indicates that you have updated your License File without restarting the license manager. Restart the license manager and try to start MATLAB again.

If you get this error on the client, but not the server, the license.dat file on the client probably needs to be updated.

Make sure that the INCREMENT line in your License File exactly matches the INCREMENT line in the license information you received from The MathWorks.

License Manager Error -21: License Checkout Failed. License File Does Not Support This Version

If you are getting this error on your license server, make sure you have installed the version of FLEXlm included with Release 14. Release 14 License Files will not work with the older FLEXlm versions.

If you have updated an existing license.dat file with new Release 14 passcodes, you still need to install the latest version of FLEXlm from the Release 14 CD.

If you are getting this error on one of your client systems and not on the license server, make sure the License File on the client is in the following format.

The SERVER line in the client system License File should be the same as the SERVER line found in the License File on the license server.

Also, make sure you are using your Release 14 license and not a license from a previous release.

License Manager Error -25: License Checkout Failed. License Server Does Not Support This Version of This Feature

This error indicates that you are trying to run MATLAB with an old license. You must update your license.dat file with your new license passcodes.

If you do not have your MATLAB Release 14 license, contact Customer Service at The MathWorks.

License Manager Error -31: License Checkout Failed. Feature Not Yet Available

This error indicates that the system date is set to a date that is earlier than the date MATLAB was installed. Make sure that your system date is set to a date after the date that your license was made. See License Manager Error -10: License Checkout Failed. Feature Has Expired to learn how to reset the system date.

License Manager Error -39: User/Host Not on INCLUDE List for Feature

This error can indicate that your FLEXlm options file contains an incorrect username on the INCLUDE line. For Stand-Alone Named User and Network Named User, the FLEXlm options file requires an INCLUDE line for all licensed products. See Setting Up Network Named User Licensing for more information.

In addition, make sure that each user named in the FLEXlm options file must have read permissions for the options file.

License Manager Error -83: License Checkout Failed. FLEXlm Version of Client Newer Than Server

This error usually indicates that the version of the license manager on the client system is newer than the license manager on the server system. When MATLAB starts, the license file points to the wrong version of the license manager. To remedy this problem, update the license manager on the server to the latest version of FLEXlm that is included on the MathWorks CD.

License Manager Error -84: USER_BASED license has no specified users

The license manager cannot find your options file. Some possible resolutions are:

License Manager Error -96: License Checkout Failed. Server Node is Down or Not Responding

This error can occur if you are running DHCP (to obtain a dynamically assigned IP address) on your license server. MATLAB cannot connect with the license manager because it uses TCP/IP protocols for communication and the IP address is changing.

To fix this problem, follow this procedure:

  1. Obtain the current IP address for your server. If you are on UNIX or Linux, use the ifconfig command. On a PC running Windows, you can use the ipconfig command at a DOS prompt.
  2. Edit the hosts file on your system and change the IP address for your server's entry to be the correct IP address. On UNIX or Linux systems, edit the /etc/hosts file. On Windows NT and Windows 2000 systems, edit the C:\WINNT\system32\drivers\etc\hosts file.

License Manager Error -97: License Checkout Failed

This error can occur when trying to start the license manager while an existing vendor daemon (mlm.exe) is already running. To resolve this, open the Task Manager and terminate any mlm.exe processes that are running. If you cannot end the process in the Task Manager, reboot your computer. Once you reboot, restart the license manager.

If the same error occurs after rebooting, it is also possible that the vendor daemon is trying to run on an occupied port. To specify an open port for the vendor daemon, edit the DAEMON line in the license.dat file, found in the $MATLAB\flexlm folder, where $MATLAB is the root MATLAB folder.

where ##### is an open port. You can use any unused port number between 0 and 64000. By default, the license manager uses a port in the range 27000 to 27009.


Previous page  Problems After Installation Troubleshooting an Installation That Uses Dongles Next page