FusionReactor on WebLogic 9.2

Overview

Customers often ask if FusionReactor can be used with BEA Weblogic Servers.

FusionReactor is implemented as a J2EE Servlet filter i.e. it can be installed as a stand alone web application or added to an already deployed J2EE web application. On many application servers (e.g. JRun, Tomcat, Jetty, etc.) it can be installed as a global Servlet Filter which is applied to all web applications. However, with BEA Weblogic and IBM WebSphere this is not supported, i.e. FusionReactor cannot be installed as a global Servlet filter but has to be added per web application.

This document describes how to install Coldfusion 8 (as an example web application) and FusionReactor on the BEA Weblogic 9.2 server running on Windows.

Installation

The following assumes that the Weblogic server resides in directory C:\bea\weblogic92.

ColdFusion

Follow these instructions to install ColdFusion as a J2EE web application on the Weblogic server. In this example we have used the ColdFusion8 Setup to create a web application (cfusion.war) and unpacked it to the directory c:\cfusion.

FusionReactor

To install FusionReactor into the ColdFusion web application download the package suitable to do a manual installation and unpack it to your computer. In this example we have unpacked the archive to C:\FusionReactor

Copying files

Next copy the fusionreactor.jar file from

to directory

If you want to use the FusionReactor JDBC wrapper copy the JDBC driver JAR file suitable for your database (e.g. jtds-1.2.2.jar for the jTDS MSSQL driver) to this directory.

The drivers in file macromedia_drivers.jar, delivered with ColdFusion, cannot be used outside the ColdFusion server! You have to use a different JDBC driver in case.

Copy FusionReactors native library from

to directory

The native library currently does not support the JVM BEA Systems, Inc., Version 1.5. If you use this JVM CPU monitoring will not be available in FusionReactor. In such a case you can see a message in the FusionReactor log similiar to the following

Now use an editor to open the ColdFusion web descriptor located in

and add the FusionReactor Servlet filter definition as the first filter as shown below:

FusionReactor can monitor any type of J2EE server. ColdFusion runs on a J2EE server meaning that you can monitor your ColdFusion application with Nagios using FusionReactor and this plugin.

You can also monitor your Railo server with Nagios or OpenBD (Open BlueDragon) using this Nagios plugin.

Editing the web descriptor

Now use an editor to open the ColdFusion web descriptor located in

and add the FusionReactor Servlet filter definition as the first filter as shown below:

      
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE web-app PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN" "http://java.sun.com/dtd/web-app_2_3.dtd">
<web-app id="adobe_coldfusion">
    <display-name>Adobe ColdFusion 8</display-name>
    <description>Adobe ColdFusion 8</description>

    <!-- FusionReactor Servlet filter configuration -->
    <filter>
        <filter-name>FusionReactor</filter-name>
        <filter-class>com.intergral.fusionreactor.filter.FusionReactorFilter</filter-class>
        <init-param>
            <param-name>config</param-name>
            <param-value>C:/FusionReactor/instance/default/conf/reactor.conf</param-value>
        </init-param>
    </filter>
    <filter-mapping>
        <filter-name>FusionReactor</filter-name>
        <url-pattern>/*</url-pattern>
    </filter-mapping>

    <context-param id="coldfusion_context_1">
        <param-name>cftags</param-name>
        <param-value>/WEB-INF/cftags</param-value>
        <description>Path to search for built-in tags. Relative to application root.
            This parameter can only be one path element.</description>
    </context-param>
    ... 
        
        

Starting FusionReactor

Finally restart the Weblogic server and open the FusionReactor administration page listening on port 8088 by pointing you browser to http://localhost:8088/fusionreactor on this machine.

Please goto http://www.fusion-reactor.com/fr/support.cfm#doc for more documentation about FusionReactor.