 

Installation Instructions: Graphical 
Program Analysis Tools Version 3.0

This document contains the information you need to install the Graph-
ical Program Analysis Tools (GPA) Version 3.0-(n) (where n is the cur-
rent incremented version) on a Compaq Tru64 UNIX system. You must read 
this document before installing GPA.

GPA Kit Summary

Product Name: Graphical Program Analysis Tools (GPA) Version 3.0-(n) 
for Compaq Tru64 UNIX

Operating system: Compaq Tru64 UNIX Version 4.0D for Alpha Systems or 
higher

Required Hardware

You need an Alpha system, workstation monitor or terminal, and the fol-
lowing media drives depending on your distribution kit:

Required Hardware Drives

If your distribution kit is on...     You need this hardware drive...

CD-ROM optical disk                   RRD42 or RRD43 optical disk drive

Required Software

Required Compaq Tru64 UNIX Subsets

Contents                              Subset Name

Tru64 UNIX  Base System               OSFBASE425 or higher

Tru64 UNIX  Networking Utilities      OSFCLINET425 or higher

Standard Programmer Commands 
(Software Development)                OSFPGMR425 or higher

Software Development Tools and 
Utilities                             OSFSDE425 or higher

The following table lists required GPA subsets along with sizes:

GPA Subset Names and Sizes

Contents                              Disk Space

Graphical Program Analysis 
Base for Compaq Tru64 UNIX            27,200 KB in /usr/opt

Graphical Program Analysis 
Local Clients                         9,100 KB in /usr/opt



                                      TOTALS: 36,300 KB

Installation Summary

The following steps provide a summary of the steps for installing GPA:

1.	Back up your system disk before installing any software.   For 
details on performing a system disk backup, refer to your system's 
documentation.

2.	Determine the type of installation you are doing.

If you are performing a local installation of GPA, mount the CD-ROM 
containing the GPA kit.

If you copied the UNIX server-side tar files to a temporary area 
from the FTP or Web site, expand the GPA file by using the following: 
tar -xvf gpa30(n).tar where (n) is the current incremented 
version, for example, 5.  

If you are installing GPA subsets from a Remote Installation Services 
(RIS) server area of a remote system to your local system, 
first check with your site system administrator to make sure that:

-	A GPA kit is installed in the RIS server area and is available 
for use.

-	Your system is registered as a RIS client.

If the GPA subsets are available on a RIS server system, you need 
the name of that system to start the installation procedure.

See "Installing into a RIS Server Area" on page 6. 

3.	Log in as superuser (login name root) to the system where you 
are installing GPA.

4.	Determine if you have enough available disk space for the 
installation and add more if necessary.  (See "Increasing Disk Space for 
the GPA Installation" on page 4.)

5.	Make sure /usr/tmp and /tmp have read and write permissions for 
all GPA users. Without read and write permissions on these directories, 
GPA will not start.

6.	If necessary, delete old GPA kits.  Use the setld -i command to 
list the subsets installed on your system and check for the presence 
of any subset with a name that starts with GPA.  For example:

# /usr/sbin/setld -i | grep GPA | grep installed

If any of these subsets exist, they are old versions that must be 
deleted. To delete a subset, use the setld -d command. For example, 
to delete the Version 2.0 base subset, enter the following command:

# /usr/sbin/setld -d GPABASE200

7.	Use the setld -l (load) command to specify the full pathname of 
the directory on the CD-ROM containing the GPA software:

 # /usr/sbin/setld -l `directory-name'

Note: If you downloaded the files from an FTP or Web site, you 
should set your working directory to the gpa.kit subdirectory and 
then use the following setld command:

8.	# /usr/sbin/setld -l .

Note that the period (.) in the setld command is required.

9.	The installation script lists the subset choices:

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) Graphical Program Analysis Base V3.0-(n) for Tru64 UNIX                                             
2) Graphical Program Analysis Local Clients V3.0-(n)                       

Enter your choices or press RETURN to display the next screen.

Choices (for example, 1 2 4-6):                                               

Or you may choose one of the following options:

5) ALL of the above
6) CANCEL selections and redisplay menus
7) EXIT without installing any subsets

Enter your choices or press RETURN to redisplay
menus.

Choices (for example, 1 2 4-6): 5

Enter the numbers of the subsets to install and press Return.

10.	The installation script prompts you to confirm your subset 
selections. Enter y and press Return to confirm.

11.	The installation script installs the software and displays 
messages describing the installation.

Verifying the GPA Installation

After you install GPA, you can run the Installation Verification 
Procedure (IVP) for each of the four subsets.

To verify the GPA base subset, enter the following command:

# setld -v GPABASE30(n)

(n) is the current incremented version number, for example, 5.

The Installation Verification Procedure (IVP) runs and displays 
information on your terminal.  The IVP ends with the following text:

The IVP completed successfully.

To verify the local clients, enter the following command:

# setld -v GPALCLCLIENTS0(n)

The IVP runs and displays information on your terminal, ending with a 
message that the IVP completed successfully.

Registering an OSF-DEV License to Use GPA

You must have the Developer's Toolkit license (the OSF-DEV or OSF-DEV-
USER Product Authorization Key) loaded in order to run the GPA tools.  
If you do not have this PAK, contact your local authorized Compaq sales 
representative or visit the software licensing Web site at 
www.digital.com/software-licensing for information.

Increasing Disk Space for the GPA Installation

To determine the current amount of free space for a directory path:

1.	Log in to the system where you plan to install GPA.

