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

PDF

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

ONS-QSFP-PSM2 pluggables

Want to summarize with AI?

Log in

This section explains how the ONS-QSFP-PSM2 pluggable provides optical channel protection on supported NCS 1014 line cards and maintains service by selecting a working or protected path.


An ONS-QSFP-PSM2 pluggable is a QSFP-DD optical protection switching module that

  • splits the transmit signal from the common port across the working and protected paths;

  • monitors the working and protected receive paths independently and selects a signal based on optical-power thresholds; and

  • helps maintain service when a path degrades or fails.

The pluggable supports wide-band switching based on total optical power and frequency-selective switching based on the power of a channel at a configured baud rate.

Table 1. Feature history

Feature name

Release information

Description

ONS-QSFP-PSM2 channel protection switching support

Cisco IOS XR Release 26.3.1

NCS 1014 supports the ONS-QSFP-PSM2 pluggable module to enable channel protection. The NCS1K4-QXP-K9, NCS1K14-2.4T-K9, and NCS1K14-2.4T-X-K9 line cards are the host cards and support ONS-QSFP-PSM2 in both wide-band (all-channel) and frequency-selective (single-channel) protection modes within WDM optical systems.

This support enhances network resilience by providing automated, seamless traffic recovery during signal degradation or failure.

Optical Transport Section controllers

When a physical port is configured in protection switching module (PSM) mode, three Optical Transport Section (OTS) controllers are created. These controllers represent the Common (COM), Working (W), and Protection (P) ports of the pluggable.

Table 2. ONS-QSFP-PSM2 logical ports

OTS controller

Logical port

Function

OTS R/S/I/P/0

Common

Controls PSM settings and connects to the protected optical channel.

OTS R/S/I/P/1

Working

Carries traffic on the preferred path and provides optical-power measurements.

OTS R/S/I/P/2

Protected

Carries traffic on the alternate path and provides optical-power measurements.

Note

A single physical-port LED represents the common, working, and protected logical ports. It turns Red when any logical port has an active alarm and Green when none has an active alarm.

Protection behavior

PSM Module enables dynamic switching between working and protection paths through integrated 1x2 switches in the RX section, and signal bridging to both working and protection ports in the TX section. The auto switching is based on the detected RX-LOS-P alarm, and user can select working or protect path manually using manual switch command.

  • In non-revertive operation, traffic remains on the protected path after the working path recovers.

  • In revertive operation, traffic returns to the working path after the configured wait-to-restore interval.

  • In bidirectional operation, both ends coordinate their switching state. Unidirectional operation switches each direction independently.


ONS-QSFP-PSM2 parameters and configuration guidelines

Use this information to determine whether the pluggable and a proposed configuration are supported before you provision PSM mode.

Table 3. Supported line cards and ports

Line card

Eligible port

Protection in Release 26.3.1

NCS1K4-QXP-K9

Any free client or trunk port

Channel

NCS1K14-2.4T-K9

A client port that is not assigned to a transponder or muxponder slice

Channel

NCS1K14-2.4T-X-K9

A client port that is not assigned to a transponder or muxponder slice

Channel

Note

Section and path protection are planned for a future release. Do not configure these protection types for customer traffic in Release 26.3.1.

The PSM uses these cable assemblies:

  • ONS-MPO-6LC-3: Optical channel protection. The cable is also intended for path protection when that mode becomes available.

  • ONS-MPO-8LC-2: Optical multiplex section protection when that mode becomes available.

Table 4. Core PSM parameters

Parameter

Supported value

Default

Controller

protection-type

channel

channel

COM

protection-switching-criteria

signal-power or total-power

signal-power

COM

switching-type

revertive or non-revertive

non-revertive

COM

switching mode

bidirectional or unidirectional

bidirectional

COM

revertive-timer

0-65535 seconds

120 seconds

COM

hold-off-timer

0-1000 milliseconds

0 milliseconds

COM

safety-control-mode

auto or disable

disable

COM

auto-threshold

enabled or disabled

disabled

COM

Table 5. Extended PSM parameters

Parameter

Supported value

Default

Controller

auto-threshold margin

1-25.5 dB in 0.1-dB units

5.0 dB

COM

auto-threshold rx-power-time-interval

10-255 seconds

90 seconds

COM

revertive-delta

