Problems After Installation

After a successful installation, you may encounter problems starting MATLAB software. Many of these problems originate in the FLEXnet license manager used by MathWorks products. When a problem occurs, the license manager displays an error message in a window on your display and also writes the message to the FLEXnet log file, lmlog.txt, in the matlabroot\etc\$ARCH folder. Read the error message carefully; it provides information that can help solve the problem. For information about viewing the license manager log file, see Managing the License Manager.

For more complete diagnostic information about an error message, go to the MathWorks Web site, visit the Support page at the MathWorks Web site, www.mathworks.com/support/. The Support page includes a Search facility that lets you search the support database for help with an error message by error number. You can also select the error number from the License Manager Errors menu.

You can also get information about license manager error messages in the License Administration Guide, for the FLEXnet Publisher Licensing Toolkit, available in PDF format in matlabroot\etc\LicenseAdministration.pdf.

Allowing Access to License Manager Daemons

If you run the license manager on a server that is protected by a security firewall, you must open the firewall to allow client installations to communicate with the license manager daemons. For more information about these daemons, see the License Administration Guide.

Opening Access to the License Manager Daemon

Using the interface provided by your firewall program, allow access on port 27000 for the license manager daemon. This is the default port used to communicate with the license manager. If you changed this port number, specify the port number used at your site. For more information about specifying the license manager daemon port number, see the License Administration Guide.

Opening Access to the Vendor Daemon

The port used by the vendor daemon is assigned dynamically. If you need to open access to the vendor daemon in your firewall, you must assign a port for vendor daemon communication, rather than using this dynamic port assignment. You can then open the assigned port number in your firewall.

To specify the vendor daemon port number, edit the License File on your license server and add the port= syntax to the DAEMON line. For more information about specifying the vendor daemon port number, see the License Administration Guide.

Back to Top

Understanding the License Files

A License File is a specially formatted ASCII text file that contains encrypted product passcodes for each product you are licensed to run. Each product passcode identifies the number of keys available for that product. The license manager grants or denies access to a product depending on the availability of the license keys associated with each product.

The following figure presents a sample License File. Each INCREMENT line identifies a product, the number of keys available for the product, and other information. (The INCREMENT lines in your License File might not include every element shown in the example.) The backslash (\) character indicates that the line continues onto the next line.

The lines that begin with a pound sign (#) are comments. The MathWorks Installer uses the information in these comment lines (license server host ID or Internet address) when it processes the License File during installation.

# BEGIN-------cut here-------CUT HERE-------BEGIN
# MATLAB license passcode file.
# LicenseNo: 12345           HostID: INTERNET=144.212.101.43
INCREMENT TMW_Archive MLM 18 01-sep-2010 0  \
	BC9DE773A77D15AF8 VENDOR_STRING=83 HOSTID=DEMO SN=12345
INCREMENT MATLAB MLM 18 01-sep-2010 1  \
	4C9D3348561BE9E3B USER_BASED DUP_GROUP=U SN=12345
INCREMENT SIMULINK MLM 18 01-sep-2010 1  \
	1CD148466EF58DF8B USER_BASED DUP_GROUP=U SN=12345
INCREMENT Signal_Toolbox MLM 18 01-sep-2010 1  \
	6CF74B458BA143DC3 USER_BASED DUP_GROUP=U SN=12345
# END---------cut here-------CUT HERE-------END

License File Search Path

When you start MATLAB, it reads the License File to check for product licensing. MATLAB searches for the License file in the following locations, in the specified order. Once it finds a License File, MATLAB stops searching.

1. License File specified on MATLAB startup command line using the -c argument. You can specify a list of paths to search. When you use the -c option, you explicitly prohibit the searching of the environment variables. When using the -c option, keep in mind the following:

   • If the path to your License File contains a space, enclose the path name in quotation marks.

   • If you are specifying more than one License File, make sure to enclose the entire list of License Files in quotation marks.

2. If no License File is specified at the MATLAB command, MATLAB searches two environment variables, described in the following table. MATLAB searches the vendor specific environment variable, MLM_LICENSE_FILE first.

   Environment Variable	Purpose
   MLM_LICENSE_FILE	Specifies the location of the License File, but only for MathWorks products. (Recommended, because it affects only MathWorks products.)
   LM_LICENSE_FILE	Specifies the location of the License File for all applications using FLEXnet licensing on this server.

3. If it doesn't find any License File specified using environment variables, MATLAB searches the profile folder of the person starting the program. For licenses that are locked to individual users, the activation application puts the License File in a folder in your user profile.

4. If it doesn't find any License File specified in environment variables or in your user profile, MATLAB checks the \licenses folder in your MATLAB installation for files named license.dat or any file with the extension .lic.

Back to Top

Problems During Installation

© 1984-2012- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS