Difference between revisions of "SNMP configuration example"
PauliusRug (talk | contribs) |
|||
(26 intermediate revisions by 4 users not shown) | |||
Line 18: | Line 18: | ||
===RUT9xx=== | ===RUT9xx=== | ||
− | To setup SNMP first make sure that SNMP package is installed, more information here [[RUT955 Packages]] and [[ | + | To setup SNMP first make sure that SNMP package is installed, more information here [[RUT955 Packages]] and [[RUT950 Packages]]. |
==OID codes== | ==OID codes== | ||
OID code (Object identifier code) - is an address used to identify devices and their status. | OID code (Object identifier code) - is an address used to identify devices and their status. | ||
− | |||
[[File:SNMP_OID_MIB_Tree.png]] | [[File:SNMP_OID_MIB_Tree.png]] | ||
Line 69: | Line 68: | ||
</tr> | </tr> | ||
<table> | <table> | ||
− | + | ||
To communicate with Teltonika router the start of the OID code, in this case, will be 1.3.6.1.4.1.48690. | To communicate with Teltonika router the start of the OID code, in this case, will be 1.3.6.1.4.1.48690. | ||
Line 83: | Line 82: | ||
<td>static</td> | <td>static</td> | ||
<td>1</td> | <td>1</td> | ||
− | <td>Static router information (Router name, Modem Imei, Modem | + | <td>Static router information (Router name, Modem Imei, Modem Modle etc.)</td> |
</tr> | </tr> | ||
<tr> | <tr> | ||
Line 116: | Line 115: | ||
</tr> | </tr> | ||
<table> | <table> | ||
− | |||
To access variable values, after enterprise number add field number and then specify variable number. For example: .1.3.6.1.4.1.48690.1.7.0 represents router name (48690.1.7.0: Enterprise (48690) - Teltonika, Field (1) - static, Variable (7.0) - routerName). All OID codes can be generated from MIB file, basic OID codes can be found here [[RUT955 SNMP#SNMP Variables list]]. | To access variable values, after enterprise number add field number and then specify variable number. For example: .1.3.6.1.4.1.48690.1.7.0 represents router name (48690.1.7.0: Enterprise (48690) - Teltonika, Field (1) - static, Variable (7.0) - routerName). All OID codes can be generated from MIB file, basic OID codes can be found here [[RUT955 SNMP#SNMP Variables list]]. | ||
==MIB File== | ==MIB File== | ||
− | MIB File can be used with MIB browsers for easier access to configuration and status information variables | + | MIB File can be used with MIB browsers for easier access to router configuration and status information variables. Download the MIB file and upload/load it in MIB browser. |
− | + | [[File:Networking device configrationexample snmp mib browser v1.png]] | |
− | |||
− | [[File:Networking device configrationexample snmp mib browser | ||
===Generating OID code from MIB File=== | ===Generating OID code from MIB File=== | ||
MIB File contains all OID codes. | MIB File contains all OID codes. | ||
Line containing numbers needed for OID code can be identified by this marking "::=". | Line containing numbers needed for OID code can be identified by this marking "::=". | ||
− | + | [[File:Networking device configurationexample snmp mib file oid codes v1.png|middle]] | |
− | [[File:Networking device configurationexample snmp mib file oid codes v1.png]] | ||
All that is left, is to add the numbers together. Example from given MIB File: 1.3.6.1.4.1.48690.1.1.0. | All that is left, is to add the numbers together. Example from given MIB File: 1.3.6.1.4.1.48690.1.1.0. | ||
Line 135: | Line 130: | ||
==SNMP Configuration== | ==SNMP Configuration== | ||
− | To configure SNMP, first enable SNMP service, leave or change the port, you can leave everything else as it is. | + | To configure SNMP, first enable SNMP service, leave or change the port, you can leave everything else as it is. |
− | |||
− | |||
− | |||
[[File:Networking_device_configurationexample_snmp_snmpconfiguration_v1.png]] | [[File:Networking_device_configurationexample_snmp_snmpconfiguration_v1.png]] | ||
===Testing SNMP with MIB browser=== | ===Testing SNMP with MIB browser=== | ||
− | Use MIB browser to test if SNMP works. Make sure to use same port and IP address of the router in MIB browser | + | Use MIB browser to test if SNMP works. Make sure to use same port and IP address of the router in MIB browser, upload/load MIB file. MIB browser lets you walk through all OID codes, or return a distinct variable value. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
===Testing SNMP with console command=== | ===Testing SNMP with console command=== | ||
Line 162: | Line 147: | ||
==Trap Configuration== | ==Trap Configuration== | ||
− | First enable SNMP Trap, then enter '''Host/IP''', Hots/IP is the SNMP manager, computer to which SNMP agent will send Trap messages. If router is connected to PC via ethernet cable, enter the IP address of the interface the router is connected to. You can use '''ipconfig''' command on windows, '''ifconfig''' on linux to find IP address of the interface to which router is connected. Next choose '''port''', preferably choose port number higher than '''1024''' so SNMP manager could establish connection without root/admin rights. | + | First enable SNMP Trap, then enter '''Host/IP''', Hots/IP is the SNMP manager, computer to which SNMP agent will send Trap messages. If router is connected to PC via ethernet cable, enter the IP address of the interface the router is connected to. You can use '''ipconfig''' command on windows, '''ifconfig''' on linux to find IP address of the interface to which router is connected. Next choose '''port''', preferably choose port number higher than '''1024''' so SNMP manager could establish connection without root/admin rights. |
− | |||
[[File:Networking device configurationexample trap configurations v1.png]] | [[File:Networking device configurationexample trap configurations v1.png]] | ||
===Trap rules=== | ===Trap rules=== | ||
− | Trap rules describe on what event SNMP agent should send Trap messages. | + | Trap rules describe on what event SNMP agent should send Trap messages. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− |
Revision as of 12:52, 11 September 2019
Main Page > General Information > Configuration Examples > SNMP > SNMP configuration exampleSummary
This chapter is a guide on configuring SNMP package to establish communication between devices.
SNMP
SNMP (Simple Network Management Protocol) - is widely used in networking management for networking monitoring. SNMP uses MIB (Management Information Base) to organize management data in the form of variables, which describe the system configuration and status.
Trap
Traps are alert messages sent by SNMP agent to SNMP manager.
SNMP agent - Teltonika router. Device which sends Trap messages to the manager.
SNMP manager - device which listens for Trap messages from the agents.
Teltonika routers are able to send SNMP Trap messages to the manager on their own when they experience a problem or a situation described in the rules.
Preconditions
RUT9xx
To setup SNMP first make sure that SNMP package is installed, more information here RUT955 Packages and RUT950 Packages.
OID codes
OID code (Object identifier code) - is an address used to identify devices and their status.
OID code is represented by the numbers in the boxes starting from "root".
Number | Label | Explanation |
---|---|---|
1 | iso | ISO is the group that established the OID standard |
3 | org | An organization will be specified next |
6 | dod | The US Department of Defense (established the early internet) |
1 | internet | Communication will be via Internet/network |
4 | private | This is a device manufactured by a private entity |
1 | enterprise | The device manufacturer is classified as an enterprise |
48690 | Teltonika | Teltonika enterprise number |
Field | Number | Explanation |
---|---|---|
static | 1 | Static router information (Router name, Modem Imei, Modem Modle etc.) |
gsm | 2 | Sim card information (Sim State, Operator, Mobile IP etc.) |
hotspot | 3 | Hotspot information (Hotspot ip, users etc.) |
Trap | 4 | Trap messages (Information sent through trap messages) |
rut9x5 | 5 | Input/Output information |
gps | 6 | GPS information (Latitude, accuracy etc.) |
ethernet | 7 | Information about router ports |
MIB File
MIB File can be used with MIB browsers for easier access to router configuration and status information variables. Download the MIB file and upload/load it in MIB browser.
Generating OID code from MIB File
MIB File contains all OID codes. Line containing numbers needed for OID code can be identified by this marking "::=".
All that is left, is to add the numbers together. Example from given MIB File: 1.3.6.1.4.1.48690.1.1.0.
Important note: Do not forget to add .0 at the end of the generated OID code, except to Trap OID codes. Trap OID codes are only used by SNMP agent (router), using them in MIB browser or command line will not give any results.
SNMP Configuration
To configure SNMP, first enable SNMP service, leave or change the port, you can leave everything else as it is.
Testing SNMP with MIB browser
Use MIB browser to test if SNMP works. Make sure to use same port and IP address of the router in MIB browser, upload/load MIB file. MIB browser lets you walk through all OID codes, or return a distinct variable value.
Testing SNMP with console command
We can use snmpget command to get information from router:
$ snmpget -c public -v 2c IP_address:port OID_code
Example:
$ snmpget -c public -v 2c 192.168.1.1:161 1.3.6.1.4.1.48690.1.7.0
Trap Configuration
First enable SNMP Trap, then enter Host/IP, Hots/IP is the SNMP manager, computer to which SNMP agent will send Trap messages. If router is connected to PC via ethernet cable, enter the IP address of the interface the router is connected to. You can use ipconfig command on windows, ifconfig on linux to find IP address of the interface to which router is connected. Next choose port, preferably choose port number higher than 1024 so SNMP manager could establish connection without root/admin rights.
Trap rules
Trap rules describe on what event SNMP agent should send Trap messages.