License Management (MATLAB Installation Guide for Unix)

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 user-based 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 HostID of the server or the string ID=xxxx, where xxxx identifies the user. TCP_PortNumber specifies the TCP/IP port number used to connect to license manager daemon.

Note The hostid in the comment portion of the License File must match the hostid in the SERVER line.

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. 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 user-based licenses, the DAEMON line also contains the path of the license options file, as the fourth parameter. See Creating a License Options File for more information.

For example, if your server is named thunderball and its hostid is 170a3472, the SERVER and DAEMON lines in your License File would look like this:

Applications Specifying the Location of the License File