CONTENTS PREV NEXT INDEX

Compaq logo


Chapter 2 Prerequisites for Installing Compaq Fortran


This chapter contains the following sections:

2.1 Registering Your Software License

Compaq Fortran includes support for the License Management Facility (LMF). You must register your License Product Authorization Key (License PAK) in the License Database (LDB) in order to use Compaq Fortran on a newly-licensed node. 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.

If you are installing Compaq Fortran as an update on a node already licensed for this software, you have already completed the License PAK registration requirements.

To register a license for Compaq Tru64 UNIX, follow these steps:

  1. Log in as superuser.
  2. At the superuser prompt, enter the following command to edit your License PAK:
  3. # lmf register
    
    An empty PAK template is displayed in a text editor (vi by default). Enter all the information from your License PAK form.
  4. After you register your license, use the following command to copy the license details from the LDB to the kernel cache:
  5. # lmf reset
    
For complete information on using the License Management Facility, see the Compaq Tru64 UNIX Software License Management and the lmf(8) reference page.

Note that CXML does not require a separate license.

2.2 Checking the Software Distribution Kit

Use the Parts List to check the contents of your Tru64 UNIX Software Product Library CD-ROM software distribution kit. The software distribution kit is ordered separately from Compaq Fortran and includes the following: If your software distribution kit is damaged or incomplete, contact your Compaq representative.

2.3 Time Requirements and Login Privileges

Installing Compaq Fortran, including running the Installation Verification Procedure (IVP), takes approximately 10 to 15 minutes, depending on your system configuration.

You must have superuser privileges to install the Compaq Fortran software and to register the license PAK.

2.4 Hardware Requirements

To install Compaq Fortran, you need the following hardware: For additional hardware requirements, see the Compaq Fortran Software Product Description (SPD).

2.5 Software Requirements

Compaq Fortran Version 5.4 requires Version 4.0 (or later) of the Compaq Tru64 UNIX operating system. Use of parallel features requires Version 4.0D (or later) of the Compaq Tru64 UNIX system. Use of NUMA (Non-Uniform Memory Access) features requires Version 5.1 (or later) of the Compaq Tru64 UNIX system.

Future releases of Compaq Fortran might require higher Compaq Tru64 UNIX versions. For information about the minimum version of the operating system required, see the Release Notes or the cover letter. (See Section 1.2, "Reading the Release Notes and Cover Letter".)

Compaq Fortran also requires that the following Compaq Tru64 UNIX subsets be loaded on the system where you install Compaq Fortran:

To install the Compaq Fortran reference pages (manual pages), the following Compaq Tru64 UNIX software subsets must already be installed on your system: To check whether these subsets are loaded, follow these steps:
  1. Log in to the system where you will install Compaq Fortran.
  2. Enter the following command:
  3. # setld -i | egrep 'OSFBASE|OSFCMPLRS|OSFPGMR|OSFMANOS|OSFMANOP|OSFDCMT'
    
    If you do not log in as superuser (login name root), you must enter the full path of the command. For example:
    # /usr/sbin/setld -i | grep OSFBASE
Check the displayed rows for the name of the relevant subset and any related patches. The word "installed" appears in a row after the subset identifier when a subset is loaded.

If the word "installed" does not appear (that is, the second column in a row is blank), the subset or patch is not loaded. In this case, you must load the missing Compaq Tru64 UNIX software before installing Compaq Fortran. (For information on how to load Compaq Tru64 UNIX operating system software, see the Compaq Tru64 UNIX Installation Guide.)

2.6 Determining Which Compaq Fortran Subsets to Load

You must choose the Compaq Fortran subsets you want to load. Table 2-1 indicates which subsets are required or recommended for each compiler. (Both compilers are installed.)

The subsets starting with XMD are part of the Compaq Extended Math Library (CXML).

