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 and supported platforms topics.

Arm Forge

Version 21.0 - Latest release 21.0.3

Released: July 30, 2021

What's new in 21.0 - Latest release 21.0.3

Arm Forge 21.0 covers the following releases:

  • Arm Forge 21.0 - Release 1st March, 2021
  • Arm Forge 21.0.1 - Release 30th March, 2021
  • Arm Forge 21.0.2 - Release 30th April, 2021
  • Arm Forge 21.0.3 - Release 30th July, 2021

21.0.3

Additions and changes

Arm Forge:

  • Added support for GCC 11.

Arm DDT:

  • Added a warning to notify when the debugger cannot debug shared libraries because of an unknown library path.

Arm MAP and Performance Reports:

  • None in this release.
Resolved issues

Arm Forge:

  • None in this release.

Arm DDT:

  • [FOR-13309] Fixed an issue that was preventing start up with GCC 11.
  • [FOR-13499] Fixed a bug where Python Debugging would not work correctly with SLURM if the Python binary was using the Python shared library.

Arm MAP and Performance Reports:

  • [FOR-12903] Fixed a numerical scaling issue with SPE counts on long profiling runs.

21.0.2

Additions and changes
  • None in this release
Resolved issues

Arm Forge:

  • [FOR-12711] Fixed an issue that was preventing startup with newer Slurm versions.
  • [FOR-12762] Fixed auto-detection of Open MPI on HPE/Cray systems.

Arm DDT:

  • [FOR-12924] Fixed an issue debugging python 3.8+ programs where python is configured with trace refs support.

Arm MAP and Performance Reports:

  • [FOR-12803] Fixed a crash issue when profiling Python 3.9 programs.

21.0.1

Additions and changes
  • Added support for Arm Compiler for Linux 21.0.
  • Documented a workaround for startup issues with recent versions of SLURM.

Resolved issues

Arm Forge:

  • [FOR-11503] Fixed intermittent remote connect crash.

Arm DDT:

  • None in this release.

Arm MAP and Performance Reports:

  • [FOR-10699] Fixed an allocation issue in MAP which caused the program being profiled to crash on rare occasions.
  • [FOR-12576] Adjusted detection of OpenMP Regions with Arm Compiler for Linux.

21.0

Additions and changes
  • Forge for Linux is now distributed as a single package per architecture.
  • Added ability to sort by column in "Cross-Thread" and "Cross-Process Comparison" views.
  • Added support for GNU Compiler version 9.
  • Added support for GNU Compiler version 10.
  • Added GDB 10 as an optional debugger.
  • Added support for Open MPI version 4.1.
  • Added support for NVIDIA HPC Compiler version 20.9.
  • Removed support for CUDA 8.x.
  • Removed GDB 8.1 as a debugger.
  • Removed support for the following MPIs: SGI MPT (prior to HPE MPI), Open MPI on Cray X-series systems, Open MPI 2.x.x, Parastation MPI.
Resolved issues

Arm Forge:

  • None in this release.

Arm DDT:

  • [FOR-11277] Fixed an issue where DDT would not start the debug session at the expected location for non-MPI, Fortran applications.
  • [FOR-9476] Fixed an issue where CUDA Memory Debugging did not track allocations made via cudaMallocPitch and cudaMalloc3D.
  • [FOR-4826] Fixed an issue where watchpoints would not be removed from the GUI when going out of scope.
  • [FOR-10025] Fixed an issue with missing icons in the remote file dialog on MacOS.
  • [FOR-10332] Fixed an issue which could cause an internal error to occur on shutdown.
  • [FOR-10154] Fixed an issue where remote clients could show unconfigurable items in the options dialog when not connected to a remote system.
  • [FOR-10300] Fixed an issue displaying directory icons when browsing remote files using the Windows client.
  • [FOR-10387] Fixed startup to be more robust with serial programs.
  • [FOR-9980] Fixed an issue where some header files could appear under the "Sources" section of the "Project Files" view.
  • [FOR-11447] Fixed an issue where the remote launch connection name did not display correctly when adding multiple new connections.
  • [FOR-11986] Fixed an issue creating a clean config via the --cleanconfig command line parameter.
  • [FOR-12112] Fixed an issue where the --source-dirs command-line option did not always add source directories as expected.

Arm MAP and Performance Reports:

  • [FOR-11492] Improved OpenMP region names for some compilers.
  • [FOR-8536] Improved the performance of perf metrics selection lists.
  • [FOR-8567] Fixed possible output of corrupted memory to user.
  • [FOR-9264] Improved MAP line metrics for samples on system calls.
  • [FOR-10387] Fixed startup to be more robust with serial programs.
  • [FOR-11447] Fixed an issue where the remote launch connection name did not display correctly when adding multiple new connections.
  • [FOR-11684] Improved MAP's ability to detect time spent in thread synchronization.
  • [FOR-11935] Fixed an issue with the static sampler library on Power (ppc64le) which caused link failures.
  • [FOR-11986] Fixed an issue creating a clean config via the --cleanconfig command line parameter.
  • [FOR-12085] The forge-probe utility script now sources the allinearc settings file.
  • [FOR-12112] Fixed an issue where the --source-dirs command-line option did not always add source directories as expected.

Deprecated features

The following features remain deprecated since the release of version 21.0, and might be removed in a future version:

  • VisIt Visualization.
  • Automatically adding breakpoints and tracepoints based on version control information.
  • Support for the IPMI energy agent.
  • Support for PAPI metrics in MAP. Arm recommends using perf metrics instead.
  • Support for Python 2.x.x.
  • Support for Open MPI 3.x.x.
  • Support for Red Hat Enterprise Linux 7.x on aarch64 and ppc64le.
  • Support for Ubuntu 16.04.
  • Support for Ubuntu 16.04.
  • Support for SUSE Linux Enterprise Server 12 on aarch64.
  • Support for macOS High Sierra (10.13).

Known issues

Please refer to the known issues page.



Release Note for Release History 21.0 - Latest release 21.0.3

Arm Forge 21.0.3 Release Note
================================

Copyright (c) 2017-2021 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.


Arm proprietary notices, including confidentiality status, terminology statement, and product release status, can be found at the end of this document.


Contents
========

- Release overview
- Release contents
- Get started
- Support
- Release history
- Glossary
- Proprietary notices


Release overview
================

Product description
-------------------

Arm Forge 21.0.3 combines Arm DDT, Arm MAP, and Arm Performance Reports. Arm DDT is the leading debugger for time-saving high-performance application debugging. Arm MAP is the trusted performance profiler for invaluable optimization advice across native and Python HPC codes. Arm Performance Reports provides advanced reporting capabilities.

This release includes enhancements and bug fixes.

Release status
--------------

This is the 21.0.3 release of Arm Forge.

These deliverables are being released under the terms of the agreement between Arm and each licensee (the "Agreement"). All planned verification and validation is complete. The release is suitable for volume production under the terms of the Agreement.


Release contents
================

The following subsections detail:
- The component parts that are delivered as part of this release.
- Any changes since the previous release.
- Any known issues and limitations that exist at the time of this release.

Deliverables
------------

- Arm Forge, which includes:
  - Arm DDT
  - Arm MAP
  - Arm Performance Reports
- Release Notes (this document, also available at:
  https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history)
- Documentation is available in the documentation area of your product installation or online at:
  https://developer.arm.com/documentation/101136/2103

Information about how to use the Arm HPC tools to debug, profile, and analyze many common scientific applications are available on the Arm Developer website:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge

Further documentation about all the tools can be found online at:
https://developer.arm.com/tools-and-software/server-and-hpc/help

Documentation can change between product releases. For the latest product documentation, check the software downloads page on the Arm Developer website at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge


Differences from previous release
---------------------------------

Differences from the previous release of Arm Forge are detailed in the following subsections.


Additions and changes
~~~~~~~~~~~~~~~~~~~~~

- Arm Forge:
Added support for GCC 11.

- Arm DDT:
Added a warning to notify when the debugger cannot debug shared libraries because of an unknown library path.

- Arm MAP and Arm Performance Reports:
None in this release.

Resolved issues
~~~~~~~~~~~~~~~

- Arm Forge:
None in this release.

- Arm DDT:
[FOR-13309] Fixed an issue that was preventing start up with GCC 11.
[FOR-13499] Fixed a bug where Python Debugging would not work correctly with SLURM if the Python binary was using the Python shared library.

- Arm MAP and Arm Performance Reports:
[FOR-12903] Fixed a numerical scaling issue with SPE counts on long profiling runs.

Deprecated features
~~~~~~~~~~~~~~~~~~~

The following features have been deprecated in this release, and might be removed in a future version:
- VisIt Visualization.
- Automatically adding breakpoints and tracepoints based on version control information.
- Support for the IPMI energy agent.
- Support for PAPI metrics in MAP. Arm recommends using perf metrics instead.
- Support for Python 2.x.x.
- Support for Open MPI 3.x.x.
- Support for Red Hat Enterprise Linux 7.x on aarch64 and ppc64le.
- Support for Ubuntu 16.04.
- Support for SUSE Linux Enterprise Server 12 on aarch64.
- Support for macOS High Sierra (10.13).

If you rely on this functionality, please contact support-hpc-sw@arm.com.


Known limitations
-----------------

See the known issues section on the Arm Developer website:
https://developer.arm.com/documentation/101136/2103/Appendix/Known-issues


Get started
===========

This section describes how to get started with accessing, setting up, and using Arm Forge.

For more information, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/resources/get-started

Licensing information
---------------------

Arm Forge requires a valid license to run.

Note: You do not need to install a license file on a machine that is running the Remote Client for connecting remotely to Arm Forge products. The license is only required on the machine on which Arm Forge is installed.

To request a license, go to:
https://store.developer.arm.com/store/high-performance-computing-hpc-tools/arm-forge

To request an evaluation license, go to:
https://pages.arm.com/Hpc-trial-request.html

For more information about Arm HPC tools licensing, see:
https://developer.arm.com/tools-and-software/server-and-hpc/debug-and-profile/arm-forge/licensing


