HP XC System 3.x Software - Manual (Page 35)

4 Using HPCPI
This chapter describes how to perform basic HPCPI tasks, including how to start HPCPI, control
the HPCPI daemon, and view data using HPCPI tools. This chapter also includes tips on using
HPCPI.
This chapter addresses the following topics:
•
“Starting HPCPI” (page 35)
— “Setting Up the HPCPI Environment” (page 35)
— “Selecting a Location for the HPCPI Database Directory” (page 36)
— “Setting the Default Database Directory Environment Variable (HPCPID)” (page 36)
— “Starting the hpcpid Daemon” (page 36)
— “Selecting Events to Monitor” (page 37)
• “Running an Application for Analysis” (page 40)
• “Controlling the Daemon with hpcpictl” (page 41)
• “Viewing Data with hpcpiprof, hpcpilist, and hpcpitopcounts” (page 43)
• “Viewing Per-Image Data: hpcpiprof” (page 44)
• “Viewing Per-Procedure Data: hpcpiprof image_name” (page 46)
• “Viewing Per-Instruction Data: hpcpilist procedure_name image_name” (page 47)
• “Listing the Instructions with the Highest Event Counts: hpcpitopcounts” (page 49)
• “Listing Instructions in an Image: hpcpitopcounts image_name” (page 50)
• “HPCPI Utility Options” (page 51)
— “Specifying an Alternate Database” (page 51)
— “Specifying an Alternate Epoch” (page 51)
— “Selecting Data by System” (page 51)
— “Specifying Events to Display” (page 52)
— “Selecting Data by Label” (page 52)
— “Specifying an Alternate Sort Key” (page 53)
— “Limiting the hpcpiprof Output” (page 54)
— “Displaying Raw Values” (page 53)
— “Additional Options” (page 54)
• “Tips and Best Practices for Using HPCPI” (page 55)
Starting HPCPI
This section describes the tasks you must complete to start HPCPI, and describes operating
parameters you can set when you start HPCPI.
Setting Up the HPCPI Environment
On systems with the modules utility, enter the following command to set up the HPCPI
environment:
% module load hpcpi
Alternatively, you can manually add the HPCPI binary directory (/opt/hpcpi/bin) to your
PATH
environment variable, and /opt/hpcpi/man to your MANPATH. For example:
% setenv PATH /opt/hpcpi/bin:$PATH
% setenv MANPATH /opt/hpcpi/man:$MANPATH
Starting HPCPI 35