Installation troubleshooting tips

If you have an issue during installation, generating a log of the installation can provide valuable information for support.

How you log an installation of a Genero package depends on your operating system.
Table 1. Logging your installation
Operating System How to log the installation
Windows®
  1. Extract the msi file from the software package executable (exe):

    fjs-package-name.exe /x

  2. From the command line execute:
    msiexec /i fjs-package-name.msi /log mylogfile.log
    Important:

    On Windows®, you must run the command as administrator. It is not enough to simply have administrator permissions.

UNIX™/Linux®/macOS™ From the command line:
  1. export FGLINSTALLDEBUG=1
  2. ./fjs-package-name 2>&1 | tee fjs.log
Mac® See Troubleshooting Genero Studio Installation Issues on macOS (GUI installer).

Fixing the UNIX installation bzip2 error

When installing a Genero package in a UNIX system you see an error similar to this:
The bzip2 binary included in the package cannot be executed
This might indicate that permissions are missing or incorrect.
  • Check you have the correct version of the installation download for your system.
  • Check you have permissions to allow you to install the package.
  • Check you have the correct permissions for the default temporary files directory (/tmp) used to extract and execute the installation files. If /tmp is not writable or executable because of sysadmin policies, you must specify an alternative working directory in the installation command:

    ./fjs-package-name -w $DIR

    Where:
    • -w is the switch that specifies the working directory.
    • $DIR is a path that is fully accessible to you.

Fixing the AIX® "not enough memory" or "no space" error

When installing a Genero package in IBM® AIX systems you see errors similar to these:
./fjs-gstsrv-4.00.03-build202109231810-a640710.run[972]: 0403-029 There is not enough memory available now.
fjs-gstsrv-4.00.03-build202109231810-a640710.run[972]: no space
This might indicate that you do not have enough space in the default temporary files directory (/tmp) used to extract and execute the installation files.
  • Check that data and stack user limits are "unlimited" (ulimit --help).
  • Check that you have enough space in your /tmp directory with the df -k command; and if not, specify an alternative working directory in the installation command:

    ./fjs-package-name -w $DIR

    Where:
    • -w is the switch that specifies the working directory.
    • $DIR is a path that is fully accessible to you.
The issue may be related to the memory needed to execute the installation process. Increasing the large page memory to the maximum, by setting the environment variable LDR_CNTRL, is known to resolve this issue. Execute these commands prior to installing the Genero package:
LDR_CNTRL=MAXDATA=0x80000000
export LDR_CNTRL
Where value 8 stands for 8x256MB (max. value) = 2 GB.

For more information on troubleshooting this error, refer to IBM Support pages.