Fix for OPENDJ-212: Need better error message when trying to configure SNMP

Mark Craig

03.47.2011 e59544654091821a4b794ce038963e795c9298c8

Fix for OPENDJ-212: Need better error message when trying to configure SNMP

 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">

 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">