Chapter 6. Upgrading to Red Hat Enterprise Virtualization 3.1

6.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.1
6.2. Changing the Cluster Compatibility Version
6.3. Changing the Data Center Compatibility Version

6.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.1

Summary

Upgrading Red Hat Enterprise Virtualization Manager to version 3.1 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 2.2 must migrate to Red Hat Enterprise Virtualization 3.0 before attempting this upgrade. For information on migrating from Red Hat Enterprise Virtualization 2.2 to Red Hat Enterprise Virtualization 3.0, refer to https://access.redhat.com/knowledge/techbriefs/migrating-red-hat-enterprise-virtualization-manager-version-22-30.

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 6.1. Upgrading to Red Hat Enterprise Virtualization Manager 3.1

Add JBoss Enterprise Application Platform 6 Subscription
Ensure that the system is subscribed to the required channels and entitlements to recieve JBoss Enterprise Application Platform 6 packages. JBoss Enterprise Application Platform 6 is a required dependency of Red Hat Enterprise Virtualization Manager 3.1.
Certificate-based Red Hat Network
The JBoss Enterprise Application Platform 6 packages are provided by the JBoss Enterprise Application Platform entitlement in certificate-based Red Hat Network.
Use the subscription-manager command to ensure that the system is subscribed to the JBoss Enterprise Application Platform entitlement.
```
# subscription-manager list
```
Red Hat Network Classic
The JBoss Enterprise Application Platform 6 packages are provided by the JBoss Application Platform (v 6) for 6Server x86_64 channel, also referred to as jbappplatform-6-x86_64-server-6-rpm, in Red Hat Network Classic. The Channel Entitlement Name for this channel is JBoss Enterprise Application Platform (v 4, zip format).
Use the rhn-channel command, or the Red Hat Network Web Interface, to subscribe to the JBoss Application Platform (v 6) for 6Server x86_64 channel.
Add Red Hat Enterprise Virtualization 3.1 Subscription
Ensure that the system is subscribed to the required channels and entitlements to recieve Red Hat Enterprise Virtualization Manager 3.1 packages. This procedure assumes that the system is already subscribed to required channels and entitlements to receive Red Hat Enterprise Virtualization 3.0 packages. These must also be available to complete the upgrade process.
Certificate-based Red Hat Network
The Red Hat Enterprise Virtualization 3.1 packages are provided by the rhel-6-server-rhevm-3.1-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 --enablerepo=rhel-6-server-rhevm-3.1-rpms
```
Red Hat Network Classic
The Red Hat Enterprise Virtualization 3.1 packages are provided by the Red Hat Enterprise Virtualization Manager (v.3.1 x86_64) channel, also referred to as rhel-x86_64-server-6-rhevm-3.1 in Red Hat Network Classic.
Use the rhn-channel command, or the Red Hat Network Web Interface, to subscribe to the Red Hat Enterprise Virtualization Manager (v.3.1 x86_64) channel.
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
```

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.0 to 3.1 upgrade detected
Checking pre-upgrade conditions...(This may take several minutes)

If the ipa-server package is installed then an error message is displayed. Red Hat Enterprise Virtualization Manager 3.1 does not support installation on the same machine as Idenity, Policy, Audit (IPA).
```
Error: IPA was found to be installed on this machine. Red Hat Enterprise Virtualization Manager 3.1 does not support installing IPA on the same machine. Please remove ipa packages before you continue.
```
To resolve this issue you must migrate the IPA configuration to another system before re-attempting the upgrade. For further information see https://access.redhat.com/knowledge/articles/233143.
A list of packages that depend on JBoss Enterprise Application Platform 5 is displayed. These packages must be removed to install JBoss Enterprise Application Platform 6, required by Red Hat Enterprise Virtualization Manager 3.1.
```
 Warning: the following packages will be removed if you proceed with the upgrade:

    * objectweb-asm

 Would you like to proceed? (yes|no):
```
You must enter yes to proceed with the upgrade, removing the listed packages.

Result

Your Red Hat Enterprise Virtualization Manager installation has now been upgraded. To take full advantage of all Red Hat Enterprise Virtualization 3.1 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.1.
Change all of your data centers to use compatibility version 3.1.