Installation and Availability

4 Installation and Availability

WARNING:

Oracle Linux 7 is now in Extended Support. See Oracle Linux Extended Support and Oracle Open Source Support Policies for more information.

Migrate applications and data to Oracle Linux 8 or Oracle Linux 9 as soon as possible.

You can download a full Oracle Linux 7 Update 3 installation media image from the Oracle Software Delivery Cloud at https://edelivery.oracle.com/linux. You can also obtain the latest Oracle Linux 7 packages from the Unbreakable Linux Network (ULN) and the Oracle Linux yum server.

You can install additional software for Oracle Linux 7 by subscribing to the different channels on ULN or by enabling the required repositories within the Oracle Linux yum server configuration. To explore the channels that are available to you on ULN, login to https://uln.oracle.com/ and view the Channels option. To view the Oracle Linux yum server repositories available for Oracle Linux 7, visit https://yum.oracle.com/oracle-linux-7.html.

Note:

Oracle Linux yum server does not provide equivalent repositories for some channels that are available on ULN. These channels provide non-open source packages.

If you are installing the update on a system on which you have previously installed the Oracle-supported OFED packages, see the following sections for instructions on how to update these packages during the upgrade:

Installing Oracle Linux 7 Update 3 from ULN if the Oracle-Supported OFED Packages Are Already Installed for instructions on how to install the update from ULN.
Installing Oracle Linux 7 Update 3 from Oracle Linux Yum Server if the Oracle-Supported OFED Packages Are Already Installed for instructions on how to install the update from Oracle Linux yum server.

UEK R4 Update 2 is the default boot kernel for fresh installations of Oracle Linux 7 but the UEK R3 kernel remains available if you need to continue to use this. For more information, see Unbreakable Enterprise Kernel: Release Notes for Unbreakable Enterprise Kernel Release 4 Update 2 (4.1.12-61).

For systems that are running UEK R3 or UEK R4 and are subscribed to the ol7_x86_64_UEKR3 or ol7_x86_64_UEKR4 channel on ULN, or the ol7_x86_64_UEKR3 or ol7_x86_64_UEKR4 repository on Oracle Yum Server, upgrade to the latest UEK release as follows:

Upgrade all packages on the system, including kernel packages.
```
sudo yum update
```
By default, the boot manager automatically enables the most recent kernel version so you do not need to change your GRUB configuration.
Reboot the system.
```
sudo systemctl reboot
```

Important:

Oracle Linux 7 Update 3 updates many major subsystems. To ensure that your updated systems function correctly, reboot them after updating.

Upgrading from Oracle Linux 6

It is possible to upgrade an Oracle Linux 6 system to Oracle Linux 7 Update 3 under the following conditions:

The system meets the minimum installation requirements for Oracle Linux 7 as described in System Requirements and Limits.
The Oracle Linux 6 system has been completely updated from the ol6_x86_64_latest channel or ol6_latest repository.
UEK R3 or UEK R4 has been installed on the system to be upgraded and is the default boot kernel. Upgrading from UEK R2 is not supported.
No Oracle product stack is present on the system.

Upgrading is supported only for systems that are installed with the Minimal Install base environment. If additional packages are installed from an alternative repository or channel, upgrade may fail or the resulting upgrade may not function as expected.

General instructions on how to perform an upgrade are covered in Oracle Linux 7: Installation Guide. A summary of steps specific to the update for this release is provided below:

Make sure that your system is completely up to date by using the yum update command to update to the latest Oracle Linux 6 release. The system must be subscribed to the ol6_x86_64_latest channel or ol6_latest repository to be updated.

Install the required upgrade packages (specified version or later) :

redhat-upgrade-tool-0.7.47-1.0.1.el6.noarch.rpm 
preupgrade-assistant-el6toel7-0.6.59-5.0.1.el6.noarch.rpm 
preupgrade-assistant-el6toel7-data-0.20161013-1.el6.noarch.rpm 
preupgrade-assistant-2.1.10-6.0.1.el6.noarch.rpm 
preupgrade-assistant-tools-2.1.10-6.0.1.el6.noarch.rpm 
preupgrade-assistant-ui-2.1.10-6.0.1.el6.noarch.rpm

Obtain the latest versions of these packages from ULN (in the ol6_x86_64_addons channel), or from Oracle Linux yum server (in the ol6_addons repository).

