README FOR HP/UX-IRAF VERSION 2.10 Current patch level V2.10.2 System built on HP/UX 9.0.1 Updated 21 June 93 THE HP HP/UX-IRAF NETWORK DISTRIBUTION This directory and its subdirectories contains the HP/UX-IRAF distribution for HP/Apollo systems. README This file. as.hpux.gen AS.HPUX.GEN (all sources) ib.hpux.hp7 IB.HPUX.HP7 (Series 700 binaries, core system) nb.hpux.hp7 NB.HPUX.HP7 (Series 700 binaries, NOAO packages) ib.hpux.hp3 binaries for Series 300 (none currently) nb.hpux.hp3 binaries for Series 300 (none currently) hpuxiraf.ms.Z HPUX/IRAF installation guide source hpuxiraf.ps.Z HPUX/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 HP/UX-IRAF on a Series 700 or 800 workstation or server you need AS.HPUX.GEN, IB.HPUX.HP7, and NB.HPUX.HP7, plus all the release documentation. As of June 93 we do not have precompiled binaries for other than Series 700 model workstations from HP/Apollo, though we understand that the Series 700 binaries should in all probability work on Series 800 machines of the same major HPUX release. 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 HP/UX 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.hpux.gen o Set the current directory on both the local and remote systems. ftp> cd as.hpux.gen ftp> lcd as.hpux.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 SYS5 (HP/UX) checksums are given. The HP/UX command "sum" will compute the SYS5 checksum of a file. On the HP the command "sum -r" computes the BSD checksums. 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 HP/UX-IRAF Complete instructions for installing and configuring HP/UX-IRAF are given in the HP/UX-IRAF Installation Guide and UNIX/IRAF Site Manager's Guide, compressed Postscript versions of which are given in the files hpuxiraf.ps.Z and unixsmg.ps.Z. On most UNIX systems containing a Postscript printer, a hardcopy version of the manual can be obtained with a command such as % zcat hpuxiraf.ps.Z | lpr [-P] # BSD systems or % zcat < hpuxiraf.ps.Z | lp -d # SysV (HP/UX) 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. X11 SUPPORT A binary for the SAOimage image display server is included with the release and will be installed automatically when the install script is run. Xterm is provided with HP/UX so is not included. More recent versions of these utilities, and additional or alternative X11 support programs may be available from the IRAF network archive (iraf.noao.edu). NOTES -- Random notes added after the distribution was generated. -------------------------------------------------------------------- Date: Thu, 24 Jun 93 11:41:21 -0500 From: turner@bigbang.astro.indiana.edu Another thing for people who have the old hppa version of iraf running on their machines is to make sure they change their .login from : setenv MACH hppa setenv IRAFARCH hppa to : setenv MACH hp700 setenv IRAFARCH hp700 Otherwise you might pick up the old version; I found this out only after I moved to old version and started getting the error message /iraf/bin.hppa/cl.e not found. The new iraf continued to start, but it's an indication that old environment variables are around.