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

Configure optical safety for the EDFA2 card

Updated: September 23, 2026

Want to summarize with AI?

Use this procedure to configure safety parameters to manage and secure optical amplification on EDFA2 card ports.

Use this task to configure various optical safety parameters on the COM-TX and LINE-TX ports of the EDFA2 card.

The optical safety parameters are:

Table 1. Optical safety parameters
Parameters	Description
egress-ampli-safety-control-mode	Configures the safety mode. The available options are: auto: This is the default option. disabled: Use this option to work in ALS disabled mode where the EDFA maximum output power is clamped to 20dBm.
egress-ampli-osri	Configures the Optical Safety Remote Interlock (OSRI). Use the no form of the command to disable OSRI. The OSRI will turn off the EDFA, regardless of any power settings, regular configurations, or other maintenance settings, such as force APR or safety mode disable.
egress-ampli-force-apr	Forces the Automatic Power Reduction (APR). The available options are: off: This is the default option and re-enables the safety check mechanism starting from the Laser OFF condition. on: Use this option to forcibly enable the EDFA pump lasers, regardless of safety mode and LOS alarms. It also maintains the EDFA output power at a constant 'safe' level of +8 dBm.

Procedure

Use the command controller Ots R/S/I/P egress-ampli-safety-control-mode {auto | disabled} to enable or disable the optical safety mode on the EDFA2 card.

Example:

