5.3. Upgrading a Self-Hosted Engine Environment
/var/tmpdirectory contains 5 GB free space to extract the appliance files. If it does not, you can specify a different directory or mount alternate storage that does have the required space. The VDSM user and KVM group must have read, write, and execute permissions on the directory.
- Place the high-availability agents that manage the Manager virtual machine into global maintenance mode.
- Upgrade the Manager virtual machine.
- Place a self-hosted engine node into maintenance. The Manager virtual machine and other virtual machines will be migrated to another host in the cluster if necessary.
- Update the self-hosted engine node. Repeat for all hosts. Red Hat recommends updating all hosts in the environment, including standard hosts.
- After all hosts in the cluster and the Manager virtual machine have been upgraded, change the cluster compatibility version to 4.1.
Procedure 5.4. Upgrading a Self-Hosted Engine Environment
- Disable the high-availability agents on all the self-hosted engine nodes. In the Hosts tab, right-click a self-hosted engine node and select Enable Global HA Maintenance.After a few minutes, check that the General tab in the details pane reports Hosted Engine HA: Global Maintenance Enabled to confirm that the environment is in maintenance mode.
- Log in to the Manager virtual machine to upgrade the Red Hat Virtualization Manager.
- Enable the Red Hat Virtualization Manager 4.1 and Red Hat Virtualization Tools repositories:
# subscription-manager repos --enable=rhel-7-server-rhv-4.1-rpms # subscription-manager repos --enable=rhel-7-server-rhv-4-tools-rpms
- Update the setup packages:
# yum update ovirt\*setup\*
engine-setupand follow the prompts to upgrade the Red Hat Virtualization Manager:
- Remove or disable the Red Hat Virtualization Manager 4.0 repository to ensure the system does not use any Red Hat Virtualization Manager 4.0 packages:
# subscription-manager repos --disable=rhel-7-server-rhv-4.0-rpms
- Update the base operating system:
# yum update
ImportantIf any kernel packages were updated, reboot the Manager virtual machine manually to complete the update. See Troubleshooting the Manager Virtual Machine.
- Disable global maintenance. In the Administration Portal, click the Hosts tab. Right-click a self-hosted engine node and select Disable Global HA Maintenance.
- Update the self-hosted engine nodes, then any standard hosts in the environment:
- In the Administration Portal, click the Hosts tab. Right-click a host and select → to place the host into local maintenance. If the host is hosting the Manager virtual machine, the virtual machine will be migrated to another host. Any other virtual machines will be migrated according to your virtual machine migration policy. The high-availability agents are automatically placed into local maintenance.
- Ensure the correct repository is enabled:
# subscription-manager repos --enable=rhel-7-server-rhv-4-mgmt-agent-rpms # subscription-manager repos --enable=rhel-7-server-ansible-2-rpms
- Update the host:
- On a Red Hat Enterprise Linux host, log in to the host machine and run the following command:
# yum update
- On a Red Hat Virtualization Host (RHVH), log in to the Cockpit user interface, click Terminal, and run the following command:
# yum update
ImportantIf any kernel packages were updated, reboot the host to complete the update.
- Select the same host and click→ .
- Repeat these steps to update all hosts.
- Update the cluster and data center compatibility version to 4.1. See Post-Upgrade Tasks in the Upgrade Guide for more information.
ImportantOnly update the compatibility version if all hosts have been updated for Red Hat Virtualization 4.1 to avoid some hosts becoming non-operational.