001: /*
002: * Copyright (c) 2003, Intracom S.A. - www.intracom.com
003: *
004: * This library is free software; you can redistribute it and/or
005: * modify it under the terms of the GNU Lesser General Public
006: * License as published by the Free Software Foundation; either
007: * version 2 of the License, or (at your option) any later version
008: *
009: * This library is distributed in the hope that it will be useful,
010: * but WITHOUT ANY WARRANTY; without even the implied warranty of
011: * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
012: * Lesser General Public License for more details.
013: *
014: * You should have received a copy of the GNU Lesser General Public
015: * License along with this library; if not, write to the Free Software
016: * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
017: *
018: * This package and its source code is available at www.jboss.org
019: **/
020: package org.jboss.jmx.adaptor.snmp.trapd;
021:
022: import java.net.InetAddress;
023: import java.net.UnknownHostException;
024:
025: import org.jboss.system.ServiceMBeanSupport;
026: import org.jboss.system.server.ServerConfig;
027: import org.opennms.protocols.snmp.SnmpTrapSession;
028:
029: /**
030: * MBean wrapper class that acts as an SNMP trap receiver/logger.
031: * It logs traps as INFO messages - change log4j configuration to
032: * redirect logging output. To reconfigure the listening port
033: * the MBean needs to be stopped and re-started.
034: *
035: * @jmx:mbean
036: * extends="org.jboss.system.ServiceMBean"
037: *
038: * @version $Revision: 23955 $
039: *
040: * @author <a href="mailto:spol@intracom.gr">Spyros Pollatos</a>
041: * @author <a href="mailto:dimitris@jboss.org">Dimitris Andreadis</a>
042: **/
043: public class TrapdService extends ServiceMBeanSupport implements
044: TrapdServiceMBean {
045: /** The listening port */
046: private int port;
047:
048: /** The interface to bind, useful for multi-homed hosts */
049: private InetAddress bindAddress;
050:
051: /** The snmp session used to receive the traps*/
052: protected SnmpTrapSession trapSession;
053:
054: /**
055: * Empty CTOR
056: **/
057: public TrapdService() {
058: // empty
059: }
060:
061: /**
062: * Sets the port that will be used to receive traps
063: *
064: * @param port the port to listen for traps
065: *
066: * @jmx:managed-attribute
067: **/
068: public void setPort(int port) {
069: this .port = port;
070: }
071:
072: /**
073: * Gets the port that will be used to receive traps
074: *
075: * @return the port to listen for traps
076: *
077: * @jmx:managed-attribute
078: **/
079: public int getPort() {
080: return this .port;
081: }
082:
083: /**
084: * Sets the interface that will be bound
085: *
086: * @param host the interface to bind
087: *
088: * @jmx:managed-attribute
089: **/
090: public void setBindAddress(String host) throws UnknownHostException {
091: this .bindAddress = toInetAddress(host);
092: }
093:
094: /**
095: * Gets the interface that will be bound
096: *
097: * @return the interface to bind
098: *
099: * @jmx:managed-attribute
100: **/
101: public String getBindAddress() {
102: String address = null;
103:
104: if (this .bindAddress != null)
105: address = this .bindAddress.getHostAddress();
106:
107: return address;
108: }
109:
110: /**
111: * Performs service start-up by instantiating an SnmpTrapSession
112: **/
113: protected void startService() throws Exception {
114: // Create the SNMP trap receiving session with the logging handler,
115: // using Logger inherited from ServiceMBeanSupport
116: try {
117: // cater for possible global -b option, if no override has been specified
118: InetAddress address = this .bindAddress != null ? this .bindAddress
119: : toInetAddress(System
120: .getProperty(ServerConfig.SERVER_BIND_ADDRESS));
121:
122: this .trapSession = new SnmpTrapSession(new TrapReceiver(
123: this .log), this .port, address);
124: } catch (Exception e) {
125: log.error("Cannot instantiate trap session");
126:
127: throw e; // ServiceMBeanSupport will log this
128: }
129: }
130:
131: /**
132: * Performs service shutdown by stopping SnmpTrapSession
133: **/
134: protected void stopService() throws Exception {
135: this .trapSession.close();
136: this .trapSession = null; // gc
137: }
138:
139: /**
140: * Safely convert a host string to InetAddress or null
141: */
142: private InetAddress toInetAddress(String host)
143: throws UnknownHostException {
144: if (host == null || host.length() == 0)
145: return null;
146: else
147: return InetAddress.getByName(host);
148: }
149:
150: } // class TrapdService
|