PC-IRAF Installation Guide

Appendix A. A Complete Example

Assume we are installing IRAF for the first time on our spiffy new PC. The IRAF directories will be located at /u1/iraf using a symbolic link /iraf to point to this location. We will configure only the linux binaries, locating the BIN directories in the directory /iraf/irafbin (installing other architectures is just a matter of unpacking the binaries and creating the links). The local user commands will be placed in /usr/local/bin. We will be installing from a network distribution with the distribution files located in /d0.

The first step is for the superuser to create an account for the fictitious user `iraf', with home directory /iraf/iraf/local and shell /bin/csh. The /u1/iraf directory is created owned by IRAF, and pointed to by the link /iraf. We then login as IRAF (a warning message will be printed since there is no login directory) and proceed as follows.

% whoami
iraf
%
% setenv iraf /iraf/iraf/               # set root directory
% mkdir /iraf/iraf
%
% cd $iraf                              # unpack main IRAF distribution
% cat /d0/as.lnux.gen/as.* | zcat | tar -xpf -
%
% cd /iraf                              # create BIN directories
% mkdir irafbin
% mkdir irafbin/bin.linux
% mkdir irafbin/noao.bin.linux
%
% cd $iraf/bin.linux                    # unpack core bin.linux
% cat /d0/ib.lnux.x86/ib.* | zcat | tar -xpf -
%
% cd $iraf/noao/bin.linux               # unpack NOAO bin.linux
% cat /d0/nb.lnux.x86/nb.* | zcat | tar -xpf -
%
% cd $iraf/unix/hlib                    # run the INSTALL script
% source irafuser.csh
% ./install -n
% su
# ./install
# exit
%
% cd
% source .login                         # read new .login
% rehash                                # pick up new iraf commands
% cl                                    # verify that the CL runs

This will fully install IRAF on a server or a standalone system. If this version of IRAF will be accessed via NFS by client nodes then the IRAF install script must be run on each client node as well. Installing IRAF does not allow one to access local tape drives, printers, and so on. Refer to the PC-IRAF Site Manager's Guide for information on how to configure IRAF for the local site.