1-25.5 dB in 0.1-dB units

1.0 dB

COM

baud-rate

0-65535

138

COM

lockout-from

work or protect

None

COM

tx-voa-attenuation

0-15 dB

0 dB

Working or protected

rx-voa-attenuation

0-15 dB

0 dB

Working or protected

rx-low-threshold

-23 to +27 dBm on COM; -26 to +5 dBm on working or protected

-23 dBm on COM; -20 dBm on working and protected

COM, working, or protected

Table 6. PSM parameter behavior

Parameter

Behavior

lockout-from

Excludes the selected path from protection. If the selected path is active, the PSM switches traffic to the other available path.

auto-threshold

Calculates receive low thresholds from measured optical power by using the configured margin and receive-power sampling interval. The working and protected receive paths are monitored independently.

uni-dir

Allows each traffic direction to switch independently. Without this configuration, the default switching mode is bidirectional.

revertive

Returns traffic to the working path after the working path recovers and the revertive timer expires.

non-revertive

Keeps traffic on the protected path after the working path recovers.

ONS-QSFP-PSM2 configuration guidelines

  • Configure the baud rate to match the protected channel when using signal-power as switching criteria. A matching value improves power-measurement accuracy and switching time.

  • Enable either revertive switching or automatic threshold calculation. These functions do not operate together.

  • Use manually configured receive low thresholds only when automatic threshold calculation is disabled. When enabled, automatic threshold calculation controls the thresholds for the working and protected paths.

  • Use safety control mode for path protection. In Release 26.3.1, this configuration is available but is not fully qualified for channel protection.

Limitations

  • When the switching criteria is changed between signal power and total power, Rx-low threshold and revertive-delta parameters must be explicitly reconfigured or removed. The new mode uses default values, not user-configured values.

  • In channel protection mode with signal power as switching criteria , the ONS-QSFP-PSM2 requires a signal at COM-RX to detect channel power at W-RX and P-RX. If COM-RX is not receiving expected power or signal, W-RX and P-RX report -50 dBm. This is an expected behaviour and does not apply in total-power mode.

  • Last switching time value is reset to '0' upon LC/Optics/RP reload.


Configure the ONS-QSFP-PSM2 channel-protection mode

Set the PSM mode to create Common, Working, and Protected Optical Transport Section (OTS) controllers, and enable optical channel protection.

This procedure configures an ONS-QSFP-PSM2 pluggable in slot 0, port 2 as an example. Replace rack, slot, instance, and port values to match your system.

Before you begin

  • Ensure the ONS-QSFP-PSM2 pluggable is installed in a supported line-card port.

  • On an NCS1K4-QXP-K9 card, use a free client or trunk port.

  • On an NCS1K14-2.4T-K9 or NCS1K14-2.4T-X-K9 card, use a client port that is not assigned to a transponder or muxponder slice.

Follow these steps to configure the ONS-QSFP-PSM2 channel-protection mode:

Procedure

  1. Run the hw-module location 0/ <slot> /NXR0 ols-port <port> mode psm command to configure the pluggable on a specific OLS port in PSM mode.

    Example:

    This is a sample to configure the pluggable in slot 0, port 2.

    
    RP/0/RP0/CPU0:psm#configure
    RP/0/RP0/CPU0:psm(config)#hw-module location 0/0/NXR0 ols-port 2 mode psm
    RP/0/RP0/CPU0:psm(config)#commit
    RP/0/RP0/CPU0:psm(config)#end 
    

    Once PSM mode is configured, all default settings apply.

  2. (Optionl) Run the no hw-module location 0/ <slot> /NXR0 ols-port <port> mode psm command to delete the PSM mode.

    Example:

    To remove PSM mode from slot 0, port 2.

    
    RP/0/RP0/CPU0:psm#configure
    RP/0/RP0/CPU0:psm(config)#no hw-module location 0/0/NXR0 ols-port 2 mode psm
    RP/0/RP0/CPU0:psm(config)#commit
    RP/0/RP0/CPU0:psm(config)#end 

The selected port is configured as an ONS-QSFP-PSM2 channel-protection port.


Configure PSM parameters

Configure the PSM parameters for channel-protection mode in your ONS-QSFP-PSM2 pluggable to ensure optimal switching and protection functionality.

