From 003feab5387aab317998ba79e521f9090d82cac7 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Thu, 28 Jun 2012 07:24:38 +0000
Subject: [PATCH] Review comment from Ludovic: Rather than restart OpenDJ, just restart the connection handler.

---
 opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml |   28 ++++++++++++-
 opendj3/src/main/docbkx/admin-guide/chap-listeners.xml  |   50 +++++++++++++++++++++++--
 2 files changed, 71 insertions(+), 7 deletions(-)

diff --git a/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml b/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
index 7bf0af3..c308333 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-listeners.xml
@@ -68,8 +68,29 @@
     <para>This example changes the port number to 11389 in the configuration.</para>
    </step>
    <step>
-    <para>Restart the server so the change takes effect.</para>
-    <screen>$ stop-ds --restart</screen>
+    <para>Restart the connection handler so the change takes effect.</para>
+    <para> To restart the connection handler, you disable it, then enable
+    it again.</para>
+    <screen>$ dsconfig
+ set-connection-handler-prop
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "LDAP Connection Handler"
+ --set enable:false
+ --trustAll
+ --no-prompt
+$ dsconfig
+ set-connection-handler-prop
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "LDAP Connection Handler"
+ --set enable:true
+ --trustAll
+ --no-prompt</screen>
    </step>
   </procedure>
  </section>
@@ -257,8 +278,29 @@
     <para>This example changes the port number to 11636 in the configuration.</para>
    </step>
    <step>
-    <para>Restart the server so the change takes effect.</para>
-    <screen>$ stop-ds --restart</screen>
+    <para>Restart the connection handler so the change takes effect.</para>
+    <para> To restart the connection handler, you disable it, then enable
+    it again.</para>
+    <screen>$ dsconfig
+ set-connection-handler-prop
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "LDAPS Connection Handler"
+ --set enable:false
+ --trustAll
+ --no-prompt
+$ dsconfig
+ set-connection-handler-prop
+ --hostname opendj.example.com
+ --port 4444
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "LDAPS Connection Handler"
+ --set enable:true
+ --trustAll
+ --no-prompt</screen>
    </step>
   </procedure>
  </section>
diff --git a/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml b/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
index f420b06..794f0d0 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
@@ -123,9 +123,31 @@
  --trustAll
  --no-prompt</screen>
 
-  <para>Restart OpenDJ to make sure the port number changes are taken into
-  account.</para>
-  <screen>$ stop-ds --restart</screen>
+  <para>Restart the SNMP Connection Handler to take the port number changes
+  into account.</para>
+  <para> To restart the connection handler, you disable it, then enable
+  it again.</para>
+
+  <screen>$ dsconfig
+ set-connection-handler-prop
+ --port 4444
+ --hostname opendj.example.com
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "SNMP Connection Handler"
+ --set enabled:false
+ --trustAll
+ --no-prompt
+$ dsconfig
+ set-connection-handler-prop
+ --port 4444
+ --hostname opendj.example.com
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "SNMP Connection Handler"
+ --set enabled:true
+ --trustAll
+ --no-prompt</screen>
 
   <para>Use a command such as <command>snmpwalk</command> to check that the
   SNMP listen port works.</para>

--
Gitblit v1.10.0