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 20.0

Released: November 22, 2019

What's new in 20.0

Arm DDT New features and enhancements

  • CUDA GDB is now shipped on AArch64.
  • Added Assembly debugging mode.
  • Added GDB 8.2 as an optional debugger.
  • Updated the MPICH3 auto-detection heuristics.
  • Fixed an issue where the program was unresponsive when debugging or profiling applications that expect user input from a pseudo terminal.
  • Added support for Ubuntu 18.04 on AArch64.
  • Added support for Ubuntu 18.04 on x86_64.
  • Upgraded CUDA GDB 10.1 to update 2.
  • Added support for Arm Compiler for Linux 19.3.
  • Added support for Arm Compiler for Linux 20.0.
  • Added support for Intel 19.x Compiler and MPI.
  • Updated the Support email address from allinea-support@arm.com to support-hpc-sw@arm.com.
  • Because of issues with the Data Address Watchpoint Register (DAWR) on POWER9, hardware watchpoints are not available from Linux kernel version 4.17. In this case, DDT falls back to software watchpoints which are significantly slower than using hardware watchpoints. More information can be found at https://github.com/torvalds/linux/blob/master/Documentation/powerpc/dawr-power9.rst.


Arm DDT Bug fixes

  • [FOR-8193] Improved the security of the X11 display server used in Offline Mode.
  • [FOR-8194] Fixed a security issue with Reverse Connect which affected the authentication between Remote Daemons.
  • [FOR-7972] Fixed preloading of the memory debugging library on Cray with Slurm.
  • [FOR-3369] Fixed editor lookups involving user supplied file paths when double-clicking a breakpoint item in the Breakpoint view.
  • [FOR-5400] Fixed a crash in the Attach dialog.
  • [FOR-6148] Fixed an issue with displaying std::map iterators in the variables view.
  • [FOR-8522] Fixed a segmentation fault when printing C++ static constexpr class members.
  • [FOR-8280] Fixed an issue resulting in extra items displaying in the Memory Usage dialog chart legend.

Arm MAP New features and enhancements

  • Added support for counting hardware events using Linux perf.
  • MAP and Performance Reports custom metric API extended to improve usability and support for passing configuration data to custom metric libraries.
  • Reduced MAP and Performance Reports memory usage when profiling large applications.
  • Updated the MPICH3 auto-detection heuristics.
  • Fixed an issue where the program was unresponsive when debugging or profiling applications that expect user input from a pseudo terminal.
  • Clarified metrics descriptions for branch misses and cache misses on AArch64 and Power architectures.
  • Added support for Ubuntu 18.04 on AArch64.
  • Added support for Ubuntu 18.04 on x86_64.
  • Added support for Arm Compiler for Linux 19.3.
  • Added support for Arm Compiler for Linux 20.0.
  • Added support for Intel 19.x Compiler and MPI.
  • Updated the Support email address from allinea-support@arm.com to support-hpc-sw@arm.com.

Arm MAP Bug fixes

  • [FOR-8193] Improved the security of the X11 display server used in Offline Mode.
  • [FOR-8194] Fixed a security issue with Reverse Connect which affected the authentication between Remote Daemons.
  • [FOR-8337] Fixed an issue which caused MAP to fail to create a MAP file at the end of a profiling run.
  • [FOR-7508] Fixed an issue where MAP hangs on start-up when running on an Ubuntu 18.04, AArch64 system without libc debug symbols installed.
  • [FOR-8529] Fixed a bug where a crash during profiling prevented the Run button on MAP from working.
  • [FOR-8343] Fixed an issue where an error message displayed about "unavailable metrics" when metrics were unlicensed.

Known Issues

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

Arm Forge known issues

Release Note for Release History 20.0

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

Arm Forge 20.0 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 20.0 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 DDT:

- New features and enhancements:

Added GDB 8.2 as an optional debugger.

Added support for Arm Compiler for Linux 19.3.

Upgraded CUDA GDB 10.1 to update 2.

Added support for Arm Compiler for Linux 20.0.

CUDA GDB is now shipped on AArch64.

Updated the MPICH3 auto-detection heuristics.

Because of issues with the Data Address Watchpoint Register (DAWR) on POWER9, hardware watchpoints are not available from Linux kernel version 4.17. In this case, DDT falls back to software watchpoints which are significantly slower than using hardware watchpoints. More information can be found at https://github.com/torvalds/linux/blob/master/Documentation/powerpc/dawr-power9.rst.

Updated the Support email address from allinea-support@arm.com to support-hpc-sw@arm.com.

Added support for Intel 19.x Compiler and MPI.

Added Assembly debugging mode.

Fixed an issue where the program was unresponsive when debugging or profiling applications that expect user input from a pseudo terminal.

Added support for Ubuntu 18.04 on AArch64.

Added support for Ubuntu 18.04 on x86_64.

- Bug fixes:

[FOR-8193] Improved the security of the X11 display server used in Offline Mode.

[FOR-8194] Fixed a security issue with Reverse Connect which affected the authentication between Remote Daemons.

[FOR-7972] Fixed preloading of the memory debugging library on Cray with Slurm.

[FOR-3369] Fixed editor lookups involving user supplied file paths when double-clicking a breakpoint item in the Breakpoint view.

[FOR-5400] Fixed a crash in the Attach dialog.

[FOR-6148] Fixed an issue with displaying std::map iterators in the variables view.

[FOR-8522] Fixed a segmentation fault when printing C++ static constexpr class members.

[FOR-8280] Fixed an issue resulting in extra items displaying in the Memory Usage dialog chart legend.

Arm MAP:

- New features and enhancements:

Added support for Arm Compiler for Linux 19.3.

Added support for Arm Compiler for Linux 20.0.

Reduced MAP and Performance Reports memory usage when profiling large applications.

Updated the MPICH3 auto-detection heuristics.

Added support for counting hardware events using Linux perf.

Updated the Support email address from allinea-support@arm.com to support-hpc-sw@arm.com.

Clarified metrics descriptions for branch misses and cache misses on AArch64 and Power architectures.

Added support for Intel 19.x Compiler and MPI.

MAP and Performance Reports custom metric API extended to improve usability and support for passing configuration data to custom metric libraries.

Fixed an issue where the program was unresponsive when debugging or profiling applications that expect user input from a pseudo terminal.

Added support for Ubuntu 18.04 on AArch64.

Added support for Ubuntu 18.04 on x86_64.

- Bug fixes:

[FOR-8193] Improved the security of the X11 display server used in Offline Mode.

[FOR-8194] Fixed a security issue with Reverse Connect which affected the authentication between Remote Daemons.

[FOR-8337] Fixed an issue which caused MAP to fail to create a MAP file at the end of a profiling run.

[FOR-7508] Fixed an issue where MAP hangs on start-up when running on an Ubuntu 18.04, AArch64 system without libc debug symbols installed.

[FOR-8529] Fixed a bug where a crash during profiling prevented the Run button on MAP from working.

[FOR-8343] Fixed an issue where an error message displayed about "unavailable metrics" when metrics were unlicensed.

[FOR-8479] Fixed an issue where inline time glyphs were not updated when a single sample from the main activity timeline was selected.

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 support-hpc-sw@arm.com or use our support request form online:

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