The Red Hat Gluster Storage Web Administration environment consists of the following system components.

On the system to be designated as the Web Administration server, verify that these recommended hardware and software requirements are available.

Ensure the following requirements are met on the Red Hat Gluster Storage node:

For detailed information on prerequisites and setting up Red Hat Gluster Storage server, see the Red Hat Gluster Storage 3.3.1 Installation Guide.

The Red Hat Gluster Storage Web Administration environment can be accessed by a client machine with the following web browser compatibility.

Red Hat Gluster Storage Web Administration uses the firewalld service, which you must configure to suit your environment.

The ports listed in this section are the default ports that must be accessible through your system’s firewall

To apply the changes immediately, reload the firewall configuration after executing the port opening commands described below:

# firewall-cmd --reload

# firewall-cmd --permanent --zone=public --add-port=2379/tcp

For Graphite:

# firewall-cmd --permanent --zone=public --add-port=2003/tcp

For Graphite Web:

# firewall-cmd --permanent --zone=public --add-port=10080/tcp

For tendrl HTTP:

# firewall-cmd --permanent --zone=public --add-service=http

For tendrl-api:

# firewall-cmd --permanent --zone=public --add-port=9292/tcp

For Grafana server:

# firewall-cmd --permanent --zone=public --add-port=3000/tcp

For tendrl-monitoring-integration:

# firewall-cmd --permanent --zone=public --add-port=8789/tcp

In addition to enabling storage node ports, enable port for tendrl-gluster-integration:

# firewall-cmd --permanent --zone=public --add-port=8697/tcp

Before installing Red Hat Gluster Web Administration, ensure the following prerequisites are met:

The entire installation process goes through the following sequence:

To check if Tendrl minimal requirements and setup are satisfied, run the /usr/share/doc/tendrl-ansible-*/prechecks.yml playbook which is included in the sample playbook. If there are any problems with the prechecks.yml file then the sample site.yml file will fail, pointing you to the particular configuration problem. Running the prechecks.yml file is advisable before commencing installation.

The following procedure outlines the steps to install Web Administration the Ansible way.

[tendrl-server]
tendrl.example.com

[gluster-servers]

gl1.example.com
gl2.example.com
gl3.example.com
gl4.example.com

The tendrl-ansible installation of Web Administration does not generate and deploy encryption certificates and keys. To configure etcd TLS client-server authentication, generate and deploy encryption certificates on all the nodes of the cluster before executing tendrl-ansible based Web Administration installation.

Before setting up the Transport Layer Security (TLS ) encryption, ensure the following encryption components are generated:

After generating and placing the TLS certificate files in the preferred directory, update the value of the Ansible variables in the site.yml file with the respective file paths of the certificate files.

In the site.yml file, add and modify the etcd TLS variables.

etcd_tls_client_auth: this variable is to enable or disable TLS authentication.

etcd_cert_file: certificate used for SSL/TLS connections to etcd. When this option is set, advertise-client-urls can use the HTTPS schema.

etcd_key_file: key for the certificate which must be unencrypted.

etcd_trusted_ca_file: the trusted Certificate Authority.

The Clusters tab in the navigation pane lists all the imported clusters in a rows format. Each row shows the individual cluster attributes such as the version of the cluster, whether managed or unmanaged and the status of Volume Profiling whether enabled or disabled.

Figure 6.2. Clusters View

Accessing Monitoring Dashboard

The Clusters tab provides a shortcut button to access the Grafana Monitoring Dashboard. At the right hand side of a cluster row, click on Dashboard and you will be redirected to the Grafana Monitoring dashboard.

The Hosts tab in the navigation pane lists all the accepted hosts assigned to different clusters. The Hosts can be filtered by the host Name, Cluster, Role, and Status.

Figure 6.3. Hosts View

Accessing Monitoring Dashboard

The Hosts tab provides a shortcut button to access the Grafana Monitoring Dashboard. At the right hand side of a Host row, click on Dashboard, and you will be redirected to the Grafana Monitoring dashboard.

The Events view lists all the events occurred in the system. The events sent to the Events view interface of the Web Administration are not resent as notifications via SMTP or SNMP.

Figure 6.4. Events View

The Web Administration consists of a sizeable number of user-initiated actions to accomplish operations such as importing clusters. It is crucial for Web Administration users to monitor and view the status of the actions they initiated.

A user can view the following task information:

Figure 6.5. Tasks View

The Users tab lists all the users created to access the Web Administration interface. The interface provides user tasks such as adding, editing and deleting a user. For more user administration actions, see the Managing Users and Roles section in the Red Hat Gluster Storage Web Administration Monitoring Guide.

To view system-wide severe and critical alerts and to change the user password, a menubar is available at the top right corner of the interface.

To view system-wide alerts, click on the bell icon at the top left menubar of the interface.

Changing User Password

To change the user password:

Signing out from the interface

To signout from the interface: