Location:
<WorkspaceDirectory>\DataFiles\xio.SNMP.DeviceDefinitions.dat
The SNMP devices definition specifies the communication components in the network. For each network component the device configuration needs to be specified. Based on the datapoint configuration which is discussed in the next section, the NETx BMS Core Server adds server items to the device which is represented in a separate directory. The parameter for the communication like IP address or port of the SNMP device are specified in this configuration.
The structure of the SNMP device definition file is as follows:
'SNMP device configuration file
'SNMP Server;Host IP;Port;Community string;Version code;Refresh interval;Max Request Items;Max Parallel cmds;Ignore Items Quality;Authentication name;
ServerRoomSensor;192.168.1.34;161;netxnetx;V2;5000;;;;;
TRAP_Wago1_22;192.168.1.22;161;public;V1;10000;;;;;
TRAP_Wago2_22;192.168.1.22;161;public;V2;10000;;;;;
TRAP_Wago3_22;192.168.1.22;161;public;V3;10000;;;;theuser;
Each line – except comment lines that start with ' – defines a single SNMP device.
<tr> <td>1</td> <td>SNMP Server</td> <td></td> <td> .
| Info |
|---|
|
<WorkspaceDirectory>\DataFiles\xio.SNMP.DeviceDefinitions.dat |
| Col# | Parameter | Description | Scope |
| Unit | Mandatory / default value |
|---|
| 1 | SNMP Server | This parameter specifies the name of the SNMP device which represents the device on the |
...
| Core Server and is important for the configuration of the data points. |
...
| string |
| none | mandatory |
| 2 | Host IP | The parameter refers to the IP address of the SNMP device in the network. |
...
| IP address |
| none | mandatory |
| 3 | Port | This attribute specifies the IP port of the SNMP device for the communication with the NETx BMS Core Server in the network. The default value is the "'161"'. |
...
| Port |
| 0 – 65535 | 161 |
| 4 | Community string | The authentication on a SNMP device requires a password which is called community string. The password can be individually set on each device, but the default value is "'public"'. |
...
| string |
| none | public |
| 5 | Version code | The SNMP standard has different versions with different functionality. The |
...
...
| module supports Version 1 and Version 2 of the |
...
| standard. This parameter identifies which version is supported by the device and used during the communication. By default the version code is "'V1"', which stands for SNMP Version 1. |
...
| V1,V2,V3 |
| none | V1 |
| 6 | Refresh interval | This attribute specifies the time span in which the |
...
| Core Server checks the availability of the SNMP device in the network. |
...
| | 100 - 2147483647 |
| ms | 5000 |
| 7 | Max Request Items | The number of polling items can be limited, so that the SNMP device is not overloaded. |
...
| 1 - 2147483647 |
| none | 10 |
| 8 | Max Parallel cmds | Defines the number of requests which are used by the |
...
| Core Server to poll the defined items. |
...
| | 1 - 2147483647 |
| none | 1 |
| 9 | Ignore Items Quality | The parameter enables to |
...
...
| Core Server, depending on the quality (status) of the SNMP device. |
...
| | true/false |
| none | false |
| 10 | Authentication Name | SNMP version 3 requires allows the encryption of data which is transferred during the communication. The name refers to the configuration of the user in the SNMP user definition file |
...
| . | none |
| Reference to SNMP user definitions | empty |
| 11 | Retry count | Number of tries that are performed before considered a network failure. | 1 - 2147483647 |
| none | 3 |