Documentation & Tutorials

Configure a High-Availability Storage with GlusterFS on Ubuntu 18.04 LTS

GlusterFS Overview

GlusterFS is an open-source, scalable network filesystem suitable for high data-intensive workloads such as media streaming, cloud storage, and CDN (Content Delivery Network). Each storage server will be a mirror of the other storage server, and files will be replicated automatically across both storage servers.

This tutorial shows you how to:

  1. Configure the Host File
  2. Add the GlusterFS Repository
  3. Install GlusterFS
  4. Configure GlusterFS Servers
  5. Set-up the Distributed GlusterFS Volume
  6. Configure GlusterFS Client
  7. Test Replication & Mirroring


Configuring the Host File

The first step we need to do before installing glusterfs on all servers is configuring the hosts’ file and add GlusterFS repository to each server.

1 . Log in to each server and edit the /etc/hosts file.

nano /etc/hosts

2 . Paste hosts configuration below

ip_address gluster01
ip_address gluster02
ip_address client01

3 . Save and exit

4 . Ping each server using the hostname as below

ping -c 3 gluster01
ping -c 3 gluster02
ping -c 3 client01

Note: If the ping command is not installed by default, you can install it with the apt install iputils-ping command.

Each hostname will resolve to each server IP address.

--- gluster01 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2033ms
rtt min/avg/max/mdev = 0.560/0.604/0.627/0.031 ms

--- gluster02 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2050ms
rtt min/avg/max/mdev = 0.497/0.593/0.688/0.080 ms

--- client01 ping statistics ---
3 packets transmitted, 3 received, 0% packet loss, time 2036ms
rtt min/avg/max/mdev = 0.672/0.728/0.802/0.054 ms

Adding the GlusterFS Repository

1 . Install the software-properties-common package to all systems

apt install software-properties-common -y

2 . Add the glusterfs key and repository to all systems

wget -O- | apt-key add -
add-apt-repository ppa:gluster/glusterfs-3.12

Installing GlusterFS Server

1 . Install the glusterfs server on both gluster01 and gluster02 servers.

apt install glusterfs-server -y

2 . Start the glusterd service and enable it to launch every time at system boot

systemctl start glusterd
systemctl enable glusterd

Glusterfs server is now up and running on the gluster01 and gluster02 servers.

3 . Check the services and the installed software version

systemctl status glusterd
glusterfsd --version

The command should return an active (running) status and glusterfs 3.13.2 version.

Configuring GlusterFS Servers

Glusterd services are now up and running, and the next step we will do is to configure those servers by creating a trusted storage pool and creating the distributed glusterfs volume. The first step consists of creating a trusted storage pool.

1 . From the gluster01 server, we need to add the gluster02 server to the glusterfs storage pool

gluster peer probe gluster02

The result peer probe: success is displayed. We added the gluster02 server to the storage trusted pool.

2 . Check the storage pool status and list

gluster peer status
gluster pool list

which returns

root@gluster01:~# gluster peer status
Number of Peers: 1

Hostname: gluster02
Uuid: 17e7a76f-f616-42e5-b741-63a07fd091d6
State: Peer in Cluster (Connected)
root@gluster01:~# gluster pool list
UUID					Hostname 	State
17e7a76f-f616-42e5-b741-63a07fd091d6	gluster02	Connected
ecc9cafa-b25d-477e-b6bc-403c051e752d	localhost	Connected

The gluster02 server is connected to the peer cluster, and it’s on the pool list.

After creating the trusted storage pool, we will create a new distributed glusterfs volume. We will create the new glusterfs volume based on the system directory.

Setting up the Distributed GlusterFS Volume

Note: For the server production, it’s recommended to create the glusterfs volume using the different partition, not using a system directory.

1 . Create a new directory /glusterfs/distributed on each gluster01 and gluster02 servers.

mkdir -p /glusterfs/distributed

2 . From the glusterO1 server, create the distributed glusterfs volume named ‘vol01’ with 2 replicas ‘gfs01’ and ‘gfs02’

