Using Software AG Installer

Version 10.5

October 2019
This document applies to Software AG Installer Version 10.5 and to all subsequent releases.
Specifications contained herein are subject to change and these changes will be reported in subsequent release notes or new editions.
Copyright © 2010-2019 Software AG, Darmstadt, Germany and/or Software AG USA Inc., Reston, VA, USA, and/or its subsidiaries and/or
its affiliates and/or their licensors.
The name Software AG and all Software AG product names are either trademarks or registered trademarks of Software AG and/or
Software AG USA Inc. and/or its subsidiaries and/or its affiliates and/or their licensors. Other company and product names mentioned
herein may be trademarks of their respective owners.
Detailed information on trademarks and patents owned by Software AG and/or its subsidiaries is located at
hp://softwareag.com/licenses.
Use of this software is subject to adherence to Software AG's licensing conditions and terms. These terms are part of the product
documentation, located at hp://softwareag.com/licenses and/or in the root installation directory of the licensed product(s).
This software may include portions of third-party products. For third-party copyright notices, license terms, additional rights or
restrictions, please refer to "License Texts, Copyright Notices and Disclaimers of Third Party Products". For certain specific third-party
license restrictions, please refer to section E of the Legal Notices available under "License Terms and Conditions for Use of Software AG
Products / Copyright and Trademark Notices of Software AG Products". These documents are part of the product documentation, located
at hp://softwareag.com/licenses and/or in the root installation directory of the licensed product(s).
Use, reproduction, transfer, publication or disclosure is prohibited except as specifically provided for in your License Agreement with
Software AG.

Document ID: WIR-UG-105-20191015

 M
Table of Contents

Table of Contents

About this Guide..............................................................................................................................7

Document Conventions.............................................................................................................. 7
Online Information and Support................................................................................................. 8
Data Protection........................................................................................................................... 9

Concepts......................................................................................................................................... 11
Software AG Installer and Uninstaller...................................................................................... 12
Installation Methods..................................................................................................................12
Install Products from Empower......................................................................................... 12
Install Products Using an Installation Image.....................................................................13
Install Products Using an Installation Script......................................................................14
Install Products or Create Images Faster................................................................................ 14
Generate Images for Multiple Operating Systems from an Image Generation Script...............14
Uninstallation Methods............................................................................................................. 15
Installation and Uninstallation Modes.......................................................................................15
JDK Support............................................................................................................................. 15
Ports..........................................................................................................................................16
Logging..................................................................................................................................... 16
EU General Data Protection Regulation (GDPR).....................................................................17

Critical Requirements and Recommendations for Successful Installation and

Uninstallation..................................................................................................................................19
Machine Requirements.............................................................................................................20
Access Requirements...............................................................................................................21
Installer/Uninstaller and Installation/Uninstallation Requirements............................................ 21
Troubleshooting Downloads..................................................................................................... 22

Using GUI Mode to Install.............................................................................................................25

Start the Installer on a Windows System.................................................................................26
Start the Installer on a Mac OS X, UNIX, or Linux System..................................................... 26
View the Welcome Panel......................................................................................................... 28
Use a Proxy Server..................................................................................................................29
Provide Credentials.................................................................................................................. 30
Choose Release....................................................................................................................... 31
Specify the Installation Directory.............................................................................................. 32
Select Products to Install..........................................................................................................34
Select Language Packs to Install.............................................................................................35
Read the License Agreement...................................................................................................35
Configure Products................................................................................................................... 36
Review and Install.................................................................................................................... 36
Use Installation Images............................................................................................................ 36
Create an Image for One Operating System.................................................................... 37

Using Software AG Installer Version 10.5 3

 M
Table of Contents

Install from an Image........................................................................................................ 39

Use Existing Images to Install Products or Create Images Faster...........................................39
Use Installation Scripts.............................................................................................................41
Create a Script.................................................................................................................. 41
Edit an Existing Script....................................................................................................... 42
Install from a Script Using the GUI................................................................................... 43
Install from a Script Using the Command Line on Windows Systems.............................. 43
Generate Images for Multiple Operating Systems from an Image Generation Script...............44
Create the Image Generation Script................................................................................. 44
Generate Images...............................................................................................................45
Change Logging Options..........................................................................................................46

Using Console Mode to Install.....................................................................................................49

Start the Installer...................................................................................................................... 50
Use a Proxy Server..................................................................................................................51
Provide Credentials.................................................................................................................. 51
Choose Release....................................................................................................................... 52
Specify the Installation Directory.............................................................................................. 52
Select Products to Install..........................................................................................................52
Select Language Packs to Install.............................................................................................54
Read the License Agreement...................................................................................................54
Configure Products................................................................................................................... 54
Use Installation Images............................................................................................................ 54
Create an Image............................................................................................................... 54
Display the Contents of an Image.................................................................................... 56
Validate the Contents of an Image................................................................................... 56
Install from an Image........................................................................................................ 56
Use Existing Images to Install Products or Create Images Faster...........................................56
Use Installation Scripts.............................................................................................................57
Create a Script.................................................................................................................. 57
Edit an Existing Script....................................................................................................... 58
Install from a Script on Mac OS X System, Other UNIX System, or Windows System......58
Generate Images for Multiple Operating Systems from an Image Generation Script...............59
Create an Image Generation Script.................................................................................. 59
Generate Images...............................................................................................................60
Change Logging Options..........................................................................................................60

Uninstalling.....................................................................................................................................63
Overview................................................................................................................................... 64
Before You Begin......................................................................................................................64
Start the Uninstaller..................................................................................................................65
Uninstall Selected Products from Local or Remote Machine................................................... 65
Uninstall All Products from Local or Remote Machine with No User Input...............................66
Uninstall All Products Silently in GUI Mode......................................................................66
Uninstall All Products Silently in Console Mode............................................................... 67
Uninstall Using a Script............................................................................................................ 67

Using Software AG Installer Version 10.5 4

 M
Table of Contents

Uninstall Using a Script in GUI Mode............................................................................... 67

Uninstall Using a Script in Console Mode........................................................................ 67
Create a Script........................................................................................................... 67
Edit an Existing Script................................................................................................68
Uninstall Using a Script..............................................................................................68
Windows Usage Notes............................................................................................................. 68

Using Software AG Installer Version 10.5 5

 M
Even Header

Using Software AG Installer Version 10.5 6

 M
Odd Header

About this Guide

This guide explains how to prepare your machine to use this release of Software AG
Installer, and how to use Software AG Installer and Software AG Uninstaller to install
and uninstall your products.
This release of Software AG Installer supports installation of several different
releases of Software AG products. This guide, therefore, is intended for use with the
Software AG product installation guides for all supported product releases. The product
installation guides provide product-specific preparation, installation, and uninstallation
instructions. However, features offered by this release of Software AG Installer might
not be available when you install products that were released before that date.

Document Conventions
Convention Description

Bold Identifies elements on a screen.

Narrowfont Identifies service names and locations in the format

folder.subfolder.service , APIs, Java classes, methods, properties.

Italic Identifies:
Variables for which you must supply values specific to your own
situation or environment.
New terms the first time they occur in the text.
References to other documentation sources.

Monospace Identifies:
font
Text you must type in.
Messages displayed by the system.
Program code.

{} Indicates a set of choices from which you must choose one. Type
only the information inside the curly braces. Do not type the { }
symbols.

| Separates two mutually exclusive choices in a syntax line. Type

one of these choices. Do not type the | symbol.

Using Software AG Installer Version 10.5 7

 M
Even Header

Convention Description

[] Indicates one or more options. Type only the information inside

the square brackets. Do not type the [ ] symbols.

... Indicates that you can type multiple options of the same type.
Type only the information. Do not type the ellipsis (...).

Online Information and Support

Software AG Documentation Website
You can find documentation on the Software AG Documentation website at “hp://
documentation.softwareag.com”. The site requires credentials for Software AG's Product
Support site Empower. If you do not have Empower credentials, you must use the
TECHcommunity website.

Software AG Empower Product Support Website

If you do not yet have an account for Empower, send an email to
“[email protected]” with your name, company, and company email address
and request an account.
Once you have an account, you can open Support Incidents online via the eService
section of Empower at “hps://empower.softwareag.com/”.
You can find product information on the Software AG Empower Product Support
website at “hps://empower.softwareag.com”.
To submit feature/enhancement requests, get information about product availability,
and download products, go to “Products”.
To get information about fixes and to read early warnings, technical papers, and
knowledge base articles, go to the “Knowledge Center”.
If you have any questions, you can find a local or toll-free number for your country
in our Global Support Contact Directory at “hps://empower.softwareag.com/
public_directory.asp” and give us a call.

Software AG TECHcommunity
You can find documentation and other technical information on the Software AG
TECHcommunity website at “hp://techcommunity.softwareag.com”. You can:
Access product documentation, if you have TECHcommunity credentials. If you do
not, you will need to register and specify "Documentation" as an area of interest.
Access articles, code samples, demos, and tutorials.

Using Software AG Installer Version 10.5 8

 M
