Welcome to the Rocketeer for the IBM SP -- 4/22/03.

The Apollo clients can be found at:

  /csar/CSAR_Vis/v1.3/bin on Turing

NOTE: Be sure the LD_LIBRARY_PATH environment variable on 
      your Sun or linux workstation includes the 
      corresponding lib directory:

  /projects1/CSAR_Vis/v1.3/lib on the CSAR Suns

  /csar/CSAR_Vis/v1.3/lib on turing

You may also want to add the bin directory (above) to your path.

To install the Houston server, perform the following steps:

1) Untar the Houston_SP.tar file (we have assumed it is in
   your home directory; if not, modify the definition of
   ROCKETEER_HOME in your .cshrc file).  This will create
   the Houston_SP subdirectory, which contains:

   * This Readme file
   * bin     -- Houston master and slave executables, as well
                as the "Houston" launch script and a script
                to kill off HoustonMaster processes in case
                Apollo does not terminate normally.
   * readers -- HDF4 is the only one for now
   * MPICH   -- MPI compiled from public domain source code;
                do not use poe to launch Houston.

2) Edit your .cshrc file (or equivalent; .cshrc.blue on the 
   LLNL machines) to add the lines:

#...............................................................................

# Set up environment to run Houston using MPICH

setenv ROCKETEER_HOME "${HOME}/Houston_SP"

# Use the following on systems with OpenGL installed properly
# (we have temporarily stopped supporting the version that uses OpenGL)
#setenv ROCKETEER_VERSION "v1.3"

# Use the following on systems without OpenGL (Houston server only)
setenv ROCKETEER_VERSION "v1.3-noGL"

if ($?LIBPATH) then
  setenv LIBPATH "${ROCKETEER_HOME}/${ROCKETEER_VERSION}/readers:${LIBPATH}"
else
  setenv LIBPATH "${ROCKETEER_HOME}/${ROCKETEER_VERSION}/readers:/usr/lib:/lib"
endif

setenv MPIHOME "${ROCKETEER_HOME}/MPICH"

set path=(${ROCKETEER_HOME}/${ROCKETEER_VERSION}/bin ${MPIHOME}/bin $path)
 
#...............................................................................

3) Activate the changes by typing "source ~/.cshrc" or by
   logging out and logging back in.

To use Apollo/Houston, follow these steps:

1) Start the Houston server on the SP using the
   "Houston" command, which should be in your path.

   The Houston launch script has one optional argument,
   the number of slave processes.  It seems to work
   most efficiently when the number of slaves matches
   the number of Rocpanda servers (HDF files in one
   snapshot).   NOTE: The number of slaves must not
   exceed the number of HDF files in a snapshot; each
   slave must get at least 1 HDF file to read.  We
   suggest using 4 slaves when the number of Rocpanda
   servers is 4 or 8.

   After a few moments, Houston should say something like:

   Trying to listen to port 4041

2) Start Apollo (same release as Houston) on your local
   workstation.  In the dialogue box, tell it the name of 
   the system running Houston and which port to use
   (4041, unless Houston says otherwise).

   If all goes well, you should see the usual Rocketeer
   GUI.

3) When you exit Apollo, Houston is supposed to terminate,
   although it sometimes does not do so.  The Houston script
   will kill the HoustonMaster processes if you enter the
   letter "q" (by running KillMaster for you).

SPECIAL INSTRUCTIONS FOR TRAVERSING THE LLNL FIREWALL

The firewall allows 2-way communication on any port, but
the connection must be initiated on the LLNL side.  
The best way around this is to use ssh LOCAL port forwarding:

1) Connect from your local workstation (assume the name is "young")
   to the LLNL SP (assume it is frost) using local port forwarding:

   young> ssh -p 922 -L 4044:localhost:4041 frost.llnl.gov

2) Start Houston as usual on frost

3) Start Apollo on young as usual, but tell it the name of the
   system running the server is "localhost", not the remote
   machine name.  Also, use port 4044 on localhost.   Communication
   to port 4044 on the local machine will be forwarded through the 
   firewall to the remote machine on port 4041.

_____________________________________________________________

Robert A. Fiedler