gluster volume create vol01 transport tcp gluster01:/glusterfs/distributed gluster02:/glusterfs/distributed force

which returns

volume create: vol01: success: please start the volume to access data

3 . Start the ‘vol01’ and check the volume info

gluster volume start vol01
gluster volume info vol01

which displays

root@gluster01:/# gluster volume start vol01
volume start: vol01: success
root@gluster01:/# gluster volume info vol01

Volume Name: vol01
Type: Replicate
Volume ID: 814b103e-522c-48d2-8d1c-3301e10f3416
Status: Started
Snapshot Count: 0
Number of Bricks: 1 x 2 = 2
Transport-type: tcp
Brick1: gluster01:/glusterfs/distributed
Brick2: gluster02:/glusterfs/distributed
Options Reconfigured:
transport.address-family: inet
nfs.disable: on
performance.client-io-threads: off

At this stage, we created the ‘vol01’ volume with the type ‘Replicate’ and 2 bricks on ‘gluster01’ and ‘gluster02’ server. All data will be distributed automatically to each replica server.

The next step is to mount the volume.

Configuring GlusterFS Client

In this step, we will mount the glusterfs volume ‘vol01’ to the Ubuntu client, and we need to install the glusterfs-client to the client server.

1 . Install glusterfs-client on client01

apt install glusterfs-client -y

2 . Create a new directory ‘/mnt/glusterfs’

mkdir -p /mnt/glusterfs

3 . Mount the distributed glusterfs volume ‘vol01’ to the ‘/mnt/glusterfs’ directory.

mount -t glusterfs gluster01:/vol01 /mnt/glusterfs

4 . Check the available volume on the system

df -h /mnt/glusterfs

which returns

Filesystem        Size  Used Avail Use% Mounted on
gluster01:/vol01   46G  2.4G   42G   6% /mnt/glusterfs

Note: To mount glusterfs permanently to the Ubuntu client system, we can add the volume to the ‘/etc/fstab’.

  1. Edit the ‘/etc/fstab’ configuration file: vim /etc/fstab
  2. Paste the following configuring:gluster01:/vol01 /mnt/glusterfs glusterfs defaults,_netdev 0 0
  3. Save and exit.
  4. Reboot the server. When online, the glusterfs volume ‘vol01’ is mounted automatically through the fstab.

Testing Replication & Mirroring

1 . Mount the glusterfs volume ‘vol01’ to each glusterfs servers.

  • On gluster01: mount -t glusterfs gluster01:/vol01 /mnt
  • On gluster02: mount -t glusterfs gluster02:/vol01 /mnt

2 . Back on client01, go to the ‘/mnt/glusterfs’ directory.

cd /mnt/glusterfs

3 . Create three files using touch command

touch file01 file02 file03

4 . Check on each ‘gluster01’ and ‘gluster02’ that the files that we’ve created from the client machine are displayed

cd /mnt/
ls -lah

The gluster01 machine returns

root@gluster01:/mnt# ls -lah
total 8.0K
drwxr-xr-x  3 root root 4.0K Oct  1 15:40 .
drwxr-xr-x 24 root root 4.0K Sep 28 14:11 ..
-rw-r--r--  1 root root    0 Oct  1 15:40 file01
-rw-r--r--  1 root root    0 Oct  1 15:40 file02
-rw-r--r--  1 root root    0 Oct  1 15:40 file03

The gluster02 machine returns

root@gluster02:/mnt# ls -lah
total 8.0K
drwxr-xr-x  3 root root 4.0K Oct  1 15:40 .
drwxr-xr-x 24 root root 4.0K Sep 28 14:11 ..
-rw-r--r--  1 root root    0 Oct  1 15:40 file01
-rw-r--r--  1 root root    0 Oct  1 15:40 file02
-rw-r--r--  1 root root    0 Oct  1 15:40 file03

As you can see, all the files we created from the client machine are distributed to all the glusterfs volume node servers.

Discover a New Cloud Experience

Deploy SSD Cloud Servers in seconds.