5.3. Upgrading a Self-Hosted Engine Environment

To upgrade your Red Hat Virtualization self-hosted engine environment from version 4.0 to 4.1, upgrade the Manager virtual machine, the self-hosted engine nodes, and any standard hosts. All hosts in a self-hosted engine environment must be the same version; you cannot upgrade only some of the hosts.
To upgrade a version of Red Hat Virtualization earlier than 4.0 to Red Hat Virtualization 4.1, you must sequentially upgrade to any later versions of Red Hat Virtualization before upgrading to the latest version. For example, if you are using Red Hat Enterprise Virtualization 3.6, you must upgrade to the latest minor version of Red Hat Virtualization 4.0 before you can upgrade to Red Hat Virtualization 4.1. See the Upgrade Guide for Red Hat Virtualization 4.0 for instructions to upgrade to the latest 4.0 minor version.
Before upgrading the Manager virtual machine, ensure the /var/tmp directory contains 5 GB free space to extract the appliance files. If it does not, you can specify a different directory or mount alternate storage that does have the required space. The VDSM user and KVM group must have read, write, and execute permissions on the directory.
The upgrade process involves the following key steps:
  • Place the high-availability agents that manage the Manager virtual machine into global maintenance mode.
  • Upgrade the Manager virtual machine.
  • Place a self-hosted engine node into maintenance. The Manager virtual machine and other virtual machines will be migrated to another host in the cluster if necessary.
  • Update the self-hosted engine node. Repeat for all hosts. Red Hat recommends updating all hosts in the environment, including standard hosts.
  • After all hosts in the cluster and the Manager virtual machine have been upgraded, change the cluster compatibility version to 4.1.

Procedure 5.4. Upgrading a Self-Hosted Engine Environment

  1. Disable the high-availability agents on all the self-hosted engine nodes. In the Hosts tab, right-click a self-hosted engine node and select Enable Global HA Maintenance.
    After a few minutes, check that the General tab in the details pane reports Hosted Engine HA: Global Maintenance Enabled to confirm that the environment is in maintenance mode.
  2. Log in to the Manager virtual machine to upgrade the Red Hat Virtualization Manager.
    1. Enable the Red Hat Virtualization Manager 4.1 and Red Hat Virtualization Tools repositories:
      # subscription-manager repos --enable=rhel-7-server-rhv-4.1-rpms
      # subscription-manager repos --enable=rhel-7-server-rhv-4-tools-rpms
    2. Update the setup packages:
      # yum update ovirt\*setup\*
    3. Run engine-setup and follow the prompts to upgrade the Red Hat Virtualization Manager:
      # engine-setup
    4. Remove or disable the Red Hat Virtualization Manager 4.0 repository to ensure the system does not use any Red Hat Virtualization Manager 4.0 packages:
      # subscription-manager repos --disable=rhel-7-server-rhv-4.0-rpms
    5. Update the base operating system:
      # yum update

      Important

      If any kernel packages were updated, reboot the Manager virtual machine manually to complete the update. See Troubleshooting the Manager Virtual Machine.
    6. Disable global maintenance. In the Administration Portal, click the Hosts tab. Right-click a self-hosted engine node and select Disable Global HA Maintenance.
  3. Update the self-hosted engine nodes, then any standard hosts in the environment:
    1. In the Administration Portal, click the Hosts tab. Right-click a host and select ManagementMaintenance to place the host into local maintenance. If the host is hosting the Manager virtual machine, the virtual machine will be migrated to another host. Any other virtual machines will be migrated according to your virtual machine migration policy. The high-availability agents are automatically placed into local maintenance.
    2. Ensure the correct repository is enabled:
      # subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms
      # subscription-manager repos --enable=rhel-7-server-ansible-2-rpms
    3. Update the host:
      • On a Red Hat Enterprise Linux host, log in to the host machine and run the following command:
        # yum update
      • On a Red Hat Virtualization Host (RHVH), log in to the Cockpit user interface, click Terminal, and run the following command:
        # yum update

      Important

      If any kernel packages were updated, reboot the host to complete the update.
    4. Select the same host and click ManagementActivate.
    5. Repeat these steps to update all hosts.
  4. Update the cluster and data center compatibility version to 4.1. See Post-Upgrade Tasks in the Upgrade Guide for more information.

    Important

    Only update the compatibility version if all hosts have been updated for Red Hat Virtualization 4.1 to avoid some hosts becoming non-operational.