Jump to content
  • EN

Template:Networking rutos manual snmp: Difference between revisions

From Teltonika Networks Wiki
← Older edit
VisualWikitext
No edit summary
No edit summary
 
(38 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wireless}}} (1), {{eth}} (1) -->
<!-- Template uses {{{name}}}, {{{series}}}, {{{mobile}}} (0), {{{gps}}} (1), {{{wireless}}} (1), {{eth}} (1) -->
{{Template: Networking_rutos_manual_fw_disclosure
{{Template: Networking_device_manual_fw_disclosure
| fw_version ={{Template: Networking_rutos_manual_latest_fw
| series = {{{series}}}
| name  = {{{name}}}
| fw_version ={{Template: Networking_device_manual_latest_fw
  | series = {{{series}}}
  | series = {{{series}}}
  | name  = {{{name}}}
  | name  = {{{name}}}
  }}
  }}
}}
}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} SNMP (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT9 |<br><i><b>Note</b>: <b>[[{{{name}}} SNMP (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT9XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} SNMP (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_rutos_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
{{#ifeq: {{{series}}} | RUT2 |<br><i><b>Note</b>: <b>[[{{{name}}} SNMP (legacy WebUI)|click here]]</b> for the old style WebUI (FW version {{Template: Networking_device_manual_latest_fw | series = RUT2XX}} and earlier) user manual page.</i>|}}
==Summary==
==Summary==


Line 14: Line 16:
<u><b>
<u><b>


Note:</b> SNMP is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u>
Note:</b> SNMP is additional software that can be installed from the <b>System → [[{{{name}}} Package Manager|Package Manager]]</b> page.</u>}}
}}
 
{{Template:Networking_rutos_manual_basic_advanced_webui_disclaimer
| series = {{{series}}}
}}


==SNMP settings==
==SNMP settings==
Line 27: Line 24:
===SNMP agent settings===
===SNMP agent settings===
----
----
[[File:Networking_rutos_manual_snmp_snmp_agent_settings_v2.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_snmp_agent_settings_v3.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 38: Line 35:
         <td>Enable SNMP service</td>
         <td>Enable SNMP service</td>
         <td>off | on; default: <b>off</b></td>
         <td>off | on; default: <b>off</b></td>
         <td>Run SNMP service on system's startup.</td>
         <td>Enable SNMP (Simple Network Management Protocol) service on system startup.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Enable remote access</td>
         <td>Enable remote access</td>
         <td>off | on; default: <b>off</b></td>
         <td>off | on; default: <b>off</b></td>
         <td>Open port in firewall so that SNMP service may be reached from WAN.</td>
         <td>Create a firewall rule that allows access to SNMP for remote hosts.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 53: Line 50:
         <td>Port</td>
         <td>Port</td>
         <td>integer [0..65535]; default: '''161'''</td>
         <td>integer [0..65535]; default: '''161'''</td>
         <td>SNMP service's port.</td>
         <td>TCP/UDP port number used for the connection.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>SNMP v1 Mode</td>
         <td>SNMP v1 Mode</td>
         <td>off | on; default: '''on'''</td>
         <td>off | on; default: <b>on</b></td>
         <td>Enable/disable SNMP v1 Mode.</td>
         <td>Enable/disable SNMP v1 Mode.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>SNMP v2c Mode</td>
         <td>SNMP v2c Mode</td>
         <td>off | on; default: '''on'''</td>
         <td>off | on; default: <b>on</b></td>
         <td>Enable/disable SNMP v2c Mode.</td>
         <td>Enable/disable SNMP v2c Mode.</td>
     </tr>
     </tr>
Line 76: Line 73:
The <b>SNMP System Summary</b> section contains general information about SNMP on this device. You can also download this device's <b>MIB file</b> from this section.
The <b>SNMP System Summary</b> section contains general information about SNMP on this device. You can also download this device's <b>MIB file</b> from this section.


[[File:Networking_rutos_manual_snmp_snmp_system_summary.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_snmp_system_summary_v1.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 87: Line 84:
         <td>MIB file</td>
         <td>MIB file</td>
         <td>-(interactive button)</td>
         <td>-(interactive button)</td>
         <td>Downloads the device's MIB file.</td>
         <td>Download the MIB file containing custom Teltonika module tree for this device.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>System OID</td>
         <td>Teltonika OID path</td>
         <td>1.3.6.1.4.1.48690</td>
         <td>1.3.6.1.4.1.48690</td>
         <td>OID or Object Identifier, is an identifier used to name and point to an object in the MIB hierarchy.</td>
         <td>The OID path containing Teltonika IANA Private Enterprise Number (PEN). All custom private SNMP modules are referenced under this OID path.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Location</td>
         <td>Location</td>
         <td>string; default: <b>location</b></td>
         <td>string; default: <b>location</b></td>
         <td>Trap named sysLocation.</td>
         <td>Location of the system. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Contact</td>
         <td>Contact</td>
         <td>string; default: <b>[email protected]</b></td>
         <td>string; default: <b>[email protected]</b></td>
         <td>Trap named sysContact.</td>
         <td>Contact information. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Name</td>
         <td>Name</td>
         <td>string; default: <b>name</b></td>
         <td>string; default: <b>name</b></td>
         <td>Trap named sysName.</td>
         <td>Name of the system. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.</td>
     </tr>
     </tr>
</table>
</table>
Line 142: Line 139:
         <td>Username</td>
         <td>Username</td>
         <td>string; default: <b>none</b> </td>
         <td>string; default: <b>none</b> </td>
         <td>Set username to access SNMP.</td>
         <td>Name of the SNMP user configuration.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 175: Line 172:
     <tr>
     <tr>
         <td>Access Mode</td>
         <td>Access Mode</td>
         <td>Read-Only | Read-Write; default: '''Read-Only'''</td>
         <td>Read-Only | Read-Write; default: <b>Read-Only</b></td>
         <td>The access mode specifies the access the hosts in the community are allowed with respect to retrieving and modifying the MIB variables from a specific SNMP agent.</td>
         <td>Access mode specifies which access the host has in the community and if they are allowed to retrieve and modify MIB variables from a specific SNMP agent.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 189: Line 186:
The <b>SNMP Community</b> section is used to manage access rights. You can edit an SNMP community by clicking the 'Edit' button next to it:
The <b>SNMP Community</b> section is used to manage access rights. You can edit an SNMP community by clicking the 'Edit' button next to it:


[[File:Networking_rutos_manual_snmp_communities_edit_button.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_communities_edit_button_v1.png|border|class=tlt-border]]


This will redirect you to the community's configuration page.
This will redirect you to the community's configuration page.
Line 204: Line 201:
         <td>Community name</td>
         <td>Community name</td>
         <td>string; default: <b>none</b></td>
         <td>string; default: <b>none</b></td>
         <td>Name of the community.</td>
         <td>SNMP community name is an ID that allows access to a routers SNMP data.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 219: Line 216:
         <td>Access Mode</td>
         <td>Access Mode</td>
         <td>Read-Only | Read-Write; default: <b>Read-Only</b></td>
         <td>Read-Only | Read-Write; default: <b>Read-Only</b></td>
         <td>Access mode for current community.</td>
         <td>Access mode specifies if you can only read or read and write information from and to the device.</td>
     </tr>
     </tr>
</table>
</table>
Line 258: Line 255:
===Trap Service Settings===
===Trap Service Settings===
----
----
The <b>Trap Service Settings</b> is used to manage <b>hosts</b> which will be alerted when an SNMP trap is triggered. The host list is empty by default thus, to begin configuration you must first create at least one host.
The <b>Trap Service Settings</b> is used to manage <b>host</b> which will be alerted when an SNMP trap is triggered
 
Click the 'Add' button at the bottom-right side of the table to create a new host.
 
[[File:Networking_rutos_manual_snmp_trap_settings_trap_service_settings_add_button.png|border|class=tlt-border]]
 
The newly added Host configuration should look similar to this:


[[File:Networking_rutos_manual_snmp_trap_settings_trap_service_settings_configuration.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_trap_settings_trap_service_settings_configuration_v2.png|border|class=tlt-border]]


<table class="nd-mantable">
<table class="nd-mantable">
Line 275: Line 266:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Host/IP</td>
        <td>Enable</td>
        <td>off | on; default: <b>off</b></td>
        <td>Enables Trap service.</td>
    </tr>
    <tr>
         <td>Host</td>
         <td>url | ip; default: <b>none</b></td>
         <td>url | ip; default: <b>none</b></td>
         <td>Hostname or IP address to transfer SNMP traffic to.</td>
         <td>Host to transfer SNMP (Simple Network Management Protocol) traffic to.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Port</td>
         <td>Port</td>
         <td>integer [0..65535]; default: <b>162</b></td>
         <td>integer [0..65535]; default: <b>162</b></td>
         <td>Trap host's port number.</td>
         <td>Port for trap host.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Community</td>
         <td>Community</td>
         <td>string; default: <b>Public</b></td>
         <td>string; default: <b>public</b></td>
         <td>Name of the community to which the trap belongs.</td>
         <td>The SNMP (Simple Network Management Protocol) community is an ID that allows access to a routers SNMP data.</td>
    </tr>
    <tr>
        <td>Delete</td>
        <td>- (interactive button)</td>
        <td>Deletes the host next to the button.</td>
    </tr>
    <tr>
        <td>off/on slider</td>
        <td>off | on; default: <b>off</b></td>
        <td>Turns the host on or off. SNMP traffic is only sent to enabled hosts.</td>
     </tr>
     </tr>
</table>
</table>
Line 307: Line 293:
You can create a new trap rule by clicking the 'Add' button.
You can create a new trap rule by clicking the 'Add' button.


[[File:Networking_rutos_manual_snmp_trap_settings_trap_rules_add_button.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_trap_settings_trap_rules_add_button_v2.png|border|class=tlt-border]]


You should be redirected to the rule's configuration page which should look something like this:
You should be redirected to the rule's configuration page which should look something like this:


[[File:Networking_rutos_manual_snmp_trap_settings_trap_rules_modify_trap_rule_mobile_{{{mobile}}}.png|border|class=tlt-border]]
[[File:Networking_rutos_manual_snmp_trap_settings_trap_rules_modify_trap_rule_{{{mobile}}}.png|border|class=tlt-border]]


Above is an example of what rule configuration window looks like. Below is a table with detailed explanations on how to configure the rule and what each of the fields mean.  
Above is an example of what rule configuration window looks like. Below is a table with detailed explanations on how to configure the rule and what each of the fields mean.  
Line 319: Line 305:


{{#ifeq: {{{mobile}}} | 1 |
{{#ifeq: {{{mobile}}} | 1 |
====Signal strength====
====GSM Trap type====
----
----
<table class="nd-mantable">
<table class="nd-mantable">
Line 328: Line 314:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Enable</td>
         <td>Trigger</td>
         <td>off <nowiki>|</nowiki> on; default: <b>off</b></td>
         <td><span style="color:blue">Signal strength</span> {{!}} Network type</td>
         <td>Enable or disable this rule.</td>
         <td>The trigger which invokes the rule.</td>
    </tr>
    <tr>
        <td>Action</td>
        <td>Signal strength trap</td>
        <td>Rule will be triggered if signal strength falls below specified number.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>Signal strength</td>
         <td><span style="color:blue">Signal strength</span></td>
         <td>integer [-130..0]; default: <b>none</b></td>
         <td>integer [-130..0]; default: <b>none</b></td>
         <td>GSM signal's strength value in dBm, e.g. -85</td>
         <td>GSM signal's strength value in dBm, e.g. -85</td>
     </tr>
     </tr>
</table>
</table>|}}
<br>
====Connection type====
----
<table class="nd-mantable">
    <tr>
        <th>Field</th>
        <th>Value</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>Enable</td>
        <td>off <nowiki>|</nowiki> on; default: <b>off</b></td>
        <td>Enable or disable this rule.</td>
    </tr>


    <tr>
{{#ifeq: {{{io}}} | 1 |
        <td>Action</td>
====Input/Output Trap type====
        <td>Connection type trap</td>
        <td>Rule will be triggered when connection type will change.</td>
    </tr>
</table>
<br>|}}
 
 
====Input/Output====
----
----
<table class="nd-mantable">
<table class="nd-mantable">
     <tr>
     <tr>
         <th>field name</th>
         <th>field name</th>
         <th>value1</th>
         <th>value</th>
         <th>description</th>
         <th>description</th>
    </tr>
    <tr>
        <td>Enable</td>
        <td>off | on; default: <b>off</b></td>
        <td>Enable or disable this rule.</td>
    </tr>
    <tr>
        <td>Action</td>
        <td>Input/Output trap</td>
        <td>Rule will be triggered when specified input or output state will change.</td>
     </tr>
     </tr>
{{#switch:{{{series}}}
{{#switch:{{{series}}}
|RUTX|RUTM =  
|RUTX|RUTM|#default =  
    <tr>
        <td>Input/Output type</td>
        <td>Input/Output; default: <b>Input/Output</b></td>
        <td>Which type of Inputs and Outputs to use in this rule.</td>
    </tr>
     <tr>
     <tr>
         <td>Input/Output name</td>
         <td>Trigger</td>
         <td>Output(4) {{!}} Input(3); default: <b>Output(4)</b></td>
         <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
         <td>Which type of Inputs and Outputs to use in this rule.</td>
         <td>The trigger which invokes the rule.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td>State change</td>
         <td>State change</td>
         <td>High level {{!}} Low level {{!}} Both; default: <b>High level</b></td>
         <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
         <td>On which Input/Output state will this rule be triggered.</td>
         <td>Selects which pin state will trigger the SNMP trap.</td>
     </tr>
     </tr>
|TRB2 =
|TRB2|TRB2M =
     <tr>
     <tr>
         <td>Input/Output type</td>
         <td>Trigger</td>
         <td><span style="color:blue">Input/Output</span> {{!}} <span style="color:red">ADC</span>; default: <b>Input/Output</b></td>
         <td><span style="color:red">Analog Input (11)</span> {{!}} <span style="color:blue">Configurable Input/Output([2..4])</span>; default: <b>Configurable Input/Output(2)</b></td>
         <td>Which type of Inputs and Outputs to use in this rule.</td>
         <td>The trigger which invokes the rule.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color:blue">Input/Output:</span> Input/Output name</td>
         <td><span style="color:red">Analog Input (11):</span> State change</td>
         <td>Configurable Input/Output([2..4]); default: <b>Configurable Input/Output(2)</b></td>
         <td>In range {{!}} Out of range {{!}} Both; default: <b>Both</b></td>
         <td>Which type of Inputs and Outputs to use in this rule.</td>
         <td>Selects which pin state will trigger the SNMP trap.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color:blue">Input/Output:</span> State change</td>
         <td><span style="color:blue">Configurable Input/Output([2..4]):</span> State change</td>
         <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
         <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
         <td>On which Input/Output state will this rule be triggered.</td>
         <td>Selects which pin state will trigger the SNMP trap.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color:red">ADC:</span> Input/Output name</td>
         <td><span style="color:red">Analog Input (11):</span> Min voltage</td>
         <td>ADC; default: <b>ADC</b></td>
         <td>positive numbers; default: <b>none</b></td>
         <td>Which type of Inputs and Outputs to use in this rule.</td>
         <td>Specifies minimum voltage of the range.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><span style="color:red">ADC:</span> Voltage</td>
         <td><span style="color:red">Analog Input (11):</span>Max voltage</td>
         <td>positive float [0..40]; default: <b>none</b></td>
         <td>positive numbers; default: <b>none</b></td>
         <td>At which voltage value will this rule be triggered.</td>
         <td>Specifies maximum voltage of the range.</td>
     </tr>
     </tr>
|TRB1 =
|TRB1 =
     {{#ifeq:{{{name}}}|TRB141|
     {{#ifeq:{{{name}}}|TRB141|
         <tr>
         <tr>
             <td>Input/Output type</td>
             <td>Trigger</td>
             <td><span style="color:blue"><b>Input/Output</b></span> {{!}} <span style="color:dodgerblue"><b>Wet/Dry Input</b></span> {{!}} <span style="color:forestgreen"><b>Relay</b></span> {{!}} <span style="color:darkred"><b>4–20 mA Current Loop</b></span> {{!}} <span style="color:chocolate"><b>ADC</b></span>; default: <b>Input/Output</b></td>
             <td><span style="color:red">Analog Current Loop (7)</span> {{!}} <span style="color:blue">Analog Input (7)</span> {{!}} <span style="color:olive">Passive/Active input (Dry/Wet) (1)</span> {{!}} <span style="color:olive">Passive/Active input (Dry/Wet) (2)</span> {{!}} Configurable Input/Output (3) {{!}} Configurable Input/Output (4) {{!}} Isolated Input (8,16) {{!}} <span style="color:brown">Relay (3,4,5)</span> {{!}} <span style="color:brown">Latching Relay (11,12,13)</span>; default: <b>Analog Current Loop (7)</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>The trigger which invokes the rule.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:blue">Input/Output:</span> Input/Output name</td>
             <td><span style="color:red">Analog Current Loop (7)</span> {{!}} <span style="color:blue">Analog Input (7)</span>: State change</td>
             <td>Configurable Input/Output(3) {{!}} Configurable Input/Output(4); default: <b>Configurable Input/Output(3)</b></td>
             <td>In range {{!}} Out of range {{!}} Both; default: <b>Both</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:blue">Input/Output:</span> State change</td>
             <td><span style="color:red">Analog Current Loop (7):</span> Min current</td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>High level</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Specifies minimum current of the range. Values between 4-20mA.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:dodgerblue">Wet/Dry Input:</span> Input/Output name</td>
             <td><span style="color:red">Analog Current Loop (7):</span> Max current</td>
             <td>Wet/Dry Input(1) {{!}} Wet/Dry Input(2); default: <b>Wet/Dry Input(1)</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Specifies maximum current of the range. Values between 4-20mA.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:dodgerblue">Wet/Dry Input:</span> State change</td>
             <td><span style="color:blue">Analog Input (7):</span> Min voltage</td>
             <td>Rising {{!}} Falling {{!}} Both; default: <b>Rising</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Specifies minimum voltage of the range.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:forestgreen">Relay:</span> Input/Output name</td>
             <td><span style="color:blue">Analog Input (7):</span> Max voltage</td>
             <td>Relay(3,4,5) {{!}} Latching relay(11,12,13); default: <b>Relay(3,4,5)</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Specifies maximum voltage of the range.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:forestgreen">Relay:</span> State change</td>
             <td>State change</td>
             <td>Open {{!}} Closed {{!}} Both; default: <b>Open</b></td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
        </tr>
        <tr>
            <td><span style="color:darkred">4–20 mA Current Loop:</span> Input/Output name</td>
            <td>4–20 mA Current Loop; default: <b>4–20 mA Current Loop</b></td>
            <td>Which type of Inputs and Outputs to use in this rule.</td>
        </tr>
        <tr>
            <td><span style="color:darkred">4–20 mA Current Loop:</span> Voltage</td>
            <td>positive float [0..40]; default: <b>none</b></td>
            <td>At which voltage value will this rule be triggered.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:chocolate">ADC:</span> Input/Output name</td>
             <td><span style="color:olive">Passive/Active input (Dry/Wet) (1)</span> {{!}} <span style="color:olive">Passive/Active input (Dry/Wet) (2)</span>: State change</td>
             <td>ADC; default: <b>ADC</b></td>
             <td>Rising {{!}} Falling {{!}} Both; default: <b>Both</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:chocolate">ADC:</span> Voltage</td>
             <td><span style="color:brown">Passive/Active input (Dry/Wet) (1)</span> {{!}} <span style="color:brown">Passive/Active input (Dry/Wet) (2)</span>: State change</td>
             <td>positive float [0..40]; default: <b>none</b></td>
             <td>Open {{!}} Closed {{!}} Both; default: <b>Both</b></td>
             <td>At which voltage value will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
     |
     |
        <tr>
        <tr>
             <td>Input/Output type</td>
             <td>Trigger</td>
            <td>Input/Output; default: <b>Input/Output</b></td>
            <td>Which type of Inputs and Outputs to use in this rule.</td>
        </tr>
        <tr>
            <td>Input/Output name</td>
             <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
             <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>The trigger which invokes the rule.</td>
        </tr>
        </tr>
        <tr>
        <tr>
             <td>State change</td>
             <td>State change</td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>High level</b></td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
        </tr>}}
        </tr>}}
|RUT36X =
|RUT36X|RUT361|RUT30X|RUT301 =
        <tr>
            <td>Input/Output type</td>
            <td>Input/Output; default: <b>Input/Output</b></td>
            <td>Which type of Inputs and Outputs to use in this rule.</td>
        </tr>
         <tr>
         <tr>
             <td>Input/Output name</td>
             <td>Trigger</td>
             <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
             <td>Configurable Input/Output (3) {{!}} Configurable Input/Output (4); default: <b>Configurable Input/Output (3)</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>The trigger which invokes the rule.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td>State change</td>
             <td>State change</td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>High level</b></td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
|RUT9 =
|RUT9|RUT9M =
     {{#ifeq:{{{name}}}|RUT955|
     {{#switch:{{{name}}}|RUT955|RUT906|RUT951|RUT956|RUT976=
         <tr>
         <tr>
             <td>Input/Output type</td>
             <td>Trigger</td>
             <td><span style="color:blue">Input/Output</span> {{!}} <span style="color:forestgreen"><b>Relay</b></span> {{!}} <span style="color:darkred"><b>4–20 mA Current Loop</b></span> {{!}} <span style="color:chocolate">ADC</span>; default: <b>Input/Output</b></td>
             <td><span style="color:red">Analog Current Loop (6,9)</span> {{!}} <span style="color:blue">Analog Input (6,9)</span> {{!}} Input (3) {{!}} Digital Input (1) {{!}} Output (4) {{!}} Isolated Output (3,4,8) {{!}} Isolated Input (2,7) {{!}} <span style="color:brown">Relay (5,10)</span>; default: <b>Analog Current Loop (6,9)</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>The trigger which invokes the rule.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:blue">Input/Output:</span> Input/Output name</td>
             <td><span style="color:red">Analog Current Loop (6,9)</span> {{!}} <span style="color:blue">Analog Input (6,9)</span>: State change</td>
             <td>Input (3) {{!}} Input (1) {{!}} Output(4) {{!}} Isolated Output (3,4,8) {{!}} Isolate Input (2,7); default: <b>Input (3)</b></td>
             <td>In range {{!}} Out of range {{!}} Both; default: <b>Both</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:blue">Input/Output:</span> State change</td>
             <td><span style="color:red">Analog Current Loop (6,9):</span> Min current</td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Specifies minimum current of the range. Values between 4-20mA.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:forestgreen">Relay:</span> Input/Output name</td>
             <td><span style="color:red">Analog Current Loop (6,9):</span> Max current</td>
             <td>Relay(5,10); default: <b>Relay(5,10)</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Specifies maximum current of the range. Values between 4-20mA.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:forestgreen">Relay:</span> State change</td>
             <td><span style="color:blue">Analog Input (6,9):</span> Min voltage</td>
             <td>Open {{!}} Closed {{!}} Both; default: <b>Open</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Specifies minimum voltage of the range.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:darkred">4–20 mA Current Loop:</span> Input/Output name</td>
             <td><span style="color:blue">Analog Input (6,9):</span> Max voltage</td>
             <td>Analog Current Loop (6,9); default: <b>Analog Current Loop (6,9)</b></td>
             <td>positive numbers; default: <b>none</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Specifies maximum voltage of the range.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:darkred">4–20 mA Current Loop:</span> Voltage</td>
             <td>State change</td>
             <td>positive float [0..40]; default: <b>none</b></td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>At which voltage value will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td><span style="color:chocolate">ADC:</span> Input/Output name</td>
             <td><span style="color:brown">Relay (5,10):</span> State change</td>
             <td>Analog Input (6,9); default: <b>Analog Input (6,9)</b></td>
             <td>Open {{!}} Closed {{!}} Both; default: <b>Both</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>
    |#default=
         <tr>
         <tr>
             <td><span style="color:chocolate">ADC:</span> Voltage</td>
             <td>Trigger</td>
            <td>positive float [0..40]; default: <b>none</b></td>
            <td>At which voltage value will this rule be triggered.</td>
        </tr>
    |
        <tr>
            <td>Input/Output type</td>
            <td>Input/Output; default: <b>Input/Output</b></td>
            <td>Which type of Inputs and Outputs to use in this rule.</td>
        </tr>
        <tr>
            <td>Input/Output name</td>
             <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
             <td>Input(3) {{!}} Output(4); default: <b>Input(3)</b></td>
             <td>Which type of Inputs and Outputs to use in this rule.</td>
             <td>The trigger which invokes the rule.</td>
         </tr>
         </tr>
         <tr>
         <tr>
             <td>State change</td>
             <td>State change</td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>High level {{!}} Low level {{!}} Both; default: <b>Both</b></td>
             <td>On which Input/Output state will this rule be triggered.</td>
             <td>Selects which pin state will trigger the SNMP trap.</td>
         </tr>
         </tr>}}}}
    |}}
</table>|}}
}}
 
</table>


 
====Events log Trap type====
====Events log====
----
----
<table class="nd-mantable">
<table class="nd-mantable">
Line 595: Line 505:
     </tr>
     </tr>
     <tr>
     <tr>
         <td><b>Config change</b></td>
         <td>Config change</td>
         <td>All | Specific config change; default: <b>all</b></td>
         <td>All | Specific config change; default: <b>all</b></td>
         <td>Informs on changes to the device's configuration.</td>
         <td>Informs on changes to the device's configuration.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><b>Reboot</b></td>
         <td>Reboot</td>
         <td>All | From Web UI | From ping reboot | From reboot scheduler | From button{{#ifeq: {{{mobile}}} | 1 | {{!}} From SMS|}}; default: <b>All</b></td>
         <td>All | From Web UI | From ping reboot | From reboot scheduler | From button{{#ifeq: {{{mobile}}} | 1 | {{!}} From SMS|}}; default: <b>All</b></td>
         <td>Informs on if the device was rebooted.</td>
         <td>Informs on if the device was rebooted.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><b>Startup</b></td>
         <td>Startup</td>
         <td>Device startup completed</td>
         <td>Device startup completed {{!}} After unexpected shutdown</td>
         <td>Informs on when the device is fully booted.</td>
         <td>Informs on when the device is fully booted.</td>
     </tr>{{#ifeq: {{{gps}}} | 1 |
     </tr>{{#ifeq: {{{gps}}} | 1 |
     <tr>
     <tr>
         <td><b>GPS</b></td>
         <td>GPS</td>
         <td>All {{!}} Entered geofence {{!}} Left geofence; default: <b>All</b></td>
         <td>All {{!}} Entered geofence {{!}} Left geofence; default: <b>All</b></td>
         <td>Informs on when the device has entered or left a user defined geofence zone.</td>
         <td>Informs on when the device has entered or left a user defined geofence zone.</td>
     </tr>|}}{{#ifeq: {{{mobile}}} | 1 |
     </tr>|}}{{#ifeq: {{{mobile}}} | 1 |
     <tr>
     <tr>
         <td><b>Mobile data</b></td>
         <td>Mobile data</td>
         <td>All {{!}} Connected {{!}} Disconnected; default <b>All</b></td>
         <td>All {{!}} Connected {{!}} Disconnected; default <b>All</b></td>
         <td>Informs on changes to the state of the device's mobile connection.</td>
         <td>Informs on changes to the state of the device's mobile connection.</td>
     </tr>|}}
     </tr>|}}
     <tr>
     <tr>
         <td><b>New DHCP client</b></td>
         <td>New DHCP client</td>
         <td>All | Connected from LAN{{#ifeq: {{{wireless}}} | 1 | {{!}} Connected from WiFi|}}; default <b>All</b></td>
         <td>All | Connected from LAN{{#ifeq: {{{wireless}}} | 1 | {{!}} Connected from WiFi|}}; default <b>All</b></td>
         <td>Informs on new DHCP lease give outs.</td>
         <td>Informs on new DHCP lease give outs.</td>
     </tr>{{#ifeq: {{{eth}}} | 1 |
     </tr>{{#ifeq: {{{eth}}} | 1 |
     <tr>
     <tr>
         <td><b>Ports state</b></td>
         <td>Ports state</td>
         <td>All {{!}} Link speed {{!}} Link state {{!}} Unplugged {{!}} Plugged in {{!}} Specific port; default: <b>All</b></td>
         <td>All {{!}} Link speed {{!}} Link state {{!}} Unplugged {{!}} Plugged in {{!}} Specific port; default: <b>All</b></td>
         <td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes.</td>
         <td>Informs on Ethernet port state (plugged in or unplugged) or speed (100 Mbps or 1000 Mbps) changes.</td>
     </tr>|}}
     </tr>|}}
     <tr>
     <tr>
         <td><b>Reboot</b></td>
         <td>Reboot</td>
         <td>All | From button | From Input/Output | From Ping Reboot | From Reboot Scheduler | From WebUI | From SMS; default: <b>All</b></td>
         <td>All | From button | From Input/Output | From Ping Reboot | From wget Reboot | From Reboot Scheduler | From WebUI{{#ifeq: {{{mobile}}} | 1 | {{!}} From SMS}}; default: <b>All</b></td>
         <td>Informs after device reboot occurrences.</td>
         <td>Informs after device reboot occurrences.</td>
     </tr>{{#ifeq: {{{mobile}}} | 1 |
     </tr>{{#ifeq: {{{mobile}}} | 1 |
     <tr>
     <tr>
         <td><b>Signal strength</b></td>
         <td>Signal strength</td>
         <td>All {{!}} - 121 dBm - 113 dBm {{!}} - 113 dBm - 98 dBm {{!}} - 98 dBm - 93 dBm {{!}} - 93 dBm - 75 dBm {{!}} - 75 dBm - 60 dBm {{!}} - 60 dBm - 50 dBm; default: <b>All</b></td>
         <td>All {{!}} - 121 dBm - 113 dBm {{!}} - 113 dBm - 98 dBm {{!}} - 98 dBm - 93 dBm {{!}} - 93 dBm - 75 dBm {{!}} - 75 dBm - 60 dBm {{!}} - 60 dBm - 50 dBm; default: <b>All</b></td>
         <td>Informs on signal strength changes.</td>
         <td>Informs on signal strength changes.</td>
     </tr>
     </tr>
     <tr>
     <tr>
         <td><b>SMS</b></td>
         <td>SMS</td>
         <td>SMS received</td>
         <td>SMS received</td>
         <td>Informs on received SMS messages.</td>
         <td>Informs on received SMS messages.</td>
     </tr>|}}
     </tr>
    <tr>
        <td>SIM switch</td>
        <td>All {{!}} Changing to SIM1 {{!}} Changing to SIM2</td>
        <td>Informs on SIM switch.</td>
    </tr>
    |}}
     <tr>
     <tr>
         <td><b>SSH</b></td>
         <td>SSH</td>
         <td>All | Successful authentication | Unsuccessful authentication; default: <b>All</b></td>
         <td>All | Successful authentication | Unsuccessful authentication; default: <b>All</b></td>
         <td>Informs on successful or unsuccessful SSH login attempts.</td>
         <td>Informs on successful or unsuccessful SSH login attempts.</td>
     </tr>{{#ifeq: {{{eth}}} | 1 |
     </tr>{{#ifeq: {{{eth}}} | 1 |
     <tr>
     <tr>
         <td><b>Topology state</b></td>
         <td>Topology state</td>
         <td>Topology changes</td>
         <td>Topology changes</td>
         <td>Informs on changes to the device's network topology.</td>
         <td>Informs on changes to the device's network topology.</td>
     </tr>|}}{{#ifeq: {{{failover}}} | 1 |
     </tr>|}}{{#ifeq: {{{mwan3}}} | 1 |
     <tr>
     <tr>
         <td><b>WAN failover</b></td>
         <td>WAN failover</td>
         <td>All {{!}} Switched to failover {{!}} Switched to main; default: <b>All</b></td>
         <td>All {{!}} Switched to failover {{!}} Switched to main; default: <b>All</b></td>
         <td>Informs on WAN failover occurrences.</td>
         <td>Informs on WAN failover occurrences.</td>
     </tr>|}}
     </tr>|}}
     <tr>
     <tr>
         <td><b>WebUI</b></td>
         <td>WebUI</td>
         <td>ALL | Successful authentication | Unsuccessful authentication; default: <b>All</b></td>
         <td>ALL | Successful authentication | Unsuccessful authentication; default: <b>All</b></td>
         <td>Informs on successful or unsuccessful HTTP/HTTPS login attempts.</td>
         <td>Informs on successful or unsuccessful HTTP/HTTPS login attempts.</td>
     </tr>{{#ifeq:{{{wireless}}} | 1 |
     </tr>{{#ifeq:{{{wireless}}} | 1 |
     <tr>
     <tr>
         <td><b>New WiFi client</b></td>
         <td>New WiFi client</td>
         <td>All {{!}} Connected {{!}} Disconnected; default: <b>All</b></td>
         <td>All {{!}} Connected {{!}} Disconnected; default: <b>All</b></td>
         <td>Informs on new WiFi clients. Possible triggers are:</td>
         <td>Informs on new WiFi clients. Possible triggers are:</td>
     </tr>|}}
     </tr>|}}
    <tr>
        <td>Fota</td>
        <td>Firmware update is now available</td>
        <td>Informs if firmware update is now available</td>
    </tr>
</table>
</table>


{{#ifeq: {{{hotspot}}} | 1 |
====Hotspot client Trap type====
----
<table class="nd-mantable">
    <tr>
        <th>Field</th>
        <th>Value</th>
        <th>Description</th>
    </tr>
    <tr>
        <td>Trigger</td>
        <td>Connected {{!}} Disconnected; default: <b>Connected</b></td>
        <td>The trigger which invokes the rule.</td>
    </tr>
</table>|}}


==SNMP variables list==
==SNMP variables list==
Line 691: Line 627:
     </tr>
     </tr>
     <tr>
     <tr>
         <td>routerName.0</td>
         <td>deviceName.0</td>
         <td>.1.3.6.1.4.1.48690.1.2.0</td>
         <td>.1.3.6.1.4.1.48690.1.2.0</td>
         <td>Device name</td>
         <td>Device name</td>
Line 719: Line 655:
         <td>.1.3.6.1.4.1.48690.1.7.0</td>
         <td>.1.3.6.1.4.1.48690.1.7.0</td>
         <td>Device uptime</td>
         <td>Device uptime</td>
    </tr>
    <tr>
        <td>cpuUsage</td>
        <td>.1.3.6.1.4.1.48690.1.8.0</td>
        <td>CPU usage</td>
     </tr>{{#ifeq: {{{mobile}}} | 1 |
     </tr>{{#ifeq: {{{mobile}}} | 1 |
     <tr>
     <tr>
Line 729: Line 670:
         <td>.1.3.6.1.4.1.48690.2.1.0</td>
         <td>.1.3.6.1.4.1.48690.2.1.0</td>
         <td>The number of modems (regardless of their current state) present on this system</td>
         <td>The number of modems (regardless of their current state) present on this system</td>
    </tr>
    <tr>
        <td>modemTable</td>
        <td>.1.3.6.1.4.1.48690.2.2.0</td>
        <td>A list of modem entries. The number of entries is given by the value of modemNum.</td>
     </tr>
     </tr>
     <tr>
     <tr>
Line 887: Line 833:
     <tr>
     <tr>
         <td>connectionUptime</td>
         <td>connectionUptime</td>
         <td>.1.3.6.1.4.1.48690.2.3.0.1</td>
         <td>.1.3.6.1.4.1.48690.2.3.0</td>
         <td>Mobile connection uptime</td>
         <td>Mobile connection uptime in seconds.</td>
     </tr>|}}{{#ifeq: {{{gps}}} | 1 |
     </tr>|}}{{#ifeq: {{{gps}}} | 1 |
     <tr>
     <tr>
Line 920: Line 866:
         <td>.1.3.6.1.4.1.48690.3.5.0</td>
         <td>.1.3.6.1.4.1.48690.3.5.0</td>
         <td>Number of available GPS satelites</td>
         <td>Number of available GPS satelites</td>
     </tr>|}}{{#ifeq: {{{notifications}}} | 1 | {{#ifeq: {{{mobile}}} | 1 |
     </tr>|}}{{#ifeq: {{{notifications}}} | 1 |
     <tr>
     <tr>
         <th>Mobile notifications</th>
         <th>Mobile notifications</th>
Line 935: Line 881:
         <td>.1.3.6.1.4.1.48690.4.1.2</td>
         <td>.1.3.6.1.4.1.48690.4.1.2</td>
         <td>Network type trap</td>
         <td>Network type trap</td>
     </tr>|}}
     </tr>|}}{{#switch:{{{name}}} | TCR100 | RUTXR1 | OTD140 | TAP100 | TAP200 = | #default =
     <tr>
     <tr>
         <th>Input/Output notifications</th>
         <th>Input/Output notifications</th>
         <th></th>
         <th></th>
         <th></th>
         <th></th>
     </tr>{{#switch:{{{name}}} |RUTX08|RUTX09|RUTX10|RUTX11|RUTX12|RUTX14|RUT950|RUT951|RUT952|RUT260|RUT955|RUT956|RUT240|RUT241|RUTX50|RUT901|RUT906|RUTM08|RUTM09|RUTM10|RUTM11|RUTM12|RUTM14 =
     </tr>}}{{#switch:{{{name}}} |RUTX08|RUTX09|RUTX10|RUTX11|RUTX12|RUTX14|RUT950|RUT951|RUT952|RUT260|RUT955|RUT956|RUT240|RUT241|RUTX50|RUT901|RUT906|RUTM08|RUTM09|RUTM10|RUTM11|RUTM12|RUTM14 =
     <tr>
     <tr>
         <td>digitalInputNotification</td>
         <td>digitalInputNotification</td>
Line 950: Line 896:
         <td>.1.3.6.1.4.1.48690.4.2.2</td>
         <td>.1.3.6.1.4.1.48690.4.2.2</td>
         <td>Digital output trap</td>
         <td>Digital output trap</td>
     </tr>| #default =}}{{#switch:{{{name}}} |RUT360|RUT361|RUT300|RUT301|TRB140|TRB141|TRB143|TRB500|TRB245|TRB255 =
     </tr>| #default =}}{{#switch:{{{name}}} |RUT360|RUT361|RUT300|RUT301|TRB140|TRB141|TRB143|TRB500|TRB245|TRB246|TRB255|TRB256|TRB160 =
     <tr>
     <tr>
         <td>digitalio0Notification</td>
         <td>digitalio0Notification</td>
Line 960: Line 906:
         <td>.1.3.6.1.4.1.48690.4.2.4</td>
         <td>.1.3.6.1.4.1.48690.4.2.4</td>
         <td>Digital I/O 1 trap</td>
         <td>Digital I/O 1 trap</td>
     </tr>| #default =}}{{#switch:{{{name}}} |TRB245|TRB255 =
     </tr>| #default =}}{{#switch:{{{name}}} |TRB245|TRB246|TRB255|TRB256 =
     <tr>
     <tr>
         <td>digitalio2Notification</td>
         <td>digitalio2Notification</td>
Line 990: Line 936:
         <td>.1.3.6.1.4.1.48690.4.2.10</td>
         <td>.1.3.6.1.4.1.48690.4.2.10</td>
         <td>ACL trap</td>
         <td>ACL trap</td>
     </tr>| #default =}}{{#switch:{{{name}}}  |RUT955|RUT956|RUT906|TRB245|TRB255|TRB141 =
     </tr>| #default =}}{{#switch:{{{name}}}  |RUT955|RUT956|RUT906|TRB245|TRB246|TRB255|TRB141|TRB256 =
     <tr>
     <tr>
         <td>adc0Notification</td>
         <td>adc0Notification</td>
Line 1,010: Line 956:
         <td>.1.3.6.1.4.1.48690.4.2.14</td>
         <td>.1.3.6.1.4.1.48690.4.2.14</td>
         <td>Digital output2 trap</td>
         <td>Digital output2 trap</td>
     </tr>| #default =}}|}}{{#ifeq: {{{hotspot}}} | 1 |
     </tr>| #default =}}{{#switch:{{{name}}}  |TRB160 =
    <tr>
        <td>powerVoltageNotification</td>
        <td>.1.3.6.1.4.1.48690.4.2.15</td>
        <td>Power voltage trap</td>
    </tr>| #default =}}{{#ifeq: {{{hotspot}}} | 1 |
     <tr>
     <tr>
         <th>Hotspot Notifications</th>
         <th>Hotspot Notifications</th>
Line 1,025: Line 976:
         <td>.1.3.6.1.4.1.48690.4.3.2</td>
         <td>.1.3.6.1.4.1.48690.4.3.2</td>
         <td>Hotspot client disconnected trap</td>
         <td>Hotspot client disconnected trap</td>
     </tr>| #default =}}|}}{{#ifeq: {{{hotspot}}} | 1 |
     </tr>|}}{{#ifeq: {{{hotspot}}} | 1 |
     <tr>
     <tr>
         <th>Hotspot</th>
         <th>Hotspot</th>
Line 1,196: Line 1,147:
         <td>.1.3.6.1.4.1.48690.6.2.1.10</td>
         <td>.1.3.6.1.4.1.48690.6.2.1.10</td>
         <td>Percentage of ACL</td>
         <td>Percentage of ACL</td>
    </tr>
    <tr>
        <td> ioStateNumeric</td>
        <td>.1.3.6.1.4.1.48690.6.2.1.11</td>
        <td>Numeric state of I/O</td>
     </tr>|}}{{#ifeq: {{{wireless}}} | 1 |
     </tr>|}}{{#ifeq: {{{wireless}}} | 1 |
     <tr>
     <tr>
Line 1,482: Line 1,438:
         <td>.1.3.6.1.4.1.48690.10.2.1.7</td>
         <td>.1.3.6.1.4.1.48690.10.2.1.7</td>
         <td>Boolean value whether port is duplex or not</td>
         <td>Boolean value whether port is duplex or not</td>
     </tr>|}}
     </tr>|}}{{#ifeq: {{{mwan3}}} | 1 |
    <tr>
        <th>MultiWAN</th>
        <th></th>
        <th></th>
    </tr>
    <tr>
        <td>mwan3Count</td>
        <td>.1.3.6.1.4.1.48690.12.1</td>
        <td>Count of Multiwan interfaces</td>
    </tr>
    <tr>
        <td>mwan3Table</td>
        <td>.1.3.6.1.4.1.48690.12.2</td>
        <td>A list of Multiwan interfaces. The number of entries is given by the value of mwan3Count</td>
    </tr>
    <tr>
        <td>mwan3Entry</td>
        <td>.1.3.6.1.4.1.48690.12.2.1</td>
        <td>An entry containing information of a particular Multiwan interface</td>
    </tr>
    <tr>
        <td>mwan3Index</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.1</td>
        <td>Unique value, greater than zero, for each session</td>
    </tr>
    <tr>
        <td>mwan3Name</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.2</td>
        <td>Name of Multiwan interface</td>
    </tr>
    <tr>
        <td>mwan3Enabled</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.3</td>
        <td>Numeric value indicating if interface is enabled or not</td>
    </tr>
    <tr>
        <td>mwan3Uptime</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.4</td>
        <td>Multiwan interface uptime</td>
    </tr>
    <tr>
        <td>mwan3Status</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.5</td>
        <td>Status of Multiwan interface</td>
    </tr>
    <tr>
        <td>mwan3Ip</td>
        <td>.1.3.6.1.4.1.48690.12.2.1.6</td>
        <td>IP addresses that Multiwan interface tracks</td>
    </tr>|}}{{#ifeq: {{{universal_gateway}}} | 1 |
    <tr>
        <th>Universal Gateway</th>
        <th></th>
        <th></th>
    </tr>
    <tr>
        <td>tagTable</td>
        <td>.1.3.6.1.4.1.48690.20.1</td>
        <td>Tag table represents all resolved tags currently for modbus and mbus.</td>
    </tr>
    <tr>
        <td>tagEntry</td>
        <td>.1.3.6.1.4.1.48690.20.1.1</td>
        <td>An entry containing information of a particular tag.</td>
    </tr>
    <tr>
        <td>tagIndex</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.1</td>
        <td>Unique index for the tag entry.</td>
    </tr>
    <tr>
        <td>tagId</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.2</td>
        <td>Identifier for the tag.</td>
    </tr>
    <tr>
        <td>tagPrettyName</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.3</td>
        <td>Tag pretty name.</td>
    </tr>
    <tr>
        <td>tagSource</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.4</td>
        <td>Source protocol of the tag.</td>
    </tr>
    <tr>
        <td>tagPermissions</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.5</td>
        <td>Permissions for the tag.</td>
    </tr>
    <tr>
        <td>tagType</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.6</td>
        <td>Data type of the 'tagValue' object.</td>
    </tr>
    <tr>
        <td>tagValueSize</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.7</td>
        <td>Number of values in this tag. This is mainly used to see how many values are stored in the 'tagValueTable' for this tag, though it is not guaranteed that the number of values in the table matches this count, as with some data types such as string there will be only one 'tagValueTable' entry.</td>
    </tr>
    <tr>
        <td>tagTimestamp</td>
        <td>.1.3.6.1.4.1.48690.20.1.1.8</td>
        <td>The Unix timestamp of the last time the tag information was updated. This is mainly intended to see when the tagValueTable of this tag was last updated.</td>
    </tr>
    <tr>
        <td>tagValueTable</td>
        <td>.1.3.6.1.4.1.48690.20.2</td>
        <td>This table holds information about tag values of each tag.</td>
    </tr>
    <tr>
        <td>tagValueEntry</td>
        <td>.1.3.6.1.4.1.48690.20.2.1</td>
        <td>An entry containing information of a particular tag value. Each tag can have multiple values, which are stored in this table. Each value is usually indexed by unique ID 'tagValueIndex' which is unique for each tag, starting from 0. The 'tagValue' object contains the raw value of the tag, which can be of different data types as specified by the 'tagType' object in the tag entry.</td>
    </tr>
    <tr>
        <td>tagValueIndex</td>
        <td>.1.3.6.1.4.1.48690.20.2.1.1</td>
        <td>Unique index for the tag value entry.</td>
    </tr>
    <tr>
        <td>tagValue</td>
        <td>.1.3.6.1.4.1.48690.20.2.1.2</td>
        <td>Raw value of the tag value, refer to 'tagType' object for the data type. (<b>Note:</b> Universal Gateway supports SET commands for tagValue table entries)</td>
    </tr>}}
</table>
</table>


[[Category:{{{name}}} Services section]]
[[Category:{{{name}}} Services section]]

Latest revision as of 10:09, 27 October 2025

The information in this page is updated in accordance with firmware version .


Summary

Simple Network Management Protocol (SNMP) is a network management protocol used for collecting information and configuring network devices. This page is an overview of the SNMP function in {{{name}}} devices.

Note: SNMP is additional software that can be installed from the System → [[{{{name}}} Package Manager|Package Manager]] page.

SNMP settings

The SNMP settings page is used to configure SNMP accessibility and general SNMP information for your device.

SNMP agent settings

Field Value Description
Enable SNMP service off | on; default: off Enable SNMP (Simple Network Management Protocol) service on system startup.
Enable remote access off | on; default: off Create a firewall rule that allows access to SNMP for remote hosts.
IP type IPv4 | IPv6 | IPv4v6; default: IPv4 IP type used by SNMP.
Port integer [0..65535]; default: 161 TCP/UDP port number used for the connection.
SNMP v1 Mode off | on; default: on Enable/disable SNMP v1 Mode.
SNMP v2c Mode off | on; default: on Enable/disable SNMP v2c Mode.
SNMP v3 Mode off | on; default: off Enable/disable SNMP v3 Mode.

SNMP System Summary

The SNMP System Summary section contains general information about SNMP on this device. You can also download this device's MIB file from this section.

Field Value Description
MIB file -(interactive button) Download the MIB file containing custom Teltonika module tree for this device.
Teltonika OID path 1.3.6.1.4.1.48690 The OID path containing Teltonika IANA Private Enterprise Number (PEN). All custom private SNMP modules are referenced under this OID path.
Location string; default: location Location of the system. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.
Contact string; default: [email protected] Contact information. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.
Name string; default: name Name of the system. If the field is empty, the option will have read-write permissions. If not, the option will become read-only.

SNMP v3 users

The SNMP v3 users page is used to create and manage users, who can be authenticated using SNMP v3. To configure an SNMP user, you must first create it:

  1. Enter a custom name for the new user in the 'Name' field.
  2. Click the 'Add' button.
  3. Click the 'Edit' button next to the newly created user.

The SNMP user configuration window should look similar to this:

Note: this table has coloring scheme to indicate which fields can be seen with different configuration.

Field Value Description
Enable off | on; default: off Turns this SNMP user on or off.
Username string; default: none Name of the SNMP user configuration.
Security level No authentication, no privacy | Authentication, no privacy | Authentication and privacy; default: No authentication, no privacy A security level is an authentication strategy that is set up for the user.

No authentication, no privacy - authenticates with a username. Authentication - provides MD5 or SHA algorithms for authentication.

Privacy - Provides DES or AES encryption.
Authentication, no privacy | Authentication and privacy: Authentication type SHA | MD5; default: SHA Set authentication type to use with SNMP v3.
Authentication, no privacy | Authentication and privacy: Authentication passphrase string; default: none Set authentication passpharse to generate key for SNMP v3.
Authentication and privacy: Privacy type DES | AES; default: DES Set privacy type to use with SNMP v3.
Authentication and privacy: Privacy passphrase string; default: none Set privacy passpharse to generate key for SNMP v3.
Access Mode Read-Only | Read-Write; default: Read-Only Access mode specifies which access the host has in the community and if they are allowed to retrieve and modify MIB variables from a specific SNMP agent.
MIB subtree string; default: none Leave empty to access full MIB tree.

Communities

The SNMP Community section is used to manage access rights. You can edit an SNMP community by clicking the 'Edit' button next to it:

This will redirect you to the community's configuration page.

Field Value Description
Community name string; default: none SNMP community name is an ID that allows access to a routers SNMP data.
IP Address ip; default: none IP address of the community.
IP Mask ip; default: none Netmask for IP of the community.
Access Mode Read-Only | Read-Write; default: Read-Only Access mode specifies if you can only read or read and write information from and to the device.

SNMPv6 community configuration page:

Field Value Description
Community name string; default: public Name of the community.
Source ip6 | domain name; default: default Source of the community.
Access Mode Read-Only | Read-Write; default: Read-Only Access mode for current community.

Trap Settings

SNMP Traps are used to send alert messages to a central collector, the “SNMP manager” when an important event happens. A benefit of using Traps for reporting alarms is that they trigger instantaneously, rather than waiting for a status request from the manager.

Trap settings page is divided in two sections - Trap service settings and Trap rules. Trap service settings lets you manage hosts which will get configured alert messages, Trap rules lets you manage rules which when triggered will send alerts.

Trap Service Settings

The Trap Service Settings is used to manage host which will be alerted when an SNMP trap is triggered

Field Value Description
Enable off | on; default: off Enables Trap service.
Host url | ip; default: none Host to transfer SNMP (Simple Network Management Protocol) traffic to.
Port integer [0..65535]; default: 162 Port for trap host.
Community string; default: public The SNMP (Simple Network Management Protocol) community is an ID that allows access to a routers SNMP data.

Trap Rules

SNMP Trap Rules are alerts that trigger when certain user-specified events occur. When the trigger event happens, the trap will notify known SNMP hosts.

You can create a new trap rule by clicking the 'Add' button.

You should be redirected to the rule's configuration page which should look something like this:

[[File:Networking_rutos_manual_snmp_trap_settings_trap_rules_modify_trap_rule_{{{mobile}}}.png|border|class=tlt-border]]

Above is an example of what rule configuration window looks like. Below is a table with detailed explanations on how to configure the rule and what each of the fields mean.

To avoid redundancy, screenshots for the other rules will not be provided, since the structures, syntax and the overall look of the configuration windows for each rule are very similar. Instead, only tables containing information on how to edit each rule will be provided.




Events log Trap type

Event Event subtype Description
Config change All | Specific config change; default: all Informs on changes to the device's configuration.
Reboot All | From Web UI | From ping reboot | From reboot scheduler | From button; default: All Informs on if the device was rebooted.
Startup Device startup completed | After unexpected shutdown Informs on when the device is fully booted.
New DHCP client All | Connected from LAN; default All Informs on new DHCP lease give outs.
Reboot All | From button | From Input/Output | From Ping Reboot | From wget Reboot | From Reboot Scheduler | From WebUI; default: All Informs after device reboot occurrences.
SSH All | Successful authentication | Unsuccessful authentication; default: All Informs on successful or unsuccessful SSH login attempts.
WebUI ALL | Successful authentication | Unsuccessful authentication; default: All Informs on successful or unsuccessful HTTP/HTTPS login attempts.
Fota Firmware update is now available Informs if firmware update is now available


SNMP variables list

Name OID Description
Device
serial .1.3.6.1.4.1.48690.1.1.0 Device serial number
deviceName.0 .1.3.6.1.4.1.48690.1.2.0 Device name
productCode .1.3.6.1.4.1.48690.1.3.0 Device product (ordering) code
batchNumber .1.3.6.1.4.1.48690.1.4.0 Device batch number
hardwareRevision .1.3.6.1.4.1.48690.1.5.0 Device hardware revision
fwVersion .1.3.6.1.4.1.48690.1.6.0 Device RutOS firmware version
deviceUptime .1.3.6.1.4.1.48690.1.7.0 Device uptime
cpuUsage .1.3.6.1.4.1.48690.1.8.0 CPU usage
Input/Output notifications

[[Category:{{{name}}} Services section]]

Retrieved from "https://wiki.teltonika-networks.com/index.php?title=Template:Networking_rutos_manual_snmp&oldid=159359"