README FOR SUN/IRAF VERSION 2.11 Last Updated Mon Sep 18 2000 Current Patch Level V2.11.3 ----------------------------------------------------------------------------- 29Aug97 Initial V2.11 EXPORT release 05Sep97 IMFORT patch to add oifversion support 11Nov97 Solaris 2.4, 2.6 support 23Dec97 ***** V2.11.1 patch ***** 21Aug99 ***** V2.11.2 patch ***** 03Dec99 ***** V2.11.3 patch ***** 10Feb00 V2.11.3a (applications) patch (see "patch3a" notes below) 18Sep00 V2.11.3b (misc bug fix) patch (see "patch3b" 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 either V2.11.1 or V2.11.2 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 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 patches 1 and 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. Sun/IRAF V2.11.1 supports SunOS 4.X, Solaris 2.4, Solaris 2.5, and Solaris 2.6. Sun/IRAF V2.11.2 and V2.11.3 add support for Solaris 7 (2.7). All versions are supported with a single IRAF distribution, although you need to install separate binaries for SunOS and Solaris. 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 SUN/IRAF V2.11 RELEASE Sun/IRAF V2.11 is a port of IRAF to Sun/Sparc platforms running either SunOS or Solaris. Beginning with IRAF V2.11, a single version of Sun/IRAF installed on a central server can simultaneously support IRAF sessions running on any combination of SunOS or Solaris workstations or servers. README This file as.ssol.gen All-Sources (main IRAF distribution) ib.sos4.sun Core system binaries for SunOS ib.ssol.sun Core system binaries for Solaris nb.sos4.sun NOAO package binaries for SunOS nb.ssol.sun NOAO package binaries for Solaris 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). 2. INSTALLING SUN/IRAF The procedure for installing Sun/IRAF is unchanged from earlier versions of SunOS/IRAF and Solaris/IRAF. Refer to the Sun/IRAF Installation Guide (suniraf.ps.Z) for detailed installation instructions. A full installation, as for 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.ssun Solaris binaries for core system /iraf/irafbin/noao.bin.ssun Solaris binaries for noao packages /iraf/irafbin/bin.sparc SunOS binaries for core system /iraf/irafbin/noao.bin.sparc SunOS 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 path can be anything, although it is best to keep it short. 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 Sun/IRAF release supports two architectures. "ssun" is the Solaris-Sun architecture for Sparc platforms running Solaris. "sparc" is the SunOS architecture for Sparc platforms running SunOS. A separate set of CORE and NOAO binaries is provided for each architecture. The all-sources (AS) distribution supports both architectures. 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 Sun's CDE or OpenWindows desktops, 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. New users of X11 who are not sure how to configure the window system might want to look at the .Xdefaults, .xinitrc, .openwin-menu, etc. files in the IRAF system manager login directory ($iraf/local, or ~iraf). These files will set up a working IRAF desktop under OpenWindows and should serve as an example or starting point for an IRAF desktop under OpenWindows. Logging in as "iraf" and then typing "win" or "openwin" will start up the windows. 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.0 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 now contains default template tapecap files for both SunOS and Solaris. 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 Solaris, since it is Unix SysV based, uses lp/lpsched as the native printer interface rather than the Berkeley lpr/lpq. SunOS uses the Berkely lpr. Depending upon how Solaris is configured this may be available for Solaris as well. 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 IMFORT patch - Fri Sep 5 15:05:24 MST 1997 This patch has been deleted as the changes are included in V2.11.1. 6.2 Solaris 2.4, 2.6 support - Tue Nov 11 23:45:38 MST 1997 This patch has been deleted as the changes are included in V2.11.1. 6.3 Sun/IRAF V2.11.1 - Tue Dec 23 1997 If IRAF is not already installed on your system, or your current IRAF version is V2.10 or older, you will need to do a full install. Ignore any patch files and to a normal install as outlined in the Sun/IRAF Installation Guide included in this directory. If you are upgrading from V2.11EXPORT to V2.11.1 you can save some work by installing the patch file "patch1.tar.Z". This is done by logging in as iraf (the iraf system administrator) and "untarring" the patch at the IRAF root, as follows: % cd $iraf cat patch1.tar.Z | uncompress | tar -xpvf - After installing the patch file you must also update your BINs. In other words, install new versions of the IB and NB distributions in your bin.sparc or bin.ssun directories. The patch does not modify any site-specific files (although the motd is updated). 6.4 Sun/IRAF V2.11.2 - Sat Aug 21 1999 The Sun/IRAF distribution files have been fully regenerated for V2.11.2, so one way to upgrade IRAF to V2.11.2 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 Sun/IRAF V2.11.1 installation you have the option of installing the patch file. Note that THE V2.11.2 PATCH WILL OVERWRITE CERTAIN SITE SPECIFIC FILES. These are the following: unix/hlib/zzsetenv.def dev/graphcap dev/termcap dev/imtoolrc 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 patch2.tar.Z | uncompress | tar -xpvf - Then diff/merge the files listed above. 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.SSOL.SUN (the sparc/Solaris binaries for the core system, with the IB.SSOL.SUN distribution downloaded to the directory "/ib.ssol.sun" (where is where you created this directory): % cd $iraf/bin.ssun % pwd /iraf/irafbin/bin.ssun # (you should be here, or somewhere similar) % cat /ib.ssol.sun/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 patch. --------------------------------------------------------------------------- 6.5 Sun/IRAF V2.11.3 - Fri Dec 3 1999 The Sun/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 a Sun/IRAF V2.11.1 or V2.11.2 installation you have the option of installing the V2.11.3 patch file. The V2.11.3 patch (unlike V2.11.2 above) will not overwrite any site specific files. This is for the convenience of people updating from V2.11.2 to V2.11.3. There were some features added to graphcap/imtoolrc in V2.11.3 (new Ximtool frame buffers for CCD mosaics), however these changes are not essential to run IRAF. Anyone upgrading from V2.11.1 to V2.11.3 should however upgrade the site specific files or IRAF may not function correctly. The site specific are contained in the separate mini-patch "patch3l.tar" which contains updated versions of the following files: unix/hlib/zzsetenv.def dev/graphcap dev/termcap dev/imtoolrc 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.SSOL.SUN (the sparc/Solaris binaries for the core system, with the IB.SSOL.SUN distribution downloaded to the directory "/ib.ssol.sun" (where is where you created this directory): % cd $iraf/bin.ssun % pwd /iraf/irafbin/bin.ssun # (you should be here, or somewhere similar) % cat /ib.ssol.sun/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.2 and V2.11.3 patches. 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.6 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 files are as follows: patch3a-sos4.tar.Z patch3a for SunOS (sparc architecture) patch3a-ssol.tar.Z patch3a for Solaris (ssun architecture) 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 Sun Solaris architecture: % cd $iraf zcat patch3a-ssol.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. 6.7 Patch3b - September 18, 2000 Patch 3b is a limited patch containing bug fixes to support various external packages (Gemini, PROS, STSDAS, MSCRED). If you don't run into any of the bugs fixed in the patch you don't need to install it, although there is no reason to not do so. The 2.11.3b patch contains all FITS kernel bug fixes through August 2000, assorted buffer size increases, file descriptor leak fixes, error recovery fixes, isolated fixes to MWCS and QPOE, a fix affecting apextract performance when extracting large numbers of spectra, an updated observatory database, and some enhancements to the networking interface to support an upcoming release of Ximtool. Nothing was included which could change the normal behavior or interface of an application. This is a bug fix patch; release of new functionality is being deferred until the V2.11.4 release. The patch files are as follows: patch3b-sos4.tar.Z patch3b for SunOS (sparc architecture) patch3b-ssol.tar.Z patch3b for Solaris (ssun architecture) 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 Sun Solaris architecture: % cd $iraf zcat patch3b-ssol.tar.Z | tar -xpvf - *** NOTE *** Patch3b 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.3a patch should be installed before installing V2.11.3b. The V2.11.3 distribution files DO NOT include patch3b. ----------------------------------------------------------------------------- NOTES added since the release. Wed Sep 24 - iraf/local login (V2.11.0 only) To be able to login using the ~iraf account ($iraf/local) without getting the "run mkiraf" message, edit $iraf/local/login.cl and change the value of logver to "IRAF V2.11 May 1997". [this is fixed in V2.11.1]. Tue Feb 24 - Upgrading V2.11 to V2.11.1 If you are upgrading a V2.11 system to V2.11.1 you should relink any existing IRAF external packages if you are running Solaris 2.5.1. (Alternatively you can make a link S11_5.5.1.e pointing to S11_5.5.e). This is a one-time thing and is necessary as Sun/IRAF versions prior to V2.11.1 did not map microrelease version numbers when generating the shared image name, e.g. since V2.11.1, a SunOS version number such as 5.5.x maps to 5.5. Tue Feb 24 - V2.11 on Solaris 2.5.x Solaris/IRAF executables (or non-IRAF executables for that matter) linked on a Solaris 2.6 system may fail with a "bad arg to system call" trap if executed on older versions of Solaris such as 2.5.1. The solution is to link on a Solaris 2.5 (e.g. 2.5.1) system if an executable will be run on Solaris 2.5 or later. Executables should be linked under Solaris 2.6 only if they will be run on Solaris 2.6 or later systems. All the executables in the V2.11.1 IRAF distribution satisfy this constraint (they will run fine on systems running Solaris 2.4 through Solaris 2.6). The chief problem is IRAF external packages or other executables. Avoid linking any such programs under Solaris 2.6 unless you are sure you will not be using it under any older versions of Solaris.