{pop-away:metadata | comments | children | labels}
_This page is updated to the 0.1-alfa 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.
{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:
{panel}
{{wget}} {{[http://webfiler.teltek.es/webfiler/galicaster/GalicasterDashboard-alpha.tgz]}}
{{tar \-C $\{MH_SRC}/modules GalicasterDashboard-alpha.tgz}}
{panel}
\\
# 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:
#* 1.3 and earlier:
{panel}
{{cd $\{MH_SRC}/modules/galicaster-dashboard}}
{{mvn clean install \-DdeployTo=$\{FELIX_HOME}/matterhorn}}
{panel}
#* 1.4 and above:
{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]}}.
_This page is updated to the 0.1-alfa 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.
{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:
{panel}
{{wget}} {{[http://webfiler.teltek.es/webfiler/galicaster/GalicasterDashboard-alpha.tgz]}}
{{tar \-C $\{MH_SRC}/modules GalicasterDashboard-alpha.tgz}}
{panel}
\\
# 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:
#* 1.3 and earlier:
{panel}
{{cd $\{MH_SRC}/modules/galicaster-dashboard}}
{{mvn clean install \-DdeployTo=$\{FELIX_HOME}/matterhorn}}
{panel}
#* 1.4 and above:
{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]}}.