Start the Installer on a Mac OS X or Other UNIX System
1. Log on to the machine as the installation user you created earlier.
2. Open your installation email from Software AG. Follow the instructions to download the Software AG Installer for UNIX from the Software Download Center on Empower. Copy the product license files attached to the email to the machine on which you are going to install.
3. Shut down all non-Software AG applications that are running on the machine on which you are going to install. If these applications are not shut down, product files might become corrupted.
4. If you are going to install new products into an existing Software AG installation directory (that contains products from the same release):
Shut down running products in that directory so the installer can update key files that are locked by the operating system. For instructions, see the product documentation.
Check whether a file named afterInstallAsRootLog.txt exists in the
Software AG installation directory. If it does, execute the
Software AG_directory /bin/beforeInstallAsRoot script.
5. For a Mac OS X or other UNIX system, install a 64-bit JDK to run the installer and the uninstaller. For information on supported JDKs for Mac OS X and other UNIX systems, see the product system requirements on the Software AG Documentation website.
6. Check the classpath environment variable on the machine on which you are going to run the installer. If it points to a JRE that is earlier than version 8, either remove the path or edit the variable to point to a JRE that is version 8 or later.
7. The user file-creation mode mask (umask) can affect the file permissions for newly created files and directories. Make sure the umask you are using for installation will not prevent users from accessing and executing these files.
8. If you are going to install on a remote machine, do the following:
a. Allow the remote machine to access your local machine’s X11 display. If your local machine is a UNIX system, you can use the command xhost +remote_machine . If your local machine runs a X11 emulation on Windows, you might have to set a property in your emulation software.
b. Log on to the remote machine and set the shell variable DISPLAY to the value of your local machine’s X11 display. For example, if you are using a sh, ksh, or bash shell, you can use export DISPLAY=local_machine:0.0. If you are using a csh or tcsh shell, you can use setenv DISPLAY local_machine:0.0.
c. Start the installer in the same shell.
d. On Mac OS X, you can only install in GUI mode in the Mac OS X desktop, or in console mode in a terminal session. There is no way to use a remote X11 display like with other UNIX systems.
9. Run this command to start the installer:
java -jar SoftwareAGInstalleryyyymm.{jar|zip|dmg}
To list all available command line options, run this command:
java -jar SoftwareAGInstalleryyyymm.{jar|zip|dmg} -help -console
As you move through the wizard, the installer stores some of the files it requires in the default temporary directory. If you cancel the installer and later restart it on the same machine, the installer will use the stored files rather than downloading them from the installer server again, to improve performance. After a successful installation, the installer deletes the stored files.
Note: If your temporary directory contains thousands of files, the startup process might take one minute or longer. The installer will display Initializing system resources during this time. If you want to speed up this process, delete the files in your temporary folder.
Note: You might receive Java messages when you start the installer. For example, you might receive warning messages about system preferences, or about unlocking connections. You can ignore these messages.