Linux Release Notes
-------------------

NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE 

RPM installation is buggy. The postinstall configuration will occurr
only in the home directory of the user who is installing the software. Tarball
installation is recommended. At least, the instructions can be followed to fix
the RPM installation issue.

NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE 


* Installation

The Linux distribution of TMlib Client comes in two forms: RPM and tarball.
The RPM installation requires administrator privileges since it installs into
/usr/local/STEREO. The RPM also automates a few steps that are required to
configure the TMlib Client software. To install the RPM, run the following
command as administrator:

prompt% rpm -i TMlib_Client-1.6.2789-1.i386.rpm

If everything goes well and you have the proper software prerequisites (any
linux system should, they are minimal) TMlib Client will be installed to
/usr/local/STEREO. You can distribut the tmlibrc.new files found in the
TMlib_Client/ subdirectory to any users on the system who would like to use
the tmconfig application, else using the STEREO_Server environment variable
is also acceptable (read the documentation for more details).

If for some reason you have trouble installing the RPM or you don't have
administrator access to the machine, a tarball of the software has been
provided. To install from the tarball the following steps are required:

  1. Unpack the tarball to the desired installation directory. For example:

     prompt$ pwd
     /usr/people/myhome
     prompt$ tar zxf TMlib_Client-1.6.2789.tar.gz
     prompt$ ls
     STEREO/
     prompt$ cp STEREO/TMlib_Client/tmlibrc.new .tmlibrc
     prompt$

  2. Modify your shell environment. The following lines should be added to your
     .bash_profile (or .bashrc or .profile), if you're using bash, to configure
     the software:

     export STEREO_TMlib_Client_Home="/usr/people/myhome/STEREO/TMlib_Client"
     if [ -e $STEREO_TMlib_Client_Home/bin/TMlib_Startup.sh ]; then
          source $STEREO_TMlib_Client_Home/bin/TMlib_Startup.sh
     fi

     There is also a startup script for csh users.

  3. Verify that everything works by logging out and back in, closing and
     opening a new terminal window, or just by source'ing the newly modified
     shell initialization file. If no errors occurr, then verify the environ-
     ment variables have been set by the following mechanism:
     
     prompt$ echo $STEREO_TMlib_Client_Home
     /usr/people/myhome/STEREO/TMlib_Client
     prompt$ echo $PATH
     /bin:/usr/bin:/usr/java/default:/usr/people/myhome/STEREO/TMlib_Client/bin
     prompt$
     
     You should something similar to the preceeding output. If not, double
     check the steps outlined above.

  4. Read the TMlib Client documentation to learn how to select data servers,
     and how to use the client tools and APIs.


--jjl
3/3/2007