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.

In addition to being supplied with Compaq Fortran, some or all of these subsets are included on the Compaq Tru64 UNIX operating system CD-ROM distribution media (see Section 3.3).

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

1.4.5 Determining Disk Space Requirements

Table 1-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 1-2 Compaq Fortran Subset Sizes (Disk Space Requirements)

Subset Name	Directory	Kbytes Required
DFABASE nnn	/usr	1
	/usr/bin	1
	/usr/lib/cmplrs	1
	/usr/lib/cmplrs/fort90_ nnn	13000
	/usr/lib/cmplrs/fort_ nnn	6500
	Total:	19500
DFACOM nnn	/usr/bin	110
	/usr/include	60
	/usr/man/man1	6
	/usr/man/man3	200
	/usr/lib	3
	/usr/shlib	30
	Total:	410
DFADOC nnn	/usr/lib/cmplrs/fort_ nnn	340
	/usr/lib/cmplrs/fort90_ nnn	400
	Total:	740
DFARTL nnn	/usr/lib	1
	/usr/lib/cmplrs	1
	/usr/lib/cmplrs/fortrtl_ nnn	1980
	/usr/lib/nls/msg/en_us.iso8859-1	1
	/usr/shlib	1
	Total:	1990
OTABASE nnn	/usr/lib/cmplrs	1
	/usr/lib/cmplrs/o3abase_ nnn	165
	/usr/shlib	1
	Total:	170
HPFLIBS nnn	/usr/lib	1
	/usr/lib/cmplrs/hpfrtl	1
	/usr/lib/cmplrs/hpfrtl_ nnn	6400
	/usr/man/man3	1
	/usr/opt/hpf nnn/hpf/usr/examples/hpf	100
	/usr/shlib	1
	Total:	6500
XMDCOM nnn	/usr/opt/xmdcom nnn	29
	/usr/opt/xmdcom nnn/docs	10
	/usr/opt/xmdcom nnn/cxml	218
	/usr/opt/xmdcom nnn/ivp	68
	Total:	325
XMDLIB4 nnn	/usr/opt/xmdlib4 nnn/	60000
XMDLIB5 nnn	/usr/opt/xmdlib5 nnn/	62000
XMDLIB6 nnn	/usr/opt/xmdlib6 nnn/	66000
XMDMAN nnn	/usr/opt/xmdman nnn/man	4600
XMDHTM nnn	/usr/opt/xmdman nnn/man	4900
XMDSCI nnn	/usr/opt/xmdsci nnn/cxml	1018
	/usr/opt/xmdsci nnn/ivp	9
	/usr/opt/xmdsci nnn/man	225
	/usr/opt/xmdsci nnn	7
	Total:	1534
	Grand Total:	228670

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 the file /usr/lib/cmplrs/fort90/filelist (Fortran 90) or the file /usr/lib/cmplrs/fort/filelist (Fortran 77).

1.4.5.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 indicates the following:

• /usr (mounted to /dev/rd0g ) is the only mount point that affects where Compaq Fortran files will reside.
• The system has only one local disk drive
• The /usr/lib and /usr/lib/cmplrs file systems reside in the g partition of the disk on that drive.

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 may be different.

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

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

# df /usr/lib /usr/man

In this case, you would:

• Compare space required for Compaq Fortran files in /usr/lib with the free space displayed in the first line of the df output list.
• Compare the space required for Compaq Fortran files in /usr/man with the free space displayed in the second line of that list.

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:
   • /usr/lib/cmplrs/fort90_nnn
     This is a symbolic link to the directory /usr/lib/cmplrs/fort90_nnn .
   • /usr/lib/cmplrs/fort_nnn
     This is a symbolic link to the directory /usr/lib/cmplrs/fort_nnn .
   
   In these directory names, nnn is the Compaq Fortran version number.
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.

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:

• A Compaq Fortran network kit is available for use.
• Your system is registered as a RIS client.

For more information on installing Compaq Fortran from a RIS distribution area, see Section 2.1.2.

1.6 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.

1.7 Stopping the Installation

To stop the installation procedure at any time, enter Ctrl/C. You must then delete files created interactively up to this 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

1.8 Recovering from Installation Errors

If errors occur during the installation, the system displays appropriate 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:

• The operating system version is incorrect.
• The prerequisite software version is incorrect.
• The system parameter values for successful installation are insufficient.

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 system requirements for installing Compaq Fortran, see Section 1.4.3.

If an error occurs while Compaq Fortran is in use and you believe the error is caused by a problem with Compaq Fortran, take one of the following actions:

• If you have a Software Product Services Support Agreement, consider contacting your Customer Support Center (CSC) by telephone (in the United States, 1-800-354-9000) or by using the electronic means provided with your support agreement. You can use DSNlink or other electronic means to report the problem to the CSC.
• Customers without a service contract can arrange for per-call CSC support.

When you initially contact the CSC, please indicate the following:

1. The name and version number of the operating system you are using
2. The name and version number of Compaq Fortran you are using
3. The hardware system you are using (such as a model number)
4. Whether or not the problem is critical
5. A very brief description of the problem (one sentence if possible)

