Quick installation guide

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

{section}
{column:width=69%}
This is a generic step-by-step, one-page guide to Galicaster 1.2.0.
If you are not familiar with Galicaster you may want to read the full guide, starting at the [Download page.|Download Galicaster]

h1. Prerequisites

* Install Ubuntu 12.04 (64 bits recommended)

{bgcolor:yellow}
{table:align=center}

# [Hardware recommendations|Hardware recommendations]
#* [Cookbook|Cookbook]
# [Software installation|Software installation]
#* [Upgrading from older versions]
# [Configuration manual|Galicaster Configuration].

{bgcolor}
{column}
{section}

{code:none}
$ sudo apt-get install \

$ sudo apt-get install v4l-conf v4l-utils guvcview

{code}



h4. Install drivers

* [Epiphan|Galicaster:Epiphan cards]
** Download the driver for 64 bits architecture and kernel 3.2.0-24 or newer from this [link|http://www.epiphan.com/downloads/linux/index.php?dir=&file=vga2usb-3.27.2.4-ubuntu-3.2.0-24-generic-x86_64.tbz]
* [Hauppauge|Galicaster:Hauppauge cards]
** Hauppauge driver is included Ubuntu 12.04
* [Galicaster:Blackmagic cards]
** Latest driver is available at this [link|http://www.blackmagicdesign.com/media/4631288/Blackmagic_Desktop_Video_Linux_9.5.3.tar.gz]. It contains a DEB package.
** Blackmagic gstreamer plugin is included on the gstreamer dependencies installed above.
* [Galicaster:NCast cards]
** Driver for 3.x kernels is available at this [address|http://www.ncast.com/files/digitizer4-2_3_1_5.tgz].

h4. [Configure your udev rules|Cookbook] as in previous releases.

* Consult the device internal names
{code:none}
ls /dev/video*
udevadm info --attribute-walk --name=/dev/video0 | grep name
{code}

* Create the file /etc/udev/rules.d/galicaster.rules with a variation of the following lines.
{code:none}
KERNEL=="video[0-9]*", ATTR{name}=="UVC Camera (0123d:4567)", GROUP="video", SYMLINK+="webcam"
KERNEL=="video[0-9]*", ATTR{name}=="vga2usb", SYMLINK+="screen"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder MPG", GROUP="video", SYMLINK+="haucamera"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder YUV", GROUP="video", SYMLINK+="hauprevideo"
KERNEL=="video[0-9]*", ATTR{name}=="ivtv0 encoder PCM", GROUP="audio", SYMLINK+="haupreaudio"
{code}

h3. Install Galicaster:

* Download the [package|http://webfiler.teltek.es/webfiler/galicaster/galicaster-1.2.0.tgz].
* Unpackage it and place the folder in an area where you have permissions to run applications. Change the folder name if you want to.

h4. Migrate Repository from 1.1.x to 1.2.x

Mediapackages are compatible with both versions but we have included new information concerning the status of the operations. Thus, only one file needs to be modified, the others will remain unaltered.

* Run it on a terminal: {code:none}python migrate_repository.py{code}

h4. Create a launcher at the Desktop and in Unity

* Copy {{docs/autostart/galicaster.svg}} to {{/usr/share/icons}}.
* Copy {{docs/autostart/galicaster.destktop}} to {{usr/share/applications}}.
* Pulse Meta(Win key), type Galicaster and drag the GC icon to the desktop.
** If the GC logo does not show, right-click on the file, go to Properties, choose the 'Permissions' tab and check 'Allow executing file as a program'.
* Resize it by right-clicking on the launcher, go to Resize Icon... .

h4. Configure the ingestion server and behaviour

Depending on when or how you want to ingest the mediapackages set the {{manual}} and {{scheduled}} properties to {{none}} / {{immediately}} / {{nightly}}.
{code:none}
[ingest]
active = True
manual = nightly
scheduled = immediate
host = http://fakeadmin.matterhorn.com:80
username = matterhorn_system_account
password = CHANGE_ME
workflow = full
workflow-parameters = trimHold:true
{code}