USA +1 866 806 2068 | UK +44 203 1292 513 | JAPAN +81 3 45208991 担当:萩原 info@openlm.com

Options File management Using OpenLM EasyAdmin v2.0 – AN3007

FLEXlm ( FlexNet publisher ) Options file  grants license administrators close control over various operating parameters within the constraints of the license model. Licensed features can be dedicated, denied or reserved to users or groups of users, as well as Hosts, IPs, and Host Groups according to the Options file setting.

Employing FLEXlm Options file, the license administrator can:

1. For concurrent (floating) licenses:

  • Allow the use of features

  • Deny the use of features

  • Reserve licenses

2. For all license types:

  • Restrict the number of licenses available

  • Control the amount of information logged about license usage

  • Enable a report log file

  • Control the automatic rereading of licenses

FLEXlm Options file are implemented as text files, located on the license server. Although  this method fits the licensing requirements well, the process of creating and maintaining Options files is error-prone and difficult to maintain.

The OpenLM solution incorporates synchronization of License administration tools with the organization’s LDAP (Active Directory), keeping the FLEXlm Options file up-to-date as users leave or join the organization, or move between groups.

Creating an Options File

1. The Options file should be placed under the same directory as the vendor daemon file, in order to enable FLEXlm to read it automatically. Locating the Options file in a different folder is possible, but this requires FLEXlm to be configured to search for it in that particular location.

2. The recommended name for the Options file is vendor.opt, where vendor is the vendor daemon name ( e.g.: for the ESRI ArcGIS vendor: arcgis.opt is recommended). Note: The name should not contain any blank spaces, use an underscore _ if need to create a separation between words, otherwise name will not register. i.e.: “Vendor name.opt” is not recognized.

FLEXlm Options file editing

When configuring the Options file using OpenLM, the configuration data is presented to the OpenLM Server, and forward by it to the OpenLM Broker, located on the license server machine. The OpenLM Broker updates the Options file.

OpenLM Server Configuration

 

To arrange the OpenLM Server Configuration, follow the following path, (“Windows Start →All Programs →OpenLM →Configure OpenLM Server” )

Select the Advanced tab and depending on the flow of action (writing or reading) select the proper button in the box labeled  Direction of Options file data flow.

r1

OpenLM Broker Configuration

It is necessary to install the OpenLM Broker on the license server machine in order to edit the Options file using the OpenLM EasyAdmin web application. An indication to proper Broker configuration is the green ‘LED’ submenu indication on the EasyAdmin  License servers window.

r2

 

Information about the OpenLM Broker and its installation process is available here:

Application Note (3004b) OpenLM v2.0: Broker Comprehensive Installation Guide

 

The latest OpenLM Broker version is available for download in the downloads section HERE.

After creating an Options file on the license server machine configure the OpenLM Broker to work with it:

1. Open the OpenLM Broker Configuration Tool installed on the license server machine

(Windows’ Start → All Programs → OpenLM → Broker → OpenLM Broker Configuration Tool).

2. In the Broker Configuration Tool window, Click the (+) bullet below the License Servers to expand the License server menu in the configuration window.

3. Click the (+) bullet and expand the Port Node (e.g. Port 27000.)

4. Click the (+) bullet to expand the Vendors file.

5. Input a particular Vendor name (Case sensitive)

6. Input in the Options file Path and provide it a name (e.g.: “MyOptionFile”)

7. Type in the path to the Options file previously created.

8. Click Advanced>> and check the Watch Options file box.

9. Click the Apply and Restart Broker buttons.

r3

Editing Options files

Options file targets: Users, User groups, Hosts, Host Groups and IPS

 

Options files apply license constraints to certain target categories; namely Users, User groups, Hosts, Host groups and IPs. Setting up and introducing these targets is beyond the scope of this article. Read this Application Note (skip down to the Appendixes at the end of the document) to review the subjects listed directly below:

  • Introduction of Users and User groups

  • Add multiple IP addresses.

  • Hosts and Host Groups.

In order to edit Options files, select a specific Options file, and then apply changes to it.

Options file Selection

1. Open the OpenLM EasyAdmin web application

2. Click StartOptions fileOpt. File Admin. The Options file Administration window opens

3. Select the specific Options file to be edited (e.g.: Autocad Options file) and click Set

 

Global Setting of the Vendor Daemon

1.  Open the OpenLM EasyAdmin web application

2.  Click Start →  Options file → Opt. File Management

    The Policy of… Options file window opens.

3.  After inserting information, click Save

policy

This window is comprised of several text boxes:

GROUPCASEINSENSITIVE (OFF / ON)

ON: User names and host names specified with the Options File GROUP and HOST_GROUP keywords respectively, are treated as case insensitive.

OFF (Default): User names and host names are treated as case sensitive.

NOLOG { IN | OUT | DENIED | QUEUED }

