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