Chapter 19. Updating the Red Hat Enterprise Virtualization Environment

19.1. Upgrades between Minor Releases

19.1.1. Checking for Red Hat Enterprise Virtualization Manager Updates

Summary
Use the engine-upgrade-check command, included in Red Hat Enterprise Virtualization Manager, to check for updates.

Procedure 19.1. Checking for Red Hat Enterprise Virtualization Manager Updates

  1. Run engine-upgrade-check as a user with administrative privileges such as the root user.
    # engine-upgrade-check
    • Where no updates are available the command will output the text No upgrade.
      # engine-upgrade-check
      VERB: queue package rhevm-setup for update
      VERB: package rhevm-setup queued
      VERB: Building transaction
      VERB: Empty transaction
      VERB: Transaction Summary:
      No upgrade
    • Where updates are available the command will list the packages to be updated.
      # engine-upgrade-check
      VERB: queue package rhevm-setup for update
      VERB: package rhevm-setup queued
      VERB: Building transaction
      VERB: Transaction built
      VERB: Transaction Summary:
      VERB:     updated    - rhevm-lib-3.3.0-0.46.el6ev.noarch
      VERB:     update     - rhevm-lib-3.3.1-0.48.el6ev.noarch
      VERB:     updated    - rhevm-setup-3.3.0-0.46.el6ev.noarch
      VERB:     update     - rhevm-setup-3.3.1-0.48.el6ev.noarch
      Upgrade available
Result
You have successfully checked for Red Hat Enterprise Virtualization Manager updates.

19.1.2. Updating Red Hat Enterprise Virtualization Manager

Summary
Updates to the Red Hat Enterprise Virtualization Manager are released via Red Hat Network. Before installing an update from Red Hat Network be sure to read the advisory text associated with it as well as the most recent version of the Red Hat Enterprise Virtualization Release Notes, and the Red Hat Enterprise Virtualization Technical Notes. A number of actions must be performed to complete an upgrade, including:
  • Stopping the ovirt-engine service.
  • Downloading and installing the updated packages.
  • Backing up and updating the database.
  • Performing post installation configuration.
  • Restarting the ovirt-engine service.
A script is included to perform these actions for you in an automated fashion. Active virtualization hosts are not upgraded by this process and must be updated separately. As a result the virtual machines running upon them are not affected. All commands in this task must be run while logged into the system hosting Red Hat Enterprise Virtualization Manager as the root user.

Procedure 19.2. Updating Red Hat Enterprise Virtualization Manager

  1. Run the yum command to update the rhevm-setup package.
    # yum update rhevm-setup
  2. Run the engine-setup command to update the Red Hat Enterprise Virtualization Manager.
    # engine-setup

    Note

    From Version 3.3, installation of Red Hat Enterprise Virtualization Manager supports otopi, a standalone, plug-in-based installation framework for setting up system components. Under this framework, the rhevm-upgrade command used during the installation process has been updated to engine-setup and is now obsolete.

    Note

    The upgrade process may take some time; allow time for the upgrade process to complete and do not stop the process once initiated. Once the upgrade has been completed, you will also be instructed to separately upgrade the data warehouse and reports functionality. These additional steps are only required if these optional packages are installed.
Result
You have successfully updated Red Hat Enterprise Virtualization Manager.

19.1.3. Updating Red Hat Enterprise Virtualization Manager Reports

Summary
The Red Hat Enterprise Virtualization Manager Reports must be updated separately to the Red Hat Enterprise Virtualization Manager. This task provides instructions for updating both the history database and the reporting engine. You must run all commands in this task while logged into the system hosting Red Hat Enterprise Virtualization Manager as the root user.

Procedure 19.3. Updating Red Hat Enterprise Virtualization Manager Reports

  1. Use the yum command to update the rhevm-reports and rhevm-dwh packages.
    # yum update -y rhevm-reports rhevm-dwh
  2. Run the rhevm-dwh-setup command to update the ovirt_engine_history database.
    # rhevm-dwh-setup
  3. Run the rhevm-reports-setup command to update the reporting engine.
    # rhevm-reports-setup
Result
You have successfully updated the Red Hat Enterprise Virtualization Manager Reports.

19.1.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 19.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-hypervisor6 parameters to ensure that you have the most recent version of the rhev-hypervisor6 package installed.
    # yum update rhev-hypervisor6
  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.

    Important

    After a Red Hat Enterprise Virtualization Hypervisor is successfully registered to the Red Hat Enterprise Virtualization Manager and then upgraded, it may erroneously appear in the Administration Portal with the status of Install Failed. Click on the Activate button, and the hypervisor will change to an Up status and be ready for use.
Result
You have successfully updated a Red Hat Enterprise Virtualization Hypervisor. Repeat these steps for each Hypervisor in the Red Hat Enterprise Virtualization environment.

19.1.5. Updating Red Hat Enterprise Linux Virtualization Hosts

Summary
Red Hat Enterprise Linux virtualization hosts are updated the same way as regular Red Hat Enterprise Linux systems, using yum. It is highly recommended that you use yum to update your systems regularly, to ensure timely application of security and bug fixes. All steps in this task must be run while logged into the Red Hat Enterprise Linux virtualization host as the root user.

Procedure 19.5. Updating Red Hat Enterprise Linux Virtualization Hosts

  1. On the administration portal, navigate to the Hosts tab and select the host to be updated. Click Maintenance to place it into maintenance mode.
  2. On the Red Hat Enterprise Linux virtualization host, run the yum command with the update parameter to update all installed packages.
    # yum update
  3. If a package such as the kernel was updated, you must reboot the host to get the new functionality. If a package such as VDSM or libvirt was updated, you must restart that service to get the new functionality. Moreover, if the libvirt package is updated, you must restart the VDSM service.
Result
You have successfully updated the Red Hat Enterprise Linux virtualization host. Repeat this process for each Red Hat Enterprise Linux virtualization host in the Red Hat Enterprise Virtualization environment.

19.1.6. Updating the Red Hat Enterprise Virtualization Guest Tools

Summary
The guest tools allow the Manager to communicate with running guests, providing information such as IP addresses, memory usage, and installed applications for display in the Administration Portal. The guest tools are distributed as an ISO file that can be attached to guests. The ISO file is packaged as an RPM file, that can be installed and upgraded on registered Red Hat Enterprise Virtualization Manager servers.

Procedure 19.6. Updating the Red Hat Enterprise Virtualization Guest Tools

  1. On the Manager, as root user, use the yum upgrade to upgrade the rhev-guest-tools-iso package.
    # yum update -y rhev-guest-tools-iso*
    
  2. When the rhev-guest-tools-iso package has been successfully upgraded, use the engine-iso-uploader command to upload it to your ISO storage domain. Replace [ISODomain] with the name of your ISO storage domain.
    engine-iso-uploader --iso-domain=[ISODomain] upload /usr/share/rhev-guest-tools-iso/rhev-tools-setup.iso
    
    The rhev-tools-setup.iso file is actually a link to the most recently updated ISO file. The link is automatically changed to point to the newest ISO file every time you upgrade the rhev-guest-tools-iso package.
  3. Using the web portal or REST API, attach the rhev-tools-setup.iso file to each of your guests, and from within each guest, upgrade the tools installed on each guest using the installer on the ISO.
Result
You've updated your rhev-tools-setup.iso file, uploaded the updated ISO to your ISO storage domain, and attached it to your virtual machines.