Odd Header

Use the online discussion forums, moderated by Software AG professionals, to

ask questions, discuss best practices, and learn how other customers are using
Software AG technology.
Link to external websites that discuss open standards and web technology.

Data Protection
Software AG products provide functionality with respect to processing of personal data
according to the EU General Data Protection Regulation (GDPR). Where applicable,
appropriate steps are documented in the respective administration documentation.

Using Software AG Installer Version 10.5 9

 M
Even Header

Using Software AG Installer Version 10.5 10

 M
Odd Header
Concepts

1   Concepts
■ Software AG Installer and Uninstaller .......................................................................................... 12
■ Installation Methods ..................................................................................................................... 12
■ Install Products or Create Images Faster .................................................................................... 14
■ Generate Images for Multiple Operating Systems from an Image Generation Script .................. 14
■ Uninstallation Methods ................................................................................................................. 15
■ Installation and Uninstallation Modes .......................................................................................... 15
■ JDK Support ................................................................................................................................. 15
■ Ports ............................................................................................................................................. 16
■ Logging ......................................................................................................................................... 16
■ EU General Data Protection Regulation (GDPR) ........................................................................ 17

Using Software AG Installer Version 10.5 11

 M
Even Header
Concepts

Software AG Installer and Uninstaller

This chapter explains Software AG Installer concepts and the features offered by the this
release of the installer.

Important: Each release of the Software AG Installer supports installation of many

different releases of Software AG products. However, features offered by the
this release of the Software AG Installer might not be available when you
install products that were released before this release. To see the release date
for any Software AG Installer, see the installer’s About information.

For detailed instructions on using the installer, see the other chapters in this guide.

Installation Methods
The Software AG Installer offers the methods below for installing products.
You can install the latest releases of products directly from the Software AG
Empower Product Support website on one machine. Empower always offers only the
latest product releases.
You can download products from Empower into an installation image and then install
some or all products from the image on one or more machines.
You can record an installation script of yourself installing products from Empower or
from an installation image, and then install the products with no user input on one
or more machines.

Install Products from Empower

You can install products by running the Software AG Installer and connecting to
Empower. You might use this method if you want to install the latest releases of
products, and you want to install on a single machine, and the machine on which you
want to install can go outside your corporate firewall.
When you install from Empower, the installer automatically manages dependencies for
the products you select. When you select a product to install, the installer automatically
selects additional products that are required by the selected product for you, and does
not allow you to unselect them without also unselecting the dependent products.
The installer also asks for machine- and product-specific information such as target
installation directory and product port values, license files, and database connection
parameters.

Using Software AG Installer Version 10.5 12

 M
Odd Header
Concepts

Install Products Using an Installation Image

You can download products from Empower into an installation image and then use that
image to install products on one or more machines. When you install from the image,
you can choose to install only the subset of products you want on each machine. You
might use this method in these cases:
When machines on which you want to install cannot go outside your corporate
firewall (that is, cannot connect to Empower).
You want to store a specific release of each product so you can install the same
product releases on multiple machines over time. Empower provides only the latest
releases of products, so the release of a product that is available now might be
replaced by a later release in the future. An installation image always contains the
releases of the products that you downloaded into it from Empower.

Important: Software AG recommends creating images so you can ensure consistency

across product installations over time.

You want to install some or all of the same products on multiple machines, and you
want to avoid the time required to download from Empower.
You create an image by running the Software AG Installer, connecting to Empower,
and selecting products to download into the image. You can create an image for any
operating system from any operating system; for example, you can create an image for
a Solaris system from a Windows system. When you create an image, therefore, the
installer ignores the local machine. This means that:
When you select a product to include in the image, the installer does not
automatically select additional products that are required by the selected product.
Instead, the installer lists the required products and asks whether to select them for
you. If the target installation directories are empty, you would accept the offer. If
you know that the target installation directories already contain all or some of the
required products and you want to reduce the size of the image, you can accept the
offer and then deselect already installed products, or refuse the offer and make the
necessary selections yourself.
The installer does not ask for machine-specific information such as target installation
directory or product port values. You will provide the machine-specific information
when you install from the image on each target machine.
The installer does not request product-specific information such as product port
values, license files, and database connection parameters during image creation. You
will provide product-specific information when you install from the image on each
target machine.
The installer saves images as zip files. Each zip file includes an HTML file named
ImageContents.html that you can open to see the contents of the image.

Using Software AG Installer Version 10.5 13

 M
Even Header
Concepts

Install Products Using an Installation Script

You can record yourself installing products from Empower or from an installation image
and then use the recording, or script, to install products on one or more machines. The
script automatically installs all products in the script on each machine. You might use
this method if you want to install identical product installations on multiple machines,
or if you want to automate product installation.
When you create a script while installing from Empower, the script contains your
Empower user name and password and references the latest releases of your products.
When you install from the script, the referenced product releases must be available or
the script will fail.
When you create a script while installing from an image, the script references the
releases of your products that are in the image and contains the location of the image.
When you install from the script, the image must be in the same location or the script
will fail.
When you create a script, you specify all machine-specific values, such as target
installation directory and product port values, and all product-specific values, such as
license files and database connection parameters. Because scripts run with no user input,
you cannot change these values when you install from the script. If these values are not
accurate for all target machines, the script will fail.
You can edit an existing script. You can create a script by editing an existing script and
saving it under a new name.

Install Products or Create Images Faster

When you install products from the installer (not through an image of script) and when
you create an installation image, the installer downloads the products from Empower. If
you already have existing images that contain some of the products you want to install
or include in the new image, you can improve performance by identifying the existing
images to the installer. The installer will retrieve those products from the existing images
rather than download them from Empower.
You can specify any existing image that contains the products you want. It does not
maer which operating systems the image was created for.

Generate Images for Multiple Operating Systems from an

Image Generation Script
You can generate images for multiple operating systems from an image generation script
script. Image generation scripts contain only a list of products you select. The list should
be a master list from which you can create various images, so when you create the script

Using Software AG Installer Version 10.5 14

 M
Odd Header
Concepts

you select the operating system that supports the greatest number of your products. For
most products, that operating system is Microsoft Windows 64-bit.
Image generation scripts do not specify release numbers for the products. When you
generate an image from an image generation script, the installer connects to Empower
and downloads the latest releases of the selected products at that point in time into the
image.

Note: You cannot use an image generation script to install products; it is not an
installation script. The only purpose of an image generation script is to enable
you to generate images for multiple operating systems.

Uninstallation Methods
You can uninstall products using these methods:
You can uninstall specified products from the local machine.
You can uninstall all products from the local machine.
You can create an uninstallation script for specified products and run it on multiple
machines with identical installations.

Installation and Uninstallation Modes

You can run the Software AG Installer and Software AG Uninstaller using different
modes, as follows:
Graphical user interface (GUI). You can use GUI mode to install or uninstall
using the installer, an image, or a script on all operating systems supported by
Software AG products. UNIX systems must have an X Windows environment.

Note: The Software AG Installer does not support running in compatibility mode
on Windows systems. For example, the installer does not support running
in Windows XP compatibility mode on Windows Vista or Windows 7.

Console mode. You can use console mode to install or uninstall locally or remotely
using the installer, an image, or a script on all non-Windows operating systems
supported by Software AG products. You can also use console mode to install or
uninstall using a script on Windows operating systems.

JDK Support
The Software AG Installer installs a separate JDK for the products in the
Software AG_directory/jvm directory and configures the products and the Software AG

Using Software AG Installer Version 10.5 15

 M
Even Header
Concepts

Uninstaller to use it. For information on supported JDKs, see the product system
requirements on the Software AG Documentation website.

Important: Do not apply maintenance updates from the vendor of the installed JDK.
If an update to the installed JDK is required, Software AG will provide the
update in the form of a fix.

If you want your products to be able to run in FIPS mode, or use algorithms such as 256-
bit AES, your JVM must use Java Cryptography Extension (JCE) Unlimited Strength
Jurisdiction Policy Files.
The table below explains how to obtain JCE Unlimited Strength Jurisdiction Policy Files.

For Software AG Products Obtain JCE Unlimited Strength Jurisdiction Policy Files
Released at this Time

October 2018 and later JDKs installed by the Software AG Installer

contain the files. No action is necessary.

October 2015 through Do one of the following:

October 2017
Install Java Package Fix 11 to get the files.
Download the files from the appropriate
website to the directory specified in the vendor
documentation.

Before October 2015 Download the files from the appropriate

website to the directory specified in the vendor
documentation.

Ports
The Software AG Installer uses HTTP port 80 to download files over the Internet, or if
you choose to use SSL, port 443.

Logging
By default, the Software AG Installer writes errors that occur during installation to a
file named installLog.txt in the Software AG_directory/install/logs directory. If errors
occur during uninstallation, the Software AG Uninstaller writes them to a file named
uninstallLog.txt and stores the file in the same directory. You can increase or decrease
the amount of information that is wrien, specify a different file name and directory,
and choose to write to standard out and standard error in addition to the log file.

