Loading sub-menu...

1.0.x Software installation

compared with
Current by developer
on ago 21, 2012 20:00.

Key
This line was removed.
This word was removed. This word was added.
This line was added.

Changes (32)

View Page History

Before starting the installation process, please make sure that:
* Your equipment meets Galicaster's [Hardware Recommendations|Galicaster:Hardware Recommendations|1.1 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]. [Cookbook|1.1 Cookbook].

The installation process consists of five steps: installing dependencies, checking configuration, downloading software, configuring and running.
The installation process consists of six steps: [installing dependencies|#dependences], [checking the configuration|#check], [downloading software|#download], [configuring Galicaster|#config], [checking the connection to a Matterhorn core|#matterhorn] and [testing it|#running].

{anchor:dependences}

h6. 1.\- Install dependencies.

* Gstreamer
* python-setuptools and pip
* iCalendar 2.2 version
* pyCurl
* Capture card configuration tools
gstreamer0.10-plugins-ugly gstreamer0.10-plugins-ugly-multiverse
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar==2.2
$ sudo apt-get install python-pycurl
$ sudo apt-get install v4l-conf ivtv-utils guvcview
{code}

{anchor:check}

h6. 2.\- Check configuration.

{code}

{anchor:download}

h6. 3.\- Download software

*By downloading, you agree to the* *[non-commercial license|http://creativecommons.org/licenses/by-nc-sa/3.0/]**. (Commercial licenses also available under request)* *[!http://i.creativecommons.org/l/by-nc-sa/3.0/80x15.png|width=80!|http://creativecommons.org/licenses/by-nc-sa/3.0/]*

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






Uncompress it using tar:

{code}
$ wget http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.0.0.tgz
$ tar xzf galicaster-1.0.0-rc1.tgz
$ cd galicaster-1.0.0-rc1
{code}


{anchor:config}

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

You can configure all the parameters of the application on it, 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.

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:
* As [Galicaster Operation mode [Galicaster Class|Galicaster:Galicaster Class]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_class/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_class/conf.ini]
* As [Galicaster Mobile|Galicaster:Galicaster Mobile]:
* Operation mode [Galicaster Mobile|Galicaster Mobile]:
** [Video Capture Card configuration|1.1 Hardware recommendations#videocapturecard] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/hau_mobile/conf.ini]
** [WebCam USB configuraion|1.1 Hardware recommendations#webcamusb] \- [conf.ini|http://webfiler.teltek.es/webfiler/galicaster/configs/webcam_mobile/conf.ini]

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

h6. 5.\- Running
{anchor:matterhorn}

h6. 5.\- Opencast Matterhorn Connection

One of the key features of Galicaster is the connection to the publishing platform. If you are using Matterhorn as your media publishing and distribution system, you need to configure Galicaster to work as a Capture Agent and connect it to your core machine. Here are some tips to do so:

* Your Galicaster unit needs access to your Matterhorn Core network.
* Use a valid *host* URL. It may be a fully-qualified name or simply an IP address.
* If your Matterhorn Core is not running in the default port (80), then you need to explicitly include it in the URL (i.e. {{http://<host_name_or_ip>:8080}}).
* The use of the {{http://}} prefix is mandatory.
* You need to use a Matterhorn account which authenticates via Digest (usually, this account is set up in the {{config.properties}} file in your Matterhorn server). A regular account will not work.
* Remember to activate the connection in Galicaster (in the configuration file, section {{ingest}}, value {{active}}).
* A wrong workflow will raise an error in Matterhorn. Please make sure you use a workflow name that exists in the machine you connect Galicaster to.
* Check your Galicaster unit is registered as a Capture Agent in the Admin Tools section of your Matterhorn installation.
** The log (in {{/tmp/galicaster.log}}) will record any problem occurring on the connection to the Matterhorn server.

If your Galicaster is registered as a Capture Agent you should be able to receive the recording schedule, if any, and ingest any recordings in Galicaster to the Matterhorn Core. If this is not so, please review all the steps above and try again. The logs in Matterhorn and Galicaster will give you the hints to know what is failing.


{anchor:running}

h6. 6.\- Run Galicaster

Galicaster Class is launched with the command:

{code}

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