Complete the steps as applicable to prepare for an upgrade from Oracle Linux 9 to Oracle Linux 10.

1. Set up a means to connect remotely through a console.

   This document assumes that you're performing a Leapp upgrade remotely. In this case, a console is necessary so you can monitor the progress of the upgrade process, especially as the upgrade performs automatic reboots.

   The following list shows console connection options you can use:

   • Oracle Linux server: Use Oracle Integrated Lights Out Manager (ILOM). See https://docs.oracle.com/en/servers/management/ilom/index.html.

   • Oracle Private Cloud Appliance: Use the Instance Console Connection. See https://docs.oracle.com/en/engineered-systems/private-cloud-appliance/index.html.

   • Oracle Linux Virtualization Manager or Oracle Linux Kernel based Virtual Machines (KVM): User virt-viewer, virt-manager, or Cockpit Web Console. See Oracle Linux Virtualization Manager documentation.

   Note:

   If you connect to the system by using SSH or by using VNC to a VNC service running on the system, you're disconnected during the upgrade process and are unable to log in until the upgrade is completed.

2. Perform a backup.

   Always back up a system so that the system can be restored to its former state if the upgrade fails.

3. Shut down all production workloads that have been set up to run on the system, as the upgrade is intrusive and requires several reboots.

4. If the system has network mounted file systems, unmount them, and then insert related entries in the /etc/fstab file inside comment marks.

   See File Systems and Storage Issues.

5. If the system is behind a proxy, configure the proxy settings in /etc/dnf/dnf.conf, for example:

   proxy=proxy-url:port

   See Oracle Linux: Managing Software on Oracle Linux.

6. If you installed the package, clear any packages with locked versions.

7. Obtain the latest Oracle Linux 9 packages.

   sudo dnf update -y

8. If the system is registered with ULN or a ULN mirror, unregister the system.

   See the following documentation for this step.

   • Removing a System From ULN in Oracle Linux: Managing Software on Oracle Linux

   • Checking Yum Configuration in https://yum.oracle.com/getting-started.html#checking-yum-configuration.

9. Reboot the system.

   sudo reboot

10. Ensure that the appstream and baseos_latest repositories are enabled.

    dnf repolist

11. Install the Leapp utility using the following command:

    sudo dnf install -y leapp-upgrade