FLM 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 Four Js License Manager 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.

The FLM configuration file has changed

The default configuration file for FLM 6.00 is now $FLMDIR/etc/flmprofile; the file $FLMDIR/etc/lmprofile is no longer relevant and is no longer provided. The new configuration file involves a new format and has new entries. For more information and to discover available configuration options, see Configure the License Manager.

You can enter your configuration details in the default file provided, or you can specify a different configuration file, as described next.

Specifying the configuration file

You can define environment variables to specify the FLM configuration file (FLMPROFILE) or the license controller configuration files (FGLLICENSE and GRELICENSE) to use.

Starting at FLM 6.00.10, the FLM reads a single configuration file only. If the environment variable for the FLM configuration file or the license controller configuration file environment variable is set, the file identified by that variable is used; otherwise, the default file located in the product installation directory is used.

For example, if FLMPROFILE is set, the file specified will be used and the FLM configuration file $FLMDIR/etc/flmprofile will be ignored.

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

FLM default communication port

Service or port number for the communication between the license controller and FLM has changed from 6399 to 6800.

For more information, see Configure the License Manager and Configure a Genero license controller.

flmprg command --validate-configuration

Starting at version 6.00.12, the flmprg --validate-configuration command is added to validate the FLM configuration. After making changes to the flmprofile FLM configuration file, it is advised to run this command to validate the configuration entries.

For more information about flmprg see FLM (flmprg) options.

Sharing similar licenses between a user pool

Starting at version 6.00.13, license sharing can be configured. For example, if one license had 5 users and the other license had 10 users, the FLM allows you to share these two licenses amongst a cumulative pool of 15 users.

This version of the license sharing feature has changes to how this feature was configured in version 5.20. In FLM 5, license sharing was enabled with the fglprofile entry: flm.license.shared="1". When enabled, the license manager would automatically share all "compatible" licenses.

In FLM 6 you have more control over what licenses you can share. The license share must be declared in the flmprofile file. Muliple shares can be declared and used.

For more information on configuring license sharing, see Manage license sharing (flmprg).

Changes to the ping mechanism

Starting at version 6.00.13, the ping mechanism the FLM uses to receive regular pings from clients that are active can not be disabled. If previously you had configured FLM to disable the ping by setting client.ping.interval=-1 in the flmprofile file, this will now be ignored.

You can configure the ping interval value, but if the value is not acceptable (for example, less than 1 or greater than 60 seconds), a warning is raised and the default (5 seconds) is used.

For more information about configuring the FLM, see Configure the License Manager.

Changes to running flmprg commands in Windows

In a Windows system, some flmprg licensing 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, see FLM (flmprg) options and FLM_BYPASS_UAC.