Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 5. Updating Red Hat Hyperconverged Infrastructure

Updating involves moving from one version of a product to another minor release of the same product version, for example, from Red Hat Virtualization 4.1 to 4.1.3.

Red Hat recommends updating your systems regularly to apply security and bug fixes and take advantage of minor enhancements that are made available between major product releases.

5.1. Update workflow
Copy link

Red Hat Hyperconverged Infrastructure is a software solution comprised of several different components. Apply updates in the following order to minimize disruption.

  1. Hosted Engine virtual machine
  2. Physical hosts

5.2. Before you update
Copy link

  • Ensure that your Hosted Engine virtual machine is subscribed to the rhel-7-server-rhvh-4-rpms and rhel-7-server-rhv-4-tools-rpms repositories. 

    # subscription-manager repos --enable=rhel-7-server-rhv-4.1-rpms
# subscription-manager repos --enable=rhel-7-server-rhv-4-tools-rpms
    Copy to Clipboard Toggle word wrap

  • Ensure that all physical machines are subscribed to the rhel-7-server-rhvh-4-rpms repository. 

    # subscription-manager repos --enable=rhel-7-server-rhv-4-rpms
    Copy to Clipboard Toggle word wrap

  • If geo-replication is configured, ensure that data is not being synchronized.

    1. Check the Tasks subtab and ensure that there are no ongoing tasks related to Data Synchronization. If data synchronization tasks are present, wait until they are complete before beginning the update.

    2. Stop all geo-replication sessions so that synchronization will not occur during the update. Click the Geo-replication subtab and select the session that you want to stop, then click Stop.

      Alternatively, run the following command to stop a geo-replication session. 

      # gluster volume geo-replication MASTER_VOL SLAVE_HOST::SLAVE_VOL stop
      Copy to Clipboard Toggle word wrap

5.3. Updating the Hosted Engine virtual machine
Copy link

Follow the steps in the following section of the Red Hat Virtualization Upgrade Guide to update the Hosted Engine virtual machine: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html/upgrade_guide/chap-updates_between_minor_releases#Upgrading_between_Minor_Releases

5.4. Updating the physical hosts
Copy link

Follow the steps in the sections linked below to update the physical hosts one at a time.

Between updates, ensure that you wait for any heal operations to complete before updating the next host. You can view heal status in the Bricks subtab. Alternatively, run the following command for every volume, and ensure that Number of entries: 0 is displayed for each brick before updating the next host. 

# gluster volume heal VOLNAME info
Copy to Clipboard Toggle word wrap

Most updates can be applied using Red Hat Virtualization Manager. Follow the steps in the following section of the Red Hat Virtualization Upgrade Guide to update the physical host machines one at a time: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html/upgrade_guide/updating_virtualization_hosts.

If you need to apply a security fix, apply updates manually instead. Follow the steps in the following section of the Red Hat Virtualization Upgrade Guide: https://access.redhat.com/documentation/en-us/red_hat_virtualization/4.1/html/upgrade_guide/Manually_Updating_Virtualization_Hosts

Important

Remember to move your hosts out of maintenance mode when their updates have been applied by running the following command: 

# hosted-engine --set-maintenance --mode=none
Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat