KAP Fortran 90 for_Digital_UNIX______________________________ Installation Guide Order Number: AA-QMB4C-TE December 1996 This document contains instructions for installing KAP Fortran 90 on Digital UNIX systems. Revision/Update Information: This is a revised document. Operating System and Version: Digital UNIX, Versions 3.2 and 4.0b Software Version: KAP Fortran 90, Version 3.1 Digital Equipment Corporation Maynard, Massachusetts __________________________________________________________ First Printing, October 1995 Revised, December 1996 Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. Digital Equipment 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, 1996. All rights reserved. © Kuck & Associates, Inc. 1995, 1996. All rights reserved. The following are trademarks of Digital Equipment Corporation: AlphaGeneration, DECthreads, Digital, VAX DOCUMENT, and the DIGITAL logo. KAP is a trademark of Kuck & Associates, Inc. UNIX is a registered trademark in the United States and other countries licensed exclusively through X/Open Company Ltd. All other trademarks and registered trademarks are the property of their respective holders. This document is available on CD-ROM. This document was prepared using VAX DOCUMENT Version 2.1. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing to Install KAP Fortran 90 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-2 1.3.2 Hardware Requirements.................... 1-2 1.3.3 Software Requirements.................... 1-3 1.3.3.2 Parallel Libraries Identical for all KAP Products........................... 1-4 1.3.4 Disk Space Requirements.................. 1-5 1.4 Backing Up Your System Disk.................. 1-6 1.5 Stopping the Installation.................... 1-7 1.6 Recovering from Errors....................... 1-7 1.7 Building Images with the Archive DECthreads Library...................................... 1-8 2 Installing KAP Fortran 90 2.1 Installing KAP Fortran 90.................... 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 KF9 Kit.................... 2-2 2.1.2.2 Monitoring Displays During the Subset Loading Process........................ 2-2 iii 3 Completing the Installation 3.1 Building Applications with the DECthreads Archive Library on Digital UNIX Versions 4.0 and Higher................................... 3-1 A Files Installed on Your System B Sample Installation Index Tables 1-1 KAP Version 3.1 Parallel Processing Libraries................................ 1-4 1-2 KAP Subset Sizes with Digital UNIX....... 1-5 A-1 Installed KAP Fortran 90 Files........... A-1 iv ________________________________________________________________ Preface This manual describes how to install KAP for Fortran 90 on processors running the 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. The name of the DEC OSF/1 Alpha operating system has been changed to Digital UNIX. All references to DEC OSF/1 Alpha refer to the Digital UNIX operating system. Intended Audience This manual is intended for a system manager who installs KAP Fortran 90 on a Digital 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 KAP Fortran 90 installation and related procedures that you complete before installing KAP. o Chapter 2 describes the KAP Fortran 90 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. v o Appendix B contains a log for a KAP installation. 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 KAP Fortran 90 also includes the following: o KAP Fortran 90 for Digital UNIX User Guide o KAP Fortran 90 for Digital UNIX Quick Reference For general information about installing software, refer to the following manual: o Guide to Installing DEC OSF/1 Alpha Conventions The following conventions are used in this guide: __________________________________________________________ Convention_______Description______________________________ UPPERCASE and The Digital 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 KAP Fortran 90 This chapter describes the preparations and requirements for installing KAP. 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 Digital 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 KAP Fortran 90 software supports the Digital UNIX License Management Facility (LMF). A License Product Authorization Key (License PAK) must be registered in the License Database (LDB) to use KAP Fortran 90. 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 Digital UNIX, first log in as superuser. You can then perform the PAK registration in the LDB in the following way: 1. At the superuser prompt, enter the lmf register command: # /usr/sbin/lmf register o The lmf register command brings you into edit mode. o While in edit mode, enter all the information on your License PAK. Preparing to Install KAP Fortran 90 1-1 o After you enter the information, exit edit mode. 2. After you register your license, use the following lmf reset command to copy the license details from the LDB to the kernel cache: # /usr/sbin/lmf reset For complete information about using the Digital UNIX LMF, see the DEC OSF/1 AXP Version 1.3 Guide to Software Licensing 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 KAP Fortran 90. Installing KAP Fortran 90 and KAP Fortran 90 reference pages (manpages), and running the Installation Verification Procedure (IVP) on a standalone system takes about 2 minutes. 1.3.1 Login Privileges You must be able to log in as superuser on the system where you are installing KAP Fortran 90. Only when you are logged in as superuser do you have sufficient privileges to install the KAP Fortran 90 software. 1.3.2 Hardware Requirements For a complete list of supported processors, see the SPD. Installing KAP Fortran 90 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 1-2 Preparing to Install KAP Fortran 90 You can use either a hardcopy or video terminal to communicate with the operating system and respond to prompts from the installation procedure for KAP Fortran 90. 1.3.3 Software Requirements You must install the following software before you install KAP Fortran 90, Version 3.1, for Digital UNIX: o DEC OSF/1 Alpha Base System The required subset is OSFBASExxx, which is named "Base System." o Digital Fortran 90, Version 4.0 The required subset is F9ABASE410, which is named "DEC Fortran 90 Version 4.0 for OSF/1 AXP Systems." o Digital Fortran 90 Run-Time Library The required subset is DFARTL374, which is named "DEC Fortran for OSF/1 AXP Run-Time Support." o OSFMANOPxxx 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.0b operating system CD- ROM. This subset is required only if you are using Digital UNIX 4.0b 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 KAP Fortran 90 software, which consists of the KF9BASE310 subset. The SPD contains a complete list of prerequisite software and required version numbers. Preparing to Install KAP Fortran 90 1-3 1.3.3.2 Parallel Libraries Identical for all KAP Products Version 3.1 of KAP for DEC Fortran, KAP Fortran 90, and KAP for C use the same parallel libraries. If you use different languages within a parallelized program, you should use Version 3.1 of all the KAP products. Table 1-1 shows the KAP Version 3.1 parallel libraries. Use the what command to determine the versions of some parallel libraries, for example: For the Digital UNIX Version 3.2 library, libkmp_osf.a: what /usr/lib/libkmp_osf.a Returns KAP version: version bl26.2 Table_1-1_KAP_Version_3.1_Parallel_Processing_Libraries___ Library_________________________KAP_Version_Number________ Digital_UNIX_Version_3.2__________________________________ libkmp_osf.a bl26.2 __________________________________________________________ Digital_UNIX_Version_4.0__________________________________ libkmp_osfp10.a bl27.2_posix_10 libpthread.so___________________UNIX_4.0b_________________ 1-4 Preparing to Install KAP Fortran 90 1.3.4 Disk Space Requirements The disk space requirements discussed in this section apply to the disks where you load the KAP Fortran 90 subset. Table 1-2 lists the disk space requirements for loading KAP Fortran 90 software subsets for Digital UNIX systems. The KAP Fortran 90 installation procedure loads files into the following directories: /usr/opt /usr/bin /usr/man/man1 /usr/lib Table_1-2_KAP_Subset_Sizes_with_Digital_UNIX______________ Subset_Name______/usr/opt____/usr/bin____/usr/man/man1____ KF9BASE310_______9_MB________50_bytes____50_bytes_________ Compare the space required for subsets with the free space currently on the disks where KAP Fortran 90 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 KAP Fortran 90. 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 KAP Fortran 90 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. Preparing to Install KAP Fortran 90 1-5 Enter the df command to determine total space and free space for the one or two file systems where KAP Fortran 90 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: # 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-2 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 KAP Fortran 90 files in /usr/opt to the free space displayed in the output list. If you find that there is insufficient disk space for the KAP Fortran 90 subsets, and know that you have additional space on alternative disks or disk partitions for your system, you can take the following steps before installing KAP Fortran 90: 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 Digital 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 Digital UNIX documentation. 1-6 Preparing to Install KAP Fortran 90 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 KF9BASE310. KF9BASE310 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 Digital UNIX documentation on system messages, recovery procedures, and Digital 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. If an error occurs while using KAP Fortran 90 and you believe that the error is caused by a problem with KAP Fortran 90, take one of the following actions: o If you have a basic or DECsupport Software Agreement, call your Customer Support Center (CSC). The CSC provides telephone support for high-level advisory and remedial assistance. o If you have a Self-Maintenance Software Agreement, you can submit a Software Performance Report (SPR). Preparing to Install KAP Fortran 90 1-7 o If you purchased KAP Fortran 90 within the last 90 days and you think that the problem is caused by a software error, you can submit an SPR. 1.7 Building Images with the Archive DECthreads Library The KAP kit nolonger includes the DECthreads archive library libpthread.a. Although Digital recommends that you use the DECthreads shared library default, you can link an image to the DECthreads archive library libpthread.a, by using the -non_shared linker switch and the following procedure for Digital UNIX Version 4.0: If you are upgrading from KAP Version 3.0 to 3.1, you should perform the following installation step: 1. Copy /usr/opt/KF9BASE300/libpthread.a, to a private area, for example, /usr/users/tmp/libpthread.a Continue with the installation procedure as described in Chapter 2. With Digital UNIX Versions 4.0a and 4.0b, this step is not required. 1-8 Preparing to Install KAP Fortran 90 2 ________________________________________________________________ Installing KAP Fortran 90 This chapter describes the procedures for installing KAP Fortran 90 on a Digital UNIX system. 2.1 Installing KAP Fortran 90 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 KAP Fortran 90. 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: # mount /dev/rz4 /mnt 5. Enter a setld command that requests the load function and identifies the directory in the mounted file system where KAP Fortran 90 subsets are located. For Digital UNIX, the directory location for the KAP subsets is /mnt/kf9310. For example, if you load KAP Fortran 90 subsets onto a Digital UNIX system, enter the following command: Installing KAP Fortran 90 2-1 # /usr/sbin/setld -l /mnt/kf9310 KF9BASE310 2.1.2 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2.1.2.1 Loading the KF9 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 KF9 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 After you have made your menu selection, the procedure displays a series of messages. First, you are 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 system displays the following information: The product's license information is: Product Name: KAP-FORTRAN 90 Producer: KUCK Version: 3.1 Issuer: DEC Copyright (c) Kuck and Associates, Inc. 1995, 1996. 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. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. 2-2 Installing KAP Fortran 90 *-----------------------------------------------* * Installation Verification Procedure * * KAP Fortran 90 3.1 k271520 961119 * *-----------------------------------------------* KAP passes Optimization Compilation test KAP Object Execution Test Passed ****** Installation Verification Procedure SUCCESSFUL ****** # 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 KF9BASE310 Installing KAP Fortran 90 2-3 3 ________________________________________________________________ Completing the Installation At any time after installing KAP Fortran 90, 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 KAP Fortran 90. To run the IVP after an installation, enter the following command: # /usr/sbin/setld -v KF9BASE310 When the IVP runs successfully, the system displays the following: Copyright (c) Kuck and Associates, Inc. 1995,1996. All rights reserved. *-----------------------------------------------* * Installation Verification Procedure * * KAP Fortran 90 3.1 k271520 961119 * *-----------------------------------------------* KAP passes Optimization Compilation test KAP Object Execution Test Passed ****** Installation Verification Procedure SUCCESSFUL ****** 3.1 Building Applications with the DECthreads Archive Library on Digital UNIX Versions 4.0 and Higher Although Digital recommends that you use the Digital UNIX DECthreads shared library default, you can link an image to the DECthreads archive library libpthread.a, by using the -non_shared linker switch and one of the following procedures based on your version of Digital UNIX: Completing the Installation 3-1 o Digital UNIX Version 4.0: Create a link to the saved libpthread.a as follows: ln -sf /usr/users/tmp/libpthread.a /usr/lib/libpthread.a o Digital UNIX Version 4.0a: Version 4.0a does not contain libpthread.a. Your choices are as follows: 1. Upgrade to Version 4.0b and use the method for that version. 2. Downgrade to Version 4.0 and use the method for that version. 3. Use the kf90 -call_shared default linker switch which links an image with the DECthreads shared library /usr/shlib/libpthread.so. o Digital UNIX Version 4.0b: You should have installed the CMPDEVENH subset (Development Enhancements for Digital UNIX) from the Digital UNIX 4.0b operating system CD-ROM. The DECthreads archive library is at the following location: /usr/opt/alt/user/lib/threads/libpthread.a To link to libpthread.a when you are building a parallel program, use the following command: kf90 fkapargs='-conc' -non_shared \ /usr/opt/alt/usr/lib/threads/libpthread.a myprog.f90 3-2 Completing the Installation A ________________________________________________________________ Files Installed on Your System Table A-1 lists the files on your system after you install KAP. Table_A-1_Installed_KAP_Fortran_90_Files__________________ Directory________File______________Description____________ /usr/opt KF9310_release_ Release notes in text /KF9BASE310 note.txt /usr/opt ivp.csh IVP C-shell /KF9BASE310 /usr/opt kapf90 KAPF90 binary /KF9BASE310 /usr/opt kapf90.1 KAPF90 manpages /KF9BASE310 /usr/opt kapfivpin.f IVP source file /KF9BASE310 /usr/opt kapfivpin.kmp IVP file /KF9BASE310 /usr/opt kapfivpin.kut IVP file /KF9BASE310 /usr/opt kapfivpver.lis IVP KAP version /KF9BASE310 /usr/opt kf90 KAP F90 driver binary /KF9BASE310 /usr/opt kf90.1 KAP F90 driver manpages /KF9BASE310 /usr/opt libkmp_osf.a Digital UNIX V3.2, /KF9BASE310 POSIX 1003.4a/d4- compliant, parallel run-time library (continued on next page) Files Installed on Your System A-1 Table_A-1_(Cont.)_Installed_KAP_Fortran_90_Files__________ Directory________File______________Description____________ /usr/opt libkmp_osfp10.a Digital UNIX V4.0, /KF9BASE310 POSIX 1003.1c- compliant, parallel run-time library /usr/bin kapf90 Links /usr/bin kf90 Links /usr/man/man1 kapf90.1 Links /usr/man/man1 kf90.1 Links /usr/lib libkmp_osf.a Links /usr/lib_________libkmp_osfp10.a___Links__________________ A-2 Files Installed on Your System B ________________________________________________________________ Sample Installation This appendix contains a log of a complete installation of the KAP Fortran 90 for Digital UNIX Kit. Your installation may differ from this example because you can make different choices during the procedure. # /usr/sbin/setld -l /mnt/kf9310 KF9BASE310 /usr/sbin/setld -l /usr/users/karen/kapfkit *** Enter subset selections *** The following subsets are mandatory and will be installed automatically unless you choose to exit without installing any subsets: * KAP Fortran 90 for Digital UNIX Optimizer You may choose one of the following options: 1) ALL of the above 2) CANCEL selections and redisplay menus 3) EXIT without installing any subsets Enter your choices or press RETURN to redisplay menus. Choices (for example, 1 2 4-6): 1 You are installing the following mandatory subsets: KAP Fortran 90 for Digital UNIX Optimizer You are installing the following optional subsets: Is this correct? (y/n): y The installation of KF9BASE310 takes approximately 2 to 4 minutes, depending on your type of media and your system configuration. Begin Loading KF9 kit for KAP Copyright (c) Kuck and Associates, Inc. 1993,1994. All rights reserved. Sample Installation B-1 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 90 for Digital UNIX Optimizer Copying from /usr/users/karen/kapfkit (disk) Verifying Configuring "KAP Fortran 90 for Digital UNIX Optimizer" (KF9BASE310) This product is REGISTERED LICENSED SOFTWARE. Product: KAP-FORTRAN 90 Producer: KUCK Version: 3.1 Issuer: DEC The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. Is the PAK registered and loaded?[y/n] y Copyright (c) Kuck and Associates, Inc. 1994,1995,1996. 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. Possession, use, or copying of this software and media is authorized only pursuant to a valid written license from Digital or an authorized sublicensor. *-------------------------------------------* * Installation Verification Procedure * * KAP for Fortran 90 3.1 k271520 961119 * *-------------------------------------------* B-2 Sample Installation KAP passes Optimization Compilation test KAP Object Execution Test Passed ****** Installation Verification Procedure SUCCESSFUL ****** Sample Installation B-3 ________________________________________________________________ Index A Installation guide ___________________________ associated documents, vi Archive DECthreads library, conventions, vi 1-8 structure, v building applications IVP, 3-1 with, 3-1 L__________________________ B__________________________ libpthread.a, 3-1 Backing up your system, License Management Facility 1-6 (LMF), 1-1 ___________________________ P__________________________ Disk space requirements, Parallel libraries, 1-4 1-5 Privileges increasing, 1-6 checking login, 1-2 ___________________________ S__________________________ Error recovery, 1-7 Software requirements, 1-3 Stopping installation, 1-7 H Storage required for ___________________________ installation, 1-2 Hardware required for installation , 1-2 I__________________________ Installation sample, B-1 stopping, 1-7 storage, 1-2 Index-1