Install Genero Desktop Client
These topics relate to the installation of the Genero Desktop Client.
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.
Genero compatibility for the GDC
Determine the compatibility of different versions of the Genero product family and the Genero Desktop Client.
GDC 3.21 and Genero compatibility
GDC 3.21 can run in direct mode (SSH) with FGLGWS 3.21, FGLGWS 3.20, or FGLGWS 3.10.
GDC 3.21 can run on the UA protocol using FGLGWS 3.21 + GAS 3.21, FGLGWS 3.20 + GAS 3.20, or FGLGWS 3.10 + GAS 3.10.
The Genero Report Viewer (GRV) 3.21, which is included in GDC, is compatible with FGLGWS 3.21, FGLGWS 3.20, or FGLGWS 3.10.
GDC 3.20 and Genero compatibility
GDC 3.20 can run in direct mode (SSH) with FGLGWS 3.20 or FGLGWS 3.10.
GDC 3.20 can run on the UA protocol using FGLGWS 3.20 + GAS 3.20 or FGLGWS 3.10 + GAS 3.10.
The Genero Report Viewer (GRV) 3.20, which is included in GDC, is compatible with FGLGWS 3.20 or FGLGWS 3.10.
GDC 3.10 and Genero compatibility
GDC 3.10 is compatible with FGLGWS 3.00 or FGLGWS 3.10 in direct mode.
GDC 3.10 is compatible with a 3.10 server-side configuration (FGLGWS 3.10 + GAS 3.10) in UA mode.
Install GDC on UNIX platforms
Follow these steps to install GDC on UNIX™ platforms.
Before installation on Linux® systems, verify libxcb is installed.
On UNIX platforms, GDC is provided as an auto-extractable shell script. Distribution files and installation program are provided in the same file.
The installation program has options. Display the installation program options using the help
(-h
) option, for example:
./fjs-gdc-3.20.11-build158046-l64xl212.run -h
When installation is complete, see the Genero Desktop Client User Guide for configuration information and instructions.
Install GDC on UNIX platforms in silent mode
Install the Genero Desktop Client (GDC) silently on GNU/Linux and UNIX platforms.
To start the installation, type the following:
./fjs-gdc-version-buildYYYYMMDDhhmm-osident.run -a -q --no-desktop -t install_dir
For example:
./fjs-gdc-3.20.13-build202005251839-l64xl217.run -a -q --no-desktop -t $PWD/fjs-gdc-3.20.13
Options
Table 1 shows the options relating to installation.
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. |
|
Specify what happens if the installation directory already exists:
|
|
Install the product in the specified target directory. If -t is not
specified, the default installation is used. |
--no-desktop |
Desktop bindings are not installed, which means:
|
Install GDC on Windows
Procedure to install GDC on Windows® using the exe file.
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/.
When installation is complete, see the Genero Desktop Client User Guide for configuration information and instructions.
Install GDC on Windows in silent mode
Install Genero Desktop Client 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:
c:\fjs-gdc-version-build-osident.exe /x
For example:
c:\fjs-gdc-3.10.03-build4949-w32v100.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.
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_gdcdir_path |
The path where GDC will be installed. It is an alias of GDCDIR variable.
|
GDCDIR=your_gdcdir_path |
The path where GDC 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\gdc". |
ADDLOCAL=[ALL|GDC|GDC,GDCFILEASSOCGDC] |
Set the features to install.
|
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:
"" . |
FORCEWRITEPERM=YES |
Specify whether to grant read, write, and modify permissions on the installation directory to
the Users group. These permissions are needed to allow the GDC auto-updater to work silently.
However, granting these permissions may be considered as unsecure. Consult with your Genero
application administrator.
|
Install GDC on macOS
Procedure for installing GDC on macOS™.
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.
You need the GDC .dmg package. For example: fjs-gdc-3.xx.xx-buildxxxxxx-m64xxxx.dmg, where the "x" are placeholders for version and build numbers.
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.
Follow these instructions to install the Genero Desktop Client.
When installation is complete, see the Genero Desktop Client User Guide for configuration information and instructions.
Install GDC on X11 systems
Procedure to install GDC on X11 systems
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/.
By default, the script un-compresses data into DBTEMP
. Please make sure you
have the correct permissions for this directory. If you do not have the necessary permissions,
either unset DBTEMP
(/tmp will be used), or use the
-w <tempdir>
option to specify an alternate temporary directory.
When installation is complete, see the Genero Desktop Client User Guide for configuration information and instructions.
Microsoft Windows Security Blocking
The Windows firewall, enabled by default, detects and blocks the Genero Studio Server and the Genero Desktop Client.
From the network point of view, Genero Studio Server and the Genero Desktop Client (used by Genero Studio to display forms) are both considered servers. When you start Genero Desktop Client, or attempt to connect to Genero Studio Server, the firewall detects this and blocks the programs.
A dialog allows you to unblock the program. Follow the instructions provided by the dialog.
If you select Keep Blocking or Ask Me Later, the firewall continues to block the program(s).
If Keep Blocking has been pressed by mistake, you can change this parameter in the Windows Firewall settings. Ensure you add Genero Studio, Genero Studio Server and Genero Desktop Client to the list of exceptions or allowed apps, and make sure that their listings have a check mark.