Skip to content
Merged
Changes from all commits
Commits
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
37 changes: 22 additions & 15 deletions content/install-guides/armpl.md
Original file line number Diff line number Diff line change
Expand Up @@ -84,67 +84,75 @@ 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.07/arm-performance-libraries_25.07_macOS.tgz
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_26.01/arm-performance-libraries_26.01_macOS.tgz
```

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

Output of above command:
```console
armpl_25.07_flang-20.dmg
armpl_26.01_flang-21.dmg
```

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

Now run the installation script as a superuser:

```console
/Volumes/armpl_25.07_flang-20_installer/armpl_25.07_flang-20_install.sh -y
/Volumes/armpl_26.01_flang-21_installer/armpl_26.01_flang-21_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.

To install Arm Performance Libraries using Homebrew in a terminal and automatically accept the End User License Agreement use:

```console
brew install arm-performance-libraries
```

The installer runs using `sudo` so you may be asked to input your password.

To get started, 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.

For more information refer to [Get started with Arm Performance Libraries](https://developer.arm.com/documentation/109362).


## 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 20.1. The NVHPC compatible releases are tested with NVHPC 25.5.
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 21.1. The NVHPC compatible releases are tested with NVHPC 25.11.

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

[Download](https://developer.arm.com/downloads/-/arm-performance-libraries) the appropriate package for your Linux distribution. The deb based installers can be used on Ubuntu 20 and Ubuntu 22. The RPM based installers can be used on the following supported distributions:
[Download](https://developer.arm.com/downloads/-/arm-performance-libraries) the appropriate package for your Linux distribution. The deb based installers can be used on Ubuntu 22 and Ubuntu 24. The RPM based installers can be used on the following supported distributions:

- Amazon Linux 2, Amazon Linux 2023
- RHEL-8, RHEL-9
- SLES-15 Service Packs 5 and 6
- RHEL-8, RHEL-9, RHEL-10
- SLES-15 Service Packs 6 and 7

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.07/arm-performance-libraries_25.07_deb_gcc.tar
wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Performance-Libraries/Version_26.01/arm-performance-libraries_26.01_deb_gcc.tar
```

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

```bash
tar xf arm-performance-libraries_25.07_deb_gcc.tar
tar xf arm-performance-libraries_26.01_deb_gcc.tar
```

Run the installation script as a super user:

```bash
sudo ./arm-performance-libraries_25.07_deb/arm-performance-libraries_25.07_deb.sh --accept
sudo ./arm-performance-libraries_26.01_deb/arm-performance-libraries_26.01_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.
Expand All @@ -158,7 +166,6 @@ Arm Performance Libraries are available to install using Linux system package ma
Add the Arm Performance Libraries `apt` package repository to your system:

```bash
sudo apt update
. /etc/os-release
curl "https://developer.arm.com/packages/arm-toolchains:${NAME,,}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/Release.key" | sudo tee /etc/apt/trusted.gpg.d/developer-arm-com.asc
echo "deb https://developer.arm.com/packages/arm-toolchains:${NAME,,}-${VERSION_ID/%.*/}/${VERSION_CODENAME}/ ./" | sudo tee /etc/apt/sources.list.d/developer-arm-com.list
Expand Down Expand Up @@ -200,13 +207,13 @@ module avail
The output should be similar to:

```output
armpl/25.07_gcc
armpl/26.01_gcc
```

Load the appropriate module:

```console
module load armpl/25.07_gcc
module load armpl/26.01_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