Chapter 5. Update between minor releases To update the current version of Red Hat Hyperconverged Infrastructure for Virtualization 1.8 to the latest version, follow the steps in this section. 5.1. Update workflow Red Hat Hyperconverged Infrastructure for Virtualization is a software solution comprising several different components. Update the components in the following order to minimize disruption to your deployment: Prepare the systems to be updated. Updating the Hosted Engine virtual machine and Red Hat Virtualization Manager 4.4. Update the hyperconverged hosts. 5.2. Preparing the systems to update This section describes the steps to prepare the systems for the update procedure. 5.2.1. Update subscriptions You can check which repositories a machine has access to by running the following command as the root user on the Hosted Engine Virtual Machine: Verify that the Hosted Engine virtual machine is subscribed to the following repositories: rhel-8-for-x86_64-baseos-rpms rhel-8-for-x86_64-appstream-rpms rhv-4.4-manager-for-rhel-8-x86_64-rpms fast-datapath-for-rhel-8-x86_64-rpms jb-eap-7.4-for-rhel-8-x86_64-rpms openstack-16.2-cinderlib-for-rhel-8-x86_64-rpms rhceph-4-tools-for-rhel-8-x86_64-rpms Verify that the Hyperconverged host (Red Hat Virtualization Node) is subscribed to the following repository: rhvh-4-for-rhel-8-x86_64-rpms See Enabling the Red Hat Virtualization Manager Repositories for more information on subscribing to the above mentioned repositories. 5.2.2. Verify that data is not currently being synchronized using geo-replication Perform the following steps to check if geo-replication is in progress: Click the Tasks tab at the bottom right of the Manager. Ensure that there are no ongoing tasks related to data synchronization. If data synchronization tasks are present, wait until they are complete before starting the update process. Remove all the scheduled geo-replication sessions so that synchronization will not occur during the update. Click Storage Domains Select the domain and click on the domain name. Click the Remote Data Sync Setup tab Setup button. New dialog window to set the geo-replication schedule pops-up,set the recurrence to None . 5.3. Updating the Hosted Engine virtual machine and Red Hat Virtualization Manager 4.4 This section describes the steps to update the Hosted Engine Virtual Machine and the Red Hat Virtualization Manager 4.4 to move towards updating the hyperconverged hosts. 5.3.1. Updating the Hosted Engine virtual machine Place the cluster into Global Maintenance mode. Log in to the Web Console of one of the hyperconverged nodes. Click Virtualization Hosted Engine . Click Put this cluster into global maintenance . On the Manager machine, check if updated packages are available. Log in to the Hosted Engine Virtual Machine and run the following command: 5.3.2. Updating the Red Hat Virtualization Manager Log in to the Hosted Engine virtual machine. Upgrade the setup packages using the following command: Update the Red Hat Virtualization Manager with the engine-setup script. The engine-setup script performs the following tasks: Prompts you with configuration questions. Stops the ovirt-engine service. Downloads and installs the updated packages. Backs up and updates the database. Performs post-installation configuration, Starts the ovirt-engine service. Run the engine-setup script and follow the prompts to upgrade the Manager. This process can take a while and cannot be aborted, Red Hat recommends running it inside a tmux session. When the script completes successfully, the following message appears: Execution of setup completed successfully. Important The update process might take some time. Do not stop the process before it completes. Upgrade all other packages. Important If any kernel packages are updated: Disable global maintenance mode Reboot the machine to complete the update. Remove the cluster from Global Maintenance mode. Log in to the Web Console of one of the hyperconverged nodes Click Virtualization Hosted Engine . Click Remove this cluster from maintenance . 5.4. Upgrading the hyperconverged hosts The upgrade process differs depending on whether your nodes use Red Hat Virtualization version 4.4.1 or version 4.4.2. Use the following command to verify which version you are using: Then follow the appropriate process for your version: Upgrading from Red Hat Virtualization 4.4.2 and later Upgrading from Red Hat Virtualization 4.4.1 and earlier 5.4.1. Upgrading from Red Hat Virtualization 4.4.2 and later Upgrade each hyperconverged host in the cluster, one at a time. For each hyperconverged host in the cluster: Upgrade the hyperconverged host. In the Manager, click Compute Hosts and select a node. Click Installation Upgrade . Click OK to confirm the upgrade. The node is upgraded and rebooted. Verify self-healing is complete. Click the name of the host. Click the Bricks tab. Verify that the Self-Heal Info column shows OK beside all bricks. Update cluster compatibility settings to ensure you can use new features. Log in to the Administrator Portal. Click Cluster and select the cluster name ( Default ). Click Edit . Change Cluster compatibility version to 4.6 . Important Cluster compatibility is not completely updated until the virtual machines have been rebooted. Schedule a maintenance window and move any application virtual machines to maintenance mode before rebooting all virtual machines on each node. Click Compute Data Centers . Click Edit . Change Compatibility version to 4.6 . Update data center compatibility settings to ensure you can use new features. Select Compute Data Centers . Select the appropriate data center. Click Edit . The Edit Data Center dialog box opens. Update Compatibility Version to 4.6 from the dropdown list. 5.4.2. Upgrading from Red Hat Virtualization 4.4.1 and earlier In the Manager, click Compute Hosts and select a node. Click Installation Check for Upgrade. This will trigger a background check on that host for the presence of host update. Once the update is available, there will be a notification to the host about the availability of host update. Move the host to maintenance mode . On the RHV Administration Portal, navigate to Hosts Select the host. Click on Management Maintenance Maintenance Host dialog box opens. On the Maintenance Host dialog box, check the Stop Gluster service box click OK . Once the host is in maintenance mode , click Installation Upgrade . Upgrade Host dialog box opens, make sure to un-check Reboot host after upgrade . Click OK to confirm the upgrade. Wait for the upgrade to complete. Remove the existing LVM filter on the upgraded host before rebooting by using the following command: Reboot the host. Once the host is rebooted, regenerate the LVM filter: Verify self-healing is complete before upgrading the host. Click the name of the host. Click the Bricks tab. Verify that the Self-Heal information column of all bricks is listed as OK before upgrading the host. Repeat the above steps on the other hyperconverged hosts. Update cluster compatibility settings to ensure you can use new features. Log in to the Administrator Portal. Click Cluster and select the cluster name ( Default ). Click Edit . Change Cluster compatibility version to 4.6 . Important Cluster compatibility is not completely updated until the virtual machines have been rebooted. Schedule a maintenance window and move any application virtual machines to maintenance mode before rebooting all virtual machines on each node. Click Compute Data Centers . Click Edit . Change Compatibility version to 4.6 . Update data center compatibility settings to ensure you can use new features. Select Compute Data Centers . Select the appropriate data center. Click Edit . The Edit Data Center dialog box opens. Update Compatibility Version to 4.6 from the dropdown list. Important Disable the gluster volume option cluster.lookup-optimize on all the gluster volumes after the update. Troubleshooting The self healing process should start automatically once each hyperconverged host comes up after a reboot. Check for self-heal status using the command: If there are pending self-heal entries for a long time, check the following: Gluster network is up. All brick processes in the volume are up. If there are any brick processes reported to be down, restart the glusterd service on the node where the brick is reported to be down: If the Red Hat Virtualization node is unable to boot and drops in to maintenance shell , then one of the reasons is due to the unstable LVM filter rejecting some of the physical volumes (PVs). Log into the maintenance shell with the root password. Remove the existing LVM filter configuration: Reboot the host. Once the node is up, regenerate the LVM filter:

Commands:
subscription-manager repos --list-enabled
engine-upgrade-check
yum update ovirt-engine\*setup\* rh\*vm-setup-plugins
engine-setup
yum update
cat /etc/os-release | grep "PRETTY_NAME"
sed -i /^filter/d /etc/lvm/lvm.conf
vdsm-tool config-lvm-filter -y
for volume in `gluster volume list`; do gluster volume set USDvolume cluster.lookup-optimize off; done
gluster volume heal <volname> info summary
ip addr show <ethernet-interface>
gluster volume status <vol>
systemctl restart glusterd
sed -i /^filter/d /etc/lvm/lvm.conf
vdsm-tool config-lvm-filter -y