Installing Oracle-Supported RDMA Packages

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.

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.

Stop and then disable the rdma.service service:

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

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*'

Clean all yum cached files from all enabled repositories:
```
sudo yum clean all           
```
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.

Caution:

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

Upgrading Oracle-Supported RDMA Packages for x86_64 platforms

Typical upgrade of Oracle-supported RDMA packages can be achieved using the yum update command.

If you're upgrading a system where the oracle-rdma-release or oracle-rdma-release-guest package is installed and the package version is lower than version 0.18.1-1 and you intend to upgrade to version 0.18.1-1 or above, you must first manually remove the rdma-core-devel package before performing the upgrade. Remove this package using the rpm -e --nodeps command to remove the package outside of the standard yum or dnf package manager control and leaving any dependencies intact, for example:

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

If you're upgrading an older system where the oracle-ofed-release or oracle-ofed-release-guest package is installed and you intend to upgrade to oracle-rdma-release or oracle-rdma-release-guest version 0.18.1-1 or above, you must manually remove development packages that were installed for OFED before performing the upgrade or installation of the oracle-rdma-release or oracle-rdma-release-guest package:

sudo /bin/rpm -e --nodeps libibumad-devel libibverbs-devel librdmacm-devel libibmad-devel
sudo yum install oracle-rdma-release-guest

Note that these steps are only required for the transition from versions of the oracle-rdma-release and oracle-rdma-release-guest packages prior to 0.18.1-1 to version 0.18.1-1 or later; or for the transition from oracle-ofed-release to oracle-rdma-release version 0.18.1-1 or later. These steps aren't required for upgrades after the packages are at version 0.18.1-1 or later.

If the system you have upgraded has the oracle-rdma-release or oracle-rdma-release-guest package installed and if the package version is version 0.31.0-1, then you can remove it because that package no longer serves any purpose:

sudo yum remove oracle-rdma-release*