[frs-87] How do I install FusionReactor on a J2EE ColdFusion MX 7 installation deployed to the examples domain of WebLogic 8.1 on a UNIX platform?


The following procedure describes how to install FusionReactor on a J2EE ColdFusion MX 7 installation deployed to the examples domain of WebLogic 8.1 on a UNIX platform. In this setup FusionReactor will be added as a Servlet filter to the ColdFusion web application, i.e. FusionReactor will track only request belonging to ColdFusion.

The following assumes that WebLogic is installed in /opt/bea/weblogic81, and the (unpacked) ColdFusion enterprise application module resides in /opt/bea/weblogic81/samples/domains/examples/applications/cfusion-ear with the web module cfusion-war inside.

To install FusionReactor in this environment you have to

  1. Download the generic install and unpack it to /opt. This creates the directory /opt/fusionreactor.
  2. Open the CFMX web descriptor /opt/bea/weblogic81/samples/domains/examples/applications/cfusion-ear/cfusion-war/WEB-INF/web.xml and add the FusionReactor servlet filter definition:
    <filter>
      <filter-name>FusionReactor</filter-name>
      <filter-class>
        com.intergral.fusionreactor.filter.FusionReactorFilter
      </filter-class>
      <init-param>
        <param-name>config</param-name>
        <param-value>
          /opt/fusionreactor/instance/default/conf/reactor.conf
        </param-value>
       </init-param>
    </filter>
    <filter-mapping>
      <filter-name>FusionReactor</filter-name>
      <url-pattern>/*</url-pattern>
    </filter-mapping>

    as the first servlet filter at the top of the document (e.g. before the first <context-param> element.

  3. Copy /opt/fusionreactor/etc/lib/fusionreactor.jar to /opt/bea/weblogic81/samples/domains/examples/applications/cfusion-ear/cfusion-war/WEB-INF/lib
  4. Copy /opt/fusionreactor/etc/lib/libFusionReactor.so to /opt/bea/weblogic81/server/bin
  5. Restart the WebLogic examples server and open http://localhost:8088 in a browser on this machine to access FusionReactor.

The initial password is the empty string.

NOTE: If you use different paths as in the procedure above you have to take care that you also use them in the servlet filter definition and the configuration file reactor.conf.

Issue Details

Type: Technote
Issue Number: FRS-87
Components: Installer
Environment:
Resolution: Fixed
Last Updated: 23/Aug/07 12:39 PM
Affects Version: 2.0
Fixed Version: 2.0
Server: WebLogic
Platform: Linux
Related Issues: