README FOR IBM-AIX/IRAF VERSION 2.10 Current patch level V2.10.1 Updated 30 November 1992 THE IBM-AIX/IRAF NETWORK DISTRIBUTION This directory and its subdirectories contains the AIX/IRAF distribution for the IBM RS/6000 series. README This file. as.aix3.gen AS.AIX3.GEN (all sources) ib.aix3.rs6 IB.AIX3.RS6 (RS/6000 binaries for core system) nb.aix3.rs6 NB.AIX3.RS6 (RS/6000 binaries for NOAO packages) aixbin Some utility programs precompiled for AIX aixiraf.ms.Z AIX/IRAF installation guide source aixiraf.ps.Z AIX/IRAF installation guide, Postscript output unixsmg.ms.Z UNIX/IRAF Site Manager's Guide source unixsmg.ps.Z UNIX/IRAF Site Manager's Guide, Postscript Additional release related documentation of interest. iraf/v210/v210revs.ms.Z V2.10 revisions summary source iraf/v210/v210revs.ps.Z V2.10 revisions summary in postscript iraf/v210/pkgnotes.v210.Z V2.10 package revisions notes iraf/v210/sysnotes.v210.Z V2.10 system revisions notes See also iraf/docs for general documentation. To install IBM-AIX/IRAF you need AS.AIX3.GEN, IB.AIX3.RS6, and NB.AIX3.RS6, plus all the release documentation. REGISTERING YOUR SITE Please register with us if you use IRAF, so that we can track use of IRAF by the community. This also gets you on the IRAF mailing list so that you will receive the IRAF newsletters and other IRAF relating mailings. To register, fill out the form in the v210/REGISTER file and email it to iraf-requests@noao.edu. 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 AIX 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.aix3.gen o Set the current directory on both the local and remote systems. ftp> cd as.aix3.gen ftp> lcd as.aix3.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. files making up the distribution file). Both BSD (Sun and AIX) and SYS5 checksums are given. The AIX command "sum" will compute the BSD 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 INSTALLING AIX/IRAF Complete instructions for installing and configuring AIX/IRAF are given in the AIX/IRAF Installation Guide and UNIX/IRAF Site Manager's Guide, compressed Postscript versions of which are given in the files aixiraf.ps.Z and unixsmg.ps.Z. On most BSD networks containing a Postscript printer, a hardcopy version of the manual can be obtained with a command such as % zcat aixiraf.ps.Z | lpr [-P] 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 or for those who want to read the manuals online with nroff. The IRAF sources and binaries, and the IRAF layered packages are distributed as separate modules that can be installed anywhere. However, the following directory structure is recommended to help organize all IRAF related files. Adhering to this directory structure will simplify the installation as well as future upgrades. iraf/iraf core iraf system iraf/iraf/local iraf system manager login dir iraf/irafbin binaries for main iraf release iraf/irafbin/bin. core iraf bin directory iraf/irafbin/noao.bin. noao package bin directory (other binaries) iraf/stsdas layered package iraf/xray layered package iraf/grasp layered package iraf/ice layered package (other layered packages) The location of the root directory "iraf" above is arbitrary, although to avoid possible filename truncation problems it is recommended that the path be kept reasonably short. A good practice is to set up a symbolic link such as /iraf or /usr/iraf pointing to the actual root directory, and use this in all external references to the iraf files, to allow the root directory to be relocated without affecting software that knows the path to the iraf root. This is especially important when iraf is installed in a central location and NFS mounted on a number of client machines. Any of the directories above can be symbolic links pointing to the actual location of the directory, if disk space becomes tight and it is necessary to move something. Please read the installation guide for detailed instructions regarding the installation.