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.
...
.
| 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 NETx BMS 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 NETx SNMP Module module supports Version 1 and Version 2 of the Standardstandard. 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 NETx BMS Core Server checks the availability of the SNMP device in the network. The default refresh interval is "'3000"' milliseconds. | 100 - 2147483647 | ms | 5000 | ||
| 7 | Max Request Items | The number of polling items can be limited, so that the SNMP device is not overloaded. By default the item amount is restricted to "'10"' items. | 1 - 2147483647 | none | 10 | ||
| 8 | Max Parallel cmds | Defines the number of requests which are used by the NETx BMS Core Server to poll the defined items. By default "'1"' request is used per device to query the data. | 1 - 2147483647 | none | 1 | ||
| 9 | Ignore Items Quality | The parameter enables to reset item values on the NETx BMS Core Server, depending on the quality (status) of the SNMP device. The default value is "'F"' (false). | 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 which is decribed in section 4.3.5.4.. | 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 |