display failover

Purpose

Displays IP network failover status and statistics.

Required permissions

For Digi products with two or more users, permissions must be set to
set permissions display=execute to use this command. See set permissions for details on setting user permissions for commands.

Syntax

display failover

Examples

In the following example, the Ethernet interface, eth0, has been configured for IP failover.

#>display failover
Failover is on/enabled, which overrides the non-failover gateway configuration.
Current Default Gateway Status:
  Gateway interface : eth0
  Gateway address   : 192.168.250.1
  Configured by     : failover
Current Network Failover Status:
  Failover state           : on
  Fallback to non-failover : on
  Priority  Interface       Status              Gateway         State  Tests
     1      mobile0         2 (up)              68.28.89.85      on      0
     2      eth0            1 (responding)      192.168.250.1    on      1
     3      wln0            2 (up)              192.168.33.1     on      0
Current Network Gateway Status (Non-Failover):
  Priority  Interface       Status      Gateway
     1      mobile0         1 (up)      68.28.89.85
     2      eth0            1 (up)      192.168.250.1
     3      wln0            1 (up)      192.168.33.1
Current Failover Link Test Statistics:
                     Test         Test       Bypass  Consecutive     Link Not
  Interface       Success      Failure         Test     Failures   Responding
  mobile0               0            0            0            0            0
  eth0                  1            0            0            0            0
  wln0                  0            0            0            0            0

These examples show using the display failover command to display the network interface list when the mobile0 (cellular) interface is up and down.

When mobile0 interface is up:

#> display failover

Failover is off/disabled, which enables the non-failover gateway configuration.

Current Default Gateway Status:

  Gateway interface : mobile0
  Gateway address   : 10.0.0.1
  Configured by     : non-failover

Current Network Failover Status:

  Failover state           : off
  Fallback to non-failover : on

  Priority  Interface       Status              Gateway         State  Tests
     1      mobile0         2 (up)              10.0.0.1         on      0
     2      eth0            2 (up)              10.30.1.1        on      0

Current Network Gateway Status (Non-Failover):

  Priority  Interface       Status      Gateway
     1      mobile0         1 (up)      10.0.0.1
     2      eth0            1 (up)      10.30.1.1

Current Failover Link Test Statistics:

                     Test         Test       Bypass  Consecutive     Link Not
  Interface       Success      Failure         Test     Failures   Responding
  mobile0               0            0            0            0            0
  eth0                  0            0            0            0            0

When mobile0 interface is down:

#> display failover

Failover is off/disabled, which enables the non-failover gateway configuration.

Current Default Gateway Status:

  Gateway interface : eth0
  Gateway address   : 10.30.1.1
  Configured by     : non-failover

Current Network Failover Status:

  Failover state           : off
  Fallback to non-failover : on

  Priority  Interface       Status              Gateway         State  Tests
     1      mobile0         4 (down)            0.0.0.0          on      0
     2      eth0            2 (up)              10.30.1.1        on      0

Current Network Gateway Status (Non-Failover):

  Priority  Interface       Status      Gateway
     1      mobile0         0 (down)    0.0.0.0
     2      eth0            1 (up)      10.30.1.1

Current Failover Link Test Statistics:

                     Test         Test       Bypass  Consecutive     Link Not
  Interface       Success      Failure         Test     Failures   Responding
  mobile0               0            0            0            0            0
  eth0                  0            0            0            0            0

See also

set failover for more information on the IP network failover feature.