Install Genero Studio
These topics relate to the installation of the Genero Studio.
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 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.
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 GST
Determine the compatibility of different versions of the Genero product family and Genero Studio.
GST 4.01 and Genero compatibility
When using Genero Studio (GST) 4.01, ensure the other Genero components are based on compatible versions.
Genero Studio 4.01 is compatible with:
- FGLGWS 3.10 and above
- GDC 3.10 and aboveNote: GST may work with older versions of FGLGWS and GDC.
- GAS 3.10 and above
- GRE 4.01
- GGC 2.00 (included with FGLGWS 3.20) and above
- GMI 4.01
- GMA 4.01
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:
- FGLGWS 3.10 and above
- GDC 3.10 and aboveNote: GST may work with older versions of FGLGWS and GDC.
- GAS 3.10 and above
- GRE 3.20
- GGC 2.00 (included with FGLGWS 3.20)
- GMI 1.4
- GMA 1.4
Install Genero Studio on UNIX platforms
Follow these steps to install Genero Studio on Gnu/Linux and UNIX™.
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/.
Install Genero Studio on UNIX platforms in silent mode
Install Genero Studio silently on Gnu/Linux and UNIX platforms.
Before you begin: Ensure that your PATH environment variable contains the full
path to the java
binary that you want to use with Genero Studio
tools.
To start the installation, type the following:
./fjs-gst-version-buildYYYYMMDDhhmm-osident.run -a -q --no-desktop -t install_dir
For example:
./fjs-gst-4.00.00-build202006051012-l64xl217.run -a -q --no-desktop -t $PWD/fjs-gst-4.00
Options
Table 1 shows the most common 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 Genero Studio on Windows
Procedure to install Genero Studio on Windows.
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/.
Install Genero Studio on Windows in silent mode
Install Genero Studio 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-gst-version-build-osident.exe /x
For example:
fjs-gst-4.00-build123456-w64v120.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_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-4.00.02-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-4.00.02-build167272-w64v141.msi PRODUCTDIR="C:\Program Files\FourJs\Genero Studio\4.00.02\" 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
Install Genero Studio on macOS (GUI installer)
Procedure to install Genero Studio 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 http://4js.com/end-user-license-agreements/.
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.
If the installation fails, see the Troubleshooting Genero Studio Installation Issues on macOS (GUI installer) page.
JAVA_HOME
environment variable as the
location of the Java directory. Troubleshooting Genero Studio Installation Issues on macOS (GUI installer)
Here are troubleshooting tips for issues you may encounter when installing Genero Studio on macOS in GUI mode.
Review the installation logs
- When the installation process begins, you will have a "Window" menu. Go to the Window menu and choose the Installer Log item. It launches a window where the installation logs are displayed.
- To the left of the new window, you can choose Show all logs from a combobox.
- When the installation process ends (with or without error), you can use the save button to create a file containing all log messages.
Installation download is blocked
"fjs-gst-version-build-m64x1014.pkg" can't be opened because Apple cannot check it for malicious software. This software needs to be updated. Contact the developer for more information.This warning is a security mechanism to protect your computer from malware:
- Go to page. The page lists the blocked file.
- Select the option that allows you to install the application.
Install Genero Studio on macOS (command line)
Procedure to install Genero Studio 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 http://4js.com/end-user-license-agreements/.
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.
JAVA_HOME
environment variable as the
location of the Java directory. 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