Configuration Guide for Cisco NCS 1014, IOS XR Releases 26.x.x

PDF

Automatic bidirectional OTDR scan

Want to summarize with AI?

Log in

This section explains how automatic bidirectional OTDR scans identify fiber faults and locate issues by triggering scans in both directions during key network events.


Table 1. Feature History

Feature Name

Release Information

Feature Description

Automatic OTDR scan

Cisco IOS XR Release 25.2.1

An OTDR scan is automatically triggered on both Rx and Tx directions, whenever events such as span fault, span restore, device power cycle, and line card cold reload occur. The automatic scan lets you quickly identify fiber failure type and fault location, while avoiding any collision during the bidirectional autoscan.

Commands added to enable auto OTDR scan and view its results:

  • otdr auto-scan {enable | disable}

  • show olc otdr-status [details]

Automatic OTDR scan triggering events

The OTDR scan, starts automatically when events like span fault, span restoration, automatic OTDR scan enabling, device power cycling, and line card cold reload occur.

Autoscan direction and duration

The OTDR autoscan scans events in both Tx and Rx directions.

In both span up and span down events, the bidirectional OTDR scan process terminates after both Rx and Tx scans have been completed successfully. You can stop the scan sequence by disabling the autoscan feature.

The autoscan duration for Auto and Expert modes, the scan takes upto three minutes to complete. . During the autoscan, the OTDR-SCAN-IN-PROGRESS-RX and OTDR-SCAN-IN-PROGRESS-TX alarms are raised and get cleared once the scan is finished.

Autoscan behavior

The autoscan has these key behaviors:

  • The autoscan reserves the span on the peer node and locks the OTDR resource to prevent manual triggering of a scan using the otdr-start command . However, if a manual scan is already in progress, the autoscan will wait until the manual scan is completed before proceeding.

  • The autoscan terminates the ongoing scan and starts a new one if a change in Span Status is detected.

Span fault and restoration events detection

This table details how the span fault and span restore events are detected:

Table 2. Definition of span up and span down events
Events

Definition

Span Down

Raise of OSC-LOS and EDFA_RX_LOS alarms at the OSC controller

Span Up

Clearing of OSC-LOS and EDFA_RX_LOS alarms at the OSC controller


How the bidirectional autoscan works

Unidirectional and bidirectional fiber cuts

The bidirectional OTDR auto scan functions in the event of unidirectional and bidirectional fiber cuts, and during fiber restoration events.

In a span including both broken and non-broken fibers, the scanning behavior differs based on the type of fiber cut:

  • Unidirectional Fiber Cut:

    • The broken fiber is scanned in both the Rx and Tx directions by the Near End (NE) and Far End (FE) nodes.

    • The non-broken fiber is scanned only in the Tx direction.

  • Bidirectional Fiber Cut:

    • Both fibers are scanned in both the Rx and Tx directions.

Span down event

For a bidirectional autoscan triggered by a span down event:

  • Timeslots are used for both unidirectional and bidirectional fiber cuts as the node communication and hence negotiation is not possible.

  • Timeslots are of equal duration and are alternately assigned to Rx and Tx directions. This order is consistent across both NE and FE node.

  • If a scan cannot be completed inside the assigned timeslot or the scan execution failed for any reason, the execution is rescheduled at the next available timeslot for that port/direction.

Span up event

For a bidirectional autoscan triggered by a span up event:

  • Rx and Tx scans are executed sequentially through negotiation with the remote node, eliminating the need for time slots.

    The OSC and associated Ethernet communication must be functioning properly to initiate the scan.

In both span up and span down events, the bidirectional OTDR scan process terminates after both Rx and Tx scans have been completed successfully. You can stop the scan sequence by disabling the autoscan feature.


Enable automatic OTDR scan

Follow these steps to enable OTDR scan to run automatically during certain events.

Procedure

1.

Enter the OTS controller configuration mode for the port you want to configure the automatic OTDR scan.

Example:


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#optical-line-control controller Ots 0/0/0/0
                    
2.

Enable automatic OTDR scan.

Example:

RP/0/RP0/CPU0:ios(config-olc-ots)#otdr auto-scan enable 

If you want to disable the automatic OTDR scan, use the otdr auto-scan disable command.

3.

Commit the changes and exit all the configuration modes.

Example:


RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#exit
                    

Verify autoscan status

Use this task to verify the status of the autoscan.

Procedure

Use the command show olc otdr-status [details] to view the automatic OTDR scan results.

Example:

RP/0/RP0/CPU0:R1#show olc otdr-status 
Tue Oct 10 20:15:57.359 UTC 
 
Controller                : Ots0/0/0/0 
OTDR Auto-scan Status     : RUNNING 
Status Detail : Completed on Span Down. 
Auto-scan Rx Start Time   : 2023-10-10 20:12:01 
Rx Status Detail          : Completed on Span Down
Auto-scan Tx Start Time   : 2023-10-10 20:14:31 
Tx Status Detail          : Waiting for OTDR Resource 
Optical Span Status       : Up
Trigger Event             : Manual 
Last Trigger Event        : Manual  

See OTDR scan status for a list of the different OTDR scan statuses and their definitions.