Using Software AG Installer Version 10.5 16

 M
Odd Header
Concepts

The Software AG Installer writes product, version, and build information to an audit
history log file named history.txt in the Software AG_directory/install/history directory.
The Software AG Installer writes provisioning operations information to a log file
named sag-osgi.log in the Software AG_directory/install/profile/logs directory.

EU General Data Protection Regulation (GDPR)

The Software AG Installer connects to the Software Download Center on Empower to
download your products. The installer collects and stores IP addresses and Empower
user names on the Software Download Center so it can track problems that occur during
installation of products. To request removal of this personal data from the Software
Download Center, contact Software AG Global Support.

Using Software AG Installer Version 10.5 17

 M
Even Header

Using Software AG Installer Version 10.5 18

 M
Odd Header
Critical Requirements and Recommendations for Successful Installation and Uninstallation

2   Critical Requirements and Recommendations for

Successful Installation and Uninstallation

■ Machine Requirements ................................................................................................................ 20

■ Access Requirements .................................................................................................................. 21
■ Installer/Uninstaller and Installation/Uninstallation Requirements ................................................ 21
■ Troubleshooting Downloads ......................................................................................................... 22

Using Software AG Installer Version 10.5 19

 M
Even Header
Critical Requirements and Recommendations for Successful Installation and Uninstallation

Machine Requirements
Make sure the machine on which you are going to run the installer has at least 1GB
of available virtual memory, and at least 200MB of free disk space in its system temp
(Windows) or temporary (UNIX) directory.
If you are going to create an installation image, make sure the machine on which
you are going to run the installer has at least twice the size of the installation image
in free disk space in the file system that will contain the image file. For example,
if you are going to create the 1GB image MyImage.zip in C:\MyDirectory, file
system C:\ must have at least 2GB free disk space available. This is because the
installer downloads the products to a directory with the same name as the image (for
example, C:\MyDirectory\MyImage) before adding the products to the image, so if
you lose your connection to Empower, you can resume where you left off. To predict
the image size, see the numbers for Free Space Required (for the image) and Free
Space Available (in the file system) in the product selection tree after you select the
products to include in the image.
Make sure the machine on which you are going to run the installer has enough free
disk space in its system temp (Windows) or temporary (UNIX) directory. If you are
going to install from an installation image, you need 200MB of free disk space in that
directory. If you are going to install from an installation image, you need 200MB plus
the size of the image of free disk space in that directory. For example, if the image is
200MB, the directory must have at least 400MB of available disk space.
If you are going to install on a Windows system:
Make sure the machine on which you are going to run the installer has the latest
Windows updates. On Windows 8.1 and Windows Server 2012 R2, installation
will fail if the Microsoft update KB2919355 from April 2014 is not present.
You can only install Software AG products on a local hard drive. You cannot
install the products on a network-mounted drive.
If you are going to install or uninstall on a UNIX system, and you are going to do so
using the GUI, your local machine must be equipped with an X11 display server.

Note: Results from using different X11 display servers may vary. If you
experience problems with one X11 display server, Software AG
recommends trying another. MobaXterm, for example, has been used
successfully with the Software AG Installer.

If you are installing on a Linux system, Software AG recommends turning off

Security Enhanced Linux (SELinux).

Using Software AG Installer Version 10.5 20

 M
Odd Header
Critical Requirements and Recommendations for Successful Installation and Uninstallation

Access Requirements
If you are going to install on a Windows system, create a user account for performing
the installation, give the account Windows system administrator privileges, and
install as that user. The installation user will own all files you install.
If you are going to install on a UNIX system, create a non-root user account for
performing the installation and install as that user. The installation user will own all
files you install.
If you are going to install new products into an existing Software AG installation
directory (that is, a directory that contains Software AG products from the same
release), use the same user account to install the new products.
The user account must have full read and write permissions to the directory in which
you are going to install your products.
Use the same user account to uninstall products.

Installer/Uninstaller and Installation/Uninstallation

Requirements
To avoid problems with shared system resources, run only one installer instance
at a time on the machine. Make sure the entire product installation is complete and
the installer instance is shut down before starting any other installer instance on the
machine.
To avoid product or file conflicts, do not run the installer and the Software AG
Update Manager at the same time.
Do not modify or remove files that are installed or created by the Software AG
Installer or Software AG Update Manager unless specifically instructed to do so by
Software AG. Do not modify or remove files from the Software AG_directory \install
or UpdateManager directory; these directories contain important metadata that is
used by the installer and the Software AG Update Manager.
The installer installs a JDK for the products. Do not apply maintenance updates from
the vendor of the JDK. If an update is required, Software AG will provide the update
in the form of a fix.
Only install products from a single release in an installation directory. Do not mix
products from different releases in the same installation directory. Doing so is not
supported, and you will experience problems or be unable to access functionality.
Create installation images of your products and store them on your internal
network. Create an image for each operating system on which you plan to install
that is covered by your license agreement. Storing images enables you to ensure
consistency across installations over time; the installer provides only the latest

Using Software AG Installer Version 10.5 21

 M
Even Header
Critical Requirements and Recommendations for Successful Installation and Uninstallation

product releases, while installation images contain the product releases you
download into them. In addition, installing from images helps you reduce WAN
traffic and improve installation speeds.
Uninstall products using the uninstaller that came with the installer you used to
install the products. For example, if you used the April 2015 Software AG Installer
to install products, use the April 2015 Software AG Uninstaller to uninstall the
products.
This guide provides general instructions for installing and uninstalling. See
your product installation guide for additional, product-specific installation and
uinstallation instructions.

Troubleshooting Downloads
Product jar files and product files downloaded from Empower are verified using
SHA256 checksums.
The installer performs a write check before downloading files. On some
systems using Kaspersky anti-virus software, the write check might fail. If
possible, disable your anti-virus software. If you are installing on Windows
using SoftwareAGInstalleryyyymm .exe, try seing environment variable
ZFUSION_INSTALL_ARGS= -skipWriteCheck and restarting the installer. If UAC is
enabled on the machine, launch a command shell using Run as Administrator and
execute SoftwareAGInstalleryyyymm .exe from inside the shell.
During file download, activity might appear at times to stop completely. The cause
might be that your virus scanner is scanning the files the installer is downloading.
The download will resume after the virus scanner finishes scanning the files.
If your network interferes with the downloading of files, you might have problems
connecting to Empower or see error messages about corrupted Zip files. Try the
following:
Most download issues are caused by interference from a security appliance
such as a virus scanner. Ask your network administrator whether he can make
an adjustment to allow the download to work properly. Also check whether a
proxy must be used to download files properly in the installer. Ask the network
administrator to check the security seings for your proxy or firewall; they might
be incompatible with the installer. If so, ask your IT department for temporary
access to a port outside the firewall to download the files.
Run the installer again, but this time select the Use SSL to connect to the Software
AG Installer Server option on the Proxy panel, and select the Verbose logging level
on the Advanced Options Logging tab. Using SSL may allow installation to
continue despite security appliances because the streams will be encrypted; the
encrypted streams should not trigger anti-virus, anti-malware, or other scanners.
Also test whether your network is handling SSL traffic properly; public websites
are available to help with this diagnoses. The verbose log will give you a great

Using Software AG Installer Version 10.5 22

 M
Odd Header
Critical Requirements and Recommendations for Successful Installation and Uninstallation

deal of troubleshooting information, but even if you cannot spot the problem,
you will need to provide the verbose log to Software AG Global Support.
If you have access to another network, try running the same installation on the
other network. If the installation succeeds, create an installation image to use on
machines in the network that is experiencing problems.
If you are still having trouble after trying these options, contact Software AG
Global Support for help. If the issue cannot be resolved after exploring all
possibilities, or if you need an installation image urgently, Software AG Global
Support can contact Software AG Logistics to provide your products on a DVD
or through a private FTP site.

Using Software AG Installer Version 10.5 23

 M
Even Header

Using Software AG Installer Version 10.5 24

 M
Odd Header
Using GUI Mode to Install

3   Using GUI Mode to Install

■ Start the Installer on a Windows System .................................................................................... 26
■ Start the Installer on a Mac OS X, UNIX, or Linux System ......................................................... 26
■ View the Welcome Panel ............................................................................................................. 28
■ Use a Proxy Server ..................................................................................................................... 29
■ Provide Credentials ...................................................................................................................... 30
■ Choose Release ........................................................................................................................... 31
■ Specify the Installation Directory ................................................................................................. 32
■ Select Products to Install ............................................................................................................. 34
■ Select Language Packs to Install ................................................................................................ 35
■ Read the License Agreement ...................................................................................................... 35
■ Configure Products ....................................................................................................................... 36
■ Review and Install ........................................................................................................................ 36
■ Use Installation Images ................................................................................................................ 36
■ Use Existing Images to Install Products or Create Images Faster .............................................. 39
■ Use Installation Scripts ................................................................................................................ 41
■ Generate Images for Multiple Operating Systems from an Image Generation Script .................. 44
■ Change Logging Options ............................................................................................................. 46

