Software installation

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

Galicaster is based on Open Source technologies.

Before starting the installation process, please make sure that:
* Your equipment meets Galicaster's [Hardware Recommendations|Galicaster:Hardware recommendations].
* You are running a Linux-based OS. The recommended distribution is [Ubuntu 10.10|http://es.archive.ubuntu.com/cdimage/releases/10.10/release/] .
* Your capture devices are configured as indicated in the [Cookbook|Galicaster:Cookbook].

The installation process consists of six steps: [Install dependencies|#dependences], [Check the configuration|#check], [Download Software|#download], [Configure Galicaster|#config], [Check Matterhorn Core connection|#matterhorn] and [Test it|#running].

{anchor:dependences}

h6. 1.\- Install dependencies.

Galicaster requires the following software to be installed:

* Gstreamer
* python-setuptools and pip
* iCalendar
* pyCurl
* Capture card configuration tools

In ubuntu 11.04 and above, installing v4l-utils is recommended instead of ivtv-utils.

{code:none}
$ sudo apt-get install \
gstreamer0.10-ffmpeg gstreamer0.10-alsa gstreamer0.10-plugins-bad gstreamer0.10-plugins-bad-multiverse \
gstreamer0.10-plugins-base gstreamer0.10-plugins-base-apps gstreamer0.10-plugins-good \
gstreamer0.10-plugins-ugly gstreamer0.10-plugins-ugly-multiverse
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar
$ sudo apt-get install python-pycurl
$ sudo apt-get install v4l-conf ivtv-utils guvcview
{code}

{anchor:check}

h6. 2.\- Check configuration.

Run the following commands in a shell in order to verify that all dependencies are installed:

{code:none}
$ python --version
Python 2.6.6

$ python -c "import pygtk; pygtk.require('2.0')"
$ python -c "import pygst; pygst.require('0.10')"
$ python -c "import pycurl"
$ python -c "import icalendar"

$ gst-launch-0.10 videotestsrc num-buffers=25 ! video/x-raw-yuv,width=800,height=600,framerate=24/1 ! ffmpegcolorspace ! xvimagesink
$ gst-launch-0.10 videotestsrc num-buffers=25 ! video/x-raw-yuv,width=800,height=600,framerate=24/1 ! ffmpegcolorspace ! x264enc pass=5 quantizer=22 speed-preset=4 profile=1 ! queue ! avimux ! filesink location=out.avi
$ file out.avi
out.avi: RIFF (little-endian) data, AVI, 800 x 600, ~24 fps, video: H.264 X.264 or H.264
$ rm out.avi
{code}

{anchor:download}

h6. 3.\- Download software

Download the software from [this site|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.0.tgz].
Uncompress it using tar:

{anchor:config}

h6. 4.\- Configure Galicaster

Galicaster configuration is in the file {{conf.ini}}. All the application parameters can be set up in this file, such as:

* Operation mode of the application: I.e. whether Galicaster will work as [Galicaster Class|Galicaster:Galicaster Class], designed to be used in a classroom environment, or as [Galicaster Mobile|Galicaster:Galicaster Mobile], a portable recording station.
* Devices used in the capturer, and their configuration.
* Server information to ingest.
* User privileges to control the recorder.


The simplest way to get started with Galicaster is dowloading any of the pre-existing {{conf.ini}} files for any of the reference configurations proposed:
* Operation mode [Galicaster Class|Galicaster:Galicaster Class]:
** [Video Capture Card configuration|Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_class/conf.ini]
** [WebCam USB configuraion|Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_class/conf.ini]
* Operation mode [Galicaster Mobile|Galicaster:Galicaster Mobile]:
** [Video Capture Card configuration|Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]
** [WebCam USB configuraion|Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_mobile/conf.ini]

In the Section [Galicaster Configuration] you will find a description of all section of {{conf.ini}} file.

{anchor:matterhorn}

h6. 5.\- Opencast Matterhorn connection

One of the key features of Galicaster is the connection to the publishing platform. Then it's important to your configuration that your Galicaster unit is working as Matterhorn Capture Agent. Some tips to do so:

* Your Galicaster unit need access to your Matterhorn Core network.
* Use a valid *host* URL. The IP address is suitable too.
* Include the port on the URL, if it's not a default one (for instance host:1234)
* Your Matterhorn account should allow Digest, a regular account won't work.
* Remember to activate the connection (config file, section _ingest_, value _active_).
* A wrong workflow will raise an error, so check it too.
* Once running, check if your Galicaster unit is registered as a Capture Agent, on the admin tools of the Matterhorn worker.
** The log (in /tmp/galicaster.log) would record if any trouble connecting to the Matterhorn server, too.

If your Galicaster is registered as a Capture Agent you should be able to receive the scheduled recording, if any, and ingest whatever you want. If not, review all the steps above and retry.


{anchor:running}

h6. 6.\- Running

Galicaster Class is launched with the command:

{code:none}
$ ./run_galicaster.py
{code}

The [Galicaster:User Guide] section contains Galicaster's user manual. Should you have any questions, please visit the [F.A.Q.|Galicaster:FAQ] section where some common questions are already answered.