This document contains the information you need to install the Graphical Program Analysis Tools (GPA) Version 3.0-(n) (where n is the current incremented version) on a Compaq Tru64 UNIX [Footnote 1] system. You must read this document before installing GPA.
You need an Alpha system, workstation monitor or terminal, and the following media drives depending on your distribution kit:
If your distribution kit is on... | You need this hardware drive... |
CD-ROM optical disk |
RRD42 or RRD43 optical disk drive |
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:
Contents | Disk Space |
Graphical Program Analysis Base for Compaq Tru64 UNIX |
27,200 KB in
|
Graphical Program Analysis Local Clients |
9,100 KB in
|
|
TOTALS: 36,300 KB |
The following steps provide a summary of the steps for installing GPA:
Back up your system disk before installing any software. For details on performing a system disk backup, refer to your system's documentation.
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 Section 1.10
Log in as superuser (login name
root
)
to the system where you are installing GPA.
Determine if you have enough available disk space for the installation and add more if necessary. (See Section 1.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.
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
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 1.0 base subset, enter
the following command:
# /usr/sbin/setld -d GPABASE100
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:
# /usr/sbin/setld -l .
Note that the period (.
) in thesetld
command is required.
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.
The installation script prompts you to confirm your
subset selections.
Enter
y
and press Return to
confirm.
The installation script installs the software and displays messages describing the 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.
You must have the Developer's Toolkit license (the OSF-DEV
Product Authorization Key or OSF-DEV PAK) 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.
To determine the current amount of free space for a directory path:
Log in to the system where you plan to install GPA.
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.
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:
Log in as superuser (login name of
root
).
Create the directory
/usr/opt/GPA30(n).
Specify in the
/etc/fstab
file
that the newly created directory is a mount point to new disk partitions
where there is additional space.
Enter the
mount /usr/opt/GPA30(n)
command to have the new mount point take effect.
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.
Use the
setld
command to deinstall GPA:
# /usr/sbin/setld -d GPABASE30(n) GPALCLCLIENTS30(n)
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
, anddxheap
.
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.
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:
Log in as superuser (login name
root
)
to the system where you are installing GPA.
Enter the following command to ensure that you are at the root (/) directory:
# cd /
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.
Enter the numbers of the GPA subsets that you want
to install and press Return.
The
setld
utility
installs GPA on the client machine.
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:
The following sample session describes how to add GPA to
the
ris0.alpha
area:
Log in as the superuser (login name
of
root
).
Enter the following command to invoke the RIS utility:
# /usr/sbin/ris
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
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
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
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
After the subsets are installed, the following message appears:
Media extraction complete.
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.
1999 Digital Equipment Corporation. All rights reserved.