Install Four Js License Manager
To centralize licensing, install the Four Js License Manager. Four Js License Manager is a separate product, to be installed in a dedicated directory with its own configuration file.
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
Installation can vary depending on the host operating system. Ensure you follow the installation instructions for your host operating system.
System requirements
For details about system requirements, refer to the Supported platforms and databases document (available on the Download page of the Four Js Web site) or contact your support center.
Upgrade the FLM without re-applying licenses
When you upgrade the Four Js license manager, you do not need to reinstall your existing licenses.
It is also recommended to upgrade the license controllers for your Genero Business Development Language (fglWrt) or Genero Report Writer (greWrt) installations at this time. See Patching a license controller.
Patching a license controller
If you need to update the license controller in order to make an older version of Dynamic Virtual Machine (DVM) compliant with the License Manager, follow the procedure described.
Genero product | Licence controller |
---|---|
Genero Enterprise | Four Js License Controller for BDL (fglwrt) |
Genero Report Engine | Four Js License Controller for GRE (greWrt) |
License controller versions
When patching a license controller, what version information do you need to examine when considering compatibility with the Four Js License Manager (FLM) and with the Dynamic Virtual Machine (DVM)?
The license controller (fglWrt) works with the DVM and the FLM; the DVM does not know about the FLM, and the FLM does not know about the DVM.
The license controller and the FLM
To examine whether a version of the license controller works with a version of Four Js License Manager, start with the axiom:
fgWrt version >= FLM version
The license controller and the DVM
While the license controller is expected to be compatible with all versions of the DVM, a DVM may require a minimal version of the license controller.
The license controller bundled with the DVM (in the FGLGWS package) is always compatible. If you attempt to downgrade the license controller, it may fail; however, an upgrade of the license controller is always allowed.
Version number commands
To find the version for the ... | Execute the command ... |
---|---|
license controller | fglWrt -V |
Four Js License Manager (FLM) | flmprg -V |
DVM | fglrun -V |
Four Js License Manager packages
The Four Js License Manager (FLM) software is a self-extractable installation program.
On UNIX™, the installation program is a shell script. On Windows, the installation file is an executable (exe) file.
A Four Js or Genero software package follows a specific naming convention:
fjs-product-version-build-osident.extension
where:
- product is the product identifier ("flm" for Four Js License Manager).
- version is the software release number.
- build is the software build number.
- osident is the operating system identifier.
- extension is the file extension: sh or run on UNIX platforms, exe on Windows platforms, and dmg or run on macOS™ platforms.
Launching the installation
Four Js License Manager can be installed on Windows, UNIX, or macOS platforms.
Install Four Js License Manager on UNIX platforms
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
-h
) option:sh fjs-flm-5.10.3a-build333-lnxlc23.run -h
When installation is complete, see License Manager configuration for configuration information and instructions.
Install Four Js License Manager on UNIX platforms in silent mode
Install Four Js License Manager silently on Gnu/Linux and UNIX platforms.
To start the installation, type the following:
./fjs-flm-version-buildYYYYMMDDhhmm-osident.run -a -q -t install_dir
For example:
./fjs-flm-5.20.17-build202005061204-l64xl25.run -a -q -t $PWD/fjs-flm-5.20.17
Options
Table 3 shows the most common options relating to installation.
Install option | Description |
---|---|
-a or --accept |
Bypass the display and the prompt for acceptance of the license
agreement. Using the -a option indicates that you have read and accepted the End
User License Agreement, located on the Four Js website at http://4js.com/end-user-license-agreements/. |
-h or --help |
Display help about all possible options. |
-q or --quiet |
Silent mode with no UI. If -q is not specified,
the interactive installer is used. |
|
Specify what happens if the installation directory already
exists:
|
|
Install the product in the specified target directory. If
-t is not specified, the default installation
is used. |
Install Four Js License Manager on Windows platforms
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
When installation is complete, see License Manager configuration for configuration information and instructions.
Install Four Js License Manager on Windows in silent mode
Install Four Js License Manager on Windows platforms using the MSI installer.
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
The msiexec utility provides the means to install,
modify, and perform operations on Windows Installer from the command line. The
/qn
option allows you to install in silent mode. The
msiexec utility expects an msi file. To be
compliant with Microsoft® User Access Control
(UAC) requirements, the msi file is embedded inside an
exe file. To extract the msi file from the
exe file, use the /x
option:
fjs-product-version-build-osident.exe /x
For example:
fjs-flm-5.20.17-build202005061204-w64v141.exe /x
A msi file is created in the same directory and with the same name as the exe file.
Options
Table 4 shows the most common options for msiexec relating to installation and un-installation.
msiexec option | Description |
---|---|
/qn |
Silent mode with no UI. If /qn is not
specified, the graphical installer is used. |
/i package-name.msi
|
Install the specified msi package. |
/x package-name.msi
|
Uninstall the specified msi package. |
/log logfile
|
Write processing info to the specified log file. |
/l*vx logfile |
Provide verbose (detailed) logs in the specified log file |
Enter msiexec from the command prompt to view the complete list of available options.
Arguments
You can pass arguments to the msiexec installer on the command line.
Argument | Description |
---|---|
PRODUCTDIR=your_flmdir_path |
The path where FLM will be installed. It is an alias of
FLMDIR variable. |
STARTMENUFOLDER=your_startmenufolder_path
|
Customize the location for the shortcuts in the startmenu. For example, "fjs\flm". |
FORCEREMOVEPRODUCTDIR=YES |
On uninstall, force the removal of the
PRODUCTDIR directory, even if it is not empty.
For any value other than YES , keep the files in the
PRODUCTDIR location. Default value:
"" . |
FORCEINNONEMPTY=YES |
Force the installation of a folder, even if it is not empty. For
any value other than YES , do not allow installation
into a non-empty folder. Default value: "" . |
SERVICECONFIG=[NotToInstall|ServiceInstall|ServiceStart] |
Specify whether the service is installed.
|
Installing the service (Windows only)
The installation wizard gives you the option of installing the Four Js License Manager as a service.
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
flmprg --service-install
flmprg --service-start
Install FLM on macOS
The installation and licensing of Genero products requires you to read and accept the End User License Agreement, which can be found on the Four Js website at http://4js.com/end-user-license-agreements/.
You need a macOS and an user account which has administrator access level.
Download the installation package for the macOS .
Follow these instructions to install the Four Js License Manager (FLM) on macOS.
When installation is complete, see License Manager configuration for configuration information and instructions.
Setting the environment
Before starting the Four Js License Manager, the FLMDIR
and
PATH
environment variables must be set.
A script for setting the environment is created during the installation phase. Located in the
Four Js License Manager installation directory (FLMDIR
), this file is
named envflm on UNIX
platforms and envflm.bat on Windows platforms. By running this script file, the
following actions are performed:
on UNIX (using sh as shell script):
FLMDIR=/opt/fourjs/flm
export FLMDIR
PATH=$PATH:$FLMDIR/bin
export PATH
on Windows:
set FLMDIR=c:\fjs\flm
set PATH=%PATH%;%FLMDIR%\bin
Starting Four Js License Manager
To start the License Manager service, execute the following command:
flmprg -r
On Linux/UNIX, the License Manager runs as a daemon. On Windows, it runs as a service.
flmprg --service-start
Stopping license manager
To stop the License Manager service, execute the following command:
flmprg -s
Alternatively, on Windows, you can also issue the following command:
flmprg --service-stop