Installation Instructions - tar.gz(bz2) package for any Unix distribution:

To install the tar.gz(bz2) package for any distribution, please follow these steps:

  1. After downloading the tar.gz package, you need to uncompress and extract it in a location of your choice, for example, /usr/lib or /usr/local or /usr/local/lib. For the purpose of this document, it is assumed you are going to install UltraScan in /usr/lib and /path is the path to your downloaded file.
    cd /usr/lib
    gzip -d /path/ultrascan-version.tar.gz
    
    For bzip2 compressed binaries, use:
    bzip2 -d /path/ultrascan-version.tar.bz2
    
    tar -xvf /path/ultrascan-version.tar
    

  2. Next, you need to set the following environment variables, either in the private login script file, or in a global login script file, or alternatively as shown in option (5):

    For sh, bash:

    export ULTRASCAN=/usr/lib/ultrascan
    export PATH=$PATH:$ULTRASCAN/bin
    

    For csh, tcsh:

    setenv ULTRASCAN /usr/lib/ultrascan
    setenv PATH "$PATH:$ULTRASCAN/bin"
    

    shared library list. If your Unix system supports dynamic link path configuration using /etc/ld.so.conf, this can be accomplished by adding /usr/lib/ultrascan to the /etc/ld.so.conf file and running ldconfig.

  3. If your Unix system does not support /etc/ld.so.conf dynamic link configurations, you will need to modify the "LD_LIBRARY_PATH" environment variable and add the UltraScan library directory to it:

    For sh, bash:

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/lib/ultrascan/lib
    

    For csh, tcsh:

    setenv LD_LIBRARY_PATH "$LD_LIBRARY_PATH:/usr/lib/ultrascan/lib"
    

    For Mac OS-X:

    export DYLD_LIBRARY_PATH=$ULTRASCAN/lib:$DYLD_LIBRARY_PATH
    

  4. Next, you will have to add the UltraScan library directory to your dynamically
  5. If your distribution supports /etc/profile.d/ script parsing (most Linux versions do), you can also add these files to /etc/profile.d:

    Don't forget to make the scripts executable:

    chmod 755 /etc/profile.d/us.*
    

  6. If your Unix version does not support /etc/profile.d/* script parsing, you will have to modify your environment

  7. To verify that the environment variables are correctly installed, use the "echo" command:

    echo $VARIABLE
    

  8. Next, verify that all dependencies are satisfied. UltraScan requires QT version 3.1.x with the following compile time options:

    configure -qt-gif -thread -shared -qt-sql-mysql
    


www contact: Borries Demeler

This document is part of the UltraScan Software Documentation distribution.
The latest version of this document can always be found at:

    http://www.ultrascan.uthscsa.edu

Last modified on January 13, 2003