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 18.2 - latest update 18.2.3

Released: September 28, 2018

What's new in 18.2 - latest update 18.2.3

Arm Forge 18.2 covers the following releases:

  • Arm Forge 18.2.0 - Released 15th June 2018
  • Arm Forge 18.2.1 - Released 26th July 2018
  • Arm Forge 18.2.2 - Released 7th September 2018
  • Arm Forge 18.2.3 - Released 28th September 2018

Changes in Arm DDT

New features and enhancements:

18.2.0

  • Added IBM Spectrum MPI 10.2 support on Power 8 and Power 9.
  • Dropped IBM Spectrum MPI 10.1 support.
  • Added CUDA 9.2 toolkit support.
  • Support added for offload OpenMP added for IBM XL 16.1+ compilers.
  • Added PGI compiler support for DDT on Power 8 and Power 9.
  • Added support for the clang-coral C/C++ compiler.
  • Added basic support for debugging Python 3.X programs to match the support for Python 2.7 programs. It is possible to inspect global and local variables, but not to control execution within Python stack frames.
  • DDT now supports split DWARF (Fission) debug info on the Power architecture.


18.2.1

  • Enabled Cray Fast Track Debugging for GDB 7.12.1

 

18.2.2

No new features in this release.

18.2.3

No new features in this release.

Bug fixes :

18.2.0

  • Improve the axis scaling of the MDA array visualiser and also fix a rendering issue with the axis numbers.
  • Bug fixes to watchpoint interface.
  • Fixed a bug causing GDB to crash when debugging Fortran code compiled with the -O3 flag.
  • SSH-less startup with IBM Spectrum MPI PMIx (jsrun).
  • Message queue debugging is now supported on Spectrum MPI 10.2.
  • Forge can launch programs with Slurm when MPI_Init is called from a shared library.


18.2.1

  • Fixed "Unsupported CUDA toolkit version (9.x)" issue on some Cray systems.
  • Fixed an issue which prevented DDT displaying Memory Statistics from multiple GPUs.
    Please note that when using remote/reverse connect, both the local and remote installs will need to be updated to take advantage of this fix.
  • Added support for tracking allocations from ISO C11 aligned_alloc with memory debugging.
  • GPU Memory Debugging now shows allocations for multiple GPUs. To enable, update both the client and the remote install.
  • Added Platform MPI 9.01.04 support.
  • Fixed issue where running the GUI installer as root you could not install to an NFS directory.

 

18.2.2

  • Fixed a bug in the memory leak feature in offline mode.
  • Fixed a slowdown in stepping through Fortran functions when dissociated pointers are present.

18.2.3

  • Fixed an issue where source files with the same filename would not be listed in Arm DDT.
  • Fixed an issue in Arm MAP where white "uncategorized" time is displayed during all MPI calls when the pthreads view is active.

Changes in Arm MAP

New features and enhancements:

18.2.0

  • In MAP the parallel stack view will now display functions that could not be positively identified using the form  "<unknown> in libXXX.so".
  • Added IBM Spectrum MPI 10.2 support on Power 8 and Power 9.
  • Dropped IBM Spectrum MPI 10.1 support.
  • Reduced the memory usage of MAP GUI when viewing large .map files.

 

18.2.1

No new features in this release.

18.2.2

No new features in this release.


Bug fixes:

18.2.0

  • Fixed bug causing the PAPI.config file to be read incorrectly.
  • SSH-less startup with IBM Spectrum MPI PMIx (jsrun).


18.2.1

  • Added Platform MPI 9.01.04 support.
  • Fixed issue where running the GUI installer as root you could not install to an NFS directory.

 

18.2.2

  • Fixed a memory leak in MAP that caused memory overhead to increase when profiling some OpenMP programs.

Known issues

Please refer to the Known issues page.

Refer to the Release Note for further details.

Release Note for Release History 18.2 - latest update 18.2.3

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

Arm Forge 18.2 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 18.2 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 18.2.0:

Added IBM Spectrum MPI 10.2 support on Power 8 and Power 9.

Dropped IBM Spectrum MPI 10.1 support.

Added CUDA 9.2 toolkit support.

Support added for offload OpenMP added for IBM XL 16.1+ compilers.

Added PGI compiler support for DDT on Power 8 and Power 9.

Added support for the clang-coral C/C++ compiler.

Added basic support for debugging Python 3.X programs to match the support for Python 2.7 programs. It is possible to inspect global and local variables, but not to control execution within Python stack frames.

DDT now supports split DWARF (Fission) debug info on the Power architecture.

- New features and enhancements 18.2.1:

Enabled Cray Fast Track Debugging for GDB 7.12.1

- New features and enhancements 18.2.2:

None in this release.

- New features and enhancements 18.2.3:

None in this release.


- Bug fixes 18.2.0:

Improve the axis scaling of the MDA array visualiser and also fix a rendering issue with the axis numbers.

Bug fixes to watchpoint interface.

Fixed a bug causing GDB to crash when debugging Fortran code compiled with the -O3 flag.

SSH-less startup with IBM Spectrum MPI PMIx (jsrun).

Message queue debugging is now supported on Spectrum MPI 10.2.

Forge can launch programs with Slurm when MPI_Init is called from a shared library.

- Bug fixes 18.2.1:

Fixed "Unsupported CUDA toolkit version (9.x)" issue on some Cray systems.

Fixed an issue which prevented DDT displaying Memory Statistics from multiple GPUs. Please note that when using remote/reverse connect, both the local and remote installs will need to be updated to take advantage of this fix.

Added support for tracking allocations from ISO C11 aligned_alloc with memory debugging.

GPU Memory Debugging now shows allocations for multiple GPUs. To enable, update both the client and the remote install.

Added Platform MPI 9.01.04 support.

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

 

- Bug fixes 18.2.2:

Fixed a bug in the memory leak feature in offline mode.

Fixed a slowdown in stepping through Fortran functions when dissociated pointers are present.

- Bug fixes 18.2.3:

Fixed an issue where source files with the same filename would not be listed in Arm DDT.

Fixed an issue in Arm MAP where white "uncategorized" time is displayed during all MPI calls when the pthreads view is active.


Arm MAP:

- New features and enhancements 18.2.0:

In MAP the parallel stack view will now display functions that could not be positively identified using the form  "<unknown> in libXXX.so".

Added IBM Spectrum MPI 10.2 support on Power 8 and Power 9.

Dropped IBM Spectrum MPI 10.1 support.

Reduced the memory usage of MAP GUI when viewing large .map files.

- New features and enhancements 18.2.1:

None in this release.

- New features and enhancements 18.2.2:

None in this release.


- Bug fixes 18.2.0:

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

SSH-less startup with IBM Spectrum MPI PMIx (jsrun).

- Bug fixes 18.2.1:

Added Platform MPI 9.01.04 support.

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

- Bug fixes 18.2.2:

Fixed a memory leak in MAP that caused memory overhead to increase when profiling some OpenMP programs.

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