Usage guide: Replicate volumes with arbiter configuration
Arbiter volumes are replica 3 volumes where the 3rd brick of the replica is automatically configured as an arbiter node. What this means is that the 3rd brick will store only the file name and metadata, but does not contain any data. This configuration is helpful in avoiding split-brains while providing the same level of consistency as a normal replica 3 volume.
The arbiter volume can be created with the following command:
gluster volume create <VOLNAME> replica 3 arbiter 1 host1:brick1 host2:brick2 host3:brick3
Note that the syntax is similar to creating a normal replica 3 volume with the
exception of the
arbiter 1 keyword. As seen in the command above, the only
permissible values for the replica count and arbiter count are 3 and 1
respectively. Also, the 3rd brick is always chosen as the arbiter brick and it
is not configurable to have any other brick as the arbiter.
Client/ Mount behaviour:
By default, client quorum (
cluster.quorum-type) is set to
auto for a replica
3 volume when it is created; i.e. at least 2 bricks need to be up to satisfy
quorum and to allow writes. This setting is not to be changed for arbiter
volumes also. Additionally, the arbiter volume has additional some checks to
prevent files from ending up in split-brain:
Clients take full file locks when writing to a file as opposed to range locks in a normal replica 3 volume.
If 2 bricks are up and if one of them is the arbiter (i.e. the 3rd brick) and it blames the other up brick, then all FOPS will fail with ENOTCONN (Transport endpoint is not connected). IF the arbiter doesn't blame the other brick, FOPS will be allowed to proceed. 'Blaming' here is w.r.t the values of AFR changelog extended attributes.
If 2 bricks are up and the arbiter is down, then FOPS will be allowed.
In all cases, if there is only one source before the FOP is initiated and if the FOP fails on that source, the application will receive ENOTCONN.
Note: It is possible to see if a replica 3 volume has arbiter configuration from
the mount point. If
and its value is 1, then it is an arbiter volume. Also the client volume graph
will have arbiter-count as a xlator option for AFR translators.
Self-heal daemon behaviour:
Since the arbiter brick does not store any data for the files, data-self-heal from the arbiter brick will not take place. For example if there are 2 source bricks B2 and B3 (B3 being arbiter brick) and B2 is down, then data-self-heal will not happen from B3 to sink brick B1, and will be pending until B2 comes up and heal can happen from it. Note that metadata and entry self-heals can still happen from B3 if it is one of the sources.cd