Configure a Genero license controller

Edit the license controller configuration file to configure a Genero license controller.

To use a license managed by the Four Js License Manager (FLM), you must configure the product's license controller configuration file locally with details regarding the FLM server and the license number for the product.

Locate your product's license controller configuration file.
Table 1. Genero products and license configuration files
Genero product Default license controller configuration file
Genero Business Development Language (BDL) $FGLDIR/etc/fgllicense
Genero Report Engine (GRE) $GREDIR/etc/grelicense
Tip:

Default locations of the license controller configuration files are shown. You can set the location of these files by using the FGLLICENSE or GRELICENSE environment variables.

See Specify the licensing configuration file.

  1. Set the hostname and port of the FLM server. 
    [server]
host=hostname 
port=port     # Default is 6800
  2. Add the license number. 
    [license]
# License to use with FLM service
number=license_number
  3. Add or update values for the resources shown in Table 2 as required:
    Table 2. DVM - configuration resources for License Server
    Category Description
    [server] Details of the machine that holds the license service program.
    Resource Default value Description
    host=hostname
    Warning:

    Although no default is provided, this parameter is mandatory.

    		 This value should be the same as the entry in $FLMDIR/etc/flmprofile. See Four Js License Manager configuration file.
    port=value 6800 This value should be the same as the entry in $FLMDIR/etc/flmprofile. See Four Js License Manager configuration file.
    retry=value 10 Specify the number of times the license controller retries when communication with the FLM fails or times out.
    [license] Set either the product license number or the share name for licenses that are shared, or the reservation name for licenses that are reserved for users. License number and reservation options are mutually exclusive.
    Resource Default value Description
    number=[license_number | share_name]
    Warning:

    Although no default is provided, you must set this value to use Four Js License Manager.

    		 Value of your current license number or license share. For example: number=XXX#XXXXXXXX or number="qaShare", where "qaShare" must correspond to a value in the shares entry in the FLM configuration file. For details, go to Four Js License Manager configuration file.
    Important:

    If using FLM, the license number and reservation options are mutually exclusive; you must configure one or the other, but not both. If not using FLM, license reservation is not an option; configure the license number.
    reservation= user_group none Identify users for whom licenses are reserved. For example, reservation=qa, "qa" must correspond to a value in the reservations entry in the FLM configuration file, $FLMDIR/etc/flmprofile, where license reservation is configured. See Four Js License Manager configuration file.
    Important:

    If using FLM, the license number and reservation options are mutually exclusive; you must configure one or the other, but not both. If not using FLM, license reservation is not an option; configure the license number.
    user.check=value 10 Number of requests between active users check.
    Warning:

    This feature only works in Genero 4.00 products running in compatibility mode with FLM 6. In compatibility mode, the ping mechanism can not be used, and products act as if the feature is disabled. Instead the user.check is used to confirm the client's active status.

    A value of -1 disables the feature. However, it is not recommended to disable it because the FLM needs it to recover licenses.
    [log] Enable and configure license controller logs and log rotation. For more information on configuring logs, see Log files and debugging.
    Resource Default value Description
    enabled= { true| false } false Enable or disable logging. enabled on its own is the equivalent of enabled=TRUE.
    directory=dir-path none Directory where log files are stored. For example, directory=${TEMP}/log
    categories=[ error, info, warning, debug ] none Specifies in a comma-separated list categories of errors to log. categories= "error, info, warning, debug" .
    maxsize= value { K | M | G } -1 (no limit, log rotation is not performed) Specifies log rotation. 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 2 In log rotation, specify a maximum number of log files to keep. For example, maxfiles=5. The license controller rotates files by renaming and renumbering them up to the maxfiles value, for example, fglwrt.log, fglwrt.1.log, fglwrt.2.log, and so on. It deletes the file that exceeds the maxfiles value.
    syslog={ true| false } false Redirect FLM logs to the system log of Unix-like platforms only.
    Warning:

    The syslog feature can not be enabled on Windows®.

    		 
    [client]
    Set permissions for directories, such as the lock and log, used by your product's license controller. If you do not set a umask, the default value is applied. The environment variable, FLM_UMASK, can be used to override configured values. For more information about using UMASk, go to FLM_UMASK.
    Warning:

    The UMASK feature is available on UNIX-like platforms only.

    Resource Default value Description
    umask=value 0000
    The permission mask is applied to directories used by your product's license controller. For BDL:
    • $FGLDIR/lock
    • $FGLDIR/etc
    • Log directory as defined in log
    For GRE:
    • $GREDIR/lock
    • $GREDIR/etc
    • Log directory as defined in log