	MIDAS release 01SEPpl1.3 for Linux 2.2.16 on Alpha 
	===================================================

*******************************************************************************
Copyright Notice:
=================
ESO-MIDAS: Copyright by European Southern Observatory. 

Permission to use, copy, and distribute the contents of this directory, for
non-commerical purposes, is hereby granted without fee, provided that this
license information and copyright notice appear in all copies.

ESO - Data Management Division
*******************************************************************************

Contents of this directory:

README.alpha_linux	# This file
verify01SEPpl1.3.tar.gz	# MIDAS verification procedures (optional)
calib.tar.gz		# All calibration data already installed (optional)
demo_data.tar.gz	# All demo data already installed (optional)
01SEPpl1.3.tar.gz	# MIDAS 01SEP patch level 1.3 already installed and 
			# without sources, for Linux 2.2.16 (Alpha SuSE 7.0)
			# with fort77/f2c Fortran-to-C translator) and Motif 2.1
[00-20].01SEPpl1.3.tar.gz # The previous file in 1.44 MB chunks.
================================================================================

Installing MIDAS:
----------------

- Retrieve the binary files of the compressed-tar release of MIDAS:

    - Create the HOME directory for MIDAS code <midas_dir>. 

    - Go to the HOME directory, <midas_dir>

	% cd <midas_dir>

    - From ftp:

	ftp> bin
	ftp> get 01SEPpl1.3.tar.gz

  	Or if this file is to big for a single transfer, 
	try the splitted ones:

	ftp> prompt
	ftp> mget ??.01SEPpl1.3.tar.gz

- Re-assemble the original 01SEPpl1.3.tar.gz file from the chunks (which
  conveniently fits on one 1.44 Mybte floppy each):

	% cat ??.01SEPpl1.3.tar.gz > 01SEPpl1.3.tar.gz
	% rm ??.01SEPpl1.3.tar.gz

- Rename or remove a previous release of MIDAS previously installed with
  the same name 01SEP.

- Decompress and untar MIDAS binaries and patches (if available):

	% gunzip -c 01SEPpl1.3.tar.gz | tar xf -
	% gunzip -c patch01SEPpl<n>.tar.gz | tar xf -
	% rm 01SEPpl1.3.tar.gz patch01SEPpl*.tar.gz

  Do the same with all other .tar.gz files that you wish to use.

- Make MIDAS front-end scripts available:

   As a normal user, you can make the following  aliases, and you can include
   them in your .profile or equivalent:

	% alias inmidas=<midas_dir>/01SEPpl1.3/system/unix/inmidas
	% alias gomidas=<midas_dir>/01SEPpl1.3/system/unix/gomidas
	% alias helpmidas=<midas_dir>/01SEPpl1.3/system/unix/helpmidas
    
   Or as superuser:

        # cd /usr/local/bin
        # ln -s <midas_dir>/01SEPpl1.3/system/unix/inmidas
        # ln -s <midas_dir>/01SEPpl1.3/system/unix/gomidas
        # ln -s <midas_dir>/01SEPpl1.3/system/unix/helpmidas

- As superuser create the soft link /midas: 

	# ln -s /<midas_dir> /midas

- Make MIDAS man-pages available (as superuser):

  Create /usr/man/manl if it does not exist:

	# mkdir /usr/man/manl

  Copy MIDAS man-pages to /usr/man/manl

	# cd <midas_dir>/01SEPpl1.3/system/unix/manl
	# cp *.l /usr/man/manl

- To run MIDAS, simply type:

	% inmidas		(to start a MIDAS session)
	% gomidas    		(to resume a previous stopped MIDAS session)

- Demo and tutorial data already installed are in the files demo_data.tar.gz
  and calib.tar.gz.

- For on-line help, simply type HELP in response to the MIDAS prompt or
  lunch the Graphical User Interface with command 'create/gui help'.

- MIDAS documentation in DVI and PostScript format can be obtained in
  the "/midaspub/01SEPpl1.3/doc" directory.

- Verification procedures for MIDAS are available in the file 
  verify01SEPpl1.3.tar.gz
  To run the verification procedures, type:

	% cd <midas_dir>
	% gunzip -c verify01SEPpl1.3.tar.gz | tar xf -
        % mkdir tmp
	% cd tmp
	% inmidas 
	Midas 001> @ vericopy
   to execute all of them:
	Midas 002> @@ veriall
   to execute one bye one:
	Midas 003> @@ verify1
	Midas 003> @@ verify2
	Midas 003> @@ verify3
	Midas 003> @@ verify4
	Midas 004> @@ verify5
	Midas 005> @@ verify6
	Midas 006> @@ verify7
	Midas 006> @@ verify8
	Midas 008> @@ verifyt1
	Midas 009> @@ verifyt2
	Midas 007> @@ verifydio
	% cd ..
	% rm -rf tmp

- To remove unnecessary MIDAS packages:

	% cd <midas_dir>/01SEPpl1.3/install/unix
	% cleanm 
	               MIDAS DELETE MENU:
        ====================================
        1 - Delete only object files.
        2 - Delete object and source files.
        3 - Delete object, source files and libraries.
        4 - Delete executable files.
        q - Quit.

	Select: 4
	        DELETE EXECUTABLES FILES FROM:

	<here a list of MIDAS packages>
	Type <Q> to quit or <L> to list again.
	Select NAME to DELETE: <packagename>

- Optional: Calibration and Demo data already installed.

  Most tutorials in MIDAS require the demo data delivered in separated
  compressed-tarred files. Calibration data contains files with ESO 
  specific instruments like Filters and CCDs.

        % cd <midas_dir>
        % gunzip -c demo_data.tar.gz | tar xmvf -
        % gunzip -c calib.tar.gz | tar xmvf -

- Best of success and enjoy MIDAS!.

Technical Support and Network Services
--------------------------------------
User support is offered to users affiliated with registered ESO-MIDAS sites.
For site registration please use the ESO-MIDAS Registration Form  in
http://http.hq.eso.org/midas-info/midas-registerform.html. We can provide help
for problems, questions during installation or usage of the MIDAS system. If 
answers to questions cannot be obtained locally (e.g. through the manuals) or 
after consulting our FAQ, please feel free to contact us for support.

        - Electronic mail: midas@eso.org
        - Post: Data Management Division - User Support Group.
                Karl-Schwarzschild-Strasse 2,
                D-85748 Garching bei Muenchen
                Germany

Other public services:

	- Anonymous FTP: ftp://ftphost.hq.eso.org
	- WWW          : http://www.eso.org/esomidas
        - mailing lists: 
             midas-announce (for official announcements)
             midas-users    (for general discussion).
          To subscribe send an e-mail to "midas-announce-request"
          or "midas-users-request" with the text "subscribe" in
          the body of the mail.
