diff options
| -rw-r--r-- | doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md | 31 |
1 files changed, 23 insertions, 8 deletions
diff --git a/doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md b/doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md index bc111255b4a..38c1f6725b8 100644 --- a/doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md +++ b/doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md @@ -113,16 +113,26 @@ To add multiple volumes per mountbroker user, /usr/libexec/glusterfs/set_geo_rep_pem_keys.sh <mountbroker_user> <master_volume> <slave_volume> ``` -### Configuring meta volume -A gluster meta volume needs to be configured with geo-replication to -better handle rename and other consistency issues in geo-replication during -brick/node down scenarios when master volume is configured with EC(Erasure Code)/AFR. +### Create and mount meta volume +NOTE: +___ +If shared meta volume is already created and mounted at '/var/run/gluster/shared_storage' +as part of nfs or snapshot, please jump into section 'Configure meta volume with goe-replication'. +___ + +A 3-way replicated common gluster meta-volume should be configured and is shared +by nfs, snapshot and geo-replication. The name of the meta-volume should be +'gluster_shared_storage' and should be mounted at '/var/run/gluster/shared_storage/'. + +The meta volume needs to be configured with geo-replication to better handle +rename and other consistency issues in geo-replication during brick/node down +scenarios when master volume is configured with EC(Erasure Code)/AFR. Following are the steps to configure meta volume Create a 3 way replicated meta volume in the master cluster with all three bricks from different nodes as follows. ```sh - gluster volume create <meta_vol> replica 3 <host1>:<brick_path> <host2>:<brick_path> <host3>:<brick_path> + gluster volume create gluster_shared_storage replica 3 <host1>:<brick_path> <host2>:<brick_path> <host3>:<brick_path> ``` Start the meta volume as follows. @@ -131,12 +141,17 @@ Start the meta volume as follows. gluster volume start <meta_vol> ``` -Configure meta volume with geo-replication session as follows. +Mount the meta volume as follows in all the master nodes. + ```sh + mount -t glusterfs <master_host>:gluster_shared_storage /var/run/gluster/shared_storage + ``` + +###Configure meta volume with geo-replication session as follows. ```sh - gluster volume geo-replication <master_volume> <slave_host>::<slave_volume> config meta_volume <meta_vol> + gluster volume geo-replication <master_volume> <slave_host>::<slave_volume> config use_meta_volume true # If Mountbroker Setup, - gluster volume geo-replication <master_volume> <mountbroker_user>@<slave_host>::<slave_volume> config meta_volume <meta_vol> + gluster volume geo-replication <master_volume> <mountbroker_user>@<slave_host>::<slave_volume> config use_meta_volume true ``` #### Starting a geo-rep session |