Basic Troubleshooting and Data Gathering for Red Hat Gluster Storage Web Admin Console

Environment

Red Hat Gluster Storage 3.x

Issue

• This document intends to provide some basic troubleshooting steps to solve the most common issues faced with RHGS Web Admin console.
• In addition, it specifies the location of Web Admin logs and services that need to be running when the software is installed.

Resolution

Basic troubleshooting

1. Check WebAdmin package versions, and upgrade if required.

1.1 Packages that need to be installed in the Gluster nodes:

Latest versions of:

        tendrl-collectd-selinux             
        tendrl-commons   
        tendrl-gluster-integration      
        tendrl-node-agent            
        tendrl-selinux     

At the moment of writing, the latest package versions are:

        tendrl-collectd-selinux.noarch              1.5.4-3.el7rhgs                                                           
        tendrl-commons.noarch                       1.6.3-17.1.el7rhgs                                                        
        tendrl-node-agent.noarch                    1.6.3-18.el7rhgs                                                          
        tendrl-selinux.noarch                       1.5.4-3.el7rhgs      
        tendrl-gluster-integration.noarch           1.6.3-15.el7rhgs

To check for updates, run yum check-update 'tendrl*'

1.2 Packages that need to be installed in the WebAdmin server:

Latest versions of:

        tendrl-selinux
        tendrl-notifier
        tendrl-ansible
        tendrl-commons
        tendrl-node-agent
        tendrl-grafana-selinux
        tendrl-api
        tendrl-ui
        tendrl-monitoring-integration
        tendrl-grafana-pluginstt
        tendrl-api-httpd

At the moment of writing, the latest package versions are:

        tendrl-ansible.noarch                     1.6.3-11.el7rhgs                                                         
        tendrl-api.noarch                         1.6.3-13.el7rhgs                                                         
        tendrl-api-httpd.noarch                   1.6.3-13.el7rhgs                                                         
        tendrl-commons.noarch                     1.6.3-17.1.el7rhgs                                                       
        tendrl-grafana-plugins.noarch             1.6.3-21.el7rhgs                                                         
        tendrl-grafana-selinux.noarch             1.5.4-3.el7rhgs                                                          
        tendrl-monitoring-integration.noarch      1.6.3-21.el7rhgs                                                         
        tendrl-node-agent.noarch                  1.6.3-18.el7rhgs                                                         
        tendrl-notifier.noarch                    1.6.3-4.el7rhgs                                                          
        tendrl-selinux.noarch                     1.5.4-3.el7rhgs                                                          
        tendrl-ui.noarch                          1.6.3-15.el7rhgs                                                             

To check for updates, run yum check-update 'tendrl*'

2. Verify the required services are running.

2.1 Services that need to be running in the Gluster nodes:

    tendrl-gluster-integration
    collectd
    tendrl-node-agent

If any of these services is not running, collect the output of journalctl -xu <service name >to check for errors.

2.2 Services that need to be running in the WebAdmin host:

    etcd
    tendrl-monitoring-integration
    tendrl-api
    tendrl-notifier
    carbon-cache
    grafana-server
    tendrl-node-agent

If any of these services is not running, collect the output of journalctl -xu <service name>to check for errors.

3. Web admin log files.

3.1 Log files to be collected in the client side:

    /var/log/messages
    Directory /var/log/tendrl

3.2 Log files to be collected in the server side:

    /var/log/messages
    Directory /var/log/tendrl

Tools to solve common issues:

1. Steps to de-install WebAdmin:

1. git clone https:/github.com/shtripat/tendrl-cleanup.git

2. cd tendrl-cleanup

3. vi hosts ==> This is an inventory file that has to be created.

4. Add the following content in the hosts file (replace the example fqdn with proper fqdn)

    [gluster-servers]<br>
      gl1.example.com<br>
      gl2.example.com<br>
      gl3.example.com<br>
      gl4.example.com<br>
    [tendrl-server]<br>
      tendrl.example.com
   

5. mv site.yml.sample site.yml

6. ansible-playbook -i hosts site.yml

2. Cleanup steps when an import cluster fails:

• Check the KCS document 3740711 - Gluster Web Administration Cleanup Steps for the general procedure.

• In case that more than one cluster is being monitored by WebAdmin, and only one cluster needs to be cleaned up from the configuration, use the script available in this Content from github.com is not included.link, providing the cluster name that needs to be deleted as an argument.

This solution is part of Red Hat’s fast-track publication program, providing a huge library of solutions that Red Hat engineers have created while supporting our customers. To give you the knowledge you need the instant it becomes available, these articles may be presented in a raw and unedited form.