Upgrading the Engine or Self-Hosted Engine

Upgrade a standalone or Self-Hosted Engine on Oracle Linux 8

Important:

This section applies only when you upgrade an Oracle Linux 8 standalone or Self-Hosted Engine from Oracle Linux Virtualization Manager Release 4.4 to 4.5.

Before you start the upgrade process,

  1. On the engine or self-hosted engine machine, install the Oracle Linux Virtualization Manager Release 4.5 package.
    dnf install oracle-ovirt-release-45-el8
  2. Verify that the ovirt-4.5 and ovirt-4.5-extras repositories are enabled.
    dnf repolist

    If either repository isn't enabled, use the dnf config-manager --enable repository command to enable them.

    Note:

    For ULN registered hosts or if you're using Oracle Linux Manager, ensure you have subscribed to ol8_x86_64_ovirt45 and ol8_x86_64_ovirt45_extras.
  3. Check for updated packages:

    engine-upgrade-check
  4. Update the setup packages:

    dnf update ovirt\*setup\*
  5. Check the engine host configuration or the self-hosted engine host configuration.
  6. Update the engine or self-hosted engine:

    engine-setup
  7. Proceed to Migrating KVM Hosts to 4.5.

    Important:

    After the engine and KVM hosts are upgraded and verified, remove the release package for version 4.4 on engine and all KVM hosts:
    dnf remove oracle-ovirt-release-el8

Migrate a standalone engine from Oracle Linux 8 to Oracle Linux 9

Important:

This section applies only when you move a standalone Manager from Oracle Linux 8 to Oracle Linux 9. An in-place upgrade of the Manager host operating system is not supported.

Back up the Oracle Linux 8 Manager and restore it on a new or re-imaged Oracle Linux 9 host. Preserve the Oracle Linux 8 boot volume until you validate the restored Manager.

  1. Verify the Manager is at the required 4.5 package and build level.

  2. Stop the engine service and create a full backup.

    sudo systemctl stop ovirt-engine
    sudo engine-backup --mode=backup --scope=all
  3. Copy the backup file to secure storage. Record its location and verify that the copy is readable.

  4. Install and configure a standalone Oracle Linux 9 Manager host. See Configure an Oracle Linux 9 Engine Host.

  5. Restore the backup and configure the Manager.

    sudo engine-backup --mode=restore --file=backup_file --provision-all-databases --restore-permissions
    sudo engine-setup
  6. Validate the restored environment. Verify the service status, sign in to the Administration Portal, verify host connectivity, confirm data center and cluster compatibility, verify that running virtual machines report the expected state, and verify the backup archive.

WARNING:

Objects changed after the backup was created are not included in the restored Manager. Recover or recreate those objects as necessary. If validation fails, return to the retained Oracle Linux 8 boot volume and restore the original backup.

Before you start the upgrade process,

  1. On the engine or self-hosted engine machine, install the Oracle Linux Virtualization Manager Release 4.5 package.
    dnf install oracle-ovirt-release-45-el8
  2. Verify that the ovirt-4.5 and ovirt-4.5-extras repositories are enabled.
    dnf repolist

    If either repository isn't enabled, use the dnf config-manager --enable repository command to enable them.

    Note:

    For ULN registered hosts or if you're using Oracle Linux Manager, ensure you have subscribed to ol8_x86_64_ovirt45 and ol8_x86_64_ovirt45_extras.
  3. Check for updated packages:

    engine-upgrade-check
  4. Update the setup packages:

    dnf update ovirt\*setup\*
  5. Check the engine host configuration or the self-hosted engine host configuration.
  6. Update the engine or self-hosted engine:

    engine-setup
  7. Proceed to Migrating KVM Hosts to 4.5.

    Important:

    After the engine and KVM hosts are upgraded and verified, remove the release package for version 4.4 on engine and all KVM hosts:
    dnf remove oracle-ovirt-release-el8