Enable and disable safety-control-mode on BST2 amplifiers (LINE-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/0 egress-ampli-safety-control-mode auto

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/0 egress-ampli-safety-control-mode disabled

Enable and disable safety-control-mode on PRE amplifier (COM-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/1 egress-ampli-safety-control-mode auto

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/1 egress-ampli-safety-control-mode disabled

Use the command controller Ots R/S/I/P no shutdown | shutdown} to configure the transport administration state on the CHECK-2 and CHECK-3 ports of the EDFA2 card, for PRE1 amplifier safety.
Example:

When both the CHECK ports are connected to the monitor ports of the NCS1K-MD-32O-CE and NCS1K-MD-32E-CE passive modules:
```
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2 no shutdown
```
```
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/3 no shutdown
```
When any one of the passive modules, configure one port as in- service and other port as out-of-service.
```
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/2 no shutdown
```
```
RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/3 shutdown
```

If you want to enable the OSRI on the EDFA2 card, use the controller Ots R/S/I/P egress-ampli-osri command.

Example:

Enable and disable OSRI on BST2 amplifiers (LINE-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/0 egress-ampli-osri

RP/0/RP0/CPU0:ios(config)#no controller ots 0/0/0/0 egress-ampli-osri

Enable and disable OSRI on PRE amplifier (COM-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/1 egress-ampli-osri

RP/0/RP0/CPU0:ios(config)#no controller ots 0/0/0/1 egress-ampli-osri

If you want to force APR or disable the APR, use the command controller Ots R/S/I/P egress-ampli-force-apr { off | on } to enable or disable the APR on the EDFA2 card.

Example:

Enable and disable APR on amplifiers (LINE-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/0 egress-ampli-force-apr on

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/0 egress-ampli-force-apr off

Enable and disable APR on PRE amplifier (COM-TX port):

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/1 egress-ampli-force-apr on

RP/0/RP0/CPU0:ios(config)#controller ots 0/0/0/1 egress-ampli-force-apr off

Verify the optical safety configurations on the EDFA2 card

Use this task to verify various optical safety parameters configured on the COM-TX and LINE-TX ports of the EDFA2 card.

Procedure

Use the show controllers ots R/S/I/P to verify the optical safety parameters configured on the COM-TX and LINE-TX ports of the EDFA2 card.

Example:

Verify the safety parameters configured on the BST2 amplifiers (LINE-TX port):

RP/0/RP0/CPU0:ios#show controllers ots 0/0/0/0 
Tue Feb 25 14:40:05.324 IST

 Controller State: Up 

 Transport Admin State: In Service 

 LED State: Green 

 Last link flapped: 3d20h

         Alarm Status:
         -------------
         Detected Alarms: None


         Alarm Statistics:
         -----------------
         RX-LOS-P = 1          
         RX-LOC = 1          
         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 = 1          
         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 = -5.11 dBm 
         Total Tx Power = 3.40 dBm 
         Rx Signal Power = -5.82 dBm 
         Tx Signal Power = -0.31 dBm 
         Tx Voa Attenuation = 9.2 dB 
         Egress Ampli Mode = Gain
         Egress Ampli Gain = 23.0 dB
         Egress Ampli Tilt = 0.0 dB
         Egress Ampli Safety Control mode = auto 
         Egress Ampli OSRI = OFF 
         Egress Ampli Force APR = OFF 
         Egress Ampli BR Power = -18.73 dBm 
         Egress Ampli BR Ratio = -18.40 dB 



         Configured Parameters:
         -------------
         Tx Voa Attenuation = 0.0 dB 
         Egress Ampli Mode = Gain
         Egress Ampli Gain = 23.0 dB 
         Egress Ampli Power = -2.0 dBm
         Egress Ampli Tilt = 0.0 dB
         Egress Ampli Safety Control mode = auto 
         Egress Ampli OSRI = Off 
         Egress Ampli Force APR = off
                  BR High Threshold = 0.0 dBm

Verify the safety parameters configured on the PRE amplifier (COM-TX port):

RP/0/RP0/CPU0:ios##show controllers ots0/0/0/1
Wed Oct  2 16:47:25.596 UTC
 
 Controller State: Up
 
 Transport Admin State: In Service
 
 LED State: Green
 
         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
 
         Parameter Statistics:
         ---------------------
         Total Rx Power = -11.89 dBm
         Total Tx Power = 3.99 dBm
 
 
         Tx Voa Attenuation = 1.0 dB
         Ingress Ampli Mode = Gain
         Ingress Ampli Gain = 8.0 dB
         Ingress Ampli Gain Range = Normal
         Egress Ampli Mode = Power
         Egress Ampli Gain = 19.0 dB
         Egress Ampli Tilt = 0.0 dB
         Egress Ampli Gain Range = Normal
         Egress Ampli Safety Control mode = auto
         Egress Ampli OSRI = OFF
         Egress Ampli Force APR = OFF
         Egress Ampli BR Power = -20.20 dBm
         Egress Ampli BR Ratio = -24.20 dB
 
 
 
         Configured Parameters:
         -------------
         Tx Voa Attenuation = 1.0 dB
         Ingress Ampli Gain = 8.0 dB
         Ingress Ampli Gain Range = Normal
         Egress Ampli Mode = Gain
         Egress Ampli Gain = 21.0 dB
         Egress Ampli Power = -5.0 dBm
         Egress Ampli Tilt = 0.0 dB
         Egress Ampli Gain Range = Normal
        Egress Ampli Safety Control mode = auto
         Egress Ampli OSRI = off
         Egress Ampli Force APR = off
         BR High Threshold = -17.0 dBm

The entries highlighted in bold show the optical safety parameters configured.

Troubleshooting EDFA-BST2 and pre-amplifier EDFA

Troubleshoot the booster amplifier (EDFA-BST2) issues

When the BST2 amplifier switches off for safety reasons, follow these steps to diagnose and resolve the issue:

Disable the safety feature on BST2: Set the safety disable option on the BST2 amplifier to allow for further investigation and configuration.Disable the safety feature on the BST2 amplifier to allow further investigation and configuration.
Check the received power value:
- Examine the received power on the RX line of the remote node (the node where the fiber span physically terminates at BST2).
- Compare the observed value with the expected operational thresholds.
Analyze threshold and power values:
- If the observed RX power is below the threshold but matches expected operational values:
  - Reconfigure the threshold to align with the expected RX power.
- If the observed RX power and Total RX Power are both -40 dBm:
  - This indicates a physical fiber interruption between the two sites. Inspect the fiber span for possible damage or disconnection.

Troubleshoot the pre-amplifier EDFA issues

When the Pre-Amplifier switches off for safety reasons, follow these steps:

Disable safety mode on the pre-amplifier: set the safety disable option on the pre-amplifier.
Verify received power on CHECK-2 and CHECK-3 ports:Check the power levels received on both CHECK-2 and CHECK-3 ports.

Note

These are typically monitor ports on the demux, with an expected attenuation of approximately -20 dBm from the demux output.
Analyze power levels:
- If power levels on both CHECK ports are below threshold, reset both thresholds to the correct values.
- If optical power is present on only one CHECK port but should be present on both, check the physical connection between the CHECK port (alarmed) and its corresponding demux monitor port.
- If optical power is present on only one CHECK port as expected (e.g., only one mux/demux is connected), shut down the CHECK port that is not in use (to avoid unnecessary alarms).
Restore safety mode:Once the checks and adjustments are complete, set the Pre-Amplifier safety mode back to automatic.

Note

If you need to operate with the safety feature disabled, both CHECK ports must be configured in shutdown mode.

Need help?

Open a support case

(Requires a Cisco Service Contract)

The documentation set for this product strives to use bias-free language. For the purposes of this documentation set, bias-free is defined as language that does not imply discrimination based on age, disability, gender, racial identity, ethnic identity, sexual orientation, socioeconomic status, and intersectionality. Exceptions may be present in the documentation due to language that is hardcoded in the user interfaces of the product software, language used based on RFP documentation, or language that is used by a referenced third-party product. Learn more about how Cisco is using Inclusive Language.