This task outlines the configuration steps for PSM parameters on an NCS 1014 port, including protection modes, switching criteria, thresholds, and timers.
Follow these steps to configure the PSM parameters:

Procedure

Configure PSM parameters as required.
Table 7. PSM parameter configuration

If...

Then...

You configure channel protection on the common OTS controller.

Run the controller ots <R/S/I/P/0> protection-type channel command.

RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm protection-type channel
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end
Note
For signal-power switching, it is recommended to configure the baud rate to match the protected channel.

You select total-power or signal-power switching.

Use total-power switching for a wide-band signal.

Run the controller ots <R/S/I/P/0> psm protection-switching-criteria <signal-power | Total Power> command.

RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm protection-switching-criteria total-power
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You configure baud rate.

Run the controller ots <R/S/I/P/0> psm protection-switching-criteriasignal-power baud-rate <value> command.

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm protection-switching-criteria signal-power baud-rate 60
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You configure revertive or non-revertive switching.

Run the controller ots <R/S/I/P/0> psm protection-switching-criteria <revertive | non-revertive> <value> command.

This is a sample to configure revertive switching.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm switching-type revertive
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

The revertive timer (revertive-timer <value: 0- 65535>) and revertive delta <value:10 – 255> (in units of 0.1 dB) are optional parameters in revertive mode. If you do not configure them, the system uses the default values: 120 seconds for the revertive timer and 1.0 dB for the revertive delta.

This is a sample to configure revertive timer.


RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm revertive-timer 60
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

This is a sample to configure revertive delta.


RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm revertive-delta 10
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

This is a sample to configure non-revertive switching.


RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm switching-type non-revertive
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You enable auto-threshold.

Run the controller ots <R/S/I/P/0> psm auto-threshold command.

When automatic threshold is configured, default values are used for auto-threshold margin and rx-power-time-interval..

This is a sample to enable auto-threshold.


RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm auto-threshold
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You configure the auto-threshold margin.

Run the controller ots <R/S/I/P/0> psm auto-threshold margin <value> command. .

This is a sample to enable auto-threshold margin .


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm auto-threshold margin 50
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You enable auto-threshold rx-power-time-interval.

Run the controller ots <R/S/I/P/0> psm auto-threshold rx-power-time-interval <value> command.

This is a sample to enable auto-threshold rx-power-time-interval.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm auto-threshold rx-power-time-interval 90
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

The PSM controls the Working and Protected Rx low thresholds current value while auto-threshold is enabled.

You configure receive low thresholds when auto-threshold calculation is disabled.

Run the controller ots <R/S/I/P/0> rx-low-threshold <value> command.

This is a sample to configure -23.0 dBm on the common port and -20.0 dBm on the working and protected ports.


RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 rx-low-threshold -230
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/1 rx-low-threshold -200
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/2 rx-low-threshold -200
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

The CLI expresses optical-power values in 0.1-dBm units.

You configure unidirectional switching mode.

Run the controller ots <R/S/I/P/0> psm uni-dir command.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm uni-dir
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You configure bidirectional switching mode.

Run the no controller ots <R/S/I/P/0> psm uni-dir command.


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#no controller ots 0/0/0/2/0 psm uni-dir
RP/0/RP0/CPU0:ios(config)#commit
RP/0/RP0/CPU0:ios(config)#end

You configure the hold-off timer.

Run the controller ots <R/S/I/P/0> psm hold-off timer <value> command.

The value range is 0 -1000.


RP/0/RP0/CPU0:ios#configure terminal
RP/0/RP0/CPU0:ios#(config)#controller ots 0/0/0/2/0 psm
RP/0/RP0/CPU0:ios#(config-Ots-psm)#hold-off-timer ?
  <+0,+1000>  Hold-off timer (milliseconds)
RP/0/RP0/CPU0:ios#(config-Ots-psm)#hold-off-timer 30
RP/0/RP0/CPU0:ios#(config-Ots-psm)#commit
RP/0/RP0/CPU0:ios#(config-Ots-psm)#end

You configure lockout-from.

Run the controller ots <R/S/I/P/0> lockout-from <none | protected| working > command.


RP/0/RP0/CPU0:ios#configure terminal
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/0 psm
RP/0/RP0/CPU0:ios(config-Ots-psm)#lockout-from ?
  none       Clear lockout
  protected  Lock out protected port
  working    Lock out working port
