ESO-MIDAS on CD-ROM

ESO MIDAS DOCUMENTATION

ESO-MIDAS documentation is also included in this CD-ROM in PostScript and HTML format in the directory /cdrom/midas/docs

• volume_a.ps.gz ESO-MIDAS Volume A: System
  
• volume_b.ps.gz ESO-MIDAS Volume B: Data Reduction
  
• volume_a.html.tar.gz ESO-MIDAS Volume A: System
  
• volume_b.html.tar.gz ESO-MIDAS Volume B: Data Reduction
  
• env.ps.gz ESO-MIDAS Environment
  
• agldoc.tar.gz AGL Documentation
  
• ididoc.tar.gz IDI Documentation
  
• installunix.ps.gz MIDAS Installation Notes for UNIX
  
• installvms.ps.gz MIDAS Installation Notes for VMS
  

ESO MIDAS INSTALLATION FROM CD ROM

This section describes installing ESO-MIDAS from the MIDAS release distribution on CD-ROM.
The CD-ROM contains all the ESO-MIDAS sources needed for a full installation, which is applicable for most common Unix platforms, as well as Linux and Mac OS X.

STEP 1 - BEFORE YOU BEGIN

a) Disk Requirements (in kilobytes)
You must ensure that you have enough disk space to install ESO-MIDAS products before you begin. Consult the following table, and add together the disk requirements for each product you are installing:

b) MIDASHOME Directory
The ESO-MIDAS products you are installing will reside entirely within a single directory called MIDASHOME (e.g. /midas or /home/midas) which must be created by you. Before proceeding with the installation, check the disk space available on your system (e.g. with command df), and decide in which filesystem you want to install ESO-MIDAS.

STEP 2 - COPY THE FILES

ESO-MIDAS products are supplied as compressed tar files on the CD-ROM. They are installed by running the installation shell script on a machine with write-access to what will be the MIDASHOME directory. If this machine does not have its own CD-ROM drive, it will need to remotely access a CD-ROM drive somewhere on the network. To install ESO-MIDAS product(s):

a) Login as root.

b) Load the CD-ROM on the machine with the CD-ROM drive. Mount the CD-ROM as an ISO-9660 (High Sierra) filesystem using the appropriate device name and mount command for your architecture. The following table gives suggested device configurations and mount commands for each architecture:

If the machine with the CD-ROM drive does not have write-access to what will be the MIDASHOME directory, you must now export the /cdrom direc- tory, and mount it on an appropriate machine.

On Solaris and with vold(1) running, the CD-ROM may be automatically mounted as /cdrom.
On Silicon Graphics the CD-ROM might be automatically mounted as /CDROM.
On other systems you may need to create the CD-ROM mount point to /cdrom with the command "mkdir /cdrom".

c) Copy the relevant files
The CD contains compressed tar files for the MIDAS system, the verification package, as well as the FORS1/2 and UVES VLT instrument pipelines. Also the corresponding README files in ASCII format are on the CD. So, for the MIDAS system do:

% cd $MIDASHOME
% cp /cdrom/midas/$MIDVERS.tar.gz .
% gunzip $MIDVERS.tar.gz
% tar xvf $MIDVERS.tar

Once you have copied all files from the CD, you can unmount it using "umount /cdrom"

STEP 3 - DO THE INSTALLLATION

For a full configuration and complete installation of MIDAS with defaults values the following command will work on most system:

% cd $MIDASHOME/$MIDVERS/install/unix
% ./autoconfig

The previous configuration tool 'config' is still available. Use this script if you want to select packages and change defaults.

% ./config

the config script is described in detail in the Postscript file installunix.ps , also stored on the CD.

STEP 4 - TEST THE INSTALLATION (OPTIONAL, BUT RECOMMENDED)

The verification procedures are designed to exercise MIDAS commands and to compare results with internal and correct values. They should stop and report to the operator if they detect any problem with MIDAS commands.
To run the verification procedures, create a temporary directory (e.g.$MIDASHOME/tmp), move in, and enter:

% inmidas
Midas 001> @ vericopy
Midas 002> @@ veriall

STEP 5 - CLEAN UNNECESSARY PACKAGES (OPTIONAL)

The distribution of ESO-MIDAS includes all packages available for MIDAS, but you might not be interested in all of them. If after the installation you want to remove them, to free some disk space, you should use the option "9 - clean MIDAS" available in the "config" script:

% cd $MIDASHOME/$MIDVERS/install/unix
% ./config
....
Select: 9 (clean MIDAS)

You wil get a menu of choices, and for any option you select, confirmation will be requested before it starts removing files.

STEP 6 - ACCESS TO TAPE AND PRINTER DEVICES

TROUBLESHOOTING

This section lists some typical errors and their solutions.
You can execute all actions as a user, except for the last one "7 - Complete installation in your system" which has to be done as root.

• You can install products for more than one architecture, provided they are installed in separate directories.
  
• In some architectures (e.g. Linux) the directory /usr/man/manl for system man pages does not exist. Just take an existing one (e.g. /usr/man/man1).
  
• On SUN-Solaris the LD_LIBRARY_PATH should contain the following directories: /usr/dt/lib, /usr/openwin/lib and /usr/SUNWspro/lib
  
• AFS (Andrew File System) does not support pipenames. If you get error messages like "Cannot create server for GUI XHelp.exe", set the environmentvariable MID_WORK to a directory in the local file system (e.g. /tmp/mymidwork).
  
• On some systems like SUN-SunOS and SUN-Solaris you might get error messages like:
  ***** Warning: translation table syntax error: Unknown keysym name: ***
  If so, they may be solved by using the file /cdrom/midas/xKeysymDB. Try one of the two posibilities:
  As any user, enter:
  

  % cp /cdrom/midas/xkeysymdb $HOME/XKeysymDB
  - for C-Shells and alike: % setenv XKEYSYMDB $HOME/XKeysymDB
  - for Bourne Shells and alike: % XKEYSYMDB=$HOME/XKeysymDB ; export XKEYSYMDB
  

COPYRIGHT AND LICENSE

Send comments to <midas@eso.org> Last modified: Mon Oct 28 11:20:14 MET