LoriotPro NMS software Network Management Software

Newsletter | Contact Us | News |Downloads | Support | Partners

version française

Environmental IP monitoring for homes, offices, server rooms
Monitoring TERACOM devices with the SNMP Manager LoriotPro

Table of contentsTCW122B TERACOM

Introduction

TERACOM SNMP Configuration

Adding the TERACOM MIB inside LoriotPro

Using the SNMP Trap sent by the TERACOM device

Using the dashboard for TERACOM device TCW122B-CM

How to install the TERACOM Simple Dashboard

TERACOM complex Dashboard for TCW122B-CM

Introduction

This document explains how to perform the exploitation and the configuration of TERACOM device and specifically the TCW122B-CM with the SNMP Manger LoriotPro.

You amy find the same document on the Teracom WEB site under this link :https://www.teracomsystems.com/blog/monitoring-system-tcw122b-cm-and-loriotpro/

TCW122B-CM is a multifunctional device for remote monitoring and management. It is an Ethernet based controller, which is designed to work in IP-based networks and managed by WEB interface or SNMP programs. Its I/O interface - relay outputs, analog and digital inputs, is suitable for solving specific problems in various fields such as remote control, alarm systems, industrial process automation, control and management of computer networks etc.

Input Output feature of the TCW122B-CM :

  • 2 digital inputs with "logic level" and "dry contact" modes
  • 2 analog inputs with input range 0 ÷ 60 VDC
  • 2 relays with NO and NC contacts

Before reading this document read the user manual of the manufacturer below: TCW122B-CM

After configuring LoriotPro and the device the Active View dashboard will then be used to have a synthetic view of the device. Example below : 

Dashboard Teracom device

Template was made with a TCW121B but works as well with a TCW122B-CM (TCW121B is discontinued at TERACOM)

 teracom device

Template was made with a TCW121B but works as well with a TCW122B-CM (TCW121B is discontinued at TERACOM)

TERACOM SNMP Configuration

To be able to control the TERACOM device with Loriotpro the configuration of the SNMP level is required. You must perform a WEB access on the device and configure the SNMP setup below.

teracom web access

Enable SNMP Configuration first and then select the SNMP community. These communities are a kind of shared password between the SNMP Manager and the TERACOM SNMP agent. The same values should be defined in the agent and in the manager.

When done in the LoriotPro SNMP Manager you can add the TERACOM device. Select the network where your device is connected (if the network is not there add it manually or launch a discover. Read the LoriotPro documentation for more details about network discover option and IP Scanner)

add teracom host

The Insert Host screen pops up.

enter IP address of teracom device

Enter the IP address of the Tercom device, the same Read Only Community and Read Write Community. If the device is responding to SNMP the Name will automatically assigned with the Name of the device defined in the SNMP configuration (the sysname object).

The new device is now visible in the directory tree.

DirectoryTreeWithTercomdevi.png

The green indicate that the device is well responding to SNMP Ping. If the color is not green you should verify step by step that the following points are respected.

You device should be at least blue, it means that LoriotPro SNMP Manger is able to communicate with the device and doing simple PING. Else check the network connectivity, remoce firewall filter etc

You should verify that the SNMP agent is enabling on the TERACOM device and that the community strings READ ONLY and READ WRITE are set with the same values on LoriotPro and on the TERCOM device.

You should let the SNMP version to V1 and port to 161

Check that no firewall are blocking port 161 between LoriotPro and the TERACOM device.

Adding the TERACOM MIB inside LoriotPro

If the device is in the Green state you should now add the MIB file inside LoriotPro. The MIB file can be downloaded from the TERACOM web site.

The device that we use in our example is a TCW122B-CM and the MIB is TCW122-CM_v1.01.mib.

The MIB file should be place into the directory /bin/mib

Then open the MIB compiler of LoriotPro Menu->MIB -> MIB Compiler

Browse the directory and select the MIB, Clcik on the Compile this MIB File button to perform the compilation.

TercomMibCompiling.png

When done you should have the TERACOM entry in the MIB tree of LoriotPro

teracom mib tree

You can select the TERACOM object and then click right mouse button and select SNMP Walker to perform a WALK on the MIB object. Beware that the TERACOM device should be first selected in the directory.

WalOnTERACOMMib.png

All the objects in the TERACOM branch are collected with the SNMP GET NEXT command.

If you get a clean list of the object and their values you are ready to exploit the device with LoriotPro.

Using the SNMP Trap sent by the TERACOM device

