Arm Forge Release History

This page describes the changes between releases of Arm Forge.

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

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

Arm Forge

Version 19.1 - latest update 19.1.4

Released: October 04, 2019

What's new in 19.1 - latest update 19.1.4

Arm Forge 19.1 covers the following releases:

  • Arm Forge 19.1.0 - Released 7th June 2019
  • Arm Forge 19.1.1 - Released 28th June 2019
  • Arm Forge 19.1.2 - Released 2nd August 2019
  • Arm Forge 19.1.3 - Released 30th August 2019
  • Arm Forge 19.1.4 - Released 4th October 2019

Arm DDT new features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • Fixed an issue where GDB 8.1 would not start on an Ubuntu 16.04 system without libmpfr installed.
  • Support for debugging of IBM Spectrum MPI jobs launched with Spindle.
  • GDB 8.1 is now the default DDT debugger.
  • Support for the GDB 7.10.1 debugger has been removed.
  • Memory Debugging support for PMDK.
  • Support for debugging CUDA 10.0 and 10.1 binaries.
  • Remote connect network traffic is now compressed by default so some actions will now be faster when using this feature.

19.1.1

  • None in this release.

19.1.2

  • Support for Cray Shasta detection.

19.1.3

  • None in this release.

19.1.4

  • None in this release.

Arm DDT bug fixes

