1.2.0 Quick installation guide

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

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
** _Recommended_: Deactivate screensaver (Brightness & Lock configuration)

h4. Install dependencies
{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
$ 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
** 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.

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"

* 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).

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

[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}