Loading sub-menu...

1.2.0 Software installation

compared with
Current by developer
on jun 26, 2013 13:37.

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

Changes (49)

View Page History

Before starting the installation process, please make sure that:
* If you already have a Galicaster running, please check the [upgrading|Galicaster:Upgrading [upgrade|Galicaster:Upgrading from older versions] documentation.
* Your equipment meets Galicaster's [Hardware Recommendations|1.1 Recommendations|1.2.0 Hardware recommendations].
* You are running a Linux-based OS. The recommended distribution is [Ubuntu 12.04|http://releases.ubuntu.com/12.04/]. Be careful selecting 32 or 64 bit on the Desktop release.
* Your capture devices are configured as indicated in the [Cookbook|1.1 Cookbook].
* You are running a Linux-based OS. The recommended distribution is [Ubuntu 12.04|http://releases.ubuntu.com/12.04/]. Make sure that the version chosen matches your system architecture (32 or 64 bit).
* Configuration of your capture devices is explained in the [Cookbook|Cookbook].

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

As a faster alternative, Galicaster can be installed using as a [debian package format|#debpkg]. [.deb package|#debpkg].

{column}
{column:width=29%}
{td}
{center}

h5. Documentation
{center}

# [Hardware recommendations|1.2.0 Hardware recommendations]
#* [Cookbook|Galicaster:1.2.0 Cookbook]
# [Software installation|1.2.0 Software installation]
#* [Galicaster:Capture cards configuration]
#* [Upgrading from older versions]
# [Configuration manual|Galicaster:1.2.0 Galicaster Configuration].
#* [Input profiles]
# [User's Guide|User Guide]
#* [FAQ|Galicaster:1.2.0 FAQ]

* [Quick installation guide|Galicaster:1.2.0 Quick installation guide]
* [Cookbook|Cookbook]\\
\\ \\
{td}
{table}

{anchor:dependences}

h6. 1.\- Install dependencies.

{code:none}
$ sudo apt-get install \
python python-gtk2 python-gst0.10 libgtk2.0-0 libgstreamer0.10-0 \
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 \
_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.1.1.tgz]. site|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.2.3.tar.gz].

Uncompress it using tar:

{code}
$ wget http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.2.0.tgz http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.2.3.tar.gz
$ tar xzf galicaster-1.2.0.tgz galicaster-1.2.3.tar.gz
$ cd galicaster-1.2.03
{code}

_Recommendation: Move galicaster-1.2.02 folder to a familiar location_


h6. 4.\- Configure Galicaster

Galicaster configuration is in the files {{conf-dist.ini}} and {{conf.ini}}. \*Any duplicated value on {{conf.ini}} will prevail over the same ones on {{conf-dist.ini}}.
\*Any duplicated value in {{conf.ini}} will prevail over the one in {{conf-dist.ini}}.

All the application parameters can be set up in these files, such as:


The simplest way to get started with Galicaster is dowloading any of the pre-existing files for any of the reference configurations proposed: *leaving {{conf-dist.in}} *unchanged *leaving* {{{*}conf-dist.ini{*}}} *unchanged* as a reference, and make *making any modification you need on* {{conf.ini}}*: in* {{{*}conf.ini{*}}}:

* 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]
* 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]
* Operation Mode
** [Galicaster Class|Galicaster:Galicaster Class] \- Only recording area
** [Galicaster Mobile|Galicaster Mobile] \- All areas accessible
* Profiles
** [PAL/NTSC Video Capture|1.2.0 Hardware recommendations#videocapturecard] \- [Profile|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
** [WebCam USB|1.2.0 Hardware recommendations#webcamusb] \- [Profile|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/webcam_sound.ini]
** HD video capture - [Profile|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini]

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

{anchor:matterhorn}
h6. 5.\- Opencast Matterhorn Connection

One of the key features of Galicaster is the its 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.
* 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 cause an error in Matterhorn. Please make sure you use a workflow name that exists in the machine you connect Galicaster to.
* *Workflow parameters are available but optional. A unexisting or wrong parameter won't affect the process, a mistaken value will be considered as "False".*
* Check your Galicaster unit is registered as a Capture Agent in the Admin Tools section of your Matterhorn installation.
{code}

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.
The [User Guide] section contains the Galicaster user manual. Should you have any questions, please visit the [F.A.Q.|FAQ] section, where some common questions are already answered.

{anchor:debpkg}

h4. Galicaster Debian Package \[Experimental\]

To install Galicaster using the debian .deb package, [download it|http://webfiler.teltek.es/webfiler/galicaster/galicaster_1.2.0_all.deb] it|http://webfiler.teltek.es/webfiler/galicaster/galicaster_1.2.3_all.deb] and run the following command in a shell:

{code:none}
sudo dpkg -i galicaster_1.2.03_all.deb
{code}

or double-click over on the file browser, running it with the Ubuntu Software Center.
In addition dpkg may ask you to run the following command into install additional packages that are required:

If the Ubuntu Software Center installation is selected, a warning appear since Galicaster is not packaged following the standards strictly, ignore it and continue the installation
{code:none}
sudo apt-get -f install
{code}

Using this method, Galicaster will be installed on /usr/share/galicaster, and the configuration files should placed on _/etc/galicaster/conf.ini_ and _/etc/galicaster/profiles_.

To remove it, run on a shell as root:
Alternatively, open a file browser and double-click on the .deb file, which will install the galicaster package and it's dependencies using the Ubuntu Software Center.

_Note: The Ubuntu Software Center shows a warning because Galicaster does not strictly following the .deb standards. You can safely ignore it and continue the installation._

The package installs Galicaster in {{/usr/share/galicaster}}, and the configuration files are stored at {{/usr/share/galicaster/conf-dist.ini}}, {{/etc/galicaster/conf.ini}} and {{/etc/galicaster/profiles}}.

To remove the package, run the following command in a shell:
{code:none}
sudo dpkg -r galicaster
{code}

The files on _/etc/galicaster_ won't be removed, preserving your configuration files. If you want to delete them also, run as root:
The files at {{/etc/galicaster}} won't be removed, thus preserving your configuration. If you want to delete that too, run:
{code:none}
sudo rm /etc/galicaster/profiles/*.*
sudo dpkg --purge galicaster
{code}