| Installation Guide for Windows | |
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
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 -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. FLEXnet 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
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.
SERVER host hostID port_num USE_SERVER
Note that there should be a carriage return immediately following the USE_SERVER line.
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. |
Make sure that the 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.
Make sure that your License File includes a DAEMON line. See DAEMON Line for more information.
Make sure the TCP port number used by the license manager is not already being used by another application. This port number appears at the end of the SERVER line in your License File, as in the following.
SERVER hostname INTERNET=128.36.2.12 27000
To determine if another application is using this port number, use the netstat command. On Windows 2000 and Windows XP systems, run
C:\WINNT\system32\netstat -p tcp
If you find the port number used by the license manager in the information returned by netstat, the port is in use. Change the port number on the SERVER line in your License File to a port that is not already in use. By default, FLEXnet uses a port number in the range 27000 to 27009.
Make sure that you do not have multiple MathWorks vendor daemons (mlm.exe) running. Check your FLEXnet log file ($MATLAB\flexlm\lmlog.txt) for the error Multiple MLM Servers Running.
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. |
Check your License File to see if you are licensed to use this product. Your License File should contain an INCREMENT line for each licensed product
Make sure that your License File does not contain extra carriage returns or tabs. To avoid this, make sure that each line begins with either #, 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.
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.
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. |
Verify that the host ID specified in the License File matches the system's host ID. See Finding the Host ID on a Windows System.
Make sure that your License File does not contain extra carriage returns or tabs. To avoid this, make sure that each line begins with either #, 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.
Make sure that the license information in your License File matches the license information The MathWorks sent you.
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
Replaced your hard drive
Changed the partition on an existing hard drive
Do not have a C:\ drive
Tried to clone an installation from one system to another
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.
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:
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:
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.
For example, if your SERVER line looks like this,
SERVER hostname INTERNET=128.36.2.12 27000
Add the following line to your TCP/IP hosts file.
128.36.2.12 hostname
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 Personal License Passwords (PLPs) and License Files for information about the format and contents of the SERVER and DAEMON lines.
Before modifying your License File, verify that the host ID in your license server matches the host ID given in the commented line of the file. If your system's host ID does not match the host ID used to generate your License File, contact The MathWorks; you will need your license regenerated for the correct host ID.
Note You must restart the license manager after making any changes to the License File on the license server. |
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.
This error indicates that MATLAB cannot connect to the license server.
Verify that both license manager daemons, 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.
Verify that you have read permission to your MATLAB installation folder.
For additional suggestions, go to the Support page on the MathWorks Web site, www.mathworks.com and search for this license manager error number.
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 Personal License Passwords (PLPs) and License Files for an examples.
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.
If you are getting this error on your license server, make sure you have installed the version of FLEXnet included with the release you are trying to install. Older FLEXnet versions will not work with the License Files for new releases.
If you have updated an existing license.dat file with new passcodes, you still need to install the latest version of FLEXnet included with the release.
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.
SERVER host hostname port_num USE_SERVER
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.
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 an up-to-date license, contact Customer Service at The MathWorks.
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.
This error can indicate that your FLEXnet options file contains an incorrect username on the INCLUDE line. For Stand-Alone Named User and Network Named User installations, the FLEXnet 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 FLEXnet options file has read permission for the options file.
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 FLEXnet that is included on the MathWorks CD.
The license manager cannot find your options file. Some possible resolutions are
Verify that the installer created an options file during the installation procedure. The full path of the options file is $MATLAB\flexlm\MLM.opt, where $MATLAB is your MATLAB installation folder. See Setting Up Network Named User Licensing for more information.
Verify that the 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.
Verify that you are listed as a valid user of the product you are trying to use.
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:
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.
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 systems, edit the C:\WINNT\system32\drivers\etc\hosts file.
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
DAEMON MLM $MATLAB\flexlm\mlm.exe port=#####
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 | |
© 1984-2006 The MathWorks, Inc. • Terms of Use • Patents • Trademarks • Acknowledgments