advtool-install

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.

Learn about using Advance Toolchain

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

Learn about using Advance Toolchain

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

Learn about using Advance Toolchain

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].

Learn about using Advance Toolchain

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.

Learn about using Advance Toolchain

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

Learn about using Advance Toolchain

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.

Learn about using Advance Toolchain

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.

Learn about using Advance Toolchain