Installing SnB v2.1

Preparing for Installation:

1. Verify that the necessary software is present to run SnB on your platform
   
   
   1. SGI IRIX installations require the MIPSpro 7.2.1 IRIX standard Execution Environment Java 3.1.1 (Sun 1.1.6).
      
      
   2. Alpha Unix installations require DIGITAL Fortran V5.1 RTL, HPFLIBS150 (High Performance Fortran Runtime Libraries), and Java 1.1.8-1.
      
      
   3. Linux installations require glibc 2.1.1 or better and Java 1.1.7 or better.
      
      The main complication of getting SnB working on Linux is using a solid Java Run Time engine. For SnB 2.1, you need to install JDK 1.1.8 available from http://www.blackdown.org. If you have Kaffee Java Run Time Engine installed, deinstall it (The SnB GUI does not work with this Java Run Time Engine). An example of doing this on Redhat Linux 6.2: as root run the Kpackage program, browse to Development, Languages, Kaffe, the click on the bottom middle Uninstall ICON.
      
      
   4. Solaris installations require Java 1.1.6 or better.
      
      
   5. IBM SP installations require Java 1.1.6 or better. The directory containing the executable "llclass" must be in your path.
      
      PLEASE NOTE: Java 1.2 is NOT supported at this time. The SnB GUI may work with it, but there are no guarantees. If you are using Java 1.2 and are experiencing difficulties with the GUI, try the 1.1.x version listed above for your platform.
      
      Please contact your system administrator if the prerequestie software is not installed.
      
      
2. The "Install" program uses a GUI written in Java. If you are using X-Windows and are not physically present at the host where you are running the "Install" program, be sure that your DISPLAY environment variable is set and that the host has permission to display on the local machine. Type the following:
   
   For csh:
   
   setenv DISPLAY local_machine_name:0.0 (in a window for the remote machine)
   
   For sh and bash:
   
   export DISPLAY=remote_machine_name:0.0
   
   For all shells:
   
   xhost +remote_machine_name (in a window for the local machine).
   
   
3. Since both the SnB installer and GUI use Java, you will need to make sure that the Java interpreter is in your path. Type "which java" to see if it is present.

Installing SnB:

4. Untar the distribution package and go into the subdirectory "snb-temp" that is created when you untar the distribution package.
   
   gzip -cd snb21.platform.tar.gz | tar xvf -
   cd snb-temp.
   
   
5. Verify that the following files are present:
   
   Install -- Unix version of the install script
   Install.bat -- DOS/Windows version of the install script
   Install.jar -- Java class files for the SnB installer
   snb.zip -- SnB program package (zipped).
   
   
6. Run the Install program:
   
   ./Install
   
   
7. Add the SnB binary directory to your path. For csh and tcsh, add the following line to the end of your ~/.cshrc file, substituting $SNB_HOME for the directory where you installed SnB.
   
   set path=($path $SNB_HOME/bin)
   
   For sh and bash, add the following to your ~/.bashrc file:
   
   export PATH=$PATH:$SNB_HOME/bin.
   
   
8. Log out and log back in so the changes to your environment can take place. To run SnB type in "SnB" at the command line.
   
   
9. After you have verified that everything works delete the files in the "snb-temp" directory that was created when you untarred the distribution package.