= 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 

To operate the wall using Wiimote also these libraries are required:
* wiiuse v.0.12 (http://downloads.sourceforge.net/project/wiiuse/wiiuse/v0.12/wiiuse_v0.12_src.tar.gz)
* wiiusecpp v.0.12 (http://www.missioncognition.net/downloads/wiiusecpp_v0.12_src.tar.gz)
More information about wiiusecpp can be found at http://www.missioncognition.net/software/wiiusecpp.html .

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 nad 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
 * in .bashrc change one of the first lines from:
  {{{ 
  [ -z "$PS1" ] && return 
  }}}
  to:
  {{{
  [ -z "$PS1" ] && . /etc/profile.d/sage.sh && return
  }}}
  This will setup all required environmental variables even if you don't start an interactive session but just run a command using ssh.

2. Libraries location
 Some applications using SAGE may not found 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)

== Usage ==