EDA Solutions logo

Reserve or block users from a license – Galaxy Semiconductor

This technical note describes how to create a license option file to create user groups and how to reserve or block users from a particular license.  

Step 1: Create an Options file

  1. Go to the vendor daemon directory and create a text file called ‘galaxylm.opt’.  This should be the same directory where the license file is located
    • Windows default location: C:\Program Files\Galaxy License Activation Utility\fnp_utils\galaxylm\galaxylm.opt
    • Linux default location: /opt/galaxy-la-<version>/fnp_utils/galaxylm/galaxylm.opt
  2. Using a text editor, add the desired keyword and syntax (see Options file keywords) and save the file.

Options file keywords and syntax

KeywordDescription and syntax
USERName of the user executing the licensed application.
This is case sensitive and must match the user login name on the client system checking out the license. If the username contains spaces, it must be enclosed in double quotation marks; otherwise, it will be treated as different users.

Syntax: USER <User List>Example: USER “Junesh Rahman” Artis “Tan Seng Chuan”
RESERVEThis option keyword is used to reserve license to certain users or group.
Any licenses reserved for a user are dedicated to that user. Even when that user is not actively using the license, it is unavailable to other users. However, a RESERVEd license does not cause usage to be reported by FlexNet Manager if the license is not actually in use.

Syntax: RESERVE <Number of License to Reserve> <Feature or Product ID> <Restriction Type> <Name>Example: RESERVE 2 GEX-Pro GROUP “PE Support”
EXCLUDEThis option keyword blocks a user or predefined group of users from the list of two is allowed to use the feature.  

Syntax: EXCLUDE feature[:keyword=value]  type  {name  |  group_name}

Example: EXCLUDE GEX-Pro USER lchang
Example: EXCLUDE GEX-PAT INTERNET 172.30.104.108
GROUPName of the group executing the licensed application.
If the group name contains spaces, it must be enclosed in double quotation marks. It is NOT necessary to define USER first before including in a GROUP; users can be directly defined into a GROUP.

Syntax: GROUP <Group Name> <User List>Example: GROUP “PE Support” User1 “User 2”

Example Options File

GROUP PAT user1 user2
GROUP GEX user3 user4 user5
GROUP BAD user6 user7
RESERVE 1 GEX-PAT GROUP PAT
RESERVE 3 GEX-Pro GROUP GEX
EXCLUDE GEX-Pro GROUP BAD

Step 2: Update Galaxy license file to load the Options file

  1. Go to the vendor daemon directory and edit the license file (galaxylm.lic).
    • Windows default location: C:\Program Files\Galaxy License Activation Utility\fnp_utils\galaxylm\galaxylm.opt
    • Linux default location: /opt/galaxy-la-<version>/fnp_utils/galaxylm/galaxylm.opt
  2. In the same line as the VENDOR line and before the PORT definition (if any), add the options keyword with the full path and filename of the options file.

Note: The location of the OPTIONS keyword must be exact or the options file will not load properly.

Example License file

SERVER this_host ANY 27000
VENDOR galaxylm "/opt/galaxy-la/fnp_utils/galaxylm/galaxylm" OPTIONS="/opt/galaxy/licreserve.opt" PORT=55227
#This increment is only for vendor daemon initialization
 
INCREMENT GEX-Init galaxylm 1.0 permanent uncounted \
  VENDOR_STRING="Galaxy Semiconductor" HOSTID=ANY TZ=SERVERTZ \
  ISSUER="Galaxy Semiconductor"  SIGN="..."

Step 3: Re-read the License file

Re-read the license file using the lmadmin web portal.