diff options
Diffstat (limited to 'pkg/proto/vol/README.install')
| -rw-r--r-- | pkg/proto/vol/README.install | 107 |
1 files changed, 107 insertions, 0 deletions
diff --git a/pkg/proto/vol/README.install b/pkg/proto/vol/README.install new file mode 100644 index 00000000..c3f23147 --- /dev/null +++ b/pkg/proto/vol/README.install @@ -0,0 +1,107 @@ + + Installation Instructions for the VOL Addon Package + +The volume-images package, VOL, is being distributed separately +from the IRAF V2.8 distribution. This package is being made available for +user testing on a user-beware basis. The installation instructions +that follow assume that you have copied the tar format VOL archive onto +your host machine. The method you use to copy the file (or remotely access +the tar file) is OS dependent and is not discussed in this document. If your +IRAF system has been stripped of the IRAF libraries ('mkpkg stripall') you +will not be able to build the VOL executable as described here. You must +either reload the required libraries or request a binary distribution +of VOL for your operating system. If you have any questions, please send +electronic mail to the IRAF project at + +Internet (ARPAnet, MILnet, NSFnet, etc.) iraf@noao.edu +BITnet iraf@noao.edu * +SPAN/HEPnet (DECnet) noao::iraf or 5355::iraf +UUCP/Usenet {arizona,decvax,ncar}!noao!iraf + uunet!noao.edu!iraf +* = through a user-specified gateway + + [IRAF Hotline: (602) 323-4160] + +For discussion of algorithms or ongoing bug fixes etc., contact the author, +Steve Rooke, at 602-325-9399 (or rooke@noao.edu or 5355::rooke). + +This package is being distributed as an external package making use of the +layered software enhancements in IRAF V2.8. + +[1] This discussion assumes you intend to install VOL as an independent + external layered package. You may choose to merge it into your custom + "local" package instead, but would need to edit several files not + discussed herein. + +[2] Log into the CL from the IRAF installation account. This insures you + have the proper permissions and the files will have the proper owner. + + Create a directory for vol, preferably external to the IRAF directory + tree to simplify future IRAF updates, then set an IRAF environment + variable to point to it. + + UNIX example: + cl> reset vol /local/iraftest/vol/ + VMS example: + cl> reset vol usr\$1:[localiraf.vol] + +[3] Change directory to vol and unpack the tar archive. You must + load the softools package before executing rtar. Note that the <ARCHIVE> + name must be given with the appropriate path name at the host OS level, + or may be specified as a tape device if that is how you received the + package. + + cl> cd vol + cl> softools + so> rtar -xrf <ARCHIVE> # Read the archive + so> cd vol # Change to VOL subdirectory + +[4] When the archive has been unpacked, build the VOL package executable: + + 1) Delete any bin directory symbolic links you find + 2) Create a directory called bin.ARCH where ARCH is something + like "f68881", "ffpa", "sparc", or "vax"; see your IRAF + installation guide. + 3) Then issue the following commands: + + so> mkpkg ARCH + so> mkpkg -p vol update >& spool & + + The first command sets the bin directory to be properly configured + and the second recompiles the package. For Sun multiple architecture + support, please refer to the "Sun/IRAF Site Manager's Guide". + +[5] The spool file(s) should be reviewed upon completion to make sure + there were no errors. When you are confident the installation was + successful, delete the spool file (and the archive file if you wish). + +[6] Still logged in as iraf, edit the one file in the core iraf system + that is necessary to install an external layered package: + + so> cd hlib + so> edit extern.pkg + + UNIX example, leaving out other external packages: + reset vol = /local/iraftest/vol/ + task vol.pkg = vol$vol.cl + + reset helpdb = "lib$helpdb.mip\ + [ ... other packages ... ] + ,vol$lib/helpdb.mip\ + " + VMS example, leaving out other external packages: + reset vol = usr\$2:[localiraf.vol] + task vol.pkg = vol$vol.cl + + reset helpdb = "lib$helpdb.mip\ + ,vol$lib/helpdb.mip\ + " + +[7] Finally, build the help database. Still logged in as iraf: + + so> mkhelpdb vol$lib/root.hd vol$lib/helpdb.mip + +That's it ... you should be ready to go. If you have any questions or +problems, please do not hesitate to send email to iraf@noao.edu or call the +IRAF HOTLINE at 602-323-4160 or the author at 602-325-9399. + |