Order Number: AA--QMB4H--TE
This guide describes how to install Compaq KAP Fortran/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.4
Compaq Fortran Version 5.3
Compaq Computer Corporation
Houston, Texas
© 2001 Compaq Computer Corporation
© 2001 Intel Corporation
Compaq, the Compaq logo, and Tru64 are trademarks of Compaq Information Technologies Group, L.P. KAP is a trademark of Intel Corporation. UNIX is a trademark of The Open Group. 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 vendor's 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.
Contents | Index |
This guide describes how to install Compaq KAP Fortran/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.
This guide is written for a system manager who installs Compaq KAP Fortran/OpenMP on a Tru64 UNIX system.
This guide contains two chapters and two appendixes:
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 Fortran/OpenMP also includes the following:
To view the KAP Fortran manpage, enter: man kf90
For general information about installing software, refer to your Tru64 UNIX installation guide.
The following conventions are used in this guide:
Convention | Description |
---|---|
UPPERCASE and lowercase | The Tru64 UNIX system differentiates 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. |
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.
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:
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 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 Fortran/OpenMP and Compaq KAP Fortran/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 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 15 megabytes of disk storage space on your system.
To perform the installation, you need the following hardware:
You must install the following software before you install Compaq KAP Fortran/OpenMP Version 4.4 for Tru64 UNIX:
After you have installed the software described above, you can install the Compaq KAP Fortran/OpenMP software, which consists of the KF9BASE440 subset.
The SPD contains a complete list of prerequisite software and required
version numbers.
1.3.3.1 Parallel Libraries
The installation kit includes the KAP parallel runtime library, libkmp_osfp10.a . Use the what command to determine the version of the parallel library:
what /usr/opt/KF9BASE440/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.
Subset Name | /usr/opt | /usr/bin | /usr/man/man1 |
---|---|---|---|
KF9BASE440 | 15 MB | 50 bytes | 50 bytes |
The Compaq KAP Fortran/OpenMP installation procedure loads files into the following directories:
/usr/opt
/usr/bin
/usr/man/man1
/usr/lib
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:
# 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:
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.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 KF9BASE440.
KF9BASE440 will not be loaded.
If any of the following conditions exist, errors can occur during the installation:
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.
This chapter describes how to install Compaq KAP Fortran/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 KAP installation procedure from CD-ROM:
This section explains the installation procedure prompts and displays.
2.2.1 Loading the KF9BASE440 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 KF9BASE440 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, as follows:
Product: KAP FORTRAN/OpenMP
Producer: KUCK
Version: 4.4
Issuer: Compaq
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:
KAP Fortran/OpenMP Installation Verification Procedure (IVP)
Version: 4.4 k340504 20010517
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 message:
KAP Fortran/OpenMP V4.4 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 Fortran subset before you reinstall the product:
# /usr/sbin/setld -d KF9BASE440
2.3 Running the Installation Verification Procedure (IVP)
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:
# setld -v KF9BASE440
When the IVP runs successfully, the system displays the following:
KAP Fortran/OpenMP Installation Verification Procedure (IVP)
Version: 4.4 k340504 20010517
KAP Fortran/OpenMP IVP passed Optimization Compilation test
KAP Fortran/OpenMP IVP passed Object Execution Test
KAP Fortran/OpenMP IVP executed correctly
Table A-1 lists the files on your system after you install Compaq KAP\OpenMP.
Directory | File | Description |
---|---|---|
/usr/opt/KF9BASE440 | KF9440_release_note.txt | Release Notes |
/usr/opt/KF9BASE440 | ivp.csh | IVP script |
/usr/opt/KF9BASE440 | kapf | KAP for f77 translator |
/usr/opt/KF9BASE440 | kapf90 | KAP for f90/f95 translator |
/usr/opt/KF9BASE440 | kapfivpin.f | IVP source program |
/usr/opt/KF9BASE440 | kapfivpin.kmp | IVP comparison file |
/usr/opt/KF9BASE440 | kapfivpin.kut | IVP comparison file |
/usr/opt/KF9BASE440 | kapfivpver.lis | Version, edit level and date |
/usr/opt/KF9BASE440 | kf77 | KAP for f77 driver |
/usr/opt/KF9BASE440 | kf90 | KAP for f90/f95 driver |
/usr/opt/KF9BASE440 | kf90.1 | kf90/kapf90 man pages |
/usr/opt/KF9BASE440 | libkmp_osfp10.a | KAP parallel runtime library |
/usr/bin | kapf90 | Symbolic link |
/usr/bin | kf90 | Symbolic link |
/usr/bin | kapf | Symbolic link |
/usr/bin | kf77 | Symbolic link |
/usr/man/man1 | kf90.1 | Symbolic link |
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 /mnt/kf9440/kit KF9BASE440 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 KF9BASE440 takes approximately 2 minutes. Begin Loading KAP Fortran/OpenMP V4.4 Copyright (c) 2001 Compaq Computer Corporation Copyright (c) 2001 Intel Corporation. All rights reserved. KAP Fortran/OpenMP for Tru64 UNIX Copying from output (disk) Verifying 1 of 1 subset(s) installed successfully. Configuring %quot;KAP Fortran/OpenMP for Tru64 UNIX%quot; (KF9BASE440) This product is REGISTERED LICENSED SOFTWARE. Product: KAP FORTRAN/OpenMP Producer: KUCK Version: 4.4 Issuer: Compaq The Product Authorization Key (PAK) must be registered with the LICENSE MANAGEMENT FACILITY. Is the PAK registered and loaded?[y/n] (n) y KAP Fortran/OpenMP Installation Verification Procedure (IVP) Version: 4.4 k340504 20010517 KAP Fortran/OpenMP IVP passed Optimization Compilation test KAP Fortran/OpenMP IVP passed Object Execution Test KAP Fortran/OpenMP IVP executed correctly KAP Fortran/OpenMP V4.4 is properly installed. # exit |
Index | Contents |