ICMP Poll Engine Files

Description

Bipoller is a multithreaded, scalable ICMP polling application which leverages the following projects:

Derby - http://db.apache.org/derby/
argparser - http://www.cs.ubc.ca/~lloyd/java/argparser.html
icmp4j - http://www.icmp4j.org/d/index.html
snmp4j - http://www.snmp4j.org/

Each database can support up to 10 polling clients and each client can ICMP poll up to 3000 devices (given
appropriate poll intervals and throttle settings, see below).

Installation

Extract the contents of bipoller-dist.zip into chosen directory (the following text will 
assume c:\bipoller).

Execution

1) cd to c:\bipoller

2) Edit bipoller.props to suit your preferences.

2) Create a server using the following:

	java -jar bipoller.jar -server

3) Populate the server using either of the following:

	java -jar bipoller.jar -load <filename> - A sample file - import.csv is provided
	example: java -jar bipoller.jar -load import.csv

	java -jar bipoller.jar -add -name <nodename> -interval <poll interval>
	example: java -jar bipoller.jar -add -name google.com -interval 90

4) Run a polling client using the following:

	java -jar bipoller.jar -poller

Other Commands

1) 	java -jar bipoller.jar -list 
	List all polled device details in readable form

2) 	java -jar bipoller.jar -delete -node <nodename>
	Removes <nodename> from the list of polled devices

3) 	java -jar bipoller.jar -export
	List all polled device details in csv format

4) 	java -jar bipoller.jar -sendtrap
	This is a daemon that sends SNMP V1 traps for all unreachable devices to Network Management System. 
	Uses the following properties

		bipoller.trap.enterprise=.1.3.6.1.4.1.16536.1.1
		bipoller.trap.destaddress=localhost
		bipoller.trap.destport=162
		bipoller.trap.interval=60	


Properties

bipoller.throttle=10
## the number of concurrent ICMP polls. Anything up to 50 would be appropriate for any modern OS.
bipoller.connection.host=localhost
## the host on which the server is running - used by polling clients and commands. Not used by server, this always
## runs on the system on which it is executed.
bipoller.connection.port=19001
## the port number on which the server will be listening
bipoller.poller.username=poll
## Derby username
bipoller.poller.password=bipolar
## Derby password
bipoller.dbname=POLLER33
## Derby database name, will be created if does not exist
bipoller.trap.enterprise=.1.3.6.1.4.1.16536.1.1
## The SNMP enterprise OID which wil be used when sending SNMP V1 traps
bipoller.trap.destaddress=localhost
## The hostname on which the target NMS (or SNMP daemon) is running
bipoller.trap.destport=162
## The ort number on which the target NMS (or SNMP daemon) is running
bipoller.trap.interval=60
## How often the trap daemon will check for unavailable devices

Limitations
All communication between clients and server uses JDBC connections which are neither lightweight
or encrypted. Use with caution over secure connections. I will address these limitations in a later
release.

When starting a polling client, allow 5 seconds before starting another client.

Compiler
Built with Sun Java 1.7.0_67

Tested Platforms
Windows 7
Linux (Moonos)