Linaro Performance Reports is a simple tool used to generate a single-page HTML or plain text report that presents the overall performance characteristics of HPC applications. It supports pthreads, OpenMP, or MPI code on CPU, GPU, and MIC based architectures.
Availability and Restrictions
Versions
The versions currently available at OSC are:
| Version | Owens | Pitzer | Ascend |
|---|---|---|---|
| 22.0.2 | X | X | X |
| 23.1 | X* | X* | X* |
You can use module spider linaro-pr to view available modules for a given machine. Feel free to contact OSC Help if you need other versions for your work.
Access
Linaro Performance Reports is available to all OSC users. We have 64 seats with 64 HPC tokens. Users can monitor the license status here.
Publisher/Vendor and License Type
Linaro, Commercial
Usage
Set-up
To load the module for the Linaro Performance Reports default version, use module load linaro-pr. To select a particular software version, use module load linaro-pr/version. For example, use module load linaro-pr/6.0 to load Linaro Performance Reports version 6.0, provided the version is available on the OSC cluster in use.
Using Linaro Performance Reports
You can use your regular executables to generate performance reports. The program can be used to analyze third-party code as well as code you develop yourself. Performance reports are normally generated in a batch job.
To generate a performance report for an MPI program:
module load linaro-pr perf-report -np <num procs> --mpiargs="<mpi args>" <program> <program args>
where <num procs> is the number of MPI processes to use, <mpi args> represents arguments to be passed to mpiexec (other than -n or -np), <program> is the executable to be run and <program args> represents arguments passed to your program.
For example, if you normally run your program with mpiexec -n 12 wave_c, you would use
perf-report -np 12 wave_c
To generate a performance report for a non-MPI program:
module load linaro-pr perf-report --no-mpi <program> <program args>
The performance report is created in both html and plain text formats. The file names are based on the executable name, number of processes, date and time, for example, wave_c_12p_2016-02-05_12-46.html. To open the report in html format use
firefox wave_c_12p_2016-02-05_12-46.html
For more details, download the Linaro Performance Reports User Guide.
Performance Reports with GPU
Linaro Performance Reports can be used for CUDA codes. If you have an executable compiled with the CUDA library, you can launch Linaro Performance Reports with
perf-report {executable}
For more information, please read the section 6.10 of the Linaro Performance Reports User Guide.
