FRS-252

Introduction

The normal method for installing FusionReactor into a J2EE container is to use the FusionReactor Administration Manager's Instance Manager. This page, located in Instances -> Instance Manager, allows you to easily administer all instances present on a single machine.

If FusionReactor doesn't detect your instance, you may have to install it manually. There are some caveats to this process:

The instance will not be displayed within the Instance Manager.

You won't be able to use the IM to administer it. Internal webserver port, IP address and the "Bind to all interfaces" flag will only be changed by editing the fram.conf file (more on that later).

The instance will be unable to use the FusionReactor Administration Manager to offload the zipping of logfiles, or the shipping of logfiles to FusionAnalytics.

Procedure

This procedure has been developed for Unix-type operating systems, including Linux. FusionReactor may be installed manually on windows, by changing the corresponding paths. A Windows-specific template configuration is available, and this is noted later in this procedure.

Prerequisites

The following list outlines the prerequisites which must be fulfilled prior to beginning this procedure.

The target J2EE container must be installed and running.

If you have previously installed FusionReactor 3.x manually, this must be uninstalled.

The FusionReactor filter definition, which is inserted usually in a web.xml (or default-web.xml) must be removed.

You should know in which file your J2EE server defines its servlets and filters. You'll need to know this in order to add the FusionReactor filter later.

This will give a clean environment in which FR4 can be installed.

Installing FusionReactor Administration Manager

The FusionReactor Administration Manager, or FRAM, is a cut-down version of FusionReactor which runs inside its own server, and provides administrative and monitoring functionality for other FusionReactor instances.

Although, as a manual install, you won't be able to take advantage of these functions, FRAM does contain an instance template which you can use to create a manually-installed instance.

Unix users who do not have X-Windows or another GUI available to them can run the FusionReactor 4 installer in command-line mode. Simply start it with ./FusionReactor_linux_4_0_0.sh -c

Unix users with a GUI available, and Windows users, can proceed through the graphical install wizard.

After the wizard completes, and assuming default answers, the FusionReactor Administration Manager will be installed into /opt/fusionreactor (c:FusionReactor on Windows).

It is not strictly necessary to start FRAM, but if you wish to do so, it can be started using the shell script (/opt/fusionreactor/tomcat/bin/framd start), or by starting the FusionReactor AM service on Windows. If you picked the default port, the service will be available in your browser at http://localhost:8087/.

Installing a Manual Instance

FusionReactor Administration Manager includes a template instance which you can customize. The four main steps are: