The following procedure describes how to upgrade to the latest UEK R5 Oracle-supported RDMA packages from the OFED release. The instructions describe how to remove the oracle-ofed-release packages and then install the Oracle-supported RDMA packages.

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

   • If the 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.

   • To install the packages from the Oracle Linux yum server, enable the required repositories and ensure the system is using the modular yum repository configuration. If the system isn't using the modular yum repository configuration, install the oraclelinux-release-el7 package and run the /usr/bin/ol_yum_configure.sh script:

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

     Enable the ol7_latest, ol7_UEKR5, and ol7_UEKR5_RDMA repositories:

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

     If you don't intend to use this kernel, you can optionally disable the ol7_UEKR4 repository.

     Note:

     The RDMA packages that are installed from the ol7_UEKR5_RDMA repository aren't compatible with other UEK releases.

     See Oracle Linux 7: Administrator's Guide for more information.

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

   sudo systemctl stop rdma.service
   sudo systemctl disable rdma.service            

3. Remove any existing OFED packages:

   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 'mstflint*'
   sudo yum remove 'ofed-docs*'
   sudo yum remove 'ofed-scripts*'
   sudo yum remove 'opensm*'
   sudo yum remove 'oracle-ofed-release*'
   sudo yum remove 'perftest*'
   sudo yum remove 'qperf*'
   sudo yum remove 'sdpnetstat*'
   sudo yum remove 'rdma*'
   sudo yum remove 'rds-tools*'

4. Clean all yum cached files from all enabled repositories:

   sudo yum clean all           

5. Install the RDMA packages for UEK R5.

   • 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

   • (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

Each UEK release requires a different set of RDMA packages. If you change the kernel on the 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.