		MIDAS release 98NOVpl2.2 for Solaris 2.6
		==========================================

*******************************************************************************
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.solaris		# This file
verify98NOVpl2.2.tar.Z	# MIDAS verification procedures (optional)
calib.tar.Z		# All calibration data already installed (optional)
demo.tar.Z		# All demo data already installed (optional)
demoFeros.tar.Z         # Demo data already installed for FEROS (optional)
98NOVpl2.2.tar.Z	# MIDAS 98NOV patch level 1.4, for Solaris 2.6
			# already installed and without sources.
[00-42].98NOVpl2.2.tar.Z  # The previous file in  1.4Mb chunks.
================================================================================

Installing MIDAS:
-----------------
- Create a HOME directory for MIDAS <midas_dir>. E.g. /users/midas. 

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

    - Go to the MIDAS HOME directory, <midas_dir>

	% cd <midas_dir>

    - From ftp:

	ftp> bin
	ftp> get 98NOVpl2.2.tar.Z

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

        ftp> prompt
        ftp> mget ??.98NOVpl2.2.tar.Z

- Re-assemble the original 98NOVpl2.2.tar.Z file from the chunks (which
  conveniently fits on one 1.44 Mybte floppy each):

        % cat ??.98NOVpl2.2.tar.Z > 98NOVpl2.2.tar.Z
        % rm ??.98NOVp2.2.tar.Z

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


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

	% zcat 98NOVpl2.2.tar.gz | tar xf -
	% zcat patch98NOVpl<n>.tar.gz | tar xf -
	% rm 98NOVpl2.2.tar.gz patch98NOVpl*.tar.Z

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

- Make MIDAS front-end scripts available. Two ways:

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

	% alias inmidas=<midas_dir>/98NOV/system/unix/inmidas
	% alias gomidas=<midas_dir>/98NOV/system/unix/gomidas
	% alias helpmidas=<midas_dir>/98NOV/system/unix/helpmidas
    
  2- Or as superuser:

	# cd /usr/bin
	# ln -s <midas_dir>/98NOV/system/unix/inmidas
	# ln -s <midas_dir>/98NOV/system/unix/gomidas
	# ln -s <midas_dir>/98NOV/system/unix/helpmidas

- Make man pages available. 
  As superuser:

	# cd <midas_dir>/98NOV/system/unix/manl
	# cp *.l /usr/man/manl
	# cd /usr/man
	# catman -M . l

- Make MIDAS shared libraries available. Two ways:

  1- As a normal user, if your LD_LIBRARY_PATH is not defined:

	% setenv LD_LIBRARY_PATH <midas_dir>/98NOV/lib

     or if it is already defined:

	% setenv LD_LIBRARY_PATH <midas_dir>/98NOV/lib:$LD_LIBRARY_PATH
 
  2- Or as superuser:

        # ln -s <midas_dir> /midas

- 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.tar.Z and
  calib.tar.Z. They can also be obtained in the "/midaspub/demo" and 
  "/midaspub/calib" subdirectories in this ftp account.
  For on-line help, simply type HELP in response to the MIDAS prompt.

- MIDAS documentation and PostScript format can be obtained in
  the "/midaspub/98NOV/doc" directory.

- Verification procedures for MIDAS are available in the file 
  verify98NOVpl2.2.tar.Z
  To run the verification procedures, type:

	% cd <midas_dir>
	% zcat verify98NOVpl2.2.tar.Z | 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 004> @@ verify2
	Midas 005> @@ verify3
	Midas 006> @@ verify4
	Midas 007> @@ verify5
	Midas 008> @@ verify6
	Midas 009> @@ verify7
	Midas 010> @@ verify8
	Midas 011> @@ verify9
	Midas 012> @@ verify9
	Midas 013> @@ verify10
	Midas 014> @@ verifyt1
	Midas 015> @@ verifyt2
	Midas 016> @@ verifydio
	% cd ..
	% rm -rf tmp

- To remove unnecessary MIDAS packages:

	% cd <midas_dir>/98NOV/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 (not included in the 
  release). Calibration data contains files with ESO specific instruments
  like Filters and CCDs.

	% cd <midas_dir>
	% zcat demo.tar.Z | tar xmvf -
	% zcat demoFeros.tar.Z | tar xmvf -
	% zcat calib.tar.Z | tar xmvf -

- Best of success an 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
        - Telephone: +49-89-32006456
        - Telefax:   +49-89-3202362

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.
