QUICKSTART (v2.1)

COMPILATION

1. Install required libraries

You need to install these libraries before installing SAGE:

2. Modify makefile

Open the Makefile in the "sage/src" directory and set QUANTA_DIR to the QUANTA directory where you installed QUANTA in your machine.

3. Compile

Execute make in the sage directory (NOT sage/src). If youget errors, check include paths and library paths in makefiles. Also check that you have all the required libraries installed. This will compile frenchwindows library, then the SAGE source and then two simple OpenGL test applications (GLUT is needed for those).

CONFIGURATION

1. Edit Configuration Files

In order to run SAGE on a single machine you shouldn't have to modify the configuration files. For all other cases some changes are needed.
  1. go to the "sage/bin" directory
  2. fsManager.conf:
    • fsManager: name and IP address of the machine on which FreeSpace Manager runs. Usually the master node of cluster. You can specify two IP addresses here from v1.3. The first IP address will be used for system components (i.e. streaming of pixels) and the second IP address will be used for UI connections (sent to connection manager so it must be a PUBLIC address). If only one IP address is specified, it will be used for both.
    • systemPort: port for SAGE system message channel
    • uiPort: port for SAGE UI message channel
    • trackPort: port for tracking data (for LambdaTable)
    • conManager: the ip address and port number of Connection Manager - Connection manager is a server which manages connections among SAGE UIs, fsManagers and appLaunchers - If you don't want to run your own connection manager, just leave these fields as they are (recommended), then your SAGE will connect to the connection manager on a Starlight machine. To set up your own connection manager look in "sage/ui/README" and "sage/ui/usersServer/README" for details.
    • tileConfiguration: name of tile configuration file (described below)
    • receiverSyncPort: port number of sync connection on displaying side
    • receiverStreamPort: port number used for streaming on displaying side
    • receiverBufSize: size of circular buffers of SAGE Receiver in mb
    • fullscreen: 1=True, 0=False (run display nodes in fullscreen?)
    • winTime: used in animation of SAGE window movement/resizing - how long does it take for a window to move from one position to the other
    • winStep: used in animation of SAGE window movement/resizing - how many steps are used in the animation
  3. appLauncher/sage.conf:
    Each application can have multiple execution configurations which consist of:
    • nodeNum: number of nodeson which an app runs
    • Init posX posY sizeX sizeY: initial position andsize of app window in pixels. This line is optional.
    • exec ip command: set an ip address of rendering machine and command to execute an app
    • nwProtocol: TCP - tvTcpModule.so / UDP - tvUdpModule.so
  4. stdtile-1.conf:
    • Dimensions: number of columns and rows of tiled display (col, row)
    • Mullions: width(inches) of top, down, left, and right mullions
    • Resolution: screen resolution of each tile
    • PPI: pixels per inch of each tile
    • Machines: number of display nodes which drive tiled display (does not include the master)
    • for each "DisplayNode":
      • Name: name of each display node (not critical)
      • IP: ip address of each display node
      • Monitors: number of tiles which each node drives (xPos, yPos) of each tile (0,0) is the tile at the lower left corner
  5. tileNodes.list:
    • list the ip addresses of all your cluster nodes including the master

2. Environment Variables (in .profile,.tcshrc or .bashrc)

SAGE requires the following environment variables to be set (examples are for bash shell):

^

RUNNING SAGE

1. Start SAGE

To start SAGE go to the bin directory and execute fsManager. If SAGE was started successfully, your tiled display will turn black. However, if you get any errors, check the configuration files and your environment variables as described above.

2. Run test applications from a console

In "sage/bin" directory:

3. Run SAGE GUI

In order to run SAGE GUI you need the following:

To start SAGE GUI go to sage/ui and type python sageui.py. A dialog should pop-up with a list of SAGE machines. If your SAGE is running correctly, you will see its entry in there with a green circle. Select that entry, change your username and click Connect. From that point on interaction is similar to popular desktop environments (dragging windows, resizing them, closing them...). If your SAGE is connecting to your own connection manager and not EVL's, start the GUI by specifying the IP where your connection manager is running: python sageui.py 123.123.123.123

3. Shutdown SAGE

There are three ways to shutdown SAGE (all the applications must be closed beforehand):

^