RP/0/RP0/CPU0:ios(config-Ots-psm)#lockout-from working
RP/0/RP0/CPU0:ios(config-Ots-psm)#commit
RP/0/RP0/CPU0:ios(config-Ots-psm)#end

You configure Tx or Rx VOA attenuation on Work or Protect ports.

Run the controller ots <R/S/I/P/<1/2> tx-voa-attenuation rx-voa-attenuation <Value> command. .

The value range is 0-150.


RP/0/RP0/CPU0:ios#configure terminal
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/1
RP/0/RP0/CPU0:ios(config-Ots)#tx-voa-attenuation 100
RP/0/RP0/CPU0:ios(config-Ots)#commit
RP/0/RP0/CPU0:ios(config-Ots)#end

RP/0/RP0/CPU0:ios#configure terminal
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2/1
RP/0/RP0/CPU0:ios(config-Ots)#rx-voa-attenuation 100
RP/0/RP0/CPU0:ios(config-Ots)#commit
RP/0/RP0/CPU0:ios(config-Ots)#end

Verify the PSM mode configuration details

Ensure the common, working, and protected OTS controllers operate correctly after configuring the ONS-QSFP-PSM2 pluggable.

These verification steps use example values for slot 0, port 2. Replace the rack, slot, instance, and port values with those applicable to your system.

Before you begin

Configure the ONS-QSFP-PSM2 pluggable in PSM mode.

Follow these steps to verify PSM mode configuration details:

Procedure

  1. Run the hw-module location 0/ <slot> /NXR0 ols-port <port> command to verify that the selected OLS port is in PSM mode.

    Example:

    RP/0/RP0/CPU0:ios#show hw-module location 0/0/NXR0
             ols-port 2
             mode psm
  2. Run the show controllers controller type <R/S/I/P/0> psm-details command to verify the PSM configuration and active path.

    Example:

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/2/0 psm-details
    Selected switching criteria = Signal power
    Switching type              = Non-Revertive
    Switching Mode              = Bi-Directional
    Revertive timer             = 120 Sec
    Hold-off timer              = 0 ms
    Active Path                 = Working
    Last switching reason       = No switch
    Last switching time         = 0
    Auto-threshold status       = Enabled
    Safety Mode                 = Disabled
  3. Run the show controllers controller type <R/S/I/P/subport> command to verify operational data on the common, working, and protected OTS controllers.

    Example:

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/2/0
     Controller State: Up
     Transport Admin State: In Service
     LED State: Green
     Detected Alarms: None
    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/2/1
     Controller State: Up
     Transport Admin State: In Service
     LED State: Green
     Detected Alarms: None
    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/2/2
     Controller State: Up
     Transport Admin State: In Service
     LED State: Green
     Detected Alarms: None

The output confirms the PSM mode, switching state, OTS controller health, alarms, and optical performance.


Verify OTS controller operational data

Review the operational data for the common, working, and protected paths of the ONS-QSFP-PSM2 pluggable.

Before you begin

  • Configure the ONS-QSFP-PSM2 pluggable in PSM mode.

Follow these steps to verify OTS controller operational data:

