GlusterFS Operations

Gluster shared storage filesystem operations

This document provides information on how to check and view Gluster shared storage filesystem configured within the cfxDimensions platform.

Run the below command to see Gluster mount point on any of the cfxDimensions platform VM. (Login as 'macaw' user using any SSH client to access the CLI)

The configured Gluster volume name is 'macaw' and it is mounted on all of the cfxDimensions platform VMs as /opt/macaw (Platform, Infrastructure (DB/Data), Application services & cLambda)

df -h

The Gluster volume is configured to mount as /opt/macaw using the below mount options. Please refer /etc/fstab

defaults,backup-volfile-servers=192.168.186.152:192.168.186.153,_netdev,noauto,x-systemd.automount 0 0

backup-volfile-servers: This option is used by the Gluster client while mounting the volume, when the primary Gluster node is not available, it will try backup Gluster node to fetch the volume's metadata and complete the mount operation.

noauto & x-systemd.automount: 'noauto' option is used not to mount during boot-up time automatically. However, it is used along with x-systemd.automount option which enables to mount the Gluster volume automatically on access by client service. This is similar to AutoFS feature of NFS shares.

Login as 'macaw' user into one of the cfxDimensions platform VM on which Gluster is installed. You can get Gluster host information using the below command

macaw status

Gluster Host:

Run the below command to get the container ID of the Gluster service after logging into the host in which it is deployed.

docker ps | grep -i gluster

The below command lists all of the Gluster peer (cluster nodes) members. It should show all three members of the Gluster.

docker exec <gluster-container-id> gluster pool list

The below command provides Gluster volume information which is being configured and used within the cfxDimensions platform.

The configured Gluster volume name is 'macaw' and it is mounted on all of the cfxDimensions platform VMs as /opt/macaw (Platform, Infrastructure (DB/Data), Application services & cLambda)

docker exec <gluster-container-id> gluster volume info

The below command provides Gluster volume 'macaw' status.

docker exec <gluster-container-id> gluster volume status

The below command provides Gluster volume 'macaw' status in detail (verbose).

docker exec <gluster-container-id> gluster volume macaw detail

Below command provides insight into Gluster volume 'macaw' "heal" status when one of the Gluster is rebooted or recovered from a crash.

Gluster node joins the cluster on reboot and syncs the data automatically from it's peer node.

docker exec <gluster-container-id> gluster volume heal macaw info summary