Install Genero Studio
These topics relate to the installation of the Genero Studio.
Installation can vary depending on the host operating system. Ensure you follow the installation instructions for your host operating system.
The Genero Studio software package includes Genero Studio, Genero Business Development Language, Genero Application Server, Genero Desktop Client, Genero Web Client, Genero Web Services, Genero Mobile and Genero Report Writer. During the installation process, you can select which components to include or exclude. By default, the wizard installs all components.
Genero Studio can be used as a standalone application, or in a client/server mode. The packages for Windows® and GNU/Linux® install client and server programs.
Use a standalone scheme when you want to use local Genero and Genero Desktop Client installations and compile files locally.
If the Genero installation and your project files are on another machine, install Genero Studio on this machine and run the server program only. You will have to declare the Genero Studio Server in your local Genero Studio (client) configuration in order to use it.
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.
GST 3.20 and Genero compatibility
When using Genero Studio (GST) 3.20, ensure the other Genero components are based on compatible versions.
Genero Studio 3.20 is compatible with:
- FGL 3.00 and above
- GDC 3.00 and aboveNote: GST may work with older versions of FGL and GDC.
- GAS 3.00 and above
- GRE 3.20
- GGC 2.00
- GMI and GMA 1.4
Install Genero Studio on Windows
Procedure to install Genero Studio on Windows.
What to do next
When installation is complete, see the Configuring Genero Studio page in the Genero Studio User Guide.
Install Genero Studio on Windows in silent mode
Install Genero Studio 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-gst-version-build-osident.exe /x
For example:
fjs-gst-3.20.04-build123456-w64v120.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_gstdir_path |
Path where GST will be installed. It is an alias of GSTDIR . |
||||||||||||||||||||||||||
GENEROSTUDIODIR=your_gstdir_path |
Path where GST 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\gst" | ||||||||||||||||||||||||||
ADDLOCAL=option |
Use option to set the features to install.
GSTIDE , GSTFILEASSOCSOURCEFILES ,
GSTFILEASSOCBINARYFILES , GSTIDECONTEXTMENU , GDC ,
GDCFILEASSOCGDC , FGL , GRE ,
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:
"" |
ADDLOCAL
argument,
which can be complex. - Install the product using the graphical installer (without
/qn
) and specify a log file, for example:msiexec /i fjs-gst-3.20.08-build167272-w64v141.msi /l gst_install.log
- Open the log file.
- Search the log file for the arguments you need, for example
ADDLOCAL
andPRODUCTDIR
. Copy the values. - Install the product again (you may need to uninstall first), this time using
silent mode (with
/qn
) and specifying the copied arguments. For example:msiexec /qn /i fjs-gst-3.20.08-build167272-w64v141.msi PRODUCTDIR="C:\Program Files\FourJs\Genero Studio\3.20.08\" ADDLOCAL="GENEROSTUDIO,GSTIDE,GDC,FGL,GRE, GAS,VC100_CRT_x86_x64,VC120_CRT_x86_x64,VC141_CRT_x86_x64,GSTFILEASSOC4AD,GSTFILEASSOCSOURCEFILES,GSTFILEASSOC4BA,GSTFILEASSOC4DB, GSTFILEASSOC4DBX,GSTFILEASSOC4DM,GSTFILEASSOC4FD,GSTFIL"
- Save the installation instructions to a script, so it can be reused and distributed.
Silent install example
This command installs GST 3.20.03 with all products, and sets the location of the Java Virtual Machine (JRE):
msiexec /qn /i fjs-gst-3.20.03-build155239-alpha-w64v120.msi /log gst.log PRODUCTDIR="c:\fjs\gst32003\" ADDLOCAL=ALL JAVADIR="C:\Program Files\Java\jdk1.7.0_80\bin"
Silent uninstall example
This command removes GST 3.10.05 and removes the product directory:
msiexec /qn /x fjs-gst-3.10.05-build155239-alpha-w64v120.msi /log gst_remove.log FORCEREMOVEPRODUCTDIR=YES
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.
Install Genero Studio on UNIX platforms
Follow these steps to install Genero Studio on Gnu/Linux and UNIX™.
What to do next
When installation is complete, see the Configuring Genero Studio page in the Genero Studio User Guide.
Install Genero Studio on UNIX platforms in silent mode
Follow these steps to install Genero Studio on Gnu/Linux and UNIX in silent mode.
Before you begin: Be sure that your PATH environment variable contains the full path
to the java
binary that you want to use with Genero Studio tools.
./fjs-gst-version-build-osident.run
-a -q --no-desktop -t $PWD/fjs-gst-version
Example:
./fjs-gst-3.10.05-build156401-l64xl212.run -a -q --no-desktop -t
$PWD/fjs-gst-3.10.05
Where:
$ sh
fjs-gst-version-build-osident.run
-a -q --no-desktop -t $PWD/fjs-gst-version
-a
bypasses the display and the prompt for acceptance.
-q
specifies a non-verbose installation
--no-desktop
means that Genero files (ie: *.4pw, *.4gl, *.per, etc...)
are not automatically associated with GST.
-t
specifies the target for installing the product.
What to do next
When installation is complete, see the Configuring Genero Studio page in the Genero Studio User Guide.
Install Genero Studio on macOS (GUI installer)
Procedure to install Genero Studio on macOS™.
You need a macOS and an user account which has administrator access level.
You need the GST .dmg package. For example: fjs-gst-3.xx.xx-buildxxxxxx-m64xxxx.dmg, where the "x" are placeholders for version and build numbers.
Follow these instructions to install Genero Studio.
What to do next
When installation is complete, see the Configuring Genero Studio page in the Genero Studio User Guide.
Debug the Genero Studio Install on macOS (GUI installer)
Procedure to debug the install Genero Studio on macOS.
Follow these steps to debug a failed installation in GUI mode:
Install Genero Studio on macOS (command line)
Procedure to install Genero Studio on macOS.
You need a macOS and an user account which has administrator access level.
You need the GST .dmg package. For example: fjs-gst-3.xx.xx-buildxxxxxx-m64xxxx.dmg, where the "x" are placeholders for version and build numbers.
What to do next
When installation is complete, see the Configuring Genero Studio page in the Genero Studio User Guide.
Debug the Genero Studio Install on macOS (command line)
Procedure to debug the install Genero Studio on macOS.
sudo installer -pkg
/Volumes/fjs-gst-2.50.00-buildxxxxxx-m64x106/fjs-gst-2.50.00-buildxxxxxx-m64x106.pkg/
-target "/Volumes/Macintosh HD" -dumplog -verbose 2>&1
| tee
fjs-gst-2.50.00-buildxxxxxx-m64x106.log