Merge pull request #3493 from anupras-mohapatra-arm/install-guides

jasonrandrews · web-flow · commit bc4ddfbf8d1d · 2026-07-14T11:51:09.000-05:00
Arm Toolchains repo install guide review
diff --git a/content/install-guides/arm-toolchains-repository.md b/content/install-guides/arm-toolchains-repository.md
@@ -1,5 +1,5 @@
 ---
-title: Arm Linux Toolchains Repository
+title: Arm Toolchains repository
 
 draft: true
 
@@ -17,7 +17,7 @@ test_images:
   - ubuntu:latest
 
 official_docs: https://developer.arm.com/tools-and-software
-description: Configure the Arm Linux Toolchains Repository package archive on supported Linux AArch64 distributions to enable installing Arm Toolchains products using the system package manager.
+description: Configure the Arm Toolchains repository on supported Linux aarch64 distributions to install Arm Toolchain for Linux and Arm Performance Libraries using the system package manager.
 author: Gary Carroll
 
 weight: 1                       # Defines page ordering. Must be 1 for first (or only) page.
@@ -27,27 +27,23 @@ multitool_install_part: false   # Set to true if a sub-page of a multi-page arti
 layout: installtoolsall         # DO NOT MODIFY. Always true for tool install articles
 ---
 
-The Arm Linux Toolchains Repository provides a native and convenient way to install selected Arm software products on supported Linux hosts using the host operating system package manager.
+The [Arm Toolchains repository](https://developer.arm.com/packages/arm-toolchains/) provides a native and convenient way to install selected Arm software products on supported Linux hosts using the host operating system package manager.
 
-The repository files are published at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/).
-
-They are used to distribute Linux packages for Arm Toolchains, including:
+The repository files are used to distribute Linux packages for Arm Toolchains, including:
 
 - Arm Toolchain for Linux
 - Arm Performance Libraries for supported compilers on Linux
 
-Using the Arm Toolchains Linux Repository allows you to install, upgrade, and manage these products using standard Linux package-management tools such as `apt`, `dnf`, `yum`, and `zypper`.
-
-Root or `sudo` permissions are required to install system packages.
-
-{{% notice Repository signing key update July 2026 %}}
-Arm has recently reviewed and strengthened the repository management and publication processes used for the Arm Linux Toolchains Repository.
+Using the repository, you can install, upgrade, and manage these packages using standard Linux package-management tools such as `apt`, `dnf`, `yum`, and `zypper`.
 
-As part of the continuing evolution of this release channel, Arm has revoked and replaced the signing key.
+To use the repository, you'll need to install the repository package. Arm provides an `arm-toolchains-repository` package for each supported Linux distribution. The package installs:
 
-If you previously configured the Arm Linux Toolchains Repository, install the `arm-toolchains-repository` package version `2-2` or later before installing or upgrading Arm Toolchain for Linux or Arm Performance Libraries.
+- the Arm Toolchains repository definition for your Linux distribution
+- the Arm Toolchains repository signing public key
+- package manager configuration that associates the repository with the correct signing key
 
-Existing installed copies of Arm Toolchain for Linux and Arm Performance Libraries continue to work.
+{{% notice Note %}}
+You need root or `sudo` permissions to install system packages.
 {{% /notice %}}
 
 ## Before you begin