2.	Check which file systems are mounted and where they are by 
displaying 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
/usr/man@bigsys:/usr/man:ro:0:0:nfs:bg:

In this example, /usr (mounted to /dev/rd0g) is the only mount 
point that affects where GPA files will reside; the system has only 
one local disk drive and the /usr file system resides in the g partition 
of the disk on that drive.

3.	Enter the df command to determine total space and free space for 
the file system where GPA files will reside. Based on the preceding 
display of the /etc/fstab file, which shows that only /usr is a 
mount point, you will only need to inspect free space in the /usr 
file system.

# df -k /usr

Filesystem Total   kbytes  kbytes %

node       kbytes  used    free    used    Mounted On

/dev/rd0g  122598  54447   55892   49%     /usr

This display indicates that there are 55,892 KB free.

The GPA installation procedure creates the directory /usr/opt/
GPA30(n), if it does not already exist, and loads files into subordinate 
directories. If you have insufficient disk space for the GPA subsets 
and know that you have additional space on alternative disks or 
disk partitions for your system, you can take the following steps before 
installing GPA:

1.	Log in as superuser (login name of root).

2.	Create the directory /usr/opt/GPA30(n).

3.	Specify in the /etc/fstab file that the newly created directory 
is a mount point to new disk partitions where there is additional 
space.

4.	Enter the mount /usr/opt/GPA30(n) command to have the new mount 
point take effect.

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.

Deinstalling the Software

Use the setld  command to deinstall GPA: 

# /usr/sbin/setld -d GPABASE30(n) GPALCLCLIENTS30(n)

Running the GPA Tools After Installation

To run the Memory Profiler, Process Viewer, Performance Profiler, or 
Heap Analyzer from the command line after installation, use the 
following commands, respectively: mview, pview, dxprof, or dxheap.  To 
view the man pages, use the following commands: man mview, man pview, 
man dxprof, and dxheap.

Error Recovery

If errors occur during the installation, the system displays error 
messages. If the installation fails due to insufficient disk (file 
system) space, the installation procedure displays the following message:

fitset:
filesystem /usr needs xxx kbytes more to install the
software specified

An error can also occur during the installation if:

- 	The operating system version is incorrect.

- 	The Networking Utilities subset is not installed.

For more information about error messages generated during installation, 
see your system's documentation on system messages, recovery procedures, 
and software installation. If you are notified that any errors 
occurred, take the appropriate action as described in that documentation.

Installing into a RIS Server Area

You can install GPA with the Remote Installation Services (RIS) utility 
into a RIS server area on a Tru64 UNIX system. You do not use the setld 
command for this operation. To install GPA from a RIS server to a RIS 
client, you must first install GPA in your RIS server environment. See 
your RIS manager if GPA is not already installed on the RIS server.

To install GPA subsets that reside in a /var/adm/ris distribution area 
on a remote system, start the installation procedure as follows:

1.	Log in as superuser (login name root) to the system where you are 
installing GPA.

2.	Enter the following command to ensure that you are at the root (/) 
directory:

# cd /

3.	Enter a setld command that requests the load function and 
identifies the system where the GPA subsets are located.

For example, if you are loading GPA subsets from a RIS distribution 
area on node bigsys, enter the following command:

# setld -l bigsys:

RIS then displays a menu that lists all the software subsets available 
to you and prompts you to enter the numbers of the ones you want to load.

Note that the numbers of the GPA subsets vary from system to system, 
depending on which products are available in the RIS area and 
how many subsets each has.

4.	Enter the numbers of the GPA subsets that you want to install and 
press Return. The setld utility installs GPA on the client machine.

RIS Disk Space Requirements

The disk space requirements in these installation instructions do not 
apply if you are installing GPA into a RIS server area.  In this case, 
you do not create GPA file systems but use the RIS utility to extract 
files from media.  Furthermore, GPA files are compressed during the 
extraction process and require the following amounts of disk space to 
be available in the RIS server area:

GPA Version 3.0-(n) - 12,600 KB

Sample RIS Installation

The following sample session describes how to add GPA  to the ris0.alpha 
area:

1.	Log in as the superuser (login name of root).

2.	Enter the following command to invoke the RIS utility:

# /usr/sbin/ris

3.	Select the Install Software option from the RIS main menu by 
entering i at the prompt:

*** RIS Utility Main Menu ***

a) ADD a client
d) DELETE software products
i) INSTALL software products
l) LIST registered clients
m) MODIFY a client
r) REMOVE a client
s) SHOW software products in remote installation environments  
x) EXIT     

Enter your choice: i

4.	Choose option 2 from the RIS Software Installation Menu:

RIS Software Installation Menu:

1) Install software into a new area
2) Add software into an existing area
3) Return to previous menu

Enter your choice: 2

5.	A list of available environments appears from which you might 
select ris0.alpha:

You have chosen to add a new product into an
existing environment.

Select the remote installation environment:

1 /usr/var/adm/ris/ris0.alpha

 (list of available products for environment)

.
.
.

2 /usr/var/adm/ris/ris0.vax

 (list of available products for environment)

.
.
.

Enter your choice: 1

6.	The installation procedure then prompts you for an input device 
name:

Enter the device special name or mount point of
the distribution media, for example, /dev/rmt0h:

/dev/rmt0h

7.	After the subsets are installed, the following message appears:

Media extraction complete.

8.	When the RIS main menu appears, choose the m menu item (Modify 
Client) to add GPA to the list of products that RIS clients can install.



Copyright 2000 Digital Equipment Corporation.  All rights reserved.
