[[image(linux.jpg)]]
== Installing Rappture on Linux Systems ==

'''1.''' Download the latest Rappture distribution:  [[download(rappture-linux-i686-*.tar.gz)]]

'''2.''' If possible, unpack it in the {{{/apps/rappture}}} directory:
{{{
% cd /apps/rappture
% tar xvzf /tmp/rappture-linux-i686-XXXXXXXX.tar.gz
}}}

Where XXXXXXXX is the date of the version you are downloading

If you can do this, you're good to go.  But if you can't write to {{{/apps}}}, you'll have to unpack Rappture somewhere else, and then edit the {{{bin/rappture}}} shell script to contain the proper path.  For example, you could install in /tmp as follows:

{{{
% cd /tmp/rappture
% tar xvzf rappture-linux-i686-XXXXXXXX.tar.gz
% vi XXXXXXXX/bin/rappture

in the editor change the following few lines at the top of the script:
  #!/bin/sh
  #
  # If you install Rappture elsewhere, edit the line below:
  RAPPTURE_INSTALL_DIR=/tmp/rappture/XXXXXXXX
                       ^^^^^^^^^^^^^
}}}

'''3.''' Test it out.  Put the Rappture {{{bin}}} directory on your command path:
{{{
for csh/tcsh:  setenv PATH "/apps/rappture/XXXXXXXX/bin:$PATH"
for sh/bash:   export PATH=/apps/rappture/XXXXXXXX/bin:$PATH
}}}
(''NOTE:'' You should put the {{{PATH}}} setting in your {{{.profile}}} file (sh/bash) or your {{{.cshrc}}} file (csh/tcsh) so it happens automatically whenever you start a shell.)

Now, run one of the examples:
{{{
% cd rappture/XXXXXXXX/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!

== See Also ==
[wiki:rappture_install_macosx Installing on MacOSX]