Installing SnB v2.3

Preparing for Installation:

1. Verify that the necessary software is present to run SnB on your platform
   
   
   1. Linux installations require glibc 2.34 or better and Java 1.4.1.
      
      The main complication of getting SnB working on Linux is using a solid Java Run Time engine. For SnB 2.3, 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.
      
      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 prerequisite software is not installed.
      
      
   2. Apple Mac platforms require machines with Power Mac G5 processors, Mac OS 10.4 (Tiger), and Java 1.4.1 or better.
      
      
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:

1. Create a temporary directory, move the tarball into it, and untar the distribution package.
   
   mkdir snb-temp
   mv snb-2.3-platform.tar.gz snb-temp
   cd snb-temp
   gzip -cd snb-2.3-platform.tar.gz | tar xvf -
   
   
2. 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.bat.model -- Windows model (not implemented)
   SnB.model -- Unix model
   jakarta-oro-2.0-jar -- Jakarta-ORO Java classes (perl5 regex)
   snb.prop -- SnB Properties Template
   snb.zip -- SnB base package (zipped)
   bin.zip -- SnB bin directory (zipped)
   
   
3. Run the Install program:
   
   ./Install
   
   
4. 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.
   
   
5. 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.
   
   
6. After you have verified that everything works, you may delete the files, except perhaps the distribution tarball, in the temporary directory that you created.