From f5e4c943cf520c6ec2df3c231fef9ae4116097b8 Mon Sep 17 00:00:00 2001
From: Kotresh HR <khiremat@redhat.com>
Date: Mon, 30 Mar 2015 13:10:00 +0530
Subject: doc/geo-rep: Documentation for management volume for geo-rep

Documented new changes to admin guide for setting up
geo-replication with the new active/passive switching
logic that comes with http://review.gluster.org/#/c/9759/

Change-Id: I47de9d2c1e678f7ad789f0ca2acf7ce67eb96c62
BUG: 1196632
Signed-off-by: Kotresh HR <khiremat@redhat.com>
Reviewed-on: http://review.gluster.org/10043
Reviewed-by: Aravinda VK <avishwan@redhat.com>
Reviewed-by: Humble Devassy Chirammal <humble.devassy@gmail.com>
Tested-by: Gluster Build System <jenkins@build.gluster.com>
---
 .../en-US/markdown/admin_distributed_geo_rep.md     | 21 +++++++++++++++++++++
 1 file changed, 21 insertions(+)

(limited to 'doc/admin-guide')

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 c559f2cc306..ad44ed55ff8 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
@@ -44,6 +44,27 @@ gluster volume geo-replication <master_volume> <slave_host>::<slave_volume> crea
 ```
 In this case the master node rsa-key distribution to slave node does not happen and above mentioned slave verification is not performed and these two things has to be taken care externaly.
 
+### 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.
+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>
+```
+
+Start the meta volume as follows.
+```sh
+gluster volume start <meta_vol>
+```
+
+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>
+```
+
 #### Starting a geo-rep session
 There is no change in this command from previous versions to this version.
 ```sh
-- 
cgit