This page is updated to the 0.1-alfa 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.
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).
- 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-alpha.tgz
tar -C ${MH_SRC}/modules GalicasterDashboard-alpha.tgz - 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
- Compile the bundles with Maven:
- 1.3 and earlier:
cd ${MH_SRC}/modules/galicaster-dashboard
mvn clean install -DdeployTo=${FELIX_HOME}/matterhorn - 1.4 and above:
cd ${MH_SRC}/modules/galicaster-dashboard
mvn clean install -DdeployTo=${MH_SRC}
- 1.3 and earlier:
- If maven returns with no errors, the Dashboard should be available at:
http://your-server-url/dashboard/index.html.