Error Disable

Error-disable recovery is a feature that automatically re-enables interfaces or ports that have been shut down due to error conditions such as link OAM failures, UDLD violations, STP BPDU guard events, or L2VPN MAC move detections. When an error-disable condition is detected, IOS-XR places the affected interface in an error-disabled state to prevent further issues.

Key Components:

• Recovery Cause Settings (recovery_cause): Configures recovery intervals for various error-disable conditions.

Key Parameters Briefly Explained:

• recovery_cause: Recovery interval settings for link OAM, UDLD, STP, L2VPN, and other error conditions.

Diagram

Classes

iosxr

Name	Type	Constraint	Mandatory	Default Value
devices	List	devices	No
device_groups	List	device_groups	No
global	Class	global	No

devices (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

device_groups (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

global (iosxr)

Name	Type	Constraint	Mandatory	Default Value
configuration	Class	configuration	No

configuration (iosxr.devices)

Name	Type	Constraint	Mandatory	Default Value
error_disable	Class	error_disable	No

error_disable (iosxr.devices.configuration)

Name	Type	Constraint	Mandatory	Default Value
recovery_cause	Class	recovery_cause	No

recovery_cause (iosxr.devices.configuration.error_disable)

Name	Type	Constraint	Mandatory	Default Value
link_oam_session_down_interval	Integer	min: 30, max: 1000000	No
link_oam_discovery_timeout_interval	Integer	min: 30, max: 1000000	No
link_oam_capabilities_conflict_interval	Integer	min: 30, max: 1000000	No
link_oam_miswired_interval	Integer	min: 30, max: 1000000	No
link_oam_link_fault_interval	Integer	min: 30, max: 1000000	No
link_oam_dying_gasp_interval	Integer	min: 30, max: 1000000	No
link_oam_critical_event_interval	Integer	min: 30, max: 1000000	No
link_oam_threshold_breached_interval	Integer	min: 30, max: 1000000	No
stp_bpdu_guard_interval	Integer	min: 30, max: 1000000	No
stp_legacy_bpdu_interval	Integer	min: 30, max: 1000000	No
cluster_udld_interval	Integer	min: 30, max: 1000000	No
cluster_minlinks_interval	Integer	min: 30, max: 1000000	No
udld_unidirectional_interval	Integer	min: 30, max: 1000000	No
udld_neighbor_mismatch_interval	Integer	min: 30, max: 1000000	No
udld_timeout_interval	Integer	min: 30, max: 1000000	No
udld_loopback_interval	Integer	min: 30, max: 1000000	No
pvrst_pvid_mismatch_interval	Integer	min: 30, max: 1000000	No
l2vpn_bport_mac_move_interval	Integer	min: 30, max: 1000000	No
ot_track_state_change_interval	Integer	min: 30, max: 1000000	No
link_oam_dampening_interval	Integer	min: 30, max: 1000000	No

Example YAML Code:

Example-1: Configure error disable recovery for Link OAM related error conditions.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        error_disable:
          recovery_cause:
            link_oam_session_down_interval: 420
            link_oam_link_fault_interval: 424
            link_oam_dying_gasp_interval: 425

Example-2: Configure error disable recovery for UDLD (UniDirectional Link Detection) violations.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        error_disable:
          recovery_cause:
            udld_unidirectional_interval: 432
            udld_neighbor_mismatch_interval: 433
            udld_timeout_interval: 434

Example-3: Configure error disable recovery for STP and L2VPN error conditions to automatically re-enable affected ports.

iosxr:
  devices:
    - name: router-1
      host: 10.10.10.1:57400
      configuration:
        error_disable:
          recovery_cause:
            stp_bpdu_guard_interval: 428
            pvrst_pvid_mismatch_interval: 436
            l2vpn_bport_mac_move_interval: 437