Install FLM

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, go to Four Js License Manager packages.

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 https://4js.com/end-user-license-agreements/.

To display the installation options, run the installation command with the help (-h) option:

./fjs-flm-6.xx.xx-buildYYYYMMDDhhmm-osident.run -h

For example:

./fjs-flm-6.00.14-build202307121120-l64xl217.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:
    ./fjs-flm-6.xx.xx-buildYYYYMMDDhhmm-osident.run
    Example:
    ./fjs-flm-6.00.14-build202307121120-l64xl217.run
  5. Follow the instructions displayed.

When installation is complete, see Configure License Manager 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-6.00.14-build202307121120-l64xl25.run -a -q -t $PWD/fjs-flm-6.00.14

Options

Table 1 shows the options relating to installation.

Table 1. 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, located on the Four Js website at https://4js.com/end-user-license-agreements/.
-c or --check Check integrity of the archive and of bzip2/tar binaries embedded in this program.

-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.
-k or --keep Do not delete working directory when done.
-l or --list Print the list of files in the archive.
-h or --help Display help about all possible options.
-i or --install Install the product.
Important:

This option is not recommended. It is included only for backward compatibility.

-s license or

--show license

 Display the license of the product.
-n or --nocheck Escape the checksum test on the archive included in the installer.
-q or --quiet Silent mode with no UI. If -q is not specified, the interactive installer is used.
-r or --root Allow the 'root' user to install the package.
Important:

Installing as root is not recommended. It is recommended that you install while logged in as a non-root user.
-V or --version Show the version number.

-t install_dir or

--target install_dir

Install the product in the specified target directory. If this option is not specified, the default installation is used.

-w working_dir or

--work working_dir

Specify the working directory. By default, a temporary directory is created in $TMPDIR or /tmp.
-x or --extract Extract the contents of this program, but do not run fglgws-installer. This option implies --keep.

Installing and starting the daemon

The installation wizard installs the Four Js License Manager daemon.

Once installed, start the daemon from the command line; for details, go to Starting Four Js License Manager.

If using systemd to manage services, you can configure the license manager systemd service template to automatically start the daemon on boot, and to execute systemctl commands to start and stop the service. For more information on how to set this up, go to Systemd service template.

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 https://4js.com/end-user-license-agreements/.

  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-flm-6.xx.xx-buildYYYYMMDDhhmm-osident.exe

    Example:

    fjs-flm-6.00.12-build202209270907-w64v142.exe
  4. Doubleclick the file to launch it, or right-click on the filename and select Run as administrator.
  5. Follow the instructions displayed.
    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 Configure License Manager 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 https://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-6.00.12-build202209270907-w64v142.exe /x

A msi file is created in the same directory and with the same name as the exe file.

Options

Table 2 shows the most common options for msiexec relating to installation and un-installation.

Table 2. 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 3. 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 and starting 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 https://4js.com/end-user-license-agreements/.

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. For details about starting the service, go to Starting Four Js License Manager.

Important:

On Windows you must run the command as administrator, it is not enough to simply have administrator permissions.

Install Four Js License Manager on macOS

Before you begin

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 https://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 .

Genero packages for Apple® Mac® and the macOS operating system are provided as x86 packages, which are designed to run on Intel® processors. Rosetta enables a Mac with Apple silicon to use apps built for a Mac with an Intel processor. If you are using such a machine, you will be asked to install Rosetta the first time you install or open your Genero app. Rosetta works automatically in the background whenever you use an app that was built only for Mac computers with an Intel processor. It translates the app for use with Apple silicon. If Rosetta is already installed, you are not asked to install it again.

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:
    sh fjs-flm-6.xx.xx-buildYYYYMMDDhhmm-osident.run

    Example:

    sh fjs-flm-6.00.14-build202307121120-m64x1014.run
  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 Configure License Manager for configuration information and instructions.

Install Four Js License Manager on macOS platforms in silent mode

Install Four Js License Manager silently on macOS platforms.

To start the installation, type the following:

sh fjs-flm-version-buildYYYYMMDDhhmm-osident.run -a -q -t install_dir

For example:

sh fjs-flm-6.00.14-build202307121120-m64x1014.run -a -q -t $PWD/fjs-flm-6.00.14

Options

Table 4 shows the options relating to installation.

Table 4. 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, located on the Four Js website at https://4js.com/end-user-license-agreements/.
-c or --check Check integrity of the archive and of bzip2/tar binaries embedded in this program.

-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.
-k or --keep Do not delete working directory when done.
-l or --list Print the list of files in the archive.
-h or --help Display help about all possible options.
-i or --install Install the product.
Important:

This option is not recommended. It is included only for backward compatibility.

-s license or

--show license

 Display the license of the product.
-n or --nocheck Escape the checksum test on the archive included in the installer.
-q or --quiet Silent mode with no UI. If -q is not specified, the interactive installer is used.
-r or --root Allow the 'root' user to install the package.
Important:

Installing as root is not recommended. It is recommended that you install while logged in as a non-root user.
-V or --version Show the version number.

-t install_dir or

--target install_dir

Install the product in the specified target directory. If this option is not specified, the default installation is used.

-w working_dir or

--work working_dir

Specify the working directory. By default, a temporary directory is created in $TMPDIR or /tmp.
-x or --extract Extract the contents of this program, but do not run fglgws-installer. This option implies --keep.

Installing and starting the daemon

The installation wizard installs the Four Js License Manager daemon.

Once installed, start the daemon from the command line; for details, go to Starting Four Js License Manager.

Installation troubleshooting tips

If you have an issue during installation, generating a log of the installation can provide valuable information for support.

How you log an installation of a Genero package depends on your operating system.
Table 5. Logging your installation
Operating System How to log the installation
Windows
  1. Extract the msi file from the software package executable (exe):

    fjs-package-name.exe /x

  2. From the command line execute:
    msiexec /i fjs-package-name.msi /log mylogfile.log
    Important:

    On Windows, you must run the command as administrator. It is not enough to simply have administrator permissions.
UNIX/Linux/macOS From the command line:
  1. export FGLINSTALLDEBUG=1
  2. ./fjs-package-name 2>&1 | tee fjs.log

Fixing the UNIX installation bzip2 error

When installing a Genero package in a UNIX system you see an error similar to this:
The bzip2 binary included in the package cannot be executed
This might indicate that permissions are missing or incorrect.
  • Check you have the correct version of the installation download for your system.
  • Check you have permissions to allow you to install the package.
  • Check you have the correct permissions for the default temporary files directory (/tmp) used to extract and execute the installation files. If /tmp is not writeble or executable because of sysadmin policies, you must specify an alternative working directory in the installation command:

    ./fjs-package-name -w $DIR

    Where:
    • -w is the switch that specifies the working directory.
    • $DIR is a path that is fully accessible to you.