linux上安装apama Installation on Solaris and Linux

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:
/opt/Progress/Apama_5.0/install/Apama_5.0.0.0/logs
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

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

Linux platform notes

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

No support for Security Enhanced Linux

Apama does not support Security Enhanced Linux (SELinux). This option should be turned off on
Linux for Apama to run.

Linux development and samples

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.

Linux and Solaris root permissions

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.

Apama 5.0 installation procedure on Solaris and Linux

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

Performing an Apama 5.0 GUI installation

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.

Performing an Apama 5.0 console installation

To perform a console installation of the Server version 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, log
    in 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 -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.
  5. 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,
    enter Y.
  6. Accept the default location or specify a different location for installing Apama.
  7. Accept the default location or specify a different location for the Apama work directory.
  8. 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.
  9. Review the pre-installation summary and press Enter to continue the installation.
  10. The installation is complete. Press Enter.
  11. 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.

Post-installation steps on Solaris and Linux

1
2
3
4
5
6
After installation, there are a few simple steps you must follow.The following topics describe these
steps:
• Copy the license file on page 42
• Set up the environment on page 42
• Start the Apama service if needed on page 42
• Set up Apama Sonic Integration Service on page 42

Copy the license file

1
2
3
4
5
6
After installation, copy your Apama license file to the license directory in your Apama work
directory. If you accepted the default Apama work directory location then the path for your license
file will be something like the following, where ~ indicates your home directory:
~/Progress/ApamaWork_5.0/license/license.txt
For details about Apama behavior when a license file expires, see Overview of Installing Apama
on page 11.

Set up the environment

1
2
3
4
5
6
After installation, source the apama_env file, which is in the bin directory of your Apama installation
directory. This script sets up the Apama environment, including setting the following environment
variables:
• APAMA_HOME
• APAMA_WORK
• APAMA_JRE

Start the Apama service if needed

1
2
3
4
5
6
7
8
9
10
During installation, the installer starts the Apama Management & Monitoring Agent service if it can.
If you need to start or restart this service, do one of the following:
• Run the apama_services file, which is in the bin directory of your Apama installation directory.
You can use this script to do the following:
• Add the service if you did not add it during installation
• Start and stop the service
• Perform other service management operations
Usage information is in the file.
• Run the executable for the service. If you installed Apama in the default location, the path for
the executable is /opt/Progress/Apama_5.0/bin/sentinel_agent.

Set up Apama Sonic Integration Service

1
2
3
4
The Apama Sonic Integration Service provides a way to send Apama events and Sonic XQMessages
back and forth between Apama applications and the Sonic ESB. For information about setting up
this service, see "The Apama Sonic integration service" in Deploying and Managing Apama
Applications.

Uninstalling Apama on Solaris and Linux

1
2
3
4
5
6
7
8
Before you uninstall Apama, ensure that all Apama components and applications are no longer
running.
To uninstall Apama:
1. Run the uninstall_apama_5.0 utility, located in the Apama’s uninstall directory. The
default location is /opt/Progress/Apama_5.0/uninstall.
2. The uninstall wizard opens.
3. Click Uninstall. The uninstall process proceeds.
4. After the uninstall process is complete, delete the Apama installation directory.