Arm Performance Reports

This page lists the Arm Performance Reports release history.

To download and install the latest version of Arm Performance Reports, see our downloads page and follow the installation steps given in the Arm Performance Reports user guide.

Details on Release Versions, and links to the Release Notes and Documentation are provided below.

For more compatibility information, see our Known Issues and supported platforms topics.

Arm Performance Reports

Version 19.1 - latest update 19.1.1

Released: June 28, 2019

What's new in 19.1 - latest update 19.1.1

Arm Performance Reports 19.1 covers the following releases:

  • Arm Performance Reports 19.1.1 - Released 28th June 2019
  • Arm Performance Reports 19.1.0 - Released 7th June 2019

New features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • New CPU metrics for IBM Power9 and Armv8-A platforms.

19.1.1

  • None in this release.

Bug fixes

19.1.0

  • [FOR-6642] Improved unwinding for PGI-compiled binaries on IBM Power systems.
  • [FOR-6414] Fixed an issue that occurs when profiling applications that were statically compiled by the PGI compiler.
  • [FOR-6659] Clarified information in the user guide about startup issues with OpenMPI 3.0 and 3.1.
  • [FOR-7236] Fixed an issue where MPI auto-detection did not work with HPE MPT 2.18+.
  • [FOR-7195] Fixed an issue that occurs when output brackets are present in the output file argument.

19.1.1

  • None in this release.

Known issues

Please refer to the known issues page.

Release Note for Release History 19.1 - latest update 19.1.1

Arm Performance Reports 19.1.1 Release Notes
============================================
Copyright (c) 2002-2019 Arm Limited (or its affiliates). All rights reserved.

Arm Performance Reports 19.1 helps you characterize and understand the performance of your HPC application runs in a simple one-page report.

Contents
========

This document provides information specific to the 19.1 release of Arm Performance Reports:

- Changes in this release:
    - New features and enhancements
    - Bug fixes
- Known issues
- System requirements
- Installing, uninstalling, licensing
- Running the tools
- Where to find example code
- How to access user documentation
- How to contact support

For information about previous releases of Arm Performance Reports, refer to the release history online:

https://developer.arm.com/products/software-development-tools/hpc/arm-performance-reports/release-history

Changes in this release
=======================

Arm Performance Reports 19.1 covers the following releases:

  • Arm Performance Reports 19.1.1 - Released 28th June 2019
  • Arm Performance Reports 19.1.0 - Released 7th June 2019

New features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • New CPU metrics for IBM Power9 and Armv8-A platforms.

19.1.1

  • None in this release.

Bug fixes

19.1.0

  • [FOR-6642] Improved unwinding for PGI-compiled binaries on IBM Power systems.
  • [FOR-6414] Fixed an issue that occurs when profiling applications that were statically compiled by the PGI compiler.
  • [FOR-6659] Clarified information in the user guide about startup issues with OpenMPI 3.0 and 3.1.
  • [FOR-7236] Fixed an issue where MPI auto-detection did not work with HPE MPT 2.18+.
  • [FOR-7195] Fixed an issue that occurs when output brackets are present in the output file argument.

19.1.1

  • None in this release.

Known issues
============

Please refer to the known issues section on the Arm Developer website:

https://developer.arm.com/products/software-development-tools/hpc/arm-performance-reports/known-issues


System requirements
===================

Please refer to the supported platforms pages on the Arm Developer website:

https://developer.arm.com/products/software-development-tools/hpc/arm-performance-reports/arm-performance-reports-platforms

Installation instructions
=========================

Run the graphical "installer" or the text-only "textinstall.sh" from the download tarball.

You may choose to install just for you or for all users on your system.

If you are installing on a cluster, please make sure the package is available at the same path on every machine.

Full installation instructions are available in the Arm Performance Reports user guide, available on the Arm Developer website:

https://developer.arm.com/docs/101137/latest/installation

Uninstalling Arm Performance Reports
====================================

To uninstall Arm Performance Reports, remove the installation directory from your system:

rm -r <installation-dir>

Licences
========

If you do not have a licence file you will need to obtain one from Arm. Evaluation licences may be obtained from the Arm website:

https://www.arm.com/products/development-tools/hpc-tools/get-software

Full licences may be obtained by emailing HPCToolsSales@arm.com. Licence files should be stored in a directory called licences below the installation directory. For a default (root) installation, that directory would be:

   /opt/arm/reports/licences

and for a user-only installation it would be:

   ${HOME}/arm/reports/licences

Running Arm Performance Reports
===============================

To run Arm Performance Reports, add 'perf-report' in front of your existing mpiexec or aprun command-line, e.g.:

     {arm-reports-path}/bin/perf-report mpiexec -n 4 examples/wave_c

If {arm-reports-path}/bin is in your $PATH, just 'perf-report' will do.

Your chosen program will be run just as before and two report files, one .txt and one .html will be created in the current directory on completion. If you have problems starting your program under Performance Reports, first ensure it can run without Performance Reports with no errors.

You can use the --output/-o argument to specify a single output file name.

See perf-report --help or the user guide for more information.

Examples
========

Example code can be found in the installation directory:

   <INSTALL_DIR>/examples

Copy the example code to a writeable directory and run the examples using the makefiles provided.

Documentation
=============

Once installed these release notes can be found in the installation directory, and online at:

https://developer.arm.com/products/software-development-tools/hpc/arm-performance-reports/release-history

The Arm Performance Reports user guide is available in the <INSTALL_DIR>/doc directory, or online here:

https://developer.arm.com/docs/101137/latest/introduction

Further documentation, help and tutorials can be found online at:

https://developer.arm.com/products/software-development-tools/hpc/documentation

Support
=======

If you require support or would like to provide feedback, please contact allinea-support@arm.com or use our support request form online:

https://developer.arm.com/products/software-development-tools/hpc/get-support