advtool-install

Installing Advance Toolchain for Linux on IBM Power Systems

IBM Advance Toolchain for Linux on Power 16.0-5 is now available! Learn more

Installation instructions

Installing the Advance Toolchain on Red Hat Enterprise Linux (RHEL)

Installing Advance Toolchain on RHEL with YUM

Use these steps to download the public key, create a repository configuration file, and install the Advance Toolchain packages.

  1. The gpg public key is provided in the IBM repositories. This public key is used to verify the authenticity of both the Advance Toolchain packages and the repository contents. Download the gpg public key for your Linux distribution and import it by using the following commands, replacing RHELX with the Red Hat release that you are using and PUBKEY with its respective value.
    • For RHEL8, the gpg public key is: gpg-pubkey-6976a827-5164221b
    • For RHEL9, the gpg public key is: gpg-pubkey-615d762f-62f504a1
    wget https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHELX/PUBKEY
    sudo rpm --import PUBKEY
    
  2. Create a configuration file for the Advance Toolchain repository configuration file: /etc/yum.repos.d/advance-toolchain.repo. Add the following content:
    # Begin of configuration file
    [advance-toolchain]
    name=Advance Toolchain IBM FTP
    baseurl=https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHELX
    enabled=1
    gpgcheck=1
    gpgkey=https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/redhat/RHELX/PUBKEY
    # End of configuration file
    
  3. Install the Advance Toolchain by running yum install. Replace atX.X with the Advance Toolchain release that you are installing. For example, at14.0.
    yum install advance-toolchain-atX.X-runtime \
    advance-toolchain-atX.X-devel \
    advance-toolchain-atX.X-perf
    

    Answer y when YUM prompts for confirmation.

Installing Advance Toolchain on RHEL manually

You can use the Advance Toolchain (AT) downloader tool to download the latest version of all of the AT packages for a supported distribution and create an ISO image if wanted. This script looks at the official FTP sites to find the available distributions and versions and then downloads them to your system. You can then manually install the packages. This method is intended for users with limited Internet access to their Power Systems.

If you are installing the rpm files manually, you need to install them in the following order (due to prerequisites):

advance-toolchain-atX.X-runtime
advance-toolchain-atX.X-devel
advance-toolchain-atX.X-perf
advance-toolchain-atX.X-mcore-libs

If you are updating a previous installation, you need to update as a batch, so rpm can solve the dependencies, that is:

rpm -Uvh advance-toolchain-atX.X-runtime-X.X.ppc64le.rpm \
advance-toolchain-atX.X-devel-X.X.ppc64le.rpm \
advance-toolchain-atX.X-perf-X.X.ppc64le.rpm \
advance-toolchain-atX.X-mcore-X.X.ppc64le.rpm

The rpm command should always be run as root. Failure to do so will result in an error similar to the following message:

error: can't create transaction lock on /var/lib/rpm/__db.000

Installing Advance Toolchain on RHEL with the Linux on Power tools repository

The Advance Toolchain repository can also be configured automatically by the IBM Linux on Power tools after installing the ibm-power-repo package:

  1. Download the RPM package from https://www.ibm.com/support/pages/service-and-productivity-tools
  2. Install the ibm-power-repo RPM package, by running the following command with root user privileges:
    rpm -ivh ibm-power-repo-latest.noarch.rpm
    
  3. After the installation, run the following command with root user privileges:
    /opt/ibm/lop/configure
    
  4. Install the Advance Toolchain by using yum or dnf

Installing the Advance Toolchain on SUSE Linux Enterprise Server (SLES)

Installing Advance Toolchain on SLES with Yast

