1 PGHPF 3.0
Installation Notes

• 1.1 Installing PGHPF

The PGHPF compilers and tools are license-managed using the FLEXlm license management system. FLEXlm allows multiple users to use PGHPF and PGPROF simultaneously, up to the limit specified for the license you purchased. This section describes how to install PGHPF and PGPROF, as well as the necessary components to enable license-management using FLEXlm.

Once PGHPF and PGPROF are installed, you must install FLEXlm license keys that will make these tools operational. A license key is a text file supplied by PGI that is unique to your system. There is additional information below on how to obtain and install demo or permanent PGHPF license keys from PGI. Executable files generated with permanent license keys in place are unconstrained, and will run on any compatible system regardless of whether PGHPF is installed.

For the first 60 days after your purchase, you may send technical questions about these products to the e-mail address trs@pgroup.com. If you have purchased maintenance, you will have access to e-mail and/or phone support service for an additional 12 months and will be notified by e-mail when maintenance releases occur and are available for electronic download and installation. Contact PGI at sales@pgroup.com or your local PGI distributor if you would like more information regarding PGI's software maintenance service for the PGI products you have purchased.

1.1 Installing PGHPF

Bring up a shell command window on your system. The instructions below assume you are using csh, sh, ksh, or some compatible shell. Appropriate modifications will be necessary when setting environment variables if you are using a shell that is not compatible with one of these three.

Step 1 - Create the directory in which you wish to install the software. Common locations would be /usr/pgi or /usr/local/pgi, but installation can occur in any directory where you have appropriate permissions. Please make sure that the installation directory has the necessary ownership and permissions appropriate for your site by using the chown and chmod commands.

The following assumes installation in /usr/pgi. Set the environment variable PGI to the name of the installation directory. Assuming csh:

       % setenv PGI /usr/pgi

Or, assuming sh or ksh:

       % PGI=/usr/pgi
       % export PGI

Step 2 - If you received this software on a CD-ROM, please skip to step 3. If you downloaded the software from ftp://ftp.pgroup.com or another PGI electronic distribution site, then in the instructions that follow, <tarfile> needs to be replaced with the name of the file that was downloaded.

The compressed tar file needs to be uncompressed and untar'd before installation.

       % gunzip <tarfile>.tar.gz
       % tar xpf <tarfile>.tar

Note that the products cannot be installed into the same directory where the tar file is unpacked, so it is recommended you execute the above commands in /tmp or another location that is not the installation directory.

If you are downloading software from the Internet and installing multiple products onto a single system, then you must retrieve all of the tar files that you wish to install before running the install script.

All software should fit into less than 35 MB of disk space. Approximately 70 MB are required during installation. Half of that can be recovered by deleting the tar file after installation is complete.

Step 3 - The install script must be run to properly install the software. If you are installing from a CD-ROM, issue the following command:

       % /mnt/cdrom/install

NOTE: If you have difficulty running this script check the permissions on /dev/null. Permission should be set to "crw-rw-rw-". Re-set permissions to this value if necessary.

Also note that some systems use a CD-ROM volume manager that may insert an additional directory in the above pathname. For example, the pathname might be

       % /cdrom/pgisoft/install

on a Solaris system using volume management. If you are not sure how to access the CD-ROM drive, check with your system administrator.

If you downloaded the software from the Internet, change to the directory where you uncompressed and untar'd the tar file, and run:

       % ./install

The install script will list the products that are available on this CD-ROM. You will be asked which products should be installed and to select an installation directory. After the software is installed, the script will do some system-specific customization and then initialize the licensing, which is covered in step 4 below.

Step 4 - All PGI products are license-managed. To use the software, you must obtain a license key from PGI. You may request a 30 day evaluation license by sending electronic mail containing the following information to sales@pgroup.com:

1. Name
2. Organization
3. Position or title
4. Phone
5. FAX
6. E-mail address
7. Full street address
8. List of products you wish to evaluate
9. Host ID(s) of the system(s) on which you wish to perform the
evaluation

You can determine the FLEXlm host ID of your system by executing the command

	% $PGI/<arch>/bin/lmutil lmhostid

where <arch> is replaced with the the appropriate modifier based on the product you installed. Table 1-1 lists the modifier for each supported target system:

After the information is sent to PGI, a demo or permanent license will be returned to you. Once you have obtained your permanent license keys, place them in the file $PGI/license.dat or add them to an existing FLEXlm license.dat file if you are using FLEXlm to license-manage other software products.

At this point, if you do not already have a FLEXlm license daemon running, you must start a FLEXlm license daemon on your system. Consult your system administrator or the FLEXlm User's Guide for more information on this procedure.

Step 5 - You can view the online HTML documentation using any web browser. Assuming you use netscape, issue the following command:

       % netscape $PGI/doc/pgi.index.html

You may want to place a bookmark on this location for easy future reference to the online manuals.

Step 6 - With either the temporary or permanent license file in place, execute the following commands to make the PGI products you have purchased accessible. Depending on the target system on which you're installing PGHPF, substitute the appropriate path modifier from table 1-1 in place of <arch> in the commands that follow:

Assuming csh:

       % setenv PGI /usr/pgi
       % set path = ( $PGI/<arch>/bin $path )
       % setenv MANPATH "$MANPATH":$PGI/man

Or, assuming sh or ksh:

       % PGI=/usr/pgi
       % export PGI
       % PATH=$PGI/<arch>/bin:$PATH
       % export PATH
       % MANPATH=$MANPATH:$PGI/man
       % export MANPATH

You should add the above commands to your startup files to ensure you have access to the PGI products upon future logins.

Step 7 - You can verify the release number of the product you have installed using the -dryrun -V options on any of the compiler commands. This will also show you the sequence of steps the compiler will use to compile and link programs for execution on your system:

% pghpf -dryrun -V x.f

Note that the file x.f need not exist in order for you to successfully execute this command.

Installation is now complete. For the first 60 days after your purchase, you may send technical questions about these products to the e-mail address trs@pgroup.com. If you have purchased maintenance, you will have access to e-mail service and automatic upgrade releases for an additional 12 months and will be notified by e-mail whenever a new release is available for electronic download and installation. Contact PGI at sales@pgroup.com if you would like information regarding PGI's subscription service for the PGI products you have purchased.