Licensing 6.00 upgrade guide

These topics describe product changes you must be aware of when upgrading to version 6.00.

Important:

This is an incremental upgrade guide that covers only topics related to the Genero version specified in the page title. Check prior upgrade guides if you migrate from an earlier version, and complete the migration tasks for all versions between your existing version and the target version in order. Make sure to also read about the new features for this version.

Corresponding new features page: Licensing 6.00 new features.

License controller configuration

Configuring a license controller is no longer handled in the FGLPROFILE file. Each license controller now has its own dedicated configuration file.

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.

For more information, see Configure a Genero license controller.

Licensing Genero in a Docker container requires the FLM

Genero 3.21 requires the use of the Four Js License Manager 6.00.

It is no longer possible to license using the local license controllers (fglWrt or greWrt) to assign the license installed on the host machine to that running in a Docker container. The license controller options of docker-assign and docker-release are no longer present.

For instructions on licensing your docker container, see the Four Js License Manager User Guide.

Force log rotation with the --log-rotate option

Starting at 6.00.12, the --log-rotate option of the license controller (fglWrt or greWrt) can be used to force a log rotation on demand.

fglWrt --log-rotate
This command forces a log rotation. It closes the current log file and starts a new log file, just as if the log rotation had been triggered by the maxsize value. You may wish to force a log rotation when you are asked to send a log file to Four Js, or move a log file to another location. This command and option can be executed at any time; even while log files are in use.

For more information see License Controller (fglWrt) or License Controller (greWrt) and License logs.

Multiple configuration files

Starting at 6.00.12, you can specify one or more configuration files for the license controller using the environment variable FGLLICENSE.

For more information on setting these environment variables for multiple configuration files, see Specify the licensing configuration file.

Client license status check supported in compatibility mode only

Starting at 6.00.13, the user.check setting of the fgllicensegrelicense license controller configuration file is only supported in Genero installations prior to 3.21 running in compatibility mode with FLM 6.

In compatibility mode, the FLM ping mechanism, which confirms the client's active status, can not be used. Instead the user.check (PID mechanism) is used to confirm the client's active status.

If you have Genero installations prior to 3.21 running in compatibility mode, the user.check setting is used to configure the frequency of requests between active users checks.

For more information, go to Configure a Genero license controller.

Changes to running licensing commands in Windows®

In a Windows system, some fglWrt or greWrt commands will only work if run as administrator, and a Microsoft® User Account Control (UAC) prompt will be raised to open an elevated command terminal where you can complete the action.

To change to the old method for running commands, set the environment variable to disable the UAC prompt: FLM_BYPASS_UAC=1. Be aware that with the UAC prompt disabled, you will need to open a terminal with "Run as Administrator" to run commands that need administrator privileges.

For more information, go to License Controller (fglWrt) or License Controller (greWrt) and FLM_BYPASS_UAC.

For more information about the FLM_BYPASS_UAC environment variable, see the Four Js License Manager User Guide.

Licensing upgrade packages upgrade tool

Starting at 6.00.13, the licensing upgrade packages provided on the Four Js website now include an upgrade tool for patching the license controllers (fglWrt or greWrt) with the latest version. Where before you applied the upgrade manually, now you can run the upgrade tool (upgrade-fglwrt or upgrade-grewrt) to perform the upgrade. For more information on patching a license controller using the upgrade tool, go to License upgrade tool (upgrade-fglwrt) or License upgrade tool (upgrade-grewrt), and Patch license controller using the upgrade tool.