Procedure

  1. Run the show controllers controllertype <R/S/I/P/subport> command to view the OTS controller operational data for the Common, Working, and Protected ports.

    Example:

    This sample displays operational data for Common port.

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/0
    Mon Aug 24 05:19:23.059 UTC
    
     Controller State: Up 
    
     Transport Admin State: In Service 
    
     LED State: Green 
    
     Last link flapped: 4d16h
    
             Alarm Status:
             -------------
             Detected Alarms: None
    
             Alarm Statistics:
             -----------------
             RX-LOS-P = 0          
             RX-LOC = 0          
             TX-POWER-FAIL-LOW = 0          
             INGRESS-AUTO-LASER-SHUT = 0          
             INGRESS-AUTO-POW-RED = 0          
             INGRESS-AMPLI-GAIN-LOW = 0          
             INGRESS-AMPLI-GAIN-HIGH = 0          
             EGRESS-AUTO-LASER-SHUT = 0          
             EGRESS-AUTO-POW-RED = 0          
             EGRESS-AMPLI-GAIN-LOW = 0          
             EGRESS-AMPLI-GAIN-HIGH = 0          
             HIGH-TX-BR-PWR = 0          
             HIGH-RX-BR-PWR = 0          
             SPAN-TOO-SHORT-TX = 0          
             SPAN-TOO-SHORT-RX = 0          
             INGRESS-AMPLI-LASER-OFF = 0          
             EGRESS-AMPLI-LASER-OFF = 0          
    
             Parameter Statistics:
             ---------------------
             Total Rx Power = 0.37 dBm 
             Total Tx Power = -9.85 dBm 
             Tx Signal Power = -11.49 dBm 
             Rx Low Threshold Current = -23.0 dBm 
    
             Configured Parameters:
             -------------
             Rx Low Threshold = -23.0 dBm 
    

    Example:

    This sample displays operational data for Working port.

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/1
    Mon Aug 24 05:19:30.162 UTC
    
     Controller State: Up 
    
     Transport Admin State: In Service 
    
     LED State: Green 
    
     Last link flapped: 00:16:54
    
             Alarm Status:
             -------------
             Detected Alarms: None
    
             Alarm Statistics:
             -----------------
             RX-LOS-P = 1          
             RX-LOC = 0          
             TX-POWER-FAIL-LOW = 4          
             INGRESS-AUTO-LASER-SHUT = 0          
             INGRESS-AUTO-POW-RED = 0          
             INGRESS-AMPLI-GAIN-LOW = 0          
             INGRESS-AMPLI-GAIN-HIGH = 0          
             EGRESS-AUTO-LASER-SHUT = 0          
             EGRESS-AUTO-POW-RED = 0          
             EGRESS-AMPLI-GAIN-LOW = 0          
             EGRESS-AMPLI-GAIN-HIGH = 0          
             HIGH-TX-BR-PWR = 0          
             HIGH-RX-BR-PWR = 0          
             SPAN-TOO-SHORT-TX = 0          
             SPAN-TOO-SHORT-RX = 0          
             INGRESS-AMPLI-LASER-OFF = 0          
             EGRESS-AMPLI-LASER-OFF = 0          
    
             Parameter Statistics:
             ---------------------
             Total Rx Power = -3.78 dBm 
             Total Tx Power = -5.34 dBm 
             Rx Signal Power = -6.40 dBm 
             Rx Voa Attenuation = 0.0 dB 
             Tx Voa Attenuation = 0.0 dB 
             Rx Low Threshold Current = -9.0 dBm 
    
             Configured Parameters:
             -------------
             Tx Voa Attenuation = 0.0 dB 
             Rx Voa Attenuation = 0.0 dB 
             Rx Low Threshold = -9.0 dBm 
    

    Example:

    This sample displays operational data for Protected port.

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/2
    Mon Aug 24 05:19:33.569 UTC
    
     Controller State: Up 
    
     Transport Admin State: In Service 
    
     LED State: Green 
    
     Last link flapped: 00:15:25
    
             Alarm Status:
             -------------
             Detected Alarms: None
    
             Alarm Statistics:
             -----------------
             RX-LOS-P = 1          
             RX-LOC = 0          
             TX-POWER-FAIL-LOW = 0          
             INGRESS-AUTO-LASER-SHUT = 0          
             INGRESS-AUTO-POW-RED = 0          
             INGRESS-AMPLI-GAIN-LOW = 0          
             INGRESS-AMPLI-GAIN-HIGH = 0          
             EGRESS-AUTO-LASER-SHUT = 0          
             EGRESS-AUTO-POW-RED = 0          
             EGRESS-AMPLI-GAIN-LOW = 0          
             EGRESS-AMPLI-GAIN-HIGH = 0          
             HIGH-TX-BR-PWR = 0          
             HIGH-RX-BR-PWR = 0          
             SPAN-TOO-SHORT-TX = 0          
             SPAN-TOO-SHORT-RX = 0          
             INGRESS-AMPLI-LASER-OFF = 0          
             EGRESS-AMPLI-LASER-OFF = 0          
    
             Parameter Statistics:
             ---------------------
             Total Rx Power = -3.19 dBm 
             Total Tx Power = -5.80 dBm 
             Rx Signal Power = -8.35 dBm 
             Rx Voa Attenuation = 0.0 dB 
             Tx Voa Attenuation = 0.0 dB 
             Rx Low Threshold Current = -20.0 dBm 
    
             Configured Parameters:
             -------------
             Tx Voa Attenuation = 0.0 dB 
             Rx Voa Attenuation = 0.0 dB 
             Rx Low Threshold = -20.0 dBm 
  2. (Optional) Run the show controllers controllertype <R/S/I/P> command to view the Optics operational data.

    Note
    Only Optics Type and Transceiver Vendor Details are supported.

    Example:

    
    RP/0/RP0/CPU0:ios#show controllers optics 0/0/0/1
    Tue Sep  1 04:36:45.572 UTC
    
     Controller State: Down 
    
     Transport Admin State: In Service 
    
     Laser State: Off 
    
     LED State: Off 
     
     Optics Status 
    
             Optics Type:  QSFP-DD PSM
    
             Alarm Status:
             -------------
             Detected Alarms: None
    
    
    
             Alarm Statistics:
    
             -------------
             HIGH-RX-PWR = 0            LOW-RX-PWR = 0          
             HIGH-TX-PWR = 0            LOW-TX-PWR = 0          
             HIGH-LBC = 0               MEA  = 0          
             IMPROPER-REM = 0          
             TX Power = N/A 
             RX Power = N/A 
    
             Performance Monitoring: Enable 
    
             THRESHOLD VALUES
             ----------------
    
             Parameter                 High Alarm  Low Alarm  High Warning  Low Warning
             ------------------------  ----------  ---------  ------------  -----------
             Rx Power Threshold(dBm)         15.0      -26.0           0.0          0.0
             Tx Power Threshold(dBm)          0.0        0.0           0.0          0.0
             LBC Threshold(mA)                N/A        N/A          0.00         0.00
    
             LBC High Threshold = 98 % 
             Configured Tx Power = -1.50 dBm 
             Configured CD High Threshold = 180000 ps/nm 
             Configured CD lower Threshold = -180000 ps/nm 
             Configured OSNR lower Threshold = 0.00 dB 
             Configured DGD Higher Threshold = 180.00 ps 
             Polarization parameters not supported by optics
    
     Transceiver Vendor Details
    
             Form Factor            : QSFP-DD
             Name                   : CISCO-ACCELINK
             Part Number            : 10-100516-01
             Rev Number             : 12
             Serial Number          : ACW3011YL37
             PID                    : ONS-QSFP-PSM2
             VID                    : VES2
             Firmware Version       : Major.Minor.Build
             Active                 : 1.11.0
             Inactive               : 1.11.0
             Date Code(yy/mm/dd)    : 26/03/30
             Fiber Connector Type: MPO 
             Otn Application Code: Not Set 
             Sonet Application Code: Not Set 
             Ethernet Compliance Code: Not set 
         RP/0/RP0/CPU0:ios#

