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

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
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