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.

Warning: 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.
  1. 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.

  2. 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 the maxfiles value, for example, flmprgd.log, flmprgd.1.log, flmprgd.2.log, etc. It deletes the file that exceeds the maxfiles 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=seconds 5 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 by name that licenses may be reserve for. For more information on configuring license reservation, see Manage license reservation (flmprg).
    Resource Default value Description
    names=user_group none Identify users. Specify them in a comma-separated list. For example,
    [reservations]
    names=svc,qa
    Where "qa", might identify licenses reserved for users testing applications.
    [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_number
    Warning: 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:
    license_number="hostname"
    For more information about configuring access, see Restricting access to licenses.
    [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:
    license_number="hostname"
    For more information about configuring access, see Restricting access to licenses.