Set Up Named User Licensing

With Network Named User licenses, MathWorks^® uses FlexNet^® options files to identify the specific Named Users to whom you have assigned right-to-use privileges. A FlexNet options file is a text file that contains option statements. An option statement begins with a keyword that identifies the option, such as RESERVE, INCLUDE, EXCLUDE, GROUP, or HOST_GROUP.

Note

Do not confuse your License File with your FlexNet options file. The License File contains the encrypted passcodes for each product you are licensed to install and run. The FlexNet options file is a text file that contains license manager option statements.

If you have a Network Named User license, after you install your products, you might need to

Check that the FlexNet options file includes all licensed users — see Check the Options File.
Check that the DAEMON line in your License File includes the options file location — see Control License Borrowing with Options Files.

For more detailed information about creating FlexNet options files, see the FlexNet License Administration Guide, available in PDF form in matlabroot/etc/LicenseAdministration.pdf, where matlabroot represents your installation folder.

Check the Options File

As part of the installation process, the MathWorks installer creates a FlexNet options file, named MLM.opt, in the etc subfolder of your top-level MATLAB^® installation folder. In this options file, the installer puts an INCLUDE line for each product you are licensed to install and run. By default, the installer puts the username of the person who performed the installation in these INCLUDE lines. If you performed your own installation, the options file might not need editing. However, if you performed the installation for another user, or if your license server is installed on a UNIX^® system and you had root privileges when you performed the installation, you will need to edit this options file.

For example, if your username is sysadmin, the options file would look like this.

INCLUDE MATLAB USER sysadmin
INCLUDE Signal_Toolbox USER sysadmin
INCLUDE Optimization_Toolbox USER sysadmin

You must replace sysadmin in these INCLUDE statements with the usernames of the licensed users. Because the installer includes the GROUPCASEINSENSITIVE option in the options file and sets it to ON, login names are not case sensitive. If multiple users are licensed for the same product, you must create a separate INCLUDE line for each user or collect the users into a group, using the GROUP syntax, and specify the name of the group in an INCLUDE line. The number of users must not exceed the number of license keys available for that product. This example shows both methods.

Note

If you edit the options file, make certain that there are no extra space characters at the end of each INCLUDE line.

GROUPCASEINSENSITIVE ON
GROUP matlab_users tom judy mike jean brad
GROUP signal_users tom mike brad
INCLUDE MATLAB GROUP matlab_users
INCLUDE Signal_Toolbox GROUP signal_users
INCLUDE Optimization_Toolbox USER mike
INCLUDE Optimization_Toolbox USER jean

Note

Do not use the INCLUDEALL option with products from MathWorks licensed under an Individual (Linux^® or Mac OS X only) license option. You can use this option with Concurrent licenses.

Do not use USER_GROUP or HOST_GROUP as names of groups. These terms are reserved.

Make Sure Your DAEMON Line Includes Your Options File

When the installer creates an options file during installation, it also adds the Options= syntax to the DAEMON line in your License File. This syntax specifies the pathname of the options file.

For example, if your server is named thunderball and its IP address is 144.212.111.103, the SERVER and DAEMON lines in your License File would look like this:

SERVER thunderball INTERNET=144.212.111.103 27000
DAEMON MLM "C:\Program Files\MATLAB\R2016b\etc\win64\MLM.exe" \
            options="C:\Program Files\MATLAB\R2016b\etc\mlm.opt"

Was this topic helpful?

Documentation