Install Genero Report Engine

These topics relate to the installation of the Genero Report Engine (GRE).

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

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.

Important:

The binary format of the Genero Report Engine must match the binary format of the JVM. For example, a 64-bit Genero Report Engine requires a 64-bit JVM.

Genero compatibility

Determine the compatibility of the Genero component versions that comprise Genero Report Writer for Java, C#, and PHP.

Genero Report Writer for Java, C#, and PHP includes two components: Genero Studio for Report Writer (GSTRW) and the Genero Report Engine (GRE). The major version numbers for these two components must match. For example, if you use Genero Studio for Report Writer 4.0x for development, you must also use Genero Report Engine 4.0x in production.

Install Genero Report Engine on UNIX platforms

Follow these steps to install Genero Report Engine (GRE) on GNU/Linux® and UNIX™.

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 must have Java installed. You will be asked to provide the Java directory as part of the installation. For details about supported Java versions, refer to the Supported platforms and databases document on the Download page of the Four Js Web site.

  1. Type the following command to start the installation:
    $ sh fjs-gre-version-buildYYYYMMDDhhmm-osident.run

    For example:

    $ sh fjs-gre-4.01.03-build202211291818-l64xl217.run
  2. Follow the instructions displayed.

When installation is complete, see Genero Report Writer for Java, C#, and PHP User Guide for configuration information and instructions.

Install Genero Report Engine on UNIX platforms in silent mode

Install Genero Report Engine (GRE) silently on GNU/Linux and UNIX platforms.

To start the installation, type the following:

./fjs-gre-version-buildYYYYMMDDhhmm-osident.run -a -q -t install_dir

For example:

./fjs-gre-4.00.00-build202006051403-h64i112.run -a -q -t $PWD/fjs-gre-4.00

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

Install Genero Report Engine on Windows

Follow these steps to install the Genero Report Engine (GRE) on Windows®.

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

Important:

If your installation directory is in the C:\Program Files path, you must run as administrator when you license the product. This avoids any permission issues.

You must have Java installed. You will be asked to provide the Java directory as part of the installation. For details about supported Java versions, refer to the Supported platforms and databases document on the Download page of the Four Js Web site.

  1. Execute the installation package to start the Setup Wizard.
    fjs-gre-version-buildYYYYMMDDhhmm-osident.exe

    For example:

    fjs-gre-4.01.03-build202211291818-w64v142.exe

  2. Follow the instructions displayed.
    The installation completes and the install wizard closes.

When installation is complete, see the Genero Report Writer for Java, C#, and PHP User Guide for configuration information and instructions.

Install Genero Report Engine on Windows in silent mode

Install Genero Report Engine (GRE) 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/.

Important:

Before you install the Genero Report Engine (GRE), you must install the Java Runtime Engine (JRE).

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:

c:\fjs-gre-version-build-osident.exe /x

For example:

c:\fjs-gre-3.20.06-build166789-w32v141.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_gredir_path The path where Genero Report Engine will be installed. It is an alias of GREDIR variable.
GREDIR=your_gredir_path The path where Genero Report Engine will be installed. It is an alias of the PRODUCTDIR variable.
STARTMENUFOLDER=your_startmenufolder_path Customize the location for the shortcuts in the startmenu. For example, "fjs\gre".
ADDLOCAL=[ALL|GRE] Set the features to install.
  • ALL (default): Install Genero Report Engine (mandatory) and .gre file association
  • GRE: Install Genero Report Engine only
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: "".
Note:

Quotes are only required around the argument value when a space character is in the value string.

Example

The following commands install the JRE and the Genero Report Engine (GRE) silently:

msiexec /qn /i fjs-gre-3.20.05-build156498-alpha-w64v140.msi /l*vx gre.log GREDIR=D:\gre3.20 STARTMENUFOLDER="Four Js Genero Report Engine 3.20.05 (64 bits)"

Install Genero Report Engine on macOS

Follow these steps to install the Genero Report Engine (GRE) 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 .

You must have Java installed. You will be asked to provide the Java directory as part of the installation. For details about supported Java versions, refer to the Supported platforms and databases document on the Download page of the Four Js Web site.

If you plan to license the Genero Report Engine during the installation process, ensure you have the license number, license key, and maintenance or subscription number available.

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 Genero Report Engine on macOS.

  1. Determine the directory where you will install the product.
    The wizard will eventually suggest /opt/fourjs/gre. 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-gre-version-buildYYYYMMDDhhmm-osident.run

    Example:

    sh fjs-gre-4.01.03-build202211291818-m64x1014.run
  5. Follow the instructions displayed.
    Tip:

    After you have read the licensing agreement, press "q" to return to the instructions and prompts.

    At some point in the instructions, you will be asked whether you wish to provide the licensing details for the Genero Report Engine. If you skip this step during the installation, you can always go back later to provide the licensing details.
What to do next

When installation is complete, see Genero Report Writer for Java, C#, and PHP User Guide for configuration information and instructions.