Updating the Engine

Important:

If you are upgrading your environment, refer to Updating engine or self-hosted engine to 4.4 in the Upgrading Your Environment to 4.5 section.

To update your engine:

  1. Update the release rpm.
    • If you are updating from 4.4 to the latest version of 4.4, run:
      # dnf update oracle-ovirt-release-el8
    • If you are updating from 4.5 to the latest version of 4.5, run:
      # dnf update oracle-ovirt-release-45-el8
  2. Check to see if your 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 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.

    If the update is successful, you will 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.

  5. Update the base operating system 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,