The operational data for the common, working, and protected ONS-QSFP-PSM2 paths is displayed, including controller status, alarm statistics, parameter values, and transceiver details.


Switch the ONS-QSFP-PSM2 path manually

Manually change the active receive path for ONS-QSFP-PSM2 traffic to facilitate maintenance or fault isolation without waiting for automatic switching.

Note

A manual switch allows you select the active receive path for ONS-QSFP-PSM2 traffic. Use a manual switch for troubleshooting, maintenance, or fault isolation. The manual switch will not take any action if the target path is already in a Loss of Signal (LOS) state.

Before you begin

  • Configure the ONS-QSFP-PSM2 port in PSM mode.

  • Verify that both the working and protected OTS controllers are operational.

Procedure

  1. Run the show controllers controllertype R/S/I/P/0 psm details command to identify the current active path.

    Example:

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/13/0 psm-details
    Active Path                 = Working
    Last switching reason       = No switch
    Last switching time         = 0
  2. Run the show controllers controllertype R/S/I/P/0 manual-switch-to-protected command to switch traffic to the protected path.

    Example:

    
    RP/0/RP0/CPU0:ios#psm controller ots 0/0/0/13/0 manual-switch-to-protected
    RP/0/RP0/CPU0:ios#

    To return traffic to the working path, run the show controllers controllertype R/S/I/P/0 manual-switch-to-work command.

  3. Run the show controllers controllertype R/S/I/P/0 psm details command to verify the active path and the most recent switching reason.

    Example:

    
    RP/0/RP0/CPU0:ios#show controllers ots 0/3/0/0/0 psm-details 
    Selected switching criteria     = Signal power
    Switching type                  = Non-Revertive
    Switching Mode                  = Bi-Directional
    Revertive timer                 = 120 Sec
    Hold-off timer                  = 0 ms
    Active Path                     = Protected
    Last switching reason           = Manual switchover
    Last switching time             = Tue Sep 08 13:15:38 2026 UTC
    Auto-threshold status           = Disabled
    Safety Mode                     = Disabled

