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

---
 opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml |   29 +++++++++++++++++++++++++----
 1 files changed, 25 insertions(+), 4 deletions(-)

diff --git a/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml b/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
index 89f8421..b7150ae 100644
--- a/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
+++ b/opendj3/src/main/docbkx/admin-guide/chap-monitoring.xml
@@ -85,10 +85,14 @@
   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, installed with
-  OpenDJ that you download from ForgeRock, but not enabled by default. You can
+  <para>OpenDJ SNMP-based monitoring depends on OpenDMK, which you must
+  <link xlink:href="http://opendmk.java.net/download/">download
+  separately</link>. Install the Full Binary Bundle alongside OpenDJ. OpenDJ
+  that you download from ForgeRock is built with OpenDMK, but OpenDMK is not
+  part of OpenDJ, and SNMP is therefore not enabled by default. You can
   set up a connection handler for SNMP by enabling the connection
-  handler.</para>
+  handler, and pointing OpenDJ to your installation of the OpenDMK
+  libraries.</para>
   
   <screen>$ dsconfig
  set-connection-handler-prop
@@ -98,11 +102,28 @@
  --bindPassword password
  --handler-name "SNMP Connection Handler"
  --set enabled:true
+ --set opendmk-jarfile:/path/to/OpenDMK-bin/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>
+  port 162 for traps. On UNIX and Linux systems, only root can normally open
+  these ports. Therefore if you install as a normal user, you might want
+  to change the listen and trap ports.</para>
+  
+  <screen>$ dsconfig
+ set-connection-handler-prop
+ --port 4444
+ --hostname `hostname`
+ --bindDN "cn=Directory Manager"
+ --bindPassword password
+ --handler-name "SNMP Connection Handler"
+ --set listen-port:11161
+ --set trap-port:11162
+ --trustAll
+ --no-prompt
+$ snmpwalk -v 2c -c OpenDJ@OpenDJ localhost:11161 mib-2.66.1.1.2.1
+SNMPv2-SMI::mib-2.66.1.1.2.1 = STRING: "/path/to/OpenDJ"</screen>
  </section>
 
  <section xml:id="jmx-monitoring">

--
Gitblit v1.10.0