THE IRIX/IRAF NETWORK DISTRIBUTION This directory and its subdirectories contain the IRIX/IRAF distribution, for all Silicon Graphics computers running IRIX v3.3 and probably some later versions as well. README This file. as.irix.gen AS.IRIX.GEN (all sources) ib.irix.mip IB.IRIX.MIP (core system binaries) nb.irix.mip NB.IRIX.MIP (NOAO package binaries) irixiraf.ms.Z IRIX/IRAF cover letter source irixiraf.ps.Z IRIX/IRAF cover letter, Postscript bsdiraf.ms.Z Berkeley UNIX/IRAF installation guide source bsdiraf.ps.Z BSD/IRAF installation guice, Postscript output unixsmg.ms.Z BSD/IRAF Site Manager's Guide source unixsmg.ps.Z BSD/IRAF Site Manager's Guide, Postscript zzmake Build utility (not part of distribution) To install IRIX/IRAF you will need to transfer the AS.IRIX.GEN file plus the two sets of binaries, IB.IRIX.MIP and NB.IRIX.MIP. REGISTERING YOUR SITE While the network archive makes it easier to get IRAF, it also makes it harder for us to track IRAF usage by the community. We need this information, e.g., to help obtain funding to continue to develop and support IRAF for the community. PLEASE REGISTER YOUR SITE IF YOU USE IRAF! This takes only a moment; all you need do is fill out the form in the v29/REGISTER file and mail it to iraf-requests@noao.edu. As an added benefit you will get on the IRAF mailing list, and will receive the IRAF Newsletter and other IRAF mail. TRANSFERRING THE FILES Each distribution file is stored in a subdirectory containing the compressed and split distribution file, a CHECKSUMS file, and a FILES.Z file. The distribution file is a UNIX TAR file containing one or more directory trees from the IRAF system. To facilitate transfers over unreliable network connections, the distribution file is split into a number of smaller (512 Kb) files. The files can be transferred as follows. These examples are for the SunOS version of FTP. o If you did not start up FTP as "ftp -i", exit and restart it with the "-i" switch. This is necessary to be able to do bulk transfers without having to answer annoying and unnecessary yes or no queries for each individual file. o On the local system, create a subdirectory for each distribution file you want to transfer, e.g., ftp> !mkdir as.irix.gen o Set the current directory on both the local and remote systems. ftp> cd as.irix.gen ftp> lcd as.irix.gen o Transfer all the files in the distribution file directory. A binary transfer is required for the compressed tar files, and will work for the text files as well since both systems are UNIX. ftp> binary ftp> mget * If problems are encountered, use the CHECKSUMS file to verify that any subfiles already transferred are correct. Delete any partially transferred subfiles and restart the transfer (by subfile we mean the 512 Kb files with extensions .00, .01, .02 etc. making up the distribution file). Both BSD UNIX and SYS5 checksums are given. The IRIX command "sum" will compute the SYS5 checksum of a file. Once all the files have been transferred the subfiles can be concatenated and uncompressed to reconstruct the original distribution TAR file, e.g.: % cat as.* | uncompress | tar -tvf - would list the contents of the distribution file. Such a listing is provided in the file FILES.Z in each distribution file directory. An easy way to look at a compressed text file such as FILES.Z is with "zcat": % zcat FILES.Z | page On SGI systems, the BSD utilities compress, uncompress, zcat, etc., will be found in the directory /usr/bsd. INSTALLING IRIX/IRAF NOTE: these instructions generally assume one is running the cshell csh rather than the System V default Bourne shell sh. Instructions for installing IRIX/IRAF after unpacking the network archive are given in the IRIX/IRAF Installation Guide and UNIX/IRAF Site Manager's Guide, compressed Postscript versions of which are given in the files irixiraf.ps.Z and unixsmg.ps.Z. On most UNIX networks containing a Postscript printer, a hardcopy version of the manual can be obtained with a command such as: % zcat irixiraf.ps.Z | lp [-d] where is the name of the local printer device you want the manual to be printed on. Troff source for the manuals is also provided for sites that do not have ready access to a Postscript printer. Installation is as described in the manuals except that, since you will be installing a network distribution, you install from the compressed and split disk version of the distribution file instead of from tape. For example, to restore AS.IRIX.GEN to the remote directory $iraf, while logged in as user "iraf": % whoami iraf % cd IRIX/as.irix.gen % cat as.* | uncompress | (cd $iraf; tar -xpf -) NOTE: depending on your version of IRIX, you may need "tar -xpof" instead. This example assumes that "iraf" is defined in your unix environment (if not, just type in the pathname of the iraf root directory instead). As a variation, suppose the distribution files are stored on the local system "alex" in directory /tmp2/IRIX and you want to install iraf in the root directory /usr/iraf on the remote system "fred": % cd /tmp2/IRIX/as.irix.gen % cat as.* | uncompress | rsh fred "cd /usr/iraf; tar -xpf -" NOTE: depending on your version of IRIX, you may need "tar -xpof" instead. Or, if you are logged in on fred instead: % cd /usr/iraf % rsh -n alex "cat /tmp2/IRIX/as.irix.gen/as.*" |\ uncompress | tar -xpf - NOTE: depending on your version of IRIX, you may need "tar -xpof" instead. (The -n argument allows you to suspend the rsh without having the job stop waiting for terminal input). Note that, even if the two systems are connected by NFS, it is always safer, faster, and more efficient to use rsh instead of NFS for file transfers such as these. The BIN directories are restored in much the same fashion, e.g., NOTE: depending on your version of IRIX, you may need "tar -xpof" instead. % cd /usr/iraf % rm bin.irix; mkdir bin.irix % cd bin.irix % (cd /tmp2/IRIX/ib.irix.mip; cat ib.*) | uncompress | tar -xpf - % cd /usr/iraf/noao % rm bin.irix; mkdir bin.irix % cd bin.irix % (cd /tmp2/IRIX/nb.irix.mip; cat nb.*) | uncompress | tar -xpf - Please read the installation guide for more complete instructions regarding the installation. There is more to installing and configuring IRAF than just restoring the files to disk as discussed in these examples. As you will see in the other documents, help is available through the IRAF Hotline at (602) 323-4160, which is currently answered weekday mornings, and through electronic mail at "iraf@noao.edu" throughout the week. X WINDOW SYSTEM SUPPORT At the time of the V2.9 release we are just beginning to convert to X at NOAO and IRAF graphics and image display under X is not as nice as one would like. Nonetheless, basic facilities are available. The most important of these is SAOIMAGE, an image display server for X11 which can be used with IRAF in a client/server fashion like IMTOOL on Suns. Source for SAOIMAGE is provided in IRIX/IRAF in the directory $iraf/unix/x11/saoimage. The executable will be installed automatically when the hlib$install script is executed as part of the normal installation. Interactive graphics with IRIX/IRAF is provided by the XTERM terminal emulator, available on SGI's at /usr/bin/X11/xterm. More complete support for IRAF under X11 will be available in the future.