Table 2-1 Required and Recommended Subsets for Compaq Fortran Compilers
Subset Name Compaq Fortran 95/90 Compaq Fortran 77
DFABASE Required Required
DFACOM Required Required
DFADOC Recommended Recommended
DFARTL Required Required
OTABASE Required Not used
HPFLIBS Required Not used
XMDCOM Recommended Recommended
XMDLIB4, XMDLIB5, XMDLIB61 Recommended Recommended
XMDSCI Recommended Recommended
XMDMAN Recommended Recommended
XMDHTM Recommended Recommended
1

Typically, a user installs only one of the XMDLIB subsets. (See Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets".)

In the subset identifiers starting with DFA, the nnn represents the version number of Compaq Fortran. In the subset identifier DFARTLnnn and HPFLIBSnnn, the nnn represents the current version of those subsets. For a list of the current subset numbers, read the Release Notes. (See Section 1.2, "Reading the Release Notes and Cover Letter".)

Some of these subsets are also included on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see the Compaq Tru64 UNIX Installation Guide).

For information about loading specific subsets, see the setld(8) reference page.

The subsets are described in the following sections.

2.6.1 DFABASEnnn Subset

Subset title: Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems.

This the primary subset for Compaq Fortran and requires DFARTLnnn and HPFLIBSnnn. You must install this subset to compile, link, and run Fortran programs using either Compaq Fortran 95/90 or Compaq Fortran 77 programs.

This subset installs its files in the following directories:

/usr/lib/cmplrs/fort90
/usr/lib/cmplrs/fort
/usr/lib/cmplrs
/usr/bin
/usr
The directory /usr/lib/cmplrs/fort90 is a symbolic link to the following directory:
/usr/lib/cmplrs/fort90_nnn
The directory /usr/lib/cmplrs/fort is a symbolic link to the following directory:
/usr/lib/cmplrs/fort_nnn

2.6.2 DFACOMnnn Subset

Subset title: Compaq Fortran Vn.n Tools & Their Man Pages.

This subset contains:

If disk space is a concern, you can omit installing this subset.

This subset and its files are used by both Compaq Fortran 95/90 (f90 command) and Compaq Fortran 77 (f77 command).

This subset installs its files in the following directories:

/usr/bin
/usr/include
/usr/lib
/usr/shlib
/usr/man/man1
/usr/man/man3

2.6.3 DFADOCnnn Subset

Subset title: Compaq Fortran Vn.n Release Notes and Man Page.

This subset contains:

Because the Release Notes and the f90(1) and f77(1) reference pages must be available to programmers using Compaq Fortran, you should load this subset.

To view these files before proceeding with the Compaq Fortran installation, you can choose to install this subset first.

This subset installs its files in the following directories:

/usr/lib/cmplrs/fort90
/usr/lib/cmplrs/fort
The directory /usr/lib/cmplrs/fort90 is a symbolic link (for Compaq Fortran 95/90 files) to the following directory:
/usr/lib/cmplrs/fort90_nnn
The directory /usr/lib/cmplrs/fort is a symbolic link (for Compaq Fortran 77 files) to the following directory:
/usr/lib/cmplrs/fort_nnn

Because the DFACOMnnn and DFADOCnnn subsets contain reference pages, you can load them only if the appropriate Compaq Tru64 UNIX reference pages subsets are already loaded on your system. (See Section 2.5, "Software Requirements".)

2.6.4 DFARTLnnn Subset

Subset title: Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77).

This subset supports both Compaq Fortran 95/90 and Compaq Fortran 77 and contains:

This subset (or a higher version) is a prerequisite for the DFABASEnnn subset. Always choose this subset if it appears in your menu and if you are also installing DFABASEnnn.

During the Compaq Fortran installation procedure, if you choose DFARTLnnn, it will not be installed if your system already has a more recent version.

This subset installs files in the following directories:

/usr/lib/nls/msg/en_US.ISO8859-1
/usr/lib/cmplrs/fortrtl
/usr/lib/cmplrs
/usr/lib
/usr/shlib
The directory /usr/lib/cmplrs/fortrtl is a symbolic link to the following directory:
/usr/lib/cmplrs/fortrtl_nnn

