[ENG] 6. [DKSF 707.2 IU] Example of Configuring NetPing SMS Gateway to Send SMS Notifications from other NetPing Devices

To receive SMS notifications about events on sensors from a group of NetPing devices, which have no built-in GSM modem, there is a need to configure NetPing SMS gateway in the following way:

Go to the tab «AGENTS» of a device web interface. An agent is a device that is controlled or requested via an SNMP protocol. When receiving SNMP TRAP notifications from an agent, Netping SMS sends SMS notifications to specified phone numbers;
Add a new agent. There is a need to click the field «click here to add new data»:

In a window that appeared add the following:
Short name – is an agent name, which will be used in SMS messages. It can contain up to 15 letters of the Latin alphabet. Using spaces is prohibited. On default: empty row
IP Address or Domain Name – is an agent name, where SNMP SET commands and SNMP GET requests will be sent. It is possible to indicate a domain name or an IP address. It can contain up to 62 characters. On default: empty row
Port – is a UDP agent port, where an SNMP message will be sent. On default: 161
Community – is used in SNMP packages. It should coincide with Community, configured in the section «SETUP» of an agent. On default: empty row
To delete agent, there is a need to click on it and click the button «Delete record» in the window that appears. To change parameters of the agent, there is a need to click on it and edit parameters in a window that appeared, then click the button «Save». To cancel the operation, click the button «Cancel»;
At the tab «GSM SETUP», specify destination numbers where to send SMS notifications:
Set the rules for processing SNMP trap notifications at the page «TRAPS» of a web interface. Trap is an SNMP notification, which is generated by a device (an agent) when an event happens. Netping SMS can receive traps, process them and send SMS notifications as a result of processing SNMP trap.
SNMP trap notification contains a notification identifier (snmpTrapOID) and a set of variables. A rule includes a host source (agent), snmpTrapOID, and a text of SMS notification. When a device receives an SNMP trap, it looks for a suitable rule, which has the same source address and snmpTrapOID identifier as the received on. If there is a suitable rule, then an SMS message will be sent with a specified text to all destination numbers indicated at the page «GSM SETUP». It is possible to include two values of variables into the text from a body of the Trap.
To add a rule for SNMP trap processing, there is a need to click the last (empty) table row. A form for adding a new rule will be displayed. A maximum number of rules is 32:
where:
Source Agent – is a drop-down list containing a list of agents configured at the page «AGENTS»;
Trap of NetPing – is a drop-down list containing a list of traps, sending by NetPing devices. It is used to make a configuration easier. On default: empty
Arbitrary snmpTrapOID – is an arbitrary trap identifier, which is subject to processing. On default: empty row.
SMS Text – is a text of an SMS message, which is going to be sent if snmpTrapOID and a source of an SNMP trap package will coincide with the ones indicated in the rule. It is possible to include a value of a variable from an SNMP trap package into the text of an SMS message. To add a variable value, there is a need to indicate a variable name in the text of an SMS, having included a name of a variable into curly brackets {}. When receiving a trap package from PRTG, variable values can be inserted according to their textual name OID. Before sending an SMS message, a device will change all variable names in curly brackets by values of these variables. In the text of an SMS message, it is possible to use Latin and Russian letters and numbers (a default GSM alphabet). Its maximum size is 255 characters for the Latin alphabet and 70 characters for the Russian alphabet. A maximum size of an SMS after all values of all variables have been substituted is 160 characters.
To decipher values of a current status of parameters in a test SMS message, there is a need to adjust variables. To do this, there is a need to go to the page «VARIABLES» of a device web interface and click the field «click here to add new data»:

There is a need to add the following into the window of a new variable that appeared:

Short Name – is a name of a variable that will be used in SMS notifications. A name must consist of less than 31 characters. Using spaces is prohibited. On default: empty row
OID – is SNMP OID of a variable. It consists of less than 62 characters. It always begins with a dot. For example:
.1.3.6.1.4.1.25728.8800.1.1.2.1
.1.3.6.1.4.1.25728.911.1.0
It is possible to use a NetPing MIB reference to fill in this field (true for NetPing devices only). On default: empty row
Agent – is a drop-down list of short names of SNMP agents configured at the page «AGENTS». On default: agent is not chosen
Dictionary – is a table of pairs «Numeric Value - Textual Label». It is not obligatory to fill in. It is used to link numeric values of SNMP variables to their textual description, understandable for a human. This textual description can be used in SNMP commands later on instead of a corresponding value. This value must be integer. Decryption is done by Latin letters without spaces and underlining a register. A total length of a dictionary is 127. When storing the dictionary in a memory of a device, special delimiter characters are used (commas, brackets, spaces) that are taken into account when calculating a dictionary length. On default: dictionary is empty
To add a pair «Numeric Value - Textual Label» into a dictionary, fill in the last (empty) row. To delete a pair «Numeric Value - Textual Label» remove data in this row and click the button «Save changes»;
A NetPing MIB reference makes it easier to add new SNMP variables if a NetPing device is an agent. To run a dictionary, click the button «NetPing MIB Reference» in a window that opens for adding a new SNMP variable.

A list of known SNMP variables is displayed in the left column of the reference. Choose a necessary SNMP variable and click on it. In the right column, you will see an OID of this variable as well as a small help. Indicate a necessary index of an SNMP variable in a drop-down list «choose index». Usually, an index is similar to a number of a temperature sensor and IO line. An index will be added into the end of OID. Check a checkbox «Add OID name» to copy a name of an SNMP variable from a dictionary to a field «Short name».

As a result of all actions described above, a servicing staff will receive SMS notifications from a door sensor, which is connected to a UniPing v3 device as follows:

where:

Door 1 – is a door sensor connected to an IO line №1 of a UniPing v3 device;

Open (0)/Close (1) – is a sensor status decryption, which is set at the page «VARIABLES» of a device web interface