1.2.0 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 on the [Download page.|Galicaster:Download Galicaster]

h1. Prerequisites

* Install Ubuntu 12.04 (64 bits recommended)
** Update all packages on the Update Manager
** Activate the additional drivers for graphics card

{td}
{center}
h5. Documentation

{td}
{table}
{bgcolor}
{column}

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
$ sudo apt-get install python-pip python-setuptools
$ sudo pip install icalendar
$ sudo apt-get install v4l-conf v4l-utils guvcview

{code}



h4. Install drivers

* [Epiphan|Galicaster:Epiphan cards]
** For 64 bits machine with kernel 3.2.0-24 or newer in 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 on 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 before.
* [Galicaster:NCast cards]
** Driver for 3.x kernel is available in this [address|http://www.ncast.com/files/digitizer4-2_3_1_5.tgz].

h4. [Configure your udev rules|Galicaster: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.
* Place the [conf.ini example|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/conf.ini] on the designated folder.
* Download the profiles you may want to try and copy then on _profiles/_. Modify the values to adapt them to your scenario.
** [VGA capturing | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga.ini]
** [VGA and Sound capturing | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/vga_sound.ini]
** [Webcam and sound|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/webcam_sound.ini]
*** The device is set on /dev/video0, where webcams are usually found, change it if necessary
** [Hauppauge ( PAL / NTSC ) and VGA | http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
*** Sound synced and recorded via Hauppauge
** Blackmagic (with sound incorporated)
*** [SDI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_vga.ini] - i.e. Blackmagic Decklink
*** [HDMI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] - i.e. Blackmagic Intensity Pro
* Run Galicaster with _./run_galicaster.py_. It will start with mock devices (bars, static and noise).


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. Then, only one file will be modified, the others will remain unaltered.

To do so:
* The script is {{docs/scripts/migrate_repository.py}}
* Move it to your Galicaster 1.2 directory,
* Configure Galicaster to point to the repository you want to migrate. {{basic>repository=/home/folder/example}}
* _Optional:_ Make a backup
* Run it on a terminal: {code:none}python migrate_repository.py{code}

h4. Create a launcher on the Desktop and on 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 doesn't show, right-button on the file, go to Properties, choose the tab Permissions and check Allow executing file as a program.
* Resize it by clicking right-button on the launcher, go to Resize Icon... .

To make galicaster start as the operative system loads do the following:

* Copy _docs/autostart/galicaster.desktop_ to _~/.config/autostart_.


h4. Configure the server and the ingest behaviour

Depending on when or how you want to ingest the mediapackages set none/immediately/nightly on manual and scheduled.
{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}