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.
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 installing 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.
To install Apama
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.
The product selection tree includes the following nodes for installing Apama:
Apama. For the main Apama product, this node allows you to install the following Apama components:
1. Server. The server components of Apama, including the correlator and associated command line tools.
2. Cumulocity IoT Integration. Integration with the Cumulocity IoT platform.
3. Dashboard Viewer. The viewer tool that allows you to view and interact with dashboards that are receiving live data from an Apama dashboard server.
4. Dashboard Servers. The Apama dashboard servers and command line tools.
5. IAF & Adapters. The Apama standalone adapter framework and associated adapters.
6. Platform Manager Plug-in. A plug-in that allows you to manage the server components of Apama using Software AG Command Central.
Note:
Command Central integration is deprecated and will be removed in a later release. For installation of Apama, it is recommended to use the Software AG Installer instead.
7. Software AG Suite Integration. Integration with other products in the Software AG suite and JMS.
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:
Designer > Apama > Apama Application Development and Apama > Dashboard Viewer are only available on Windows. All other components listed above are available on both Windows and UNIX.
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 and Apama Dashboard Shared Files. They are automatically selected when you select some of the above-mentioned components. They 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 all of the components listed above with the exception of the deprecated Platform Manager Plug-in. If licensed, this also includes Capital Markets Foundation in the Apama node and Capital Markets Application Development in the Designer > Apama node. Apama components that are not included in the typical installation can be manually selected using the product selection tree if required.
The full set of Apama documentation will always be installed, no matter which Apama options you select.
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
License file).
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 Install to start the installation process.