Skip to content

Update ArmPL guide for 25.07 release #2125

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 9, 2025
Merged

Update ArmPL guide for 25.07 release #2125

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
5d6e73d
Update ArmPL guide for 25.07 release
ndingle-arm Jun 2, 2025
6d64669
Merge branch 'main' into armpl-2507
ndingle-arm Jul 9, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
38 changes: 24 additions & 14 deletions content/install-guides/armpl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,8 +32,8 @@ layout: installtoolsall # DO NOT MODIFY. Always true for tool install ar

[Arm Performance Libraries](https://developer.arm.com/downloads/-/arm-performance-libraries#documentation) provides developers with optimized math libraries for high performance computing applications on Arm Neoverse based hardware.

These libraries include highly optimized functions for BLAS, LAPACK, FFT, sparse linear algebra, libamath and libastring.
These libraries are free to use and do not require a license. They can be installed either standalone or with your installation of [Arm Compiler for Linux](/install-guides/acfl). This install guide covers the standalone installation.
These libraries include highly optimized functions for BLAS, LAPACK, FFT, sparse linear algebra, random number generation, libamath and libastring.
These libraries are free to use and do not require a license.

Arm Performance Libraries are available for use on [Windows 11 on Arm](#windows), [macOS](#macos) (Apple Silicon), and [Linux](#linux) (AArch64) hosts.

Expand Down Expand Up @@ -63,6 +63,16 @@ Click 'Install' and then 'Finish' to complete the installation.

![win_wizard04 #left](/install-guides/_images/armpl_wizard04.png)

To install Arm Performance Libraries from a command prompt and automatically accept the End User License Agreement use:
```console
msiexec.exe /i arm-performance-libraries_<version>_Windows.msi /quiet ACCEPT_EULA=1
```

To install Arm Performance Libraries using the `winget` package manager and automatically accept the End User License Agreement use:
```console
winget install --accept-package-agreements Arm.ArmPerformanceLibraries
```

You can now start linking your application to the Arm Performance libraries on your Windows on Arm device. Follow the examples in the included `RELEASE_NOTES` file of your extracted installation directory to get started.

For more information refer to [Get started with Arm Performance Libraries](https://developer.arm.com/documentation/109361).
Expand All @@ -74,28 +84,28 @@ For more information refer to [Get started with Arm Performance Libraries](https

In a terminal, run the command shown below to download the macOS package:
```console
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_25.04/arm-performance-libraries_25.04_macOS.tgz
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_25.07/arm-performance-libraries_25.07_macOS.tgz
```

Use tar to extract the file:
```console
tar zxvf arm-performance-libraries_25.04_macOS.tgz
tar zxvf arm-performance-libraries_25.07_macOS.tgz
```

Output of above command:
```console
armpl_25.04_flang-new_clang_19.dmg
armpl_25.07_flang-20.dmg
```

Mount the disk image by running from a terminal:
```console
hdiutil attach armpl_25.04_flang-new_clang_19.dmg
hdiutil attach armpl_25.07_flang-20.dmg
```

Now run the installation script as a superuser:

```console
/Volumes/armpl_25.04_flang-new_clang_19_installer/armpl_25.04_flang-new_clang_19_install.sh -y
/Volumes/armpl_25.07_flang-20_installer/armpl_25.07_flang-20_install.sh -y
```

Using this command you automatically accept the End User License Agreement and the packages are installed to the `/opt/arm` directory. If you want to change the installation directory location use the `--install_dir=` option with the script and provide the desired directory location.
Expand All @@ -107,7 +117,7 @@ For more information refer to [Get started with Arm Performance Libraries](https

## How do I install Arm Performance Libraries on Linux? {#linux}

Arm Performance Libraries are supported on most Linux distributions like Ubuntu, RHEL, SLES and Amazon Linux on an `AArch64` host and compatible with various versions of GCC, LLVM, and NVHPC. The GCC compatible releases are built with GCC 14 and tested with GCC versions 7 to 14. The LLVM compatible releases are tested with LLVM 19.1. The NVHPC compatible releases are tested with NVHPC 24.7.
Arm Performance Libraries are supported on most Linux distributions like Ubuntu, RHEL, SLES and Amazon Linux on an `AArch64` host and compatible with various versions of GCC, LLVM, and NVHPC. The GCC compatible releases are built with GCC 14 and tested with GCC versions 7 to 14. The LLVM compatible releases are tested with LLVM 20.1. The NVHPC compatible releases are tested with NVHPC 25.5.

### How do I manually download and install Arm Performance Libraries on Linux?

Expand All @@ -122,26 +132,26 @@ The instructions shown below are for deb based installers for GCC users.
In a terminal, run the command shown below to download the Debian package:

```bash
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_25.04.1/arm-performance-libraries_25.04.1_deb_gcc.tar
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_25.07/arm-performance-libraries_25.07_deb_gcc.tar
```

Use `tar` to extract the file and then change directory:

```bash
tar xf arm-performance-libraries_25.04.1_deb_gcc.tar
tar xf arm-performance-libraries_25.07_deb_gcc.tar
```

Run the installation script as a super user:

```bash
sudo ./arm-performance-libraries_25.04.1_deb/arm-performance-libraries_25.04.1_deb.sh --accept
sudo ./arm-performance-libraries_25.07_deb/arm-performance-libraries_25.07_deb.sh --accept
```

Using the `--accept` switch you automatically accept the End User License Agreement and the packages are installed to the `/opt/arm` directory.

If you want to change the installation directory location use the `--install-to` option with the script and provide the desired directory location.

## How do I download and install Arm Performance Libraries using system packages on Linux?
### How do I download and install Arm Performance Libraries using system packages on Linux?

Arm Performance Libraries are available to install using Linux system package managers. The instructions shown below are for the Ubuntu system package manager `apt` command.

Expand Down Expand Up @@ -190,13 +200,13 @@ module avail
The output should be similar to:

```output
armpl/25.04.1_gcc
armpl/25.07_gcc
```

Load the appropriate module:

```console
module load armpl/25.04.1_gcc
module load armpl/25.07_gcc
```

You can now compile and test the examples included in the `/opt/arm/<armpl_dir>/examples/`, or `<install_dir>/<armpl_dir>/examples/` directory, if you have installed to a different location than the default.
Expand Down