Galicaster Dashboard - Installation Guide

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]}}.