Chapter 4 Upgrading an Oracle Linux System

Typically, you upgrade an Oracle Linux system by performing a fresh installation. However, starting with Oracle Linux 7, there is support for in-place upgrades. This chapter describes the conditions and method for performing an in-place upgrade.

4.1 Conditions for Performing an In-Place Upgrade

In-place upgrades are supported for systems that run Oracle Linux 6 Update 5 or later only. The following conditions must also be met:

  • The system to be upgraded must meet the minimum installation requirements for Oracle Linux 7, see Section 1.1, “System Requirements”.

  • The Oracle Linux 6 system has been completely updated from the ol6_x86_64_latest channel or the ol6_latest repository.

  • Either the Unbreakable Enterprise Kernel Release 3 (UEK R3) or the Unbreakable Enterprise Kernel Release 4 (UEK R4) release must be installed on the system and it must be the default boot kernel. Upgrading from Unbreakable Enterprise Kernel Release 2 is not supported.

  • The Oracle Linux 6 system must have been installed with the Minimal set of software.

  • No Oracle product stack is present on the system.

If the RHCK is installed, it is upgraded as part of the process, but it must not be set as the default boot kernel.

If the system to be upgraded contains valuable data, make a backup or snapshot of the system so that you can recover it to its previous state if the upgrade fails.

Before you upgrade, check the release notes for any known issues with upgrades. See Oracle® Linux 7 Documentation and Unbreakable Enterprise Kernel Documentation libraries.

To perform an in-place upgrade you must install some additional packages and their dependencies. The system should have access to the Unbreakable Linux Network (ULN), Oracle Linux yum server, or a local yum server.

4.2 Performing an In-Place Upgrade

  1. If the system is registered with ULN, make sure that it is subscribed to the ol6_x86_64_latest and ol6_x86_64_addons channels.

    If the system is using the Oracle Linux yum server or a local mirror, make sure that the ol6_latest and ol6_addons repositories are enabled.

  2. Use the yum update command to update the system to the latest Oracle Linux 6 release.

  3. Install the latest versions of the following required packages:

    • openscap

    • preupgrade-assistant

    • preupgrade-assistant-el6toel7

    • preupgrade-assistant-el6toel7-data

    • preupgrade-assistant-ui

    • preupgrade-assistant-tools

    • redhat-upgrade-tool

    For example:

    # yum install redhat-upgrade-tool preupgrade-assistant \
      preupgrade-assistant-el6toel7 preupgrade-assistant-el6toel7-data-0 \
      preupgrade-assistant-tools preupgrade-assistant-ui openscap
  4. If the system is registered with ULN, delete the system from ULN and disable yum plugins.

    You can only delete a system if it is registered to your user name on ULN.

    1. Log in to with your ULN user name and password.

    2. On the Systems tab, click the link for the system in the list of registered machines.

    3. On the System Details page, click Delete.

    4. When prompted to confirm the deletion, click OK.

    5. On the system, edit the yum configuration file /etc/yum.conf file and disable yum plugins by setting plugins=0.

  5. Run the preupg command to perform an upgrade assessment:

    # preupg
  6. Examine the upgrade assessment results file /root/preupgrade/result.html.

    If the assessment reports any fail, needs_action, or needs_inspection issues, read the remediation instructions for these issues and perform any required actions before proceeding with the upgrade.

    You might also need to perform some actions after performing the upgrade.

    You can run the preupg command as often as you like to check the system's readiness for upgrading. A backup of each assessment is stored in the /root/preupgrade-results directory. You might want to back up this directory before performing the upgrade.

    The /root/preupgrade directory (and its contents) must be present for the upgrade to proceed.

  7. Run the redhat-upgrade-tool-cli command to perform the upgrade.

    For example, to upgrade using an Oracle Linux 7 installation ISO, you might use the following command:

    # redhat-upgrade-tool-cli --iso=OL7_ISO \
    --debuglog=/tmp/upgrade.log --cleanup-post

    Substitute OL7_ISO with the path to the installation ISO. Alternately, use the --device option to point to a burned media copy of the installation ISO. For example:

    # redhat-upgrade-tool-cli --device=/dev/cdrom \
    --debuglog=/tmp/upgrade.log --cleanup-post

    Substitute /dev/cdrom with the device where the installation media is accessible.

    If you wish to use a network-based resource to perform the upgrade, you can use the --network option in conjunction with the --instrepo to specify the URL where the ISO contents are located. For example:

    # redhat-upgrade-tool-cli --network=7.5 --instrepo=OL7_repo_url \
    --debuglog=/tmp/upgrade.log --cleanup-post

    Substitute OL7_repo_url with the URL where the installation media is accessible. Note that an installation repository must contain a .treeinfo file that provides metadata for the installation. Currently, you cannot use the standard yum repositories exposed on the Oracle Linux yum server directly. If you wish to install from a network resource, you can copy the contents of an installation ISO to a locally hosted web server.

    The --cleanup-post option ensures that there are no Oracle Linux 6 packages remaining on the system after the upgrade. If you do not use this option, check the system after the upgrade and manually remove any Oracle Linux 6 packages, for example, by using the yum remove `rpm -qa | grep el6`.

    For more information, use the --help option with the redhat-upgrade-tool-cli command.

    If you require use of a proxy server to access a network resource where your installation repository is located, set the appropriate command line variables before running the command. For example:

    # export http_proxy="http://USER:PASSWORD@PROXY_SERVER:PORT"
  8. Reboot the system to start the upgrade.

    After the reboot, the upgrade tool installs the required packages, reconfigures the system, and then reboots. Depending on the number of packages, this may take some time.

    After the upgrade completes, perform any post-upgrade actions identified by the upgrade assessment.

  9. If the system was previously registered with ULN, check that yum plugins are enabled and re-register the system with ULN.

    1. On the system, edit the yum configuration file /etc/yum.conf file and enable yum plugins by setting plugins=1.

    2. Run the uln_register command.

      # uln_register

      Alternatively, if you use the GNOME graphical user desktop, select Applications, System Tools, and then ULN Registration.

    3. When prompted, enter your ULN user name, password, and customer support identifier (CSI).