1 About Leapp

The Leapp utility is a framework for updating and upgrading operating systems as well as applications. The utility's component packages enable the creation of different workflows into profiles for updating software.

Leapp operations consist of two phases:

  • The preupgrade phase, where system checks are performed to determine if the software can be upgraded.
  • The actual upgrade, which process is based on configuration files that map packages between previous and current versions of the software packages.

Caution:

Currently, the Leapp utility is used to upgrade the operating systems only, specifically, from the current Oracle Linux 7 release to the current Oracle Linux 8 version. The procedures in this document do not apply to and are unsupported on any other operating systems or versions.

Supported Leapp Features

The Leapp utility can be used to upgrade local or remote Oracle Linux 7 systems as well as instances on Oracle Cloud Infrastructure that are based on the Oracle Linux 7 image.

Upgrading Oracle Linux 7 Systems

For Oracle Linux systems, the following table lists supported and unsupported features by the Leapp utility.

Supported by Leapp Unsupported by Leapp
Platforms (latest shipping updates)
  • x86_64

  • Arm (aarch64)

Operating Systems

  • Current Oracle Linux 7 version only

Profiles

  • Minimal Install

  • Virtualization Host

  • Server with GUI

  • Basic Web Server

  • Infrastructure Server

  • File and Print Server

Systems installed with the following:

  • ISV applications, including Oracle Database and middleware

    Note:

    ISVs must provide and validate Leapp actors to coordinate their application upgrades.

  • Oracle Linux Manager or Spacewalk for Oracle Linux

  • Installations that did not use ISO images such as Ceph and GlusterFS

  • Migration of disks that are encrypted with LUKS

  • Systems that are registered with ULN

  • Systems in FIPS mode or running SecureBoot

  • Systems configured with Docker containers

Upgrading Oracle Linux 7 Oracle Cloud Infrastructure Instances

The Leapp utility also supports both the x86_64 and Arm (aarch64) platforms when upgrading Oracle Linux 7 instances on Oracle Cloud Infrastructure.

The following table lists additional supported and unsupported features.

Supported by Leapp Unsupported by Leapp

Images

  • Oracle Linux 7 Unbreakable Enterprise Kernel Release 6 Platform Image

See https://docs.oracle.com/iaas/Content/Compute/References/images.htm

Images
Shapes Shapes
  Features

Upgrading Oracle Linux 7 Systems That Use RDMA

The following table lists the scope of Leapp support for upgrading Oracle Linux 7 systems and instances that use Remote Direct Memory Access (RDMA) :

Supported by Leapp Unsupported by Leapp
  • Oracle Linux 7 with UEKR5 Oracle RDMA (requires a kernel upgrade to UEKR6 )

  • Oracle Linux 7 with UEKR6 Oracle RDMA

  • Oracle Linux 7 with UEKR3 OFED 2.0

  • Oracle Linux 7 with UEKR4 OFED

For details and instructions on obtaining newer versions of RDMA packages, see the latest UEK release notes at Unbreakable Enterprise Kernel documentation.

Upgrading Oracle Linux 7 KVM Hosts

The Leapp utility supports upgrading Oracle Linux 7 systems that host KVM virtual machines. Systems must fulfill the other Leapp criteria listed in the previous sections. The following table lists the scope of KVM host support.

Note:

The Oracle Linux KVM Image is not an Oracle Cloud Infrastructure platform image and not supported by Leapp.

Supported by Leapp Unsupported by Leapp
  • Upgrading the Oracle Linux 7 Latest KVM packages to the Oracle Linux 7 KVM AppStream

  • Upgrading the Oracle Linux 7 KVM Utilities to the Oracle Linux 7 KVM AppStream

  • Upgrading from the Oracle Linux 7 Latest packages to the Oracle Linux 8 KVM AppStream packages

  • Upgrading from the Oracle Linux 7 KVM Utilities to the Oracle Linux 8 AppStream packages

  • Upgrading KVM hosts while KVM virtual machines (guests) are running.

For repository mappings between preupgrade stage and postupgrade stage that involve KVM clients, see Supported Repositories in Leapp Upgrades.

Requirements for Upgrading

To upgrade an Oracle Linux 7 system or instance, ensure that either one meets the following requirements:

  • The minimum installation requirements as listed in System Requirements in Oracle Linux 8: Installing Oracle Linux are met.

  • Only packages provided by Oracle are installed. Upgrade stability is not guaranteed if third-party packages are present in the system.

  • Oracle Linux yum server at https://yum.oracle.com or an equivalent yum mirror is accessible.

    If accessing repositories from a mirror or a local repository, ensure that both Oracle Linux 7 and Oracle Linux 8 channels are mirrored.

  • x86_64 deployments are running Unbreakable Enterprise Kernel Release 5 or later versions or the Red Hat Compatible Kernel (RHCK).

  • aarch64 deployments are running the Unbreakable Enterprise Kernel Release 6.

Check the following references for information that might have an impact on the upgrade process:

Supported Kernel Upgrades

The following table provides guidance about which kernel upgrades are supported by the Leapp utility. The table assumes that the Oracle Linux 7 host satisfies the requirements listed in Requirements for Upgrading.

  Starting Kernel (Oracle Linux 7) Ending Kernel (Oracle Linux 8) Supported

x86_64 not using Btrfs file system

RHCK

RHCK

Yes1

 

RHCK

UEK

No

 

UEK

UEK

Yes

 

UEK

RHCK

No

x86_64 using Btrfs file system

RHCK

RHCK

No2

 

RHCK

UEK

Yes

 

UEK

UEK

Yes

 

UEK

RHCK

No2

aarch64

UEK

UEK

Yes3

1Unbreakable Enterprise Kernel Release 6 remains on the system or instance after the upgrade. If preferred, the administrator can safely remove this kernel.

2RHCK in Oracle Linux 8 does not support the Btrfs file system.

3RHCK is not distributed nor supported for the aarch64 platform.