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 4.01 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.

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 Log files and debugging.

Multiple configuration files

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

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

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, see License upgrade tool (upgrade-fglwrt), License upgrade tool (upgrade-grewrt), and Patching a license controller .