Using Software AG Installer Version 10.5 25

 M
Even Header
Using GUI Mode to Install

Start the Installer on a Windows 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.

Important: On a Hebrew Windows system, move the exe file to a directory whose
path does not include Hebrew characters. If you cannot do this, you
must instead use the instructions in “Start the Installer on a Mac OS X,
UNIX, or Linux System” on page 26 to install.

b. Copy the product license files aached 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.
5. 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.
6. Open Windows Explorer, go to the directory that contains the downloaded installer,
and double-click the SoftwareAGInstalleryyyymm .exe file.
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.
As you move through the wizard, the installer stores some of the files it requires in
the default system temp 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.

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.

Using Software AG Installer Version 10.5 26

 M
Odd Header
Using GUI Mode to Install

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 aached 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. 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.
6. 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.
7. 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.
8. Take the action below to start the installer, based on the file you downloaded from
Empower.

Using Software AG Installer Version 10.5 27

 M
Even Header
Using GUI Mode to Install

Operating File Actions

System

Mac dmg Double-click the file.

OS X

UNIX, bin Run the command below. The bin file is a self-extracting
Linux 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 reuse the extracted content of the bin file, specify the following before running
the bin file:
SAGINSTALLERDIR=/path/to/installer
export SAGINSTALLERDIR

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.

View the Welcome Panel

After you start the installer, the installer displays the Welcome panel. You can resize the
GUI.

Using Software AG Installer Version 10.5 28

 M
Odd Header
Using GUI Mode to Install

Use a Proxy Server

If the installer can connect to the Software AG Installer server without going through a
proxy, it displays a message to that effect. You can click Next to continue, click AutoDetect
to have the installer auto-detect your proxy servers so you can select one to use, or
manually supply the seings for an HTTP or Socks proxy server.
If the installer cannot connect to the Software AG Installer server without going through
a proxy server but detects a proxy server, it displays a message to that effect. You can
take the same actions as above.

Using Software AG Installer Version 10.5 29

 M
Even Header
Using GUI Mode to Install

If the installer cannot connect to the Software AG Installer server without going through
a proxy server and does not detect a proxy server, consult your network administrator.
You will not be able to continue installation until the issue is resolved.

Provide Credentials

Provide your Empower user name and password; these credentials tell the installer
which products you have licensed. Click Next. The installer connects to Empower and
verifies your credentials.

Using Software AG Installer Version 10.5 30

 M
Odd Header
Using GUI Mode to Install

Choose Release

Click the product release that includes the products you have licensed and want to
install. Click Next. The installer downloads the list of your products.

Using Software AG Installer Version 10.5 31

 M
Even Header
Using GUI Mode to Install

Specify the Installation Directory

For Installation directory, specify the installation directory in which to install your
Software AG products.

Note: If you want to use a symlink for the installation directory, you must use the
symlink every time you install into the directory. For example, you cannot
install some products using a directory name and then later create a symlink
and use it to install more products into the same directory, or vice versa.

Using Software AG Installer Version 10.5 32

 M
Odd Header
Using GUI Mode to Install

When you install using any method, the installer auto-detects a host name or IP address
for the machine on which you are running the installer. You might need to change that
value, as follows:
If the machine has multiple host names or IP addresses, the value detected by the
installer might not be the one you want to use. For example, the installer might
have detected an IP address that is only accessible from inside your organization’s
network. If you want the products to be accessible from outside your organization,
replace the auto-detected value with an externally accessible host name or IP
address.
If you are installing in the cloud, the installer detects the internal IP address of the
cloud instance. If you want your products to be accessible from outside the cloud
instance (for example, from another cloud instance running other products), replace
the auto-detected value with an externally accessible host name or IP address.
If you are creating a script, the installer stores the auto-detected or changed value in the
script. When you install from the script, the installer will use the stored value.

Note: Some third-party applications used by Software AG runtime products have

limitations regarding spaces in the installation directory. Software AG
therefore recommends installing in a directory that does not include spaces.
However, if you are installing on a Windows system, you can install some
Software AG design-time products in a directory under Program Files; the
installer indicates which products.

If you are installing on a Windows system, for Start Menu group name, specify the name to
use for the Start menu group for the products you are installing.
Click Next.

Using Software AG Installer Version 10.5 33

 M
Even Header
Using GUI Mode to Install

Select Products to Install

The installer lists all products you can download.

Important: The installer does not distinguish among versions (Windows) or flavors
(UNIX) of an operating system. Make sure you install products only on the
supported versions or flavors listed in the products’ system requirements.

The highest level in the product tree shows product names and releases, while the
lower levels show the items that make up or can be used with the product. If you have
already installed a product or item in the specified installation directory, the item name
is followed by the text (Installed) and the item name and its check box are grayed out.

Using Software AG Installer Version 10.5 34

 M
Odd Header
Using GUI Mode to Install

You can select products using these methods:

Select typical development installations from the Typical Installations list. The installer
automatically selects the products that make up those installations.
Select every product in the tree by clicking .
Select individual products in the tree. If a selected product requires other products
on the same machine, the installer does the following:
If you are installing from Empower, the installer automatically selects the
required products.

Note: If you later unselect products, the installer does not automatically
unselect the required products. To clear all automatically selected
required products, clear all selections on the tree and make your
product selections again.

If you are creating an image, the installer lists the required products and asks
whether to download them into the image. If the required products are not in the
target installation directories, you must include them in the image. If you do not,
when you try to install from the image, installation will fail.

Note: If a selected product requires other products but those products can be
installed on a different machine, the installer does not automatically select
or list those products.

When you are done, click Next.

Select Language Packs to Install

If language packs are available for products you are installing or have already installed,
the installer displays the language packs tree. The behavior of this tree is the same as the
behavior of the product tree.
By default, the installer installs U.S. English for all products, but many products support
multiple languages. You can install as many language packs as you want, and all of the
languages installed will be available to users. Select the language packs to install, and
then click Next.

Read the License Agreement

Read the license agreement and indicate whether you accept the terms. To read
the third-party license agreements, you need Internet access. If you do not have
Internet access, you can go to a machine that has Internet access and enter “hp://
documentation.softwareag.com/legal” in a browser.

Using Software AG Installer Version 10.5 35

 M
Even Header
Using GUI Mode to Install

Configure Products
If configuration values are necessary for products you are installing, the installer asks
for configuration information. For details on product configuration, see the appropriate
product installation documentation.

Review and Install

Review the list of products and items you have selected for installation. If the list is not
correct, click Back until you reach the product tree and correct your selections. If the list
is correct, click Next.
If you are going to install new products into an existing product installation directory
(that contain products from the same release), the sections in this chapter about starting
the installer instructed you to shut down running products installed in that directory.
On Windows, if any products are still running, the installer lists those products. The
PID column in the list shows the process ID as you would see it in Task Manager. The
Product column lists the product name as it is shown in the installer product tree. Shut
down running products using the instructions in the product documentation.

Important: If you proceed with the installer while products are still running, the
installer might hang in the file copy stage because files it needs are locked, or
your installation could be corrupted. Do not use Task Manager to shut down
processes or your installation could be corrupted.

The installer installs the products and related items, and then displays the installation
complete panel. Click Close.

Important: If you stop the installer or the installer exits during the product configuration
stage, any product that has not yet been configured will appear with the
words (Configuration Incomplete) in the product selection tree in both the
installer and the uninstaller. You must uninstall and reinstall such products.

Use Installation Images

Important: Never extract or modify image files using any tool other than the installer.

On the Welcome panel, click Advanced Options, and then click the Images tab.

Using Software AG Installer Version 10.5 36

 M
Odd Header
Using GUI Mode to Install

Create an Image for One Operating System

1. Click Create image.
2. In the Image file field, type the name of the file in which to save the new image. You
can specify any name that is permied by your operating system. Do not specify an
extension; the installer will automatically add .zip.
By default, the installer will write the new image file to the directory it indicates
when you click OK. If you want to write the file to a different directory, include the
full path to the file in the Image file field. The directory to which you save the file
must already exist.
3. In the Image platform field, click the operating system for which to create the image.
You can create an image for any operating system from any operating system.

Using Software AG Installer Version 10.5 37

 M
Even Header
Using GUI Mode to Install

The table below shows the values for the supported operating systems.

Value Operating System

AIX IBM AIX

OSX Apple Mac OS X

HP11IT HP HP-UX Intel Itanium 2 (for product releases 10.3 and lower)

HP11 HP HP-UX PA-RISC

LNXS390X Linux RHEL and SLES IBM System z

LNX Linux RHEL and SLES x86

LNXAMD64 Linux RHEL and SLES x86-64 (EM64T, AMD64)

WNT Microsoft Windows x86

W64 Microsoft Windows x86-64 (EM64T, AMD64)

SOL Oracle Solaris SPARC

SOLAMD64 Oracle Solaris x86-64 (EM64T, AMD Opteron) (for product

releases 10.3 and lower)

