Galicaster Dashboard - Installation Guide

{pop-away:metadata | comments | children | labels}

_This page is updated to the 1.0.0-RC1 release_

h4. 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.

{info:title=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|http://www.lernfunk.de/repo] kindly provided by the University of Osnabrück.{info}

h4. 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).

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

# 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):
{panel}
{{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}}
{panel}
\\
# Compile the bundles with Maven:
{panel}
{{cd $\{MH_SRC}/modules/galicaster-dashboard}}
{{mvn clean install \-DdeployTo=$\{MH_SRC}}}
{panel}
\\
# If {{maven}} returns with no errors, the Dashboard should be available at:
{{[http://your-server-url/dashboard/index.html]}}.