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 18.1

Released: May 04, 2018

What's new in 18.1

Arm Performance Reports 18.1 covers the following releases:

  • Arm Performance Reports 18.1.1 - Released 8th March 2018
  • Arm Performance Reports 18.1.2 - Released 29th March 2018
  • Arm Performance Reports 18.1.3 - Released 4th May 2018

New features and enhancements

  • Updated our licensing model to include a new “Arm Allinea Studio” license type.
  • Significantly reduced the overhead of Arm Performance Reports when profiling executables or shared libraries that do not include .eh_frame_header sections.
  • Added support of numactl for Arm Performance Reports.
  • Improved the documentation related to custom metrics.

Bug fixes

  • Fixed a bug causing Arm Performance Reports to report a tcmalloc error when trying to profile a dynamic executable compiled in an Intel programming environment on Cray systems.
  • Fixed a visualization glitch in the user guide.

Release Note for Release History 18.1

Copyright (c) 2002-2018 Arm Limited (or its affiliates). All rights reserved.

Arm Performance Reports 18.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 18.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.

Changes in this release

New features and enhancements

  • Updated our licensing model to include a new “Arm Allinea Studio” licence type.
  • Significantly reduced the overhead of Arm Performance Reports when profiling executables or shared libraries that do not include .eh_frame_header sections.
  • Added support of numactl for Arm Performance Reports.
  • Improved the documentation related to custom metrics.

Bug fixes

  • Fixed a bug causing Arm Performance Reports to report a tcmalloc error when trying to profile a dynamic executable compiled in an Intel programming environment on Cray systems.
  • Fixed a visualization glitch in the user guide.

Known issues

Please refer to the Known issues page.

System requirements

Please refer to the Supported platforms page.

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.

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 licenses may be obtained from the Arm website.

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, for example:

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

If {arm-reports-path}/bin is in your $PATH, just type:

perf-report

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 or -o argument to specify a single output file name.

See perf-report --help or the Arm Performance Reports 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:

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

Further documentation, help and tutorials can be found on the Arm Developer website.

Support

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