display pppstats
Purpose
Displays status and activity information for a Point-to-Point Protocol (PPP) link, including SureLink statistics.
Required permissions
For Digi products with two or more users, set permissions to set permissions display=execute to use this command. See set permissions for details on setting user permissions for commands.
Syntax
display pppstats
Examples
#> display pppstats
PPP Status (mobile0):
state : active
ip address : 166.130.0.157
peer address : 192.168.111.111
primary dns addr : 209.183.33.23
secondary dns addr : 209.183.33.23
tx bytes : 20403
rx bytes : 23430
session tx bytes : 250
session rx bytes : 736
idle resets : 41
no carrier resets : 0
no service resets : 0
admin resets : 0
non-admin resets : 2
surelink resets : 0
lcp keepalive resets : 0
last reset reason : idle
tx timer : 0 seconds
rx timer : 3600 seconds
session time : 2 hours, 50 minutes, 15 seconds
tx idle time : 2 hours, 50 minutes, 15 seconds
rx idle time : 35 minutes, 41 seconds
lcp echo requests : inactive
SureLink statistics:
session successes : 0
session failures : 0
session consecutive failures : 0
session bypasses : 0
total successes : 0
total failures : 0
total link down requests : 0 total bypasses : 0
Output
PPP status and activity Information returned by “display pppstats”
This information is specific to cellular-enabled Digi products.
display pppstats
Displays status and activity information for a PPP link and SureLink statistics.
In these status and activity values, a session is a PPP session. The session statistics are reset to zero at the start of a new PPP link. The total statistics are the accumulated totals for all sessions since the device booted.
state
The current state of the PPP link. Active indicates that a PPP link is up. Inactive means the PPP link is down. Inactive is indicated when the link is coming up, or going down.
ip address
The PPP WAN IP address of the Digi device. This is the IP address used to communicate over the cellular network. The carrier assigns this IP address most of the time, but can also be given to the network by the Digi device.
primary dns addr
secondary dns addr
These are addresses for the DNS nameservers used for performing name lookups. These DNS addresses are assigned by the carrier most of the time, but can also be assigned by users.
tx bytes
rx bytes
The total number of bytes transmitted (tx) or received (rx) over the PPP link since the last reboot.
session tx bytes
session rx bytes
The number of bytes transmitted (tx) or received (rx) over the PPP link in the current PPP session.
reset status
These PPP status values describe the reason for terminating the PPP link.
idle resets
The number of resets because the idle timeout was reached/exceeded for transmitted and received data. These idle timeouts are set by the set ppp command. Most of the time, no idle timeout is used on transmitted data.
no carrier resets
The number resets because the carrier was dropped for any reason.
no service resets
The number of resets because the data network was not available.
Note For Digi Cellular Family products, no carrier and no service resets indicate problems with your cellular service. No service resets could be cased by low signal strength. Review the signal strength and reposition the antenna or Digi device as needed. An external high-gain or directional antenna may be needed. These resets can also be due to roaming issue. To check the signal strength and current carrier settings, issue a display mobile command.
admin resets
The number of resets done for administrative purposes, such as issuing “kill” commands, or disconnecting a PPP session in the web interface’s Connections page by clicking the Disconnect button.
non-admin resets
The number of LCP termination requests made from the network; that is, the network notifies the Digi device that the PPP link is being brought down.
surelink resets
The number of resets caused by SureLink bringing down the PPP link and reestablishing it. SureLink performs three tests to monitor the integrity of the PPP link: ping, DNS, and TCP connection testing. The set surelink command has options for setting how these tests are performed (see set surelink). If SureLink is unable to complete these tests, it concludes that the link is broken, and reestablishes the connection.
lcp keepalive resets
The number of resets caused by the LCP keepalive tests. LCP keepalive tests are similar to the SureLink link integrity monitoring tests, and perform the equivalent of a ping test for the PPP link. If the cellular network does not ping back after the number of replies specified by the number of consecutive missed replaces on the set pppoutbound command option lcp_ka_max_missed_replies, the LCP keepalive feature drops the link.
last reset reason
The reason for the most recent reset of the PPP link.
idle
An idle reset brought down the link last.
lcp keepalive
An LCP keepalive reset brought down the link last.
surelink
Surelink tests failed and brought down the link.
no service
The modem received a no service indication on the monitoring channel, and brought down the link.
no carrier
The modem dropped the link (hard), and was responsible for the termination of the last link.
administrative
A user issued a kill command, or disconnected the PPP link in the web interface’s Connections page.
non-administrative
The network initiated closure of the last link.
unknown
The link was brought down for unknown reasons. This status is also displayed if the PPP connection has not been brought down since the Digi device was last rebooted. Since it is not possible for last reset reason information to persist across resets, this unknown state indicates that it is not clear which event may have been responsible for a reset that occurred at some point in the device’s operation.
tx timer
The time, in seconds, after which if no data is transmitted, the PPP link is disconnected. Typically, this value is 0 (disabled).
rx timer
The time, in seconds, the PPP link disconnects if noo data is transmitted. An idle reset ends the PPP session and reestablishes it to prevent the carrier network from dropping an inactive call. The default is 1440 seconds (24 minutes). This value is also known as the Inactivity timeout in the web interface’s Mobile Settings.
session time
The duration of the current PPP session. To display total system uptime, issue a display uptime command.
rx idle time
tx idle time
The amount of time since data was last received (rx)/or transmitted (tx) by the Digi device.
lcp echo requests
The number of Link Control Protocol (LCP) echo requests that have been sent after a “quiet” interval, in order to test the PPP link and/or keep it alive. For Digi Cellular products, LCP echo requests are typically not used.
Digi SureLink™ provides an “always-on” mobile network connection to ensure that a Digi Cellular Family device is in a state where it can connect to the network.
The statistics displayed for Digi SureLink pertain to the periodic tests, known as Link Integrity Monitoring tests, that are run over the established PPP connection to ensure that end-to-end communication is possible. There are three Link Integrity Monitoring tests available:
For descriptions of these tests, see set surelink.
In the SureLink statistics, a session is a PPP session. The session statistics are reset to zero at the start of a new PPP connection. The total statistics are the accumulated totals for all sessions since the device booted. The tests are the SureLink Link Integrity Monitoring tests that are configured to run when the mobile network connection is established.
session successes
The number of times a configured test attempts and succeeds in a PPP session.
session failures
The number of times a configured test attempts but fails in a PPP session.
session consecutive failures
The number of consecutive failures for a test. When a test is successful, the consecutive failures counter is reset to zero. The consecutive failures counter indicates a device's “progress” toward the configured maximum number of consecutive failures, after which the PPP link is taken down (and restarted).
session bypasses
If a configuration parameter is bad, a test is bypassed rather than considered to have succeeded or failed. This means the test was not run. If the PPP connection goes down while a test is in progress, that test may be classified as bypassed, since it could not be run.
Note The PPP link may go down for many reasons, independent of SureLink testing.
total successes
The total number of times a configured test attempts and succeeds since the Digi device was booted.
total failures
The total number of times a configured test attempts but fails since the Digi device was booted.
total link down requests
The number of times the SureLink feature has failed consecutively the configured number of failures and, as a result, requested that PPP shut down and restart its connection. This statistic counts such occurrences during the current device boot. SureLink itself does the PPP stop/start; it sends a message to PPP requesting a start/stop, due to a Surelink test failure.
total bypasses
The total test bypasses (see session bypasses statistic) since the Digi device was rebooted.
PDF
