[frs-266] Upgrade procedure for FusionReactor bundled with Railo


This Technote will describe the steps required to upgrade a Railo bundled FusionReactor 3.x installation to FusionReactor 4.x
The procedure required to upgrade is to manually remove the FusionReactor instance installed on the Railo Server, install FusionReactor 4.x including FRAM and to install FusionReactor into the Railo server again using FRAM's Instance Manager.

The following example has been developed for the Windows operating system, using Railo Server with Tomcat 3.2.3.000, and assumes the Railo Server has been installed in the default location of C:railo.

Uninstallation Procedure

  • Navigate to the directory where Railo is installed and shut Railo down. Stop Tomcat using shutdown.bat which by default, is located within C:railotomcatbin)
  • Once the server has been shutdown, navigate to C:railotomcatconf and open up the web.xml file. Remove the <filter> and <filter-mapping> which contains the FusionReactor filter definitions. For example:
    <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>
    
  • Delete the fusionreactor.jar from C:railotomcatlib.
  • Delete the whole fusionreactor folder located C:railo

Installation Procedure

  • If the initial server scan doesn't start, you can add the Railo Server manually. At the top of the Instance Manager, type C:railotomcat in the 'Server Root Directory' input box, and change the server type to Apache Tomcat. Click 'Add Server" to add it to the Instance Manager. You can then add FusionReactor to the instance by clicking Add Instance and following the guide.

Issue Details

Type: Technote
Issue Number: FRS-266
Components: Installer
Environment:
Resolution: Fixed
Last Updated: 30/Aug/11 3:54 PM
Affects Version:
Fixed Version: 4.0.0
Server: Railo
Platform:
Related Issues: