Chapter 4. Upgrading Red Hat Gluster Storage Web Administration

4.1. Red Hat Gluster Storage Web Administration 3.3 to 3.4

This chapter describes the procedure to upgrade Web Administration to version 3.4.0 from previous versions.

To upgrade your Web Administration environment to version 3.4, execute the following actions on the Gluster nodes and the Web Administration server:

On Gluster storage nodes

  1. Stop and disable all Web Administration services on storage nodes.
  2. Enable the Ansible repository and ensure the other required repositories are enabled.
  3. Upgrade Red Hat Gluster Storage to version 3.4.0.

On Web Administration server

  1. Reinstall Red Hat Enterprise Linux on the Web Administration Server.
  2. Install Web Administration 3.4.0
  3. Import the Gluster 3.4.0 cluster.

On Gluster storage nodes

Stopping and disabling Web Administration Services

Stop and disable the following services on the storage nodes by executing the commands given below.

To stop and disable the tendrl-node-agent service:

# systemctl stop tendrl-node-agent
# systemctl disable tendrl-node-agent

To stop and disable the collectd service:

# systemctl stop collectd
# systemctl disable collectd

To stop and disable the tendrl-gluster-integration service:

# systemctl stop tendrl-gluster-integration
# systemctl disable tendrl-gluster-integration
Note

The tendrl-node-agent service is enabled and started during execution of the tendrl-ansible site.yml playbook. The collectd and tendrl-gluster-integration services are enabled and started after importing a cluster into the Web Administration environment.

Enabling Web Administration Repositories

Enable the Ansible repository by running the following command:

# subscription-manager repos --enable=rhel-7-server-ansible-2-rpms

Additionally, ensure that the other required Web Administration repositories are enabled. Run the following command to check if all the required repositories are enabled:

# yum repolist
Note

To check the required repositories, see the Prerequisites section of the Quick Start Guide.

After the repositories are enabled, clear yum cache:

# yum clean all

Upgrading Red Hat Gluster Storage

After enabling the required repositories, upgrade your Red Hat Gluster Storage environment to 3.4. For detailed upgrade instructions, see the Upgrading to Red Hat Gluster Storage 3.4 chapter in the Red Hat Gluster Storage 3.4 Installation Guide. After a successful upgrade, resume the following steps.

On Web Administration server

Reinstalling Red Hat Enterprise Linux on the Web Administration Server After upgrading Red Hat Gluster Storage, reinstall Red Hat Enterprise Linux on the host system. For detailed installation instructions, see the Red Hat Enterprise Linux Installation Guide.

Installing Web Administration

After reinstalling Red Hat Enterprise Linux, install Web Administration and its associated components on the Web Administration server and the Gluster Storage servers using tendrl-ansible.

Note

The Web Administration components already installed on the Gluster Storage servers will be reconfigured for the new installation. For detailed instructions on installation, see Chapter 3. Installing Web Administration, the preceding chapter of this Guide.

After installation, import the Gluster 3.4 cluster in the Web Administration environment. For detailed import procedure, see the Import Cluster chapter of the Web Administration 3.4 Monitoring Guide.

4.2. Red Hat Gluster Storage Web Administration 3.4.x to 3.4.y

This chapter describes the procedure to update Web Administration from version 3.4.x to 3.4.y.

Note

The Web Administration update path outlined here is part of the overall Red Hat Gluster Storage offline update. Updating Web Administration as a standalone component is not supported. Execute the Web Administration update procedure as per the update sequence outlined in the 7.2. Updating Red Hat Gluster Storage in the Offline Mode section of the Red Hat Gluster Storage Installation Guide.

To update your Web Administration environment to version 3.4.y, follow the steps outlined below.

On Red Hat Gluster Storage Servers (Part I):

  1. Stop all Web Administration services.

    1. To stop the tendrl-gluster-integration service:

      # systemctl stop tendrl-gluster-integration
    2. To stop the tendrl-node-agent service:

      # systemctl stop tendrl-node-agent
    3. To stop the collectd service:

      # systemctl stop collectd
  2. Follow the steps from 1 - 9 under the heading Updating Red Hat Gluster Storage 3.4 in the offline mode in the 7.2. Updating Red Hat Gluster Storage in the Offline Mode section of the Red Hat Gluster Storage Installation Guide.

After executing all the steps from step 1 to step 9 under 7.2. Updating Red Hat Gluster Storage in the Offline Mode, return to this section and continue with the following steps.

On Web Administration Server:

  1. Stop all Web Administration services:

    1. To stop the tendrl-monitoring-integration service:

      # systemctl stop tendrl-monitoring-integration
    2. To stop the tendrl-node-agent service:

      # systemctl stop tendrl-node-agent
    3. To stop the tendrl-notifier service:

      # systemctl stop tendrl-notifier
    4. To stop the tendrl-api service:

      # systemctl stop tendrl-api
  2. Update all packages on the Web Administration server:

    # yum update
  3. Run the tendrl-upgrade script:

    # tendrl-upgrade
  4. Run the tendrl-ansible playbooks with the same initial installation configuration. For instructions, see section 3.3. Web Administration Installation, steps 2 to 9.
  5. If updates to the kernel package occurred, reboot the server system. If not, restart the Web Administration services:

    # systemctl restart httpd
    # systemctl restart tendrl-node-agent
    # systemctl restart tendrl-monitoring-integration
    # systemctl restart tendrl-notifier
    # systemctl restart tendrl-api

On Red Hat Gluster Storage servers (Part II):

  1. Restart the following Web Administration services:
# systemctl restart tendrl-node-agent
# systemctl restart tendrl-gluster-integration
# systemctl restart collectd

After successful completion of all the steps, your Red Hat Gluster Storage and Web Administration environment should be updated to the latest version.

Important

It is required to clear your web browser cache data after the Web Administration Update process is complete. This action is to ensure all the new changes featured in the new version are reflected in the updated Web Administration environment.