Install - schnorr/viva GitHub Wiki

Viva Installation Instructions

Viva is an open-source tool used to analyze traces (in the Paje File Format) registered during the execution of parallel or distributed applications. The tool is released under the GNU General Public Licence 3. Viva is composed of:

• the graph visualization tool (viva)
• the treemap visualization tool (vv_treemap)
• the viva utils library (libvivautils.so)

Dependecies

This package list is from a Linux Ubuntu 12.10 installation. Your installation might have packages with different names. Adapt accordingly, considering that you'll need PajeNG (instructions here), git, cmake, a C/C++ compiler, qt4 (with OpenGL support), boost, glut, and libconfig.

sudo apt-get install git cmake build-essential libboost-dev libconfig++-dev libconfig8-dev libgtk2.0-dev freeglut3-dev

Compile and Install

We recommend an out-of-source compilation:

 git clone git://github.com/schnorr/viva.git ;
 mkdir -p viva/build ;
 cd viva/build ;
 cmake .. ;
 make ;
 make install

When you configure Viva, you may want to specify an installation directory for all the Viva's binaries. You do that using cmake, like this (supposing you are inside the build directory within Viva's cloned repository and you want to install everything in /tmp/viva/):

 cmake -DCMAKE_INSTALL_PREFIX=/tmp/viva/ .. ;
 make ;
 make install

The contents of /tmp/viva/ when Viva is configured with this command are:

$ find /tmp/viva/
/tmp/viva/
/tmp/viva/man
/tmp/viva/man/man1
/tmp/viva/man/man1/vv_treemap.1
/tmp/viva/man/man1/viva.1
/tmp/viva/bin
/tmp/viva/bin/vv_treemap
/tmp/viva/bin/viva

Note the presence of viva and vv_treemap binaries that were installed. Now that you have installed viva tools, you might want to check the viva or the vv_treemap documentation to learn how to use them. You can also check the man pages for each of these tools.