MATLAB Installation Guide for Unix

License File

A License File is an ASCII text file, named license.dat, that contains a set of valid license passcodes. When you purchase MATLAB or other products, The MathWorks sends you license information in an e-mail or fax. You must create a License File containing this license information. (For more information, see Creating a License File.)

The following is an example of a user-created license.dat file:

• # BEGIN-------cut here-------CUT HERE-------BEGIN
  # MATLAB license passcode file for use with FLEXlm.
  # LicenseNo: 12345         HostID: ID=12345
  INCREMENT TMW_Archive MLM 13 01-jan-0000 0 9CC470AG7GCCB4A810 \
    VENDOR_STRING="f" HOSTID=DEMO SN=12345
  INCREMENT MATLAB MLM 13 01-jan-0000 1 BCECD70AD686BGG7E9917 \
    USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT SIMULINK MLM 13 01-jan-0000 1 2C5C2G75GF38B8EAD8FD \
    USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT Control_Toolbox MLM 13 01-jan-0000 1 \
    7CACA7GA23CG5C5E38C1 USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT Identification_Toolbox MLM 13 01-jan-0000 1 \
    EC5C175AGD025G2AD73A USER_BASED DUP_GROUP=UH SN=12345
  # END---------cut here-------CUT HERE-------END
  

Each INCREMENT line can include any of these elements:

• INCREMENT product daemon release exp-date users passcode options
  

The options may vary, depending on license type. For example, INCREMENT lines for Named User licenses include the keyword USER_BASED.

The INCREMENT line containing the TMW_Archive identifies the products you are licensed to install.

Note    In previous releases, The MathWorks used FEATURE lines to encode license passcode information in License Files. INCREMENT lines perform the same function as FEATURE lines.

License File Processing

During installation, the installer processes the License File, adding two lines to the file: the SERVER line and the DAEMON line. These lines add information about the name, location, and port number of the license manager daemon. The installer moves the processed License File into the $MATLAB/etc directory. The following is a sample of a processed License File. Note the addition of the SERVER and DAEMON lines:

• # BEGIN-------cut here-------CUT HERE-------BEGIN
  # MATLAB license passcode file for use with FLEXlm.
  # LicenseNo: 12345         HostID: ID=12345
  SERVER your_server ID=12345 27000
  DAEMON MLM /usr/local/matlab6p5/etc/lm_matlab \
    options=/usr/local/matlab6p5/etc/MLM.opt
  INCREMENT TMW_Archive MLM 13 01-jan-0000 0 9CC470AG7GCCB4A810 \
    VENDOR_STRING="f" HOSTID=DEMO SN=12345
  INCREMENT MATLAB MLM 13 01-jan-0000 1 BCECD70AD686BGG7E9917 \
    USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT SIMULINK MLM 13 01-jan-0000 1 2C5C2G75GF38B8EAD8FD \
    USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT Control_Toolbox MLM 13 01-jan-0000 1 \
    7CACA7GA23CG5C5E38C1 USER_BASED DUP_GROUP=UH SN=12345
  INCREMENT Identification_Toolbox MLM 13 01-jan-0000 1 \
    EC5C175AGD025G2AD73A USER_BASED DUP_GROUP=UH SN=12345
  # END---------cut here-------CUT HERE-------END
  

SERVER Line.   The SERVER line has the form

• SERVER hostname hostid TCP_PortNumber
  

where hostname identifies the system on which the license manager is running and hostid can either be the host ID of the server or the string ID=xxxx, where xxxx identifies the license number. The host ID in the comment portion of the License File must match the host ID in the SERVER line.

TCP_PortNumber specifies the TCP/IP port number used to connect to the license manager daemon. If the port number assigned to the server conflicts with a port number used by other software, you can edit the SERVER line to change the number. You can use any port number; however, to run the daemons from a nonroot account. The port number must be greater than 1024. Globetrotter Software, Inc., the maker of FLEXlm, recommends using a port number in the range 27000 to 27009.

DAEMON Line.   The DAEMON line identifies the name and location of the vendor daemon (MLM):

• DAEMON MLM /usr/local/matlab6p5/etc/lm_matlab 
  

In Named User licenses, the DAEMON line also contains the path of the license options file, as the fourth parameter. For example, if your server is named thunderball and its host ID is 170a3472, the SERVER and DAEMON lines in your License File would look like this:

Specifying the Location of the License File

The environment variable LM_LICENSE_FILE defines where the license manager looks for the License File. By default, The MathWorks appends the value $MATLAB/etc/license.dat to this variable. If you want this environment variable to point to some other location, you must edit the.matlab6rc.sh script, which resides in $MATLAB/bin.

If you change the definition of LM_LICENSE_FILE in .matlab6rc.sh, you need to edit the license manager options file $MATLAB/etc/lmopts.sh to change the LM_FILE variable assignment. For example, if you change the location of the License File to /usr/licenses/license.dat, use the assignment

• LM_FILE=/usr/licenses/license.dat
  

in the license manager options file.

License Manager Daemon

License Manager Tools