@@ -58,43 +54,34 @@ Confirm you are using an Arm Linux system by running:
 uname -m
 ```
 
-The output should be:
+The output is similar to:
 
 ```output
 aarch64
 ```
 
-The commands in this guide use the native package manager for your distribution:
+Use the native package manager for your distribution:
 
 - `apt` for Ubuntu LTS releases from 22.04
 - `dnf` or `yum` for RHEL 8 or later and Amazon Linux 2023
 - `zypper` for SLES 15 or 16
 
-## What is the Arm Linux Toolchains Repository? 
-
-Arm provides an `arm-toolchains-repository` for each supported Linux distribution.
-
-This package configures the Arm Linux Toolchains Repository on your host system.
-
-The package installs:
-
-- the Arm Toolchains repository definition for your Linux distribution
-- the Arm Toolchains repository signing public key
-- package manager configuration that associates the repository with the correct signing key
+## About the signing key
 
-Install this repository package before you install Arm Toolchain for Linux or Arm Performance Libraries.
+Linux package managers use cryptographic signing keys to verify that repository metadata and packages are authentic and come directly from Arm.
 
-## About the signing key 
+In July 2026, Arm reviewed and strengthened the repository management and publication processes used for the Arm Toolchains repository. As part of the continuing evolution of this release channel, Arm revoked and replaced the signing key.
 
-Linux package managers use cryptographic signing keys to verify that repository metadata and packages are authentic and come directly from Arm.
+If you're setting up a new system after July 2026, installing the `arm-toolchains-repository` package automatically configures the current repository signing key for you. You don't need to install the key manually or verify fingerprints.
 
-If you are setting up a new system, installing the `arm-toolchains-repository` package automatically configures the current repository signing key for you. No manual key installation or fingerprint verification is required.
+However, if you're upgrading a system that configured the Arm Toolchains repository for Linux before July 2026, you need to update the repository configuration to use the new key. 
+Otherwise, your package manager might refuse to refresh repository metadata or install packages.
 
-However, if you are upgrading a system that previously configured the Arm Toolchains Linux repository before July 2026, you must update the repository configuration to use the new key. Otherwise, your package manager may refuse to refresh repository metadata or install packages.
+Existing installed copies of Arm Toolchain for Linux and Arm Performance Libraries continue to work.
 
 ### Repository signing key fingerprints
 
-For reference or manual verification, the fingerprints of the previous and current Arm Toolchains signing keys are:
+For reference or manual verification, the fingerprints of the previous and current Arm Toolchains signing keys are as follows.
 
 Previous fingerprint:
 
@@ -108,7 +95,7 @@ Current fingerprint:
 A406 5BCE 9386 DD1E 62FD  E03B 8144 CA16 11A0 BD71
 ```
 
-### (Optional) Manually verifying the signing key
+### (Optional) Manually verify the signing key
 
 If you want to manually verify the signing key, ensure the `gpg` utility (part of GnuPG) is installed on your system, then download the key file and display its fingerprint:
 
@@ -123,37 +110,26 @@ The output should show the current fingerprint:
 A406 5BCE 9386 DD1E 62FD  E03B 8144 CA16 11A0 BD71
 ```
 
-## Expected package manager errors
-
-If your system still trusts only the previous Arm Linux Toolchains Repository signing key, package manager operations might fail when you refresh metadata, install packages, or upgrade packages.
+## Previous repository locations
 
-Ubuntu hosts may experience errors running the `apt update` command, for example:
+The current Arm Toolchains repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/) replaces the earlier repository structure that was based on repositories built using the SUSE Open Build Service.
 
-```output
-Err:1 https://developer.arm.com/packages/arm-toolchains/ubuntu noble InRelease
-  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY <key-id>
-W: An error occurred during the signature verification. The repository is not updated and the previous index files will be used. GPG error: <error>
-W: Some index files failed to download. They have been ignored, or old ones used instead.
-```
-
-RPM based hosts may download the new signing key but refuse to use it:
+Earlier repositories were published under the top-level package URL [https://developer.arm.com/packages/](https://developer.arm.com/packages/) and used repository prefixes such as:
 
 ```output
