| Installation Guide for Windows | |
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 -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:
| Note If you make any changes to the License File on the license server, you must restart the license manager. |
SERVER line in your License File matches the SERVER line in the License File on your license server. On client systems, the License File is $MATLAB\bin\win32\license.dat; on your license server, the License File is $MATLAB\flexlm\license.dat, where $MATLAB is the root MATLAB installation folder.
DAEMON line. See DAEMON Line for more information.
SERVER line in your License File is not already being used by another application. On Windows 2000 and Windows NT systems, run:
If the local system appears on the Foreign Address list, then the port number listed is being used. Change the port number on the SERVER line to a port that is not being used. By default, if a port is not specified, FLEXlm uses a port number in the range 27000 to 27009.
mlm.exe) running. Check your FLEXlm log file ($MATLAB\flexlm\lmlog.txt) for the error Multiple MLM Servers Running.
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.
| Note You must restart the license manager after making any changes to the License File on the license server. |
INCREMENT line for each licensed product
#, SERVER, DAEMON, or INCREMENT and replace any tab characters in INCREMENT lines with spaces. One way to check for extraneous tabs and carriage returns is to open your License File in a text editor and view all nonprinting characters. Remove these tabs and replace with them spaces.
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.
| Note You must restart the license manager after making any changes to the License File on the license server. |
#, SERVER, DAEMON, or INCREMENT and replace any tab characters in INCREMENT lines with spaces. One way to check for extraneous tabs and carriage returns is to open your License File in a text editor and view all nonprinting characters. Remove these tabs and replace with them spaces.
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:
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:
C:\WINNT\system32\drivers\etc\hosts
SERVER line of your license.dat 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
| Note You must restart the license manager after making any changes to the License File on the license server. |
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.
lmgrd and mlm, are running. on the server. You can check this via the Task Manager, which can be accessed by pressing the Ctrl+Alt+Delete key sequence. If the license manager isn't running, see Starting and Stopping the License Manager for information about starting it.
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:
$MATLAB\flexlm\MLM.opt, where $MATLAB is your MATLAB installation folder. See Setting Up Network Named User Licensing for more information.
DAEMON line in your License File includes the full pathname of your options file. Check the processed License File, $MATLAB\flexlm\license.dat. If the DAEMON line wraps onto a second line, make sure there is a line continuation character (\) at the end of the first line.
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:
ifconfig command. On a PC running Windows, you can use the ipconfig command at a DOS prompt.
/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.
| | Problems After Installation | Troubleshooting an Installation That Uses Dongles | |