Install

To have all of the Arm Allinea Studio tools available to use, you must install both the Arm Compiler for Linux and Arm Forge packages.

Install Arm Compiler for Linux

Follow these instructions to install the Arm Compiler for Linux package.

Before you begin

If any of the following tools are not already installed by your Linux distribution, you must install them before installing Arm Compiler for Linux:

  • Python (version 2.7 or later)
  • C Libraries:
    • SUSE and RHEL: glibc-devel
    • Ubuntu:                 libc6-dev

You must have at least 3 GB of free hard disk space to both download and unpack the Arm Compiler for Linux package. You must also have an additional 5 GB of free space to install the package.

Procedure

  1. Extract the downloaded package:

    tar -xvf <package_name>.tar

    Replace <package_name> with the full name of the downloaded package.

  2. Change to the extracted package directory:

    cd <package_name>
  3. Install the package:

    • To install the package using the default options (requires superuser permissions), run:

      sudo ./<package_name>.sh
      The packages are installed to /opt/arm/<package_name>.

    • To install the package using a set of options, run:

      sudo ./<package_name>.sh <options>
      Note: sudo permissions are not required if you install the package to a location where you have write permissions using --install-to (see table below).

      Where <options> can be one or more of:

      Option
      Description
      -a, --accept Automatically accept the EULA
      (the EULA still displays).
      -l, --list-packages List the installer packages
      -i, --install-to <install_location> Install to the given directory, <install_location>.
      Use this option if you do not have sudo rights to install to /opt/arm or another central location.
      -s, --save-packages-to <install_location> Extracts the .deb or .rpm files to the given directory, <install_location>.
      -f, --force Force an install attempt to a non-empty directory.
      -h, --help Display this table in the form of a help message in the terminal.

      The packages are installed to <install_dir>/<package_name>, where <install_dir> defaults to /opt/arm if not explicitly provided using the --install-to option.

  4. The installer displays the EULA and prompts you to agree to the terms. To agree, type 'yes' at the prompt.

Note: Arm recommends that you rebuild your MPI implementation (Open MPI, MVAPICH, MPICH) after each installation of a new version of Arm Compiler for Linux. This ensures that the Fortran interface incorporates any changes to the armflang module format, and that the correct run-time libraries are used.

(Optional) Enable command line completion

The following information only applies if: a) a users' system does not have the 'bash-autocomplete' package installed, or b) users do not use bash shells, but want to use the command line complete functionality that the bash-autocomplete.sh script allows.

If 'bash-completion' is installed, you can load the 'arm<major-version>/<package-version>' environment module and use the command line completion tool immediately.

Arm Compiler for Linux versions 20.2+ include a tool that allows bash terminal users to autocomplete their command line using the Tab key on their keyboard. For compile commands, it allows users to press Tab to auto-complete the armflang|armclang|armclang++ commands, supported compiler options, and option arguments. For example, to list the supported arguments for -ffp-contract= with armclang, users can type the following command line into your terminal and press Tab where indicated by [TAB]:

armclang -ffp-contract=[TAB]

The arguments supported by -ffp-contract=return:

fast off on

Auto-completion relies on the support in a users' shell, and on the completion functions for the compiler (which make use of the  <install-dir>/share/utils/bash-autocomplete.sh file in the Arm Compiler for Linux package). If, after you have loaded the compiler modulefile, the command line completion is not working, consider the following points:  

  • To enable bash users to use this functionality, System Administrators should ensure that the 'bash-completion' package is installed and available for all users to use.

  • To enable users of other shell types to use this functionality, System Administrators must rewrite the _clang() function defined in <install-dir>/share/utils/bash-autocomplete.sh using an appropriate syntax for your users' shell, then register the _clang() function with the completion system for that shell. To automatically register autocompletion scripts when the 'arm<major-version>/<package-version>' environment module is loaded, System Administrators might also want to modify the 'arm<major-version>/<package-version>' module.

Install Arm Forge

These steps describe the Linux text-mode install for Arm Forge, however a graphical installation is also available. For the full instructions on how to install Arm Forge on your Linux platform, see the installation instructions in the Arm Forge User Guide.

Procedure

  1. Untar the Arm Forge installation package and run the textinstall.sh script by using these commands:

    tar xf arm-forge-<version>-linux-aarch64.tar
        cd arm-forge-<version>-linux-aarch64
        ./textinstall.sh
    Note: Replace <version> with the required version. For example, the AArch64 Linux tarball package for the 21.0 version is:
    arm-forge-21.0-linux-aarch64.tar
  2. When you are prompted, press Return to read the license. When prompted, agree to the license terms by typing a, and pressing Enter. Next, when prompted, enter the path of the Arm Forge installation directory. The directory must be accessible on all the nodes in your cluster.

Install Arm Licence Server

If you will use Arm Allinea Studio with a floating license, you must also install Arm Licence Server to serve your floating license.

You do not need to install Arm Licence Server if you have an evaluation or named user licence.

Procedure

To install Arm Licence Server:

  1. Untar the Arm Forge installation package and run the textinstall.sh script by using these commands:
    tar xf arm-licence-server-linux-aarch64.tar
    cd arm-licence-server-linux-aarhc64
    ./textinstall.sh
    Replace with the four digit version number of your installation package using the format xx.x for major product releases, and the format xx.x.x for support releases. For example, the AArch64 Linux tarball package for the 21.0 version is:
    arm-forge-21.0-linux-aarch64.tar
  2. When you are prompted, press Return to read the license, and enter the path of the installation directory.

A full description of how to install, setup, and use Arm Licence Server is provided in the Arm Licence Server User Guide.


Previous Next