Please enable JavaScript to view this site.

Knowledge Base

Navigation: Installation Manual > FlexNet License Manager

Controlling License Access

We've made some changes. Use 'Ctrl-F5' to clear your browser cache.
Scroll Prev Top Next More

The options file allows the license administrator to control various operating parameters within the constraints of

the license model. Users are identified by their user name, host name, display, or IP address.

 

Customers with floating licenses have the ability to control access to Lumerical licenses using the Options file. Licenses can be reserved for particular users or computers.  Typical examples include:

Reserve a set of licenses for a particular group of users. Eg: if one user always needs access to MODE Solutions, a license can be permanently reserved to this user.

Reserve a set of licenses for a cluster.  Eg: 10 FDTD engine licenses can be permanently reserved for use on a local cluster.

All access control rules are defined in the FlexNet license manager's Options (.opt) file.  

 

This page applies to:

All Floating license models

Video Demonstration

 

Contents

Options file

Example Reservations

User reservation

Group reservation

Multiple licenses

Keywords

 


The Options file

Location of Lumerical's Options File

Windows: C:\Program Files (x86)\Lumerical\Lumerical-FlexLM\licenses\LUMERICL\LUMERICL.opt

Linux: /opt/lumerical/lumerical-flexlm/licenses/LUMERICL/LUMERICL.opt

MacOS: /opt/lumerical/lumerical-flexlm/licenses/LUMERICL/LUMERICL.opt

 

Update the options file based on your requirements.

See specific sections and examples below for details. Administrator access will be required to edit this file.

 

Re-start the vendor daemon

1.Go to FlexNet license manager dashboard by visiting http://localhost:8095/ on your license server

2.Click Administration

3.If you haven't logged in yet, enter the user name and password for license administrator (default would be admin for both)

4.Click Vendor Daemon Configuration from the list of options on the left

5.Click the Vendor Daemon (LUMERICL) from the vendor daemons list

6.Click Reread License Files

7.If the option file is configured correctly, you should be able to notice the difference on FlexNet license manager dashboard

install_flexnet_adv_restrict_access_zoom61

 

Alternatively, if the web based dashboard is not available or you prefer to work from the command line, see restarting the license manager.  

User reservations

The following option file code will reserve one FDTD Solutions design license and two FDTD Solutions engine licenses for the USER named 'bill'.

RESERVE 1 FDTD_Solutions_design USER bill

RESERVE 2 FDTD_Solutions_engine USER bill

Group reservations

The following option file code will reserve 2 FDTD Solutions licenses (both the design and engine components) for a group of users that includes 'bob', 'john' and 'tim'.

#Define the members of each group

GROUP ResearchLab bob john tim

 

#Define the restrictions 

RESERVE 2 FDTD_Solutions_design GROUP ResearchLab

RESERVE 2 FDTD_Solutions_engine GROUP ResearchLab

Multiple licenses

Group reservations using multiple license with different expiry dates.

 

Suppose Group A has a license of FDTD Solutions that will expire on January 31 and Group B has a license of FDTD Solutions that will expire on March 31. The two groups don't want to share licenses, especially after Group A's license expires.

 

The duplicate product means that there will be duplicate features of FDTD_Solutions_design and FDTD_Solutions_engine. Therefore you have to specify your features using keyword-value pair. The following syntax will be used:

featureName:keyword=value

 

There are many possible keyword combinations that could be used. In this case, the easiest option is to use the EXPDATE keyword (the expiry date of the license).  The final options file would look something like this:

#Define the members of each group

GROUP GroupA bob john tim

GROUP GroupB anna suzanne 

 

#Define the restrictions 

RESERVE 1 FDTD_Solutions_design:EXPDATE=31-jan-2013 GROUP GroupA

RESERVE 1 FDTD_Solutions_engine:EXPDATE=31-jan-2013 GROUP GroupA

RESERVE 1 FDTD_Solutions_design:EXPDATE=31-mar-2013 GROUP GroupB

RESERVE 1 FDTD_Solutions_engine:EXPDATE=31-mar-2013 GROUP GroupB

Option file keywords

 

USER : Defining a user that for use with an option. This option is case sensitive.

Syntax

USER username

Example: To reserve FDTD Solutions to USER bill

RESERVE 1 FDTD_Solutions_design USER bill

RESERVE 1 FDTD_Solutions_engine USER bill

 