19.1.0

  • [FOR-7342] Fixed an issue with memory debugging aligned allocations.
  • [FOR-6659] Clarified information in the user guide about startup issues with OpenMPI 3.0 and 3.1.
  • [FOR-6503] Fixed an issue where variables named "array" in a struct were not evaluated.
  • [FOR-6142] Fixed an issue with memory debug, where the total number of free calls were double counted when using memkind_realloc.
  • [FOR-6049] Fixed an issue with remote client messages when X11 is not available.
  • [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

  • [FOR-7417] Track memory allocations for Fortran applications compiled with the  -mkl option to the Intel compiler.
  • [FOR-7140] Fixed an issue where allocated Fortran arrays are reported as not allocated.
  • [FOR-7376] Fixed an issue that caused the offline report memory leak bar charts to flow onto multiple lines.

19.1.2

  • [FOR-6985] Fixed an issue that prevented the expansion of Fortran arrays in the Current Line window. 
  • [FOR-7660] Fixed an issue when launching an application with Slurm 19.0.5.
  • [FOR-7661] Arm Forge now auto-detects HPE HMPT.

19.1.3

  • None in this release.

19.1.4

  • [FOR-8191] Fixed an issue which prevented the MPI message debugging library from loading.

Arm MAP new features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • Improved GUI performance and reduced memory consumption when viewing large .map files.
  • New CPU metrics for Armv8-A platforms.
  • New CPU metrics for IBM Power9 platforms.
  • MAP now displays stacks from Python code on non-main threads.
  • Architecture information is now stored to the generated .map file.
  • CPU metrics on Power and Armv8-A are now available with a standard Arm Forge license.
  • Support for displaying Caliper instrumented regions (https://github.com/LLNL/Caliper) to Arm MAP. Refer to section 32, 'Performance Analysis with Caliper Instrumentation', in the Arm Forge user guide.
  • Section 24.1 in the Arm Forge user guide has been updated to better describe the CPU instruction metrics available on x86_64, Armv8-A and IBM Power 8 and Power 9 platforms.
  • Remote connect network traffic is now compressed by default so some actions will now be faster when using this feature.

19.1.1

  • None in this release.

19.1.2

  • Support for Cray Shasta detection.

19.1.3

  • None in this release.

19.1.4

  • None in this release.

Arm MAP 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-5518] Fixed an issue that caused a slowdown of the analysis phase when profiling Python scripts.
  • [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

  • [FOR-7366] You can now see a breakdown of time spent calling functions and executing instructions per line on AArch74- and ppc64le-based systems.

19.1.2

  • [FOR-7660] Fixed an issue when launching an application with Slurm 19.0.5.
  • [FOR-7661] Arm Forge now auto-detects HPE HMPT.
  • [FOR-7663] MAP GPU profiling now works as expected when GPUs are in "Exclusive Process" mode.

19.1.3

  • [FOR-7879] Autodetection of make-profiler-libraries now works as expected on Cray systems.

19.1.4

  • [FOR-8100] Fixed issues when profiling Python scripts run under Anaconda Python and Python 3.7.
  • [FOR-8187] Fixed an issue which prevented the Caliper sampler library from loading.

Known issues

Please refer to the known issues page.

Release Note for Release History 19.1 - latest update 19.1.4

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

Arm Forge 19.1 provides a complete debugging and profiling environment for C, C++ and Fortran high performance code on Linux, to help you develop and tune your HPC applications. Arm Forge combines an industry-leading debugger, Arm DDT, and an out-of-the-box-ready profiler, Arm MAP.

Contents
========

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

- 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 Forge, refer to the release history online:

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

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

Arm Forge 19.1 covers the following releases:

  • Arm Forge 19.1.0 - Released 7th June 2019
  • Arm Forge 19.1.1 - Released 28th June 2019
  • Arm Forge 19.1.2 - Released 2nd August 2019
  • Arm Forge 19.1.3 - Released 30th August 2019
  • Arm Forge 19.1.4 - Released 4th October 2019

Arm DDT new features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • Fixed an issue where GDB 8.1 would not start on an Ubuntu 16.04 system without libmpfr installed.
  • Support for debugging of IBM Spectrum MPI jobs launched with Spindle.
  • GDB 8.1 is now the default DDT debugger.
  • Support for the GDB 7.10.1 debugger has been removed.
  • Memory Debugging support for PMDK.
  • Support for debugging CUDA 10.0 and 10.1 binaries.
  • Remote connect network traffic is now compressed by default so some actions will now be faster when using this feature.

19.1.1

  • None in this release.

19.1.2

  • Support for Cray Shasta detection.

19.1.3

  • None in this release.

19.1.4

  • None in this release.

Arm DDT bug fixes

19.1.0

  • [FOR-7342] Fixed an issue with memory debugging aligned allocations.
  • [FOR-6659] Clarified information in the user guide about startup issues with OpenMPI 3.0 and 3.1.
  • [FOR-6503] Fixed an issue where variables named "array" in a struct were not evaluated.
  • [FOR-6142] Fixed an issue with memory debug, where the total number of free calls were double counted when using memkind_realloc.
  • [FOR-6049] Fixed an issue with remote client messages when X11 is not available.
  • [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

  • [FOR-7417] Track memory allocations for Fortran applications compiled with the  -mkl option to the Intel compiler.
  • [FOR-7140] Fixed an issue where allocated Fortran arrays are reported as not allocated.
  • [FOR-7376] Fixed an issue that caused the offline report memory leak bar charts to flow onto multiple lines.

19.1.2

  • [FOR-6985] Fixed an issue that prevented the expansion of Fortran arrays in the Current Line window. 
  • [FOR-7660] Fixed an issue when launching an application with Slurm 19.0.5.
  • [FOR-7661] Arm Forge now auto-detects HPE HMPT.

19.1.3

  • None in this release.

19.1.4

  • [FOR-8191] Fixed an issue which prevented the MPI message debugging library from loading.

Arm MAP new features and enhancements

19.1.0

  • Support for Arm C/C++/Fortran Compiler up to version 19.2.
  • Improved GUI performance and reduced memory consumption when viewing large .map files.
  • New CPU metrics for Armv8-A platforms.
  • New CPU metrics for IBM Power9 platforms.
  • MAP now displays stacks from Python code on non-main threads.
  • Architecture information is now stored to the generated .map file.
  • CPU metrics on Power and Armv8-A are now available with a standard Arm Forge license.
  • Support for displaying Caliper instrumented regions (https://github.com/LLNL/Caliper) to Arm MAP. Refer to section 32, 'Performance Analysis with Caliper Instrumentation', in the Arm Forge user guide.
  • Section 24.1 in the Arm Forge user guide has been updated to better describe the CPU instruction metrics available on x86_64, Armv8-A and IBM Power 8 and Power 9 platforms.
  • Remote connect network traffic is now compressed by default so some actions will now be faster when using this feature.

19.1.1

  • None in this release.

19.1.2

  • Support for Cray Shasta detection.

19.1.3

  • None in this release.

19.1.4

  • None in this release.

Arm MAP 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-5518] Fixed an issue that caused a slowdown of the analysis phase when profiling Python scripts.
  • [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

  • [FOR-7366] You can now see a breakdown of time spent calling functions and executing instructions per line on AArch74- and ppc64le-based systems.

19.1.2

  • [FOR-7660] Fixed an issue when launching an application with Slurm 19.0.5.
  • [FOR-7661] Arm Forge now auto-detects HPE HMPT.
  • [FOR-7663] MAP GPU profiling now works as expected when GPUs are in "Exclusive Process" mode.

19.1.3

  • [FOR-7879] Autodetection of make-profiler-libraries now works as expected on Cray systems.

19.1.4

  • [FOR-8100] Fixed issues when profiling Python scripts run under Anaconda Python and Python 3.7.
  • [FOR-8187] Fixed an issue which prevented the Caliper sampler library from loading.

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

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

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


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

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

Arm DDT:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/arm-ddt/arm-ddt-platforms

Arm MAP:
https://developer.arm.com/products/software-development-tools/hpc/arm-forge/arm-map/arm-map-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 that it is available at the same path on every machine.

If you have a job submission system such as PBS or LoadLeveler running, please refer to the Configuration section in the Arm Forge User Guide for additional setup information:

https://developer.arm.com/docs/101136/latest/appendix/configuration

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

https://developer.arm.com/docs/101136/latest/arm-forge/installation

If you're installing the Remote Client for Windows, follow the instructions here:

https://developer.arm.com/products/software-development-tools/hpc/documentation/setting-up-arm-forge-remote-client-on-windows

Uninstalling Arm Forge
======================

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

rm -r <installation-dir>

Licences
========

If you do not have licence files for each product you will need to obtain them 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/forge/licences

and for a user-only installation it would be:

   ${HOME}/arm/forge/licences

Running DDT
===========

If you are using a supported desktop environment (KDE or Gnome) you will find a DDT icon in your Development/Programming menu.

To run DDT from the command line, type:

   {arm-forge-path}/bin/ddt

or, if {arm-forge-path}/bin is in your $PATH, just type:

    ddt

You may optionally provide a program name as the first argument.

Upon startup you will be presented with the Welcome page. From here you may choose to run a program, attach to an existing program or open a core file.

To start debugging a program, choose "Run".  In the Run window, set the path to your program in the Application field and click "Run" to start the program.

Your chosen program will be run using mpirun.  If you have problems starting your program under DDT, first ensure it can run without DDT from the command line.

Running MAP
===========

If you are using a supported desktop environment (KDE or Gnome) you will find a MAP icon in your Development/Programming menu.

To run MAP from the command line, type:

   {arm-forge-path}/bin/map

or, if {arm-forge-path}/bin is in your $PATH, just type:

    map

You may optionally provide a program name as the first argument.

Upon startup you will be presented with the Welcome page.  From here you may profile a program, or load a profile from a previous run.

To start profiling a program, choose "Profile".  In the Run window, set the path to your program in the Application field and click "Run" to start the program.

Your chosen program will be run using mpirun.  If you have problems starting your program under MAP, first ensure it can run without MAP from the command line.

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-forge/release-history

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

https://developer.arm.com/docs/101136/latest/arm-forge

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