> # Chapter 3 How to Install Compaq Fortran

> This chapter contains the following sections:

> - 3.1, "How to Install Your Kit Locally Using CD-ROM Software Products Library Media"
> - 3.2, "How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area"
> - 3.3, "Selecting Compaq Fortran Subsets"
> - 3.4, "Installing the Compaq Extended Math Library (CXML)"

> #### Note:

> For a complete example of an installation process, see Appendix A.
> For a list of files from the DFABASE, DFACOM, and DFADOC subsets installed on your system by the installation process, see the following file:

>     /usr/lib/cmplrs/fort90/filelist

> ## 3.1 How to Install Your Kit Locally Using CD-ROM Software Products Library Media

> The installation procedure loads Compaq Fortran files 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-ROM master index file on the media CD-ROM
> - Contact the system administrator
> - Check the cover letter, Read Before Installing or Using Compaq Fortran Version n.n for Tru64 UNIX Alpha Systems.
> 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.
> For more information, see Section 1.1, "Files on the Software Product Library CD-ROM".
> 1. If the media CD-ROM containing the Compaq Fortran installation files is not mounted, either contact the system administrator or insert the appropriate media CD-ROM into an available CD-ROM drive.
> 2. Log in as superuser (login name root) to the system where you will install Compaq Fortran.
> 3. Make sure you are at the root directory (/) by entering the following command:

>     # cd /

> 4. Find out whether a previous version of Compaq Fortran is installed by entering the following command:

>     # setld -i | egrep 'PSESH|DFA|HPFLIBS|XMD|OTABASE'

> 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

> For more information on deleting subsets for previous versions before continuing the installation (including Compaq Fortran subsets also used by other products), see Section 4.2, "How to Delete Compaq Fortran from Your System".
> 1. Specify the /mnt directory to be the mount point for the distribution file system on the drive. For example, 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 cover letter, as described in Section 1.2, "Reading the Release Notes and Cover Letter".
> 1. To verify the location of the Compaq Fortran main product directory on the appropriate media CD-ROM (see step 1), enter an ls command such as the following:

>     # ls /mnt/product-directory/kit

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

> In this example, product-directory is the main Compaq Fortran directory (such as dfa500) listed in the Software Product Library CD-ROM User's Guide and CD master index file.

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

> See Section 3.3, "Selecting Compaq Fortran Subsets", to continue the installation.

> ## 3.2 How to Install Your Kit Remotely Using a Remote Installation Service (RIS) Distribution Area

> 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:

> RIS 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 3.3, "Selecting Compaq Fortran Subsets", to continue the installation.

> ## 3.3 Selecting Compaq Fortran Subsets

> #### Note:

> Examples in this section use generic version numbers, such as Vn.n, or (in subset identifiers), nnn. During installation, the actual version numbers will appear on your screen.

> The actual subset numbers are listed in the Release Notes (see Section 1.2, "Reading the Release Notes and Cover Letter").

> #### Note:

> If you are installing from a RIS distribution area, the numbers of the Compaq Fortran subsets can vary depending on what products are available in the RIS area and how many subsets they have.

> The installation proceeds as follows:

>     The subsets listed below are optional:
>     	There may be more optional subsets than can be presented on a single
>     	screen. If this is the case, you can choose subsets screen by screen
>     	or all at once on the last screen. All of the choices you make will
>     	be collected for your confirmation before any subsets are installed.
>     1) CXML Common Files for the Extended Math Lib, Vn.n
>     2) CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n
>     3) CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n
>     4) CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n
>     5) CXML Reference (man)Pages
>     6) CXML Reference (man)Pages in HTML format
>     7) CXML Vn.n SCIPORT library
>     8) Compaq Compiled Code Support Library #nnn
>     9) Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems
>     10) Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77)
>     11) Compaq Fortran Vn.n High Performance Fortran Runtime Libraries V1.8-5
>     12) Compaq Fortran Vn.n Release Notes and Man Page
>     13) Compaq Fortran Vn.n Tools & their Man Pages
>     Or you may choose one of the following options:
>     14) ALL of the above
>     15) CANCEL selections and redisplay menus
>     16) EXIT without installing any subsets
>     Enter your choices or press RETURN to redisplay menus.
>     Choices (for example, 1 2 4-6): 1,3,5-13

> The actual display shown on your system might not include certain lines if you have a recent version of Compaq Fortran installed. For example, if the same version of the "Compaq Fortran RTL #nnn for Tru64 UNIX Alpha" (subset DFARTL) on the Compaq Fortran kit has already been installed, that line will not be displayed.

> The following text in this section assumes this is a new installation.