The TERACOM device is able to send SNMP traps to the SNMP Manager LoriotPro. In the initial configuration of the TERACOM device we specifically add the IP address of the LoriotPro. Thus we should receive this trap.

SNMP traps are sent if:

  • event occurs (status change) on Digital Input 1 or Digital Input 2;
  • measured voltage on Analog Input 1 or Analog Input 2 goes outside the range;
  • measured temperature goes outside the range;
  • measured humidity goes outside the range;
  • restart condition.

To check that the configuration is well done and that LoriotPro will receive traps, you can simply :

1 -Perform a physical power off power on of the device then a restart device Trap should be displayed in LoriotPro in the TRAP log windows.

2 -You can also select the device in the directory and call the Tool option of the contextual menu and select the LoriotPro sample plugin SetSNMP Value/

Enter the restartdevic/(IN)1 and click send

set snmp on teracom

trap of teracom device

How to trigger an action when a threshold is reached

On trap reception it could be necessary to trigger an action. LoriotPro provide a bunch of filtering and action options. You may look at the trap filter documentation to discover all of them.

In the case of the TERACOM device, only one trap type can be received. The different types of TERACOM TRAP can be identified with the contains of the Varbind 1. Varbind are optional field that can be provided by the device constructor.

To create a filter on a Trap in LoriotPro you have to possibilities:

You can select the trap received in the trap log (of course you should be able to generate the trap manually) and call the contextual menu and select the TrapFilter Wizard option

TrapWizard.png

The second possibility consist of selecting the Event Trap Filter tab and then Th New Trap Filter

TrapManualFilter.png

A new windows is displayed.

TrapFilter.png

In the trap type select the Enterprise / Notification option

In the Trap/ Notification name enter the world TERACOM

And finish by clicking OK.

trap filter teracom device

Using the dashboard for TERACOM device TCW122B-CM

Now that you have a responding device you can monitor it, why not using a very simple dashboard created with the LoriotPro Active View concept. Here under the result of such implementation with a working device. This view can be used with any Edition of LoriotPro.

teracom active view

Template was made with a TCW121B but works as well with a TCW122B-CM

The Relays can be managed from there too. When you click right on the Status box then the contextual menu is display.

RelayOnOff.png

On our example the Relay is OFF and we select ON. The SNMP SET screen is displayed.

set relay on teracom device

Just click on the Set button to confirm.

How to install the TERACOM Simple Dashboard

This chapter explains how to install the dashboard that we presented in the previous chapter

Download it from our web site: TeracomActiveViewTemplate.zip

Copy this file in the loriotpro directory /bin/config/activeview/

Select the TERACOM Device in the LoriotPro directory tree and click right to open the contextual menu. Select the Insert Task option then The Active View option.

InsertSimpleActiveView.png

A new popup is displayed asking you to select a template.

av template of teracom device

Enter Yes.

The file list of available ActiveView is displayed; select the TERACOMSimpleActiveViewTemplate.cmp file that you have previously copied to this directory.

ActiveViewSimpleFromTmpl.png

You are in edit mode and you can modify what you want. Read the LoriotPro documentation and the Active View chapter for understanding the Active View feature and configuration.

Click on the Process button to switch to the monitoring mode (blue arrow)

TERACOM complex Dashboard for TCW122B-CM

The following dashboard for the TERACOM TCW122B-CM provide more information and action capabilities.

You can see for each sensor the threshold set for alarm generation.

You can change the threshold by a double click on the value box.

You can reset the device with the rest button

dashboard av teracom

Template was made with a TCW121B but works as well with a TCW122B-CM (change the name when necessary)

This template can be downloading and used as is.

To install it, follow the same procedure as the one use for the previous simple dashboard.

Using Active View threshold to trigger event and action

The TERACOM device offers the internal capabilities for sending alarm on threshold. You can also set threshold and action within Loriotpro Active View.

We will see how to define that in a new Active View.

Add first an empty Active View attached to the TERACOM device but these times don't select the Active View template option. A new empty active will be created.

Drag and drop a text object and open its properties.

You can add rules base on the the threshold that you want to set like in the configuration below.

When the thresholds are reached and event is fired to LoriotPro and receives in the Event tab.

ThresholdonObject.png

The Event can then be used to trigger Action like sending e-mail launching programs etc...

Refer to the Event chapter of the documentation of LoriotPro

**************End of document*************

Newsletter || Contact Us | News |Downloads | Support | Partners
   
google search button LoriotPro Site Map lexicon and terminology © LUTEUS SARL. All rights reserved