THE MIPS/IRAF NETWORK DISTRIBUTION This directory and its subdirectories contains the MIPS/IRAF distribution. The V2.9 binary distribution was compiled under RISC/os 4.10 and version 2.10 of the MIPS compilers. The first release of MIPS/IRAF is for IRAF V2.9.1, hence patches 1-3 for IRAF V2.9 are not available for this release. README This file. as.mips.gen All sources. ib.mips.mip Core system binaries. nb.mips.mip NOAO packages binaries. mipsiraf.ms.Z MIPS/IRAF Installation Guide source mipsiraf.ps.Z MIPS/IRAF Installation Guide, Postscript unixsmg.ms.Z Generic UNIX/IRAF Site Manager's Guide unixsmg.ps.Z Generic UNIX/IRAF Site Manager's Guide zzmake Build utility (not part of distribution) To install MIPS/IRAF you will need to transfer the AS.MIPS.GEN file and the two sets of binaries, IB.MIPS.MIP and NB.MIPS.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. 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.mips.gen o Set the current directory on both the local and remote systems. ftp> cd as.mips.gen ftp> lcd as.mips.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 SysV checksums are given. The RICS/os (SysV) command "sum" will compute the 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 MIPS systems, the BSD utilities compress, uncompress, zcat, etc., will be found in the directory /usr/ucb. INSTALLING MIPS/IRAF Complete instructions for installing and configuring MIPS/IRAF are given in the MIPS/IRAF Installation Guide and UNIX/IRAF Site Manager's Guide, compressed Postscript versions of which are given in the files mipsiraf.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 mipsiraf.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. Installation is as described in the manuals except that, since you will be installing a network distribution, you install from the compressed and split For example, to restore AS.MIPS.GEN to the remote directory $iraf, while logged in as user "iraf": % whoami iraf % cd MIPS/as.mips.gen % cat as.* | uncompress | (cd $iraf; tar -xpf -) 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/MIPS and you want to install iraf in the root directory /usr1/iraf on the remote system "fred": % cd /tmp2/MIPS/as.mips.gen % cat as.* | uncompress | rsh fred "cd /usr1/iraf; tar -xpf -" [MIPS NOTE - use /usr/ucb/rsh. Beware that there is also a command /bin/rsh, which is the SysV restricted shell.] Or, if you are logged in on fred instead: % cd /usr1/iraf % rsh alex "cat /tmp2/MIPS/as.mips.gen/as.*" |\ uncompress | tar -xpf - 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., % cd /usr1/iraf % rm bin.mips; mkdir bin.mips % cd bin.mips % (cd /tmp2/MIPS/ib.mips.mip; cat ib.*) | uncompress | tar -xpf - % cd /usr1/iraf/noao % rm bin.mips; mkdir bin.mips % cd bin.mips % (cd /tmp2/MIPS/nb.mips.mip; cat nb.*) | uncompress | tar -xpf - If multiple architecture support is desired you need only create additional sets of BIN directories (multiple architecture support is not currently common practice with MIPS/IRAF). The system as shipped will contain existing symbolic links with these names which should be deleted (you can use a symbolic link to store the BIN directory on another disk if space is tight). DO NOT delete the "bin.generic" directory, or modify the symbolic links "iraf$bin" and "iraf$noao/bin" to point to anything other than bin.generic. 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. 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 facilties 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. An installable SAOIMAGE installation kit is available from the IRAF network archive on tucana (tucana.tuc.noao.edu). Interactive graphics with MIPS/IRAF is provided by the XTERM terminal emulator, which is included in the RISC/Windows package provided by MIPS. More complete support for IRAF under X11 will be available in the future.