MATLAB: How to specify which release of MATLAB users can have access to in the Options file

MATLAB

I have a multi-release license file and I want to specify which release of MATLAB different users have access to. How can I do this using the options file?

Best Answer

You can specify the release that a User or Group has access to in an options file by using the asset info tag from the license file.

Instead of listing the encryption key in the options file, you can use the “asset_info=” tag. You can simply add “asset_info=<xxx>”, where <xxx> is any character string, to the end of the INCREMENT lines if they are not already in the license file

For example, if you have a multi-release license file as below:

SERVER MyLicenseManager 001122334455 27000
DAEMON "C:\Program Files\MATLAB\R2010b\win32\mlm.exe" options="C:\Program Files\MATLAB\R2010b\win32\MLM.opt"
# BEGIN--------------BEGIN--------------BEGIN
# License No: 111222    HostID:001122334455
#
# R2017b
#
INCREMENT MATLAB MLM 17 01-jan-0000 11 8DE646541AFDDFE9416 \
HOSTID=ID=111222 USER_BASED DUP_GROUP=U asset_info=12345 SN=111222
INCREMENT SIMULINK MLM 17 01-jan-0000 11 2D66AD832109E0698 \
HOSTID=ID=111222 USER_BASED DUP_GROUP=U asset_info=111222 SN=111222
#
#R2012b
#
INCREMENT MATLAB MLM 17 01-jan-0000 7 9D164CBED8D11BCC72 \
HOSTID=ID=999888 USER_BASED DUP_GROUP=U asset_info=6789 SN=111222
#-------END-----------

Then you can restrict the release that they have access to in the options file using the asset info tag at the end of the INCREMENT line. The corresponding options file will look as below:

#Options file for use with MATLAB

GROUP MATLAB_users_R2017b user1 user2

GROUP MATLAB_users_R2012b user3 user4

#INCLUDE group for R2017b users

INCLUDE "MATLAB:asset_info=12345" GROUP MATLAB_users_R2017b

#INCLUDE group for R2012b users

INCLUDE "MATLAB:asset_info=6789" GROUP MATLAB_users_R2012b

This makes the options file easier to manage in the future because encryption keys change every release, whereas asset_info tags do not.

Related Solutions

MATLAB: How to configure an options file with multiple licenses

Serving multiple licenses from the same license server typically requires you to define an options file to ensure that the correct users receive the appropriate licenses when using MATLAB.

Network license files contain an asset_info tag which is used to identify an INCREMENT line belonging to a specific license by the license number. asset_info tags are consistent between releases and therefore you do not need to update your options file when updating your license file to a new release of MATLAB.

For example, lets say you have two licenses, 111222 and 999888. This configuration would allow the users of license 111222 to access 111222 and prevent them from accessing 999888. The license file would look like this:

SERVER MyLicenseManager 001122334455 27000
DAEMON "C:\Program Files\MATLAB\R2010b\win32\mlm.exe" options="C:\Program Files\MATLAB\R2010b\win32\MLM.opt"
#------BEGIN----------
# License No: 111222    HostID:001122334455
INCREMENT MATLAB MLM 17 01-jan-0000 11 8DE646541AFDDFE9416 \
HOSTID=ID=111222 USER_BASED DUP_GROUP=U asset_info=111222 SN=111222
INCREMENT SIMULINK MLM 17 01-jan-0000 11 2D66AD832109E0698 \
HOSTID=ID=111222 USER_BASED DUP_GROUP=U asset_info=111222 SN=111222
#-------END-----------
#-------BEGIN---------
# License No: 999888    HostID:001122334455
INCREMENT MATLAB MLM 17 01-jan-0000 7 9D164CBED8D11BCC72 \
HOSTID=ID=999888 USER_BASED DUP_GROUP=U asset_info=999888 SN=999888
#-------END-----------

The corresponding options file would look like this:

# Options file for use with MATLAB
GROUP MATLAB_users user1 user2 ...
GROUP SIMULINK_users user1 user2 ...
#
# Include the GROUP users for license 111222
#
INCLUDE "MATLAB:asset_info=111222" GROUP MATLAB_users
INCLUDE "SIMULINK:asset_info=111222" GROUP SIMULINK_users
#
# Exclude the Group users from license 999888
#
EXCLUDE "MATLAB:asset_info=999888" GROUP MATLAB_users

MATLAB: What is the asset_info tag in the license file

What is an asset_info tag:

==========

Starting with R2008a, all network based licenses will come with the tag "asset_info=######" where ###### is your license number (ex: asset_info=123465). These tags are used as an optional identifier in the license file when utilizing an options file. They are not required and can be removed or changed to any value. For example you could change the asset_info tag to be "asset_info=my_license".

These tags are particularly useful when utilizing an options file with multiple licenses on one server. If for example you have 2 different licenses and you want to apply an option to just one of the licenses, you could specify so using the asset_info tag.

Using asset_info tags in an options file:

==========

Let's take an example, where there are two MATLAB licenses, 123465 and 987654. We have features that are on both licenses, but we want to RESERVE keys from license 123456. To do this we would need to take the encryption code from the license and put it in the RESERVE statement.

RESERVE 5 MATLAB:key=<encryption code> GROUP power_users
(Ex: RESERVE 5 MATLAB:key=FD88D4758F5B54530753 GROUP power_users)

If the license file is updated, we will need to update the options file with the new encryption code.

If instead we use the asset_info tag:

RESERVE 5 MATLAB:asset_info=132456 GROUP power_users

The same asset_info tag will be in the updated license file. This means that updating the license file requires no change to the options file unless we wish to apply new options.

For more examples and uses of the asset_info tag, see the related solution: "How do I configure an options file with multiple licenses?"

Best Answer

Related Solutions

MATLAB: How to configure an options file with multiple licenses

MATLAB: What is the asset_info tag in the license file

Related Question