% cd $iraf* % tar -cf /scr0/oiraf.tar local dev unix/hlib % /bin/rm -rf *There are many possible variations on this, e.g., you could use mv to move the above directories to someplace outside the main IRAF directory tree. Although it is probably simplest and safest to save entire directories as in the example, in practice only a few files are likely to have been modified. These are the following.
dev/graphcap dev/hosts dev/tapecap* dev/termcap hlib/extern.pkg hlib/login.cl hlib/zzsetenv.def local/.loginIn the case where you will be installing V2.11 Sun/IRAF to replace existing SunOS and Solaris IRAF systems it will be necessary to save these files from both systems so they can be merged in the final configuration. If updating an existing V2.11 installation remember to save all the tapecap files.
Once the old system (or systems) has been deleted you are ready to install the new one, as described in §2.2. It is important to delete the old system first to avoid creating junk files or directories when the new system is installed (due to file or directory name changes or deletions). Once the new system has been restored to disk, do not merely restore the files saved above, as you will need to carefully merge local changes into the versions of the files supplied with the new IRAF release (more on this later).
*$iraf symbolizes the UNIX pathname of the root IRAF directory. If no "iraf" environment variable is defined just supply the actual pathname.
iraf'. This is necessary for IRAF
system management, which should always be done from the IRAF account. The
IRAF account has custom login files which set up a standard UNIX environment
for IRAF system management. Having an IRAF account provides a convenient
place (the IRAF system manager's login directory) to keep scratch files
created during system configuration, and since it has a standard environment
it not only simplifies routine maintanence but provides a baseline for
performance when problems are encountered.The location of the IRAF root directory is arbitrary. Our practice here is to locate the software in a system file storage area separate from the rest of the operating system files (to simplify OS upgrades), and then use a symbolic link such as /iraf to point to the actual root directory. This makes life simpler if IRAF is NFS mounted on several machines and it is later necessary to move the IRAF files. Try to keep the path to the physical IRAF root directory short to avoid filename truncation problems when IRAF is run.
The login directory for the IRAF account should be $iraf/local (e.g., /iraf/iraf/local), rather than the IRAF root directory $iraf as one might expect. This is done to provide a work area for local files separate from the main IRAF directory tree, to simplify updates and make it easier to keep track of what has been locally added and what is standard IRAF. In any case, make sure that when the IRAF account is set up the login directory is set correctly, or the IRAF environment will not be set up properly and later problems are sure to result.
A typical IRAF installation consists of the main IRAF release, a number of BIN directories (the IRAF binaries), and additional directories for layered software such as STSDAS, PROS, and so on. If sufficient disk space is available to keep everything in one area the following directory structure is recommended.
/iraf/iraf # iraf root directory ($iraf)
/iraf/iraf/local # iraf login directory (~iraf)
/iraf/irafbin # iraf BIN directories
/iraf/irafbin/bin.sparc # SunOS binaries iraf core system
/iraf/irafbin/noao.bin.sparc # SunOS binaries NOAO package
/iraf/irafbin/bin.ssun # Solaris binaries iraf core system
/iraf/irafbin/noao.bin.ssun # Solaris binaries NOAO package
/iraf/extern # external package directory
/iraf/extern/stsdas # external layered package
/iraf/extern/xray # external layered package
(etc.)
For the purposes of this example we assume that the IRAF files are stored in
/iraf; as we say this might be a link and the actual directory is
arbitrary. Given this directory the IRAF root $iraf would be
"/iraf/iraf/" and the login directory for the IRAF account would be
/iraf/iraf/local. The e.g.
Solaris binaries for the core IRAF system would be in /iraf/irafbin/bin.ssun,
with a link $iraf/bin.ssun pointing to this directory (more on this
later).
Given the above directory structure the /etc/passwd file entry for the
IRAF account would be something like the following.
iraf:*:123:12:IRAF system login:/iraf/iraf/local:/bin/csh