License Controller (fglWrt)

The fglWrt command line tool is used to install, upgrade, or delete Genero BDL licenses. There are also options to provide various types of license information and statistics.

Syntax

fglWrt { import-license | [ options ] }

options are described in fglWrt Options.
The import-license command is used to import a license from another product installation. There are options specific to this command, and these are described in the next paragraph.

Syntax 1: import-license command

fglWrt import-license [ options ]

The import-license command imports a license from another product installation.
options are described in Table 2.

fglWrt Options

Table 1. fglWrt options
Option	Description
`-h` or `--help`	Displays options for the tool.
`-V` or `-version`	Displays version information.
`--short-version`	Displays short version information.
`-L` `license license_key [ maintenance_key \| subscription_key ]`	Installs a temporary license (requires license number and license key). For example, you can install an existing license 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` `license_key [ maintenance_key \| subscription_key ]`	Installs a license. To escape when prompted to enter a license number and license key, type "`stop`" at the prompt.
`-m option`	Maintenance key installation, possible options are: `key` : Install a key directly. `auto` : The key is automatically installed (Internet connection is required).
`-u`	Check for active users.
`-k 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`	Remove current installed license.
`--decode-license-string license-string`	Decode the license string and write the license string information to the standard out.
`--encode-license-string [ license ] [license_key] [ maintenance_key \| subscription_key ] [login ]`	Encode license information into a license string that is written to the standard out.
`-i`	Clears the list of registered user sessions.
`-a option`	Check or view options. Here `option` can be one of the following: `info users` : Shows information about registered active users. `info license` : Shows license information. `cpu` : Shows number of CPU in the computer. `up` : Shows if license server is up and responding. `ps` : Shows processes on this machine. `env` : Shows current environment `hostname` : Shows name of this machine.
`-x` or `-kill-session pid`	Clears the session referenced by the specified pid.
`--batch action=command`	Performs the specified action in batch mode. Here `command` can be one of the following: `target-info` (Get operating system information) `lm-info` (Get license manager information) `product-info` (Get license controller information) `license-info` (Get license information) `install-license^lnum=license_num^lkey=license_key` `uninstall-license` `install-mkey^mkey=[ maintenance_key \| subscription_key ]` `install-mkey-http^login=username^proxy=http://myproxy^proxy-port=port-number^proxy-user=proxy-user^proxy-passwd=proxy-password` `install-ikey^ikey=installation_key` `install-ikey-http^user=username^proxy=http://myproxy^proxy-user=proxy-user^proxy-passwd=proxy-password` The caret character (^) is used for parsing. There is no space allowed before or after the caret. In Windows® the caret is also used to escape special characters. To escape it, you may need to double (^^) it up. `fglWrt --batch action=install-mkey^^mkey=maintenance_key`
`--batch-console action=command`	Opens fglWrt in console mode for the batch commands. `C:\fgl>fglwrt --batch-console $ action=product-info { "product": "fglWrt", "version": "6.00.06", "wrtminver": "6.00.00", "build": "202106071541", "git-rev": "22c59c4", "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.
`--log-rotate`	Force log rotation. You can force a log rotation even while log files are in use.

Table 2. fglWrt import-license command options
Option	Description
`-h` or `--help`	Display help for the command.
`--from` `installation_directory`	Specify the product installation directory the license is to be moved from.
`--license license_num`	Specify the license number if `--from` is a Four Js License Manager installation.

Usage

The fglWrt is the command line tool you use to administer licensing:

For example:

Use the fglWrt -a info license command to get license information.
Use the fglWrt -l command to install licenses.

Running commands in Windows elevated command

In a Windows system, some fglWrt 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. If you have not started the command terminal with "Run as Administrator", the following commands will raise the UAC prompt:

fglWrt -L # install a temporary license
fglWrt -l # install a license
fglWrt -k # install an installation key
fglWrt -m # install a maintenance/subscription key
fglWrt -d # delete a license
fglWrt --install-license-string
If the commands above are run with the --batch option, the UAC prompt is raised too.
fglWrt import-license

Commands will fail if you cancel the prompt and run without administrator privileges. If you are an administrator, or have administrator privileges, you can validate the UAC by clicking Yes. Once you have validated the UAC, an elevated command terminal is opened where you can complete the action.

Tip:

If you need to disable the UAC prompt, you can set the environment variable 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.