FLM (flmprg) options

The flmprg command line tool is used to install, upgrade, or delete Genero licenses. There are also options that apply specifically to Windows®, and options to provide various types of license information.

Syntax

flmprg [options]
  1. License management command options are described in Table 2.
  2. Batch command and batch console options are described in Table 5 and in Batch commands (flmprg).
  3. Options for use on Windows only are described in Table 6

flmprg Options

Table 1. Help and version options
Option Description
-h or --help

Display help for the license manager tool.

-V or --version Shows license manager version information.
--short-version Displays short version information about the license manager.
flmprg 6.00.05 build-202105200957 rev-5f61e35 target-w64v141
Table 2. License management options
Option Description
-L license_num license_key [ maintenance_key ] Installs a temporary license (requires license number and license key).
Note:

You can install an existing license, for example, on a new server on a temporary basis for 30 days. In that time, you validate the license with Four Js and install the Installation key (-k option) from the license validation.

--install-license-string license-string [ --auto ]

Install a license or update an installed license using the provided license string.

If --auto is provided, HTTP licensing is used (Internet connection is required).

-l [ license_num ]
Installs a license (requires license number and license key).
Note:

To escape at any stage, type "stop" at the prompt.

-m license_num

Install the maintenance or subscription key for the specified license.

-k license_num option Installation key for license validation, possible options are:
  • key : Install a key directly.
  • auto : The key is automatically installed (Internet connection is required).
-d license_num
Deletes the specified license.
Important:

You cannot remotely add or remove licenses registered on Four Js License Manager (FLM) with a local license controller command, for example, fglWrt.

-a option
Check or view various license information, possible options are shown in the table.
Option Description
env Shows current environment.
hostname Shows name of the host machine.
cpu Shows number of CPUs in the computer.
info license Shows license information.
info users Shows all registered active users.
info up Checks if the FLM is started.
--decode-license-string license-string Decode a license string and write the license string information to the standard out.
--encode-license-string [ license_num ] [license_key] [ maintenance_key | subscription_key ] [login ] Encode license information into a license string that is written to the standard out. See Encode a license string.
Table 3. Registered user management options
Option Description
-u or --verify-users [ host | all ]

Checks active users working on a given host.

-u all checks users on all machines.

-i or --clear-sessions [ license_num | all ]
Clears the list of registered user sessions for a given license.
Warning:

All active users will be disconnected.

Use -i all to clear lists for all licenses.

-x or --kill-session[host : pid | host ] Kills all sessions owned by the specified host, if pid is provided, only the specified session is cleared.
Table 4. Service management options
Option Description
-r or --service-start

Runs the license server daemon.

-s or --service-stop

Stops the license server daemon.

--service-restart

Restart the license server daemon - same as stopping and starting the service.

-D or --no-detach

Stops the flmprg tool from detaching from the terminal and becoming a daemon.

--validate-configuration Validate the FLM configuration. If issues are found, they are displayed to the standard out. The process exit status is 0 if the configuration is valid or 1 if not valid.
Table 5. Batch command options
Option Description
--batch [ help | action=command ] Performs the specified action in batch mode.

Here command can be an action to display information, manage licenses, and view active users, etc.

Type help for instructions on its use and to display all available commands:
flmprg --batch help
You can write batch commands to a file and apply license configuration changes easily. For more information, see Batch commands (flmprg) and Batch command file.
--batch-console action=command Opens flmprg in console mode for the batch commands.
C:\fgl>flmprg --batch-console
$ action=product-info
{
  "product": "flmprg",
  "version": "6.00.05",
  "wrtminver": "6.00.05",
  "build": "202105200957",
  "git-rev": "5f61e35",
  "target": "w64v141",
  "status": 0,
  "status-msg": "Success."
}
$ 
The output is JSON formatted. You can enable / disable indentation on the output. The default is indented. To quit the console type exit. Type help for instructions on its use.
Table 6. Windows only command options
Option Description
--service-install

Installs the service and exits.

--service-uninstall

Uninstalls the service and exits.

Table 7. Log rotation
Option Description
--log-rotate

Force log rotation. For more information on log file rotation, see Log file rotation