README FOR SILICON GRAPHICS IRIX IRAF VERSION 2.11 Last Updated Thu Feb 10 2000 Current Patch Level V2.11.3 ----------------------------------------------------------------------------- 18Mar98 Initial V2.11.1 release for IRIX 6.2 on Silicon Graphics 14Dec99 ***** V2.11.3 patch for IRIX 6.5 ***** 10Feb00 V2.11.3a (applications) patch (see "patch3a" notes below) If you are INSTALLING IRAF FOR THE FIRST TIME ignore any patch files and just do a normal install from the AS, IB, and NB distributions as described in the installation guide in this directory. If you already have a V2.11.1 system installed and you are updating to V2.11.3, you have the option of either doing a full install or installing patch3.tar.Z (or patch3.tar.gz) as outlined below in Section 6. In either case you must update your binaries as well (the IB and NB distributions). If you have an older V2.11EXPORT installed you can update by applying patch 3 and then updating the binaries (IB and NB distributions). You may prefer however to do a full install instead, which will give you a clean V2.11.3 system without any patching required. The Dec99 release of IRIX/IRAF is at IRAF version V2.11.3 and was built for IRIX 6.5. It is unknown at this time whether this will continue to run on older platforms. The IRAF distribution does not itself include graphics and image visualization tools, these are distributed separately. See /iraf/x11iraf and /contrib. You should use Xgterm for any IRAF line graphics. Ximtool, SaoTNG, SAOimage, and other related image viewers may be used for image interaction. See also the post-distribution notes at the end of this file. These are continually updated after the release as any problems are encountered. ----------------------------------------------------------------------------- 1. INTRODUCTION 1.1. THE SGI IRIX V2.11 RELEASE SGI IRIX IRAF (IRIX/IRAF) V2.11 is a port of IRAF to Silicon Graphics platforms running IRIX V6.x (we used V6.2 for our port). README This file as.irix.gen All-Sources (main IRAF distribution) ib.irix.mip Core system binaries for IRIX nb.irix.mip NOAO package binaries for IRIX The distribution directories contain large compressed Tar files split into a number of modest size (e.g. 512KB) chunks, to allow recovery if the network fails during a transfer. The Installation Guide provides detailed instructions on how to use these files to install IRAF. 1.2 WHO SHOULD UPGRADE? IRAF V2.11 is a major IRAF release for all supported IRAF platforms. Support for older versions of IRAF is limited so sites running earlier versions of IRAF should update to the new version of IRAF. There may be incompatibilities between V2.11 and earlier versions of IRAF, so updating in the middle of an analysis program might not be advisable. Mixing different versions of IRAF works in most cases, but there can be complications. Large installations may want to keep and older version of IRAF around to give users time to complete their programs before switching to the new version of IRAF (e.g. here at NOAO, "cl" or "iraf" runs V2.11, and "irafo" will bring up the older V2.10.4 release). Contact site support if you are interested in setting up dual systems like this. 2. INSTALLING IRIX/IRAF The procedure for installing IRIX/IRAF is unchanged from earlier versions of IRIX/IRAF and other versions of IRAF. Refer to the IRIX/IRAF Installation Guide for detailed installation instructions (see (irixiraf.ps.Z in the distribution directory). A full installation, as this is a major release, will be required. The installation guide contains the full installation instructions (see also the notes below) but one thing is worth emphasizing here: the installation will be simplified if you set up the iraf directories as follows: /iraf root of iraf related files /iraf/iraf root iraf directory (AS dist) /iraf/irafbin iraf bin dirs go here /iraf/irafbin/bin.irix SGI IRIX binaries for core system /iraf/irafbin/noao.bin.irix SGI IRIX binaries for noao packages /iraf/extern external packages (tables etc.) Here "" is the path where all this is located, e.g., "/u3/iraf" on the IRAF development system here at NOAO. The actual path to the iraf root can be anything. You might want to also set up a symbolic link "/iraf" pointing to the "/iraf" directory. This allows all iraf files to be referred to relative to /iraf, regardless of where the files actually are located, and agrees with the default configuration used in the distribution files. The V2.11 IRIX/IRAF release currently supports only one architecture. The "irix" architecture is for Silicon Graphics platforms running IRIX 6.2 or later, built using the standard IRIX compilers. 3. X11/GUI SUPPORT IRAF V2.11 includes full support for the X11IRAF utilities - these include xgterm for xterm-compatible terminal emulation and graphics, and ximtool for image display under X. The X11IRAF package is not included in IRAF; you need to get it and install it separately, as you would any other X software. X11IRAF is available in /iraf/x11iraf on the main IRAF network server (iraf.noao.edu). Other IRAF-compatible GUIs can also be used with IRAF, e.g. SAOimage, SAOtng, and IPAC SkyView. This software is continually under development and new versions appear on a timetable independent of that for the main IRAF distribution. 3.1 THE X11 DESKTOP The X11IRAF utilities will run under any X desktop. Most people will probably use SGI's default 4DWM-based desktop, but Motif/mwm, twm, fvwm, and so on may be used as well. As of the time of this writing, the X11IRAF utilities do not run on 24 bit truecolor screens, only 8 bit pseudocolor. Support for 24 bit screens is planned. 3.2 THINGS TO WATCH OUT FOR (IRAF) Please see the release notes for information on what has changed in V2.11, and things to watch out for. 3.3 THINGS TO WATCH OUT FOR (X11) Please see the documentation included with X11IRAF V1.1 or later releases for information on running these utilities, including common problems and how to deal with them. One thing we would like to emphasize here is that we STRONGLY suggest that you use "xgterm", not the standard "xterm" to run IRAF. Xgterm, which is included in X11IRAF, has advanced graphics capabilities developed for use with IRAF. Xterm graphics work, but not terribly well. When you start up the cl in an xgterm window, type "stty xgterm" after the CL starts up to tell it you are using an xgterm window. 4. MAGTAPE INTERFACE The DEV directory contains a default template tapecap file for IRIX. If a server is configured to run IRAF for multiple network clients, you can now have multiple tapecap files, one for each host, e.g. "tapecap.foobar" for host "foobar". See the release notes for further information on this capability. 5. PRINTER INTERFACE Local printers are interfaced to IRAF using the dev$termcap file. The default printer, defined by the "printer" environment varilable in hlib$zzsetenv.def, is "lp". This uses the host system lpr with no explicit printer name given, allowing the host environment variable PRINTER to be defined in ther user's environment to direct out to the actual printer. The dev$termcap file may need to be customized to support the printers in use at your site. See the IRAF Site Manager's Guide for detailed instructions on configuration the printer interface. 6. PATCHES 6.1 IRIX/IRAF V2.11.3 - Tue Dec 14 1999 The IRIX/IRAF distribution files have been fully regenerated for V2.11.3, so one simple way to upgrade IRAF to V2.11.3 is to do a full install and diff/merge selected locally customized files from DEV (tapecap, graphcap, imtoolrc, devices.hlp, etc.) and HLIB (extern.pkg, mkiraf.csh, login.cl, zzsetenv.def). If you have an existing IRIX/IRAF V2.11.3 installation you have the option of installing the patch file. Note that THE V2.11.3 PATCH WILL OVERWRITE CERTAIN SITE SPECIFIC FILES. These are the following: unix/hlib/zzsetenv.def dev/graphcap dev/imtoolrc dev/termcap dev/tapecap You may want to save copies of these files and diff/merge them with the new versions after installing the patch. To install the patch, login as the iraf system manager, go to the $iraf directory, and untar the patch as follows: % cd $iraf cat patch3.tar.Z | uncompress | tar -xpvf - Or if you have Gnu tar (e.g. gtar) and downloaded the gzipped patch, % cd $iraf gtar -xpvzf patch3.tar.gz Next, go to the archives and download and install the IB (IRAF core system) and NB (NOAO package) binaries for the architectures your installation will support. For example, to install IB.IRIX.MIP (the IRIX binaries for the core system, with the IB.IRIX.MIP distribution downloaded to the directory "/ib.irix.mip" (where is where you created this directory): % cd $iraf/bin.irix % pwd /iraf/irafbin/bin.irix # (you should be here, or somewhere similar) % cat /ib.irix.mip/ib.* | uncompress | tar -xpvf - A similar procedure is followed to install each of the other binaries. See the URL http://iraf.noao.edu/v2112revs.html for a detailed description of what is included in the V2.11.3 patche. Most of the new features were introduced in V2.11.2. V2.11.3 mostly consists of additional bug fixes, minor changes related to the PC-IRAF upgrades, and a few isolated minor application enhancements. The system notes file (iraf/local/notes.v211) documents these revisions in detail for the core system. 6.2 Patch3a - Feb 10 2000 Patch 3a is a small patch which fixes bugs in several of the V2.11.3 applications, including a serious one affecting onedspec.dispcor (details can be found in the buglogs). The task IMEDIT and the packages APEXTRACT, ONEDSPEC, and RV are affected by the patch. The patch file is as follows: patch3a-irix.tar.Z patch3a for IRIX The patch files contain updated executables for the given architecture. Some source and runtime files are also included; these are duplicated in each patch file, and will be updated correctly no matter which patch files are installed or in what order. To install the patch, merely untar it at the IRAF root. For example, to install the patch for the IRIX architecture: % cd $iraf zcat patch3a-irix.tar.Z | tar -xpvf - *** NOTE *** Patch3a is an incremental patch for the V2.11.3 release only. IRAF must already have been upgraded to V2.11.3 before the patch is installed. The V2.11.3 distribution files DO NOT include patch3a. Patch3a must be installed after upgrading to IRAF V2.11.3. ----------------------------------------------------------------------------- NOTES added since the release. Fri Jan 28 2000 -- Binaries for IRIX 6.2-6.4 Systems ============================================================ The default IRIX/IRAF distribution was built for IRIX 6.5 and does not support earlier versions of IRIX, such as 6.2. This is because in IRIX 6.5 a new "__libc_attr" symbol was introduced which is not satisfied by earlier versions of IRIX, rendering the dynamically linked binaries unusable. We are providing _temporary_ support for IRIX 6.2/6.3/6.4 for those sites which have note yet, or cannot for other reasons, update to the latest IRIX 6.5 release. To install IRAF for IRIX pre-6.5 you install normally as you would for the default system, but substitute the IRIX pre-6.5 binaries. These are provided in the following distribution files: pre-6.5/hbin-irix.gz # Replaces iraf$unix/bin.irix pre-6.5/ib.irix.mip.gz # Core system binaries pre-6.5/nb.irix.mip.gz # NOAO package binaries To configure your IRIX installation to use these binaries, install the ib.irix.mip.gz and nb.irix.mip.gz files above instead of the regular (split) binaries found in the main distribution directories. Go to the unix subdirectory and do the following: % cd $iraf/unix # go to unix$ directory % mv bin.irix bin.irix-6.5 # save new binaries for later update % mkdir bin.irix # make a new bin directory % cd bin.irix # go there and unpack new binries % cat /path/hbin-irix.gz | gunzip | tar -xvf - The resulting system will support IRIX 6.2-6.4 systems but users should note that this system has not been as extensively tested as the main 6.5 release. Where possible we recommend that sites upgrade to 6.5. When IRIX has been upgraded to 6.5 all you need to do to upgrade IRAF is to download the standard IB and NB distributions to replace the main binaries, and switch back the unix$bin.irix directories. Sites with questions or problems are encouraged to contact site support, iraf@noao.edu.