Goanna QuickStart instructions

So you just want to get Goanna up and running and usable. This page is intended to get you up and running as fast as possible.

Building Goanna

Goanna can be built with the GoannaBuildInstructions. Basically:

$ svn co http://sss.scl.ameslab.gov/svn/libbamboo/trunk libbamboo
$ cd libbamboo
$ ./autogen.sh --prefix=/opt/sss
$ make && make install
$ cd ..
$ svn co http://sss.scl.ameslab.gov/svn/goanna/trunk goanna
$ cd goanna
$ ./autogen.sh --prefix=/opt/sss --with-bamboo=/opt/sss
$ make && make install

Running Goanna

This is where it gets interesting. Goanna works with "systems." A "system" is essentially one cluster, InfiniBand network, or other unit of interest. So, to use Goanna, you create a system and then pull some data in to it.

In more detail: When you first start Goanna, you'll get a display about like the following:

Click the "New..." button to create a new system. Give this system a name, and you'll have an open but empty system in front of you:

This system isn't really useful without some data. Let's import a dump file. Select "Import SSSRMAP dump..." from the "Data" menu. This allows us to import an XML dump of the SSSRMAP protocol's representation of a system. Browse to the "examples" directory in your Goanna source directory, and select 64node.xml. Goanna now indicates that you have some nodes:

The Nodes tab allows you to examine different nodes and their network connectivity:

Finally, the Topography tab allows you to visualize the network topography. Initially, everything is positioned at the origin (a <0,0,0>) coordinate); to move it around, click the 'Enable electrostatic repulsion' button (the circles and arrows) in the small toolbar. After that runs for a bit, you'll see a decent topography:

From there, just play around.

Making It Useful

Goanna becomes actually useful when you have a Fountain server (or other server providing the correct extended SSSRMAP data) to talk to.