When you have obtained a license file from Arm, download and install the appropriate platform version of the product here:

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


See the Arm Forge User Guide for installation methods, such as using the command-line interface and using the GUI to install Arm Forge on Windows, Linux, and MAC, at:
https://developer.arm.com/documentation/101136/2103/Arm-Forge/Installation

Run the product
---------------

See the Arm Forge User Guide for information about running each of the tools, Arm DDT, Arm MAP, and Arm Performance Reports:
https://developer.arm.com/documentation/101136/2103/Arm-Forge/Connecting-to-a-remote-system/Starting-Arm-Forge


Configure the product
---------------------

To learn how to configure the Arm Forge tools, see the user guide at:
https://developer.arm.com/documentation/101136/2103/Appendix/Configuration


Examples
--------

A range of example applications are provided with the product installation that you can use alongside information in the User Guide to explore Arm Forge functionality.
The example applications are located in the <install_directory>/examples directory.


Support
-------

If you have any issues with the installation, content, or use of this release, please create a ticket on https://support.developer.arm.com. Arm will respond as soon as possible.

These deliverables are being released under the terms of the agreement between Arm and each licensee (the "Agreement"). All planned verification and validation  is complete.
The release is suitable for volume production under the terms of the Agreement.

Note: Support for this release of the product is only provided by Arm to partners who have a current support and maintenance contract for the product.


Tools
-----

Full information about the supported platforms for Arm Forge are available on the Developer website:
https://developer.arm.com/documentation/101136/2103/Appendix/Supported-platforms


Release history
===============

A full release history for Arm Forge is available at:
https://developer.arm.com/tools-and-software/server-and-hpc/downloads/arm-forge/release-history


Glossary
========

The Arm Glossary is a list of terms used in Arm documentation, together with definitions for those terms. The Arm Glossary does not contain terms that are industry standard unless the Arm meaning differs from the generally accepted meaning.
See the Arm Glossary for more information: https://developer.arm.com/glossary.


Proprietary notices
===================

Non-confidential proprietary notice
-----------------------------------

This document is protected by copyright and other related rights and the practice or implementation of the information contained in this document may be protected by one or more patents or pending patent applications. No part of this document may be reproduced in any form by any means without the express prior written permission of Arm. No license, express or implied, by estoppel or otherwise to any intellectual property rights is granted by this document unless specifically stated.
Your access to the information in this document is conditional upon your acceptance that you will not use or permit others to use the information for the purposes of determining whether implementations infringe any third party patents.
THIS DOCUMENT IS PROVIDED "AS IS". ARM PROVIDES NO REPRESENTATIONS AND NO WARRANTIES, EXPRESS, IMPLIED OR STATUTORY, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTABILITY, SATISFACTORY QUALITY, NON-INFRINGEMENT OR FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE DOCUMENT. For the avoidance of doubt, Arm makes no representation with respect to, and has undertaken no analysis to identify or understand the scope and content of, patents, copyrights, trade secrets, or other rights.
This document may include technical inaccuracies or typographical errors.
TO THE EXTENT NOT PROHIBITED BY LAW, IN NO EVENT WILL ARM BE LIABLE FOR ANY DAMAGES, INCLUDING WITHOUT LIMITATION ANY DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, HOWEVER CAUSED AND REGARDLESS OF THE THEORY OF LIABILITY, ARISING OUT OF ANY USE OF THIS DOCUMENT, EVEN IF ARM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
This document consists solely of commercial items. You shall be responsible for ensuring that any use, duplication or disclosure of this document complies fully with any relevant export laws and regulations to assure that this document or any portion thereof is not exported, directly or indirectly, in violation of such export laws. Use of the word "partner" in reference to Arm's customers is not intended to create or refer to any partnership relationship with any other company. Arm may make changes to this document at any time and without notice.
This document may be translated into other languages for convenience, and you agree that if there is any conflict between the English version of this document and any translation, the terms of the English version of the Agreement shall prevail.
The Arm corporate logo and words marked with ® or ™ are registered trademarks or trademarks of Arm Limited (or its affiliates) in the US and/or elsewhere. All rights reserved.  Other brands and names mentioned in this document may be the trademarks of their respective owners. Please follow Arm's trademark usage guidelines at http://www.arm.com/company/policies/trademarks.

Copyright (c) 2017-2021 Arm Limited (or its affiliates). All rights reserved.
Copyright (c) 2002-2017 Allinea Software Limited.

Arm Limited. Company 02557590 registered in England.

110 Fulbourn Road, Cambridge, England CB1 9NJ.

(LES-PRE-20349)

Confidentiality status
----------------------

This document is Non-Confidential. The right to use, copy and disclose this document may be subject to license restrictions in accordance with the terms of the agreement entered into by Arm and the party that Arm delivered this document to.

Unrestricted Access is an Arm internal classification.

Product status
--------------

The information in this document is final, that is for a developed product.

Web address
-----------

http://www.arm.com

Progressive terminology statement
---------------------------------

Arm values inclusive communities. Arm recognizes that we and our industry have used terms that can be offensive. Arm strives to lead the industry and create change.

If you find offensive terms in this document, please email terms@arm.com.