Tech:GlusterFS

From Miraheze Meta, Miraheze's central coordination wiki
(Redirected from Tech:NFS)



GlusterFS is an open-source network filesystem solution. It is no longer used on Miraheze and has been replaced by Swift.

Probe server[edit | edit source]

  • gluster peer probe <server>.miraheze.org

To setup a volume[edit | edit source]

You need to run the following to set up a volume (only required if this is a new cluster)

  • gluster volume create <vol-name> transport tcp <server>.miraheze.org:/path force

Note: Please do the ssl step if you create a new volume.

To setup ssl (and set the path)[edit | edit source]

(This is only needed for new clusters)

(You have to make sure the volume is stopped beforehand which you can do gluster volume stop <vol-name>)

  • gluster volume set prodvol ssl.private-key /etc/ssl/private/wildcard.miraheze.org.key
  • gluster volume set prodvol ssl.own-cert /etc/ssl/certs/wildcard.miraheze.org.crt
  • gluster volume set prodvol ssl.ca-list /etc/ssl/certs/Sectigo.crt

You also need to do touch /var/lib/glusterd/secure-access on gluster nodes & the client to enable TLS on the Management Path.

Adding new bricks to existing cluster[edit | edit source]

Make sure that the gluster node is added to firewall.yaml in the puppet module.

Also, make sure you do the "Probe server" step before doing the below step.

  • Run gluster volume add-brick <vol name> <brick host>:<path> force

Adding clients[edit | edit source]

You need to add the client to the firewall, which you can do by adding it to [1].

  • You can then use gluster::mount.

Getting volume info[edit | edit source]

  • Run gluster volume info

Stopping and starting the volume[edit | edit source]

  • To stop the volume run gluster volume stop <vol-name>.
  • To start the volume run gluster volume start <vol-name>.

Getting help for gluster commands[edit | edit source]

  • Run the following gluster help.
  • You can also run the following gluster <name> help