EUV Installation and Maintenance Guide EUV Revision: 1.9 Center for EUV Astrophysics 1/31/00 Introduction The installation and maintenance of the EUV layered package is relatively simple. For the most part, this package is just like any other IRAF layered package. There are a few EUV- specific installation requirements, which will be mentioned below. Versions and Dependencies This EUV package version requires an IRAF version 2.11.3 or higher. For additional details about installing IRAF see the "IRAF Installation and Maintenance Guide" for your host operating system. Using the latest possible version of IRAF is always a good idea. The EUV package also requires the TABLES package from STScI. Be sure that you have installed at least TABLES v2.1.1. This EUV package version has been tested and should work with TABLES v2.1.1 under IRAF 2.11.3. For additional details about installing TABLES see "TABLES Package Installation Procedures" for your host operating system. VAX/VMS users of the TABLES package may want to consider compiling that code with the FORTRAN optimizer off. Optimizer problems have been reported with Version 6 of the FORTRAN compiler. (Version 5 seems to be OK). To recompile, you should delete and remake all object libraries in TABLES with the optimizer off, which can be done by including the following lines in mkpkg.inc for IRAF (which is in hlib): $set XFLAGS = "-c -q" # default XC compile flags $set XVFLAGS = "-c -q" # default XC compile flags for VOPS It would be a good idea to compile the EUV package without optimization, also. The EUV package is well-suited for use alongside the PROS package of X-ray analysis software from SAO. PROS contains several tasks for analysis of event data which are highly useful with EUVE data sets. However, PROS is not required in order to build the EUV package. The EUV package is designed to be portable within the IRAF environment. However, some photon list manipulations require large amounts of disk space. The performance of this software is dependent on the throughput of the underlying hardware. This release of the EUV package has been tested at CEA under SunOS and Solaris IRAF 2.11.3. These instructions use Unix(tm) specific examples when necessary. Most of the installation occurs inside of the IRAF environment -- so there are only a few Operating System specific examples. These instructions also assume that IRAF is up and running on your system. For explanations about IRAF installation and environment variables see the IRAF online help pages. These instructions also assume that TABLES has been installed. If you have setup an IRAF user account, you must use that account to do this installation, since some system files need to be modified. The EUV directory Like other IRAF layered packages the EUV package requires a single directory tree for itself. The top level of this directory tree can be allocated most anywhere. We suggest installing EUV as a separate directory tree. This will simplify updates and other package installations. Ideally the absolute path to this directory should be short. Extern.pkg modifications The entire package depends on three IRAF environment variables that are set in the file hlib$extern.pkg. These variables are euv, euv.pkg, and helpdb. For VMS installations, the IRAF file hlib$irafuser.com must also be modified. Unix instructions Unix requires the modification of only the hlib$extern.pkg file. To edit this file, change your default directory to hlib and edit the file extern.pkg: cl> cd hlib cl> edit extern.pkg Assuming that you have chosen the directory iraf$euv as the top level directory for the EUV package, add the following lines to the end of extern.pkg: reset euv = iraf$euv/ task euv.pkg = euv$euv.cl Note the use of the trailing '/' in the pathname. In addition, you must add the EUV package to the helpdb definition. For example: reset helpdb = "lib$helpdb.mip ,noao$lib/helpdb.mip ,local$lib/helpdb.mip ,euv$lib/helpdb.mip " Source Code Installation Use the rtar task to read the EUV distribution tape. To read from a tape: cl> softools so> cd euv so> allocate mtX ! X = a, b, ... so> rtar -xtvf mtX so> deallocate mtX To read from a tar file, called /tmp/euv/euv.tar, use: cl> softools so> cd euv so> rtar -xtvf /tmp/euv/euv.tar Building EUV Use the following to configure IRAF to compile the EUV package. Note that we use the 'sparc' architecture for SunOS systems. Change this to ssun for Solaris, linux for Linux, or to whatever is appropriate for your IRAF platform. cl> softools so> cd tables so> tables ta> mkpkg -p tables sparc ta> cd euv eu> euv eu> mkdir bin.sparc eu> mkpkg -p euv sparc Note that the mkdir command will generate a message if the directory already exists. You can ignore this message. This completes the Operating System specific portion of the installation. Use the following to actually build the package. eu> mkpkg -p euv >& spool & This will run the mkpkg task as a background process and put all output and errors into the euv$spool file. To get a summary of the results try: eu> mkpkg -p euv summary Help Database Making the help database is straight forward. Simply use the following: cl> softools so> euv so> mkhelpdb helpdir=euv$lib/root.hd helpdb=euv$lib/helpdb.mip Test the installation No test data is currently provided with the EUV package. Stripping the EUV package Stripping removes the EUV source code. You may want to do this after installing EUV for all machine architectures. Strip EUV as follows: cl> softools so> cd euv so> mkpkg -p euv strip EUV package structure The EUV package has a simple directory hierarchy that is commonly used in layered packages. euv bin # Machine dependent binaries doc # Documentation directory lib # Common library routines src # Package source code Package Distribution The latest version of the EUV package is always available at ftp.cea.berkeley.edu in /pub/software.