Compaq KAP C/OpenMP for_Tru64_UNIX________________________________ Installation Guide Order Number: AA-PXEEL-TE June 2001 This guide describes how to install Compaq KAP C/OpenMP on Compaq Tru64 UNIX systems. Revision/Update Information: This is a revised document. Operating System and Version: Compaq Tru64 UNIX Versions 4.0D-4.0G or 5.0-5.1 Software Version: Version 4.2 Compaq C Version 6.1 Compaq Computer Corporation Houston, Texas __________________________________________________________ © 2001 Compaq Computer Corporation © 2001 Intel Corporation Compaq and the Compaq logo are registered in the U.S. Patent and Trademark Office. KAP is a trademark of Intel Corporation in the United States and other countries. UNIX is a trademark of The Open Group in the United States and other countries. All other product names mentioned herein may be trademarks of their respective companies. Confidential computer software. Valid license from Compaq required for possession, use or copying. Consistent with FAR 12.211 and 12.212, Commercial Computer Software, Computer Software Documentation, and Technical Data for Commercial Items are licensed to the U.S. Government under vendors standard commercial license. Compaq shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is provided "as is" without warranty of any kind and is subject to change without notice. The warranties for Compaq products are set forth in the express limited warranty statements accompanying such products. Nothing herein should be construed as constituting an additional warranty. This document is available on CD-ROM. This document was prepared using DECdocument, Version 3.3-1n. ________________________________________________________________ Contents Preface.................................................. v 1 Preparing to Install Compaq KAP C/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-2 1.3.2 Hardware Requirements.................... 1-2 1.3.3 Software Requirements.................... 1-3 1.3.4 Disk Space Requirements.................. 1-3 1.4 Backing Up Your System Disk.................. 1-5 1.5 Stopping the Installation.................... 1-6 1.6 Recovering from Errors....................... 1-6 2 Installing Compaq KAP C/OpenMP 2.1 Starting the Installation Procedure.......... 2-1 2.2 Responding to Installation Procedure Prompts...................................... 2-2 2.2.1 Loading the KPC Kit...................... 2-2 2.2.2 Monitoring Displays During the Subset Loading Process.......................... 2-2 2.3 Running the Installation Verification Procedure (IVP).............................. 2-3 iii A Files Installed on Your System B Sample Installation Index Tables 1-1 KAP Subset Sizes with Tru64 UNIX......... 1-4 A-1 Installed Compaq KAP C/OpenMP Files...... A-1 iv ________________________________________________________________ Preface This guide describes how to install Compaq KAP C/OpenMP on processors running the Compaq Tru64 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 guide is written for a system manager who installs Compaq KAP C/OpenMP on a Tru64 UNIX system. Structure of This Guide This guide contains two chapters and two appendixes: o Chapter 1 describes the operating system and hardware requirements for a Compaq KAP C/OpenMP installation and related procedures that you complete before installing this software. o Chapter 2 describes how to install Compaq KAP C/OpenMP. o Appendix A describes the hierarchy and contents of Compaq KAP C/OpenMP directories. o Appendix B contains a log for a sample Compaq KAP C/OpenMP installation. v Associated Documentation Be sure to read the Cover Letter and Release Notes before installing the software. They might contain important information not described in this guide. The documentation for Compaq KAP C/OpenMP also includes the following: o Compaq KAP C/OpenMP for Tru64 UNIX User Guide o Compaq KAP C/OpenMP for Tru64 UNIX Quick Reference To view the KAP C manpage, enter the following: man kcc. 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 C/OpenMP This chapter describes the preparations and requirements for installing Compaq KAP C/OpenMP on Tru64 UNIX. 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. 1.1 Registering the License The Compaq KAP C/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 KAP C/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, do the follow- ing: 1. Enter this command at the superuser prompt to bring you into edit (vi) mode: # /usr/sbin/lmf register 2. Using regular vi edit commands, enter all the information on your License PAK. If you are not familiar with vi, see the vi reference page (> man vi). 3. Exit the vi editor. Preparing to Install Compaq KAP C/OpenMP 1-1 4. Enter this command to copy the license information from the LDB to the dynamic kernel LMF database: # /usr/sbin/lmf reset 5. Then exit: # 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 # /usr/sbin/lmf load users # exit For complete information about using LMF on Tru64 UNIX, see Tru64 UNIX Software License Management 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 Installing Compaq KAP C/OpenMP and the Compaq KAP C/OpenMP reference pages, and running the Installation Verification Procedure (IVP) on a standalone system, takes about two minutes. 1.3.1 Login Privileges You must be able to log in as superuser on the system where you are installing Compaq KAP C/OpenMP. Only when you are logged in as superuser do you have sufficient privileges to install the Compaq KAP C/OpenMP software. 1.3.2 Hardware Requirements For a complete list of supported processors, see the SPD. Installing Compaq KAP C/OpenMP requires at least 10 megabytes of storage space on your system. To perform the installation, you need the following hardware: o Software distribution device (if installing from media) 1-2 Preparing to Install Compaq KAP C/OpenMP The documentation for the CD-ROM drive that you are using explains how to load the CD-ROM 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 C/OpenMP. 1.3.3 Software Requirements You must install the following software before you install Compaq KAP C/OpenMP Version 4.2 for Tru64 UNIX: o OSFBASExxx, the required Tru64 UNIX subset, which is named "Base System." o OSFMANOPxxx, which is named "Ref Pages: Programming." o OSFDCMTxxx, which is named "Document Preparation Tools." o CMPDEVENH subset (Development Enhancements for Tru64 UNIX) from the Tru64 UNIX 4.0D operating system CD-ROM. This subset is required only if you are using Tru64 UNIX Version 4.0D and you want to use the -non_shared linker switch to link your application to the POSIX Threads archive library. After you have installed the software described above, you can install the Compaq KAP C/OpenMP software, which consists of the KPCBASE420 subset. The SPD contains a complete list of prerequisite software and required version numbers. 1.3.4 Disk Space Requirements The disk space requirements discussed in this section apply to the disks where you load the KAP C/OpenMP subset. Table 1-1 lists the disk space requirements for loading KAP C/OpenMP software subsets for Tru64 UNIX systems. Preparing to Install Compaq KAP C/OpenMP 1-3 Table_1-1__KAP_Subset_Sizes_with_Tru64_UNIX_______________ Subset_Name____/usr/opt_______/usr/bin___usr/man/man1_____ KPCBASE420_____10_MB__________50_bytes___50_bytes_________ The KAP C/OpenMP installation procedure loads files into the following directories: /usr/opt /usr/bin /usr/man/man1 /usr/lib /usr/include Compare the space required for subsets with the free space currently on the disks where KAP C/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 KAP C/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 KAP C/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 KAP C/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: 1-4 Preparing to Install Compaq KAP C/OpenMP # 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 C/OpenMP files in /usr/lib to the free space displayed in the output list. If you find that there is insufficient disk space for the Compaq KAP C/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 installing Compaq KAP C/OpenMP: 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. Preparing to Install Compaq KAP C/OpenMP 1-5 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 KPCBASE420. KPCBASE420 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. 1-6 Preparing to Install Compaq KAP C/OpenMP 2 ________________________________________________________________ Installing Compaq KAP C/OpenMP This chapter describes how to install Compaq KAP C/OpenMP on a Tru64 UNIX system. Before starting the installation procedure, you should complete the preparations described in Chapter 1. 2.1 Starting the Installation Procedure To start the Compaq KAP installation procedure from CD- ROM: 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 C/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 rz4c, enter the following command: # /usr/sbin/mount -r /dev/rz4c /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 C/OpenMP subsets are located. The directory location for the Compaq KAP subsets is /mnt/kpc420. For example, if you load Compaq KAP C/OpenMP subsets onto a Tru64 UNIX system, enter the following command: Installing Compaq KAP C/OpenMP 2-1 # /usr/sbin/setld -l /mnt/kpc420/kit KPCBASE420 2.2 Responding to Installation Procedure Prompts This section explains the installation procedure prompts and displays. 2.2.1 Loading the KPC Kit After you enter the setld command, the installation procedure displays the following message: Checking file system space required to install specified subsets: If there is sufficient file system space, the KPC kit begins loading. 2.2.2 Monitoring Displays During the Subset Loading Process After the kit is loaded, the procedure displays a series of messages such as: Product Name: KAP-C Producer: KUCK Version: 4.2 Issuer: Compaq The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. Next, you are asked if the PAK is registered. Enter y if your PAK is registered. Is the PAK registered and loaded? [y/n] y Then, the IVP will run automatically. The IVP checks to ensure that the installation is successful. If the Compaq KAP subset is properly installed, then the IVP displays the following message: KAP C/OpenMP Installation Verification Procedure (IVP) Version: 4.2 k010737s 010515 IVP passed Optimization Compilation Test IVP passed Object Execution Test IVP executed correctly 2-2 Installing Compaq KAP C/OpenMP KAP C/OpenMP 4.2 for Tru64 UNIX 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 C subset before you reinstall the product: # /usr/sbin/setld -d KPCBASE420 2.3 Running the Installation Verification Procedure (IVP) At any time after installing Compaq KAP C/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 C/OpenMP. To run the IVP after an installation, enter the following command: # /usr/sbin/setld -v KPCBASE420 When the IVP runs successfully, the system displays the following: KAP C/OpenMP Installation Verification Procedure (IVP) Version: 4.2 k010737s 010515 IVP passed Optimization Compilation Test IVP passed Object Execution Test IVP executed correctly Installing Compaq KAP C/OpenMP 2-3 A ________________________________________________________________ Files Installed on Your System Table A-1 lists the files on your system after you install Compaq KAP C/OpenMP. Table_A-1_Installed_Compaq_KAP_C/OpenMP_Files___________________ Directory___________File________________Description_____________ /usr/opt/KPCBASE420 KPC420_release_ Release Notes note.txt /usr/opt/KPCBASE420 ivp.csh IVP script /usr/opt/KPCBASE420 kapc KAP-C binary /usr/opt/KPCBASE420 kapcivpin.c IVP C source file /usr/opt/KPCBASE420 kapcivpin.kmp IVP file /usr/opt/KPCBASE420 kapcivpver.lis IVP KAP version /usr/opt/KPCBASE420 kapio.alphaosf.h Stdio header file /usr/opt/KPCBASE420 kapio.internal.h Stdio header file /usr/opt/KPCBASE420 kcc KAP-C driver binary /usr/opt/KPCBASE420 kcc.1 KAP-C driver reference pages /usr/opt/KPCBASE420 libkio.a KAP stdio library /usr/bin kapc Symbolic link /usr/bin kcc Symbolic link /usr/man/man1 kcc.1 Symbolic link /usr/lib libkio.a Symbolic link /usr/include/kap kapio.alphaosf.h Symbolic link /usr/include/kap____kapio.internal.h____Symbolic_link___________ Files Installed on Your System A-1 B ________________________________________________________________ Sample Installation This appendix contains a log of a complete installation of the Compaq KAP C/OpenMP for Tru64 UNIX kit. Your installation may differ from this example because you can make different choices during the procedure. # setld -l /mnt/kpc420/kit KPCBASE420 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 KPCBASE420 takes approximately 2 minutes Begin Loading KPCBASE420 Copyright (c) 2001 Compaq Computer Corporation Copyright (c) 2001, Intel Corporation. All rights reserved. KAP C/OpenMP for Tru64 UNIX Copying from output (disk) Verifying 1 of 1 subset(s) installed successfully. Configuring "KAP C/OpenMP for Tru64 UNIX" (KPCBASE420) This product is REGISTERED LICENSED SOFTWARE. Product: KAP-C Producer: KUCK Version: 4.2 Issuer: Compaq The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. Sample Installation B-1 Is the PAK registered and loaded?[y/n] y KAP C/OpenMP Installation Verification Procedure (IVP) Version: 4.2 k010737s 010515 KAP C/OpenMP IVP passed Optimization Compilation test KAP C/OpenMP IVP passed Object Execution Test KAP C/OpenMP IVP executed correctly KAP C/OpenMP 4.2 for Tru64 UNIX is properly installed. # exit B-2 Sample Installation ________________________________________________________________ Index B Installation procedure, ___________________________ 2-1 Backing up your system, IVP, 2-3 1-5 L__________________________ C__________________________ License Management Facility Conventions, vi (LMF), 1-1 D__________________________ P__________________________ Disk space requirements, Privileges 1-3 checking login, 1-2 increasing, 1-5 Documentation, associated, S__________________________ vi Software requirements, 1-3 Stopping installation, 1-6 E__________________________ Storage required for Error recovery, 1-6 installation, 1-2 H__________________________ Hardware required for installation , 1-2 I__________________________ Installation sample, B-1 stopping the, 1-6 storage, 1-2 Index-1