Installing the Oracle-Supported OFED Packages

The following procedure describes how to install the OFED packages that are provided by Oracle, including how to remove any existing OFED packages.

Note:

For any additional preparation that is required prior to installing or upgrading OFED packages, refer to the release notes for the Oracle Linux release that you are running.

To install the OFED packages that are provided by Oracle:

If your system is registered with ULN, subscribe the system to the ol6_x86_64_UEKR4_OFED or ol7_x86_64_UEKR4_OFED channel on ULN as appropriate.

By default, the ol7_x86_64_UEKR4 and ol7_x86_64_latest channels are enabled when you register an Oracle Linux 7 system with ULN; and the ol6_x86_64_UEKR4 and ol6_x86_64_latest channels are enabled when you register an Oracle Linux 6 system with ULN. Check that these channels are still enabled before you begin installing the OFED packages provided by Oracle. If enabled, disable the ol6_x86_64_optional latest or ol7_x86_64_latest channel, or you may encounter dependency issues.

If your system uses the Oracle Linux yum server ensure that your system is up to date and that you have transitioned to use the modular yum repository configuration by installing the oraclelinux-release-el6 or oraclelinux-release-el7 package and running the /usr/bin/ol_yum_configure.sh script. For example, run the following as root:
```
# yum install oraclelinux-release-el7
                        
# /usr/bin/ol_yum_configure.sh
```
Then use yum-config-manager to enable the ol7_UEKR4_OFED repository for Oracle Linux 7 or the ol6_UEKR4_OFED repository for Oracle Linux 6. By default, ol7_latest and ol7_UEKR4 are already enabled on Oracle Linux 7 and the ol6_latest and ol6_UEKR4 are already enabled on Oracle Linux 6. If these repositories are not enabled on your system, you should enable these as well. For example as root, run:
```
# yum-config-manager --enable ol7_latest ol7_UEKR4 ol7_UEKR4_OFED
```
Use yum-config-manager to disable the ol7_optional_latest or ol6_optional_latest repository or you may encounter dependency issues if this repository is enabled. For exampe:
```
# yum-config-manager --disable ol7_optional_latest
```
If you are running Oracle Linux 7, stop and disable the rdma.service service.
```
# systemctl stop rdma.service
# systemctl disable rdma.service
```

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

Clean all yum cached files from all enabled repositories:
```
# yum clean all
```
Run one of the following commands, based on server type:
- For a bare metal server, install the OFED packages for UEK R4 as follows:
```
# yum install oracle-ofed-release
```
- For a server that will function as a guest, install the OFED packages for UEK R4 as follows:
```
# yum install oracle-ofed-release-guest
```
Enable the RDMA service by entering the following command:
```
# chkconfig rdma on
```

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

# yum remove --setopt=clean_requirements_on_remove=1 oracle-ofed-release

Caution:

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

To update OFED packages that are already installed for UEK R4, run this command:

# yum update oracle-ofed-release

To update the OFED packages that are already installed on the guest, run this command on the guest:

# yum update oracle-ofed-release-guest