Run the preupg command to perform and upgrade assessment:
```
sudo preupg
```
Examine the results in /root/preupgrade/result.html to make sure that there are not any items that have failed or need attention.
Run the redhat-upgrade-tool-cli command to perform the upgrade:
```
sudo redhat-upgrade-tool-cli --network=7.3 --instrepo=OL7_repo_url \
--debuglog=/tmp/upgrade.log --cleanup-post
```
Replace OL7_repo_url with the URL of the repository where the Oracle Linux 7 update 2 packages are hosted.
Reboot the system to start the upgrade process.

Installing or Upgrading the Oracle-Supported OFED Packages

The following sections describe how to install or upgrade the OFED packages provided by Oracle, including how to replace the default OFED packages from Red Hat that are present on a system that you have upgraded to Oracle Linux 7 or that you have installed from the Oracle Linux 7 full installation DVD image, the ol7_x86_64_latest channel on ULN, or the ol7_latest repository on Oracle Linux yum server.

(Bug ID 19177152)

Installation or Upgrade of Oracle-Supported OFED Packages for UEK R4

For instructions for installing or upgrading OFED packages with UEK R4 u2, see Unbreakable Enterprise Kernel: Release Notes for Unbreakable Enterprise Kernel Release 4 Update 2 (4.1.12-61). This is the default kernel.

Installation or Upgrade of Oracle-Supported OFED Packages for UEK R3

The following sections describe different procedures for installing or upgrading OFED packages with UEK R3.

Installing Oracle Linux 7 Update 3 from ULN if the Oracle-Supported OFED Packages Are Already Installed

Note:

This procedure assumes that you have registered the system with ULN. See Oracle Linux: Unbreakable Linux Network User's Guide for Oracle Linux 6 and Oracle Linux 7.

To install Update 3 from ULN on an Oracle Linux 7 system on which the Oracle-supported OFED packages are already present:

Subscribe the system to the ol7_x86_64_optional_latest, ol7_x86_64_UEKR3_OFED20, ol7_x86_64_UEKR3, and ol7_x86_64_latest channels on ULN. (By default, the ol7_x86_64_UEKR3 and ol7_x86_64_latest channels are enabled when you register an Oracle Linux 7 system with ULN.)
Edit /etc/yum/pluginconf.d/rhnplugin.conf and add the following lines to the end of the file:
```
[ol7_x86_64_UEKR3_OFED20]
priority=20 
```
Install the yum-plugin-priorities package from the ol7_x86_64_optional_latest channel:
```
# yum install yum-plugin-priorities
```
To apply Oracle Linux 7 Update 3 to the system:
```
# yum update
```
Any Oracle-supported OFED packages that were already present are updated from the ol7_x86_64_UEKR3_OFED20 channel.
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_x86_64_UEKR3_OFED20 channel as required, for example:
```
# yum install ibutils
```

Installing Oracle Linux 7 Update 3 from Oracle Linux Yum Server if the Oracle-Supported OFED Packages Are Already Installed

To install Update 3 from Oracle Linux yum server on an Oracle Linux 7 system on which the Oracle-supported OFED packages are already present:

If you updated the server from Oracle Linux 6 or the initial release of Oracle Linux 7, 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-el7 package and running the /usr/bin/ol_yum_configure.sh script.
```
# yum install oraclelinux-release-el7
# /usr/bin/ol_yum_configure.sh
```

Enable the ol7_latest,ol7_optional_latest, ol7_UEKR3 and ol7_UEKR3_OFED20 repositories.

# yum-config-manager --enable ol7_latest ol7_UEKR3 ol7_optional_latest ol7_UEKR3_OFED20

Install the yum-plugin-priorities package from the ol7_optional_latest repository:
```
# yum install yum-plugin-priorities
```
To apply Oracle Linux 7 Update 3 to the system:
```
# yum update
```
Any Oracle-supported OFED packages that were already present are updated from the ol7_UEKR3_OFED20 repository.
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_UEKR3_OFED20 repository as required, for example:
```
# yum install ibutils
```

Installing the Oracle-Supported OFED Packages from ULN if the Default OFED Packages Are Not Already Installed

Note:

This procedure assumes that you have registered the system with ULN. See Oracle Linux: Unbreakable Linux Network User's Guide for Oracle Linux 6 and Oracle Linux 7.

To install the Oracle-supported OFED packages from ULN on a minimally installed Oracle Linux 7 system on which the default OFED packages have not been installed:

Subscribe the system to the ol7_x86_64_optional_latest, ol7_x86_64_UEKR3_OFED20, ol7_x86_64_UEKR3, and ol7_x86_64_latest channels on ULN. (By default, the ol7_x86_64_UEKR3 and ol7_x86_64_latest channels are enabled when you register an Oracle Linux 7 system with ULN.)
Edit /etc/yum/pluginconf.d/rhnplugin.conf and add the following lines to the end of the file:
```
[ol7_x86_64_UEKR3_OFED20]
priority=20 
```
Install the yum-plugin-priorities package from the ol7_x86_64_optional_latest channel:
```
# yum install yum-plugin-priorities
```
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_x86_64_UEKR3_OFED20 channel as required, for example:
```
# yum install ibutils
```

Installing the Oracle-Supported OFED Packages from Oracle Linux Yum Server if the Default OFED Packages Are Not Already Installed

To install the Oracle-supported OFED packages from Oracle Linux yum server on a minimally installed Oracle Linux 7 system on which the default OFED packages have not been installed:

If you updated the server from Oracle Linux 6 or the initial release of Oracle Linux 7, 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-el7 package and running the /usr/bin/ol_yum_configure.sh script.
```
# yum install oraclelinux-release-el7
# /usr/bin/ol_yum_configure.sh
```

Enable the ol7_latest,ol7_optional_latest, ol7_UEKR3 and ol7_UEKR3_OFED20 repositories.

# yum-config-manager --enable ol7_latest ol7_UEKR3 ol7_optional_latest ol7_UEKR3_OFED20

Install the yum-plugin-priorities package from the ol7_optional_latest repository:
```
# yum install yum-plugin-priorities
```
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_UEKR3_OFED20 repository as required, for example:
```
# yum install ibutils
```

Installing the Oracle-Supported OFED Packages from ULN if the Default OFED Packages Are Already Present

Note:

This procedure assumes that you have registered the system with ULN. See Oracle Linux: Unbreakable Linux Network User's Guide for Oracle Linux 6 and Oracle Linux 7.

To install the Oracle-supported OFED packages from ULN if the default OFED packages have already been installed on an Oracle Linux 7 system:

Subscribe the system to the ol7_x86_64_optional_latest, ol7_x86_64_UEKR3_OFED20, ol7_x86_64_UEKR3, and ol7_x86_64_latest channels on ULN. (By default, the ol7_x86_64_UEKR3 and ol7_x86_64_latest channels are enabled when you register an Oracle Linux 7 system with ULN.)
Edit /etc/yum/pluginconf.d/rhnplugin.conf and add the following lines to the end of the file:
```
[ol7_x86_64_UEKR3_OFED20]
priority=20 
```
Install the yum-plugin-priorities package from the ol7_x86_64_optional_latest channel:
```
# yum install yum-plugin-priorities
```
Downgrade any default OFED packages other than ibutils, libibcm, librdmacm, librdmacm-devel, librdmacm-utils, opensm, opensm-libs, and srptools that are already present on the system, for example:
```
# yum downgrade rdma
```
These packages are replaced with the Oracle-supported OFED packages from the ol7_x86_64_UEKR3_OFED20 channel.
Remove the default ibutils-libs package (if present):
```
# yum remove ibutils-libs
```
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_x86_64_UEKR3_OFED20 channel as required, for example:
```
# yum install ibutils
```

Installing the Oracle-Supported OFED packages from Oracle Linux Yum Server if the Default OFED Packages Are Already Present

To install the Oracle-supported OFED packages from Oracle Linux yum server if the default OFED packages have already been installed on an Oracle Linux 7 system:

If you updated the server from Oracle Linux 6 or the initial release of Oracle Linux 7, 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-el7 package and running the /usr/bin/ol_yum_configure.sh script.
```
# yum install oraclelinux-release-el7
# /usr/bin/ol_yum_configure.sh
```

Enable the ol7_latest, ol7_optional_latest, ol7_UEKR3 and ol7_UEKR3_OFED20 repositories:

# yum-config-manager --enable ol7_latest ol7_UEKR3 ol7_optional_latest ol7_UEKR3_OFED20

Install the yum-plugin-priorities package from the ol7_optional_latest repository:
```
# yum install yum-plugin-priorities
```
Downgrade any default OFED packages other than ibutils, libibcm, librdmacm, librdmacm-devel, librdmacm-utils, opensm, opensm-libs, and srptools that are already present on the system, for example:
```
# yum downgrade rdma
```
These packages are replaced with the Oracle-supported OFED packages from the ol7_UEKR3_OFED20 repository.
Remove the default ibutils-libs package (if present):
```
# yum remove ibutils-libs
```
Install Oracle-supported OFED packages such as ibutils, libibcm, librdmacm-devel, librdmacm-utils, librdmacm, opensm, opensm-libs, and srptools from the ol7_UEKR3_OFED20 repository as required, for example:
```
# yum install ibutils
```