[frs-311] Hotfix FR-3269: Slow Startup in Performance-Limited Environments


Hotfix 3269 for FusionReactor 4.5.5 – Description

This technote supplies a hotfix to fix an issue whereby FusionReactor (both FRAM and installed instances) is slow to start up on processor-limited systems.

Symptoms

On performance-limited systems where CPU cycles are strictly rationed, FusionReactor's Administration Manager (FRAM) and installed instances appear to start very slowly.

Analysis

Two threads which participate in the startup of FusionReactor can in some circumstances begin to compete for CPU resources, if the first thread takes longer than normal to complete.

This occurs commonly in processor-limited environments, Amazon EC2 m1.small or t1.micro instances, for example.

We have confirmed this is not a deadlock – FusionReactor does complete the startup procedure, though this can be radically longer than usual.

Resolution and Instructions For Applying Hotfix

We have confirmed this as a bug, and are supplying a hotfix for customers experiencing this issue.

Instructions.

The hotfix should applied only to FusionReactor 4.5.5. Please update if necessary.

  1. Stop FRAM
    • On Unix, this is done using /etc/init.d/framd stop
    • On Windows, this is done using the Services control panel, by stopping the FusionReactor AM Service.
  2. Stop all J2EE containers into which FusionReactor has been installed.
  3. For each instance in the FusionReactorinstance<INSTANCE> folder (including FRAM):
    • Within the instance folder, locate the osgienvsys folder.
    • This folder will contain a fr-osgi-frameworkhost-1.0.1.jar file. Delete this file.
    • Copy the attached fr-osgi-frameworkhost-1.0.2.jar into this folder.
  4. Perform the same procedure for the instance template, which can be found in FusionReactoretcosgi-templateosgienvsys
    • This folder will contain a fr-osgi-frameworkhost-1.0.1.jar file. Delete this file.
    • Copy the attached fr-osgi-frameworkhost-1.0.2.jar into this folder.
  5. Restart FRAM. It should be available within a few seconds.
  6. Restart instances.
Cumulative Hotfixes

Hotfixes are cumulative: any future hotfixes on the FusionReactor 4.5.x stream, up to but not including the next minor point release (4.5.6), will contain this hotfix (and all earlier hotfixes since the last point release).

We may decide, at our discretion, to release a full suite of installers on the 4.5.x maintenance stream at some future point. This will also incorporate hotfixes whose version numbers are the same or less than that of the installer. This means that this hotfix will be included in a potential future installer whose version is 4.5.6 or greater.

Included Hotfixes

  • None.

Files

fr-osgi-frameworkhost-1.0.2.jar

Taxonomy

This hotfix does not change the master version number (4.5.5) of the software.

~Hotfix FR3269

Issue Details

Type: Technote
Issue Number: FRS-311
Components: Plugins + OSGi
Environment:
Resolution: Fixed
Last Updated: 21/Aug/14 6:03 PM
Affects Version:
Fixed Version: Pending
Server:
Platform:
Related Issues: