Updating the Engine

Important:

If you're upgrading the environment, see Updating engine or self-hosted engine to 4.4 in the Upgrading Your Environment to 4.5 section.

To update the engine:

  1. Update the release rpm.
    • If you're updating from 4.4 to the latest version of 4.4, run:
      dnf update oracle-ovirt-release-el8
    • If you're updating from 4.5 to the latest version of 4.5, run:
      dnf update oracle-ovirt-release-45-el8

  2. Verify that the engine is eligible to update and if there are updates for any packages. 

    engine-upgrade-check
    ...
Upgrade available.

  3. Update the setup packages and resolve dependencies. 

    dnf update ovirt\*setup\*
    ...
Complete!
  4. Update the 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 postinstallation 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 won't overwrite the 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 won't apply this value. Instead, it keeps the SANWipeAfterDelete=true setting.

    If the update is successful, you will see:

    Execution of setup completed successfully

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

  5. Update the base OS and any optional packages installed.

    dnf update

    Important:

    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,