SNMP Agent - Revision history

Monica at 11:28, 4 November 2013

2013-11-04T11:28:09Z

Dana: /* Configuring Net-SNMP to proxy SNMP requests to YATE */

2012-10-22T08:57:47Z

‎Configuring Net-SNMP to proxy SNMP requests to YATE

Dana: /* Configuring Net-SNMP to proxy SNMP requests to YATE */

2012-10-22T08:57:21Z

‎Configuring Net-SNMP to proxy SNMP requests to YATE

Dana: /* Configuring Net-SNMP to proxy SNMP requests to YATE */

2012-10-22T08:56:57Z

‎Configuring Net-SNMP to proxy SNMP requests to YATE

Dana: /* Configuring Net-SNMP to proxy SNMP requests to YATE */

2012-10-22T08:56:13Z

‎Configuring Net-SNMP to proxy SNMP requests to YATE

Dana at 08:54, 22 October 2012

2012-10-22T08:54:36Z

Dana at 08:51, 22 October 2012

2012-10-22T08:51:19Z

Dana: /* Configuring SNMP traps */

2012-10-19T15:01:38Z

‎Configuring SNMP traps

Dana: /* Configuring Net-SNMP to proxy SNMP requests to YATE */

2012-10-19T15:00:12Z

‎Configuring Net-SNMP to proxy SNMP requests to YATE

Dana: /* Configuring the agent */

2012-10-19T14:59:15Z

‎Configuring the agent

← Older revision		Revision as of 11:28, 4 November 2013
Line 264:		Line 264:

	Please see Net-SNMP documentation for further details.		Please see Net-SNMP documentation for further details.
		+
		+	[[Category:Monitoring]] [[Category:SNMP]] [[Category:Traps]]

@@ Line 131: / Line 131: @@
 ::If you want to load the YATE OIDs into Net-SNMP so that it can translate the OID names the following steps must be taken:
-::* Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
+:::* Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
-::* Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
+:::* Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
   	mibs +NULL-TEAM-MIB

@@ Line 131: / Line 131: @@
 ::If you want to load the YATE OIDs into Net-SNMP so that it can translate the OID names the following steps must be taken:
-:* Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
+::* Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
-:* Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
+::* Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
   	mibs +NULL-TEAM-MIB

@@ Line 131: / Line 131: @@
 ::If you want to load the YATE OIDs into Net-SNMP so that it can translate the OID names the following steps must be taken:
-** Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
+:* Copy the NULL-TEAM-MIB file and the YATE-MIB file found int ''share/data'' to the directory from where Net-SNMP loads the MIBs (''/usr/share/snmp/mibs'' or ''~/.snmp/mibs'' on Ubuntu or you can find them by running ''net-snmp-config --default-mibdirs'').
-** Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
+:* Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
   	mibs +NULL-TEAM-MIB

@@ Line 117: / Line 117: @@
   	- -v 3 specifies the use of SNMPv3 protocol
   	- -u sets the username used for SNMPv3 agent where the requests are proxied
-	- -a MD5|SHA authentication protocol used for the user and -A the authentication
+ 	- -a MD5|SHA authentication protocol used for the user and -A the authentication
   	pass phrase
   	- -x AES|DES privacy protocol used for the user and -X the encryption pass phrase

@@ Line 125: / Line 125: @@
   	- the subtree of OIDs to proxy
-::This tells the daemon that all requests comming with an OID belonging in the .1.3.6.1.4.1.34501 subtree (the Null Team tree) should be proxied to localhost port 16001.
+::This tells the daemon that all requests comming with an OID belonging in the .1.3.6.1.4.1.34501 subtree (the Null Team tree) should be proxied to localhost port 16001. After modifying the configuration file, the snmpd daemon must be restarted. <br>'''Note:''' snmpd must start with the following command line parameter ''-Iproxy'' to ensure that that daemon enables proxying.
-    After modifying the configuration file, the snmpd daemon must be restarted.
-−
-    NOTE! snmpd must start with the following command line parameter ''-Iproxy'' to ensure that that daemon enables proxying.
 *  Loading the YATE MIB into Net-SNMP

@@ Line 179: / Line 179: @@
 '''Example'''
-	proto_version=SNMPv2c
+ 	proto_version=SNMPv2c
-−
-	; if SNMPv2 is used, set the community string used for the remote SNMP entity
+ 	; if SNMPv2 is used, set the community string used for the remote SNMP entity
-	community=yateSNMP
+ 	community=yateSNMP
 * Configuring YATE to send SNMP v3 traps
 To send SNMP v3 traps, you must specify in the [traps] section the SNMP protocol version used for sending traps and the SNMP v3 user for the remote SNMP entity which catches the traps:
