pandorafms/pandora_server
slerena 4e6270f73b * pandora_network.pl: Now launch 3 threads, one for each of this network modules: ICMP, TCP/UDP and SNMP. This will improve the max. capacity of each network server. This code was copied from Pandora Data Server code.
* pandora_db.pm: Corrected a small problem in server keepalive function. Now works fine, and create an event when server going up or server going down (also a Log line).
* pandora_server.pl: Fixed a damm bug when server was running in daemon: keepalive check function doesnt exec because thread starts before daemonize call. Fixed and workaround copied to Network Server code.

git-svn-id: https://svn.code.sf.net/p/pandora/code/trunk@74 c3f86ba8-e40f-0410-aaad-9ba5e7f4b01f
2006-07-02 21:31:08 +00:00
..
bin * pandora_network.pl: Now launch 3 threads, one for each of this network modules: ICMP, TCP/UDP and SNMP. This will improve the max. capacity of each network server. This code was copied from Pandora Data Server code. 2006-07-02 21:31:08 +00:00
conf * Updated functions pandora_serverkeepaliver and pandora_updateserver to work on instances of server instead of single name. Now instances for servers will be called "xxx_Net" for Network, "xxx_Data" for Data Server, and "xxx_SNMP" for SNMP Server. This way, a individual keepalive will be used for each instance. 2006-07-01 01:54:36 +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