Compaq KAP Fortran/OpenMP for_Tru64_UNIX________________________________ Installation Guide Order Number: AA-QMB4F-TE September 1999 This document contains instructions for installing Compaq KAP Fortran/OpenMP on Compaq Tru64 UNIX (formerly DIGITAL UNIX) systems. Revision/Update Information: This is a revised document. Operating System and Version: Compaq Tru64 UNIX Versions 4.0F and 5.0 DIGITAL UNIX Versions 4.0D and 4.0E Software Version: Version 4.2 Compaq Fortran Version 5.2 Compaq Computer Corporation Maynard, Massachusetts __________________________________________________________ First Printing, October 1995 Revised, September 1999 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq or an authorized sublicensor. Compaq Computer Corporation makes no representations that the use of its products in the manner described in this publication will not infringe on existing or future patent rights, nor do the descriptions contained in this publication imply the granting of licenses to make, use, or sell equipment or software in accordance with the description. © Digital Equipment Corporation 1995 - 1999. All rights reserved. © Kuck & Associates, Inc. 1995 - 1999. All rights reserved. Compaq, the Compaq logo, AlphaGeneration, Compaq C, Compaq Fortran, DIGITAL, and VAX DOCUMENT are registered in the U.S. Patent and Trademark Office. DECthreads is a trademark of Compaq Computer Corporation. KAP is a trademark of Kuck & Associates, Inc. POSIX is a registered trademark of IEEE. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. Other product names mentioned herein may be the trademarks of their respective companies. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing to Install Compaq KAP Fortran/OpenMP 1.1 Registering the License...................... 1-1 1.2 Checking the Media Software Distribution Kit.......................................... 1-2 1.3 Understanding Installation Procedure Requirements................................. 1-2 1.3.1 Login Privileges......................... 1-3 1.3.2 Hardware Requirements.................... 1-3 1.3.3 Software Requirements.................... 1-3 1.3.3.1 Parallel Libraries..................... 1-4 1.3.4 Disk Space Requirements.................. 1-4 1.4 Backing Up Your System Disk.................. 1-6 1.5 Stopping the Installation.................... 1-7 1.6 Recovering from Errors....................... 1-7 2 Installing Compaq KAP Fortran/OpenMP 2.1 Installing Compaq KAP Fortran/OpenMP......... 2-1 2.1.1 Starting the Installation Procedure...... 2-1 2.1.2 Responding to Installation Procedure Prompts.................................. 2-2 2.1.2.1 Loading the KF9BASE420 Kit............. 2-2 2.1.2.2 Monitoring Displays During the Subset Loading Process........................ 2-2 iii 3 Completing the Installation A Files Installed on Your System B Sample Installation Index Tables 1-1 KAP Subset Sizes with Tru64 UNIX......... 1-5 A-1 Installed Compaq KAP Fortran/OpenMP Files.................................... A-1 iv ________________________________________________________________ Preface This manual describes how to install Compaq KAP Fortran /OpenMP on processors running the Compaq Tru64 UNIX (formerly DIGITAL UNIX) operating system. For information about the compatibility of other software products with this version of KAP, refer to the Software Product Description (SPD). You can use the SPD to verify which versions of your operating system are compatible with this version of KAP. Intended Audience This manual is intended for a system manager who installs Compaq KAP Fortran/OpenMP on a Tru64 UNIX system. Structure of This Document This manual includes three chapters and two appendixes: o Chapter 1 describes the operating system and hardware requirements for a Compaq KAP Fortran/OpenMP installa- tion and related procedures that you complete before installing KAP. o Chapter 2 describes the Compaq KAP Fortran/OpenMP installation procedure. o Chapter 3 describes the Installation Verification Procedure (IVP) and any postinstallation procedures that you must complete before you use KAP. o Appendix A describes the hierarchy and contents of KAP directories. o Appendix B contains a log for a KAP installation. v Associated Documents Please read the cover letter and release notes before installing the software, in case important information missing from this document has been added to these documents. The documentation for Compaq KAP Fortran/OpenMP also includes the following: o Compaq KAP Fortran/OpenMP for Tru64 UNIX User Guide o Compaq KAP Fortran/OpenMP for Tru64 UNIX Cover Letter For general information about installing software, refer to your Tru64 UNIX installation guide. Conventions The following conventions are used in this guide: __________________________________________________________ Convention_______Description______________________________ UPPERCASE and The Tru64 UNIX system differentiates lowercase between lowercase and uppercase characters. Literal strings that appear in text, examples, syntax descriptions, and function descriptions must be typed exactly as shown. user input This bold typeface is used in interactive examples to indicate typed user input. # A number sign is the default superuser _________________prompt.__________________________________ vi 1 ________________________________________________________________ Preparing to Install Compaq KAP Fortran/OpenMP This chapter describes the preparations and requirements for installing Compaq KAP Fortran/OpenMP on Tru64 UNIX systems. Your bill of materials (BOM) and indented bills report (BIL) specify the contents of your kit. If your kit is damaged or if you find that parts of it are missing, contact your Compaq representative. Before starting the installation procedure described in Chapter 2, complete the preparations outlined in this chapter. You need to know about installation options and information related to the installation procedure. 1.1 Registering the License The Compaq KAP Fortran/OpenMP software supports the Tru64 UNIX License Management Facility (LMF). A License Product Authorization Key (License PAK) must be registered in the License Database (LDB) to use Compaq KAP Fortran/OpenMP. The License PAK may be shipped along with the kit if you ordered the license and media together; otherwise, it is shipped separately to a location based on your license order. To register a license under Tru64 UNIX, first log in as superuser. You can then perform the PAK registration in either of these two ways: o If you have the license PAK on paper, enter the following commands at the superuser prompt: # /usr/sbin/lmf register - This register command brings you into edit (vi) mode. Preparing to Install Compaq KAP Fortran/OpenMP 1-1 - Using regular vi edit commands, enter all the information on your License PAK. If you are not familiar with vi, please see the vi reference page (> man vi). - Exit the vi editor. # /usr/sbin/lmf reset - This reset command copies the license information from the LDB to the dynamic kernel LMF database. # exit o If you have the license PAK in the form of a csh command script (in PAK_file), enter the following commands at the superuser prompt: # /usr/sbin/lmf register - < PAK_file # exit Compaq KAP Fortran/OpenMP accepts licenses associated with the following lmf names: KAP-FORTRAN Capacity KAP-FORTRAN-USER Concurrent Use KAP-F90 Capacity KAP-F90-USER Concurrent Use For complete information about using the Tru64 UNIX LMF, see Compaq Tru64 UNIX Software License Management (Tru64 UNIX, and DIGITAL UNIX Version 4.0 and above) or the lmf(8) reference page. 1.2 Checking the Media Software Distribution Kit The kit includes a CD-ROM optical disk. 1.3 Understanding Installation Procedure Requirements The following sections describe various requirements for installing Compaq KAP Fortran/OpenMP. Installing Compaq KAP Fortran/OpenMP and Compaq KAP Fortran/OpenMP reference pages, and running the Installation Verification Procedure (IVP) on a standalone system takes about 2 minutes. 1-2 Preparing to Install Compaq KAP Fortran/OpenMP 1.3.1 Login Privileges You must be able to log in as superuser on the system where you are installing Compaq KAP Fortran/OpenMP. Only when you are logged in as superuser do you have sufficient privileges to install the Compaq KAP Fortran/OpenMP software. 1.3.2 Hardware Requirements For a complete list of supported processors, see the SPD. Installing Compaq KAP Fortran/OpenMP requires at least 9.0 megabytes of disk storage space on your system. To perform the installation, you need the following hardware: o Software distribution device (if installing from media) A CD-ROM software kit. The documentation for the CD-ROM drive that you are using explains how to load media. o Terminal You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure for Compaq KAP Fortran/OpenMP. 1.3.3 Software Requirements You must install the following software before you install Compaq KAP Fortran/OpenMP, Version 4.2, for Tru64 UNIX Versions 4.0F and 5.0, and DIGITAL UNIX Versions 4.0D and 4.0E: o Tru64 UNIX Alpha Base System The required subset is OSFBASExxx, which is named "Base System." o Compaq Fortran, Version 5.2 The required subset is DFABASE520. o Compaq Fortran Run-Time Library The required subset is DFARTL385. o OSFMANOPxxx Preparing to Install Compaq KAP Fortran/OpenMP 1-3 This subset is named "On Line Manual Pages." o OSFDCMTxxx This subset is named "Document Preparation Software." o CMPDEVENH subset (Development Enhancements for DIGITAL UNIX) from the DIGITAL UNIX 4.* operating system CD- ROM. This subset is required only if you are using DIGITAL UNIX 4.0* and you want to use the -non_shared linker switch to link your application to the DECthreads archive library. When you have installed the previous software, you can then install the Compaq KAP Fortran/OpenMP software, which consists of the KF9BASE420 subset. The SPD contains a complete list of prerequisite software and required version numbers. 1.3.3.1 Parallel Libraries Version 4.2 of Compaq KAP Fortran/OpenMP lets you optionally use a parallel runtime library. Use the what command to determine the version of the parallel library: For libkmp_osfp10.a: what /usr/opt/kf9BASE420/libkmp_osfp10.a This command returns the KAP version: Version BL31.1_posix_10 1.3.4 Disk Space Requirements The disk space requirements discussed in this section apply to the disks where you load the Compaq KAP Fortran/OpenMP subset. Table 1-1 lists the disk space requirements for loading Compaq KAP Fortran/OpenMP software subsets for Tru64 UNIX systems. The Compaq KAP Fortran/OpenMP installation procedure loads files into the following directories: 1-4 Preparing to Install Compaq KAP Fortran/OpenMP /usr/opt /usr/bin /usr/man/man1 /usr/lib Table_1-1_KAP_Subset_Sizes_with_Tru64_UNIX________________ Subset Name_______/usr/opt__/usr/bin__/usr/man/man1______________ KF9BASE420_25_MB_____50_bytes__50_bytes___________________ Compare the space required for subsets with the free space currently on the disks where Compaq KAP Fortran/OpenMP files will reside. To determine the current amount of free space for a directory path, log in to the system where you plan to install Compaq KAP Fortran/OpenMP. You can check which file systems are mounted, and where they are, by displaying the file /etc/fstab. For example: # more /etc/fstab /dev/rz0a / ufs rw 1 1 /dev/rz0g /usr ufs rw 1 2 /dev/rz0b swap1 ufs rw 0 2 /dev/rz1c swap2 ufs sw 0 2 /dev/rz0f /usr/users ufs rw 1 2 The previous display indicates that /usr (mounted to /dev /rz0g ) is the only mount point that affects where Compaq KAP Fortran/OpenMP files will reside; the system has only one local disk drive and the /usr/opt file system resides in the g partition of the disk on that drive. Enter the df command to determine total space and free space for the one or two file systems where Compaq KAP Fortran/OpenMP files will reside. Based on the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you would only need to inspect free space in the /usr file system: Preparing to Install Compaq KAP Fortran/OpenMP 1-5 # df /usr Filesystem Total blks blks % node 512-blks used free used Mounted on /dev/rz0g 793406 624892 89172 88% /usr The previous display indicates that there are 89172 blocks (512 bytes per block) free. This free space accommodates the subset requirements listed in Table 1-1 for the /usr /opt file system. On systems where /usr/opt is mounted to different devices from /usr, enter the following command: # df /usr/opt In this case, you compare space required for Compaq KAP Fortran/OpenMP files in /usr/opt to the free space displayed in the output list. If you find that there is insufficient disk space for the Compaq KAP Fortran/OpenMP subsets, and know that you have additional space on alternative disks or disk partitions for your system, you can take the following steps before installation: 1. Log in as superuser. 2. Specify in the /etc/fstab file that one or more of the newly created directories are mount points to new disk partitions where there is additional space. 3. Enter the mount -a command so that the new mount points take effect. 1.4 Backing Up Your System Disk Compaq recommends that you back up your system disk before installing any software. Use the backup procedures established at your site. For details about performing a system disk backup, see your Tru64 UNIX documentation. 1-6 Preparing to Install Compaq KAP Fortran/OpenMP 1.5 Stopping the Installation You can stop the installation procedure at any time by pressing Ctrl/C. However, files created up to that point are not deleted. You must delete these files interactively. Appendix A lists the files and directories created during the installation procedure. 1.6 Recovering from Errors If errors occur during the installation, the system displays failure messages. If the installation fails due to insufficient disk space, the installation procedure displays the following message: There is not enough file system space for subset KF9BASE420. KF9BASE420 will not be loaded. If any of the following conditions exist, errors can occur during the installation: o The operating system version is incorrect. o The prerequisite software version is incorrect. o The system parameter values for successful installation are insufficient. For descriptions of error messages generated by these conditions, see the Tru64 UNIX documentation on system messages, recovery procedures, and Tru64 UNIX software installation. If you are notified that any of these conditions exist, take the appropriate action described in the message. For information about software requirements, see Section 1.3.3. Preparing to Install Compaq KAP Fortran/OpenMP 1-7 2 ________________________________________________________________ Installing Compaq KAP Fortran/OpenMP This chapter describes the procedures for installing Compaq KAP Fortran/OpenMP on a Tru64 UNIX system. 2.1 Installing Compaq KAP Fortran/OpenMP This section explains how to start an installation procedure directly from the CD-ROM and how to respond to installation procedure prompts. 2.1.1 Starting the Installation Procedure Start the KAP installation procedure from CD-ROM as follows: 1. Mount the media on the appropriate drive. 2. Log in as superuser (the login name is root) to the system where you are installing Compaq KAP Fortran /OpenMP. 3. Make sure that you are at the root ( / ) directory by entering the following command: # cd / 4. Specify the /mnt directory to be the mount point for the distribution file system on the drive. If your CD-ROM drive is rz4, enter the following command: # /usr/sbin/mount -r /dev/rz4 /mnt Do not give this command from /mnt. 5. Confirm that the KAP software is accessible: # ls -ld /mnt/k* 6. Enter a setld command that requests the load function and identifies the directory in the mounted file system where Compaq KAP Fortran/OpenMP subsets are located. Installing Compaq KAP Fortran/OpenMP 2-1 For Tru64 UNIX, the directory location for the KAP subsets is /mnt/kf9420. For example, if you load Compaq KAP Fortran/OpenMP subsets onto a Tru64 UNIX system, enter the following command: # /usr/sbin/setld -l /mnt/kf9420/kit KF9BASE420 2.1.2 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2.1.2.1 Loading the KF9BASE420 Kit After you enter the setld command, the installation procedure displays the following message: Checking file system space required to install specified subsets: When the file system space checks okay, the KF9BASE420 kit begins to load, and the system displays a series of messages described in Section 2.1.2.2. 2.1.2.2 Monitoring Displays During the Subset Loading Process Among the displayed messages, you are notified that KAP is a licensed product: This product is REGISTERED LICENSED SOFTWARE. Product: KAP FORTRAN/OpenMP Producer: KUCK Version: 4.2 Issuer: DEC The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. You are then asked if the KAP License PAK is registered. Enter y if your License PAK is registered. Is the PAK registered and loaded? [y/n] y After you respond to the registration question, the Installation Verification Procedure begins and displays the following information: 2-2 Installing Compaq KAP Fortran/OpenMP Installation Verification Procedure (IVP) KAP Fortran/OpenMP V4.2 for Tru64 UNIX Copyright (c) Kuck and Associates, Inc. 1995, 1999. All rights reserved. KAP Fortran/OpenMP IVP passed Optimization Compilation test KAP Fortran/OpenMP IVP passed Object Execution Test KAP Fortran/OpenMP IVP executed correctly The installation ends with the following messages: The release notes are in /usr/opt/KF9BASE420/KF9420_release_note.txt. KAP Fortran/OpenMP V4.2 is properly installed. If you encounter errors during the installation, see the Diagnostics section of the setld(8) reference page for an explanation of the error and the appropriate action to take. If the verification process fails, you can look in the file /usr/var/adm/fverify to find information that can help you diagnose the problem. After you correct the installation problem, use the following command to delete the KAP subset before you reinstall the product: # /usr/sbin/setld -d KF9BASE420 Installing Compaq KAP Fortran/OpenMP 2-3 3 ________________________________________________________________ Completing the Installation At any time after installing Compaq KAP Fortran/OpenMP, you can run the Installation Verification Procedure (IVP) to verify that the software is available on your system. You may also want to run the IVP after a system failure to be sure that users can access Compaq KAP Fortran/OpenMP. To run the IVP after an installation, enter the following command: # /usr/sbin/setld -v KF9BASE420 When the IVP runs successfully, the system displays the following: KAP Fortran/OpenMP IVP passed Optimization Compilation test KAP Fortran/OpenMP IVP passed Object Execution Test KAP Fortran/OpenMP IVP executed correctly Completing the Installation 3-1 A ________________________________________________________________ Files Installed on Your System Table A-1 lists the files on your system after you install Compaq KAP. Table_A-1_Installed_Compaq_KAP_Fortran/OpenMP_Files_______ Directory________File______________Description____________ /usr/opt KF9420_release_ Release notes in text /KF9BASE420 note.txt /usr/opt ivp.csh IVP C-shell /KF9BASE420 /usr/opt kapf90 KAPF90 binary /KF9BASE420 /usr/opt kapf90.1 KAPF90 reference pages /KF9BASE420 /usr/opt kapf KAPF binary /KF9BASE420 /usr/opt kapf.1 KAPF reference pages /KF9BASE420 /usr/opt kapfivpin.f IVP source file /KF9BASE420 /usr/opt kapfivpin.kmp IVP file /KF9BASE420 /usr/opt kapfivpin.kut IVP file /KF9BASE420 /usr/opt kapfivpver.lis IVP KAP version /KF9BASE420 /usr/opt kf90 KAP F90 driver binary /KF9BASE420 /usr/opt kf90.1 KAP F90 driver /KF9BASE420 reference pages (continued on next page) Files Installed on Your System A-1 Table A-1 (Cont.) Installed Compaq KAP Fortran/OpenMP __________________Files___________________________________ Directory________File______________Description____________ /usr/opt kf77 KAPF77 driver binary /KF9BASE420 /usr/opt kf77.1 KAPF77 driver reference /KF9BASE420 pages /usr/opt libkmp_osfp10.a Kuck & Associates /KF9BASE420 parallel runtime library /usr/bin kapf90 Links /usr/bin kf90 Links /usr/bin kapf Links /usr/bin kf77 Links /usr/man/man1 kapf90.1 Links /usr/man/man1 kf90.1 Links /usr/man/man1 kapf.1 Links /usr/man/man1____kf77.1____________Links__________________ A-2 Files Installed on Your System B ________________________________________________________________ Sample Installation This appendix contains a log of a complete installation of the Compaq KAP Fortran/OpenMP for Tru64 UNIX Kit. Your installation may differ from this example because you can make different choices during the procedure. # setld -l output KF9BASE420 Checking file system space required to install specified subsets: File system space checked OK. 1 subset(s) will be installed. Loading 1 of 1 subset(s).... The installation of KF9BASE420 takes approximately 2 minutes, depending on your type of media and your system configuration. Begin Loading KAP Fortran/OpenMP V4.2 Copyright (c) Kuck and Associates, Inc. 1995, 1999. All rights reserved. Restricted Rights: Use, duplication, or disclosure by the U.S. Government is subject to restrictions as set forth in subparagraph (c)(1)(ii of DFARS 252.227-7013, or in FAR 52.227-19, or in FAR 52.227-14 Alt. III., as applicable. This software is proprietary to and embodies the confidential technology of Kuck and Associates, Inc. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. KAP Fortran/OpenMP for Tru64 UNIX Copying from output (disk) Verifying 1 of 1 subset(s) installed successfully. Sample Installation B-1 Configuring "KAP Fortran/OpenMP for Tru64 UNIX" (KF9BASE420) This product is REGISTERED LICENSED SOFTWARE. Product: KAP FORTRAN/OpenMP Producer: KUCK Version: 4.2 Issuer: DEC The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. Is the PAK registered and loaded?[y/n] (n) y Installation Verification Procedure (IVP) KAP Fortran/OpenMP V4.2 for Tru64 UNIX Copyright (c) Kuck and Associates, Inc. 1995, 1999. All rights reserved. KAP Fortran/OpenMP IVP passed Optimization Compilation test KAP Fortran/OpenMP IVP passed Object Execution Test KAP Fortran/OpenMP IVP executed correctly The release notes are in /usr/opt/KF9BASE420/KF9420_release_note.txt. KAP Fortran/OpenMP V4.2 is properly installed. B-2 Sample Installation ________________________________________________________________ Index B storage, 1-3 ___________________________ Installation guide Backing up your system, associated documents, vi 1-6 conventions, vi structure, v D__________________________ IVP, 3-1 Disk space requirements, L__________________________ 1-4 License Management Facility increasing, 1-6 (LMF), 1-1 E__________________________ P Error recovery, 1-7 ___________________________ Parallel libraries, 1-4 H Privileges ___________________________ checking login, 1-3 Hardware required for installation S__________________________ , 1-3 Software requirements, 1-3 I Stopping installation, 1-7 ___________________________ Storage required for Installation installation, 1-3 sample, B-1 stopping, 1-7 Index-1