Most of them are outdated, but provide historical design context.
They are not user documentation and should not be treated as such.
Documentation is available here.
The upgrade flow is centered arount a new cluster upgrade policy called ’ InClusterPolicy’ which consists of the InClusterUpgradeFilterPolicyUnit and the InClusterUpgradeWeightPolicyUnit. When these two policy units are activated, it should be save to mix different major host OS versions. VMs will only migrate to newer hosts and will not migrate back. To allow the activation of these policy units, some preconditions have to be met which are described later.
Filter - InClusterUpgradeFilterPolicyUnit
The filter is responsible for filtering out all hosts which run older OS versions than the host the VM is currently running on. In other words, the filter forbids downgrades. So a VM which is running on Fedora 22 can migrate to Fedora 22 or Fedora 23 but not to Fedora 21. Once it is on a Fedora 23 host, only other Fedora 23 hosts are viable targets. When a VM was shut down, it can start on any host in the cluster.
Weight - InClusterUpgradeWeightPolicyUnit
The weight policy unit gives an OS which is newer than the OS where the VM is currently running on no penalty. It penalizes OS versions significantly which are running the same OS versions. Finally older OS versions are penalized even more. The policy makes sure that hosts with newer major versions of an OS will be preferred when a VM is migrating or started.
Overview of activated and deactivated features
|EmulatedMachineFilter||keep||Has no fixed uuid|
|HostedEngineHAClusterWeight||disabled, HE is out of scope|
|CpuPinningPolicy||disabled (not yet merged)|
|NumaPinningPolicy||disabled (not yet merged)|
Preconditions to allow policy activation
- No suspended VMs are allowed in the cluster
- No CPU pinning on any VM in the cluster
- No NUMA pinning on any VM in the cluster
- No preferred hosts with migration strategy “No migrations allowed” on any VM in the cluster
- No PCI pass through on any VM in the cluster
Limitations during upgrade
- Suspending VMs is forbidden
- HA reservation for VMs is disabled. But the engine will still try to restart HA VMs if they are failing
- Affinity Groups will not be respected. After the upgrade is done the Affiniy Rules Enforcement Manager will reestablish them
- No load balancing will happen
- Migrating a VM back to an older OS version is not possible during upgrade. To run a VM on an older host OS, the VM hast to be stopped first.
Since affinity will be ignored through the upgrade process, the affinity rules enforcement manager will be disabled.
Upgrade Flow from 3.5 to 3.6
- Enable the upgrade mode with
engine-config -s CheckMixedRhelVersions=false --cver=3.5(This allows to set the InClusterUpgrade policy).
- Restart the engine
- Set the InClusterUpgrade Policy on the desired cluster (this allows mixing different major host OS versions)
- When saving this cluster configuration change a lot of checks are happening. They are making sure that all preconditions as described above are met
- If setting the policy fails, resolve the mentioned issue and try again
- Move a host X to maintenance (If this is the 2nd+ host some VMs will move to el7 machines)
- If needed, pre-migrate VMs manually as a precaution
- Upgrade host in place (fedup style) to el7 and reboot to get the new kernel or just install a new image
- Activate (fedup) or Reinstall (new image) the host in the engine (should move to ‘up’).
- Go to step 4 until all hosts upgraded for this cluster and then reset the scheduling policy.
- Increase cluster level to 3.6.
- Go to step 3 and repeat for all clusters.
- Disable the config from step 1 with
engine-config -s CheckMixedRhelVersions=true --cver=3.5.
- Restart the engine