This chapter provides information and instructions for installing a Server version of Apama Release
5.0 on Solaris and Linux systems.You can download the installation package from the Apama
Electronic Software Distribution (ESD) site.
The installation logs for the Apama Server installation can be found in the Apama installation's logs directory. If you accepted the default installation location, the path is something like this:
For details, see the following topics:
• Installation prerequisites on Solaris and Linux
• Linux platform notes
• Apama 5.0 installation procedure on Solaris and Linux
• Post-installation steps on Solaris and Linux
• What was installed on Solaris and Linux
• Uninstalling Apama on Solaris and Linux
To be able to install Apama on your system, you must have local Administrator privileges.
If you have an earlier release of Apama on your system it is highly recommended that you uninstall
the previous version and then install Apama 5.0. In all cases, you cannot have two installed versions
of the Apama Management & Monitoring Agent service (also called the Sentinel Agent) running
concurrently without changing default port settings.
An Apama installation on Solaris or Linux must satisfy the following requirement:
• 500MB free disk space.
• The Apama Dashboard Server port (default 3278) must be accessible by Dashboard Viewer.
If you are using Solaris or Linux with the firewall enabled, you need to unblock network access
for this port.
• If you are deploying Java applications, when you start the correlator and specify the -j option,
the correlator starts a Java Virtual Machine. It uses the first JRE/JDK in the PATH environment
variable. It is highly recommended that you use JRE 7.0 update 5, which is the version that
Apama ships with.
Web clients can access Apama dashboards through any Apama host supported web browser. No
Apama installation is required for web clients but they must satisfy the following requirements:
• Oracle's(Sun's) Java plug-in (version 1.7.0_5 or later) must be installed for dashboards deployed
either as applets or through Java Web Start technology. There is no Java plug-in requirement
for dashboards deployed with the Apama Dashboard Display Server.
• Your browser must have cookies enabled for web pages served from the host where you are
running your application server.
• If you have a pop-up blocker, be sure to set it to allow popups for web pages served from the
host where you are running your application server.
efore installing Apama 5.0 on Linux, consider the following:
• No support for Security Enhanced Linux on page 32
• Linux development and samples on page 32
• Linux and Solaris root permissions on page 33
Apama does not support Security Enhanced Linux (SELinux). This option should be turned off on
Linux for Apama to run.
To build the samples and develop applications using the C/C++ API, development tools that are
not present in the default installation of the supported platforms must be installed. On all supported
Linux platforms the GCC-C++ package and all its dependencies must be installed. These are all
provided on the installation media provided with the distribution.
On all UNIX platforms if Apama is installed by the root user then the resulting ApamaWork_5.0
directory will also be owned by root.This can cause problems for non-root users who run Apama
tools; they may not be able to write to ApamaWork_5.0.To support non-root users in installations
owned by root do one of the following:
• Change the permissions or owner of ApamaWork_5.0 and its subdirectories to allow write
access by users.
• Define the environment variable APAMA_WORK and set its value to an ApamaWork_5.0 directory
the users have write access to.
To install the Server version of Apama 5.0 on Solaris or Linux, you can run the installation program
either in an X Windows environment or in console mode.The X server does not need to be running
on the same host as the installation program; remote X connections are fully supported. For a
remote installation, check that the DISPLAY environment variable is set appropriately before starting
It is recommended that, for administration purposes, you create a separate user (for example,
apama) for installing and running Apama components.
There are two installation options on Solaris and Linux:
• Performing an Apama 5.0 GUI installation on page 33
• Performing an Apama 5.0 console installation on page 37
To perform a GUI installation of Apama Release 5.0 on Solaris or Linux machines:
1. If you intend the software to be used by a specific dedicated user account, such as apama,
login as this user.
2. Use gunzip to uncompress the archive file.
3. Unpack the archive file to some temporary directory. Be sure to preserve directory names and
structure. For example:
tar -xf PROGRESS_APAMA.tar .
4. Run ./install.bin from the solaris or linux directory within the temporary directory.
You can remove the temporary directory after installation is complete.
5. Click Next to proceed with the Installation Wizard.
6. You must accept the terms of the license agreement before you can install. Click Next.
7. Accept the default locations for installing Apama and for Apama's workspace or specify different locations. The user account performing the installation must have permission to write to the specified directories. Click Next.
8. Confirm that you want to install the Apama Server set including the correlator, dashboard servers, and other management tools. Then click Next
If the installation script cannot install the Apama service, it displays a message to indicate this and also displays the name of the script to run after installation. If necessary, make a note of this script, and run it after installation to add the Apama service.
9. Review the pre-installation summary (click Previous to make any changes). Then click Install to complete the installation.
10. The installation wizard shows the progress of the installation.
The progress bar does not necessarily reflect actual installation progress. The bar might not move for several minutes, but the installation is progressing.
11. When the installation is complete, click Next
If the installation script detected a license file when it started the installation, it displays instructions for where to store the Apama license file. Be sure to follow these instructions.
To perform a console installation of the Server version of Apama Release 5.0 on Solaris or Linux
- If you intend the software to be used by a specific dedicated user account, such as apama, log
in as this user.
- Use gunzip to uncompress the archive file.
- Unpack the archive file to some temporary directory. Be sure to preserve directory names and
structure. For example:
tar -xf PROGRESS_APAMA.tar
- Run ./install.bin -i console from the solaris or linux directory within the temporary
directory. (You can remove the temporary directory once the installation is complete.)
This starts the Apama installation. Press Enter to continue.
- You must accept the terms of the license agreement before you can install Apama.You can
scroll and read through the entire agreement or you can skip to the end where you can indicate
that you agree.
At the appropriate prompt, after scrolling through the license information or skipping to the end,
- Accept the default location or specify a different location for installing Apama.
- Accept the default location or specify a different location for the Apama work directory.
- Enter 1 to specify that you want to install the Server install set.
If you do not have permission to install the Apama service, the installation script displays a
message to let you know. It also indicates that you can run the
Progress/Apama_5.0/bin/apama_services script after installation to add the services.
- Review the pre-installation summary and press Enter to continue the installation.
- The installation is complete. Press Enter.
- The installation script provides information about where to put your Apama license file. Be sure
to follow these instructions. Press Enter to exit the installer.
After installation, there are a few simple steps you must follow.The following topics describe these
After installation, copy your Apama license file to the license directory in your Apama work
After installation, source the apama_env file, which is in the bin directory of your Apama installation
During installation, the installer starts the Apama Management & Monitoring Agent service if it can.
The Apama Sonic Integration Service provides a way to send Apama events and Sonic XQMessages
Before you uninstall Apama, ensure that all Apama components and applications are no longer