The following instructions describe how to install Oracle-Supported RDMA on an Oracle Linux 8 system. These instructions include steps on how to remove other previously installed RDMA packages that could cause conflicts when installing the UEK R7 RDMA packages.

If the system is running Oracle Linux 9, see Installing Oracle-Supported RDMA Packages on Oracle Linux 9 for instructions.

1. Subscribe the system to the appropriate RDMA ULN channel or yum repository.

   • If you're using the Oracle Linux yum server, enable the ol8_UEKR7_RDMA repository for Oracle Linux 8, for example:

     sudo dnf config-manager --enable ol8_baseos_latest ol8_UEKR7 ol8_UEKR7_RDMA

   • If you're using ULN, subscribe to ol8_x86_64_UEKR7_RDMA channel.

   For further instructions, see Subscribing to ULN Channels and Enabling Access to Oracle Linux Yum Server Repositories.

2. Remove any existing packages that are related to RDMA, for example:

   sudo dnf remove 'ibacm*'
   sudo dnf remove 'ibutils*'
   sudo dnf remove 'infiniband-diags*'
   sudo dnf remove 'libibacl*'
   sudo dnf remove 'libibcm*'
   sudo dnf remove 'libibmad*'
   sudo dnf remove 'libibumad*'
   sudo dnf remove 'libibverbs*'
   sudo dnf remove 'librdmacm*'
   sudo dnf remove 'mstflint*'
   sudo dnf remove 'opensm*'
   sudo dnf remove 'oracle-rdma-release'
   sudo dnf remove 'oracle-rdma-tools'
   sudo dnf remove 'perftest*'
   sudo dnf remove 'qperf*'
   sudo dnf remove 'rdma*'
   sudo dnf remove 'rds-tools*'

3. Clean the yum cached files from all the enabled repositories:

   sudo dnf clean all

4. Install the RDMA packages for UEK R7.

   • Use the following commands to install the core packages:

     sudo dnf install rdma-core
     sudo dnf install libibverbs-utils
     sudo dnf install librdmacm-utils
     sudo dnf install mstflint
     sudo dnf install oracle-rdma-tools
     sudo dnf install rds-tools

     • If installing on a bare-metal system, install the infiniband-diags package:

       sudo dnf install infiniband-diags

     • If installing on a guest VM, install the infiniband-diags-guest package:

       sudo dnf install infiniband-diags-guest

   • (Optional) If you require the perftest package, install the package by running:

     sudo dnf install perftest

   • (Optional) If you require the qperf package, install the package by running:

     sudo dnf install qperf

   • (Optional) If you require the libpcap package, install the package by running:

     sudo dnf install libpcap

   • (Optional) If you require the ibacm package, install the package by running:

     sudo dnf install ibacm

   • (Optional) If you require the srp_daemon package, install the package by running:

     sudo dnf install srp_daemon

Each UEK release requires a different set of RDMA packages. If you change the kernel on the system to a UEK release that's earlier than UEK R7, remove the RDMA packages as instructed earlier before installing the correct packages for the new kernel.

The process of installing Oracle-supported RDMA packages on Oracle Linux 9 is simplified by using new user space packages, and a dedicated ULN channel and yum repository for RDMA-related packages.

If the system is running Oracle Linux 8, the process of installing Oracle-supported RDMA packages remains the same as it was in previous releases. For instructions, see Installing Oracle-Supported RDMA Packages on Oracle Linux 8.

The following instructions describe how to install RDMA release packages on an Oracle Linux 9 system:

1. Ensure that you have subscribed to the ULN channel or have enabled the yum repository that contains the RDMA-related user space packages for Oracle Linux 9.

   • If you're installing packages from ULN, subscribe to the ol9_x86_64_RDMA channel.

   • If you're installing packages from the Oracle Linux yum server, enable the ol9_RDMA yum repository.

2. Clean the yum cached files from all the enabled repositories by running the following command:

   sudo dnf clean all

3. Install the RDMA packages for UEK R7.

   • Use the following commands to install the core packages:

     sudo dnf install rdma-core
     sudo dnf install libibverbs-utils
     sudo dnf install librdmacm-utils
     sudo dnf install mstflint
     sudo dnf install oracle-rdma-tools
     sudo dnf install rds-tools

     • If installing on a bare-metal system, install the infiniband-diags package:

       sudo dnf install infiniband-diags

     • If installing on a guest VM, install the infiniband-diags-guest package:

       sudo dnf install infiniband-diags-guest

   • (Optional) If you require the perftest package, install the package by running:

     sudo dnf install perftest

   • (Optional) If you require the qperf package, install the package by running:

     sudo dnf install qperf

   • (Optional) If you require the libpcap package, install the package by running:

     sudo dnf install libpcap

   • (Optional) If you require the ibacm package, install the package by running:

     sudo dnf install ibacm

   • (Optional) If you require the srp_daemon package, install the package by running:

     sudo dnf install srp_daemon

You can upgrade the Oracle-supported RDMA packages on Oracle Linux 8 and Oracle Linux 9 by using the dnf update command.

If you're upgrading a system that has the oracle-rdma-release or oracle-rdma-release-guest package installed, if the package version is lower than version 0.18.1-1 and you intend to upgrade to version 0.18.1-1, or later, you must first manually remove the rdma-core-devel package. Remove this package by using the rpm -e --nodeps command, which removes the package outside of the standard yum or DNF package manager control and leaves any dependencies intact, for example:

sudo /bin/rpm -e --nodeps rdma-core-devel
sudo dnf update

sudo dnf remove oracle-rdma-release*