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

Arm Performance Reports 20.0.3 helps you characterize and understand the performance when running your HPC application, in a simple one-page report.

Contents
========

This document provides information specific to the 20.0.3 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, see the release history online:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-performance-reports/release-history

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

- New features and enhancements:

None in this release.

- Bug fixes:

None in this release.

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

See the known issues section on the Arm Developer website at:

https://developer.arm.com/docs/101137/latest/known-issues


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

See the supported platforms pages on the Arm Developer website at:

https://developer.arm.com/docs/101137/latest/supported-platforms

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

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

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

When installing on a cluster, ensure that the package is available at the same path on every machine.

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

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
========

To get licence files for each product, contact Arm by emailing HPCToolsSales@arm.com. You can obtain evaluation licences from the Arm website at:

https://www.arm.com/products/development-tools/server-and-hpc/allinea-studio/get-software

Licence files must be stored in a directory called licences below the installation directory.

For a default (root) installation, the licences directory is:

   /opt/arm/reports/licences

For a default user-only installation, the licences directory is:

   ${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'.

The program you runs runs as previously, and two report files, one .txt and one .html, arecreated in the current directory on completion. If you have problems starting your program under Performance Reports, ensure thta 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 is available in the installation directory:

   <INSTALL_DIR>/examples

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

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

After you install Arm Performance Reports, you can find a copy of these release notes in the installation directory. You can also find them online at:

https://developer.arm.com/tools-and-software/server-and-hpc/downloads/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 are available online at:

https://developer.arm.com/tools-and-software/server-and-hpc/help

Support
=======

If you require support or would like to provide feedback, open a support case, or use our support request form online:

https://developer.arm.com/tools-and-software/server-and-hpc/help

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

Arm Performance Reports 19.1.4 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.4 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
=======================

- New features and enhancements:

None in this release.

- Bug fixes:

[FOR-8192] The link to the Arm website from the Arm Performance Reports logo now takes you to the Arm Developer website, for more relevant information.

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

Changes in this release

Arm Performance Reports 19.0 covers the following releases:

• Arm Performance Reports 19.0.0 - Released 7th December 2018
• Arm Performance Reports 19.0.1 - Released 18th December 2018
• Arm Performance Reports 19.0.2 - Released 25th January 2019
• Arm Performance Reports 19.0.3 - Released 1st March 2019
• Arm Performance Reports 19.0.4 - Released 29th March 2019
• Arm Performance Reports 19.0.5 - Released 3rd May 2019

New features and enhancements:

19.0.0

• None in this release.

19.0.1

• None in this release.

19.0.2

• None in this release.

19.0.3

• None in this release.

19.0.4

• Support for profiling debug versions of Python.

19.0.5

• None in this release

Bug fixes:

19.0.0

• [FOR-5412] You can now launch serial programs that are in the environment's path without specifying the full path.
• [FOR-6217] Fixed an issue that caused a slowdown in the analysis phase.

19.0.1

• [FOR-6407] Fixed a startup issue with CRAY ALPS.

19.0.2

• [FOR-6510] Arm Performance Reports can now profile applications when SHELL is unset.

19.0.3

• [FOR-6564] The Known Issues section of the Forge user guide has been updated to describe compilation flags for OpenMPI 3.x with GCC, to fix a startup issue.
• [FOR-6644] Re-enabled Accelerator Metrics.

19.0.4

• [FOR-6791] Fixed an issue that causes the incorrect number of physical cores to be reported.
• [FOR-6886] Fixed an issue that occurs when using the PGI compiler to link with the static MAP sampler library.

19.0.5

• [FOR-6988] Fixes an issue when debugging static PGI binaries.
• [FOR-7106] Fixes an issue where the number of OpenMP threads were not being set correctly when using express launch.
• [FOR-7094] Fixes an issue where processes launched by srun would have their CPU affinity settings reset.

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. Get an evaluation licence.

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

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:

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

If {arm-reports-path}/bin is in your $PATH, you can use:

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 --outputor -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 on the Release History page on the Arm Developer website.

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.

Changes in this release

New features and enhancements:

• Performance Reports is now supported on IBM Power 8 and 9 systems.
• Reduced runtime overhead when profiling OpenMP programs with short running parallel regions.
• Updated supported platforms information in the Appendix of the user guide.

Bug fixes:

• [FOR-5909] Fixed an issue where the Windows client could not establish a multihop remote connection.

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>

Licenses

If you do not have a license file you will need to obtain one from Arm. Evaluation licenses may be obtained from the Arm website: https://www.arm.com/products/development-tools/hpc-tools/get-software.

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

/opt/arm/reports/licences

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

Or, if {arm-reports-path}/bin is in your $PATH, you can use

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/-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.

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

Arm Performance Reports 18.2 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.2 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 18.2.0
=============

- New features and enhancements:

None in this release.

- Bug fixes:

Fixed bug causing the PAPI.config file to be read incorrectly.

Changes in 18.2.1
=============

- New features and enhancements:

None in this release.

- Bug fixes:

Fixed issue where running the GUI installer as root you could not install to an NFS directory.

Changes in 18.2.2
=============

- New features and enhancements:

None in this release.

- Bug fixes:

None in this release.

Changes in 18.2.3
=============

- New features and enhancements:

None in this release.

- Bug fixes:

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

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.

Changes for Arm Performance Reports 18.0.2:

• Fixed a bug that caused startup to fail with OpenMPI on Cray systems. 
• Several pthread functions are now correctly classified as "synchronization" functions as opposed to "computing" functions.
• Improved the test examples compilation procedure.

Changes for Arm Performance Reports 18.0.1:

• Fix incorrect metric values seen on Ubuntu 16.04.
• Add user-friendly warning messages displayed for unknown or incompatible configuration options.

Changes for Arm Performance Reports 18.0:

• Update the tools branding, from Allinea Performance Reports to Arm Performance Reports.
• Arm Performance Reports is now part of Arm Allinea Studio toolkit for AArch64. The tools remain cross-platform.
• Add support for Arm HPC Compiler 18.0.
• Add support for Red Hat 7.4 and Ubuntu 16.04 on AArch64.
• Improve profiling performance with WRF when using SGI MPT.
• Update our EULA.