4. Click OK and go to “Use a Proxy Server” on page 29. You will see all panels
described in that section and the following sections except the installation directory
panel and the product configuration panels; you will see those panels when you
install from the image.

Important: When you select products to download into an image, the installer
lists additional products that are required by the selected products. If
these required products do not already exist in the target installation
directories, you must include them in the image. If you do not, you will
not be able to install the selected products, and in some cases installation
will fail. This includes the Java package; if the Java package does not exist
in the target installation directories, you must include it in the image. The
installer includes the license agreement in every image.

Using Software AG Installer Version 10.5 38

 M
Odd Header
Using GUI Mode to Install

Install from an Image

1. Click Install from image.
2. In the Image file field, type the full path to the image file from which to install.
3. If you want to list the contents of the image, click Image Contents.
4. If you want to validate the contents of the image before installing from it, click
Validate Image. Validating makes sure that the image is not missing any files and all
checksums match.

Use Existing Images to Install Products or Create Images

Faster
On the Welcome panel, click Advanced Options, and then click the Caching tab.

Using Software AG Installer Version 10.5 39

 M
Even Header
Using GUI Mode to Install

Specify existing images that contain the products you want as described below. It does
not maer which operating systems the images were created for.
You can specify the full path to an image file and click Add.
You can specify directories that contain image files and click Add.
You can create a text file that lists image files, then specify the text file on the panel,
and click Add. For example, the text file could look like this:
C:\IS_HPUX.zip
C:\Designer_Solaris.zip
C:\MwS_Windows.zip

Each time you specify a file or directory, the installer lists it below the Source images
field.

Note: If you specify a file that is not an image file, the installer ignores it.

Using Software AG Installer Version 10.5 40

 M
Odd Header
Using GUI Mode to Install

Use Installation Scripts

On the Welcome panel, click Advanced Options, and then click the Scripts tab.

Create a Script
1. Click Create script and click For product installation.

Using Software AG Installer Version 10.5 41

 M
Even Header
Using GUI Mode to Install

2. Indicate whether to install products on the local machine during script creation.
3. In the Script file field, type the name of the file in which to save the new script. You
can specify any file name that is permied by your operating system.
By default, the installer will write the new script file to the directory it indicates
when you click OK. If you want to write the file to a different directory, include the
full path to the file in the Script file field. The directory to which you save the file
must already exist.
4. Later in the installer, you will provide your Empower user name and password to
download your products, and this password is stored in the script. If you want to
encrypt the password, provide a master password.
5. If you want to create the script of yourself installing from an image rather than from
Empower, click the Images tab, click Install from image, and type the name of the image
in the Image file field.
6. Click OK, go to “Use a Proxy Server” on page 29, and follow the rest of the
instructions in this chapter.

Important: If you are creating a script that will install products into an existing
Software AG product installation directory, select the installation
directory using the Browse buon. If you type the installation directory
name into the field instead, and you do not exactly match the upper and
lower casing for the directory name, your installation might become
corrupted and possibly unrecoverable.

Edit an Existing Script

Important: Do not edit a script manually, by opening the text file.

1. Click Edit script.

2. In the Script file to edit field, browse to the file that contains the script to edit.
3. If you want to save the edited script under a different name, in the Save script to file
field, type the name of the file in which to save the edited script. You can specify any
file name that is permied by your operating system. The directory to which you
save the file must already exist.
4. When you created the script, you might have provided a master password to encrypt
the stored Empower password. If so, provide that master password so the installer
can decrypt the Empower password.
5. Click OK, go to “Use a Proxy Server” on page 29, and follow the rest of the
instructions in this chapter.

Using Software AG Installer Version 10.5 42

 M
Odd Header
Using GUI Mode to Install

Install from a Script Using the GUI

Note: If you run a script on a machine with the Windows firewall enabled, you
might get warnings during script execution, which would cause your script to
hang or fail.

1. Click Install from script.

2. In the Script file field, type the full path to the script file from which to install.

Important: If you created the script from Empower, the product releases referred to
in the script must be available on Empower or the script will fail. If you
created the script from an image, the image must be in the location it was
in when you created the script or the script will fail.

3. When you created the script, you might have provided a master password to encrypt
the stored Empower password. If so, provide that master password so the installer
can decrypt the Empower password.
4. After a script runs successfully, by default, the installer exits immediately. If you
want the installer to instead display the Finish panel until you choose to exit, select
Display Finish panel.
5. If errors occur while a script is running, installation fails. By default, the installer
shows the errors and does not exit. You can choose instead to Exit immediately or to
Display error then exit after number_of_seconds seconds.

Install from a Script Using the Command Line on Windows Systems

If you run a script on a machine with the Windows firewall enabled, you might get
warnings during script execution, which would cause your script to hang or fail.
To use the exe file, do the following:
1. Log on as the installation user you created earlier.
2. Set the environment variable ZFUSION_INSTALL_ARGS to -readScript
full_path_to_script_file . For example, enter:
set ZFUSION_INSTALL_ARGS= -readScript c:\myScript.txt

When you created the script, you might have provided a master password to encrypt
the stored Empower password. If so, provide that master password so the installer
can decrypt the Empower password. For example, enter:
set ZFUSION_INSTALL_ARGS= -readScript c:\myScript.txt -masterPassword password

3. Open a command window, go to the directory that contains the installer, and
execute the following:
SoftwareAGInstalleryyyymm .exe

Using Software AG Installer Version 10.5 43

 M
Even Header
Using GUI Mode to Install

Note: If UAC is enabled on the machine, ZFUSION_INSTALL_ARGS

might not be read properly, and your script might not start.
Launch a command shell using Run as Administrator and execute
SoftwareAGInstalleryyyymm.exe from inside the shell:

If your company connects to the Internet through an HTTP or Socks proxy server,
you must use that proxy server to install. If you specified proxy information when
you created the script, the installer stored all seings except user name and password
in the script. If you want to override the stored seings, or if you did not specify
proxy information when you created the script, set the environment variable
ZFUSION_INSTALL_ARGS to the appropriate parameters below.
To have the installer use an HTTP proxy server:
set ZFUSION_INSTALL_ARGS=-proxyHost host -proxyPort port -proxyUser user
-proxyPass password

To have the installer use a Socks proxy server:

set ZFUSION_INSTALL_ARGS=-socksProxyHost host -socksProxyPort port