Suppresses logging of the selected type of event in the debug log file.  License administrators may use this option to reduce the size of the debug log file, however it can reduce the usefulness of the debug log when debugging license server problems.

  • IN / OUT: Turns off logging of license check-ins and check-outs respectively.

  • DENIED: Turns off logging of license check-out denials.

  • QUEUED: Turns off logging of queued license requests.

REPORTLOG

Specifies the report log file for this vendor daemon. It is recommended to precede the report_log_path with a ‘+’ character to append logging entries; otherwise the file is overwritten each time the daemon is started.

TIMEOUTALL

Specify the idle timeout for all features, after which an inactive license is reclaimed. The software publisher sets a minimum value. If a smaller value is set – it is ignored, and the publisher’s minimum value is used.

DEBUGLOG

Writes debug log information for this vendor daemon to the specified file.

Note that this affects output from only the vendor daemon associated with this options file. The debug log output of lmadmin or lmgrd and any other vendor daemons in the same license file is not captured in this file.

Click Save in order to retain the edited configuration.

Feature Settings

1. Open the OpenLM EasyAdmin web application.

2. Click Start  →  Options file → Opt. File Admin.

3. The Features of Options file window opens, according to the Options file selected before. This window enables the configuration of each feature separately, applying changes either globally or to specific Users, User groups, Hosts, Host groups and IPs.

a. Select a particular Feature, the Permission column will be populated.

b. Select the Users tab (in lower window).

c. Click the Add icon. The Users search window appears.

d. Mark user(s) from the Users search window, and click the Select icon. The selected

   users are added.

3

4. Select as many permission values as needed, and set the value(s) as according to the definitions mentioned here:

BORROW_LOWWATER:

Sets the minimal number of BORROW licenses that cannot be borrowed, i.e: the minimal number of licenses that need to remain as Network licenses. For example, if FEATURE has a count of 10, borrowing is enabled in the application, and BORROW_LOWWATER = 7 then only 3 licenses may be borrowed. This option is used for licenses held in license files.

LINGER:

A lingering license stays checked out for a specified period of time beyond its check-in or FlexEnabled application exit, whichever comes first. This configuration enables users to extend the linger time for a feature beyond its check in.

Note:

  • The software publisher sets a minimum linger value. If a value smaller than the minimum is configured, the minimum value is used.

  • The linger time may be configured by the software publisher in the FlexEnabled application. When this is the case, the longer linger time is applied.

MAX_BORROW_HOURS:

Change the maximum borrow period for a specific feature. The new configured period value must be less than that in the license file. This option is used for licenses held in license files.

MAX_OVERDRAFT:

The overdraft policy allows a software publisher to specify a number of additional licenses which users are allowed to use, in addition to the licenses they have purchased. This allows your users to not be denied service when in a “temporary overdraft” state. The MAX_OVERDRAFT parameter Limits the overdraft usage to less than the amount specified in the license file.

TIMEOUT:

Specify the idle timeout for a feature, after which an inactive license is reclaimed. The software publisher sets a minimum value. If a smaller value is set – it is ignored, and the publisher’s minimum value is used.

Setting Restrictions on Specific Features

Some Option permissions may be applied according to the following categories: Users, Groups, Hosts, Host Groups and IP’s as shown.

 

These configurations include:

  • Reserved: Reserve licenses for a User / User group / Host / Host group of users/hosts.

  • Included: Allow a user to use a feature.

  • Excluded: Deny a user access to a feature.

  • Borrow Included: Allow a user to borrow licenses.

  • Borrow Excluded: Deny a user the ability to borrow licenses.

  • Max: Limit usage for a particular feature/group—prioritizes usage among users.

r6

Allow /Deny the Entire Vendors  Feature Set

It is possible to Allow or Deny a category of users (user\group\host\host group\IP) the entire set of features that a specific vendor daemon serves.

1. Open the OpenLM EasyAdmin web application

2. Click Start  →  Options filesAll Features

3. Add a Category of users (User \ Group \ Host \ Host Groups \ IP)

4. Check the Exclude All or Include All radio button;

  • Exclude All: Deny a user access to all features served by this vendor daemon

  • Include All: Allow a user to use all features served by this vendor daemon

5.Click Save

r7

Saving the Edited Options file on the License Server

Saving the changes made to the Options file back to the License Server

1. Open the OpenLM EasyAdmin web application

2. Click StartOptions fileOpt. File Management

3. Select the specific Options file, and click Set

4. Click Save back to server

r8

The Options file Update Mechanism

To automatically update Options file on a daily basis follow these steps:

  1. From the Opt. File Management screen, select Edit

  2. Check the box to allow the Enable Automatic Update Option files

  3. Select the update time (Be aware the time are configured using a 24-hour clock ‘Military time’) and click Save

r9