50.1. SNMP resource

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]Tip

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

50.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]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)

50.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]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).