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.

      By default, the ol7_x86_64_UEKR5 and ol7_x86_64_latest channels are enabled when you register an Oracle Linux 7 system with ULN.

    • If you want to install the packages from the Oracle Linux yum server, check that the yum repository file at /etc/yum.repos.d/public-yum-ol7.repo is current or contains and entry for the ol7_UEKR5_RDMA repository.

      If there is no ol7_UEKR5_RDMA repository in the yum repository file you can download an up-to-date version of this file from https://yum.oracle.com/public-yum-ol7.repo, if required. For example, you can run:

      # mv /etc/yum.repos.d/public-yum-ol7.repo /etc/yum.repos.d/public-yum-ol7.repo.bck
      # wget https://yum.oracle.com/public-yum-ol7.repo -o /etc/yum.repos.d/public-yum-ol7.repo

      Enable the ol7_latest, ol7_UEKR5 and ol7_UEKR5_RDMA repositories:

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

      Alternately, edit the /etc/yum.repos.d/public-yum-ol7.repo file to set the enabled option to 1 for the required repositories.

      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.

  2. 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*'
  3. Clean all yum cached files from all enabled repositories:

    # yum clean all
  4. 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.