4 Installation and Availability
You can install Unbreakable Enterprise Kernel Release 5 on Oracle Linux 7.5 or later, if you are running either RHCK or a previous Unbreakable Enterprise Kernel release. If you are currently running an earlier Oracle Linux release, you must first update your system to the latest available update release.
Unbreakable Enterprise Kernel Release 5 is supported on the x86_64 architecture, but not on x86. The Unbreakable Enterprise Kernel Release 5 is also supported on the 64-bit Arm (aarch64) architecture.
Installation Overview
If you have a subscription to Oracle Unbreakable Linux support, you can obtain the packages for Unbreakable Enterprise Kernel Release 5 by registering your system with the Unbreakable Linux Network (ULN) and then subscribing it to additional channels. See Subscribing to ULN Channels.
If your system is not registered with ULN, you can obtain most of the packages from the Oracle Linux yum server. See Enabling Access to Oracle Linux Yum Server Repositories.
Having subscribed your system to the appropriate channels on ULN or Oracle Linux yum server, upgrade your system. See Upgrading Your System.
Subscribing to ULN Channels
ULN channel requirements differ depending on the platform architecture that you are using.
For Oracle Linux 7 on the 64-bit Arm (aarch64) platform, no RHCK is available and UEK R5 is used by default. Your system must be subscribed to:
-
ol7_aarch64_latest
(latest user space packages for Oracle Linux 7)
For Oracle Linux 7 on the x86 platform, the kernel image and user space packages are available on the following ULN channels:
-
ol7_x86_64_latest
(latest user space packages for Oracle Linux 7) -
ol7_x86_64_UEKR5
(kernel-uek*
,dtrace-utils*
,ndctl-*
,btrfs-progs-*
andxfsprogs-*
)
The following procedure assumes that you have already registered your system with ULN.
To subscribe your system to a channel on ULN:
-
Log in to https://linux.oracle.com with your ULN user name and password.
-
On the Systems tab, click the link named for the system in the list of registered machines.
-
On the System Details page, click Manage Subscriptions.
-
On the System Summary page, select each required channel from the list of available channels and click the right arrow to move the channel to the list of subscribed channels.
Subscribe the system to the appropriate channels for your platform architecture.
-
Click Save Subscriptions.
For information about using ULN, see Oracle Linux: Unbreakable Linux Network User's Guide for Oracle Linux 6 and Oracle Linux 7.
Enabling Access to Oracle Linux Yum Server Repositories
Packages are also available on the Oracle Linux yum server repository at https://yum.oracle.com/.
Yum repository requirements differ depending on the platform architecture that you are using.
For Oracle Linux 7 on the 64-bit Arm (aarch64) platform, no RHCK is available and UEK R5 is used by default. Your system must have the following repository enabled:
-
ol7_latest
(latest user space packages for Oracle Linux 7)
For Oracle Linux 7 on the x86 platform, the kernel image and user space packages are available on the following repositories:
-
ol7_latest
(latest user space packages for Oracle Linux 7 other than the RDMA tool packages) -
ol7_UEKR5
(kernel-uek*
,dtrace-utils*
,ndctl-*
,btrfs-progs-*
andxfsprogs-*
)
To enable access to the Oracle Linux 7 repositories on the Oracle Linux yum server, use
yum-config-manager. For example, to enable
access to the ol7_latest
and
ol7_UEKR5
repositories, run the following
command:
# yum-config-manager --enable ol7_latest,ol7_UEKR5
Note:
You can only use yum-config-manager to
enable or disable repositories after you already have a
configuration file for the specified repository. Repository
configurations are typically stored in
/etc/yum.repos.d
. The repository
configurations that are required to install UEK on Oracle Linux 7 are
included in the oraclelinux-release-el7
package.
Upgrading Your System
To upgrade your system to Unbreakable Enterprise Kernel Release 5:
-
After enabling access to the appropriate ULN channels or repositories on the Oracle Linux yum server, run the following command, which upgrades the system to UEK R5:
# yum update
-
After upgrading the system, reboot it, selecting the UEK R5 kernel (version 4.14.35) if it is not the default boot kernel.
If you have questions regarding configuring or using the yum command to install updates, refer to Oracle Linux: Unbreakable Linux Network User's Guide for Oracle Linux 6 and Oracle Linux 7.
The kernel's source code is available through a public git source code repository at https://github.com/oracle/linux-uek.
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
, andol7_x86_64_latest
channels on ULN.By default, the
ol7_x86_64_UEKR5
andol7_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
, andol7_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.
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*