4.5 Installing Oracle-Supported RDMA Packages

The following procedure describes how to upgrade from the OFED release to the RDMA release. The instructions describe how to remove the oracle-ofed-release packages and then install the oracle-rdma-release packages.

  1. Subscribe your system to the appropriate ULN channels or enable the appropriate yum repositories:

    • If your system is registered with ULN, subscribe the system to the ol7_x86_64_UEKR5_RDMA, ol7_x86_64_UEKR5, and ol7_x86_64_latest channels on ULN.

    • If you want to install the packages from the Oracle Linux yum server, enable the required repositories and make sure your system is using the modular yum repository configuration. If your system is not using the modular yum repository configuration, install the oraclelinux-release-el7 package and run the /usr/bin/ol_yum_configure.sh script.

      # yum install oraclelinux-release-el7
      # /usr/bin/ol_yum_configure.sh

      Enable the ol7_latest, ol7_UEKR5 and ol7_UEKR5_RDMA repositories:

      # yum-config-manager --enable ol7_latest ol7_UEKR5 ol7_UEKR5_RDMA

      You can optionally disable the ol7_UEKR4 repository if you do not intend to use this kernel. Note that the RDMA packages installed from the ol7_UEKR5_RDMA repository are not compatible with other UEK releases.

      See https://docs.oracle.com/en/operating-systems/oracle-linux/7/admin/ol7_yum.html in Oracle® Linux 7: Administrator's Guide for more information.

  2. Stop and then disable the rdma.service service.

    # systemctl stop rdma.service
    # systemctl disable rdma.service
  3. Remove any existing OFED packages.

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

    # yum clean all
  5. Install the RDMA packages for UEK R5 by running the following command:

    # yum install oracle-rdma-release

Each UEK release requires a different set of RDMA packages. If you change the kernel on your system to a UEK release before UEK R5, remove the existing UEK R5-based RDMA packages before installing the correct packages for the new kernel by running the following command:

# yum remove --setopt=clean_requirements_on_remove=1 oracle-rdma-release
Caution

Downgrading UEK versions is not advisable, except for testing purposes.