Installer 10.15 | Complete Installation and Upgrade Information for Software AG Products | Using the Software AG Installer | Using GUI Mode | Start the Installer on a Mac OS X, UNIX, or Linux System
 
Start the Installer on a Mac OS X, UNIX, or Linux System
1. Log on to the machine as the installation user you created earlier.
2. Open your installation email from Software AG.
a. Follow the instructions to download the Software AG Installer from the Software Download Center on Empower.
Note:
If you download the bin file and you want to transfer it to another machine using FTP, use the binary file transfer mode\type. If you use another mode\type, the bin file might become corrupted.
b. 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. 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.
6. 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.
7. Take the action below to start the installer, based on the file you downloaded from Empower.
Operating System
File
Actions
Mac OS X
dmg
Double-click the file.
UNIX, Linux
bin
Run the command below. The bin file is a self-extracting archive that extracts its content into the machine's temporary directory.
chmod 755 SoftwareAGInstalleryyyymmdd-operating_system.bin
sh SoftwareAGInstalleryyyymmdd-operating_system.bin
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.
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.
To change the temporary directory for Software AG Installer and the bin file extract location, set the following environment variable before running the bin file:
TMPDIR=<temporary-directory>
export TMPDIR
To specify custom Java options, set the following environment variable before running the bin file:
SAG_JAVA_OPTIONS=<custom-options>
export SAG_JAVA_OPTIONS
As you move through the installer 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 installation concludes successfully, the installer will delete the stored files in the default temporary directory and, if you used the bin file, the bin file content.