-The GPG keys listed for the "Arm Toolchains" repository are already installed but they are not correct for this package.
-Check that the correct key URLs are configured for this repository..
- GPG Keys are configured as: file:///etc/pki/rpm-gpg/RPM-GPG-KEY-arm-toolchains
-Error: GPG check FAILED
+ACfL:<distro>
+arm-toolchains:<distro>
 ```
 
-These errors are expected on systems that have not yet installed the updated repository package or accepted the new signing key.
+These earlier repositories are deprecated but will continue to work until further notice.
 
-Install the `arm-toolchains-repository` package version `2-2` or later for your Linux distribution, then refresh package metadata to resolve such errors.
+Don't configure new systems to use the deprecated `ACfL:` or `arm-toolchains:` repository paths. Migrate existing systems to the current Arm Toolchains Linux repositories and install the current `arm-toolchains-repository` package.
 
-## Install the repository package
+The deprecated repositories will be removed in a future update.
 
-Install `arm-toolchains-repository` version `2-2` or later for your Linux distribution.
+## Install the repository package directly
 
-The examples below install the repository package directly from [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/). This allows you to update the repository configuration even if your package manager cannot currently refresh the Arm Toolchains repository metadata.
+Use one of the following commands to install the repository package [directly](https://developer.arm.com/packages/arm-toolchains/). This allows you to update the repository configuration even if your package manager can't currently refresh the Arm Toolchains repository metadata.
 
 {{< tabpane code=true >}}
   {{< tab header="Ubuntu 24.04" language="bash" >}}
@@ -198,36 +174,10 @@ sudo zypper refresh
   {{< /tab >}}
 {{< /tabpane >}}
 
-## Verify the repository package version
 
-After installing the repository package, verify that version `2-2` or later is installed.
+## Use manual recovery
 
-{{< tabpane code=true >}}
-  {{< tab header="Ubuntu" language="bash" >}}
-dpkg -l arm-toolchains-repository
-  {{< /tab >}}
-  {{< tab header="RPM-based distributions" language="bash" >}}
-rpm -q arm-toolchains-repository
-  {{< /tab >}}
-{{< /tabpane >}}
-
-The installed version should be `2-2` or later.
-
-## Install Arm Toolchain for Linux
-
-After installing the repository package, follow the [Arm Toolchain for Linux installation instructions](https://developer.arm.com/documentation/110477/latest/Installation) for your distribution.
-
-The repository package must be installed first because it configures the package manager repository and the signing key used to verify packages.
-
-## Install Arm Performance Libraries
-
-After installing the repository package, follow the [Arm Performance Libraries installation instructions](https://developer.arm.com/documentation/102620/latest/Installation) for your distribution.
-
-The repository package must be installed first because it configures the package manager repository and the signing key used to verify packages.
-
-## Manual recovery
-
-The recommended method is to install `arm-toolchains-repository` version `2-2` or later.
+The recommended method is to install `arm-toolchains-repository` version `2-2` or later directly.
 
 Use manual recovery only if you cannot install the repository package directly.
 
@@ -269,9 +219,9 @@ grep -Rns "developer.arm.com/packages/arm-toolchains/ubuntu" \
   /etc/apt/sources.list /etc/apt/sources.list.d 
 ```
 
-If the command finds an existing entry, edit that entry so it references `/usr/share/keyrings/arm-toolchains-archive-keyring.gpg` using `signed-by`. Do not create a second entry for the same repository because `apt` may report conflicting `Signed-By` values.
+If the command finds an existing entry, edit that entry so it references `/usr/share/keyrings/arm-toolchains-archive-keyring.gpg` using `signed-by`. Don't create a second entry for the same repository because `apt` might report conflicting `Signed-By` values.
 
-If the command does not find an entry, create `/etc/apt/sources.list.d/arm-toolchains.list` using the appropriate command below.
+If the command doesn't find an entry, create `/etc/apt/sources.list.d/arm-toolchains.list` using one of the following commands:
 
 For Ubuntu 24.04, run:
 
@@ -287,7 +237,7 @@ echo "deb [signed-by=/usr/share/keyrings/arm-toolchains-archive-keyring.gpg] htt
   sudo tee /etc/apt/sources.list.d/arm-toolchains.list
 ```
 
-Refresh package metadata:
+After creating `arm-toolchains.list`, refresh package metadata:
 
 ```bash
 sudo apt update
@@ -314,7 +264,7 @@ Check that the key is installed:
 rpm -qa gpg-pubkey*
 ```
 
-Refresh package metadata.
+Refresh package metadata by running one of the following set of commands.
 
 For RHEL, Amazon Linux, and compatible RPM-based distributions:
 
@@ -330,29 +280,50 @@ sudo zypper clean
 sudo zypper refresh
 ```
 
-## Previous repository locations
+## Verify the repository package version
 
