wiki:rappture_installation_hardway

Version 2 (modified by mmc, 6 years ago) (diff)

Changed "repo.nanohub.org" references

Building and Installing Rappture from Source Code

If possible, you should try to install Rappture the easy way, by downloading one of our prebuilt binary packages. But if that doesn't work for some reason, you can still install Rappture the hard way, by following the instructions on this page.

Obtaining the source code packages

Obtain the "rappture" and "rappture-runtime" sources. You can either download these tar files or through Subversion checkout the latest versions.

Using the tar files

Download both tar files:

Unpack the tar files.

tar xpvf rappture-src-*.tar.gz
tar xpvf rappture-runtime-src-*.tar.gz

This will create two directories: "rappture" and "runtime".

Using Subversion

Checkout both rappture and the runtime sources.

svn co https://nanohub.org/infrastructure/rappture/svn/trunk rappture

Rappture has dependencies on other packages. You need to checkout this too.

svn co https://nanohub.org/infrastructure/rappture-runtime/svn/trunk runtime

The resulting directories should be called "rappture" and "runtime".

Build Rappture

Run the build script.

sh runtime/build_pkg.sh

This will build the rappture runtime (things that rappture is dependent upon) and rappture itself. The results will be put into a directory "builds/<date>". <date> will be the current date (for example 20081014).

Test the build

Setup your path and try to run rappture.

For bash:

export PATH=$PWD/builds/20081014/bin:$PATH

For csh:

set path = ( $PWD/builds/20081014/bin $path )

Try to run one of the examples.

cd builds/20081014/examples/app-fermi/tcl
rappture

Move the build to its destination

Create the destination directory you would like to install Rappture (for example /usr/local/rappture) and move the build into it.

mkdir /usr/local/rappture
mv builds/20081014/* /usr/local/rappture

Edit the "rappture.env" file to indicate where you installed Rappture

vi /usr/local/rappture/bin/rappture.env

Change the INSTALL_RAPPTURE_DIR variable to the location of the destination directory.

RAPPTURE_INSTALL_DIR=/usr/local/rappture

Try running rappture again. First put the Rappture bin directory in your command path:
For bash:

export PATH=/usr/local/rappture/bin:$PATH

For csh:

set path = ( /usr/local/rappture/bin $path )

Go to the examples directory and run one of the examples:

cd /usr/local/rappture/examples/app-fermi/tcl
rappture

This should bring up a simple Fermi function simulator, built with Rappture and Tcl!

Try another example:

cd ../../graph
rappture

This should bring up a simple graphing calculator, built with Rappture and Python!