SNMP Connector

Usage

Using the SNMP connector, network components such as servers, routers, switches or printers can be monitored and configured by a central SNMP server. When monitoring network components, error detection and error reporting are configurable.

Connector types

The functions of the SNMP connectors depend on the configuration:

  • Input Connector
    Transmits static OID value pairs from a table.

  • Medium Connector
    Transmits dynamic OID value pairs from the XML input message.

Principles

Many network components contain programs that enable SNMP communication to take place. These programs, known as agents and running directly on the monitored device, can transmit the state of the device and receive and apply data for configuring the network components.

Communication

An SNMP server is employed to monitor components in simple and complex IT networks. The agents running on the network components communicate with the server over SNMP. Communication over SNMP is based on the connectionless User Datagram Protocol (UDP) which simply adds the addressing data to the SNMP data packets and thus requires very little bandwidth. By default, the agents communicate through port 161 while the SNMP Manager communicates through port 162.

The structure of the SNMP data packets is transparent when using the SNMP connector. To configure the connector, all you need to know is the connection data, the type of the data packet and the OID.

Data packets

Only four of the six different data packets that are defined in the standard are needed for the SNMP connector. The data packets are named after the methods that are executed with them. The SNMP connector supports the GET, GETNEXT, SET and TRAP operations.

OID

Each agent is aware of the value of the parameters of its network components. This can be used to either issue a status message (Trap) or to change the configuration. These parameters are known as managed objects. All managed objects are held in a tabular list (not in a database). This list is called the Management Information Base, abbreviated to MIB. An object identifier, abbreviated to OID, is assigned to each managed object in the MIB.

The object identifier is a string composed of numbers and dots. The structure of this string follows a structure that is composed of the so-called MIB tree.

For an illustration of the MIB tree, refer to https://de.wikipedia.org/wiki/SNMP.

This numeric code also contains a portion that indicates the company. Virtimo AG has been assigned the code 15899 for its INUBIT software. Thus, the start of the OID looks like this:

  • in plain text: iso.org.dod.internet.private.enterprise.INUBIT.

  • as an OID: 1.3.6.1.4.1.15899.

The OID has only been standardized as far as the Private Enterprise Code. The composition of the remainder of the OID is not standardized. It is up to the system administrators to create an internal company system that covers all network components and assigns these numbers. A number must also be allocated to each of the managed objects associated with the devices. The values of the managed objects, that is, of the events that can be monitored and configured by SNMP, are device-dependent and can only be found in the manufacturer’s manual in each case

OIDs as constants and variables

The rules for constructing the OID string out of digits and dots are frequently not followed since the OIDs are only used within the company and thus there is no need for uniqueness compared to the IT environment of other companies.

If a trap or a configuration instruction is to be sent, it normally consists of an OID and a value. Variable: Each OID can get only the values that are specified in the manufacturer’s data for the network component. Constants: In some cases just an OID is transmitted, without a value. This is the case if a managed object can only communicate a state via an OID.

Community

SNMP offers the facility to transmit a so-called community string when communicating. Only components that belong to the same community react to traps or configuration commands. The community string is transmitted unencrypted.

Example: Medium Connector for an SNMP Connector

An ISDN connection is to be established in the workflow through an SNMP connector via a router. Subsequently, at the end of the workflow, a message is to be sent over this connection to an FTP connector.

With the SNMP medium connector, tables of tuples consisting of the OID and a value cannot be specified. Instead, the relevant value pairs are expected in the XML input message.

An OID can either contain:

  • no value specification, in which case the OID itself is the instruction for the configuration, or

  • an integer, in which case the configuration is dependent on the value of the number, or

  • a value in the form of a text string.

In an XML input message, these three different cases have the following format. The OIDs and values are examples.

<Property name="1.3.6.1.4.1.272.4.4.1.1.4.10001.0"/>
<Property name="1.3.6.1.4.1.272.4.3.1.1.7.1.4" type="Integer">
  2
</Property>
<Property name="1.3.6.1.4.1.272.4.4.1.1.4.10001.0">
  UID_name
</Property>

The router is configured dynamically during the execution of the workflow. The required values are read from the input message, turned into an XML message by an XSLT converter and are then passed to the SNMP connector.

The following figure shows the mapping in the XSLT converter. The abbreviations are explained as follows:

  • PPP = Point-to-Point Protocol

  • PAP = Password Authentication Protocol

module guide 1165 0

The following lines show the XML message that is passed to the SNMP medium connector as a result of the mapping:

<?xml version="1.0" encoding="ISO-8859-1" ?>
<SNMPVarBinds version="4.0">
  <Property name="1.3.6.1.4.1.272.4.3.1.1.7.1.4"
    type="Integer">2</Property>
  <Property name="1.3.6.1.4.1.272.4.4.1.1.4.10001.0"/>
  <Property name="1.3.6.1.4.1.272.4.3.1.1.9.1.4"/>
  <Property name="1.3.6.1.4.1.272.4.3.1.1.24.1.4"/>
</SNMPVarBinds>

Example: SNMP Input Connector

This example relates to the medium connector example.

If the router’s ISDN connection always uses the same data, this connection can be configured right at the start of the workflow with a static OID table. To do this an SNMP input connector is configured as follows:

module guide 1166 0

Dialog SNMP Connector Properties

In this dialog you have the following options:

Basic configuration

  • SNMP version
    The configuration of the SNMP message depends on whether version 1 or 2c is selected. Ask your administrator which version of SNMP is used in your company network.

  • Server name
    Enter the server name here. Either a plain text name or an IP address can be entered.

  • Port
    The default port is 161. If SNMP communication runs through a different port, ask your administrator for the port number. Click the Default button to reset the port number to the default value of 161.

  • Community
    This is an editable combo box. The community string public is often used as a default. If another string is used, enter it here. Modern network components can belong to more than one community. Ask your administrator for the valid community string.

Configuration of the variable binding

Operation: Four different operations are available

  • GET: requests a record. The record contains the data on the configuration of a network component. The SNMP connector returns the data that is specified for this event in the manual for the network component.

  • GETNEXT: Continues requesting records until the end of a list of records is reached. This operation is used when the configuration of a network component extends over more than one record.

  • SET: Sends a record to configure a network component. The network component responds with a record containing the result of the configuration.

  • TRAP: Automatically triggered notification of an event occurring to a monitored component.

For the purpose of variable binding, a table of pairs is built, each pair consisting of an OID and a value. This table is only available for the SNMP input connectors.

Table

Offers a context menu for adding and deleting OIDs.

Ask your administrator for the OID and value for the desired action or get them from the manual for the particular network component.

Trap configuration
(For operation TRAP only)

  • Sender IP
    IP address or name of the host which sends SNMP traps.

  • Sender OID
    OID of the device which generates the trap. The OID defines the type of the SNMP device. Refer to Principles.

  • Generic ID
    Generic TrapID. Select the relevant ID from the list of possible TrapIDs. If you use an enterprise-specific ID, enter this in the following field Specific ID.

  • Specific ID
    Enter an enterprise-specific TrapID, if required.

    If necessary, ask your administrator for the OID and other Trap-related specifications.

Connection test

  • Test connection
    For testing whether the connection can be successfully established using your configuration.