Cisco NCS 1010 Optical Applications Configuration Guide, IOS XR Release 25.x.x

PDF

Configure Raman tuning

Updated: February 5, 2026

Overview

This topic explains Raman tuning configuration options on the NCS 1010 and directs you to tasks for automatic, manual, and parameter-based setup.

Use these tasks to configure Raman tuning based on your operational requirements.

Configure Raman tuning mode

Configure the Raman tuning mode to control how and when Raman tuning runs on the optical span. Use automatic mode to:

  • allow the system to trigger Raman tuning automatically.

  • start Raman tuning only when you explicitly initiate it.

Raman tuning optimizes signal amplification on an optical span. You can configure the tuning process to run automatically based on system events or manually based on operational requirements.

Before you begin

  • Ensure that you have access to the device CLI with configuration privileges.

  • The optical controller must be available and operational.

Follow these steps to configure Raman tuning mode.

Procedure

1.

Enter optical line control configuration mode and select the OTS controller.

Example:


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

Enable Raman tuning in automatic or manual mode.

Use the following command to configure the tuning mode:

raman-tuning {enable | manual}
3.

Commit the configuration and exit configuration mode.

Example:


RP/0/RP0/CPU0:ios(config-olc-ots)# commit
RP/0/RP0/CPU0:ios(config-olc-ots)# exit
RP/0/RP0/CPU0:ios(config-olc)# exit
4.

Start Raman tuning if the controller is configured in manual mode.

Example:


RP/0/RP0/CPU0:ios# olc start-raman-tuning controller ots 0/0/0/0

Raman tuning is configured in the selected mode.

When automatic mode is enabled, the system triggers Raman tuning automatically. After successful tuning, events such as soft reloads, Route Processor reloads, OSRI configuration changes, or forced Automatic Power Reduction (APR) changes do not retrigger Raman tuning.

What to do next

Verify Raman tuning status to confirm successful configuration and monitor system logs or controller status for tuning completion.

Configure Raman tuning parameters manually

Manually configure Raman tuning parameters to troubleshoot network issues or fine-tune system performance.

  • Disable automatic Raman tuning.

  • Set Raman gain, pump power, and DFB VOA attenuation values.

When Raman tuning is disabled, the system does not automatically calculate or adjust tuning parameters. You must manually configure the required values before initiating Raman tuning.

Use this task when you need full control over Raman tuning behavior. Common use cases include troubleshooting and performance optimization.

Before you begin

The OTS controller must be available and operational.

Follow these steps to manually configure Raman tuning parameters.

Procedure

1.

Enter optical line control configuration mode and select the OTS controller.

Example:


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

Disable Raman tuning.

Disabling Raman tuning allows you to manually configure tuning parameters.

Example:


RP/0/RP0/CPU0:ios(config-olc-ots)# raman-tuning disable
3.

Configure the Raman tuning parameters.

Set the target gain, pump power, and DFB VOA attenuation values.

Example:


RP/0/RP0/CPU0:ios(config-olc-ots)# raman-tuning raman-gain-target 180
RP/0/RP0/CPU0:ios(config-olc-ots)# raman-tx-power 1 value 21100
RP/0/RP0/CPU0:ios(config-olc)# controller DFB 0/0/0/0
RP/0/RP0/CPU0:ios(config-Dfb)# tx-voa-attenuation 100
4.

Commit the configuration and exit configuration mode.

Example:


RP/0/RP0/CPU0:ios(config-olc-ots)# commit
RP/0/RP0/CPU0:ios(config-olc-ots)# exit
RP/0/RP0/CPU0:ios(config-olc)# exit
5.

Start Raman tuning manually.

This step is required when Raman tuning is disabled or configured in manual mode.

Example:


RP/0/RP0/CPU0:ios# olc start-raman-tuning controller ots 0/0/0/0

Raman tuning runs using the manually configured parameters.

What to do next

  • Verify the Raman tuning status to confirm successful tuning.

  • Check the controller status for a TUNED state.