Skip to main content
MediaBeacon University

Webhead Installation: OS X

This section will guide administrators through the process of installing a MediaBeacon webhead on Mac OS X. MediaBeacon supports OS X 10.8 – 10.9.

To follow these instructions, install the core MediaBeacon application and download the matching webhead .war file.

  1. Install Java 8, which is required to run MediaBeacon 8.0. Download it from:
  2. Download and install Tomcat 8.0. Files and documentation are available here:

  3. Once Tomcat is installed, adjust the maximum heap size for Tomcat’s JVM to at least 1024 MB. For higher loads, more memory may be required. Contact MediaBeacon Support with any questions. To adjust memory allocation, edit bin/ in the Tomcat installation location and put this near the top (after the #!/bin/sh line): JAVA_OPTS=”$JAVA_OPTS -Xmx1024M”


  4. If using MySQL, locate the MySQL connector in the MediaBeacon application bundle. This file will be available after MediaBeacon has connected to MySQL for the first time: /Applications/ Copy it to the Tomcat library: /usr/local/tomcat/lib

    (Assumed Tomcat install location: /usr/local/tomcat – your location might vary.) Webhead-Portal_Mac_2.png
  5. Rename the .war file to match the URL that should be used for accessing the webhead. For example, webhead.war will be accessed at http://localhost:8080/webhead
  6. Copy the renamed .war file to: /usr/local/tomcat/webapps
  7. MediaBeacon 8.x will not accept connections from external applications unless they are explicitly whitelisted on the main server. To allow a connection from the webapp:
    1. Go to the “Enterprise” tab on the main MediaBeacon server and click “Applications.”
    2. Click “Add” and manually enter the IP address for the webapp. Alternatively, click “Discover External Applications.” This will open a temporary 2-minute window during which remote applications are allowed to connect to MediaBeacon, automatically adding them to the whitelist.
    3. Click “OK.”
  8. Launch Tomcat.
  9. Navigate to http://localhost:8080/webhead in a web browser (or whatever URL is appropriate, based on the name of the .war file). The browser will be redirected to remote_config.jsp for a first-time setup. Webhead-Portal_Mac_5.png There shouldn’t be any red icons in the Configuration Checker area. Enter the following information:
    1. Host: Enter the IP address of the core MediaBeacon server relative to the webhead server. If they’re both running on the same machine, localhost is fine.
    2. Port: Use 44444, unless the value for the SOA port was changed on the “Enterprise” tab of the MediaBeacon R3volution server-side GUI application (highlighted in the screenshot below).
    3. Password: The password is set via the “Change Remote Password” button on the “Enterprise” tab of the MediaBeacon R3volution server-side GUI application. Webhead-Portal_Mac_6.png
  10. After entering the Host, Port, and Password, click “OK.” A “Continue” button will display if the webhead was able to connect to the main MediaBeacon server. Webhead-Portal_Mac_7.png
  11. Click “Continue” to proceed to the MediaBeacon login screen. The webhead is now available for use.
  • Was this article helpful?