Red Hat Bugzilla – Bug 994235
[DOCS] Clarification on how to upgrade to 3.2 compatibility mode with running VMs
Last modified: 2014-11-09 17:29:12 EST
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):
N/A - Documentation
Steps to Reproduce:
N/A - Documentation
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.
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.
Updating Red Hat Enterprise Virtualization Hypervisors
Updating Red Hat Enterprise Linux Virtualization Hosts
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.
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.
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?
Robert, something weird happened. Comment 2 is newer than comment 4, and is how I'm resolving this bug.
Reassigning to Jodi Biddle (email@example.com) as I am no longer working on Red Hat Enterprise Virtualization documentation.