The options file allows the system administrator to control various operating parameters of FLEX lm . Specifically the system administrator can:
1. Use the appropriate options listed in Customizing the Options File to create the options file using any text editor. You can put the options file anywhere; however, we recommend that the option file for vendor xyz be placed in/usr/local/flexlm/options/xyz.opt .
You can include comments in your options file by starting each comment line with a pound sign "#". Everything in an options file is case sensitive. Be sure that user names and feature names, for example, are entered correctly.
Includes a user, host, display, or group of users in the list of users allowed to use all features served by this vendor daemon. Anyone not in an INCLUDEALL statement will not be allowed to use that feature.
Note: Any licenses reserved for a user are dedicated to that user. Even when that user is not actively using the license, the license is unavailable to other users.
Note: In FLEX lm v3.0 multiple GROUP lines add all the users specified into the group. Pre-v3.0 FLEX lm daemons do not allow multiple GROUP lines to concatenate.
TIMEOUT removes a feature from a user if he has been "idle" for a period longer than the specified time period, and someone else wants the license. The daemon declares a process idle when it has not heard from the process (the client sends heartbeats). The application must explicitly declare itself idle for this to work, or it must be stopped (^Z).
The application vendor can also disable the timeout feature, in which case the TIMEOUT option has no effect. The vendor can set a minimum value for the timeout. If you specify a timeout value smaller than the minimum, the minimum is used. The default minimum value is 9000 seconds (15 minutes).
When the vendor daemon is started by
lmgrd , it is passed the location of the options file. The location is specified inlicense file for that product, in the DAEMON line. If no file is listed the daemon will not use any options file.
Before you can use options to secure licenses effectively you must understand the options file precedence. INCLUDE and EXCLUDE statements can be combined in the same options file and control access to the same features. When doing so, keep in mind the following:
Once you create an INCLUDE or EXCLUDE list everyone else is implicitly "outside" the group. This feature allows you, as an administrator, the ability to secure licenses without having to explicitly list each user that you wish to allow or deny access to. In other words there are two approaches; you can either:
The sum total of the licenses reserved must be less than or equal to the number of licenses specified in the FEATURE line. In the example above, there must be a minimum of four licenses on the "compile" FEATURE line.
Note: The previous example should appear on one line in your license file for pre-v3.0 FLEX lm software. After v3.0, it can appear either on one line, or continued on a second line as shown.
Each INCLUDE, INCLUDEALL, EXCLUDE, EXCLUDEALL, and RESERVE line must have a single user name (or group) listed. To affect more than one user name create a GROUP. For example to exclude "bob," "howard," and "james" from using the feature called "toothbrush" we could create the following options file:
There is an easier way though. Create a GROUP and exclude the list of users from using the feature. Like the previous example, the following options file would exclude "bob", "howard" and "james" from using the feature called "toothbrush":
- # First define the group "Hackers"
- GROUP Hackers bob howard james
- # Then exclude the group
- EXCLUDE toothbrush GROUP Hackers
Note: In FLEX lm v3.0 multiple GROUP lines will add all the users specified into the group. Pre-v3.0 FLEX lmdaemons do not allow multiple GROUP lines to concatenate.
The GROUP function only works for a list of user names. To allow, deny or reserve licenses for multiple hosts or displays you must use multiple option lines. For example, to exclude all users logged in on the hosts "fred" and "barney" from using a feature called "f1" add these lines to your options file:
- #First Define the group "painters"
- GROUP painters picasso mondrian klee
- EXCLUDE spell GROUP pinters
- EXCLUDE spell USER bob
- EXCLUDE spell HOST bigbrush
Note that "bob" could have been added to the group painters. However, "painters" might be used for some other purpose in the future so the system administrator chose to handle "bob" as a special case here. In this case, the two EXCLUDE statements concatenate to create a list of four users.