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 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. Running the Installer with root privileges is not supported, 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 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.

1. Start the Software AG Installer GUI as described in Using Software AG Installer.

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 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.

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 Software AG Command Central.

Designer > Apama. For the main Apama product, this node allows you to install the Apama Application Development component, which provides graphical tooling for creating Apama applications using Software AG Designer (based on Eclipse).

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

Additional entries may be shown in the above nodes. These pertain to components that are not covered in this documentation. See the documentation for these components for more information.

The Infrastructure node contains Apama Shared Files. This is automatically selected whenever you select any of the above-mentioned components. It will be needed when installing Apama fixes.

3. To quickly select all components of the main Apama product, click Typical Installations, select Apama and click OK. This includes Server and, if running on Windows, also Dashboard Viewer and Apama Application Development. If licensed, this also includes Capital Markets Foundation in the Apama node and Capital Markets Application Development in the Designer > Apama node. Other Apama components such as Platform Manager Plug-in are not included in the typical installation and can be manually selected using the product selection tree if required.

4. Click Next to continue.

5. If the Languages panel is shown, click Next again as this has no affect on an Apama installation.

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).

8. Click Next to proceed to the next panel.

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.