MATLAB Installation Guide for Unix

Creating a Local License Options File

Note    For more detailed information about creating license options files, see the FLEXlm End User Manual, available in PDF form in the $MATLAB/etc directory, 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, you must use an options file. The installer creates a default license options file (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/matlab/etc/lm_matlab \
/usr/local/matlab/etc/MLM.opt

Options File Contents

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

The lines that begin with RESERVE contain 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 you want it (unless the specified number of reserved keys has already been reached).

The lines starting with INCLUDE contain the products to be restricted to a particular user, user group, host, or host group; only that user, user group, host, or host group is allowed to use this product. You can have multiple INCLUDE lines for the same feature, including different users, user groups, hosts, or host groups. You use INCLUDE lines with user-based licenses.

Note    For MATLAB user-based licenses, you cannot use the INCLUDEALL specification.

The lines starting with EXCLUDE contain 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.

Any line starting with GROUP defines the users in that group name. If a user group name is used in a RESERVE, INCLUDE, or EXCLUDE line, the group membership must be defined in a GROUP 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.

The following is a sample local options file.

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
GROUP devels andrea tom fred
HOST_GROUP hosts cygnus sirrus

Running MATLAB with Other FLEXlm Applications

Configuring Redundant License Servers