wiki:Software/Install/Normal
Last modified 6 years ago Last modified on 12/18/11 04:25:37

Install Raptor in the Recommended Normal Setup

The recommended, normal, setup of Raptor involves:

  1. Installing the Raptor Server components (the MUA and the Web interface) on one server
  2. Installing the Raptor ICA on each server you wish to monitor.
  3. Configuring each ICA and the MUA to communicate.

0. Prerequisites

0.1 Software

The only thing needed on a server hosting any of the raptor components is a Java 1.6 JRE. If using the linux packages, the RPMs should install a suitable JRE for you.

0.2 Hardware

To run the server packages (MUA/Web), you need 1G of RAM free and at least 100MB free disk space to install (and more like a few gig for log files and the database).


1. Installing

1.1 Installing the Server Components

The first step is to install both the MUA and Web packages on a single server as a single package:

1.2 Installing the ICA

The next step is to install the ICA package on each service you wish to monitor:


2. Configuring

2.1 Configuring each component

Note that future versions of the Raptor installer will do most of this for you - but for now there are some manual configuration steps that you must perform.

Follow these instructions:

  1. Configure the ICA.
  2. Configure the MUA.
  3. Configure RaptorWeb.

2.2 Configuration components to communiciate

2.2.1 The ICA and the MUA

Now that you have the server components (MUA/Web) installed on one server, and the ICA on another, they must be configured to communicate with each other.

2.2.2 The MUA and the Web Interface

As you are using the combined -server package, this has already been done automatically.

2.3 Firewalls

  • The ICA listens on TCP port :8110 - but currently nothing interacts with it (it sends information only) so this port can be left closed.
  • The MUA listens on TCP port :8111. This needs to be opened so that all ICAs and Web can send to this port.
  • RaptorWeb listens on TCP port :8112. This needs to be opened to all machines that you wish to be able to interact with the web interface.

3. Start all daemons/service

Now that all components are installed and configured, they are ready to start.

  1. First, start the Raptor MUA and Raptor Web. This will usually involve the following:
    • On Linux (as root):
      # service raptormuad start
      # service raptorwebd start
      
    • On Windows
      • Open the Services window and start the Raptor MUA and Web services.
  1. Next, start the Raptor ICA on each server that it has been installed on. This will usually involve the following:
    • On Linux (as root):
      # service raptoricad start
      
    • On Windows
      • Open the Services window and start the Raptor ICA service.

4. Enjoy!

The raptor web interface should now be available on the server that you installed RaptorWeb onto. For example, if you installed it to raptor.example.com, you would open a web browser and navigate to http://raptor.example.com:8112/.

For more information on what to do next and how to use Raptor, check out the user's guide.

If you encounter any problems, check out the Raptor Support pages.