Running the Software AG Installer

This topic provides just a brief description on how to install Apama directly on the target machine using the Software AG Installer GUI. For detailed information on the Software AG Installer, see Using the Software AG Installer.

When downloading the Software AG Installer from Empower, we recommend using the .exe file on Windows and the .jar file on UNIX.

On Windows, you have to run the installer as an administrator. When you start the .exe file from any administrative account, this will happen automatically, even if the user account control (UAC) is enabled. However, when you start the installer from the .jar file (rather than from the .exe file), you have to explicitly use Run as administrator to get a successful installation.

On UNIX, you have to run java -jar software-ag-installer-jar-filename. Root privileges are not required, but you must have permission to write to the installation directory that you are going to specify in the installer.

You can leave most installation options at their default values. See Using the Software AG Installer for more details, if desired.

Important:

When specifying the installation directory, make sure that the directory name has only 7-bit ASCII (English) characters. On Windows, not all Software AG products support to install into a directory that has spaces in its name (such as C:\Program Files). Apama, however, is one of the products that does support spaces in the directory name.

2. When the first page of the Software AG Installer GUI (the so-called Welcome panel) is shown, click the Next button repeatedly (and specify all required information on the shown panels as described in Using the Software AG Installer) until the panel containing the product selection tree appears. This tree lists the products you have licensed and which can be installed on the operating system of the machine on which you are installing.

The product selection tree provides the following nodes for installing Apama:

ii. Dashboard Viewer. The viewer tool that allows you to view and interact with dashboards that are receiving live data from an Apama Dashboard Server.

iii. Platform Manager Plug-in. A plug-in that allows you to manage the server components of Apama using Command Central.

Designer > Apama. This node allows you to install the Apama Development Environment, which provides graphical tooling for creating Apama applications using the Software AG Designer (based on Eclipse).

Note:

On UNIX, Server and Platform Manager Plug-in are the only installation options. All other options listed here are only available on Windows.

The full set of Apama documentation will always be installed, no matter which Apama options you select.

3. To quickly select all Apama components (that is, the full functionality of Apama), click Typical Installations, select Apama and click OK.

6. Read the license agreement, select the check box to agree to the terms of the license agreement, and click Next.

Note:

If you are installing other products together with Apama, several panels may appear that are not explained in this documentation. See the documentation for these products for more information.

7. A panel appears on which you can specify a different location for the Apama work directory. Apama uses the work directory to write log files, and to store the license file and any other user-writeable files. Non-English characters can be used in the work directory location, but they must be within the set of characters from the operating system's default character encoding.

It is recommended that you specify an empty directory or a directory that does not yet exist as the Apama work directory. If you specify a directory that does not yet exist, it will be created by the installer. The installer populates the work directory with some standard files and directories. The installer will also accept a non-empty directory that already exists (for example, a work directory from a previous installation), but will not write anything to it in this case. This ensures that important user content will not be overwritten.

When you have selected Apama > Server in the product selection tree, you can also specify the path to your Apama license file (see also the information on the license file in About the Apama installation process).

9. On the last panel, review the list of products you have selected for installation. If the list is correct, click Next to start the installation process.