Note: This bug is displayed in read-only format because the product is no longer active in Red Hat Bugzilla.

Bug 994235

Summary: [DOCS] Clarification on how to upgrade to 3.2 compatibility mode with running VMs
Product: Red Hat Enterprise Virtualization Manager Reporter: Robert McSwain <rmcswain>
Component: DocumentationAssignee: Jodi Biddle <jbiddle>
Status: CLOSED CURRENTRELEASE QA Contact: ecs-bugs
Severity: unspecified Docs Contact:
Priority: unspecified    
Version: 3.2.0CC: acathrow, alyoung, sfolkwil, yeylon
Target Milestone: ---   
Target Release: ---   
Hardware: Unspecified   
OS: Unspecified   
Whiteboard:
Fixed In Version: Doc Type: Bug Fix
Doc Text:
Story Points: ---
Clone Of: Environment:
Last Closed: Type: Bug
Regression: --- Mount Type: ---
Documentation: --- CRM:
Verified Versions: Category: ---
oVirt Team: --- RHEL 7.3 requirements from Atomic Host:
Cloudforms Team: --- Target Upstream Version:
Embargoed:

Description Robert McSwain 2013-08-06 19:55:41 UTC
Description of problem:
The documentation (https://access.redhat.com/site/documentation/en-US/Red_Hat_Enterprise_Virtualization/3.1/html-single/Administration_Guide/index.html#Changing_the_Cluster_Compatibility_Version) shows how to upgrade to 3.2 compatibility mode, however it does not describe what the process is if there are running guests in that cluster. The solution https://access.redhat.com/site/solutions/199463 explains that it is not detrimental to the VMs to change the compatibility mode while the VMs are running. They simply need to be migrated off the host, put the host in maintenance mode, change the compatibility, and repeat for other hosts in the cluster. 

Version-Release number of selected component (if applicable):
RHEV 3.2

How reproducible:
N/A - Documentation

Steps to Reproduce:
N/A - Documentation

Comment 1 Robert McSwain 2013-10-01 13:43:31 UTC
Tim,

I'm not sure how I saw the NeedInfo flag on this but there doesn't seem to be your update now, but from what I can tell your understanding is right that the process would be 

maintenance mode -> ssh root@host -> yum update -y -> exit -> take host out of
maintenance -> repeat for other hosts

and adding this to the documentation should help out with any confusions as to the process.

Comment 2 Tim Hildred 2013-10-02 05:41:04 UTC
Hey again Robert. 

In my testing, I've seen the the maintenance steps are actually not required at all. If your hosts support a compatibility level higher than the cluster they are currently in, you can just edit the cluster and change the compatibility level to whatever your hosts support. 

So, instead of adding steps, I've added prerequisites that your hosts be upgraded, and a note saying that you have to upgrade all your hosts. 

I took out the maintenance mode steps. 

Prerequisites:

    Updating Red Hat Enterprise Virtualization Hypervisors
    Updating Red Hat Enterprise Linux Virtualization Hosts 

Summary
Red Hat Enterprise Virtualization clusters have a compatibility version. The cluster compatibility version indicates the features of Red Hat Enterprise Virtualization supported by all of the hosts in the cluster. The cluster compatibilty is set according to the version of the least capable host operating system in the cluster.

Note
To change the cluster compatibility version, you must have first updated all the hosts in your cluster to a level that supports your desired compatibility level.

Comment 4 Tim Hildred 2013-10-03 00:25:03 UTC
Hey Robert,

I've looked at both the article, and what you've written, and something isn't clear to me.

"They simply need to be migrated off the host, put the host in maintenance mode, change the compatibility, and repeat for other hosts in the cluster."

To me, that sentence means:
1) Migrate running vms off of 1 host in the cluster.
2) Put that host, now with no running vms, into maintenance mode.
3) Change the compatibility of the host (using the "Edit Host" window) to the newer version.
4) Take that host out of maintenance mode.
5) Pick another host, and repeat 1-4, until you have put each host in maintenance mode, changed the compatibility at the host level, and brought it back out of maintenance mode.
6) Edit the cluster compatibility version using the "Edit Cluster" window, changing it to the newer version. 

The part that I'm confused about is, there is no way of changing the compatibility of a host from the UI. 

Does that mean that "change compatability" in the context of hosts means maintenance mode -> ssh root@host -> yum update -y -> exit -> take host out of mainteance -> repeat?

Comment 5 Tim Hildred 2013-10-03 00:26:14 UTC
Robert, something weird happened. Comment 2 is newer than comment 4, and is how I'm resolving this bug.

Comment 6 Tim Hildred 2013-10-28 00:03:02 UTC
Reassigning to Jodi Biddle (jbiddle) as I am no longer working on Red Hat Enterprise Virtualization documentation.