From be2357f15fe166791b34f88b08f30e6121c47ff9 Mon Sep 17 00:00:00 2001
From: Mark Craig <mark.craig@forgerock.com>
Date: Thu, 03 Nov 2011 16:47:08 +0000
Subject: [PATCH] Fix for OPENDJ-212: Need better error message when trying to configure SNMP

---
 opendj-sdk/opendj3/src/main/docbkx/admin-guide/appendix-ports-used.xml |    5 +++--
 opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml     |   18 ++++++++----------
 2 files changed, 11 insertions(+), 12 deletions(-)

diff --git a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/appendix-ports-used.xml b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/appendix-ports-used.xml
index 4f8076b..79cf1da 100644
--- a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/appendix-ports-used.xml
+++ b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/appendix-ports-used.xml
@@ -62,11 +62,12 @@
    </listitem>
   </varlistentry>
   <varlistentry xml:id="snmp-port">
-   <term>SNMP: 161</term>
+   <term>SNMP: 161, 162</term>
    <listitem>
     <indexterm><primary>Ports</primary><secondary>161</secondary></indexterm>
+    <indexterm><primary>Ports</primary><secondary>162</secondary></indexterm>
     <para>OpenDJ directory server listens for SNMP traffic on port 161 by
-    default. SNMP is not enabled by default.</para>
+    default, and uses port 162 for traps. SNMP is not enabled by default.</para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="jmx-port">
diff --git a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
index cf700ab..89f8421 100644
--- a/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
+++ b/opendj-sdk/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
@@ -85,26 +85,24 @@
   in <link xlink:href="http://tools.ietf.org/html/rfc2605">RFC 2605: Directory
   Server Monitoring MIB</link>.</para>
   
-  <para>OpenDJ SNMP-based monitoring depends on OpenDMK, not currently
-  installed by default. Before using SNMP-based monitoring, first <link
-  xlink:href="http://opendmk.java.net/download/">download</link>, and install
-  OpenDMK, provided separately due to licensing restrictions. Once you have
-  installed OpenDMK, you can set up a connection handler for SNMP.</para>
+  <para>OpenDJ SNMP-based monitoring depends on OpenDMK, installed with
+  OpenDJ that you download from ForgeRock, but not enabled by default. You can
+  set up a connection handler for SNMP by enabling the connection
+  handler.</para>
   
   <screen>$ dsconfig
- create-connection-handler
+ set-connection-handler-prop
  --port 4444
  --hostname `hostname`
  --bindDN "cn=Directory Manager"
  --bindPassword password
  --handler-name "SNMP Connection Handler"
- --type snmp
  --set enabled:true
- --set listen-port:11161
- --set trap-port:11162
- --set opendmk-jarfile:<replaceable>OpenDMK-install-dir</replaceable>/lib/jdmkrt.jar
  --trustAll
  --no-prompt</screen>
+  
+  <para>By default, the SNMP Connection Handler listens on port 161 and uses
+  port 162 for traps.</para>
  </section>
 
  <section xml:id="jmx-monitoring">

--
Gitblit v1.10.0