From 11369f23f4d647ef11f9a48d80d4aebb03e6e461 Mon Sep 17 00:00:00 2001 From: Will Fantom Date: Mon, 14 Oct 2024 15:32:36 +0100 Subject: [PATCH 1/2] Update ACfL and ArmPL install guides for 24.10 With the upcoming releases of of ACfL and ArmPL, this updates their relevant install guides to support the upcoming changes. --- content/install-guides/acfl.md | 39 +++++++++++++++++++-------------- content/install-guides/armpl.md | 28 +++++++++++------------ 2 files changed, 37 insertions(+), 30 deletions(-) diff --git a/content/install-guides/acfl.md b/content/install-guides/acfl.md index 8a00d6c7c0..da764305ca 100644 --- a/content/install-guides/acfl.md +++ b/content/install-guides/acfl.md @@ -101,11 +101,11 @@ Fetch the `ACfL` installers: #### Ubuntu Linux: ```bash { target="ubuntu:latest" } -wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Version_24.04/arm-compiler-for-linux_24.04_Ubuntu-22.04_aarch64.tar +wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Version_24.10/arm-compiler-for-linux_24.10_Ubuntu-22.04_aarch64.tar ``` #### Red Hat Linux: ```bash { target="fedora:latest" } -wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Version_24.04/arm-compiler-for-linux_24.04_RHEL-8_aarch64.tar +wget https://developer.arm.com/-/cdn-downloads/permalink/Arm-Compiler-for-Linux/Version_24.10/arm-compiler-for-linux_24.10_RHEL-9_aarch64.tar ``` ### Install @@ -118,20 +118,27 @@ Each command sequence includes accepting the license agreement to automate the i ```bash { target="ubuntu:latest", env="DEBIAN_FRONTEND=noninteractive" } sudo -E apt-get -y install environment-modules python3 libc6-dev -tar -xvf arm-compiler-for-linux_24.04_Ubuntu-22.04_aarch64.tar -cd ./arm-compiler-for-linux_24.04_Ubuntu-22.04 -sudo ./arm-compiler-for-linux_24.04_Ubuntu-22.04.sh --accept +tar -xvf arm-compiler-for-linux_24.10_Ubuntu-22.04_aarch64.tar +cd ./arm-compiler-for-linux_24.10_Ubuntu-22.04 +sudo ./arm-compiler-for-linux_24.10_Ubuntu-22.04.sh --accept ``` #### Red Hat Linux: ```bash { target="fedora:latest" } sudo yum -y install environment-modules python3 glibc-devel -tar -xvf arm-compiler-for-linux_24.04_RHEL-8_aarch64.tar -cd arm-compiler-for-linux_24.04_RHEL-8 -sudo ./arm-compiler-for-linux_24.04_RHEL-8.sh --accept +tar -xvf arm-compiler-for-linux_24.10_RHEL-9_aarch64.tar +cd arm-compiler-for-linux_24.10_RHEL-9 +sudo ./arm-compiler-for-linux_24.10_RHEL-9.sh --accept ``` +⚠️ **Compatability with Non-ACfL GCC:** On RPM based (Red Hat) systems, if an +alternative version of GCC (not the GCC bundled with ACfL) is installed +**after** ACfL, you will not be able to uninstall ACfL fully. For example, a GDB +(GNU Project Debugger) installation will install the native system GCC. If this +install takes place **after** ACfL, you will no longer be able to fully +uninstall ACfL. + ### Set up environment `Arm Compiler for Linux` uses environment modules to dynamically modify your user environment. Refer to the [Environment Modules documentation](https://lmod.readthedocs.io/en/latest/#id) for more information. @@ -163,13 +170,13 @@ module avail To configure Arm Compiler for Linux: ```bash { env_source="~/.bashrc" } -module load acfl/24.04 +module load acfl/24.10 ``` To configure GCC: ```bash { env_source="~/.bashrc" } -module load gnu/13.2.0 +module load gnu/14.2.0 ``` `ACfL` is now [ready to use](#armclang). @@ -226,7 +233,7 @@ spack compiler find To get started with the Arm C/C++ Compiler and compile a simple application follow the steps below. Check that the correct compiler version is being used: -```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } armclang --version ``` @@ -244,13 +251,13 @@ int main() Build the application with: -```console { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```console { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } armclang hello.c -o hello ``` Run the application with: -```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } ./hello ``` @@ -264,7 +271,7 @@ Hello, C World! To get started with the Arm Fortran Compiler and compile a simple application follow the steps below. Check that the correct compiler version is being used: -```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } armflang --version ``` @@ -278,12 +285,12 @@ end program hello ``` Build the application with: -```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } armflang hello.f90 -o hello ``` Run the application with: -```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.04" } +```bash { env_source="~/.bashrc", pre_cmd="module load acfl/24.10" } ./hello ``` diff --git a/content/install-guides/armpl.md b/content/install-guides/armpl.md index 7dcb2a42e1..38d80d3794 100644 --- a/content/install-guides/armpl.md +++ b/content/install-guides/armpl.md @@ -70,28 +70,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/-/media/Files/downloads/hpc/arm-performance-libraries/24-04/macos/arm-performance-libraries_24.04_macOS.tgz +wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-performance-libraries/24-10/macos/arm-performance-libraries_24.10_macOS.tgz ``` Use tar to extract the file: ```console -tar zxvf arm-performance-libraries_24.04_macOS.tgz +tar zxvf arm-performance-libraries_24.10_macOS.tgz ``` Output of above command: ```console -armpl_24.04_flang-new_clang_18.dmg +armpl_24.10_flang-new_clang_19.dmg ``` Mount the disk image by running from a terminal: ```console -hdiutil attach armpl_24.04_flang-new_clang_18.dmg +hdiutil attach armpl_24.10_flang-new_clang_19.dmg ``` Now run the installation script as a superuser: ```console -/Volumes/armpl_24.04_flang-new_clang_18_installer/armpl_24.04_flang-new_clang_18_install.sh -y +/Volumes/armpl_24.10_flang-new_clang_19_installer/armpl_24.10_flang-new_clang_19_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. @@ -103,33 +103,33 @@ For more information refer to [Get started with Arm Performance Libraries](https ## 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 and NVHPC. The GCC compatible releases are built with GCC 13 and tested with GCC versions 7 to 13. The NVHPC compatible releases are built and tested with NVHPC 24.1. +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 and NVHPC. The GCC compatible releases are built with GCC 14 and tested with GCC versions 7 to 14. The NVHPC compatible releases are built and tested with NVHPC 24.7. [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: - Amazon Linux 2, Amazon Linux 2023 -- RHEL-7, RHEL-8, RHEL-9 -- SLES-15 +- RHEL-8, RHEL-9 +- SLES-15 Service Packs 5 and 6 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: ```console -wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-performance-libraries/24-04/linux/arm-performance-libraries_24.04_deb_gcc.tar +wget https://developer.arm.com/-/media/Files/downloads/hpc/arm-performance-libraries/24-10/linux/arm-performance-libraries_24.10_deb_gcc.tar ``` Use `tar` to extract the file and then change directory: ```console -tar -xf arm-performance-libraries_24.04_deb_gcc.tar -cd arm-performance-libraries_24.04_deb/ +tar -xf arm-performance-libraries_24.10_deb_gcc.tar +cd arm-performance-libraries_24.10_deb/ ``` Run the installation script as a super user: ```console -sudo ./arm-performance-libraries_24.04_deb.sh --accept +sudo ./arm-performance-libraries_24.10_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. @@ -165,13 +165,13 @@ module avail The output should be similar to: ```output -armpl/24.04.0_gcc +armpl/24.10.0_gcc ``` Load the appropriate module: ```console -module load armpl/24.04.0_gcc +module load armpl/24.10.0_gcc ``` You can now compile and test the examples included in the `/opt/arm//examples/`, or `//examples/` directory, if you have installed to a different location than the default. From 789c5932f4437d18c976805e8dbe0cef354619b9 Mon Sep 17 00:00:00 2001 From: Will Fantom Date: Mon, 14 Oct 2024 15:36:13 +0100 Subject: [PATCH 2/2] Fix spellings in ACfL install guide --- content/install-guides/acfl.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/install-guides/acfl.md b/content/install-guides/acfl.md index da764305ca..e015f5ea5f 100644 --- a/content/install-guides/acfl.md +++ b/content/install-guides/acfl.md @@ -188,7 +188,7 @@ See the [Arm Compiler for Linux and Arm PL now available in Spack](https://commu ### Setup Spack -Clone the `Spack` repostitory and add `bin` directory to the path: +Clone the `Spack` repository and add `bin` directory to the path: ```console git clone -c feature.manyFiles=true https://github.com/spack/spack.git