Upgrading the Engine

To upgrade your engine install the ovirt-engine package and run the engine-setup command to configure the engine.

Important

If the upgrade fails, the engine-setup command attempts to rollback your installation to its previous state. Do not remove the repositories required by the 4.2 engine until after the upgrade successfully completes. If you encounter a failed upgrade, detailed instructions display explaining how to restore your installation.

  1. Subscribe to the required channels OR install the Release 4.3.6 package.

    • For ULN registered hosts only: If the host is registered on ULN, subscribe the system to the required channels.

      1. Log in to https://linux.oracle.com with your ULN user name and password.

      2. On the Systems tab, click the link named for the host in the list of registered machines.

      3. On the System Details page, click Manage Subscriptions.

      4. On the System Summary page, select each required channel from the list of available channels and click the right arrow to move the channel to the list of subscribed channels. Subscribe the system to the following channels:

        • ol7_x86_64_ovirt43

        • ol7_x86_64_ovirt43_extras

      5. Click Save Subscriptions.

    • For Oracle Linux yum server hosts only: Install the Oracle Linux Virtualization Manager Release 4.3.6 package.

      # yum install oracle-ovirt-release-el7
  2. Check to see if your engine is eligible to upgrade and if there are updates for any packages.

    # engine-upgrade-check
    ...
    Upgrade available.
  3. Update the setup packages and resolve dependencies.

    # yum update ovirt\*setup\*
    ...
    Complete!
  4. Update the engine to Release 4.3.6.

    # engine-setup
    ...
    [ INFO  ] Execution of setup completed successfully

    The engine-setup script prompts you with some configuration questions, then stops the ovirt-engine service, downloads and installs the updated packages, backs up and updates the database, performs post-installation configuration, and starts the ovirt-engine service. For more information about the configuration options, see the Engine Configuration Options.

    Note

    When you run the engine-setup script during the installation process your configuration values are stored. During an upgrade, these stored values display when previewing the configuration and they might not be up-to-date if you ran engine-config after installation. 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, your updated values are not overwritten by engine-setup.

  5. Unsubscribe to the 4.2 channels OR disable the 4.2 repositories.

    • For ULN registered hosts only: If the host is registered on ULN, unsubscribe to the following channels.

      • ol7_x86_64_ovirt42

      • ol7_x86_64_ovirt42_extras

    • For Oracle Linux yum server hosts only: Run the following commands.

      # yum-config-manager --disable ovirt-4.2
      # yum-config-manager --disable ovirt-4.2-extra
      Important

      Before you execute yum-config-manager ensure the yum-utils package is installed on your system. For more information, see Using Yum Utilities to Manage Configuration in the Oracle® Linux 7: Administrator's Guide

You are now ready to proceed with Upgrading KVM Hosts.