FAQ - SNMP support in TBS devices

FAQ - SNMP support in TBS devices

Question
Do TBS devices support SNMP monitoring?

Answer
It is possible to monitor TBS devices from SNMP server. The SNMP feature is disabled by default and needs to be activated and configured.

Concept wise, the TBS devices implement a Net-SNMP daemon that acts as SNMP version 2 agent. It requires an SNMP server installed in customer infrastructure. The available information is defined by MIBs (Management Information Bases), containing OIDs (Object IDentifiers).

The MIBs used by TBS devices are defined in UCD-SNMP-MIB.txt. It can be imported to Solarwinds and other SNMP tools.

SNMP traps & MIB support
TBS devices do not support SNMP traps!
Instead, the defined SNMP values shall be polled to trigger alerts conditionally.

TBS uses standard U.C. Davis MIB definition ( http://www.oidview.com/mibs/2021/UCD-SNMP-MIB.html).
Activation
SNMP can be activated/deactivated using DeviceConfig, via Maintenance/Monitoring/SNMP menu. It also provides options to modify community (password). 

Return codes
0 - Ok (Filled by app)
6 - Warning (Filled by app)
7 - Error (Filled by app)
8 - Critical (Filled by app)
9 - No status information (Filled by script)
10 - Status information is old (more then 120 secods, it is configurable; filled by script)
11 - Status information mismatch (Filled by script)

Testing
SNMP can be tested using command line from both Windows and Linux using Net-SNMP tool:
Application status:
Overall status
snmpwalk -v 2c -c <PASSWD> <DEVICE_IP> .1.3.6.1.4.1.2021.8
OID 1.3.6.1.4.1.2021.8.1.100.1 can have the return codes defined in above section. In case of codes 6, 7, and 8 the detailed string status is reported in OID 1.3.6.1.4.1.2021.8.1.101.1.
Example of OK status (code 0)
snmpwalk -v 2c -c public 192.168.99.192 .1.3.6.1.4.1.2021.8.1.100.1
iso.3.6.1.4.1.2021.8.1.100.1 = INTEGER: 0
snmpwalk -v 2c -c public 192.168.99.192 .1.3.6.1.4.1.2021.8.1.101.1
iso.3.6.1.4.1.2021.8.1.101.1 = STRING: "Info: OK"
Example of Error status (code 7)
snmpwalk -v 2c -c public 192.168.99.192 .1.3.6.1.4.1.2021.8.1.100.1
iso.3.6.1.4.1.2021.8.1.100.1 = INTEGER: 7
snmpwalk -v 2c -c public 192.168.99.192 .1.3.6.1.4.1.2021.8.1.101.1
iso.3.6.1.4.1.2021.8.1.101.1 = STRING: "Err: Device is blocked;"

CPU load:
snmpwalk -v 2c -c <PASSWD> <DEVICE_IP> .1.3.6.1.4.1.2021.10

SolarWinds Network Device Monitor
Solarwinds provide a free device monitoring tool ( http://www.solarwinds.com/products/freetools/network-device-monitor) that we used for tests.

The UCD-SNMP-MIB file (attached) has to be compiled using SolarWinds MIB compiler. Use OID 1.3.6.1.4.1.2021.8 and then 'Browse tree...' button to get information about device status etc. It seems that only one column watching works in free version.

Please find below a configuration example with warning/error threshold setting.

Solarwinds configuration

The output should be similar to the below:

    • Related Articles

    • FAQ - IP configuration on devices

      Question How can I change the IP settings of TBS devices? Answer Usually server and client IP addresses of TBS devices need to be adapted to your installation. This can be done in two ways: directly on device screen, using network configuration pages ...

    • FAQ - Configuration of 'headless' devices

      Question I do not know how to configure my TBS 'headless' device (2D STATION, 2D MINI etc.). How to access it? Answer Headless TBS devices are all devices in the TBS portfolio without a touchscreen. In factory reset state, there are two options to ...

    • FAQ - Door control with TBS devices - Firmware 1.xx

      Question What options does TBS offer to control doors? Answer for Firmware 1.xx For Firmware 2.xx please see this article (coming soon) A standard access door is equipped with electronic lock, door status and push button. To manage these components ...

    • FAQ - System requirements for TBS WebEdition

      Question What are the system requirements for TBS WebEdition? Answer The answer cannot be given easily, because it strongly depends on many parameters: number of users number of devices transactions per timeframe user data mutation frequency etc. ...

    • FAQ - Device error code description

      Question How to interpret the error codes reported on device and resolve them? Answer The following table provides brief description of device error codes. Error code Description Resolution 0 No error. 1 General error. 42 Sensor image caching (sensor ...