> To compile and run Fortran programs using the Compaq Fortran tools, you must choose subset numbers 8, 9, and 10.

> To use HPF parallel directives with Compaq Fortran 95/90, you must also choose subset number 11.

> To use the Compaq Extended Math Library, you must also choose subset numbers 1 and 7, and one of the following: 2, 3, or 4 (the other numbers are optional). For more information, see Section 3.4, "Installing the Compaq Extended Math Library (CXML)".

> To install only the Release Notes without installing Compaq Fortran, choose subset number 12.

> If you specify more than one number at the prompt, use spaces (not commas) to separate the numbers.

> Enter 14 to install all of the listed subsets.

> Next, the procedure lets you verify your choice. For example, if you enter 14 in response to the previous prompt, the following display appears:

>     You are installing the following optional subsets:
>     	CXML Common Files for the Extended Math Lib, Vn.n
>     	CXML Extended Math Libraries (Serial and Parallel) for Ev4, Vn.n
>     	CXML Extended Math Libraries (Serial and Parallel) for Ev5, Vn.n
>     	CXML Extended Math Libraries (Serial and Parallel) for Ev6, Vn.n
>     	CXML Reference (man)Pages
>     	CXML Reference (man)Pages in HTML format
>     	CXML Vn.n SCIPORT library
>     	Compaq Compiled Code Support Library #nnn
>     	Compaq Fortran 95/90 and 77 Vn.n for Compaq Tru64 UNIX Alpha Systems
>     	Compaq Fortran RTL #nnn for Compaq Tru64 UNIX Alpha Systems (f90 and f77)
>     	Compaq Fortran Vn.n (ECO1) High Performance Fortran Runtime Libraries V1
>     	Compaq Fortran Vn.n Release Notes and Man Page
>     	Compaq Fortran Vn.n Tools & their Man Pages

>     Is this correct? (y/n):

> If the displayed subsets are not the ones you intended to choose, enter n. In this case, the subset selection menu is again displayed, and you can correct your choice of optional subsets.

> If the displayed subsets are the ones you want to load, enter y.

> The installation procedure loads and verifies the selected Compaq Fortran subsets.

> ## 3.4 Installing the Compaq Extended Math Library (CXML)

> If you install CXML, the installation procedure asks several questions pertaining to choices of subsets, libraries, and names of libraries.

> When installing CXML, you must install a minimum of the following subsets:

> - CXML Common Files for the Extended Math Library (XMDCOMnnn)
> - One or more of the following:
> - CXML Extended Math Libraries (Serial and Parallel) for EV4 (XMDLIB4nnn)
> - CXML Extended Math Libraries (Serial and Parallel) for EV5 (XMDLIB5nnn)
> - CXML Extended Math Libraries (Serial and Parallel) for EV6 (XMDLIB6nnn)
> For more information, see Section 3.4.1, "Selecting XMDLIB Subsets" and Section 3.4.2, "CXML Library Names".

> Optionally, you can also install one or more of the following:

> - CXML SCIPORT Library (XMDSCInnn)
> - CXML Reference (man) Pages (XMDMANnnn)
> - CXML Reference (man) Pages in HTML format (XMDHTMnnn)

> ### 3.4.1 Selecting XMDLIB Subsets

> For information about these subsets, see Section 2.6.8, "XMDLIB4nnn, XMDLIB5nnn, XMDLIB6nnn Subsets".

> Typically, you choose to install only one of these subsets, but you can install any number of them. For best performance, Compaq recommends that you install the subset that matches the platform's processor type. For example, install the EV5 library for EV56 systems and the EV6 library for EV67 systems.

> If you select a subset that does not match your platform's hardware, the installation procedure will verify that you want to continue to install that subset.

> By default, both the serial and the parallel CXML libraries will be installed. You can choose to install only the serial CXML or only the parallel CXML library.

> By default, both shared and archive CXML libraries will be installed. You can choose to install only shared libraries (for example, libcxml.so) or only archive libraries (for example, libcxml.a).

> ### 3.4.2 CXML Library Names

> If you install an XMDLIB subset that matches the platform, the installation procedure will construct the CXML libraries you selected with names that show the platform explicitly (for example, libcxml_ev5.so). It will also construct symbolic links from
> /usr/lib or /usr/shlib to the selected libraries.

> By default, this installation will also construct symbolic links from the standard CXML library names (for example, /usr/shlib/libcxml.so) to your selected libraries, unless you select not to use standard names.

> If you install an XMDLIB subset that does not match the platform, the installation procedure will ask you if you want the CXML libraries you are currently installing to have the standard CXML library names (for example, /usr/shlib/libcxml.so) as well as the platform-specific names.