SNMP configuration example: Difference between revisions

(18 intermediate revisions by 4 users not shown)

Line 18:

===RUT9xx===

To setup SNMP first make sure that SNMP package is installed, more information here [[~~RUT955~~ Packages]] and [[~~RUT950~~ Packages]].

To setup SNMP first make sure that SNMP package is installed, more information here [[RUT956 Packages]] and [[RUT951_Package_Manager|RUT951 Packages]].

==OID codes==

Line 123:

In this example '''iReasoning MIB browser''' was used '''only for testing purpose'''.

[[File:Networking device configrationexample snmp mib browser v1.png]]

[[File:Networking device configrationexample snmp mib browser v2.png]]

===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 "::=".

[[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.

Line 135:

==SNMP Configuration==

To configure SNMP, first enable SNMP service, leave or change the port, you can leave everything else as it is~~. Press "Download" button to download MIB file~~.

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

Press "Download" button to download MIB file.

[[File:SNMP_config_example_7.8_5.png]]

===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~~.

Use MIB browser to test if SNMP works. Make sure to use same port and IP address of the router in MIB browser. To enter port number in MIB browser press "Advanced" button '''(on the right of IP address field)'''.

[[File:Networking device configurationexample mib browser port v2.png]]

[[File:Networking device configurationexample snmp test example v1.png]]

To upload/load MIB file press "File" in menu bar '''(top left side of the window)''' and press "Load MIBs", '''make sure to select the MIB file you downloaded from the WebUI'''. MIB browser lets you walk through all OID codes, or return a distinct variable value. To walk through all OID codes select "walk" in Operation tab '''(top left of the window)'''. To iterate through OID codes manually, navigate to the desired folder on the left of the MIB browser window and select specific element '''(Double click)'''. The value of the variable will be printed in the '''Result Table'''.

[[File:Networking device configurationexample snmp test example v2.png]]

===Testing SNMP with console command===

Line 157:

Line 164:

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. If you choose to leave default port '''162''' make sure to launch SNMP manager with admin/root permissions.

[[File:~~Networking device configurationexample trap configurations v1~~.png]]

[[File:SNMP_config_example_7.8_1.png]]

===Trap rules===

Trap rules describe on what event SNMP agent should send Trap messages. There are certain rules which can be set up using Teltonika WebUI depending on physical configuration of the device.

====Events log====

----

<tr>

<th>Event</th>

<th>~~Value~~</th>

<th>Event subtype</th>

<th>~~Explanation~~</th>

<th>Description</th>

</tr>

<tr>

<td>Config change</td>

<td>All | Specific config change; default: all</td>

<td>Informs on changes to the device's configuration.</td>

</tr>

<tr>

<td>Reboot</td>

<td>Informs on if the device was rebooted.</td>

</tr>

<tr>

<td>Startup</td>

<td>Device startup completed</td>

<td>Informs on when the device is fully booted.</td>

</tr>

<tr>

<td>All | Entered geofence | Left geofence; default: All</td>

<td>Informs on when the device has entered or left a user defined geofence zone.</td>

</tr>

<tr>

<td>Mobile data</td>

<td>All | Connected | Disconnected; default All</td>

<td>Informs on changes to the state of the device's mobile connection.</td>

</tr>

<tr>

<td>New DHCP client</td>

<td>All | Connected from LAN | Connected from WiFi; default All</td>

<td>Informs on new DHCP lease give outs.</td>

</tr>

<tr>

<td>Ports state</td>

<td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes.</td>

</tr>

<tr>

<td>~~Signal strength trap~~</td>

<td>Reboot</td>

<td>~~Minimal mobile signal strength~~</td>

<td>~~Teltonika~~ device ~~will send trap message when mobile signal strength falls lower than specified~~</td>

<td>Informs after device reboot occurrences.</td>

</tr>

<tr>

<td>~~Connection type trap~~</td>

<td>Signal strength</td>

<td>~~This trap does not have value~~</td>

<td>~~Teltonika device will send trap message when mobile connection establishes or~~ changes</td>

<td>Informs on signal strength changes.</td>

</tr>

<tr>

<td>~~Digital input trap~~</td>

<td>~~Inactive/Active/Both~~</td>

<td>SMS received</td>

<td>~~Teltonika device will send trap message when Digital input value changes to specified value~~</td>

<td>Informs on received SMS messages.</td>

</tr>

<tr>

<td>~~Digital isolated input trap~~</td>

<td>~~Inactive~~/~~Active/Both~~</td>

<td>All | Successful authentication | Unsuccessful authentication; default: All</td>

<td>~~Teltonika device will send trap message when Digital isolated input value changes to specified value~~</td>

<td>Informs on successful or unsuccessful SSH login attempts.</td>

</tr>

<tr>

<td>~~Analog input trap~~</td>

<td>Topology state</td>

<td>~~Higher/Lower/Both + Voltage value~~</td>

<td>Topology changes</td>

<td>~~Teltonika~~ device ~~will send trap message when Analog input value fulfills specified requirement~~</td>

<td>Informs on changes to the device's network topology.</td>

</tr>

<tr>

<td>~~Digital output trap~~</td>

<td>WAN failover</td>

<td>~~Inactive~~/~~Active/Both~~</td>

<td>All | Switched to failover | Switched to main; default: All</td>

<td>~~Teltonika device will send trap message when Digital output value changes to specified value~~</td>

<td>Informs on WAN failover occurrences.</td>

</tr>

<tr>

<td>~~Digital relay output trap~~</td>

<td>WebUI</td>

<td>~~Inactive~~/~~Active/Both~~</td>

<td>ALL | Successful authentication | Unsuccessful authentication; default: All</td>

<td>~~Teltonika device will send trap message when Digital relay output value changes to specified value~~</td>

<td>Informs on successful or unsuccessful HTTP/HTTPS login attempts.</td>

</tr>

<tr>

<table>

<td>New WiFi client</td>

<td>All | Connected | Disconnected; default: All</td>

<td>Informs on new WiFi clients. Possible triggers are:</td>

</tr>

</table>

----

To create new rule chose action and press "Add" button, specify rule values and save.

To create new rule chose action and press "Add" button, specify rule values and save:

~~Example~~: ~~choose "Connection type trap" action and press "Add" button.~~

[[File:~~Networking device configurationexample snmp trap rule v1~~.png]]

[[File:SNMP_config_example_7.8_2.png|1000px]]

----

~~Enable~~ trap ~~rule and press "Save".~~

Modify the trap to your needs:

[[File:SNMP_config_example_7.8_3.png|1000px]]

[[File:~~Networking device configurationexample snmp new connection rule v1~~.png]]

----

New rule should appear in the main Trap window.

New rule should appear in the main Trap rules window:

[[File:SNMP_config_example_7.8_4.png|1000px]]

[[File:~~Networking device configurationexample new snmp rule saved v1~~.png]]

----

====Testing Trap with MIB browser====

Line 225:

Line 269:

'''Note:''' Preferably open MIB browser with root/admin permissions.

[[File:Networking device configurationexample snmp trap receiver config v1.png]]

[[File:Networking device configurationexample snmp trap receiver config v2.png]]

----

To test "Connection type trap" reboot mobile modem. You can reboot modem through Status -> Network window.

MIB browser should receive Trap message.

[[File:Networking configurationexample received trap v1.png]]

[[File:Networking configurationexample received trap v2.png]]

===Testing Trap with Linux Terminal===

To test Traps with Linux terminal extra configurations and packages are required. All information how to setup Trap listening service and how to test it can be found here [[Testing Trap With Linux Operating System]].

[[Category:SNMP]]