##############################################################################
# $Id: HowToInstallForUser.txt,v 1.2 2001/09/10 15:18:15 amodigli Exp $
# $Name:  $
# $Revision: 1.2 $
# $Log: HowToInstallForUser.txt,v $
# Revision 1.2  2001/09/10 15:18:15  amodigli
# Updated for 1.2.0 release
#
# Revision 1.1  2001/05/18 09:09:19  amodigli
# Creation
#
##############################################################################
+-----------------------------------------------------------------------------+
|                                                                             |
|                   UVES Pipeline Installation Instruction For User           |
|                   This refers to a stand-alone UVES pipeline pkg            |
|                   (not the CDROM)                                           |
|                           Andrea Modigliani (ESO-DMD)                       |
|                               amodigli@eso.org                              |
|                                                                             |
+-----------------------------------------------------------------06/09/2001--+

Installation Prerequisites
==========================

- Hardware: 
  A HP/HP-UX, SUN/Solaris workstation, or a LINUX PC (Kernel 2.x),
  128 MB main memory.
  > 2.0GB Free space on Hard Disk.

- ESO-MIDAS version 01SEP, patch level pl1.3 or later.
  The MIDAS system variables $MIDASHOME and $MIDVERS have to be set correctly
  (usually MIDASHOME=/midas and MIDVERS=01SEPpl1.3).

- To allow proper installation of the pipeline:
  
  1- Check that you have a MIDAS release 01SEPpl1.3 or higher

  2- Check that the 01SEPpl1.3/local/default.mk defines
     MIDASHOME as the directory where 01SEPpl1.3 is located.


- Check that the binary ar (to create, modify, and extract from archives) is included
  in your local path (on Solaris this should be under /usr/ccs/bin)
    

(1) Be sure to have defined and existing two basic environment variables:
    MIDASHOME and MIDVERS, for example:
    
    
        setenv MIDASHOME /midas
        setenv MIDVERS 01SEPpl1.3


(2) For normal user we have a simplified installation procedure:

        mkdir $PIPE_HOME
        cd $PIPE_HOME
        gunzip uves-<rel>.tar.gz
        tar xvf uves-<rel>.tar
        cd uves-<rel>
        ./setup user
		
    The installation is terminated. In this case under $PIPE_HOME will 
    be created a link
        uves -> uves-<rel>
        
(3) The installation can occur also somewere else and the user could 
    specify the deployment directory. Lets suppose that it is $PIPE_HOME.
    It must exist:
   
     mkdir $PIPE_HOME

    Under such directory you need to have the subdirectory <instrument>-<rel>.
    
     mkdir -p $PIPE_HOME/uves-<rel>
    
    Copy your archive file (assume uves-<rel>.tar.gz) to a temporary
    directory (suppose for example named tmp_dir)
        cd tmp_dir
        gunzip uves-<rel>.tar.gz
        tar xvf uves-<rel>.tar
		cd uves-<rel>
		./setup $PIPE_HOME/uves-<rel>
		cd $PIPE_HOME
		ln -s uves-<rel> uves
		
    your installation is finished now. you can also remove tmp_dir
  

(4) To upgrade the pipeline in case of having changed just a few modules
    under $PIPE_HOME/uves/uves/ tree
    cd $PIPE_HOME/uves
    make update

