19.3. Upgrading to Red Hat Enterprise Virtualization Manager 3.2

19.3.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.2

Summary
Upgrading Red Hat Enterprise Virtualization Manager to version 3.2 is performed using the rhevm-upgrade command. Virtualization hosts, and the virtual machines running upon them, will continue to operate independently while the Manager is being upgraded. Once the Manager upgrade is complete you will be able to upgrade your hosts, if you haven't already, to the latest versions of Red Hat Enterprise Linux and Red Hat Enterprise Virtualization Hypervisor.

Important

Users of Red Hat Enterprise Virtualization 3.0 must migrate to Red Hat Enterprise Virtualization 3.1 before attempting this upgrade.

Note

In the event that the upgrade fails the rhevm-upgrade command will attempt to roll your Red Hat Enterprise Virtualization Manager installation back to its previous state. Where this also fails detailed instructions for manually restoring the installation are displayed.

Procedure 19.8. Upgrading to Red Hat Enterprise Virtualization Manager 3.2

  1. Add Red Hat Enterprise Virtualization 3.2 Subscription

    Ensure that the system is subscribed to the required channels and entitlements to receive Red Hat Enterprise Virtualization Manager 3.2 packages. This procedure assumes that the system is already subscribed to required channels and entitlements to receive Red Hat Enterprise Virtualization 3.1 packages. These must also be available to complete the upgrade process.
    Certificate-based Red Hat Network
    The Red Hat Enterprise Virtualization 3.2 packages are provided by the rhel-6-server-rhevm-3.2-rpms repository associated with the Red Hat Enterprise Virtualization entitlement. Use the yum-config-manager command to enable the repository in your yum configuration. The yum-config-manager command must be run while logged in as the root user.
    # yum-config-manager --enable rhel-6-server-rhevm-3.2-rpms
    Red Hat Network Classic
    The Red Hat Enterprise Virtualization 3.2 packages are provided by the Red Hat Enterprise Virtualization Manager (v.3.2 x86_64) channel, also referred to as rhel-x86_64-server-6-rhevm-3.2 in Red Hat Network Classic.
    rhn-channel --add --channel=rhel-x86_64-server-6-rhevm-3.2
    Use the rhn-channel command, or the Red Hat Network Web Interface, to subscribe to the Red Hat Enterprise Virtualization Manager (v.3.2 x86_64) channel.
  2. Remove Enterprise Virtualization 3.1 Subscription

    Ensure that the system does not use any Red Hat Enterprise Virtualization Manager 3.1 packages by removing the Red Hat Enterprise Vitulization Manager 3.1 channels and entitlements.
    Certificate-based Red Hat Network
    Use the yum-config-manager command to disable the Red Hat Enterprise Virtualization 3.1 repository in your yum configuration. The yum-config-manager command must be run while logged in as the root user.
    # yum-config-manager --disablerepo=rhel-6-server-rhevm-3.1-rpms
    Red Hat Network Classic
    Use the rhn-channel command, or the Red Hat Network Web Interface, to remove the Red Hat Enterprise Virtualization Manager (v.3.1 x86_64) channels.
    # rhn-channel --remove --channel=rhel-6-server-rhevm-3.1
  3. Update the rhevm-setup Package

    To ensure that you have the most recent version of the rhevm-upgrade command installed you must update the rhevm-setup package. Log in as the root user and use yum to update the rhevm-setup package.
    # yum update rhevm-setup
  4. Run the rhevm-upgrade Command

    To upgrade Red Hat Enterprise Virtualization Manager run the rhevm-upgrade command. You must be logged in as the root user to run this command.
    # rhevm-upgrade
    Loaded plugins: product-id, rhnplugin
    Info: RHEV Manager 3.1 to 3.2 upgrade detected
    Checking pre-upgrade conditions...(This may take several minutes)
    
  5. If the ipa-server package is installed then an error message is displayed. Red Hat Enterprise Virtualization Manager 3.2 does not support installation on the same machine as Identity Management (IdM).
    Error: IPA was found to be installed on this machine. Red Hat Enterprise Virtualization Manager 3.2 does not support installing IPA on the same machine. Please remove ipa packages before you continue.
    
    To resolve this issue you must migrate the IdM configuration to another system before re-attempting the upgrade. For further information see https://access.redhat.com/knowledge/articles/233143.
Result
Your Red Hat Enterprise Virtualization Manager installation has now been upgraded. To take full advantage of all Red Hat Enterprise Virtualization 3.2 features you must also:
  • Ensure that all of your virtualization hosts are up to date and running the most recent Red Hat Enterprise Linux packages or Hypervisor images.
  • Change all of your clusters to use compatibility version 3.2.
  • Change all of your data centers to use compatibility version 3.2.