Installing Oracle-Supported RDMA Packages for x86_64 platforms

The following procedure describes how to install the RDMA release packages. The instructions describe how to remove previous existing oracle-ofed-release packages and other previously installed RDMA packages that could cause conflicts during the installation of the UEK R6 RDMA packages. Note that the yum commands used in this procedure are interchangeable with the dnf command available in Oracle Linux 8.

  1. In addition to the ULN channels and yum repositories described in Subscribing to ULN Channels and Enabling Access to Oracle Linux Yum Server Repositories, subscribe the system to the appropriate RDMA ULN channel or yum repository.

    If you're using the Oracle Linux yum server, enable the ol7_UEKR6_RDMA repository for Oracle Linux 7; or the ol8_UEKR6_RDMA repository for Oracle Linux 8. For example, on Oracle Linux 7 run the following command:

    sudo yum-config-manager --enable ol7_latest ol7_UEKR6 ol7_UEKR6_RDMA

    On Oracle Linux 8 run the following command:

    sudo dnf config-manager --enable ol8_baseos_latest ol8_UEKR6 ol8_UEKR6_RDMA

    If you're subscribed to ULN, you can subscribe to ol7_x86_64_UEKR6_RDMA for Oracle Linux 7; or ol8_x86_64_UEKR6_RDMA for Oracle Linux 8.

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

    sudo yum remove 'ibacm*'
    sudo yum remove 'ib-bonding*'
    sudo yum remove 'ibutils*'
    sudo yum remove 'infiniband-diags*'
    sudo yum remove 'libibacl*'
    sudo yum remove 'libibcm*'
    sudo yum remove 'libibmad*'
    sudo yum remove 'libibumad*'
    sudo yum remove 'libibverbs*'
    sudo yum remove 'libmlx4*'
    sudo yum remove 'librdmacm*'
    sudo yum remove 'libsdp*'
    sudo yum remove 'mlnx-tools'
    sudo yum remove 'mstflint*'
    sudo yum remove 'ofed-docs*'
    sudo yum remove 'ofed-scripts*'
    sudo yum remove 'opensm*'
    sudo yum remove 'oracle-ofed-release*'
    sudo yum remove 'oracle-rdma-release*'
    sudo yum remove 'oracle-rdma-tools'
    sudo yum remove 'perftest*'
    sudo yum remove 'qperf*'
    sudo yum remove 'rdma*'
    sudo yum remove 'rds-tools*'
    sudo yum remove 'sdpnetstat*'
  3. Clean all yum cached files from all enabled repositories:

    sudo yum clean all
  4. Install the RDMA packages for UEK R6.

    • On Oracle Linux 7, run the following commands:

      sudo yum install rdma-core
      sudo yum install infiniband-diags
      sudo yum install libibverbs-utils
      sudo yum install librdmacm-utils
      sudo yum install mstflint
      sudo yum install oracle-rdma-tools
      sudo yum install rds-tools
      sudo yum install ibutils
      sudo yum install libibacl
      • If installing on a bare-metal system, install the infiniband-diags package:
        sudo yum install infiniband-diags
      • If installing on a guest VM, install the infiniband-diags-guest package:
        sudo yum install infiniband-diags-guest
    • On Oracle Linux 8, run the following commands:

      sudo dnf install rdma-core
      sudo dnf install libibverbs-utils
      sudo dnf install librdmacm-utils
      sudo dnf install mlnx-tools
      sudo dnf install mstflint
      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 yum install perftest
    • (Optional) If you require the qperf package, install the package by running:

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

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

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

      sudo yum 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 before UEK R6, remove the existing UEK R6-based RDMA packages before installing the correct packages for the new kernel.

Caution:

Downgrading UEK versions isn't advisable, except for testing purposes.