Introduction

The Simple Network Management Protocol (SNMP) is a network protocol for monitoring network elements (e.g. routers, servers, switches, printers, computers, Lobster_data, etc.) from a central monitoring tool.

SNMP in Lobster_data

SNMP traps can be sent from Lobster_data without additional licensing. Private Enterprise Code: http://www.iana.org/assignments/enterprise-numbers (→ see 39458).

Configuration

There are two separate configuration points to enable traps.

Activating Traps for Faulty Jobs (Lobster_data branch)

Sending Lobster_data log entries (e.g. failed jobs) as traps is achieved with the following configuration in file ./etc/startup.xml.

<Call name="addLogListener">
	<Arg>
		<New class="com.ebd.hub.datawizard.log.Snmp3LogListener">
			<Call name="setSnmp3Params">
				<Arg type="String">1.3.6.1.6.3.1.1.4.1</Arg>
				<Arg type="String">1.3.6.1.4.1.39458.102</Arg>
				<Arg type="String">1.3.6.1.2.1.1.3</Arg>
			</Call>
			<!-- only send trap messages for: 0 = always, 1 = jobs, 2 = general errors -->
			<Call name="setErrorType">
				<Arg type="int">0</Arg>
			</Call>
		</New>
	</Arg>
</Call>

The only thing that should be changed here (if necessary) is the ErrorType.

Activating Traps for Lobster_data and Services Availability (Integration Server branch)

The traps to report the availability of the Integration Server services (Lobster_data, FTP service, OFTP service, Message service, SMTP service, HTTP service) at regular intervals are enabled in configuration file ./etc/cron.xml.

First of all, please enable the Cron Job Logging in general.

<Call name="enableCronJobLogging"><Arg type="Boolean">True</Arg></Call>

After that, a specific cron job needs to be configured.

<Call name="addJob">
	<Arg>
		<New class="com.ebd.hub.services.cron.CronJob">
			<Arg>Snmp</Arg>
			<Arg>
				<New class="com.ebd.hub.datawizard.extensions.Snmp3Monitor"/>
			</Arg>
			<Call name="setTimeSchedule">
				<Arg>
					<New class="com.ebd.hub.services.cron.Schedule">
						<Call name="addCronTab">
							<Arg>0</Arg>
							<Arg>*/10</Arg>
							<Arg>*</Arg>
							<Arg>*</Arg>
							<Arg>*</Arg>
							<Arg>*</Arg>
						</Call>
					</New>
				</Arg>
			</Call>
		</New>
	</Arg>
</Call>

The arguments in the definition of the time points correspond to the crontab syntax. The setting here (second=0, minute=*/10, all others *) means that the cron job runs every 10 minutes.

Management Information Base (Monitoring Tool)

The monitoring tool needs the MIB of Lobster_data, which can be found under ./etc/admin/datawizard/Lobster-MIB.txt. See linked example.

Login Data for Trap User (Monitoring Tool)

The credentials of the trap user are stored i n configuration file ./etc/admin/datawizard/snmp.properties. For SNMP 3 it is important that the SNMP 3 parameters are filled.

You use this data (engine ID of Lobster_data, user, password, privacy password for encryption, etc.) when creating the trap user in the monitoring tool.Y ou can find the IP/port of the monitoring tool in the monitoring tool. See linked example.

...
 
# New settings for snmp v3
#
engineID=44-61-72-74-2E-50-6F-77-65-72-53-4E-4D-50
securityLevel=3
# may be obfuscated
privPass=myprivpass
authProtocol=SHA
privProtocol=AES128
contextEngineID=Lobster_data
contextName=Lobster

Tools

There are a variety of tools for handling SNMP traps, e.g. iReasoning or PowerSNMP.