3.7. Upgrading the Self-Hosted Engine

Upgrade your Red Hat Enterprise Virtualization hosted-engine environment from version 3.4 to 3.5.
This procedure upgrades two hosts, referred to in this procedure as Host A and Host B, and a Manager virtual machine. For the purposes of this procedure, Host B is hosting the Manager virtual machine.
It is recommended that all hosts in the environment be upgraded at the same time, before the Manager virtual machine is upgraded and the Compatibility Version of the cluster is updated to 3.5. This avoids any version 3.4 hosts from going into a Non Operational state.
All commands in this procedure are as the root user.

Procedure 3.5. Upgrading the Self-Hosted Engine

  1. Access the Administration Portal. Select Host A and put it into maintenance mode by clicking the Maintenance button. If Host A is hosting the Manager virtual machine, the virtual machine will be migrated to Host B.
  2. Log in to Host A and set the maintenance mode to local to disable the high-availability agents and prevent Host A from hosting the virtual machine while it is being upgraded.
    # hosted-engine --set-maintenance --mode=local
  3. Enable the new repository on Host A.
    # subscription-manager repos --enable=rhel-6-server-rhevm-3.5-rpms
  4. Update Host A.
    # yum update
  5. Restart VDSM on Host A.
    # service vdsmd restart
  6. Restart ovirt-ha-broker and ovirt-ha-agent on Host A.
    # service ovirt-ha-broker restart
    # service ovirt-ha-agent restart
  7. Disable maintenance mode to reinstate the high-availability agents on Host A.
    # hosted-engine --set-maintenance --mode=none
  8. Access the Administration Portal. Select Host A and activate it by clicking the Activate button.
  9. Disable the old repository on Host A.
    # subscription-manager repos --disable=rhel-6-server-rhevm-3.4-rpms
  10. When Host A has a status of Up, select Host B and put it into maintenance mode by clicking the Maintenance button. This will migrate the Manager virtual machine to Host A.
  11. Log in to Host B and set the maintenance mode to local to disable the high-availability agents and prevent Host B from hosting the virtual machine while it is being upgraded.
    # hosted-engine --set-maintenance --mode=local
  12. Enable the new repository on Host B.
    # subscription-manager repos --enable=rhel-6-server-rhevm-3.5-rpms
  13. Update Host B.
    # yum update
  14. Restart VDSM on Host B.
    # service vdsmd restart
  15. Restart ovirt-ha-broker and ovirt-ha-agent on Host B.
    # service ovirt-ha-broker restart
    # service ovirt-ha-agent restart
  16. Disable maintenance mode to reinstate the high-availability agents on Host B.
    # hosted-engine --set-maintenance --mode=none
  17. Access the Administration Portal. Select Host B and activate it by clicking the Activate button.
  18. Disable the old repository on Host B.
    # subscription-manager repos --disable=rhel-6-server-rhevm-3.4-rpms
  19. Log in to the Manager virtual machine and update the engine as per the instructions in Section 5.2.4, “Upgrading to Red Hat Enterprise Virtualization Manager 3.5”.
  20. Access the Administration Portal.
    • Select the Default cluster and click Edit to open the Edit Cluster window.
    • Use the Compatibility Version drop-down menu to select 3.5. Click OK to save the change and close the window.