README FOR VAXSTATION-ULTRIX IRAF VERSION 2.10 Current patch level V2.10.1 Updated 14 Sep 1992 THE VAXSTATION-ULTRIX/IRAF NETWORK DISTRIBUTION This directory and its subdirectories contains the Ultrix/IRAF distribution for the VAXstation. This distribution is ONLY for the VAXstation (VAX cpu). The distribution for the Decstation running Ultrix (MIPS cpu) will be found in iraf/v210/DSUX. The distribution for the VAXstation running VMS will be found in iraf/v210/VMS5. At this time there is no IRAF release for the new Alpha machines from DEC, which we have not seen yet. README This file. as.vxux.gen AS.VXUX.GEN (all sources) ib.vxux.vax IB.VXUX.VAX (binaries for iraf core system) nb.vxux.vax NB.VXUX.VAX (binaries for NOAO packages) vxuxiraf.ms.Z Ultrix/IRAF installation guide source vxuxiraf.ps.Z Ultrix/IRAF installation guide Postscript 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 Ultrix/IRAF on a VAXstation you need AS.VXUX.GEN, and the core system and noao package binaries (IB.VXUX.VAX and NB.VXUX.VAX respectively), 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 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.vxux.gen o Set the current directory on both the local and remote systems. ftp> cd as.vxux.gen ftp> lcd as.vxux.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 and SYS5 checksums are given. The Ultrix 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 ULTRIX/IRAF Complete instructions for installing and configuring Ultrix/IRAF are given in the VAXstation Ultrix/IRAF Installation Guide and in the UNIX/IRAF Site Manager's Guide, compressed Postscript versions of which are given in the files vxuxiraf.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 vxuxiraf.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.