Start the Installer on a Mac OS X or Other UNIX System

2. Open your installation email from Software AG. Follow the instructions to download the Software AG Installer for UNIX. 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):

Running products in that directory must be shut down so the installer can update key files that are locked by the operating system. If the products are running as applications, shut them down manually. If the products are running as services or daemons, the installer will automatically shut down many of them (and later restart them), but you must manually shut down some products (and later restart them). See your product installation guide for detailed information.

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. Install a 32- or 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.

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.

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.

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.