2.6.5 OTABASEnnn Subset

Subset title: Compaq Compiled Code Support Library.

This subset contains libraries required to support parallel directives. The subset installs its files in the following directories:

/usr/lib/cmplrs
/usr/lib/cmplrs/o3abase_nnn
/usr/shlib
If a newer version of these libraries already exists on your system, the installation procedure will not override them.

2.6.6 HPFLIBSnnn Subset

Subset title: High Performance Fortran Run-Time Libraries.

This subset contains:

Note:

You must install the HPFLIBSnnn subset to compile, link, and run Fortran programs using Compaq Fortran that reference any HPF* routines.
If you previously installed the PSESHPF subset and need to delete it, delete it before you install Compaq Fortran. If you delete the PSESHPF subset after you install the Compaq Fortran HPFLIBS subset, you need to reinstall the HPFLIBS subset. For information on using setld to check for and delete subsets, see Section 4.2, "How to Delete Compaq Fortran from Your System".
This subset installs its files in the following directories:
/usr/examples/hpf
/usr/lib/cmplrs/hpfrtl_nnn
/usr/lib/cmplrs/hpfrtl
/usr/lib
/usr/shlib
/usr/man/man3
The directory /usr/lib/cmplrs/hpfrtl is a symbolic link to the following directory:
/usr/lib/cmplrs/hpfrtl_nnn

2.6.7 XMDCOMnnn Subset

Subset title: CXML Common Files for the Extended Math Library.

The Compaq Extended Math Library (CXML) is a collection of high performance subprograms that perform different types of mathematical operations, including:

To use CXML, users typically include calls to CXML entry points in their application programs, then link the application program with the serial or parallel CXML library, and execute. The CXML routines are primarily called from Fortran or C, but can be called from any language.

This subset contains common material needed by the CXML XMDLIB subsets described in Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets". This subset provides release notes, example programs, header files that user programs must include, Installation Verification Procedure (IVP) tests, and other supporting CXML utilities.

This subset installs its files in the following directories:

/usr/examples/cxml
/usr/opt/XMDCOMnnn/docs
/usr/opt/XMDCOMnnn/cxml
/usr/opt/XMDCOMnnn/ivp

2.6.8 XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets

Subset titles: CXML Extended Math Libraries (Serial and Parallel) for EV4, EV5, EV6.

These three subsets contain the CXML libraries, specially tuned for one family of Alpha processors (21064, 21164, 21264).

Typically, you choose to install only one of these subsets, but you can install any number of them.

Each subset contains both the serial and the parallel CXML libraries:

The parallel version of the CXML library supports symmetric multiprocessing (SMP) for improved performance. The parallel CXML library achieves its parallelization using OpenMP. Key BLAS, LAPACK, FFT routines, and sparse and iterative solver routines in the CXML library have been modified to execute in parallel if run on SMP hardware.

Each subset installs its libraries in the following directory:

/usr/opt/XMDLIBxnnn

2.6.9 XMDSCInnn Subset

Subset title: CXML SCIPORT library.

This subset contains the SCIPORT Cray compatibility library (libsciport.a) and the SCIPORT man pages. After linking with the SCIPORT library, your Fortran program must link in the CXML library (either serial or parallel). For example:

f90 -i8 -r8 -double_size 128  myprog.f -lsciport -lcxmlp
The common subset XMDCOM and at least one of the CXML library subsets (XMDLIB4, XMDLIB5, or XMDLIB6) must be installed in addition to XMDSCI.

This subset installs its files in the following directories:

/usr/opt/XMDSCInnn/cxml
/usr/opt/XMDSCInnn/ivp
/usr/opt/XMDSCInnn/man
/usr/opt/XMDSCInnn

2.6.10 XMDMANnnn Subset

Subset title: CXML Reference (man) Pages.

