Mobile SureLink integrity monitoring settings
Enable Link Integrity Monitoring using the test method selected below
Enables or disables the link integrity monitoring tests. If this setting is enabled, you can configure the other Link Integrity Monitoring settings and use these settings to verify the functional integrity of the mobile connection. The default is off (disabled).
Link Integrity Monitoring Method
Several tests are available. For details about each type, see Link integrity test options.
- Ping Test
- TCP Connection Test
- DNS Lookup Test
- Device Cloud Connection Test
Host Address
These settings apply to Ping, TCP Connection, and DNS Lookup tests only. Two hostnames may be configured for the link integrity monitoring test. You can specify hostnames in the form of domain names or IP addresses. If the first hostname fails to reply, the same test is sent to the second hostname. The test fails if no reply is received for either hostname. The primary and secondary DNS names must be fully qualified domain names. Note that the reverse lookup of an IP address is possible, but that is usually unlikely to succeed in returning a name. You can still use a reverse lookup to demonstrate the integrity of the mobile connection.
TCP Port
The TCP port number to connect to on the remote host. The default is 80.
Repeat the selected link integrity test every N seconds
Specifies the interval, in seconds, at which the selected test is initiated (repeated). A new test will be started every N seconds while the mobile connection is established. This value must be between 10 and 65535. The default is 240. Only the Ping, TCP Connection Test, and DNS Lookup Test options use this setting. The Device Cloud Connection Test option does not use this setting.
If the configured interval is less time than it takes a test to complete, the next test will not be initiated until the previous (current) test has completed.
Test only when idle if no data is received for the above period of time
Repeats the test using the test repeat interval (above) after an idle period interval. That is, initiate the selected link integrity test only after no data has been received for the specified interval of time. This changes the behavior of the test in that the test interval varies according to the presence of other data received from the mobile connection. Only the Ping, TCP Connection Test, and DNS Lookup Test options use this setting. The Device Cloud Connection Test option does not use this setting.
Although using this idle option may result in less data being exchanged over the mobile connection, it also prevents the link integrity tests from running as often to verify the true bi-directional state of that connection.
Reset the link after this many link integrity test failures
The mobile connection resets or reconnects after the specified number of consecutive line integrity test failures. The mobile connection (reset or reconnect) is determined by the Link failure action setting.
This value must be between 1 and 255. The default is 3. When the mobile connection is reestablished, the “consecutive failures” counter is reset to zero.
If the mobile connection is disconnected for any reason (including not as a result of a link integrity test failure), the consecutive failures count is reset to zero when the mobile connection is reestablished.
Link Failure Action
The action to be performed when a link failure is detected:
- No action: No action is performed.
- Reset device: Reset the cellular modem in the XBee Gateway device.
- Reconnect interface: Reconnect the cellular interface.