Use these steps to download the public key, create a repository configuration file, and install the Advance Toolchain packages.

  1. The gpg public key gpg-pubkey-6976a827-5164221b is provided in the IBM repositories. This public key is used to verify the authenticity of both the Advance Toolchain packages and the repository contents. Download the gpg public key for your Linux distribution and import it by using the following commands:
    wget https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/suse/SLES_15/gpg-pubkey-6976a827-5164221b
    rpm --import gpg-pubkey-6976a827-5164221b
    
  2. Run yast2 as root.
  3. Select Add-on Product.
  4. From Media Type, select the FTP Protocol: (x) FTP...
  5. Under Server name, enter public.dhe.ibm.com.
  6. Under Directory on Server, enter:
    /software/server/POWER/Linux/toolchain/at/suse/SLES_X
    

    Replace SLES_X with the SLES release that you are using.

    You will get a warning about there being no product information available. This is because the repomd-based repository does not contain the YaST product information. This is not a bug. Select [Continue].

  7. Under the Software Management interface, search for "advance toolchain" and select the following packages:
    • advance-toolchain-atX.X-runtime
    • advance-toolchain-atX.X-devel
    • advance-toolchain-atX.X-perf
    • advance-toolchain-atX.X-mcore-libs
  8. Click [Accept].

Installing Advance Toolchain on SLES with Zypper

Use these steps to download the public key, create a repository configuration file, and install the Advance Toolchain packages.

  1. The gpg public key gpg-pubkey-6976a827-5164221b is provided in the IBM repositories. This public key is used to verify the authenticity of both the Advance Toolchain packages and the repository contents. Download the gpg public key for your Linux distribution and import it by using the following commands:
    wget https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/suse/SLES_15/gpg-pubkey-6976a827-5164221b
    rpm --import gpg-pubkey-6976a827-5164221b
    
  2. Add IBM FTP to the repository list:
    zypper addrepo https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/suse/SLES_X "Advance Toolchain"
    

    Replace SLES_X with the SLES release that you are using.

    This command creates a new repository entry called "Advance Toolchain" pointing to the IBM FTP site.

  3. Run zypper to install the packages:
    zypper install advance-toolchain-atX.X-runtime \
    advance-toolchain-atX.X-devel \
    advance-toolchain-atX.X-perf \
    advance-toolchain-atX.X-mcore-libs
    

    Warning: Do not try to install the advance-toolchain-atX.X-selinux package if SELinux isn't installed and enabled.

  4. You will be prompted to trust the repository key (AdvanceToolchain05). Press a for always trusting this key, then y to confirm packages installation. Optionally, you might also install the advance-toolchain-atX.X-mcore-libs package, which contains the multi-core exploitation libraries (versions 5.0-3 or newer), and the advance-toolchain-atX.X-selinux package (versions 5.0-7 or newer), which enables compatibility with SELinux.

Installing Advance Toolchain on SLES manually

You can use the Advance Toolchain (AT) downloader tool to download the latest version of all of the AT packages for a supported distribution and create an ISO image if wanted. This script looks at the official FTP sites to find the available distributions and versions and then downloads them to your system. You can then manually install the packages. This method is intended for users with limited Internet access to their Power Systems.

If you are installing the rpm files manually, you need to install them in the following order (due to prerequisites):

advance-toolchain-atX.X-runtime-X.X
advance-toolchain-atX.X-devel-X.X
advance-toolchain-atX.X-perf-X.X
advance-toolchain-atX.X-mcore-libs-X.X
advance-toolchain-atX.X-runtime-atX.X-compat-X.X

If you are updating a previous installation, you need to update as a batch, so rpm can solve the dependencies, that is:

rpm -Uvh advance-toolchain-atX.X-runtime-X.X.ppc64le.rpm \
advance-toolchain-atX.X-devel-X.X.ppc64le.rpm \
advance-toolchain-atX.X-perf-X.X.ppc64le.rpm \
advance-toolchain-atX.X-mcore-X.X.ppc64le.rpm \
advance-toolchain-atX.X-runtime-atX.X-compat-X.X.ppc64le.rpm

The rpm command should always be run as root. Failure to do so will result in an error similar to the following message:

error: can't create transaction lock on /var/lib/rpm/__db.000

Installing Advance Toolchain on SLES with the Linux on Power tools repository

The Advance Toolchain repository can also be configured automatically by the IBM Linux on Power tools after installing the ibm-power-repo package:

  1. Download the RPM package from https://www.ibm.com/support/pages/service-and-productivity-tools
  2. Install the ibm-power-repo RPM package, by running the following command with root user privileges:
    rpm -ivh ibm-power-repo-latest.noarch.rpm
    
  3. After the installation, run the following command with root user privileges:
    /opt/ibm/lop/configure
    
  4. Install the Advance Toolchain by using yum or dnf

