Loading sub-menu...

Quick installation guide

Version 4 by developer
on ago 09, 2012 14:29.

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 (40)

View Page History
{pop-away:metadata | comments | children | labels}

This is a generic step by step one page guide to Galicaster 1.2.0
{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 at the [Download page.|Galicaster:Download page.|1.2.0 Download Galicaster]

h1. Prerequisites

* Install Ubuntu 12.04 (64 bits recommended)
** Update all packages on at the Update Manager
** Activate the additional drivers for graphics card
** _Recommended_: Deactivate screensaver (Brightness & Lock configuration)

h4. Install dependencies
{column}
{column:width=29%}
{bgcolor:yellow}
{table:align=center}
{td}
{center}

h5. Documentation
{center}

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

* [Quick installation guide|Quick installation guide]\\
\\
{td}
{table}
{bgcolor}
{column}
{section}

{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
{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]
** 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 (9.6.9) is available at this [link|http://software.blackmagicdesign.com/DesktopVideo/Blackmagic_Desktop_Video_Linux_9.6.9.tar.gz]. It contains a DEB package.
** Blackmagic gstreamer plugin is included on the gstreamer dependencies installed above.
*[Galicaster:Blackmagic * [Galicaster:NCast 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.
** 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|Galicaster:Cookbook] as in previous releases.

* Consult the device internal names
{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"
* 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] oin the designated folder.
* Download the profiles you may want to try and copy then on _profiles/_. them in {{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
*** The webcam device is set to {{/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] |http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hau_vga.ini]
*** Sound synced and recorded via Hauppauge
*** Sound synch'ed and recorded through the Hauppauge card.
** Blackmagic (with sound incorporated)
*** [SDI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_vga.ini] - VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] \- i.e. Blackmagic Decklink
*** [HDMI capturing + VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/sdi_vga.ini] - VGA|http://webfiler.teltek.es/webfiler/galicaster/configs_1.2.x/profiles/hdmi_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, Thus, only one file will needs to be modified, the others will remain unaltered.

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

h4. Create a launcher on at the Desktop and oin Unity

h4. Configure the server and the ingest behaviour
* 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... .

Depending on when or how you want to ingest the mediapackages set none/immediately/nightly on manual and scheduled.
To make Galicaster start automatically at the system boot, do the following:

* Copy {{docs/autostart/galicaster.desktop}} to {{\~/.config/autostart}}.


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]