[frs-288] Windows: Changing the user of a FusionReactor installation

During installation, the FusionReactor Administration Manager is installed as the Administrators group, and the FusionReactor AM Service is installed to log on as the Local System account

If you have changed the user under which your J2EE container runs, we recommend changing FusionReactor to be owned by, and run as, the same user as your J2EE container. This is because the component installed into your J2EE container and FusionReactor itself will need to share files.

You may need to change the runtime user of FRAM/FusionReactor if:

  • Your J2EE container is not owned by the Administrators group and/or runs as a user other than the Local System account.
  • FusionReactor reports it "Cannot modify the web.xml" during instance installation
  • A FusionReactor instance doesn't start, and reports configuration exceptions, possibly reporting Permission Denied on file operations
  • You change the user under which your J2EE container runs

In order to change the runtime user of the FusionReactor system, the following procedure can be used. The procedure uses coldfusion as the runtime user, but you should substitute your J2EE service user as necessary. The procedure uses C:FusionReactor as the install location of FR – again, adjust this as necessary.


Log in to the system as user with Administrative privileges.

  1. In the Services Control Panel stop the FusionReactor AM Service.
    • Right click the FusionReactor AM Service and select the Log On tab.
    • Select This account and provide the runtime user name, and the password for that user.
    • Click OK.
  2. In a file Explorer window, right-click your C:FusionReactor and select Properties.
  3. Select Security, then Advanced.
  4. Select the Owner tab.
    • In the box marked Change owner to… select the new owner of the system. If the new owner is not displayed, click Other Users or Groups and enter the new owner name., followed by OK. That name should appear in the *Change owner to…" box.
    • Ensure the box marked Replace owner on subcontainers and objects is checked
    • Click OK. This will change the owner of the FusionReactor system files.
  5. Select the Permissions tab.
    • You may see an Allow entry for your runtime user in the Permissions box.
      • If you do not, click Add, then enter the name of the runtime user, and click OK.
      • If you do, double-click on that user. Both actions bring up the "Permission Entry for FusionReactor" dialog.
    • In the "Permissions Entry for FusionReactor" dialog:
      • Change the Apply onto dropdown to This folder, subfolders and files
      • Check the Allow column's Full Control box.
      • Ensure the last checkbox on the dialog, entitled Apply these permissions to objects and/or containers within this container only is not checked.
      • Click OK.
    • Back in the Permissions tab of the Advanced Security Settings for FusionReactor dialog, you should now have an Allow entry for your runtime user.
      • The entry should list Allow, and Full Control for this user, applied to This folder, subfolders and files.
    • Check the box marked Replace permission entries on all child objects with entries shown here that apply to child objects
    • Click OK, and say Yes to the warning dialog which appears.
  6. Click OK to close the FusionReactor Properties dialog.
  7. Restart the FusionReactor AM Service

Issue Details

Type: Technote
Issue Number: FRS-288
Components: Installer
Resolution: Fixed
Last Updated: 19/Mar/12 5:09 PM
Affects Version: 4.0.0
Fixed Version: 4.0.0
Platform: Windows 2003, Windows 7, Windows 2008
Related Issues:

FRS-270: Unix: Changing the user of a FusionReactor installation