VMS/IRAF Installation and Site Manager's Guide

Nigel Sharp
CCS

National Optical Astronomy Observatories¹
June, 1993

Abstract

This document describes how to install or update the VMS version of the portable IRAF system (Image Reduction and Analysis Facility). Installation instructions as well as procedures for improving performance, minimizing disk and memory usage, configuring the system for the local site, and interfacing local devices are given.

Table of Contents

• 1. Introduction
• 2. Installing VMS/IRAF
  • 2.1. Prepare the root IRAF directory
    • 2.1.1. If updating an existing IRAF installation...
    • 2.1.2. If installing IRAF for the first time...
  • 2.2. Read in the distribution files
    • 2.2.1. Installing from a network distribution
    • 2.2.2. Installing from tape
    • 2.2.3. Merge local revisions back into the new system
  • 2.3. Edit the system configuration files
    • 2.3.1. [IRAF.VMS.HLIB]IRAFUSER.COM
    • 2.3.2. [IRAF.VMS.HLIB]INSTALL.COM
    • 2.3.3. [IRAF.VMS.HLIB.LIBC]IRAF.H
  • 2.4. Complete the initial system configuration
• 3. Testing a Newly Installed or Updated System
  • 3.1. Configuring the IRAF account
• 4. Configuring the IRAF Environment
  • 4.1. [IRAF.VMS.HLIB]ZZSETENV.DEF
  • 4.2. The template LOGIN.CL
• 5. Configuring the Device and Networking Files
  • 5.1. [IRAF.DEV]TAPECAP
  • 5.2. [IRAF.DEV]DEVICES
  • 5.3. The DEVICES.HLP file
  • 5.4. [IRAF.DEV]TERMCAP
  • 5.5. [IRAF.DEV]GRAPHCAP
  • 5.6. [IRAF.DEV]HOSTS, UHOSTS, and IRAFHOSTS
• 6. Vector Graphics and Image Display using X Windows
  • 6.1. Xterm
  • 6.2. SAOimage
• 7. Additional System Configuration Issues
  • 7.1. New networking driver
    • 7.1.1. DECNET networking
    • 7.1.2. Proxy logins
    • 7.1.3. Configuring a VMS host as a TCP/IP server
    • 7.1.4. Network security alarms
  • 7.2. New magtape driver
    • 7.2.1. Allocation
    • 7.2.2. Density
    • 7.2.3. Status output logging
    • 7.2.4. Using tape drives over the network
  • 7.3. Configuring user accounts for IRAF
  • 7.4. VMS quotas and privileges required to run IRAF
  • 7.5. Interfacing new graphics devices
    • 7.5.1. Graphics terminals
    • 7.5.2. Graphics plotters
    • 7.5.3. Image display devices
• 8. Tuning Considerations
  • 8.1. Stripping the system to reduce disk consumption
  • 8.2. Installing executable images
  • 8.3. Rendering large runtime files contiguous
  • 8.4. Precompiling TERMCAP and GRAPHCAP entries
• 9. Software Management
  • 9.1. Shared libraries
  • 9.2. Layered software support
  • 9.3. Software management tools
  • 9.4. Modifying and updating a package
  • 9.5. Installing and maintaining layered software
  • 9.6. Configuring a custom LOCAL package
  • 9.7. Updating the full IRAF system
    • 9.7.1. The BOOTSTRAP
    • 9.7.2. Updating the system libraries
    • 9.7.3. Relinking the IRAF shared library
    • 9.7.4. Relinking the main IRAF system
• 10. Miscellaneous Notes
• Appendix A. Private TMP and IMDIR Directories

A PostScript version of this Installation Guide is available from the IRAF FTP archives.

¹NOAO is operated by the Association of Universities for Research in Astronomy, Inc. under cooperative agreement with the National Science Foundation.