-The current Arm Toolchains Linux Repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/) replaces the earlier repository structure that was based on repositories built using the SUSE Open Build Service.
+After installing the repository package, verify the installation:
 
-Earlier repositories were published under the top-level package URL [https://developer.arm.com/packages/](https://developer.arm.com/packages/) and used repository prefixes such as:
+{{< tabpane code=true >}}
+  {{< tab header="Ubuntu" language="bash" >}}
+dpkg -l arm-toolchains-repository
+  {{< /tab >}}
+  {{< tab header="RPM-based distributions" language="bash" >}}
+rpm -q arm-toolchains-repository
+  {{< /tab >}}
+{{< /tabpane >}}
+
+The installed version should be `2-2` or later.
+
+## Troubleshoot package manager errors
+
+If your system still trusts only the previous Arm Toolchains Repository signing key, package manager operations might fail when you refresh metadata, install packages, or upgrade packages.
+
+Ubuntu hosts might experience errors running the `apt update` command, for example:
 
 ```output
-ACfL:<distro>
-arm-toolchains:<distro>
+Err:1 https://developer.arm.com/packages/arm-toolchains/ubuntu noble InRelease
+  The following signatures couldn't be verified because the public key is not available: NO_PUBKEY <key-id>
+W: An error occurred during the signature verification. The repository is not updated and the previous index files will be used. GPG error: <error>
+W: Some index files failed to download. They have been ignored, or old ones used instead.
 ```
 
-These earlier repositories are deprecated but will continue to work until further notice.
+RPM-based hosts might download the new signing key but refuse to use it:
+
+```output
+The GPG keys listed for the "Arm Toolchains" repository are already installed but they are not correct for this package.
+Check that the correct key URLs are configured for this repository..
+ GPG Keys are configured as: file:///etc/pki/rpm-gpg/RPM-GPG-KEY-arm-toolchains
+Error: GPG check FAILED
+```
 
-Do not configure new systems to use the deprecated `ACfL:` or `arm-toolchains:` repository paths. Existing users should migrate to the current Arm Toolchains Linux repositories and install the current `arm-toolchains-repository` package.
+To resolve these errors, install the updated repository package and accept the new signing key.
 
-The deprecated repositories will be removed in a future update.
+## Next steps
 
-## Summary
+After installing the repository package, you're ready to install the Arm Toolchain for Linux and the Arm Performance Libraries.
 
-The Arm Linux Toolchains Repository provide a native package manager based installation channel for Arm Toolchain for Linux and Arm Performance Libraries on supported Linux hosts.
+For installation instructions, see the [Arm Toolchain for Linux installation instructions](https://developer.arm.com/documentation/110477/latest/Installation) and the [Arm Performance Libraries installation instructions](/install-guides/armpl/) for your distribution.
 
-To use the repositories, install `arm-toolchains-repository` version `2-2` or later for your Linux distribution. This package configures the repository and installs the current repository signing key.
 
-Use only the current Arm Linux Toolchains Repository at [https://developer.arm.com/packages/arm-toolchains/](https://developer.arm.com/packages/arm-toolchains/).
 
-Do not use the deprecated top-level `ACfL:` or `arm-toolchains:` repository paths for new installations.
diff --git a/content/install-guides/armpl.md b/content/install-guides/armpl.md
@@ -170,13 +170,14 @@ If you want to change the installation directory location, use the `--install-to
 
 Arm Performance Libraries are available to install using Linux system package managers. The following instructions are for the Ubuntu 24.04 system package manager `apt` command.
 
-Add the Arm Performance Libraries `apt` package repository to your system:
+Add the Arm Toolchains `apt` package repository to your system:
 
 ```bash
 curl -O https://developer.arm.com/packages/arm-toolchains/ubuntu/pool/arm-toolchains-repository_2-1~noble_all.deb
 sudo dpkg -i arm-toolchains-repository_2-1~noble_all.deb
 sudo apt update
 ```
+For more information about setting up the Arm Toolchains repository, see [Arm Toolchains](/install-guides/arm-toolchains-repository/).
 
 Download and install Arm Performance Libraries:
 
