Galicaster Dashboard - Installation Guide

This page is updated to the 1.0.0-RC1 release

External dependencies

Most of the functionalities in the Dashboard will work out-of-the-box, but the screenshot extraction has an external dependency with GStreamer. Additionally, the command-line utility gst-launch and the "good" and "bad" plugins must be installed. Versions above 0.10.29 are proven to work. Older releases may or may not work. Using PUSH mode to get the screenshot this dependency is not needed.

GStreamer in CentOS CentOS includes a very old version of GStreamer in its official repository, which will not work for Galicaster Dashboard. In this case, we recommend using the Matterhorn RPM repository kindly provided by the University of Osnabrück.

Bundle installation

The Dashboard is packaged as a Matterhorn bundle, so it can be easily deployed in any Matterhorn installation. Since it depends on certain Matterhorn services to work, it must be installed in the admin server. In the following steps, ${MH_SRC} denotes the directory where the Matterhorn source code is, and ${FELIX_HOME} the directory where the Felix instance is installed (for Matterhorn versions under or equal to 1.3).

1. Download the tarball and uncompress it in your ${MH_SRC}/modules directory. If you use a shell, this can be done by:

   wget http://webfiler.teltek.es/webfiler/galicaster/GalicasterDashboard-1.0.0-RC1.tgz
   tar -xzvf GalicasterDashboard-1.0.0-RC1.tgz
   mv Dashboard-1.0.0-RC1/galicaster-dashboard/ ${MH_SRC}/modules/

   
   

2. Make sure your current Matterhorn version matches the one in the Dashboard pom.xml file:
   • Check your exact Matterhorn version by examining the first <version> tag within the ${MH_SRC}/pom.xml file.
   • Substitute that value in the <matterhorn.version> tags within the Dashboard pom.xml file.
   • You can do this in one step by running the following command from within the ${MH_SRC}/modules/galicaster-dashboard directory (the one you have just clone'd from git):

     cd ${MH_SRC}/modules/galicaster-dashboard
     sed -i "/<matterhorn.version>[^>]+<\/matterhorn.version>/s//<matterhorn.version>$(grep -m 1 "<version>" ../../pom.xml | cut -d'>' -f2 | cut -d'<' -f1)<\/matterhorn.version>/" pom.xml

     
     

3. Compile the bundles with Maven:

   cd ${MH_SRC}/modules/galicaster-dashboard
   mvn clean install -DdeployTo=${MH_SRC}

   
   

4. If maven returns with no errors, the Dashboard should be available at:
   http://your-server-url/dashboard/index.html.