51.1. SNMP resource

51.1. SNMP resource
	Chapter 51. SNMP - Simple Network Management Protocol

The activation of SNMP resource allows to configure Abilis as a SNMP agent. The configuration is quite simple, because few parameters must be modified.

The MIB (Management Information Base) contains the description of the configuration/statistics “objects” available in the SNMP Agents and their availability to be controlled by SNMP Managers. The variables accessible via Abilis CPX SNMP resource are described in the Abilis proprietary MIB that can be downloaded from Abilis technical website - download section.

	Tip
	Refer to Section 51.5, “Appendix - SNMP Protocol” to have more information about SNMP protocol.

51.1.1. Activating the SNMP resource

Add the resource to the Abilis system with the following command:

[15:50:39] ABILIS_CPX:a res:snmp

RES:SNMP ALREADY EXISTS

The SNMP resource may already exist in the system, but may not yet be active: set it active with the command:

[15:50:43] ABILIS_CPX:s act res:snmp

COMMAND EXECUTED

	Caution
	After adding or setting the SNMP active, you must restart the Abilis to make the resource running (use the command warm start to reboot the Abilis).

[17:14:59] ABILIS_CPX:s p snmp act:yes

COMMAND EXECUTED

[17:15:17] ABILIS_CPX:d p snmp

RES:Snmp - Not Saved (SAVE CONF), Not Refreshed (INIT) ----------------------
       -----------------------------------------------------------------------
Run    DESCR:Simple_Network_Management_Protocol
       LOG:NO        ACT:YES
       - Agent ----------------------------------------------------------------
       locport:161
       COMMUNITY:public
       IPSRC:*                        IPSRCLIST:#
       - Traps ----------------------------------------------------------------
       TRAP:NO       AUTHTRAP:NO      TRAPREP:10
       TRAPDEST:#                     TRAPSRC:R-ID (192.168.001.001)

51.1.2. SNMP resource parameters

Use the following command to display the parameters of the resource; the d p snmp ? command shows the meaning of parameters.

[09:58:41] ABILIS_CPX:d p snmp

RES:Snmp ----------------------------------------------------------------------
Run    DESCR:Simple_Network_Management_Protocol
       LOG:NO        ACT:YES
       - Agent ----------------------------------------------------------------
       locport:161
       COMMUNITY:public
       IPSRC:*                        IPSRCLIST:#
       - Traps ----------------------------------------------------------------
       TRAP:NO       AUTHTRAP:NO      TRAPREP:10
       TRAPDEST:#                     TRAPSRC:R-ID (192.168.001.001)

Meaning of the most important parameters:

LOG: Logging functionalities activation/deactivation.
ACT: Agent activation [NO, YES].
udp-locport: SNMP local UDP port for incoming requests [161] <Read Only>.
COMMUNITY: Sets the keyword used by the authentication procedure of those SNMP management systems able to query the SNMP Agent of the Abilis CPX. Only those, which have the same value of the “Community Name” as the local SNMP port, are allowed to supervise. If it doesn't match, the query frames are rejected and, if the parameter AUTHTRAP is set to YES, a wrong authentication message is sent to the SNMP Manager, whose IP is configured in the parameter TRAPDEST.
IPSRC: Incoming requests: accepted source IP address [*, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
IPSRCLIST: Incoming requests: list of further accepted source IP addresses [#, IP/IR/RU/MR listname].
TRAP: Enables/disables the generation of informative asynchronous signalling (trap) to the SNMP Manager, which IP address must be declared in the TRAPDEST parameter.
AUTHTRAP: Enable SNMP authentication-failure traps generation [NO, YES].
TRAPREP: Traps repetition period [NO, 1..255 min.].
TRAPDEST: Traps destination IP address: specific IP or IP/IR list name [#, ListName, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].
TRAPSRC: Source IP address for traps [R-ID, OUT-IP, 1-126.x.x.x, 127.0.0.1, 128-223.x.x.x].

The command that allows the configuration of the resource to be modified has the following syntax:

s p snmp par:val...

	Caution
	To activate the changes made on the upper case parameters, execute the initialization command init res:snmp; while to set act the changes made on the lowercase parameters a save conf and an Abilis restart are required (i.e. With warm start command).


Chapter 51. SNMP - Simple Network Management Protocol		51.2. Example of configuration of the SNMP resource