View ONS-QSFP-PSM2 performance monitoring data

Display minimum, average, and maximum optical-power measurements for the common, working, and protected paths.

You can monitor performance for all three ONS-QSFP-PSM2 interfaces: common (COM), working, and protected. Both current and historical performance monitoring (PM) data are available for flex-bin, 30-second, 15-minute, and 24-hour intervals.

Before you begin

  • Configure the ONS-QSFP-PSM2 pluggable in PSM mode.

Follow these steps to view ONS-QSFP-PSM2 performance monitoring data:

Procedure

Run the show controllers controllertype R/S/I/P { pm { current | history } { 30 sec | 15-min | 24-hour | flex-bin } { optics} linenumber} command to display performance monitoring parameters for the Common, Working, and Protected ports.

Example:

This sample displays the current performance monitoring parameters of the Optics controller with 30-sec intervals for Common port.


RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/0 pm current 30-sec optics 1
Mon Aug 24 05:20:31.052 UTC

Optics in the current interval [05:20:30 - 05:20:31 Mon Aug 24 2026]

Optics current bucket type : Valid
             MIN       AVG       MAX      Operational      Configured      TCA   Operational      Configured     TCA
                                          Threshold(min)   Threshold(min) (min) Threshold(max)   Threshold(max) (max)
OPT[dBm]     : -9.90     -9.90     -9.90    0.00              NA              NO   0.00             NA              NO   
OPR[dBm]     : 0.37      0.40      0.40     -20.70            NA              NO   27.00            NA              NO   
OPT(S)[dBm]   : -11.53    -11.30    -11.30   0.00              NA              NO   0.00             NA              NO   

Last clearing of "show controllers OPTICS" counters never

Example:

This sample displays the current performance monitoring parameters of the Optics controller with 30-sec intervals for Working port.


RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/1 pm current 30-sec optics 1
Mon Aug 24 05:20:37.644 UTC

Optics in the current interval [05:20:30 - 05:20:37 Mon Aug 24 2026]

Optics current bucket type : Valid
             MIN       AVG       MAX      Operational      Configured      TCA   Operational      Configured     TCA
                                          Threshold(min)   Threshold(min) (min) Threshold(max)   Threshold(max) (max)
OPT[dBm]     : -5.36     -5.34     -5.32    0.00              NA              NO   0.00             NA              NO   
OPR[dBm]     : -3.93     -3.86     -3.78    -18.00            NA              NO   15.00            NA              NO   
OPR(S)[dBm]   : -6.53     -6.34     -6.20    -18.00            NA              NO   5.00             NA              NO   

Last clearing of "show controllers OPTICS" counters never

Example:

This sample displays the current performance monitoring parameters of the Optics controller with 30-sec intervals for Protected port.


RP/0/RP0/CPU0:ios#
RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/1/2 pm current 30-sec optics 1
Mon Aug 24 05:20:46.150 UTC

Optics in the current interval [05:20:30 - 05:20:46 Mon Aug 24 2026]

Optics current bucket type : Valid
             MIN       AVG       MAX      Operational      Configured      TCA   Operational      Configured     TCA
                                          Threshold(min)   Threshold(min) (min) Threshold(max)   Threshold(max) (max)
OPT[dBm]     : -5.83     -5.81     -5.74    0.00              NA              NO   0.00             NA              NO   
OPR[dBm]     : -3.21     -3.19     -3.17    -18.00            NA              NO   15.00            NA              NO   
OPR(S)[dBm]   : -8.52     -8.38     -8.24    -18.00            NA              NO   5.00             NA              NO   

Last clearing of "show controllers OPTICS" counters never
RP/0/RP0/CPU0:ios#

Review the output for minimum, average, and maximum optical-power measurements for the common, working, and protected ports.

Note

OPT TCA thresholds are not supported.