summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorKotresh HR <khiremat@redhat.com>2015-04-13 11:56:35 +0530
committerVijay Bellur <vbellur@redhat.com>2015-05-05 00:58:26 -0700
commitc79e03ecd3cd9f2ffad52fad983b32133d8af787 (patch)
treecca25fa6b0b388073d6b92ba6a78dfa85109284e /doc
parent41c3c1c1e4ccc425ac2edb31d7fa970ff464ebdd (diff)
doc/geo-rep: Doc changes w.r.t common shared gluster meta volume
Change-Id: I71c466537a191caa5c5a4a11e67df384c24c73ef BUG: 1210344 Signed-off-by: Kotresh HR <khiremat@redhat.com> Reviewed-on: http://review.gluster.org/10447 Tested-by: Gluster Build System <jenkins@build.gluster.com> Reviewed-by: Aravinda VK <avishwan@redhat.com>
Diffstat (limited to 'doc')
-rw-r--r--doc/admin-guide/en-US/markdown/admin_distributed_geo_rep.md31
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