MATLAB Installation Guide for Unix

Creating a License Options File

Note    For more detailed information about creating license options files, see the FLEXlm End User Manual, available in PDF form in $MATLAB/etc/enduser.pdf, where $MATLAB represents your installation directory.

With license options files, you can instruct the FLEXlm license manager to:

• Reserve one or more license keys for a user, group of users, host, or group of hosts.
• Specify the users, groups of users, hosts, or groups of hosts that have permission to access one or more products.

The license manager allocates keys according to the options specified in the options file, until all license keys are in use. If you try to reserve more than the authorized number of keys in the options file, a warning message appears in the license.log file.

Note    For user-based licenses, the installer creates a license options file, named ($MATLAB/etc/MLM.opt), if the installation doesn't already have an existing options file.

Specifying an Options File

To use an options file, you must list its pathname as the fourth field on the DAEMON line in the License File. For user-based licenses, the installer creates a default license file (MLM.opt) and includes it in the DAEMON line automatically. If your paths are long, use a line continuation character (\) to continue the DAEMON line onto the next lines:

• DAEMON MLM /usr/local/matlab6p5/etc/lm_matlab \
  /usr/local/matlab6p5/etc/MLM.opt
  

Options File Contents

An options file is a text file that contains any number of RESERVE, INCLUDE, EXCLUDE, GROUP, or HOST_GROUP lines.

Option	Description
EXCLUDE	Specifies the features to be restricted from a particular user, user group, host, or host group; that user, user group, host, or host group is not allowed to use that product. You can have multiple EXCLUDE lines for the same feature, excluding different users, user groups, hosts, or host groups.
GROUP	Assigns a name to a group of users. You can then use this name in a RESERVE, INCLUDE, or EXCLUDE line. Any line starting with HOST_GROUP defines the hosts in that host group name. If a host group name is used in a RESERVE, INCLUDE, or EXCLUDE line, the group membership must be defined in a HOST_GROUP line.
INCLUDE	Specifies the products to be restricted to a particular user, user group, host, or host group. You can use multiple INCLUDE lines for the same feature, including different users, user groups, hosts, or host groups. Note: You must use INCLUDE lines with user-based licenses. For MATLAB user-based licenses, you cannot use the INCLUDEALL specification.
RESERVE	Specifies the number of product keys set aside for a specific user, user group, host, or host group. This does not limit the number of keys; it simply ensures that a key will be available when they are needed (unless the specified number of reserved keys has already been reached)

The following is a sample options file:

• GROUP devels andrea tom fred
  RESERVE 1 MATLAB USER patricia
  RESERVE 3 MATLAB HOST pegasus
  RESERVE 1 Control_Toolbox GROUP devels
  RESERVE 3 Control_Toolbox HOST_GROUP hosts
  INCLUDE Signal_Toolbox HOST orion
  INCLUDE Signal_Toolbox USER tom
  EXCLUDE SIMULINK GROUP devels
  EXCLUDE SIMULINK HOST_GROUP hosts
  HOST_GROUP hosts cygnus sirrus
  

Running MATLAB with Other FLEXlm Applications

Configuring Redundant License Servers