Red Hat Training

A Red Hat training course is available for Red Hat Virtualization

Appendix A. Upgrading a RHEV-H 3.6 Self-Hosted Engine to a RHVH 4.2 Self-Hosted Engine

To upgrade a Red Hat Enterprise Virtualization 3.6 self-hosted engine environment that contains only Red Hat Enterprise Virtualization Hypervisors (RHEV-H) to Red Hat Virtualization 4.2, you must remove the hosts and install Red Hat Virtualization Host (RHVH) instead.

Self-hosted engine nodes in Red Hat Enterprise Virtualization 3.6 are added using the hosted-engine --deploy command, which cannot be used to add RHVH 4.2 as an additional node, and self-hosted engine nodes in Red Hat Virtualization 4.2 are added using the UI, which is not available in Red Hat Enterprise Virtualization 3.6. Therefore, to upgrade the environment from 3.6 to 4.2, you must first install a self-hosted engine node running RHVH 4.0, where adding more nodes using the hosted-engine --deploy command is deprecated but still available.

Alternatively, you can install a 3.6 version of RHVH in the 3.6 environment and perform a standard stepped upgrade from 3.6 to 4.0, and 4.0 to 4.1. See Red Hat Virtualization Hosts in the Red Hat Enterprise Virtualization 3.6 Self-Hosted Engine Guide for more information.

Note

This scenario does not impact self-hosted engine environments that contain some (or only) Red Hat Enterprise Linux or Next Generation RHVH self-hosted engine nodes, as they can be updated without being removed from the environment.

Important

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.

Upgrading from a Red Hat Enterprise Virtualization 3.6 self-hosted engine environment with RHEV-H 3.6 hosts to a Red Hat Virtualization 4.2 environment with RHVH 4.2 hosts involves the following key steps:

  • Install a new RHVH 4.0 host and add it to the 3.6 self-hosted engine environment. The new host can be an existing RHEV-H 3.6 host removed from the environment and reinstalled with RHVH 4.0.
  • Upgrade the Manager from 3.6 to 4.0.
  • Remove the rest of the RHEV-H 3.6 hosts and reinstall them with RHVH 4.2.
  • Add the RHVH 4.2 hosts to the 4.0 environment.
  • Upgrade the Manager from 4.0 to 4.1.
  • Upgrade the Manager from 4.1 to 4.2.
  • Upgrade the remaining RHVH 4.0 host to RHVH 4.2.

Upgrading a RHEV-H 3.6 Self-Hosted Engine to a RHVH 4.2 Self-Hosted Engine

  1. If you are reusing an existing RHEV-H 3.6 host, remove it from the 3.6 environment. See Removing a Host from a Self-Hosted Engine Environment.
  2. Upgrade the environment from 3.6 to 4.0 using the instructions in Upgrading a RHEV-H-Based Self-Hosted Engine Environment in the Red Hat Virtualization 4.0 Self-Hosted Engine Guide. These instructions include installing a RHVH 4.0 host.

  3. Upgrade each remaining RHEV-H 3.6 host directly to RHVH 4.2:

    1. Remove the host from the self-hosted engine environment. See Removing a Host from a Self-Hosted Engine Environment.
    2. Reinstall the host with RHVH 4.2. See Installing Red Hat Virtualization Host in the Installation Guide.
    3. Add the host to the 4.0 environment. See Installing Additional Hosts to a Self-Hosted Environment in the Red Hat Virtualization 4.0 Self-Hosted Engine Guide.

  4. Upgrade the Manager from 4.0 to 4.1:

    1. In the Administration Portal, right-click a self-hosted engine node and select Enable Global HA Maintenance.

      Wait a few minutes and ensure that you see Hosted Engine HA: Global Maintenance Enabled in the General tab.

    2. Use the instructions in Upgrading to Red Hat Virtualization Manager 4.1.
  5. Upgrade the Manager from 4.1 to 4.2 and then upgrade the final remaining RHVH 4.0 host to 4.2 using the instructions in Upgrading a Self-Hosted Engine from 4.1 to Red Hat Virtualization 4.2.