pandorafms/pandora_server
slerena b9d1f3d466 * Changed to SNMP module insted of NET:SNMP, a better results and could get OID with names, not only numeric OID. Tested and works fine.
* Added a small tool to test SNMP functionality (a perl snmpget command using either NET:SNMP or SNMP module).


git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@53 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f
2006-06-28 17:08:22 +00:00
..
bin * Changed to SNMP module insted of NET:SNMP, a better results and could get OID with names, not only numeric OID. Tested and works fine. 2006-06-28 17:08:22 +00:00
conf * Changed to SNMP module insted of NET:SNMP, a better results and could get OID with names, not only numeric OID. Tested and works fine. 2006-06-28 17:08:22 +00:00
doc Initial Pandora load from our internal SVN 2006-03-27 03:37:27 +00:00
log * Changed to SNMP module insted of NET:SNMP, a better results and could get OID with names, not only numeric OID. Tested and works fine. 2006-06-28 17:08:22 +00:00
util - Clear logs 2006-03-31 11:21:55 +00:00
var Initial Pandora load from our internal SVN 2006-03-27 03:37:27 +00:00
README - Update README info 2006-03-31 11:27:53 +00:00
pandora_network Initial Pandora load from our internal SVN 2006-03-27 03:37:27 +00:00
pandora_server Initial Pandora load from our internal SVN 2006-03-27 03:37:27 +00:00
pandora_snmpconsole Initial Pandora load from our internal SVN 2006-03-27 03:37:27 +00:00

README

Configure
=========
Change the values in the ./conf/pandora_server.conf file to your own values: servername, IP and so.


SNMP Troubleshooting
====================

You need to install libnet-snmp-perl (not the old libsnmp-perl) package (debian name) to use SNMP Network Agents.

On PERL code for Pandora Server:

If problems occur there are number areas to look at to narrow down the possibilities.
The first step should be to test the UCD SNMP installation independently from the Perl5 SNMP interface.
Try running the apps from the UCD SNMP distribution, this means: try to exec manually snmpget in the Pandora Network Server. Try for example:

	snmpget -v 1 -c public 192.168.5.1 SNMPv2-MIB::sysName.0
	bash: snmpget: command not found

Houston, you've a problem with snmpget :-). Fix it before launch pandora network server.

Make sure your agent (snmpd) is running and properly configured with read-write access for the community you are using.
Ensure that your MIBs are installed and enviroment variables are set appropriately (see man mib_api)
Be sure to remove old ucd-snmp installations and ensure headers and libraries from old CMU installations are not being used by mistake.

If the problem occurs during compilation/linking check that the snmp library being linked is actually the UCD SNMP library (there have been name conflicts with existing snmp libs).
Also check that the header files are correct and up to date.
Sometimes compiling the UCD SNMP library with 'position-independent-code' enabled is required (HPUX specifically).

Network Agent: ICMP Latency
===========================

This module only works if Network Server component its executed under root privileges due limitations of Net::Ping perl library. You can run Network Server using an user without admin privileges but you cannot use ICMP Data / Latency module, but ICMP Proc it's usable using any user because other perl library it's used in this case.

Network Agent: UDP
==================

This module only works if Network Server component its executed under root privileges due limitations of Net::Ping perl library.

Network Agent chat
==================

Its possible to send data to remote TCP ports in Network Agents, you can use "^M" macro to replace \r\n (Return Carriage and Line Feed), for example, to use a simple http request: "GET / HTTP/1.0^M^M".

remote_tcp_proc moduletype allows you to "expect" a string (rcv data). If this string is matched in any place of the answer, value will be 1 (OK), if not, 0 (BAD).

Network SNMP Agent
==================

SNMP OID MUST be provided in dotted format, p.e:

IF-MIB::ifInOctets.6 -> .1.3.6.1.2.1.2.2.1.16.6

SNMPv2-MIB::sysUpTime -> .1.3.6.1.2.1.1.3