Chapter 7. Updating Red Hat Gluster Storage from 3.4.x to 3.4.y

A software update is a minor release that includes bug fixes for features, software enhancements, etc. Red Hat strongly recommends you update your Red Hat Gluster Storage software regularly with the latest security patches and upgrades.
To keep your Red Hat Gluster Storage system up-to-date, associate the system with the Red Hat Network or your locally-managed content service. This ensures your system automatically stays up-to-date with security patches and bug fixes.
Be aware of the following when updating your Red Hat Gluster Storage 3.4 installation:
  • This is an update between minor releases of the same major product version. If you want to upgrade between major product versions, see Chapter 8, Upgrading to Red Hat Gluster Storage 3.4.
  • Asynchronous errata update releases of Red Hat Gluster Storage include all fixes that were released asynchronously since the last release as a cumulative update.
  • When a Red Hat Gluster Storage server node that hosts a very large number of bricks or snapshots is updated, cluster management commands may become unresponsive as glusterd attempts to start all brick processes concurrently for all bricks and snapshots. If you have more than 250 bricks or snapshots being hosted by a single node, Red Hat recommends deactivating snapshots until the update is complete.
  • After performing inservice upgrade of NFS-Ganesha, the new configuration file is saved as "ganesha.conf.rpmnew" in /etc/ganesha folder. The old configuration file is not overwritten during the inservice upgrade process. However, post upgradation, you have to manually copy any new configuration changes from "ganesha.conf.rpmnew" to the existing ganesha.conf file in /etc/ganesha folder.

7.1. Before you update

Make a complete backup using a reliable backup solution before you update your system. This Knowledge Base solution covers one possible approach: https://access.redhat.com/solutions/1484053.
Regardless of the approach that you use:
  • Back up to a location that is not on the operating system partition.
  • Ensure that you have sufficient space available for a complete backup.
  • Copy the .glusterfs directory before copying any data files.
  • Ensure that the following configuration directories and files are backed up.
    • /var/lib/glusterd
    • /etc/swift
    • /etc/samba
    • /etc/ctdb
    • /etc/glusterfs
    • /var/lib/samba
    • /var/lib/ctdb
    • /var/run/gluster/shared_storage/nfs-ganesha
    If you use NFS-Ganesha, also ensure that the following files from all nodes are backed up:
    • /etc/ganesha/exports/export.*.conf
    • /etc/ganesha/ganesha.conf
    • /etc/ganesha/ganesha-ha.conf
  • Ensure that all extended attributes, ACLs, owners, groups, and symbolic and hard links are backed up.
  • Ensure that no new files are created on Red Hat Gluster Storage file systems during the backup or update process.
  • Check that the backup restores correctly before you continue with the update:

Important

The Web Administration update sequence outlined below is part of the overall Red Hat Gluster Storage offline update. Updating Web Administration as a standalone component is not supported.

Red Hat Gluster Storage Web Administration Update

For Red Hat Gluster Storage Web Administration users intending to update to the latest version, see the Red Hat Gluster Storage Web Administration 3.4.x to 3.4.y section of the Red Hat Gluster Storage Web Administration Quick Start Guide for detailed steps. Follow this sequence to update your Red Hat Gluster Storage system along with the Web Administration environment:
  1. Visit the section Red Hat Gluster Storage Web Administration 3.4.x to 3.4.y and stop all Web Administration services on the Red Hat Gluster Storage servers outlined in step 1 under the heading On Red Hat Gluster Storage Servers (Part 1).
  2. Return to this section 7.2. Updating Red Hat Gluster Storage in the Offline Mode and execute the steps outlined under the heading Updating Red Hat Gluster Storage 3.4 in the offline mode.
  3. Navigate back to the Red Hat Gluster Storage Web Administration 3.4.x to 3.4.y section and perform the steps identified under On Web Administration Server and On Red Hat Gluster Storage Servers (Part II) to complete the Red Hat Gluster Storage and Web Administration update process.