Installing the Advance Toolchain on Ubuntu or Debian

Installing Advance Toolchain on Ubuntu or Debian with Aptitude

Use these steps to download the public key, create a repository configuration file, and install the Advance Toolchain packages.

  1. The gpg public key is provided in the IBM repositories. This public key is used to verify the authenticity of both the Advance Toolchain packages and the repository contents. Download the gpg public key for your Linux distribution and import it by using the following commands:
    • For Ubuntu 20.04:
      wget https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu/dists/focal/6976a827.gpg.key
      sudo apt-key add 6976a827.gpg.key
      
    • For Debian 12, Debian 11 or Ubuntu 22.04:
      wget -qO- https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu/dists/jammy/615d762f.gpg.key | sudo tee -a /etc/apt/trusted.gpg.d/615d762f.asc
      
  2. Configure the Advance Toolchain repositories by adding the following line to /etc/apt/sources.list:

    On ppc64el or amd64:

    • When you install on Ubuntu 22.04 (jammy) or Ubuntu 20.04 (focal), point to its respective repository:
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu jammy atX.X
      deb https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu focal atX.X
      
    • When you install on Debian 12 (bookworm) or Debian 11 (bullseye), point to its respective repository:
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/debian bookworm atX.X
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/debian bullseye atX.X
      
  3. Refresh the aptitude cache by running:
    sudo aptitude update
    
  4. Install the Advance Toolchain package running the following command:
    sudo aptitude install advance-toolchain-atX.X-runtime \
    advance-toolchain-atX.X-devel \
    advance-toolchain-atX.X-perf \
    advance-toolchain-atX.X-mcore-libs
    

aptitude supports package upgrades for new revision releases (for example, from 14.0-0 to 14.0-1). For new major releases (for example, from 13.0-1 to 14.0-0), proceed as in a normal installation.

Installing Advance Toolchain on Ubuntu or Debian with Apt

Use these steps to download the public key, create a repository configuration file, and install the Advance Toolchain packages.

  1. The gpg public key is provided in the IBM repositories. This public key is used to verify the authenticity of both the Advance Toolchain packages and the repository contents. Download the gpg public key for your Linux distribution and import it by using the following commands:
    • For Ubuntu 20.04:
      wget https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu/dists/focal/6976a827.gpg.key
      sudo apt-key add 6976a827.gpg.key
      
    • For Debian 12, Debian 11 or Ubuntu 22.04:
      wget -qO- https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu/dists/jammy/615d762f.gpg.key | sudo tee -a /etc/apt/trusted.gpg.d/615d762f.asc
      
  2. Configure the Advance Toolchain repositories by adding the following line to /etc/apt/sources.list:

    On ppc64el or amd64:

    • When you install on Ubuntu 22.04 (jammy) or Ubuntu 20.04 (focal), point to its respective repository:
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu jammy atX.X
      deb https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/ubuntu focal atX.X
      
    • When you install on Debain 12 (bookworm) or Debian 11 (bullseye), point to its respective repository:
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/debian bookworm atX.X
      deb [signed-by=/etc/apt/trusted.gpg.d/615d762f.asc] https://public.dhe.ibm.com/software/server/POWER/Linux/toolchain/at/debian bullseye atX.X
      
  3. Refresh the apt cache by running:
    sudo apt update
    
  4. Install the Advance Toolchain package running the following command:
    sudo apt install advance-toolchain-atX.X-runtime \
    advance-toolchain-atX.X-devel \
    advance-toolchain-atX.X-perf \
    advance-toolchain-atX.X-mcore-libs
    

apt supports package upgrades for new revision releases (that is, 14.0-0 to 14.0-1). For new major releases (that is, 13.0-1 to 14.0-0), proceed as in a normal installation.

Cross-compiler

The Advance Toolchain cross-compiler provides a way to compile programs for POWER by using an x86 (i386) or x86-64 (amd64) machine, helping teams to start developing for POWER without having access to a server in the early development phase.