Configure the License Manager
Configuration of the Four Js License Manager (FLM) is managed by the FLM configuration file. The FLMPROFILE environment variable specifies the configuration file to use; if not set, $FLMDIR/etc/flmprofile is used.
The configuration file is in the INI format. Configuration entries are in the format
name-of-resource=value
. For more information about using the
configuration file, see Example: flmprofile.
After making a configuration change, you will need to restart the FLM (at the command line type flmprg --service-restart to start the server). For more information, see Starting Four Js License Manager and Stopping license manager.
Sharing licenses of the same product, type, and option between a cumulative group of users, as
previously set by flm.license.shared
, is not yet available in FLM 6.00.
-
To set the value for the FLM server resource, update the host entry under the
server
element with the name of your host:The default is localhost.# FLM host host=localhost # Default service port port=6800
Note:Working with Docker on macOS™:
If you are hosting FLM and docker containers on the same host, it is recommended to configure a mapping to the localhost using a special DNS name which will resolve to the internal IP address used by the host; regardless of changes in the network. See Configure license with FLM for docker on macOS host.
-
Add or update values for the resources shown in Table 1 as required:
Table 1. License Manager Configuration categories and resources Category Description [server]
Configure details of the machine that holds the license service program.Resource Default value Description host=hostname
localhost The value is the host name of the machine. port=value
6800
Specify the port on which the FLM listens. pidfile=filename
none Specify a file that holds the process id of the FLM. For example, pidfile="${FLMDIR}/pidfile"
[log]
Enable and configure FLM licensing logs. For more information on configuring logs, see Log files and debugging.Resource Default value Description enabled=
{
true|false}
FALSE
Enable or disable logging. directory=dir-path
none Directory where log files are stored. For example, directory="${FLMDIR}/log"
categories=
[
error, info, warning, debug]
none Specifies in a comma-separated list categories of errors to log: categories= "error, info, warning, debug"
The
debug
category will produce an additional log file with the extension .dlog.maxsize= value
{
K | M | G}
-1 (no limit) Set the maximum size for the log file. The size value can be in kilobytes, megabytes, or gigabytes. For example, maxsize=512M
. When the size is reached, the file is closed and a new one is created.maxfiles=value
-1 (no limit) Specify a maximum number of log files to keep. For example, maxfiles=5
. The FLM rotates files by renaming and renumbering them up to themaxfiles
value, for example, flmprgd.log, flmprgd.1.log, flmprgd.2.log, etc. It deletes the file that exceeds themaxfiles
value.[client]
The client pings the FLM server every 5 seconds (default value) to confirm its active status. If the ping is not received, the FLM kills the session and recovers the license.Warning:This feature only works in Genero 4.00 products. In compatibility mode, the ping mechanism can not be used, and products act as if the feature is disabled.
Resource Default value Description ping.interval=
seconds5 seconds Specify the interval in number of seconds the client must ping the server. The ping mechanism can be disabled by setting ping.interval=-1
[reservations]
Identify users or group of users for whom licenses may be reserve. For more information on configuring license reservation, see Manage license reservation (flmprg). Resource Default value Description names=
user_groupnone Identify users. Specify them in a comma-separated list. For example,
Where "qa", might identify licenses reserved for users testing applications, and "svc" for users using Web services.[reservations] names=svc,qa
Note:There is no restriction on the names you choose for user groups. You can set them as you wish.
[reservation.reservation_name]
Declare details for a specific reservation: the reservation_name as defined in [reservations], the license it affects, and the number of reserved licenses.Resource Default value Description license=
license_numberWarning:Although no default is provided, you must set this value to reserve user licenses.
Specify the license number to use for reservation. (For example: number=XXX#XXXXXXXX
)count=value
none Number of licenses reserved for users. [reservation.qa] license=TAB#XXXXXXXX count=15
[access.deny]
Deny access to the FLM from the specified host, or host with the specified license. Hosts are specified in a comma-separated list inside quotes:
For more information about configuring access, see Restricting access to licenses.license_number="hostname"
[access.allow]
Allow access to the FLM from the specified host, or host with the specified license. Hosts are specified in a comma-separated list inside quotes:
For more information about configuring access, see Restricting access to licenses.license_number="hostname"