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.

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.

FLM and Genero compatibility

With Genero 4.00 or greater, you must use Four Js License Manager (FLM) 6.00.

Upgrade the FLM without re-applying licenses

When you upgrade the Four Js license manager, you do not need to reinstall your existing licenses.

  1. Make a backup copy of your FLM configuration file, FLMDIR/etc/flmprofile
  2. Start the command line interface.
    1. Open a command prompt.
      • On Windows®, open the License Manager Workplace window from the Start menu.
      • On Linux®, open a command prompt. "sudo" may be required.
    2. Type flmprg -s

      The FLM service is stopped.

  3. Install the new FLM package in the same directory as the existing installation.

    Take the option to overwrite the existing files.

  4. Replace the configuration file at $FLMDIR/etc/flmprofile with the backup copy created in Step 1.

    Overwrite the existing file.

  5. Remove every file and directory in the $FLMDIR/lock/ path.
  6. Start your new FLM
    flmprg -r

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.

To update the license controller to the latest version, you download the version for your product that is appropriate for your operating system from the Four Js web site.
Table 1. Genero Products and License Controllers
Genero product Licence controller
Genero Enterprise Four Js License Controller for BDL (fglwrt)
Genero Report Engine Four Js License Controller for GRE (greWrt)
  1. Open your browser and navigate to the Four Js web site http://www.4js.com.
  2. Navigate to the Download > Products page.
  3. Under the License manager packages heading, locate the version of the license controller that is appropriate for your operating system under the Platform heading, and click on the link under Version to start the download.
  4. When the download completes, uncompress the archive in your FGL installation directory

    The license controller is now updated.

    If a license controller version is not available for your operating system and/or for assistance with a downloaded version, contact your Four Js support center for help.

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:

fglWrt version >= FLM version

Beyond this recommendation, the license controller may require a minimal FLM version. If the FLM version does not match the version requested by the license controller, an error is returned.
Tip: If you encounter an issue regarding the versions installed, it is recommended that you download and install the latest FLM, then update the license controller on all instances of FGLGWS.

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

The -V option returns the version number of a Genero component.
Table 2. Finding the version
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.

Warning: Be sure you are installing the correct binary files for your operating system. To do so, examine the installation package name, which includes the operating system brand name. For more information on the installation package name, refer to Four Js License Manager packages.

Install Four Js License Manager on UNIX platforms

Important: Before installation on Linux systems, verify the libxcb libraries are installed.
To display the installation options, run the installation command with the help (-h) option:
./fjs-flm-5.10.3a-build333-lnxlc23.run -h
  1. Choose a directory where Four Js License Manager will be installed, such as /opt/fourjs/flm.
  2. Log in as a user with permission to write to the chosen directory.
  3. Copy the self-extractable file into a temporary directory.
  4. Run the self-extractable shell script with the -i option:
    ./fjs-flm-5.10.3a-build333-lnxlc23.run -i
  5. Follow the instructions displayed on your screen.

When installation is complete, see Four Js License Manager User Guide 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.

Table 3. UNIX install options
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 contained in the .txt files (in the license directory of the install directory).
-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.

-f backup|overwrite|remove or

--force backup|overwrite|remove

Specify what happens if the installation directory already exists:
  • backup: Back up the installation directory.
  • overwrite: Overwrite installation file.
  • remove: Delete installation directory before installing.

-t install_dir or

--target install_dir

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

  1. Choose a directory where Four Js License Manager will be installed, such as c:\fjs\flm.
  2. Log in as a user with permission to write to the chosen directory.
  3. Copy the self-extractable file into a temporary directory.
    fjs-product-version-build-osident.exe

    Example:

    fjs-flm-5.19.16-build201708251459-w64v140.exe
  4. Double-click the file to launch it, or right-click on the file name and select Run as administrator.
  5. Follow the instructions displayed by the installation wizard.
    As part of the wizard, you are asked whether to install as a service. If you elect to install as a service, it is installed and set to Manual start. To have the service restart automatically on reboot, you must edit the Startup Type and change to Automatic or Automatic Delayed.

When installation is complete, see Four Js License Manager User Guide 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 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.

Table 4. msiexec install and uninstall options
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.

Table 5. Arguments for the msiexec installer
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.
  • NotToInstall (default): Do not install the service.
  • ServiceInstall: Install the service.
  • ServiceStart: Install the service and start it.
Note: Quotes are only required around the argument value when a space character is in the value string.

Installing the service (Windows only)

The installation wizard gives you the option of installing the Four Js License Manager as a service.

If you elected NOT to install as a service during the initial installation, you can execute the following command (from the License Manager Workplace Window) to install it as a service:
flmprg --service-install
If you attempt to start the service from the command line and the service is not yet installed, it will first install the service, and then start the service.
flmprg --service-start
Important: On Windows you must run the command as administrator, it is not enough to simply have administrator permissions.

Install FLM on macOS

Before you begin

You need a macOS and an user account which has administrator access level.

Download the installation package for the macOS .

About this task

Follow these instructions to install the Four Js License Manager (FLM) on macOS.

  1. Determine the directory where you will install the product.
    The wizard will eventually suggest /opt/fourjs/flm. If you plan to use this default, ensure you have write permission to this directory.
  2. Log in as a user with permission to write to the directory in which you plan to install this product.
  3. Copy the self-extractable file into a temporary directory.
  4. From a command prompt, run the self-extractable shell script with the -i option:
    sh fjs-flm-5.20.xx-buildxxxxxx-m64x10xx.run -i
    Note: The "x" entries in the file name example above must use the actual numbers of the downloaded file!
  5. Follow the instructions displayed.
    Tip: After you have read the licensing agreement, press "q" to return to the instructions and prompts.

When installation is complete, see Four Js License Manager User Guide 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.

Important: On Linux/UNIX systems, for security reasons, it is strongly recommended that the daemon be run as a non-privileged user (not root). To avoid issues with directory permissions, it is recommended that the non-privileged user should also add the licenses.
You can also use the following command on Windows:
flmprg --service-start
Important: On Windows you must run the command as administrator, it is not enough to simply have administrator permissions.

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
Important: On Windows you must run the command as administrator, it is not enough to simply have administrator permissions.