[frs-320] Starting FusionReactor Administrator Automatically on Mac OS X

Warning: Unsupported Material

This material has been developed and carefully checked prior to publication but may not be kept up to date.

This material is provided on an 'as-is' basis, with no warranties or guarantees whatsoever. This material is not supported by Intergral GmbH.


This technote applies to customers using Mac OS X 10.8 "Mountain Lion" or above only. Earlier versions of OS X may work but have not been tested.

Starting FusionReactor Administrator Automatically on Mac OS X

A number of customers have enquired as to the possibility of starting the FusionReactor Administrator (commonly known as FRAM or FRAMD on Unix) automatically when OS X comes up.

We have not built this functionality into the installer because of the complexity of the OS X launch process, launchd and the fact that developers' machines tend to vary greatly (and unpredictably) in software layout.

We have, however, developed a procedure for adding this behaviour to OS X.

Please be aware that we cannot provide support for this procedure, because of the highly-diverse nature of developers' machines, and the difficulty of obtaining remote desktop or remote terminal access to them.

Plist and Launchd

The startup of Mac OS X is controlled by launchd. This is a system developed by Apple, designed to obviate the alternative systems in use in Unix-like environments (rc.d, upstart, service etc.).

Launchd uses 'plist', an XML grammar describing property lists (keys, values, arrays etc.). The specific keys required to develop a plist for launchd are described here.

We have developed a plist for launchd which starts FRAMD automatically on Mac OS X.


The plist file, com.intergral.fusionreactor.framd.plist is attached, and requires editing before use.

  1. Copy the attached plist file to your desktop and open it with an editor.
  2. Locate the key UserName and change the associated String value to be your username.
    • If you do no know what your username is, open Terminal (/Applications/Utilities/Terminal and type whoami, followed by the return key.
    • This step must be completed because the FusionReactor installer installs the files as being owned by the user who ran the installer, and FRAMD must access them.
  3. Locate the key ProgramArguments and change the first String value to point to your installation of FusionReactor and framd. In our example, this is /Applications/FusionReactor/instance/FRAM/framd, but you may have installed FusionReactor into another location.
  4. Check that the formatting of the file is correct by running the plutil command in Terminal:
    • plutil ~/Desktop/com.intergral.fusionreactor.framd.plist
    • plutil will respond with an OK or an error message if the formatting has been damaged. Edit the file again until plutil responds OK.
  5. Copy the file using Finder to /Library/LaunchDaemons.
    • Finder may ask you to authenticate with your password to complete this operation.
  6. In Terminal, change the ownership of the plist file to root:wheel
    • Execute the following command, followed by the return key:
    • sudo launchctl load /Library/LaunchDaemons/com.intergral.fusionreactor.framd.plist
    • No errors should occur. After a few seconds, FRAM should be available on http://localhost:8087
  7. (Optional) You can stop FRAM by executing the following command in the Terminal:
    • sudo launchctl unload com.intergral.fusionreactor.framd.plist
  8. You should then perform a reboot to ensure FRAM starts at boot time.

If you have any issues, the Console (/Applications/Utilities/Console may contain more information. If you need to edit the plist file once you've changed its ownership, you must edit the copy located on your Desktop, then procede from step 5 above. It is not possible to easily edit the copy in /Library/LaunchDaemons.


This procedure is not covered by Intergral's free installation support.

Issue Details

Type: Technote
Issue Number: FRS-320
Components: FRAM
Resolution: Fixed
Last Updated: 03/Sep/13 11:53 AM
Affects Version: 5.0.0
Fixed Version: 5.0.0
Platform: MacOS
Related Issues:

Comments are closed.