5.4. Updating Red Hat Enterprise Virtualization Hypervisors

Summary
Updating Red Hat Enterprise Virtualization Hypervisors involves reinstalling the Hypervisor with a newer version of the Hypervisor ISO image. This includes stopping and restarting the Hypervisor. Virtual machines are automatically migrated to a different host, as a result it is recommended that Hypervisor updates are performed at a time when the host's usage is relatively low.
It is recommended that administrators update Red Hat Enterprise Virtualization Hypervisors regularly. Important bug fixes and security updates are included in updates. Hypervisors which are not up to date may be a security risk.

Warning

Upgrading Hypervisor hosts involves shutting down, deactivating guests, and restarting the physical server. If any virtual machines are running on the Hypervisor, all data and configuration details may be destroyed if they are not shut down. Upgrading Hypervisors must be carefully planned and executed with care and consideration.

Important

Ensure that the cluster contains more than one host before performing an upgrade. Do not attempt to re-install or upgrade all the hosts at the same time, as one host must remain available to perform Storage Pool Manager (SPM) tasks.

Procedure 5.4. Updating Red Hat Enterprise Virtualization Hypervisors

  1. Log in to the system hosting Red Hat Enterprise Virtualization Manager as the root user.
  2. Ensure that:
    • the system is subscribed to the Red Hat Enterprise Virtualization entitlement — if using certificate-based Red Hat Network; or
    • the system is subscribed to the Red Hat Enterprise Virtualization Hypervisor (v.6 x86-64) (labeled rhel-x86_64-server-6-rhevh) — if using classic Red Hat Network.
  3. Run the yum command with the update rhev-hypervisor parameters to ensure that you have the most recent version of the rhev-hypervisor package installed.
    # yum update rhev-hypervisor
  4. Use your web browser to log in to the Administration Portal as a Red Hat Enterprise Virtualization administrative user.
  5. Click the Hosts tab, and then select the host that you intend to upgrade. If the host is not displayed, or the list of hosts is too long to filter visually, perform a search to locate the host.
  6. With the host selected, click the General tab on the Details pane.
    • If the host requires updating, an alert message indicates that a new version of the Red Hat Enterprise Virtualization Hypervisor is available.
    • If the host does not require updating, no alert message is displayed and no further action is required.
  7. Ensure the host remains selected and click the Maintenance button, if the host is not already in maintenance mode. This will cause any virtual machines running on the host to be migrated to other hosts. If the host is the SPM, this function will be moved to another host. The status of the host changes as it enters maintenance mode. When the host status is Maintenance, the message in the general tab changes, providing you with a link which when clicked will re-install or upgrade the host.
  8. Ensure that the host remains selected, and that you are on the General tab of the the Details pane. Click the Upgrade link. The Install Host dialog box displays.
  9. Select rhev-hypervisor.iso, which is symbolically linked to the most recent hypervisor image.
  10. Click OK to update and re-install the host. The dialog closes, the details of the host are updated in the Hosts tab, and the status changes.
    The host status will transition through these stages:
    • Installing,
    • Reboot,
    • Non Responsive, and
    • Up.
    These are all expected, and each stage will take some time.
  11. Once successfully updated, the host displays a status of Up. Any virtual machines that were migrated off the host, are at this point able to be migrated back to it.
Result
You have successfully updated a Red Hat Enterprise Virtualization Hypervisor. Repeat these steps for each Hypervisor in the Red Hat Enterprise Virtualization environment.