GROUP : Define a group of users for use with any options. This option is case sensitive.

Syntax

GROUP group_name user_list

Example: To define the group researchers consisting of users tom, jim, and bill

GROUP researchers tom jim bill

 

NOTE: Please ensure that each USER would only belong to ONE Group.

 

HOST_GROUP : Define a group of hosts (computers) for use with any options. This option is case sensitive.

Syntax

HOST_GROUP group_name host_list

Example: To define the host group HPCcluster consisting of nodeOne, nodeTwo, and nodeThree

HOST_GROUP HPCcluster nodeOne nodeTwo nodeThree

 

NOTE: Please ensure that each Host Name would only belong to ONE Host Group.

 

INCLUDE : Allow a user or predefined group of users/hosts to use a feature.

Syntax

INCLUDE feature type {name | group_name}

Example: To allow any user from the group researchers to use FDTD_Solutions_design feature

INCLUDE FDTD_Solutions_design GROUP researchers

 

INCLUDEALL : Allow a user or predefined group of users/hosts to use all features served by this vendor daemon.

Syntax

INCLUDEALL type {name | group_name}

Example: To allow the user jane to use all the features served by this vendor daemon

INCLUDEALL USER jane

 

EXCLUDE : Deny a user or predefined group of users/hosts access to a feature.

Syntax

EXCLUDE feature type {name | group_name}

Example: To exclude any host from the group HPCclusters to use FDTD_Solutions_design feature

EXCLUDE FDTD_Solutions_design GROUP HPCclusters

 

EXCLUDEALL : Deny a user or predefined group of users/hosts access to all features served by this vendor daemon.

Syntax

EXCLUDEALL type {name | group_name}

Example:

To exclude any user on the system called sky and prevent them from using all features served by this vendor daemon

EXCLUDEALL HOST sky

 

RESERVE : Reserve licenses for a user/host or predefined group of users/hosts.

Syntax

RESERVE num_lic feature type {name | group_name}

Example: To reserve one license of feature FDTD_Solutions_design for user jill

RESERVE 1 FDTD_Solutions_design USER jill

 

EXPDATE : Specify the expiration date of the feature to be reserved to predefined user/host or group of users/hosts.

Syntax

EXPDATE={expiry_date}

Example: To reserve one license of FDTD_Solutions_design with expiry date 31-jan-2017 for group grp1

RESERVE 1 FDTD_Solutions_design:EXPDATE=31-jan-2017 GROUP grp1

 

Note: Please ensure that the feature and expiry date are available and as shown on the license details.

 

NOTICE : Specify the account/owner of the license as listed on the license details/license file. (use quotes to define feature and account)

Syntax

NOTICE={Account Name}

Example: To reserve one license of FDTD_Solutions_design to account, Lumerical Solutions (Lito Yap) [LS-0001] for group lab1

RESERVE 1 "FDTD_Solutions_design:NOTICE=Lumerical Solutions (Lito Yap) [LS-0001]" GROUP lab1

 

Note: Please ensure that the feature and account name are as shown on the license details.

 

INTERNET : Define the network IP address or range of IP Address for a specified option.

Syntax

INTERNET 192.168.1.20

INTERNET 192.*

INTERNET 192.168.*

INTERNET 192.168.1.*

Example: To reserve 1 license of feature FDTD_Solutions_design to a specific IP Address

RESERVE 1 FDTD_Solutions_design INTERNET 192.168.1.100

Example: To reserve 10 license of feature FDTD_Solutions_design to a range of IPs or subnet

RESERVE 10 FDTD_Solutions_design INTERNET 192.168.1.*

 

TIMEOUT : Specify idle timeout for a feature, returning it to the free pool for use by another user.

Syntax

TIMEOUT {feature_name} timeout_in_seconds

Example: To check a specific license feature every 120 seconds and "check in" the license feature if not used.

TIMEOUT FDTD_Solutions_design 120

 

Note: Please ensure that the feature is as shown on the license details.

 

TIMEOUTALL : Specify idle timeout for all features available on the license manager.

Syntax

TIMEOUTALL timeout_in_seconds

Example: To check all license features every 120 seconds and "check in" all licenses features that are not used.

TIMEOUTALL 120

See also:

Obtaining the license information details

Lumerical Products' license features

Copyright Lumerical Inc. | Privacy | Site Map