Install Genero Application Server
These topics relate to the installation of the Genero Application Server.
Installation can vary depending on the host operating system. Ensure you follow the installation instructions for your host operating system.
The software is provided as an auto-extractible installation program (i.e. product files and installation program are provided in the same file). The name of the package includes the operating system type and version. You must install the Genero Application Server software package corresponding to the operating system that you use.
The Genero Application Server and the Genero BDL runtime should be installed on the same machine.
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.
Genero compatibility for the GAS
Determine the compatibility of different versions of the Genero product family and the Genero Application Server.
GAS 3.20 and Genero compatibility
When using Genero Application Server (GAS) 3.20, ensure the other Genero components are based on compatible versions.
The GAS and DVM should be in sync; GAS 3.20 should use FGL 3.20.
- GDC HTTP 3.20
- GBC 1.00
- GMA 1.40 (where the mobile client is using
runOnServer
to connect to a server-side application.) - GMI 1.40 (where the mobile client is using
runOnServer
to connect to a server-side application.)
GAS 3.10 and Genero compatibility
When using Genero Application Server (GAS) 3.10, ensure the other Genero components are based on compatible versions.
The GAS and DVM should be in sync; GAS 3.10 should use FGL 3.10.
- GDC HTTP 3.10 and GDC HTTP 3.20
- GBC 1.00
- GMA 1.30 and 1.40 (where the mobile client is using
runOnServer
to connect to a server-side application.) - GMI 1.30 and 1.40 (where the mobile client is using
runOnServer
to connect to a server-side application.)
Install Genero Application Server on UNIX platforms
Follow these steps to install the Genero Application Server on UNIX™ platforms.
The installation program provides options that allow you to specify configuration options from
the command line. You can display the installation program options using the -h
option:
./fjs-gas-version-build-osident.run
-h
Example:
$ ./fjs-gas-3.10.04-build129065-l64xl25.run -h
The installation program identifies the operating system and checks that all the system requirements are met before starting to copy the product files to disk.
When you have completed the installation of the GAS, see FastCGI installation in the Genero Application Server User Guide for details on the Web Server configuration. Afterwards, validate your installation as described in Validating the installation with the GBC or Validating the installation with the GDC in the Genero Application Server User Guide.
Install on Microsoft Windows platforms
Install the Genero Application Server on Microsoft® Windows® platforms.
On Microsoft Windows, the GAS is provided as a standard Windows setup program.
If you plan on installing the ISAPI connector for the integration of the GAS within IIS, you must install IIS first, prior to running the setup program. On IIS 7.x, ensure also that the IIS Management Scripts and Tools component under Management Tools (or Web Management Tools) is installed.
The installation program and the distribution files are provided in the same file:
fjs-gas-version-build-osident.exe
Example:
fjs-gas-3.10.04-build129065-w32v100.exe
A wizard guides you through the installation process.
When the installation completes, follow the instructions to install and configure the ISAPI dispatcher in the Genero Application Server User Guide.
Install GAS on Windows in silent mode
Install the Genero Application Server 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-gas-version-build-osident.exe /x
For example:
fjs-gas-3.10.05-build129065-v32v100.exe /x
A msi file is created in the same directory and with the same name as the exe file.
Options
Table 1 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_gasdir_path |
Path where GAS will be installed. It is an alias of
GASDIR . |
GASDIR=your_gasdir_path |
Path where GAS will be installed. It is an alias of
PRODUCTDIR . |
FGLDIR=your_fgldir_path |
Path where Genero BDL is installed. Used only when
SETFGLDIR=1 . |
SETFGLDIR=1 |
Enable the FGLDIR variable. Default value is
0 (zero). |
GREDIR=your_gredir_path |
Path where GRE is installed. Used only when
SETGREDIR=1 . |
SETGREDIR=1 |
Enable the GREDIR variable. Default value is
0 (zero). |
ADDLOCAL=GAS |
Install the GAS without ISAPI. Set the parameter to ALL to install the GAS with the ISAPI extension. |
STARTMENUFOLDER=your_startmenufolder_path |
Customize the location for the shortcuts in the startmenu. For example: "fjs\gas" |
FORCEREMOVEPRODUCTDIR=YES |
On uninstall, remove the PRODUCTDIR location
even if it is not empty. Default value: "" |
ALLUSERS=1 |
Install system-wide, for all users. Always set to
1 . |
Silent install example
msiexec /qn /i fjs-gas-3.20.08-build129065-v32v100.msi /log gas2.20.log
PRODUCTDIR=c:\tmp\gas2 ADDLOCAL=ALL ALLUSERS=1
Silent uninstall example
msiexec /qn /x fjs-gas-2.50.04-build129065-v32v100.msi /log as2_50_04.log
Install GAS on macOS
You need a macOS™ and an user account which has administrator access level.
Download the installation package for the macOS .
- The installation of Genero BDL is mandatory.
- The installation of Genero Report Engine is only necessary if you plan to use the Genero Report Writer through applications running on the GAS.
You will be asked to provide the directory paths for both BDL and GRE.
Follow these instructions to install the Genero Application Server on macOS.
When installation is complete, see the Genero Application Server User Guide for configuration information and instructions.