= SAGE installation and usage =

== Installation ==

=== Prerequisities ===

These packages are required to compile SAGE on Ubuntu:
* build-essential
* mesa-utils
* python-wxtools
* libmagickwand-dev
* libreadline6-dev 
* libsdl-dev 
* libxmu-dev 
* libxi-dev 
* freeglut3-dev 
* libglew1.5-dev 

Optionally, these packages are helpful in monitoring the system:
* ethtool 
* iftop

Before compiling SAGE make sure that the OpenGL library is linked properly in /usr/lib - some GPU drivers tend to break the links.

=== Compilation ===

To compile SAGE simple ''make'' and ''sudo make install'' is required. 
There is a configure script distributed with SAGE sources, but all it does is echo "DONE", so you don't have to run it.

=== Environment setup ===

After installation SAGE there is some environment setup required.

1. Environmental variables[[BR]]
 You need to setup environmental variables even if you don't start an interactive session but just run a command using ssh. To achieve this you have to:
 * change one of the first lines in .bashrc from:
{{{ 
  [ -z "$PS1" ] && return 
}}}
 to:
{{{
  [ -z "$PS1" ] && . /etc/profile.d/sage.sh && return
}}}
1. Libraries location[[BR]]
 Some applications using SAGE may not find SAGE libraries if you run an amd64 system. All you have to do is:
 * enter SAGE installation directory (/usr/local/sage by default)
 * make a symlink (ln -s) to lib64 folder and name it lib (''sudo ln -s lib64 lib'')
 * check whether file /etc/ld.so.conf.d/sage.conf exists; if not - create it and enter /usr/local/sage/lib
 * run ''sudo ldconfig''
1. Install openssh-server (''sudo apt-get install openssh-server'')
1. Disable SSH strict host key checking (in /etc/ssh/ssh_config line ''!StrictHostKeyChecking no'')
1. Setup static IP addresses for interfaces used to communicate between wall and access machine (using /etc/network/interfaces file)

=== Access machine ===

Previous steps are all required on both tile an access machines. On access machine, however, there is some more action to perform.

1. To operate the wall using Wiimote you need to have a Bluetooth adapter and these libraries installed in the system:
 * wiiuse v.0.12 ([http://downloads.sourceforge.net/project/wiiuse/wiiuse/v0.12/wiiuse_v0.12_src.tar.gz download])
 * wiiusecpp v.0.12 ([http://www.missioncognition.net/downloads/wiiusecpp_v0.12_src.tar.gz download]) [[BR]]
 More information about wiiusecpp can be found at [http://www.missioncognition.net/software/wiiusecpp.html developer site].
1. Setup SSH login to all tile computers using rsa key (without password)
1. Edit SAGE configuration files to suit your needs (fsManager.conf and tile*.conf in ~/.sageConfig or /usr/local/sage/sageConfig); configuration files for wall at PSNC can be found in repo

=== Tile machines ===

Also on tile machines there is one thing that you need to do after finishing the environmet setup, which is Xorg server setup. More information can be found in XorgSetup article.

== Additional software ==

=== VLC ===

VLC is the best movie player for SAGE. Information about it and downloads can be found at [http://www.vislab.uq.edu.au/research/optiputer/software/vlc/ developer site].

=== mplayer ===

=== !FileViewer ===

=== qshare ===

=== !DecklinkCapture ===

== Usage ==

=== Start SAGE ===

1. Power on all computers
1. Run Xorg on all tile machines (''runxall'' script on access machine)
1. Run ''sage'' on access machine
1. Click ''start''

=== Movies ===

=== Pictures ===

=== OpenGL ===

=== Own desktop ===

=== Playstation 3 ===

=== Wiimote ===