Install Genero Web Application

To build and package Genero Web applications, you must first install Genero Web Application (GWA).

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

Important:

The Genero Web Application and Genero BDL X.YZ versions are interdependent in terms of pcode compatibility. To build a GWA 5.01 embedded app, the source code needs to be compiled with Genero BDL 5.01.

Install Genero Business Development Language. See Install Genero Business Development Language for more details.
Download Genero Web Application from the Four Js Web site.
The Genero Web Application product is delivered as a zip that can be unzipped either to the FGLDIR or to a separate directory. The recommended installation is to unzip it directly over FGLDIR. Examples of both installation methods are given here.
The zip file will contain all tools to build the final GWA application. Notice that those tools are written in Genero and require a valid Genero BDL 5.01 or greater to be installed.

Important: Genero Studio and GWA

If you selected the "Workstation or Server - Full" setup when installing Genero Studio, GWA is installed and can be found at GSTDIR/gwa. No additional installation is necessary.

Install GWA within FGLDIR

The preferred installation is to unzip the Genero Web Application package (fjs-gwa-*.zip) directly into FGLDIR.

This has two advantages:

The GWA tools, gwabuildtool, gwarun, and gwasrv, are immediately in the PATH if $FGLDIR/bin is in the PATH already.
The GWA API is immediately available for IMPORT FGL without the need to set FGLLDPATH explicitly.

Install the GWA over FGLDIR.

Extract the files in Genero Web Application package (fjs-gwa-*.zip) into FGLDIR.

On Linux®/macOS™, open a command prompt. "sudo" may be required. Type the command to extract the contents of the archive file using an archiving tool, such as unzip, tar, or gzip.
```
$ unzip -q -o -d $FGLDIR fjs-gwa-*.zip
```
On Windows®, open an Explorer window and navigate to your downloads directory. Right click on the downloaded zip file and select Extract All. Follow the instructions to browse to your FGLDIR directory and click on Extract to extract the contents of the archive file.

Install GWA in its own directory

If you need to test several versions of GWA against a single installation of Genero BDL, you will extract each GWA distribution archive to a separate directory.

Install the GWA in a directory separate to FGLDIR.

Create a directory (gwa-install-dir) for the GWA installation.
```
$ mkdir /opt/fourjs/gwa-5.01
```
Extract the contents of the Genero Web Application package (fjs-gwa-*.zip) into this directory.
- On Linux/macOS, "sudo" may be required. Type the command to extract the contents of the archive file to your local directory using an archiving tool, such as unzip, tar, or gzip.
```
$ unzip -q -o -d /opt/fourjs/gwa-5.01 fjs-gwa-*.zip
```
- On Windows, open an Explorer window and navigate to your downloads directory. Right click on the downloaded zip file and select Extract All. Follow the instructions to browse to your local directory and click on Extract to extract the contents of the archive file.
Add the gwa-install-dir/bin directory to your PATH environment variable, in order to find the GWA tools in the path.
- On Linux/macOS, "sudo" may be required.
```
export PATH=/opt/fourjs/gwa-5.01/bin:$PATH
```
- On Windows, open a command terminal. Type the command to set the PATH to the GWA bin directory:
```
set PATH=/opt/fourjs/gwa-5.01/bin;%PATH%
```
Add the gwa-install-dir/lib directory to your FGLLDPATH environment variable.
You may need the GWA package library during your development, for example, to get the location of windows, or to reload the application.
- On Linux/macOS, "sudo" may be required.
```
export FGLLDPATH=/opt/fourjs/gwa-5.01/lib:$FGLLDPATH
```
- On Windows:
```
set FGLLDPATH=/opt/fourjs/gwa-5.01/lib;%FGLLDPATH%
```

When installation is complete, refer to the Genero Web applications section in the Genero Business Development Language User Guide for details about creating GWA applications.

Genero compatibility for GWA

Determine the compatibility of different versions of the Genero product family and Genero Web Application (GWA).

GWA 5.01 and Genero compatibility

When using Genero Web Application (GWA) 5.01, ensure the other Genero components are based on compatible versions.

The Genero Web Application 5.01 and Genero BDL 5.01 versions are interdependent in terms of pcode compatibility. To build a GWA 5.01 embedded app, the source code needs to be compiled with Genero BDL 5.01.

GWA 5.01 is compatible with:

FGLGWS 5.01 (latest version) + GAS 5.01