Cheat Sheet: End-user Software Install

This Glast software installation "Cheat Sheet" is intended as a shortcut for experienced end-users who may simply be installing software they are already familiar with on a new machine.

SLAC Public

To use SLAC's Public Installation:

1. Check Current platforms supported.

2. Fulfill Prerequisites: Basic.

3. Modify Your SLAC Public Environment to access external libraries.

Note: If you want to run FRED on your desktop, see:

Running FRED on Desktop, Gleam on SLAC Public

4. To run SAOImage ds9, FTOOLS, and Xspec on SLAC Public, setup scripts for .csh and .sh are available at:

$GLASTROOT/applications/astroTools/

1. Log on to a SLAC Public machine.

2. Enter: cd $GLASTROOT/applications/astroTools/

   Then enter: ls

3. Determine which setup script to use by entering: printenv SHELL

   If the response is /bin/tsch, use the .csh setup script. For example, enter:

   source $GLASTROOT/applications/astroTools/astrotools_setup.csh

   If the response is for a bash shell, use the .sh setup script.

   Note: You will find:

ds9		in the bin directory
All of the FTOOLS		in /headas/ftools/i686-pc-linux-gnu-ibc2.2/bin

Tip: To access FTOOLS Help, enter: fhelp, then enter the name of the tool. Tutorials and Help files are also available at:

http://ftools.gsfc.nasa.gov/docs/software/ftools/ftools_menu.html

Desktop Installations
(GlastRelease, EngineeringModel, or ScienceTools)

ATTN: If you are installing ScienceTools for DC2, please go to DC2 Code Releases and install the software following those instructions.

Installers:

• GUI Version (must have Java installed and javaws must be in your path): Launch Installer Now!

Note: If you experience problems, refer to step 1 of: Glast Software Installer.

• Linux Command Line Installer (for Linux users who prefer using a command line installer instead of a GUI)

Prerequisites:

ScienceTools

• RedHat 9 (or later), or
  Fedora Core 1 (or later)

GlastRelease or EngineeringModel

• Prerequisites: Basic

• Ruby v1.8.1 or higher (see Ruby Interpreter)

Procedure

1. Create two directories; one each for:

• GlastRelease, EngineeringModel, or ScienceTools distribution

• external libraries

2. Create a GLAST_EXT environment variable that points to the directory where the external libraries will be placed.

3. Using an installer, install both the release software and the external libraries.

4. Verify that the files have been installed and unpacked in the intended directories.

5. Create an environmental variable pointing to the bin directory (located in your instDir).

   Notes:

   • bin contains the wrapper scripts used to run the applications included within the binary distribution) 

• If you set the PATH from the command line, be sure to enter "rehash" to ensure that the executables in the bin subdirectory will be found.

• If installing Science Tools, create an environment variable pointing to PFILES.

• If installing GlastRelease or EngineeringModel, create an environment variable for ROOT; see:

• Set ROOT Environment Variables: Linux

or

• Set R05/22/2008>

Notes:

• If you are using a Windows machine, you will also need to have Cygwin installed for both FTOOLS and SAOImage ds9.

  The latest version of Xspec, however, does not support Cygwin.

• If you do not want to download and install these programs on your machine, ds9, FTOOLS, and Xspec are available on SLAC Public. (See SLAC Public, above.)

• To install these programs, click on:

• SAOImage ds9

• FTOOLS

• Xspec

7. If you are at GSFC, see GLAST at GSFC.