Skip to main content
MediaBeacon University

Running MediaBeacon as a Service

MediaBeacon R3volution 6.0+ can be run as a service on both Windows Server and OS X. The following are intended to intended to be basic setup instructions. Double-check each step to ensure its appropriateness for your particular configuration.

Windows Service Installation

  1. Ensure MediaBeacon is configured and running properly before proceeding with service installation steps.
  2. Stop MediaBeacon and exit the server application.
  3. Open a command prompt. The application must be run as the "Administrator". To do so:
    1. Press the windows key.
    2. Click the search icon, enter "Command Prompt"
    3. Right-click Command Prompt and choose "Run as administrator".
  4. In the command prompt, cd to the MediaBeacon installation, which is typically C:\Program Files\MediaBeacon\MediaBeacon
  5. Run the command sc query mediabeacon to determine if additional MediaBeacon services are installed on the system. If so, run the command bin\prunsrv.exe //DS//mediabeacon to uninstall them.
  6. Edit etc\mb_inst.bat to add the user that the service should run as.
    1. Modify the PR_SERVICEUSER and PR_SERVICEPASSWORD lines. The username should be prefixed with the domain and should match the user account name that MediaBeacon was initially installed under. For the built-in domain, use .\username. For additional information, see: https://commons.apache.org/proper/co...n/procrun.html
    2. Confirm that the line starting with SET PR_JVM= points to the correct jvm.dll on the system. The location of this file may change depending on the installed Java version and whether it’s the JDK or JRE.
    3. Confirm that the various references to MediaBeacon’s binaries are accurate. The C:\Program Files\mediabeacon\mediabeacon strings should be replaced with the actual install location if MediaBeacon is installed to a non-default location.
    4. Update the PR_JVMMX variable to match the ‘Maximum Memory’ set on the Admin tab of the core MediaBeacon application (which, in turn, should be set to a value appropriate to the server’s use and resources). The default value of 1024 for the PR_JVMMX variable is typically too low. If you’re unsure of a proper value for your environment, please contact MediaBeacon Support.
  7. In the terminal, run etc\mb_inst.bat to install the service.
  8. MediaBeacon can now be started via the server GUI or with the command net start mediabeacon. Once it’s running, the system service can also be managed via jconsole.
  9. To stop the service, use the quit() method in jconsole or the command net stop mediabeacon.

OS X Service Installation

Note: Terminal commands may need to be prefixed with sudo to execute properly. Also, remember that commands are case-sensitive in OS X.

  1. Ensure MediaBeacon is configured and running properly before proceeding with service installation steps.
  2. Stop MediaBeacon and exit the server application.
  3. Mount the MediaBeacon installation DMG. Make a local copy of the file Documentation/Tools/MediaBeacon.plist from the disk image.
  4. Edit the UserName string in MediaBeacon.plist to the user that MediaBeacon should run as. If MediaBeacon is installed in a place other than /Applications/MediaBeacon, edit the string in ProgramArguments to point to the correct location.
  5. Run the command launchctl list MediaBeacon to determine if any additional MediaBeacon daemons are installed on the system. If so, locate the appropriate files in the directory /Library/LaunchDaemons. Unload each daemon with the command launchctl unload <file>, then remove the corresponding plist files from the directory.
  6. Run the command sudo cp MediaBeacon.plist /Library/LaunchDaemons/ to copy MediaBeacon.plist to /Library/LaunchDaemons.
  7. Run the command launchctl load /Library/LaunchDaemons/MediaBeacon.plist to install the daemon.
  8. The MediaBeacon service can now be started via the server GUI or with the command launchctl start MediaBeacon. Once it is running, the system service can also be managed via jconsole.
  9. To stop the service, use the quit() method in jconsole or the command launchctl stop MediaBeacon.
  • Was this article helpful?