Before You Begin

Before you begin the upgrade process:

  • Read the upgrade prerequisites that are common to both a standard environment and a self-hosted engine environment.
  • If applicable, read the additional prerequisites for a self-hosted engine environment.
  • Ensure your engine or self-hosted engine and KVM hosts are updated to the latest version of 4.4 before you begin the upgrade process. See Updating engine or self-hosted engine to latest version of 4.4 and Updating KVM hosts to the latest version of 4.4.
  • Do not upgrade your KVM hosts until after the engine or self-hosted engine upgrade is completed.
  • Upgrade all Oracle Linux 7 KVM hosts to Oracle Linux 8.
  • (ULN registered hosts only) Run the following commands on your engine and KVM hosts:
    echo "Disabling yum module virt:ol"
/usr/bin/dnf -y module disable virt:ol  > /dev/null

echo "Enabling yum module virt:kvm_utils3"
/usr/bin/dnf -y module enable virt:kvm_utils3  > /dev/null

echo "Enabling module pki-deps"
/usr/bin/dnf -y module enable pki-deps  > /dev/null

echo "Enabling module postgresql:13"
/usr/bin/dnf -y module enable postgresql:13  > /dev/null

echo "Enabling module nodejs:18"
/usr/bin/dnf -y module reset nodejs  > /dev/null
/usr/bin/dnf -y module enable nodejs:18  > /dev/null

echo "Exclude ansible-core updates from OL ol8_appstream"
/usr/bin/dnf -y config-manager --save --setopt="exclude=ansible-core"  > /dev/null

echo "Version lock gluster-ansible* packages"
/usr/bin/dnf install -y 'dnf-command(versionlock)' > /dev/null
/usr/bin/dnf versionlock gluster-ansible-cluster-1.0-2.1*  > /dev/null
/usr/bin/dnf versionlock gluster-ansible-features-1.0.5-9*  > /dev/null
/usr/bin/dnf versionlock gluster-ansible-infra-1.0.4-18*  > /dev/null
/usr/bin/dnf versionlock gluster-ansible-maintenance-1.0.1-10*  > /dev/null
/usr/bin/dnf versionlock gluster-ansible-repositories-1.0.1-3*  > /dev/null
/usr/bin/dnf versionlock gluster-ansible-roles-1.0.5-23*  > /dev/null

Prerequisites

Ensure the following prerequisites are met before beginning your upgrade:

  • The operating system for the engine host must be Oracle Linux 8.8 (or later Oracle Linux 8 release). If it is not, update the engine host to Oracle Linux 8.8 (or later Oracle Linux 8 release) before you upgrade to the engine to 4.5.

  • All data centers and clusters in the environment must have the cluster compatibility level set to version 4.6 or higher.

  • All virtual machines in the environment must have the same compatibility level as their cluster.

  • If you use an external CA to sign HTTPS certificates, follow the steps in Replacing the Oracle Linux Virtualization Manager Apache SSL Certificate. The backup and restore include the 3rd-party certificate, so you should be able to log in to the Administration portal after the upgrade. Ensure the CA certificate is added to system-wide trust stores of all clients to ensure the foreign menu of virt-viewer works.

  • Additionally, for self-hosted engine environments:
    • Make note of the MAC address of the self-hosted engine if you are using DHCP and want to use the same IP address. The deploy script prompts you for this information.
    • Set the cluster scheduling policy to cluster_maintenance in order to prevent automatic virtual machine migration during the upgrade.

Updating engine or self-hosted engine to latest version of 4.4

Before upgrading to 4.5, you must update the engine or self-hosted engine to the latest version of 4.4.

  1. (Self-hosted engine only) Migrate virtual machines and enable global maintenance mode.

    • Migrate all other virtual machines off the host that contains the self-hosted engine virtual machine. Move the virtual machines to another host within the same cluster. During the upgrade, the host can only contain the self-hosted engine virtual machine (no other virtual machines can be on the host). Use Live Migration to minimize virtual machine down-time. See Migrating Virtual Machines between Hosts.

    • Enable global maintenance mode:
      1. Log in to the KVM host where the self-hosted engine is running or any KVM host configured to run the self-hosted engine.
      2. Enable global maintenance mode:
        # hosted-engine --set-maintenance --mode=global
      3. Confirm that the environment is in global maintenance mode before proceeding:
        # hosted-engine --vm-status
      4. You should see the following message:
        !! Cluster is in GLOBAL MAINTENANCE mode !!
  2. On the engine or self-hosted engine machine, update to the latest Oracle Linux Virtualization Manager Release 4.4 package. 
    # dnf update oracle-ovirt-release-el8
  3. Check for updated packages:
    # engine-upgrade-check
  4. Update the setup packages:
    # dnf update ovirt\*setup\*
  5. Update the engine or self-hosted engine:
    # engine-setup

    Important:

    The update process might take some time. Do not stop the process before it completes.

    The engine-setup script:

    • Prompts you with some configuration questions

      For more information, see Engine Configuration Options in the Oracle Linux Virtualization Manager: Getting Started.

    • Stops the ovirt-engine service.

    • Downloads and installs the updated packages.

    • Backs up and updates the database.

    • Performs post-installation configuration.

    • Starts the ovirt-engine service.

    Note:

    The engine-setup script displays stored configuration values supplied during the initial engine installation process. These stored values display when previewing the configuration and may not be up to date if you ran engine-config after installation. However, engine-setup will not overwrite your updated values.

    For example, if you ran engine-config to update SANWipeAfterDelete to true after installation, engine-setup outputs Default SAN wipe after delete: False in the configuration preview. However, engine-setup will not apply this value; rather, it will keep the SANWipeAfterDelete to true setting.

    After a update is successful, you see:

    Execution of setup completed successfully

    If the update fails, the engine-setup command attempts to rollback your installation to its previous state. If you encounter a failed update, detailed instructions display explaining how to restore your installation.

  6. Update the base operating system and any optional packages installed on the engine:
    # dnf update
  7. If any core libraries or services were upgraded, reboot the system to complete the changes. Run the following command to confirm a reboot is required: dnf needs-restarting -r,
  8. Update your KVM hosts.

Important:

Updating KVM hosts to the latest version of 4.4

  1. In the Administration portal, go to Compute and then click Hosts.

  2. In the Hosts pane, click a blank or non-linked cell for a host to select it.

  3. Click Installation and then Check for Upgrade.

  4. From the Upgrade Host window, click OK.

    The engine checks the KVM host to see if it requires an update.

  5. Using your mouse, hover over the icon next to the host name to see if an update is available.

  6. To proceed with the update, click Installation and then Upgrade.

  7. From the Upgrade Host window, click OK to begin the update process.

Repeat these steps to update the rest of the KVM hosts in the same cluster, one-by-one, until they are all updated to the latest version of 4.4.

When you finish updating your engine or self-hosted engine and KVM hosts, continue to Upgrading the Engine or Self-Hosted Engine.