3.7. Upgrading the Self-Hosted Engine

Summary

Upgrade your Red Hat Enterprise Virtualization hosted-engine environment from version 3.3 to 3.4.

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.4. This avoids any version 3.3 hosts from going into a Non Operational state.
All commands in this procedure are as the root user.

Procedure 3.4. Upgrading the Self-Hosted Engine

  1. Log into either host and set the maintenance mode to global to disable the high-availability agents. 
    # hosted-engine --set-maintenance --mode=global
  2. Access the Red Hat Enterprise Virtualization Manager Administration Portal. Select Host A and put it into maintenance mode by clicking the Maintenance button.

    Important

    The host that you put into maintenance mode and upgrade must not be the host currently hosting the Manager virtual machine.
  3. Log into and update Host A. 
    # yum update
  4. Restart VDSM on Host A. 
    # service vdsmd restart
  5. Restart ovirt-ha-broker and ovirt-ha-agent on Host A. 
    # service ovirt-ha-broker restart
    # service ovirt-ha-agent restart
  6. Log into either host and turn off the hosted-engine maintenance mode so that the Manager virtual machine can migrate to the other host. 
    # hosted-engine --set-maintenance --mode=none
  7. Access the Red Hat Enterprise Virtualization Manager Administration Portal. Select Host A and activate it by clicking the Activate button.
  8. Log into Host B and set the maintenance mode to global to disable the high-availability agents. 
    # hosted-engine --set-maintenance --mode=global
  9. Update Host B. 
    # yum update
  10. Restart VDSM on Host B. 
    # service vdsmd restart
  11. Restart ovirt-ha-broker and ovirt-ha-agent on Host B. 
    # service ovirt-ha-broker restart
    # service ovirt-ha-agent restart
  12. Turn off the hosted-engine maintenance mode on Host B. 
    # hosted-engine --set-maintenance --mode=none
  13. Access the Red Hat Enterprise Virtualization Manager Administration Portal. Select Host B and activate it by clicking the Activate button.
  14. Log into 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.4”.
  15. Access the Red Hat Enterprise Virtualization Manager 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.4. Click OK to save the change and close the window.
Result

You have upgraded both the hosts and the Manager in your hosted-engine setup to Red Hat Enterprise Virtualization 3.4.

Report a bug