This subset contains the reference pages (man pages) for CXML.

This subset installs its files in the following directory:

/usr/opt/XMDMANnnn/man

2.6.11 XMDHTMnnn Subset

Subset title: CXML Reference (man) Pages in HTML format.

This subset contains the reference pages (man pages) for CXML in HTML format.

This subset installs its files in:

/usr/opt/XMDHTMnnn/cxml_webpages
These pages are accessible at the following Web location:
/usr/opt/XMDHTMnnn/cxml_webpages/cxml_home_page.html

2.6.12 Reference Pages and nfs Mounting

Users on the system where Compaq Fortran is being installed can use reference pages that are nfs mounted from another system. If so, consider loading the reference pages subsets only on the other system (not the system where you are installing Compaq Fortran).

When reference pages are nfs mounted on another system, do not request the DFACOMnnn and DFADOCnnn subsets during the Compaq Fortran installation. After the installation is complete, you can log in to the system where the reference pages are installed and load only the Compaq Fortran DFACOMnnn and DFADOCnnn subsets on that system.

2.7 Determining Disk Space Requirements

Table 2-2 lists the disk space requirements for loading Compaq Fortran software subsets. These disk space requirements are approximate; the values apply to the disks where you load the Compaq Fortran subsets. The disk space requirements are listed by directory, in case you are doing installations on systems where these directories are mount points for different disk partitions.

Table 2-2 Compaq Fortran Subset Sizes (Disk Space Requirements)
Subset Name Directory Kbytes Required
DFABASEnnn /usr
/usr/bin
/usr/lib/cmplrs
/usr/lib/cmplrs/fort90_nnn
/usr/lib/cmplrs/fort_nnn

1

1
1
15000
7500
Total: 22510
DFACOMnnn /usr/bin
/usr/include
/usr/man/man1
/usr/man/man3
/usr/lib
/usr/shlib

150

170
6
200
360
30
Total: 920
DFADOCnnn /usr/lib/cmplrs/fort_nnn
/usr/lib/cmplrs/fort90_nnn

340

450
Total: 790
DFARTLnnn /usr/lib
/usr/lib/cmplrs
/usr/lib/cmplrs/fortrtl_nnn
/usr/lib/nls/msg/en_US.ISO8859-1

/usr/shlib

1

1
2700
1
1
Total: 2710
OTABASEnnn /usr/lib/cmplrs
/usr/lib/cmplrs/o3abase_nnn
/usr/shlib

1

650
1
Total: 660
HPFLIBSnnn /usr/lib
/usr/lib/cmplrs/hpfrtl
/usr/lib/cmplrs/hpfrtl_nnn
/usr/man/man3
/usr/opt/HPFnnn/hpf/usr/examples/hpf 

/usr/shlib


1

1
9600
1
100
1
Total: 9710
XMDCOMnnn /usr/opt/XMDCOMnnn
/usr/opt/XMDCOMnnn/docs
/usr/opt/XMDCOMnnn/cxml
/usr/opt/XMDCOMnnn/ivp

24

9
251
67
Total: 360
XMDLIB4nnn /usr/opt/XMDLIB4nnn
63410
XMDLIB5nnn /usr/opt/XMDLIB5nnn
62910
XMDLIB6nnn /usr/opt/XMDLIB6nnn
68590
XMDMANnnn /usr/opt/XMDMANnnn/man
4750
XMDHTMnnn /usr/opt/XMDHTMnnn/man
6820
XMDSCInnn /usr/opt/XMDSCInnn/cxml 
/usr/opt/XMDSCInnn/ivp
/usr/opt/XMDSCInnn/man

1121

8
20
Total: 1150
Grand Total: 
245290

Using these disk space requirements, total the values for the subsets you will load in each directory.

Compare the space required for subsets with the free space currently on the disks where Compaq Fortran files will reside.

If you need precise information on the sizes of individual Compaq Fortran files in the various directories, view one of the following files:

2.7.1 Checking Current Disk Space

