Version 8 (modified by ajaworski, 13 years ago) (diff)

--

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
    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
      
  2. Libraries location
    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
  3. Install openssh-server (sudo apt-get install openssh-server)
  4. Disable SSH strict host key checking (in /etc/ssh/ssh_config line StrictHostKeyChecking no)
  5. 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:
  2. Setup SSH login to all tile computers using rsa key (without password)
  3. 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.

Usage

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

Additional software