From 7eda06449a8b97adf9fa3e67eeb990223af72f99 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Tue, 09 Aug 2011 21:04:17 +0000
Subject: [PATCH] Fix OPENDJ-257: Procedure for temporarily pausing replication does not work as advertised
---
opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-replication.xml | 33 +++++++++++----------------------
1 files changed, 11 insertions(+), 22 deletions(-)
diff --git a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-replication.xml b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-replication.xml
index 5013204..9371a33 100644
--- a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-replication.xml
+++ b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-replication.xml
@@ -362,35 +362,24 @@
<title>To Stop Replication Temporarily For a Replica</title>
<para>If you need to stop a server from replicating temporarily, you can
- do so using <command>dsconfig</command> command. Do not update directory
+ do so using <command>dsconfig</command> command. Do NOT update directory
data on the server while replication is interrupted.</para>
<step>
- <para>Get the replication server property that identifies one of the
- replication service host:port combinations that you need to restart
- replication.</para>
+ <para>Disable the multimaster synchronization provider.</para>
<screen>$ dsconfig -p 5444 -h `hostname` -D "cn=Directory Manager" -w password
- get-replication-server-prop --provider-name "Multimaster Synchronization"
- --property replication-server -X
-Property : Value(s)
--------------------:-----------------------------------------------------------
-replication-server : localhost:8989,
- : localhost:9989</screen>
- </step>
- <step>
- <para>Reset the replication server property to the default (no
- replication server) to pause replication.</para>
- <screen>$ dsconfig -p 5444 -h `hostname` -D "cn=Directory Manager" -w password
- set-replication-server-prop --provider-name "Multimaster Synchronization"
- --reset replication-server -X -n</screen>
- <para>Do not modify the replica for which replication is paused.</para>
+ set-synchronization-provider-prop -X -n
+ --provider-name "Multimaster Synchronization" --set enabled:false</screen>
+ <para>Do NOT allow modifications on the replica for which replication is
+ paused, as no record of such changes is kept, and the changes cause
+ replication to diverge.</para>
</step>
<step performance="optional">
- <para>When you are ready to resume replication, set the replication server
- property to the host:port combination of an active replication server.</para>
+ <para>When you are ready to resume replication, enable the multimaster
+ synchronization provider.</para>
<screen>$ dsconfig -p 5444 -h `hostname` -D "cn=Directory Manager" -w password
- set-replication-server-prop --provider-name "Multimaster Synchronization"
- --set replication-server:localhost:8989 -X -n</screen>
+ set-synchronization-provider-prop -X -n
+ --provider-name "Multimaster Synchronization" --set enabled:true</screen>
</step>
</procedure>
--
Gitblit v1.10.0