To check the current amount of free space for a directory path, log in to the system where you will install Compaq Fortran. You can check which directories are mounted and where they are by viewing the /etc/fstab file. For example:
# more /etc/fstab 
/dev/rd0a:/:rw:1:1:ufs::
/dev/rd0g:/usr:rw:1:2:ufs::
/usr/staff/r1/leslie@bigsys:/usr/staff/r1/leslie:rw:0:0:nfs:bg:
/usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:
This display shows the following: To check total space and free space for the directories where Compaq Fortran files will reside, enter the df command. In the case of the previous display of the /etc/fstab file, which shows that only /usr is a mount point, you need to check free space only in the
/usr file system. You can do so as follows:
# df /usr 
Filesystem   Total    kbytes   kbytes   %
node         kbytes   used     free     used  Mounted on
/dev/rd0g     122598   54447   55892    49%   /usr
The device names shown in this section are for Tru64 UNIX Version 4 systems. For Tru64 UNIX Version 5 systems, the device names might be different.

This display indicates there are 55892 Kbytes free. This free space must accommodate the subset requirements listed in Table 2-2.

On systems where /usr/lib and /usr/man are mounted to devices different from /usr, enter the following command:

# df /usr/lib /usr/man
In this case, you would:

2.7.2 Increasing Disk Space by Using Alternative Disks

The Compaq Fortran installation procedure creates some directories and loads files into subordinate directories, as listed in either of the following files:
/usr/lib/cmplrs/fort90/filelist
/usr/lib/cmplrs/fort/filelist
If the /usr/lib/cmplrs directory does not exist, the Compaq Fortran installation procedure creates it. If this directory does exist, the installation procedure uses it.

If you find that there is insufficient disk space for the Compaq Fortran subsets and if you know that there is additional space on other disks or disk partitions for your system, take the following steps before installing Compaq Fortran:

  1. Log in as superuser (login name root) to the system where you will install Compaq Fortran.
  2. Create one or both of the appropriate directories:
  3. 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.
  4. Enter the mount -a command so that the new mount points take effect.

2.8 Installing from Media or Using Remote Installation Service (RIS)

Someone from your site must perform at least one Compaq Fortran installation from the distribution medium. Your site system administrator can then decide whether or not to make a Compaq Fortran distribution kit available online, so that subsequent installations of Compaq Fortran can use the Remote Installation Service (RIS).

For information on extracting Compaq Fortran subsets to a RIS distribution area, see your Compaq Tru64 UNIX system management documentation.

If you expect to use Compaq Fortran subsets from a RIS area of a remote system for installation on your local system, first check with your site system administrator to ensure the following:

For information on installing Compaq Fortran from a RIS distribution area, see Section 3.2, "How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area".

2.9 Backing Up Your System Disk

Compaq recommends that you back up your system disk before installing Compaq Fortran or any software. Use the backup procedures established at your site. For information about backing up your system disk, see the Compaq Tru64 UNIX system documentation.

2.10 Stopping the Installation

To stop the installation procedure at any time, enter Ctrl/C. You must then delete files created interactively up to that point. The directories and files created during the Compaq Fortran installation are listed in the following files:
/usr/lib/cmplrs/fort90/filelist
/usr/lib/cmplrs/fort/filelist

2.11 Recovering from Installation Errors

If errors occur during the installation, the system displays error messages. For example, if the installation of the DFABASEnnn subset fails due to insufficient disk space, the installation procedure displays the following message:
There is not enough space for subset DFABASEnnn
Compaq Fortran (DFABASEnnn) will not be loaded.
Errors can occur during the installation if any of the following conditions exist: For descriptions of error messages generated by these conditions, see the Compaq Tru64 UNIX documentation on system messages and software installation. If any of these conditions exist, take the appropriate action described in the message.

For information on requirements for installing Compaq Fortran, see Section 2.5, "Software Requirements".

.


CONTENTS PREV NEXT INDEX