-	;SNMP protocol version to use for sending traps (values are SNMPv2c or SNMPv3).
+ 	;SNMP protocol version to use for sending traps (values are SNMPv2c or SNMPv3).
-	;Defaults to SNMPv2c.
+   	;Defaults to SNMPv2c.
-	;proto_version=SNMPv3
+  	;proto_version=SNMPv3
-−
-	; if SNMPv3 is used, specify which configured user should be used for sending
+ 	; if SNMPv3 is used, specify which configured user should be used for sending
-	;traps (there must be a section named like the given value to trap_user)
+ 	;traps (there must be a section named like the given value to trap_user)
-	; see the example bellow (section [userV3]) for configuring a SNMPv3 user
+ 	; see the example bellow (section [userV3]) for configuring a SNMPv3 user
-	; the specified user will not allowed to interrogate this SNMP agent, it will
+ 	; the specified user will not allowed to interrogate this SNMP agent, it will
-	;only be used to send traps to the configured traps receiver
+ 	;only be used to send traps to the configured traps receiver
-	trap_user=
+ 	trap_user=
 Also you must have a section named like the value set to ''trap_user=''which defines a user for sending the traps.
@@ Line 203: / Line 203: @@
 '''Example'''
-	;SNMP protocol version to use for sending traps (values are SNMPv2c or SNMPv3)
+ 	;SNMP protocol version to use for sending traps (values are SNMPv2c or SNMPv3)
-	proto_version=SNMPv3
+ 	proto_version=SNMPv3
-−
-	; name of user used for sending traps
+ 	; name of user used for sending traps
-	trap_user=testuser
+ 	trap_user=testuser
-−
-	[testuser]
+ 	[testuser]
-	; authentication encryption method ( MD5 | SHA1 )
+  	; authentication encryption method ( MD5 | SHA1 )
-	auth_protocol=SHA1
+ 	auth_protocol=SHA1
-	; authentication pass phrase
+ 	; authentication pass phrase
-	auth_password=testuser
+ 	auth_password=testuser
-	; encryption method ( DES | AES )
+ 	; encryption method ( DES | AES )
-	priv_protocol=DES
+ 	priv_protocol=DES
-	; encryption pass phrase
+ 	; encryption pass phrase
-	priv_password=testuser
+ 	priv_password=testuser
 * Configuring Net-SNMP to receive SNMP traps from YATE
@@ Line 227: / Line 227: @@
 * Add in the file the following line:
-	authCommunity log,execute,net yateSNMP
+ 	authCommunity log,execute,net yateSNMP
 where:
