6.2. Upgrading a RHEL or RHEV-H 7 Self-Hosted Engine Environment

Note

The following procedure is only for upgrading a Red Hat Enterprise Virtualization 3.5 self-hosted engine environment running on Red Hat Enterprise Linux (RHEL) 7 hosts or Red Hat Enterprise Virtualization Hypervisor (RHEV-H) 7 hosts.
New RHEL 7 hosts cannot be used in Red Hat Enterprise Virtualization 3.5 self-hosted engine environments; use the appropriate RHEV-H 7 host instead. See https://access.redhat.com/solutions/2456071.
To upgrade your Red Hat Enterprise Virtualization self-hosted engine environment from version 3.5 to 3.6, update the Manager virtual machine, the self-hosted engine hosts, 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.

Important

During the 3.5 to 3.6 upgrade, at least one self-hosted engine host must be upgraded first. Upgrading the host will trigger the self-hosted engine storage domain upgrade. A new 3.6 host will not trigger the required upgrade.
The self-hosted engine storage domain auto-import will happen automatically after a 3.5 host is upgraded with 3.6 packages.
The upgrade process involves the following key steps:
  • Place the high-availability agents that manage the Manager virtual machine in the global maintenance mode.
  • Update the Manager virtual machine.
  • Place a self-hosted engine host 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 host. Repeat for all hosts. It is recommended to update all hosts in the environment, including standard hosts.
  • After all hosts in the cluster and the Manager virtual machine have been updated, change the cluster compatibility version to 3.6.

Procedure 6.4. Upgrading the Self-Hosted Engine Manager Virtual Machine

  1. Disable the high-availability agents on all the self-hosted engine hosts. To do this run the following command on any self-hosted engine host in the cluster. 
    # hosted-engine --set-maintenance --mode=global
    After a few minutes, run hosted-engine --vm-status to confirm that the environment is in maintenance mode.
  2. Log in to the Manager virtual machine to upgrade the Red Hat Enterprise Virtualization Manager.
    1. Enable the Red Hat Enterprise Virtualization Manager 3.6 repository: 
      # subscription-manager repos --enable=rhel-6-server-rhevm-3.6-rpms
    2. Update the rhevm setup packages: 
      # yum update rhevm\*setup\*
    3. Run engine-setup and follow the prompts to upgrade the Red Hat Enterprise Virtualization Manager: 
      # engine-setup
    4. Remove or disable the Red Hat Enterprise Virtualization Manager 3.5 repository to ensure the system does not use any Red Hat Enterprise Virtualization Manager 3.5 packages: 
      # subscription-manager repos --disable=rhel-6-server-rhevm-3.5-rpms
    5. Update the base operating system: 
      # yum update
Now that the Manager virtual machine has been upgraded, you can update the hosts. The following procedure is for updating Red Hat Enterprise Virtualisation Hypervisor 7 hosts.

Procedure 6.5. Updating the RHEV-H Self-Hosted Engine Host

  1. Update the RHEV-H host. See Updating Red Hat Enterprise Virtualization Hypervisors in the Upgrade Guide for more information.
  2. On the host, restart VDSM: 
    # systemctl restart vdsmd
  3. Restart ovirt-ha-broker and ovirt-ha-agent: 
    # systemctl restart ovirt-ha-broker
    # systemctl restart ovirt-ha-agent
  4. Repeat step 1 to step 3 to update all self-hosted engine hosts. If you have any standard RHEV-H hosts you can update them using step 1.
  5. Disable global maintenance after all self-hosted engine hosts have been updated. 
    # hosted-engine --set-maintenance --mode=none
The following procedure is for updating Red Hat Enterprise Linux 7-based hosts.

Procedure 6.6. Updating the RHEL-Based Self-Hosted Engine Host

  1. Access the Administration Portal. Select a self-hosted engine host and place it into maintenance mode by clicking 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. Update the self-hosted engine host: 
    # yum update
  3. Restart VDSM: 
    # systemctl restart vdsmd
  4. Restart ovirt-ha-broker and ovirt-ha-agent: 
    # systemctl restart ovirt-ha-broker
    # systemctl restart ovirt-ha-agent
  5. Access the Administration Portal. Select the same host and click Activate.
  6. Repeat step 1 to step 5 to update all self-hosted engine hosts. If you have standard Red Hat Enterprise Linux 7 hosts in your environment, ensure the required repository is enabled on the host as in step 2, and update the host. See Updating Red Hat Enterprise Linux Virtualization Hosts in the Upgrade Guide for more information.
  7. Disable global maintenance after all self-hosted engine hosts have been updated. 
    # hosted-engine --set-maintenance --mode=none
It is recommended that all hosts in your self-hosted environment are upgraded at the same time. This prevents the older version hosts from going into a Non Operational state. If this is not possible in your environment, follow this procedure to upgrade any additional hosts.

Procedure 6.7. Upgrading Additional Hosts

  1. Access the Administration Portal. Select the host and place it into maintenance mode by clicking 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 required repository is enabled: 
    # subscription-manager repos --enable=rhel-7-server-rhev-mgmt-agent-rpms
  3. Update the self-hosted engine host: 
    # yum update
  4. Restart VDSM: 
    # service vdsmd restart
  5. Restart ovirt-ha-broker and ovirt-ha-agent: 
    # service ovirt-ha-broker restart
    # service ovirt-ha-agent restart
  6. Access the Administration Portal. Select the host and activate it by clicking Activate.
  7. Repeat the steps for all self-hosted engine hosts you want to upgrade.
You can now update the cluster compatibility version to 3.6.

Important

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

Procedure 6.8. Updating the Cluster Compatibility Version

  1. Access the Administration Portal. Select the Default cluster and click Edit to open the Edit Cluster window.
  2. Use the Compatibility Version drop-down menu to select 3.6. Click OK to save the change and close the window.