When you created the script, you might have provided a master password to encrypt the
stored Empower password. If so, provide that master password as [masterPassword
password so the installer can decrypt the Empower password.

After a script runs successfully, by default, the installer exits immediately. If you want
the installer to instead allow you to choose when to exit after the script completes,
specify the -scriptNoExit parameter at the end of the command.
If errors occur while a script is running, installation fails. By default, the installer shows
the errors and does not exit. If you want the installer to exit immediately with a non-
zero exit value, specify the -scriptErrorInteract no parameter at the end of the
command. If you want the installer to show the errors and pause for a specified number
of seconds before exiting, specify the -scriptErrorInteract number_of_seconds
parameter at the end of the command.

Generate Images for Multiple Operating Systems from an

Image Generation Script

Create the Image Generation Script

1. On the Welcome panel, click Advanced Options, and then click the Scripts tab.
2. Click Create script and then click For image generation.
3. In the Script file field, type the name of the file in which to save the new image
generation script. You can specify any file name that is permied by your operating
system.
By default, the installer will write the new script file to the directory it indicates
when you click OK. If you want to write the file to a different directory, include the

Using Software AG Installer Version 10.5 44

 M
Odd Header
Using GUI Mode to Install

full path to the file in the Script file field. The directory to which you save the file
must already exist.
4. If the operating system on which you are running the installer is the system that
supports the greatest number of products for which you want to generate images,
click OK, go to “Use a Proxy Server” on page 29, and follow the rest of the
instructions in this chapter.
Otherwise, follow the steps below to indicate the operating system that supports the
greatest number of products for which you want to generate images.

Note: Typically, the operating system that supports the greatest number of
products is Microsoft Windows 64-bit.

a. Click the Images tab and then click Create image.

b. In the Image file field, type any file name.

Note: This name is needed by the installer but is not used for any purpose.

c. In the Image platform field, click the operating system for which to generate the
image.
d. Go to “Use a Proxy Server” on page 29 and follow the rest of the instructions
in this chapter.

Generate Images
1. Restart the installer.
2. On the Welcome panel, click Advanced Options, and then click the Scripts tab.
3. Click Install from script.
4. In the Script file field, type the full path to the image generation script file you just
created.

Note: If you run a script on a machine with the Windows firewall enabled, you
might get warnings during script execution, which would cause your
script to hang or fail.

5. Click the Images tab and then click Create image.

6. In the Image file field, type the name of the file in which to save the new image. You
can specify any name that is permied by your operating system. Do not specify an
extension; the installer will automatically add .zip.
By default, the installer will write the new image file to the directory it indicates
when you click OK. If you want to write the file to a different directory, include the
full path to the file in the Image file field. The directory to which you save the file
must already exist.
7. In the Image platform list, click the system for which to generate the image.

Using Software AG Installer Version 10.5 45

 M
Even Header
Using GUI Mode to Install

8. Click OK and go to “Use a Proxy Server” on page 29. You will see all panels
described in that section and the following sections except the installation directory
panel and the product configuration panels; you will see those panels when you
install from the image.

Important: When you select products to download into an image, the installer
lists additional products that are required by the selected products. If
these required products do not already exist in the target installation
directories, you must include them in the image. If you do not, you will
not be able to install the selected products, and in some cases installation
will fail. This includes the Java package; if the Java package does not exist
in the target installation directories, you must include it in the image. The
installer includes the license agreement in every image.

9. Repeat the previous steps to create an image for each operating system you want.

Important: Do not extract or modify image files using any tool other than the
installer.

Change Logging Options

On the Welcome panel, click Advanced Options, and then click the Logging tab.

Using Software AG Installer Version 10.5 46

 M
Odd Header
Using GUI Mode to Install

The following table lists the value to enter to log specified types of information.

Type of Information to Log Value

Fatal only Fatal

Fatal and errors Error

Fatal, errors, and warnings Warning

Fatal, errors, warnings, and informational messages Info

All Verbose

Using Software AG Installer Version 10.5 47

 M
Even Header
Using GUI Mode to Install

Type of Information to Log Value

Note: This logging level produces a 10 to 200 MB file.

No information (that is, do not log any information) None

By default, the installer will write the log file to the directory it indicates when you click
OK. If you want to write the file to a different directory, include the full path to the file in
the Log file field.
If the log file reaches the specified maximum size, the installer begins writing a second
file (installLog_part2.txt), and then a third file (installLog_part3.txt), and so on, until
it writes ten files (installLog_part10.txt). It then overwrites the first file, and then the
second file, and so on.

Using Software AG Installer Version 10.5 48

 M
Odd Header
Using Console Mode to Install

4   Using Console Mode to Install

■ Start the Installer .......................................................................................................................... 50
■ Use a Proxy Server ..................................................................................................................... 51
■ Provide Credentials ...................................................................................................................... 51
■ Choose Release ........................................................................................................................... 52
■ Specify the Installation Directory ................................................................................................. 52
■ Select Products to Install ............................................................................................................. 52
■ Select Language Packs to Install ................................................................................................ 54
■ Read the License Agreement ...................................................................................................... 54
■ Configure Products ....................................................................................................................... 54
■ Use Installation Images ................................................................................................................ 54
■ Use Existing Images to Install Products or Create Images Faster .............................................. 56
■ Use Installation Scripts ................................................................................................................ 57
■ Generate Images for Multiple Operating Systems from an Image Generation Script .................. 59
■ Change Logging Options ............................................................................................................. 60

Using Software AG Installer Version 10.5 49

 M
Even Header
Using Console Mode to Install

Start the Installer

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 bin file for the Software AG Installer
from the Software Download Center on Empower.

Note: If you want to transfer the bin file 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 aached 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. 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.
6. Run the command below. The bin file is a self-extracting archive that extracts its
content into the machine's temporary directory.
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>

Using Software AG Installer Version 10.5 50

 M
Odd Header
Using Console Mode to Install

export TMPDIR

To reuse the extracted content of the bin file, specify the following before running
the bin file:
SAGINSTALLERDIR=/path/to/installer
export SAGINSTALLERDIR

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 bin file content
and the stored files in the default temporary directory.
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.

Use a Proxy Server

You can use SSL to connect to the Software AG Installer server.
If your company connects to the Internet through an HTTP or Socks proxy server, you
must use that proxy server to install.
If the installer can connect to the Software AG Installer server without going through a
proxy server, it displays a message to that effect. You can choose to continue, have the
installer auto-detect your proxy servers so you can select one to use, or manually supply
the seings for an HTTP or Socks proxy server.
If the installer cannot connect to the Software AG Installer server without going through
a proxy server but detects a proxy server, it displays a message to that effect. You can
take the same actions as above.
If the installer cannot connect to the Software AG Installer server without going through
a proxy server and does not detect a proxy server, consult your network administrator.
You will not be able to continue installation until the issue is resolved.

Provide Credentials
Provide your Empower user name and password; these credentials tell the installer
which products you have licensed. The installer connects to Empower and verifies your
credentials.

Using Software AG Installer Version 10.5 51

 M
Even Header
Using Console Mode to Install

Choose Release
Choose the product release that includes the products you have licensed and want to
install. The installer downloads the list of your products.

Specify the Installation Directory

Specify the installation directory in which to install your Software AG products.

Note: If you want to use a symlink for the installation directory, you must use the
symlink every time you install into the directory. For example, you cannot
install some products using a directory name and then later create a symlink
and use it to install more products into the same directory, or vice versa.

When you install using any method, the installer auto-detects a host name or IP address
for the machine on which you are running the installer. You might need to change that
value, as follows:
If the machine has multiple host names or IP addresses, the value detected by the
installer might not be the one you want to use. For example, the installer might
have detected an IP address that is only accessible from inside your organization’s
network. If you want the products to be accessible from outside your organization,
replace the auto-detected value with an externally accessible host name or IP
address.
If you are installing in the cloud, the installer detects the internal IP address of the
cloud instance. If you want your products to be accessible from outside the cloud
instance (for example, from another cloud instance running other products), replace
the auto-detected value with an externally accessible host name or IP address.
If you are creating a script, the installer stores the auto-detected or changed value in the
script. When you install from the script, the installer will use the stored value.

Note: Some third-party applications used by Software AG runtime products have

limitations regarding spaces in the installation directory. Software AG
therefore recommends installing in a directory that does not include spaces.
However, if you are installing on a Windows system, you can install some
Software AG design-time products in a directory under Program Files; the
installer indicates which products.

Select Products to Install

The installer lists the products you have licensed that are supported on the target
operating system.

Using Software AG Installer Version 10.5 52

 M
Odd Header
Using Console Mode to Install

Important: The installer does not distinguish among flavors of an operating system.
Make sure you install products only on the supported flavors listed in the
products’ system requirements

The highest level of the product tree shows product names and releases, while the lower
levels show the items that make up or are related to the product. If you have already
installed an item in the specified installation directory, the item name is preceded by the
leer I within brackets (that is, [I]).
The installer can display only a limited number of lines in the tree at a time. To page
forward through the tree, enter a plus sign (+). To page backward through the tree, enter
a minus sign (-). To search for a specific product or item, enter S, then enter the name of
the product or item. Enter S again to find the next occurrence of the product or item.
You can select products using the methods below in any combination. The installer puts
an X in the tree next to selected products and items.
Select typical development installations from the Typical Installations list by entering
the appropriate numbers. The installer automatically selects the products that make
up those installations.

Note: You might not see the selections until you page forward through the tree.

Select individual products in the tree by entering the numbers next to the product
headings. Enter each number on a separate line. If a selected product requires other
products on the same machine, the installer does the following:
If you are installing from Empower, the installer automatically selects the
required products.

Note: If you later unselect products, the installer does not automatically
unselect the required products. To clear all automatically selected
required products, clear all selections on the tree and make your
product selections again.

If you are creating an image, the installer lists the required products and asks
whether to download them into the image. If the required products are not in the
target installation directories, you must include them in the image. If you do not,
when you try to install from the image, installation will fail.

Note: If a selected product requires other products but those products can be
installed on a different machine, the installer does not automatically select
or list those products.

When you are done, press ENTER twice.

Using Software AG Installer Version 10.5 53

 M
Even Header
Using Console Mode to Install

Select Language Packs to Install

If language packs are available for products you are installing or have already installed,
the installer prompts you to choose language packs to install. Many products support
multiple languages; you can install as many language packs as you want, and all of the
languages installed (including the default, U.S. English) will be available to users.

Read the License Agreement

Read the license agreement and indicate whether you accept the terms. To read
the third-party license agreements, you need Internet access. If you do not have
Internet access, you can go to a machine that has Internet access and enter “hp://
documentation.softwareag.com/legal” in a browser.

Configure Products
If configuration values are necessary for products you are installing, the installer asks
for configuration information. For details on product configuration, see the appropriate
product installation documentation.

Use Installation Images

To perform the tasks below, specify the indicated parameters before the -console
parameter on the command you run to start the installer.

Important: Never extract or modify image files using any tool other than the installer.

Create an Image
To create an installation image, specify the -writeImage parameter on the command.
For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-writeImage full_path_to_new_image_file -console

You can specify any file name for the image that is permied by your operating system.
Do not specify an extension; the installer will automatically add .zip. The directory to
which you save the file must already exist.
By default, the installer creates the image for the operating system on which you are
running the installer. If you want to create the image for another operating system,
specify the -imagePlatform parameter on the command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system.bin

Using Software AG Installer Version 10.5 54

 M
Odd Header
Using Console Mode to Install

-writeImage full_path_to_new_image_file
-imagePlatform operating_system -console

On operating_system, identify the operating system for which to create the image.
The table below lists the values for the operating_system parameter.

Operating System Value for

operating_system

IBM AIX AIX

Apple Mac OS X OSX

HP HP-UX Intel Itanium 2 (for product releases 10.3 and HP11IT

lower)

HP HP-UX PA-RISC HP11

Linux RHEL and SLES IBM System z LNXS390X

Linux RHEL and SLES x86 LNX

Linux RHEL and SLES x86-64 (EM64T, AMD64) LNXAMD64

Microsoft Windows x86 WNT

Microsoft Windows x86-64 (EM64T, AMD64) W64

Oracle Solaris SPARC SOL

Oracle Solaris x86-64 (EM64T, AMD Opteron) (for product SOLAMD64

releases 10.3 and lower)

Go to “Use a Proxy Server” on page 51. You will see all prompts described in that
section and the following sections except the installation directory panel and the product
configuration panels; you will see those panels when you install from the image.

Important: When you select products to download into an image, the installer lists
additional products that are required by the selected products. If these
required products do not already exist in the target installation directories,
you must include them in the image. If you do not, you will not be able to
install the selected products, and in some cases installation will fail. This
includes the Java package; if the Java package does not exist in the target
installation directories, you must include it in the image. The installer
includes the license agreement in every image.

Using Software AG Installer Version 10.5 55

 M
Even Header
Using Console Mode to Install

Display the Contents of an Image

To list the contents of an image, specify the -imageContents parameter on the
command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system .bin
-imageContents full_path_to_image_file -console

Validate the Contents of an Image

Validating an image makes sure that the image is not missing any files and all
checksums match. To validate the contents of an image, specify the -validateImage
parameter on the command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-validateImage full_path_to_image_file -console

Install from an Image

To install from an installation image, specify the -readImage parameter on the
command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readImage full_path_to_image_file -console

Use Existing Images to Install Products or Create Images

Faster
To perform the tasks below, specify the indicated parameters before the -console
parameter on the command you run to start the installer.
To install products faster, specify the -existingImages parameter on the command.
For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-existingImages existing_image_files -console

To create images faster, specify the -existingImages, -writeImage, and -

imagePlatform parameters on the command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-existingImages existing_image_files
-writeImage full_path_to_image_file
-imagePlatform operating_system -console

For existing_image_files, specify existing images that contain the products you
want, as described below. It does not maer which operating systems the images were
created for.
You can specify full paths to image files. For example:
-existingImages /opt/myImages/IS_HPUX.zip,/opt/myImages/Designer_Solaris.zip

Using Software AG Installer Version 10.5 56

 M
Odd Header
Using Console Mode to Install

You can specify directories that contain image files. For example:
-existingImages /opt/myImages/MyImages

You can list image files in a text file. For example:

/opt/myImages/IS_HPUX.zip
/opt/myImages/Designer_Solaris.zip
/opt/myImages/MwS_Windows.zip

Then specify the file. For example:

-existingImages /opt/listofimages.txt

Note: If you specify files that are not image files, the installer ignores them.

Use Installation Scripts

To perform the tasks below, specify the indicated parameters before the -console
parameter on the command you run to start the installer.
When you create a script, you will provide your Empower user name and password
to download your products, and this password is stored in the script. If you want to
encrypt the password, provide a master password using the parameter masterPassword
password. You must then provide the master password using the same parameter when
you edit or install from the script.

Create a Script
To create an installation script, run one of the commands below. You can specify any file
name for the script that is permied by your operating system. The directory to which
you save the file must already exist.
To create an installation script and install products on the local machine, specify the
-writeScript parameter on the command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system .bin
-writeScript full_path_to_new_script_file -console

To create an installation script without installing products on the local machine,

specify the -editScript parameter on the command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system .bin
-editScript full_path_to_new_script_file -console

To create an installation script of yourself installing from an image rather than from
Empower, specify the -readImage parameter on the command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system .bin
{-writeScript|-editScript} full_path_to_new_script_file
-readImage full_path_to_existing_image_file -console

To create an installation script from an existing script, specify the -readScript and
-writeScript parameters on the command. For example:
sh SoftwareAGInstalleryyyymmdd -operating_system .bin
-readScript full_path_to_new_script_file

Using Software AG Installer Version 10.5 57

 M
Even Header
Using Console Mode to Install

-writeScript full_path_to_new_script_file -console

Edit an Existing Script

Important: Do not edit a script manually, by opening the text file.

To edit an existing installation script, specify the -editScript parameter on the

command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-editScript full_path_to_existing_script_file -console

Install from a Script on Mac OS X System, Other UNIX System, or

Windows System
To install from an installation script, specify the -readScript parameter on the
command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readScript full_path_to_existing_script_file

When you created the script, you might have provided a master password to encrypt
the stored Empower password. If so, provide that master password so the installer can
decrypt the Empower password. For example, enter:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readScript full_path_to_existing_script_file -masterPassword password

By default, you will see the installer run in wizard mode unless you are installing on
a headless system. If you are installing on a headless system, the installer will run in
console mode.

Important: If you created the script from Empower, the product releases referred to in
the script must be available on Empower or the script will fail. If you created
the script from an image, the image must be in the location it was in when
you created the script or the script will fail.

If you are installing on a system that has a monitor, and you want to display the output
on a console, specify the -console parameter. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readScript full_path_to_existing_script_file -console

If your company connects to the Internet through an HTTP or Socks proxy server, you
must use that proxy server to install. If you specified proxy information when you
created the script, the installer stored all seings except user name and password in
the script. If you want to override the stored seings, or if you did not specify proxy
information when you created the script, specify the appropriate parameters below.
To have the installer use an HTTP proxy server, specify these parameters on the
command:
-proxyHost host -proxyPort port -proxyUser user -proxyPass password

Using Software AG Installer Version 10.5 58

 M
Odd Header
Using Console Mode to Install

To have the installer use a Socks proxy server, specify these parameters on the
command:
-socksProxyHost host socksProxyPort port

For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-socksProxyHost host -socksProxyPort port
-readScript full_path_to_existing_script_file -console

Note: If you are installing on a Windows system and you logged in remotely, you
might experience problems with the Windows graphics subsystem. Try
adding -Djava.awt.headless=true as the first parameter on the command.
Only do this if you experience an actual problem; configuring the installer as a
headless application on Windows systems might trigger a known problem in
Java (see bug JDK-6607186).

After a script runs successfully, by default, the installer exits immediately. If you want
the installer to instead allow you to choose when to exit after the script completes,
specify the -scriptNoExit parameter at the end of the command.
If errors occur while a script is running, installation fails. By default, the installer shows
the errors and does not exit. If you want the installer to exit immediately with a non-
zero exit value, specify the -scriptErrorInteract no parameter at the end of the
command. If you want the installer to show the errors and pause for a specified number
of seconds before exiting, specify the -scriptErrorInteract number_of_seconds
parameter at the end of the command.

Generate Images for Multiple Operating Systems from an

Image Generation Script
To perform the tasks below, specify the indicated parameters before the -console
parameter on the command you run to start the installer. For the list of valid values for
operating_system , see “Create an Image” on page 54.

Create an Image Generation Script

To create an image generation script, specify the -writeImageScript and -
imagePlatform parameters on the command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-writeImageScript full_path_to_new_image_generation_script_file
-writeImage full_path_to_new_image_file
-imagePlatform operating_system -console

You can specify any file name for the image generation script that is permied by your
operating system. The directory to which you save the file must already exist. For
operating_system , specify the operating system that supports the greatest number of
products for which you want to generate images. For most products, that operating
system is Microsoft Windows 64-bit (W64).

Using Software AG Installer Version 10.5 59

 M
Even Header
Using Console Mode to Install

Generate Images
1. To generate an installation image from the image generation script, specify the -
readImageScript parameter on the command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readImageScript full_path_to_existing_image_generation_script_file
full_path_to_new_image_file -console

You can specify any file name for the image that is permied by your operating
system. Do not specify an extension; the installer will automatically add the
extension .zip. The directory to which you save the file must already exist.
By default, the installer generates the image for the operating system on which you
are running the installer. If you want to generate the image for another operating
system, specify the -imagePlatform parameter on the command. For example:
sh SoftwareAGInstalleryyyymm -operating_system .bin
-readImageScript full_path_to_existing_image_generation_script_file
full_path_to_new_image_file
-imagePlatform operating_system -console

Follow the usual image creation steps to select products and so on.
2. Repeat the previous step to create images for other operating systems.

Note: Generating these images requires no user input, so you can automate the
generation of these images if desired.

Important: Do not extract or modify image files using any tool other than the
installer.

Change Logging Options

You can change logging options by specifying logging-related parameters in front of the
-console parameter on the command you run to start the installer.

The following table lists the parameters you can specify to change logging options.

Parameter Variables

-debugLvl Amount of information to log. Valid values are as follows:

level
Amount of information to log Value

Fatal only fatal

Errors only error

Using Software AG Installer Version 10.5 60

 M
Odd Header
Using Console Mode to Install

Parameter Variables

Errors and warnings warning

Errors, warnings, and informational messages info

(default)

All; produces a 10 to 200MB file verbose

No information (that is, do not log any none

information)

-debugFile Full path to the file to contain the logging information. The
debug_file default is Software AG_directory/install/logs/installLog.txt.

-maxLogSize Maximum size of the file to contain the logging information,

numberm in megabytes. If the file reaches the specified size, the
installer begins writing a second file (installLog_part2.txt),
and then a third file (installLog_part3.txt), and so on, until
it writes ten files (installLog_part10.txt). It then overwrites
the first file, and then the second file, and so on. The default
maximum size for the log file is 250 MB.

-debugOut Writes logging information to standard out

as well as to file. This is not valid when using
SoftwareAGInstalleryyyymm.exe

-debugErr Writes logging information to standard error as well as to

file.

-debug level Shorthand way to specify-debugErr -debugLvl level.

Using Software AG Installer Version 10.5 61

 M
Even Header

Using Software AG Installer Version 10.5 62

 M
Odd Header
Uninstalling

5   Uninstalling
■ Overview ....................................................................................................................................... 64
■ Before You Begin ......................................................................................................................... 64
■ Start the Uninstaller ..................................................................................................................... 65
■ Uninstall Selected Products from Local or Remote Machine ...................................................... 65
■ Uninstall All Products from Local or Remote Machine with No User Input .................................. 66
■ Uninstall Using a Script ............................................................................................................... 67
■ Windows Usage Notes ................................................................................................................. 68

Using Software AG Installer Version 10.5 63

 M
Even Header
Uninstalling

Overview
This chapter explains how to uninstall products using the Software AG Uninstaller.
The chapter provides general instructions for uninstalling; your products might
require additional instructions. See your product installation guide for product-specific
instructions.

Before You Begin

1. Shut down all non-Software AG applications that are running on the machine
from which you are going to uninstall. If these applications are not shut down,
the uninstaller will not be able to remove key files that are locked by the operating
system.
2. You must shut down all Software AG products you are going to uninstall, as well as
all other Software AG products that are running in the same installation directory,
so the uninstaller can remove key files that are locked by the operating system. For
instructions, see the product documentation.
3. Log on to the machine as the same user that installed the products.
4. If you are going to uninstall from a Mac OS X or other UNIX system, and the
products to uninstall are 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. When you start the uninstaller GUI (see “Start the Uninstaller” on page 65),
start it in the same shell.
5. Uninstall as many fixes as possible from the products you are going to uninstall.
(Not all fixes can be uninstalled.) For instructions, see Using Software AG Update
Manager.
6. If you are going to uninstall all products from the target installation directory, the
uninstaller will delete all files from the Software AG_directory /install directory except
the logs and the installer-maintained history.txt file. If you want to keep files that
are stored in the Software AG_directory /install directory, move the files to a non-
Software AG directory.
7. Reboot your system.

Using Software AG Installer Version 10.5 64

 M
Odd Header
Uninstalling

8. The uninstaller does not delete files that were created after you installed your
products (for example, user-created or configuration files), nor in most cases does
it delete the directory structure that contains the files. You can delete these files and
directory structure after uninstallation is complete. If you are going to reinstall into
the same directory, you must delete the product directories after uninstallation is
complete or, if you want to save the files, move them.

Start the Uninstaller

The Software AG Uninstaller was automatically downloaded when you download the
Software AG Installer.
The following table explains how to start the Software AG Uninstaller on each
supported operating system.

System Mode Steps

Windows GUI Open the Add or Remove Program or Programs and

Features control panel (depending on your operating
system) and select the entry for the installation directory
that contains the products to uninstall (for example,
Software AG Products releaseinstallation_directory).

Mac OS X GUI Open a command window, go to the

or other Software AG_directory/bin directory for the installation
UNIX directory that contains the products uninstall, and run
the command uninstall.

Mac OS X Console Open a command window, go to the

or other Software AG_directory/bin directory for the installation
UNIX directory that contains the products to uninstall, and
run the command uninstall -console.

The uninstaller looks almost identical to the Software AG Installer. You can change the
same logging options that you can change in the installer.

Uninstall Selected Products from Local or Remote Machine

1. On the product selection tree, choose the products to uninstall.
If you choose a product that is required by other products, the uninstaller warns that
it will also uninstall those other products. If you do not want the uninstaller to do
this, deselect the product that is required by the other products.
2. Continue through the uninstaller until uninstallation is complete.

Using Software AG Installer Version 10.5 65

 M
Even Header
Uninstalling

Uninstall All Products from Local or Remote Machine with No

User Input
If you want to uninstall all products in the local or remote installation directory without
providing any user input (that is, silently), follow the instructions below.

Uninstall All Products Silently in GUI Mode

On the Welcome panel, click Advanced Options, and then click the Silent tab.

1. Click the Uninstall all products silently check box.

Using Software AG Installer Version 10.5 66

 M
Odd Header
Uninstalling

2. After all products are uninstalled successfully, by default, the uninstaller exits
immediately. If you want the uninstaller to instead display the Finish panel until you
choose to exit, select Display Finish panel.
3. If errors occur while products are being uninstalled, uninstallation fails. By default,
the uninstaller shows the errors and does not exit. You can choose instead to Exit
immediately or to Display error then exit after number_of_seconds seconds.

Uninstall All Products Silently in Console Mode

You can uninstall all products silently in console mode. Specify the -
readUninstallScript parameter on the command that you run to start the uninstaller,
as follows:
uninstall -readUninstallScript -console

After a script runs successfully, by default, the uninstaller exits immediately. If you want
the uninstaller to instead allow you to choose when to exit after the script completes,
specify the -scriptNoExit parameter at the end of the command.
If errors occur while a script is running, uninstallation fails. By default, the uninstaller
shows the errors and does not exit. If you want the uninstaller to exit immediately
with a non-zero exit value, specify the -scriptErrorInteract no parameter at the
end of the command. If you want the uninstaller to show the errors and pause for
a specified number of seconds before exiting, specify the -scriptErrorInteract
number_of_seconds parameter at the end of the command.

Uninstall Using a Script

Uninstall Using a Script in GUI Mode

On the Welcome panel, click Advanced Options, and then click the Scripts tab.
The steps you perform to create, edit, and uninstall using a script in GUI mode are
the same steps you perform to create, edit, and install using a script in GUI mode. For
instructions, see “Install from a Script Using the GUI” on page 43.

Uninstall Using a Script in Console Mode

To perform the tasks below, specify the indicated parameters on the command you run
to start the uninstaller.

Create a Script
To create an uninstallation script and uninstall products from the local machine,
specify the -writeUninstallScript parameter on the command. For example:
uninstall -writeUninstallScript full_path_to_new_script_file -console

Using Software AG Installer Version 10.5 67

 M
Even Header
Uninstalling

To create an uninstallation script without uninstalling products on the local machine,

specify the -editUninstallScript parameter on the command. For example:
uninstall -editUninstallScript full_path_to_new_script_file -console

To create an uninstallation script using an existing script as a template, specify the -

readUninstallScript and -writeUninstallScript parameters on the command.
For example:
uninstall -readUninstallScript full_path_to_existing_script_file
-writeUninstallScript full_path_to_new_script_file -console

Edit an Existing Script

To edit an existing uninstallation script, specify the -editUninstallScript parameter
on the command. For example:
uninstall -editUninstallScript full_path_to_existing_script_file -console

Uninstall Using a Script

If you want to uninstall using a script on a Windows system, download the installer for
UNIX as instructed by your installation email from Software AG, and install a 64-bit
JRE. For information on supported JDKs, see the product system requirements on the
Software AG Documentation website.
To uninstall on any system using an uninstallation script, specify the -
readUninstallScript parameter on the command. For example:
sh SoftwareAGInstalleryyyymm .bin
-readUninstallScript full_path_to_existing_script_file
-installDir full_path_to_installation_directory -console

After a script runs successfully, by default, the uninstaller exits immediately. If you want
the uninstaller to instead allow you to choose when to exit after the script completes,
specify the -scriptNoExit parameter at the end of the command.
If errors occur while a script is running, uninstallation fails. By default, the uninstaller
shows the errors and does not exit. If you want the uninstaller to exit immediately
with a non-zero exit value, specify the -scriptErrorInteract no parameter at the
end of the command. If you want the uninstaller to show the errors and pause for
a specified number of seconds before exiting, specify the -scriptErrorInteract
number_of_seconds parameter at the end of the command.

Windows Usage Notes

The Windows Add or Remove Program or Programs and Features control panel
(depending on your operating system) might continue to show the entry for the
installation directory that contained the products you uninstalled (for example,
Software AG Products releaseinstallation_directory) for a few minutes after uninstallation
while it performs post-installation cleanup.

Using Software AG Installer Version 10.5 68

 M
Odd Header
Uninstalling

If you uninstalled from a Windows Vista, 2008, or 7 system, you might see a Program
Compatibility Assistant dialog box that says This program might not have
uninstalled correctly. Select the option This program uninstalled correctly.

Using Software AG Installer Version 10.5 69