When you submit information electronically or are speaking on the phone to the appropriate support specialist, you can provide more detailed information. This includes the specific commands used to compile and link the program, the error messages displayed, and relevant detailed information (possibly including source program listings). Please try to narrow the cause of the problem to a specific module or lines of code.

CSC personnel may ask for additional information, such as listings of any command files, INCLUDE files, relevant data files, and so forth. If the program is longer than 50 lines, submit a copy of it electronically or provide machine-readable media (floppy diskette or magnetic tape). For information about submitting media, see the tar(1) reference page.

Experience shows that problem reports sometimes do not contain enough information to duplicate or identify the problem. Concise, complete information helps Compaq give accurate and timely service to software problems.

If the problem is related to Compaq Fortran documentation, you can use the Internet mail address or FAX number listed on the "Send Us Your Comments" section in the front of this guide.

This chapter describes how to install Compaq Fortran, as follows:

• How to install your kit locally using CD-ROM media ( Section 2.1.1)
• How to install your kit remotely using a RIS distribution area ( Section 2.1.2)
• How to respond to installation prompts ( Section 2.2)

Before you start the installation, read Chapter 1, which describes the requirements and general options for installing Compaq Fortran using the media CD-ROM.

2.1 Starting the Installation Procedure

Compaq Fortran can be installed locally (using CD-ROM media) or from a server area.

2.1.1 Using CD-ROM Software Product Library Media for Local Installations

The installation procedure loads Compaq Fortran files on to a disk belonging to the system where you perform the installation. When Compaq Fortran is run, its executable images are mapped into memory on your system.

Follow these steps to install Compaq Fortran from the Software Products Library CD-ROM set:

1. To obtain the kit directory location of the Compaq Fortran subsets on the appropriate Software Product Library CD-ROM (media CD-ROM), do one of the following:
   • Use the cdmenu utility provided on the media CD-ROM
   • View the CD master index file on the media CD-ROM
   • Contact the appropriate system administrator
   
   For information about using the cdmenu utility and the CD files on the media CD-ROM set, see the Software Product Library CD--ROM User's Guide (media CD-ROM user guide), which accompanies the media CD-ROM distribution kit. The media CD-ROM user guide and CD master index file are provided as online files in the /readme directory on the first media CD-ROM.
2. If the media CD-ROM containing the Compaq Fortran installation files is not mounted, either contact the appropriate system administrator or insert the appropriate media CD-ROM into an available CD-ROM drive.
3. Log in as superuser (login name root ) to the system where you will install Compaq Fortran.
4. Make sure you are at the root directory (/) by entering the following command:

   # cd /

5. Find out whether a previous version of Compaq Fortran is installed by entering the following commands:

   # setld -i | egrep 'PSESH|DFA|HPFLIBS'

   
   If the directory /usr/sbin is not in your path, specify the path before the setld command ( /usr/sbin/setld ).
   If a version of Compaq Fortran is not installed, skip to the next step.
   If multiple versions of the same subset exist, consider deleting the older versions. Before you delete the older subset versions, you might make sure that Fortran programmers using the system no longer need the older versions.
   For example, if the subset names DFABASE, DFADOC, and HPFLIBS are displayed and are no longer needed, enter the following command. (In these subset names, nnn is the version number of the old subsets.)

   # setld -d DFABASEnnn DFADOCnnn HPFLIBSnnn

   
   This command deletes the previous versions of the Compaq Fortran subsets. For example, you might remove older subset versions from the system when you install a more recent version of Compaq Fortran.
   For more information on deleting subsets for previous versions before continuing the installation (including Compaq Fortran subsets also used by other products), see Section 3.2.

6. Specify the /mnt directory to be the mount point for the distribution file system on the drive. If your drive is rz1 , enter the following command:

   # mount -dr /dev/rz1c /mnt

   
   Once you mount the media CD-ROM, you can print or view the release notes and the "read first" cover letter, as described in Section 1.1.

7. To verify the location of the Compaq Fortran main product directory on the appropriate media CD-ROM, type an ls command (see step 1), such as the following:

   # ls /mnt/product-directory/kit

8. Enter a setld command that requests the load function ( -l option) and identifies the directory in the mounted file system where Compaq Fortran Version 5.n subsets are located:

   # setld -l /mnt/product-directory/kit

   
   Where product-directory is the main Compaq Fortran directory listed in the CD user guide and CD master index file (such as dfa500).

The installation procedure now displays the names of Compaq Fortran subsets and asks you to specify the subsets you want to load.

See Section 2.2 to continue the installation.

2.1.2 Using a RIS Distribution Area for Remote Installations

If you are installing Compaq Fortran subsets that reside in an /etc/ris (RIS) distribution area on a remote system, follow these steps:

1. Log in as superuser (login name root ) to the system where you will install Compaq Fortran.
2. Make sure you are at the root directory (/) by entering the following command:

   # cd /

3. Enter a setld command that requests the load function ( -l option) and identifies the system where the Compaq Fortran subsets are located. For example, if you are loading Compaq Fortran subsets from a RIS distribution area on node orion , enter the following:

   # setld -l orion:

Remote Installation Services now displays a menu that lists all the software subsets available to you and asks you to specify the subsets you want to load.

See Section 2.2 to continue the installation.