FusionReactor on WebLogic 9.2

FusionReactor on WebLogic 9.2

Overview

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

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.

Installation

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

Follow the instructions in

http://livedocs.adobe.com/coldfusion/8/htmldocs/help.html?content=installj2ee_13.html

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.

To install FusionReactor into the ColdFusion web application download the package suitable to do a manual installation from

http://www.fusion-reactor.com/fr/downloads.cfm

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

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

on this machine.

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