ESO Scientific Software Collection (Scisoft) Further information: http://www.eso.org/scisoft Help: scihelp@eso.org This version applies to Scisoft IV (April 2002) Installation Instructions This document describes the installation of the ESO Scisoft scientific software collection from some medium, normally a CD-ROM. Important - read these points before you start: a) Scisoft is currently available for Linux, Solaris 8 and HPUX 11. Please check that the distribution medium matches your hardware. There is no version for Windows or Mac. b) The installation requires more than 2GB of disk space on the target hard disk. If you do not have this much space available you may be able to do a partial install (omitting some packages). Details are given below. c) This is the fourth release of Scisoft (earlier ones were in June and November 2000 and July 2001). If an old one is currently installed it is necessary that it is removed or moved before this one is installed. See below for more details. d) If you already have a working installation you only need to expand the tar file into a new, empty /scisoft directory and check the XEphem resources file as described below (under "Second Package"). There is no need to repeat the other installation instructions. In other words you only need to perform parts iii) and follow the instructions under "Second Package" below. e) Once the collection is successfully installed csh and tcsh users should invoke the command: source /scisoft/bin/Setup.csh to gain access to all the software and configure their environment correctly. Users of the "bash" shell should use: . /scisoft/bin/Setup.bash These commands may be conveniently added to an appropriate startup file such as .cshrc/.tcshrc (for csh and tcsh) and .profile (for bash) or the system-wide equivalents. f) All the other items not listed below do not need any additional installation and automatically are available. g) Root (superuser) access is needed for a full installation. Specifically the IRAF installation requires this to work properly. For a re-installation just access to the scisoft account will suffice unless the XEphem X resources file needs to be removed which will also need root access. h) An 8bit deep X-server configuration must be used if some of the applications (notably SAOImage,ximtool and saotng) are to work. Users who prefer to retain a 24 or 16 bit deep X server are recommended to use the DS9 image display server. i) Some applications need the Motif (or equivalent) sharable library to function correctly. This may not be available on some machines, Linux in particular. j) Due to its size, Scisoft is now compressed with the bzip2 utility on all three versions. The bunzip2 utility is also included with the appropriate distributions, please note the change in the instruction below. More details are in the Scisoft Frequently Asked Questions page at: http://www.eso.org/scisoft/FAQ.html Installation Instructions: These instructions are for a FULL installation, if you already have a working Scisoft installation only stages iii) and the instructions under "Second Package" (replacing the /scisoft directory tree and cleaning up the XEphem resources) are needed. i) Login as root and create an account "scisoft" with its own distinct uid and gid. Files owned by this account should be readable by the world and the directories should have execute access for world but there should be no write access. Another, independent, account "scilocal" can also be set up to contain site/host specific things if desired but is not required. ii) Create a soft link from /scisoft to wherever scisoft will be located on your system. All internal references assume that the software tree is visible as /scisoft/... so this is VERY IMPORTANT. Similarly a /scilocal soft link can be set if desired but this is not essential. iii) Everything should be put onto disk so that it appears to be /scisoft/... (with this file in the top directory). This directory tree must be exported (read only) to all systems which want to use it. Login as the scisoft user for this stage. For a typical configuration in which the Scisoft CD-ROM is available at /cdrom the commands to unpack everything would be: If you are re-installing you should either delete or rename the previous installation and recreate an empty /scisoft directory for the new version. % cd /scisoft % zcat /cdrom/scisoft--.tar.gz | tar xf - ---or, if the distribution used bzip2 rather than gzip---- % bunzip2 -dc /cdrom/scisoft--.tar.bz2 | tar xf - is the release version name - eg, apr2002 and is the machine type - hpux, linux or solaris. NOTE: you can omit certain directories at this stage if you don't want them by using additional arguments for "tar". Please consult the help for your version of "tar" as this varies from system to system. iv) Before installing as described below again become superuser and execute the following from a csh-like shell: source /scisoft/bin/Setup.csh or . /scisoft/bin/Setup.bash if you are using the bash shell. If there are any error messages at this stage concerning MIDAS they may be safely ignored. This defines many environment variables, some aliases and executes a few scripts. It will also needed by all users. What follows are the installation steps which have to be done as root. First Package - IRAF -------------------- If you are re-installing this stage is not necessary. cd $iraf/unix/hlib ./install -n You will be prompted for a few things. The Iraf root directory must be /scisoft/iraf/iraf and the image storage directory should be set to some world-writable place where there is lots of space, this should NOT be in the scisoft directory. The destination for the Iraf commands (cl etc) must be /scisoft/bin, not /usr/local/bin. Once this has run with no obvious errors you can do it for real with: ./install The main things this does are to set up the image display communication pipe files (/dev/imt*) and install /usr/include/iraf.h. It also does a lot of checking. NOTE: in a shared, server-based configuration this Iraf installation script must be run on all machines which are to use this version of IRAF, not just on the server. Second Package - Xephem ----------------------- If you are doing a new installation onto a machine which has never had Scisoft or Xephem installed you do not need to do anything. If re-installing please read on... In versions before 3.4 Xephem required an X-resources file to be placed appropriately. This is no longer necessary. If you have an older Scisoft already installed you must remove this file to avoid errors about "version skew" which will prevent Xephem from running. The file to be removed is typically called: /usr/lib/X11/app-defaults/XEphem -or- /usr/openwin/lib/app-defaults/XEphem -or (under Linux)- /usr/X11R6/lib/X11/app-defaults/XEphem Any of these should be deleted. Third Package - ESO-MIDAS ------------------------- The Setup.csh script will set the environment for the scisoft version of MIDAS, currently 02FEB. If you want to use another MIDAS installation then you will have to reset these environment variables manually. Fourth Package - IDL -------------------- IDL is included here but this is a commercial product which requires a license to be set up in order for it to work fully. If you have a license server machine available with a valid IDL license this can be accessed by suitably setting the LM_LICENSE_FILE environment variable. Note that there are many other packages included here but they do not need any additional installation. Testing ------- If you have got this far without problems you should do a quick test from an independent, normal user account on the same machine. Login to a user account (not scisoft) and if you are running a "csh" style shell and type: source /scisoft/bin/Setup.csh Alternatively for a "bash" shell type: . /scisoft/bin/Setup.bash If there are any errors at this stage there is probably something wrong with the installation. You can now try to execute some of the software. For example try typing "sm","sex","xephem","mkiraf" followed by "cl", "inmidas", "saoimage", "ximtool" etc. Some of these will require an X11 display to be available. Please contact us if things don't go smoothly. The ESO Scisoft team, scihelp@eso.org, April 2002