Install Genero Studio Server Suite

These topics relate to the installation of the Genero Studio Server Suite

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.

The Genero Suite Server package is intended for production or for remote development (where you are developing on a server machine and the IDE is not available for the platform).

It only includes the server components.

The Genero Studio Server Suite software package includes Genero Studio Server, Genero Business Development Language, Genero Application Server, and Genero Report Engine. During the installation process, you can select which components to include or exclude. By default, the wizard installs all components.

It does not include the Genero Desktop Client (GDC). If you download this package, you must also download the GDC separately to handle any client needs.

Note: See the Genero Studio User Guide for additional installation and configuration information.

If you do not have a valid maintenance key for Genero, you must License Genero Report Engine (GRE).

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.

Install Genero Studio Server Suite on UNIX platforms

Follow these steps to install Genero Studio Server Suite on Gnu/Linux® and UNIX™.

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

If you plan to license Genero BDL during the installation process, ensure you have the license number, license key, and maintenance number available.

You will also be asked to identify a default database driver. Be prepared to provide an answer to that question.

  1. Type the following command to start the installation:

    $ sh fjs-gstsrv-version-build-osident.run

    Example:

    $ sh fjs-gstsrv-3.20.05-build156401-l64xl24.run

  2. Follow the instructions provided on the screen.
What to do next

When installation is complete, see the Genero Application Server User Guide for configuration information and instructions.

Install Genero Studio Server Suite on UNIX platforms in silent mode

Install Genero Studio Server Suite silently on Gnu/Linux and UNIX platforms.

To start the installation, type the following:

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

For example:

./fjs-gstsrv-3.20.05-build202006051012-l64xl217.run -a -q -t $PWD/fjs-gstsrv-3.20.05

Options

Table 1 shows the most common 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/.
-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 Genero Studio Server Suite on Windows

Procedure to install Genero Studio Server Suite on Windows®.

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

If you plan to license Genero BDL during the installation process, ensure you have the license number, license key, and maintenance number available.

You will also be asked to identify a default database driver. Be prepared to provide an answer to that question.

  1. Execute the package name to start the Setup Wizard.

    fjs-gstsrv-version-build-osident.exe

    Example:

    fjs-gstsrv-3.20.03-build127192-w32v100.exe

  2. When the Welcome page displays, click Next.
  3. End-User License Agreement - Read and accept the license agreement and click Next.
  4. Third-Party License Agreement - Read and accept the terms of the license agreement and click Next.
  5. Product Features - Select which components to install and click Next.
    By default, all components are selected for installation. The list box for each feature or component allows you to specify whether:
    • Feature/component will be installed on the local hard drive
    • Entire feature will be installed on the local hard drive
    • Entire feature will be unavailable
  6. Destination Folder - Specify the destination folder for your Genero installation (or use the default) and click Next.
  7. Start Menu Folder - Select the folder and click Next.
  8. Licensing - If you want to license the product directly after it is installed, select the appropriate check boxes:
    • License Genero Business Language - Select if you want to install the BDL. This is the default.
    • License Genero Report Engine - Select only if you have a specific GRE license.

    For further information about licensing types, see Genero Licensing manual.

    If you deselect all check boxes, you need to license the product at a later time. See License Genero Business Development Language and License Genero Report Engine (GRE).

    Click Next to continue.

  9. Java™ Virtual Machine - Select an installed JVM version and click Next.
  10. Ready to install - Click Install to begin the installation.
  11. If you chose to license Studio during the installation, the License Information appears as well as the maintenance key (if available). Click Install. Alternatively, select the check box to use the Four Js Activation Server.
    1. Enter the license number and the license key, and click Install.
    2. Enter the maintenance key and click Update Key.
    3. Click Quit to leave the License Information dialog.
  12. Click Finish.

    The installation completes and the install wizard closes.

What to do next

When installation is complete, see the Genero Application Server User Guide for configuration information and instructions.

Install Genero Studio Server Suite on Windows in silent mode

Install Genero Studio Server Suite 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-gstsrv-version-build-osident.exe /x

For example:

fjs-gstsrv-3.20.08-build167272-w64v141.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_gstsrvdir_path Path where GSTSRV will be installed. It is an alias of GSTDIR.
GENEROSTUDIODIR=your_gstsrvdir_path Path where GSTSRV will be installed. It is an alias of GSTDIR.
STARTMENUFOLDER=your_startmenufolder_path Customize the location for the shortcuts in the startmenu. For example: "fjs\gstsrv"
ADDLOCAL=option Use option to set the features to install.
Table 4. Option values for ADDLOCAL
Option Description
ALL Install Genero Studio Server Suite (GSTSRVCORE), Genero Business Development Language (FGL), Genero Report Engine (GRE), and the Genero Application Server (GAS).
GSTIDE Install Genero Studio Server Suite (mandatory).
FGL Install the Genero Business Development Language (BDL).
GRE Install the Genero Report Engine (GRE).
GAS Install the Genero Application Server (GAS).
JAVADIR=your_jvm_path Location of the Java Virtual Machine (JVM). This option is required for the Genero Report Engine (GRE).
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.

Silent install example

This command installs GSTSRV 3.20.08 with all products, and sets the location of the Java Virtual Machine (JRE):

msiexec /qn /i fjs-gstsrv-3.20.08-build167272-w64v141.msi /log gstsrv.log PRODUCTDIR="c:\fjs\gst32008\" ADDLOCAL=ALL JAVADIR="C:\Program Files\Java\jdk1.7.0_80\bin"

Silent uninstall example

This command removes GSTSRV 3.10.04 and removes the product directory:

msiexec /qn /x fjs-gstsrv-3.10.04-build155239-alpha-w64v120.msi /log gstsrv_remove.log FORCEREMOVEPRODUCTDIR=YES

Install Genero Studio Server Suite on macOS

Procedure to install Genero Studio Server Suite 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 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 .

You must have Java installed. You will be asked to provide the Java directory as part of the installation.

If you plan to license Genero BDL during the installation process, ensure you have the license number, license key, and maintenance number available.

You will also be asked to identify a default database driver. Be prepared to provide an answer to that question.

About this task

This installation package can install Genero Studio Server, Genero BDL, Genero Report Engine, and the Genero Application Server. You can follow the wizard suggestions and install all four at this time, or you can select and pick which components to install.

Follow these instructions to install the Genero Studio Server on macOS.

  1. Determine the directory where you will install the product.
    The wizard will eventually suggest /opt/fourjs/gstsrv. 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-gstsrv-3.xx.xx-buildxxxxxx-m64x1011.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.
    At some point in the instructions, if you elected to install Genero BDL, you will be asked whether you wish to provide the licensing details for the Genero Business Development Language. If you skip this step during the installation, you can always go back later to provide the licensing details.
    If asked about providing the licensing details for the Genero Report Engine, you can choose to not license the GRE. A GRE license is not necessary if you have a Genero BDL license with maintenance support.
What to do next

When installation is complete, see the Genero Application Server User Guide for configuration information and instructions.