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,
- Review the environment upgrade overview.
- Verify that you have satisfied the prerequisites.
- Ensure you have updated engine or self-hosted engine to latest version of 4.4.
- Ensure you have updated KVM hosts to the latest version of 4.4.
- 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 - Verify that the
ovirt-4.5andovirt-4.5-extrasrepositories are enabled.dnf repolistIf either repository isn't enabled, use the
dnf config-manager --enable repositorycommand to enable them.Note:
For ULN registered hosts or if you're using Oracle Linux Manager, ensure you have subscribed tool8_x86_64_ovirt45andol8_x86_64_ovirt45_extras. -
Check for updated packages:
engine-upgrade-check -
Update the setup packages:
dnf update ovirt\*setup\* - Check the engine host configuration or the self-hosted engine host configuration.
-
Update the engine or self-hosted engine:
engine-setup -
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.
-
Verify the Manager is at the required 4.5 package and build level.
-
Stop the engine service and create a full backup.
sudo systemctl stop ovirt-engine sudo engine-backup --mode=backup --scope=all -
Copy the backup file to secure storage. Record its location and verify that the copy is readable.
-
Install and configure a standalone Oracle Linux 9 Manager host. See Configure an Oracle Linux 9 Engine Host.
-
Restore the backup and configure the Manager.
sudo engine-backup --mode=restore --file=backup_file --provision-all-databases --restore-permissions sudo engine-setup -
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.
Note:
For KVM host migration, see Migrate KVM Hosts from Oracle Linux 8 to Oracle Linux 9. For compatibility versions, see Changing Data Center and Cluster Compatibility Versions After Upgrading.
Before you start the upgrade process,
- Review the environment upgrade overview.
- Verify that you have satisfied the prerequisites.
- Ensure you have updated engine or self-hosted engine to latest version of 4.4.
- Ensure you have updated KVM hosts to the latest version of 4.4.
- 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 - Verify that the
ovirt-4.5andovirt-4.5-extrasrepositories are enabled.dnf repolistIf either repository isn't enabled, use the
dnf config-manager --enable repositorycommand to enable them.Note:
For ULN registered hosts or if you're using Oracle Linux Manager, ensure you have subscribed tool8_x86_64_ovirt45andol8_x86_64_ovirt45_extras. -
Check for updated packages:
engine-upgrade-check -
Update the setup packages:
dnf update ovirt\*setup\* - Check the engine host configuration or the self-hosted engine host configuration.
-
Update the engine or self-hosted engine:
engine-setup -
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