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.

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 variables FGLLICENSE and GRELICENSE.

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