@@ Line 240: / Line 240: @@
 To configure Net-SNMP to receive SNMP v3 traps from YATE add the following lines In ''snmptrapd.conf'' (on Ubuntu, you'll find it in ''/etc/snmp'')
-	createUser -e yateEngineID username MD5 | SHA digestPassPhrase AES | DES
+ 	createUser -e yateEngineID username MD5 | SHA digestPassPhrase AES | DES
-	privPassPhrase
+ 	privPassPhrase
-	authuser log username
+ 	authuser log username
 where:
@@ Line 253: / Line 253: @@
 For the SNMP v3 configuration set above for YATE, the ''snmptrapd.conf'' should contain the following lines:
- 	createUser -e 0x800086c504796174655465737454657874 testuser SHA testuser DES testuser
+  	createUser -e 0x800086c504796174655465737454657874 testuser SHA testuser DES testuser
- 	authuser log testuser
+  	authuser log testuser
 where ''0x800086c504796174655465737454657874'' is the generated ''snmpEngineId''.
@@ Line 260: / Line 260: @@
 If you want to execute a command upon receiving a SNMP trap, you can add a line like this:
-	traphandle OID|default COMMAND [ARGS].
+ 	traphandle OID|default COMMAND [ARGS].
 If you want to forward it to another destination:
-	forward OID|default DESTINATION
+ 	forward OID|default DESTINATION
 Please see Net-SNMP documentation for further details.

@@ Line 146: / Line 146: @@
 To configure the module to send traps, in section [traps] of ''ysnmpagent.conf'' you should first check that the sending of SNMP traps is enabled and that a remote IP and port have been set:
-	[traps]
+ 	[traps]
-	; SNMP traps configuration
+ 	; SNMP traps configuration
-−
-	;enable or disable all notifications. Defaults to true.
+ 	;enable or disable all notifications. Defaults to true.
-	;enable_traps=true
+ 	;enable_traps=true
-−
-	; list traps to disable. Must be separated by ','.
+ 	; list traps to disable. Must be separated by ','.
-	; An entire substree of traps can be disabled by ending the name of the trap
+ 	; An entire substree of traps can be disabled by ending the name of the trap
-	;with ".*"
+ 	;with ".*"
-	; (e.g. disable the whole database status traps by adding database.*)
+ 	; (e.g. disable the whole database status traps by adding database.*)
-	disable_traps=
+ 	disable_traps=
-−
-	; IP address to which the traps are sent. Defaults to localhost.
+ 	; IP address to which the traps are sent. Defaults to localhost.
-	;remote_ip=localhost
+ 	;remote_ip=localhost
-−
-	; port for the remote IP. Defaults to 162.
+ 	; port for the remote IP. Defaults to 162.
-	;remote_port=162
+ 	;remote_port=162
 Also you can disable entire subtrees of notifications by listing them in the value of ''disable_traps='' configuration.

@@ Line 101: / Line 101: @@
 * SNMP v2c
-	proxy -v 2c -c testsnmp 127.0.0.1:16001 .1.3.6.1.4.1.34501
+ 	proxy -v 2c -c testsnmp 127.0.0.1:16001 .1.3.6.1.4.1.34501
-−
-    where:
+     where:
-	- -v 2c specifies the use of SNMPv2c protocol
+ 	- -v 2c specifies the use of SNMPv2c protocol
-	- -c testsnmp is the community string used by the agent where the requests are proxied
+ 	- -c testsnmp is the community string used by the agent where the requests are proxied
-	- the IP address and port where the agent to which the requests are proxied is
+ 	- the IP address and port where the agent to which the requests are proxied is
-	- the subtree of OIDs to proxy (in this case the NULL-TEAM subtree)
+ 	- the subtree of OIDs to proxy (in this case the NULL-TEAM subtree)
 * SNMP v3
-	proxy -v 3 -u username -a MD5|SHA -A authPassPhrase -x AES|DES -X privPassPhrase
+ 	proxy -v 3 -u username -a MD5|SHA -A authPassPhrase -x AES|DES -X privPassPhrase
-	-l authPrivLevel  .1.3.6.1.4.1.34501
+ 	-l authPrivLevel  .1.3.6.1.4.1.34501
-−
-    where:
+      where:
-	- -v 3 specifies the use of SNMPv3 protocol
+ 	- -v 3 specifies the use of SNMPv3 protocol
-	- -u sets the username used for SNMPv3 agent where the requests are proxied
+ 	- -u sets the username used for SNMPv3 agent where the requests are proxied
 	- -a MD5|SHA authentication protocol used for the user and -A the authentication
-	pass phrase
+ 	pass phrase
-	- -x AES|DES privacy protocol used for the user and -X the encryption pass phrase
+ 	- -x AES|DES privacy protocol used for the user and -X the encryption pass phrase
-	- -l authPrivLevel : the security level according to the authentication and
+ 	- -l authPrivLevel : the security level according to the authentication and
-	encryption level (noAuthNoPriv|authNoPriv|authPriv)
+ 	encryption level (noAuthNoPriv|authNoPriv|authPriv)
-	- IP:port - the IP address and port where the agent is
+ 	- IP:port - the IP address and port where the agent is
-	- the subtree of OIDs to proxy
+ 	- the subtree of OIDs to proxy
 ::This tells the daemon that all requests comming with an OID belonging in the .1.3.6.1.4.1.34501 subtree (the Null Team tree) should be proxied to localhost port 16001.
@@ Line 137: / Line 137: @@
 ** Edit the ''snmp.conf'' file of Net-SNMP (''/etc/snmp/snmp.conf'') and add the following lines:
-	mibs +NULL-TEAM-MIB
+ 	mibs +NULL-TEAM-MIB
-	mibs +YATE-MIB
+ 	mibs +YATE-MIB
-−
 === Configuring SNMP traps===

@@ Line 22: / Line 22: @@
          ; port on which the module listens for SNMP messages. Defaults to 161.
-	port=16001
+ 	port=16001
 :: If you're not running YATE as root, you should set a port greater than 1024. Also you might change the port in case you have another server running on port 161  (like Net-SNNMP).
@@ Line 71: / Line 71: @@
   	[userV3]
   	; Configure a section for a SNMPv3 user. The name of the user is the name of
-	; the section.
+ 	; the section.
- 	; To allow SNMPv3 interrogation, at least one SNMPv3 user must be configured
+  	; To allow SNMPv3 interrogation, at least one SNMPv3 user must be configured
-−
- 	; authentication pass phrase. If it is not set, authentication will not be required
+  	; authentication pass phrase. If it is not set, authentication will not be required
- 	;auth_password=
+  	;auth_password=
-−
- 	; authentication method ( MD5 | SHA1 ) in case it is used.
+  	; authentication method ( MD5 | SHA1 ) in case it is used.
- 	;auth_protocol=MD5
+  	;auth_protocol=MD5
-−
- 	; privacy pass phrase. If it is not set, encryption will not be required
+  	; privacy pass phrase. If it is not set, encryption will not be required
- 	;priv_password=
+  	;priv_password=
-−
-	; privacy encryption method ( DES | AES). Default is DES.
+ 	; privacy encryption method ( DES | AES). Default is DES.
- 	;priv_protocol=DES
+   	;priv_protocol=DES
-−
- 	; user access level. Mandatory. Acceptable values are: readonly, readwrite, readcreate.
+  	; user access level. Mandatory. Acceptable values are: readonly, readwrite, readcreate.
- 	;access=
+   	;access=
 === Configuring Net-SNMP to proxy SNMP requests to YATE===