[FRS-417] Update FusionReactor and an application server to a newer version


Introduction

This technote will provide readers with more information about the FusionReactor migration process alongside with the necessary steps readers might need to follow in order to achieve it. This technote is divided in 3 categories. The first will provide more information about the FusionReactor license migration, the second will provide more information about the automated installation process while the third will provide more information about manual installation process.
Let's begin.

License Migration

If you want to migrate FusionReactor to a new server with a different IP address, then you need to make sure the ALL the FusionReactor instances used in the old server have been successfully disabled.
If you are using FRAM for installing your FusionReactor instances, please make sure that the FRAM instance has been disabled as well.

FusionReactor instance – License deactivation
In order to disable the license key of a FusionReactor instance, follow the steps described below.

  1. Access the FusionReactor instance.
  2. Navigate to the About page.
  3. Press the "Deactivate License" button.
  4. Make sure that the license has been successfully deactivated. If the license has been deactivated then you will be able to see the follow message in the About page,

FRAM instance – License deactivation

  1. Access the FRAM instance via a browser. Usually, the FRAM instance can be found on port 8087 (default configuration port).
  2. Navigate to the About page.
  3. Press the "Deactivate License" button.
  4. Make sure that the license key has been successfully deactivated.

Migrate Configuration Files

If you want to migrate the configuration files of FusionReactor to a new server, the steps described below will guide you through that process. Additionally, for this example we are going to update a ColdFusion server from 10 to 11.
Keep in mind that the steps described below can be applied to other application servers.

FRAM Use

  1. Navigate to the ColdFusion 10 FusionReactor installation directory. This can be found by navigating to <FusionReactor installation directory>/instance/<instance name>.
  2. Copy the cmconfig directory and the conf directory into a temporary directory.
  3. Run your FusionReactor 6 installer, this will upgrade the current FRAM installation to the latest version.
  4. Stop the ColdFusion 10 instance.
  5. Install a ColdFusion 11 instance via the instance manager.
  6. Navigate to the ColdFusion 11 FusionReactor installation directory.
  7. Remove the conf and cmconfig directories.
  8. Copy and paste your conf and cmconfig from the temporary directory.
  9. Open the reactor.conf file with a text editor of your preference and remove the fruid and gruid lines (if any).
  10. Remove your ODLComponent.config file from cmconfig. This can be found here; <FusionReactor installation directory>/instance/<instance name>/cmconfig/com/intergral/fusionreactor/plugin/internal
  11. Restart your ColdFusion 11 Fusion Reactor instance.

If the configuration files have been transferred successfully, you can now remove the ColdFusion 10 instance via the Instance Manager.

For more information, please check out the following links.

Manual Installation

  1. Navigate to the FusionReactor instance installation directory. By default, the directory can be found here, <FusionReactor Installation Directory>/instance/<Instance Name>.
  2. Copy and paste the cmconfig and conf directories in the following directory of the NEW server:<FusionReactor Installation Directory>/instance/<Instance Name>.
  3. Install the ColdFusion 11 application server in the New server.
  4. Install FusionReactor in the ColdFusion 11 server. This can be achieved by placing the -javaagent argument in the JVM arguments file of the application server. The -javaagent argument will look similar to the following: "-javaagent:<DIRECTORY-PATH>FusionReactorinstance<INSTANCE-NAME>fusionreactor.jar=address=<PORT>".
  5. Navigate to the directory of the NEW server: <FusionReactor Installation Directory>/instance/<Instance Name>.
  6. Access the conf directory and open the reactor.conf file with a text editor of your preference.
  7. Remove the fruid and gruid lines (if any).
  8. Remove your ODLComponent.config file from the cmconfig directory. This can be found in the following directory; <FusionReactor installation directory>/instance/<instance name>/cmconfig/com/intergral/fusionreactor/plugin/internal
  9. Start the ColdFusion 11 application server.

If the configuration files have been transferred successfully, you will be able to find all the FusionReactor settings in the ColdFusion 11 instance.

If you are using an Ultimate license key, you should add the Production Debug library in the JVM arguments file of your application server. More information can be found here, http://docs.intergral.com/display/FR62/FusionReactor+Production+Debugger+Installation

More information about the process described above, can be found in the link below.

If you have any difficulties, please feel free to get in touch with the FusionReactor Support Team on support@fusion-reactor.com

Issue Details

Type: Technote
Issue Number: FRS-417
Components: Installer, Instance Manager, License + Activation
Environment:
Resolution: Fixed
Last Updated: Monday 1:34 PM
Affects Version:
Fixed Version: 6.2.6
Server:
Platform:
Related Issues: