Hello

We have contributed a new module to jboss, checked in at Branch_3_2.
It is a JMX -> SNMP adaptor.

To introduce ourselves, I lead the ActionStreamer product team of Intracom,
Greece.
(see
http://www.intracom.com/en/products/operations_business/actionstreamer.htm)
Original author of the module is Mr. Spyros Pollatos
(mailto:[EMAIL PROTECTED]). I provided
the JBoss/JMX expertise, refactoring and integration of the module with
JBoss.

I have summarised the important aspects of the integration below, along with
a basic description.
I hope you find it useful/interesting.

Best Regards
Dimitris Andreadis (mailto:[EMAIL PROTECTED])

-----------------------------------------------------------------------

Changes were made to:

build/build.xml
tools/etc/buildmagic/libraries.ent
thirdparty/exolab/castor/lib/castor.jar
varia/build.xml
varia/.classpath

Additions exist in:

varia/src/resources/services/snmp
varia/src/main/org/jboss/jmx/adaptor/snmp

The unpacked .sar goes to default & all configurations as: snmp-adaptor.sar
There is also the snmp-adaptor.jar installed in lib. The module depends on
snmp-support.jar (produced by the console module - contains joesnmp)
and castor 0.9.4.3 included in the .sar file.

MBeans registered under:

jboss.jmx:name=SnmpAgent,service=snmp,type=adaptor
jboss.jmx:name=SnmpAgent,service=trapd,type=logger
jboss.jmx:name=SnmpAgent,service=timer,type=heartbeat

Copied from the deploy/snmp-adaptor/META-INF/jboss-service.xml:

----------------------------------------------------------------------------
----------
<?xml version="1.0" encoding="UTF-8"?>
<!--
  $Id: jboss-service.xml,v 1.1.2.1 2003/09/15 06:20:08 andd Exp $

  The snmp-adaptor is a module used to intercept JMX notifications emitted
  by MBeans, convert them to traps and send them to SNMP managers. In this
  respect the snmp-adaptor acts as a SNMP agent. Future versions may offer
  support for full agent get/set functionality that maps onto MBean
  attributes or operations.

  It can be used to integrate JBoss with higher order system/network
  management platforms (e.g. HP OpenView), thus making the MBeans visible
  to those systems. The MBean developer can instrument the MBeans by
  producing notifications for any significant event (e.g. server coldstart).
  The adaptor can then be configured to intercept and map those
notifications
  to SNMP traps.

  SnmpAgentService is the main MBean that implements the SNMP agent.
  It is configured by means of three different configuration files:

  - managers.xml, configures where to send traps
  - mbeans.xml, configures the monitored MBeans/notifications types
  - notifications.xml, specifies the exact mapping of each notification type
    to a corresponding SNMP trap

  Have a look at the provided example configuration files for more info.

  SnmpAgentService produces by default a "coldstart" notification when
started.

  In addition, by setting the HeartBeatPeriod attribute to a value greater
  than zero, the adaptor configures a Timer MBean to produce heartbeat
  notifications at regular intervals (measured in seconds).

  The adaptor itself uses JoeSNMP by OpenNMS for its SNMP engine. The
  trap generation mechanism can be changed or extended with custom classes
  able to extract information from notifications subsclasses unknown
  to the NotificationWrapperSupport class provided with the adaptor.

  For more information on using or extending this mechanism, please
  consult the jboss documentation or the source code.

  TrapdService is a simple MBean that acts as an SNMP Manager. It
  listens to a configurable port for incoming traps and logs them
  as INFO messages using the system logger. You can modify the log4j
  configuration to redirect the log output to a file. SnmpAgentService
  and TrapdService and not dependent with each other.

  Enjoy!
-->
<service>

  <!-- A simple trap receiver that acts as an SNMP Manager -->
  <mbean code="org.jboss.jmx.adaptor.snmp.trapd.TrapdService"
         name="jboss.jmx:name=SnmpAgent,service=trapd,type=logger">

    <attribute name="Port">1162</attribute>
  </mbean>

  <!-- The SNMP adaptor MBean -->
  <mbean code="org.jboss.jmx.adaptor.snmp.agent.SnmpAgentService"
         name="jboss.jmx:name=SnmpAgent,service=snmp,type=adaptor">

    <attribute
name="TrapFactoryClassName">org.jboss.jmx.adaptor.snmp.agent.TrapFactorySupp
ort</attribute>
    <attribute name="MonitoredObjectsResName">/mbeans.xml</attribute>
    <attribute name="NotificationMapResName">/notifications.xml</attribute>
    <attribute name="ManagersResName">/managers.xml</attribute>
    <attribute name="HeartBeatPeriod">0</attribute>

    <depends optional-attribute-name="TimerName">
      <mbean code="javax.management.timer.Timer"
             name="jboss.jmx:name=SnmpAgent,service=timer,type=heartbeat"/>
    </depends>
  </mbean>

  <!-- Used for internal testing - ignore
  <mbean code="org.jboss.jmx.adaptor.snmp.test.NotificationProducerService"

name="jboss.jmx:name=SnmpAgent,service=notification,type=producer"/>
  -->
</service>




-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf
_______________________________________________
JBoss-Development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to