Configure Optical Modules

Clear the card configurations

Clear existing card and controller settings before you replace a configured optical module with a different module type in the same slot.

Before installing a new, different type of optical module, clear the configurations of the old module. A Cisco NCS 1001 slot configuration can include card configuration, OTS controller configuration, and optics controller configuration for EDFA cards.

Procedure


Step 1

Clear the configuration in the previous card.

no hw-module location 0/RP0/CPU0 slot slot-number

Step 2

Clear the configuration for each OTS controller.

no controller ots rack/slot/instance/port

Step 3

If the previous card was an EDFA card, clear each optics controller configuration.

no controller optics rack/slot/instance/port


After clearing the old card configuration, the slot is ready for the replacement optical module.

Optical amplifier module

The optical amplifier module (NCS1K-EDFA) is an NCS 1001 optical module that provides preamplifier and booster amplification for line-system deployments.

  • Preamplifier (LINE-RX to COM-TX): Provides a single preamplifier variant with switchable gain ranges according to link loss.

    • Range 1 provides 0 to 24 dB gain, and tilt control provides 24 to 27 dB gain with uncontrolled tilt.

    • Range 2 provides 20 to 34 dB gain, and tilt control provides 34 to 37 dB gain with uncontrolled tilt.

    • The COM-TX port provides 23 dBm output power.

  • Booster amplifier (COM-RX to LINE-TX): Provides true variable gain booster amplification.

    • The booster amplifier supports gain range 1 to 20. Gain range 20 to 25 has uncontrolled tilt.

    • The LINE-TX port provides 23 dBm output power.

  • The add or drop OSC channel supports both 1510 nm and 1610 nm wavelengths with a tolerance of +/-10 nm.

  • The OCM assesses channel presence, gain regulation, and per-channel power monitoring.

Feature history

Table 1. Feature history

Feature name

Release information

Feature description

Amplifier behavior

Cisco IOS XR Release 7.3.1

Grid mode configuration for the optical amplifier supports 75GHz spaced channels.

You can optimize the optical spectrum and granularity using gridless configuration. You can provision channels with arbitrary channel frequencies and channel widths. Up to 96 channels can be configured using gridless configuration.

Modified commands include:

  • hw-module

  • show controllers

EDFA front view

Figure 1. EDFA front view

EDFA front view

Table 2. EDFA front view callouts

1

XFP for OSC and additional OTDR feature

2

SFP for OSC (Optical Service Channel)

3

Status LED

4

Service channel input and output ports [OSC – RX, TX]

5

PRE and BST amplifier input and output ports

[L (LINE) – RX, TX]

[C (COM) – RX, TX]

[COM – CHECK]

Controller and optical port mappings

This table describes the mapping of controllers and optical ports for the optical amplifier module.

Table 3. Controller and optical port mappings

Controller

Optical ports

Ots 0/slot/0/0

  • COM-RX (booster input)

  • COM-TX (preamplifier output)

Ots 0/slot/0/1

  • LINE-RX (preamplifier input)

  • LINE-TX (booster output)

Ots 0/slot/0/2

  • OSC-RX

  • OSC-TX

Ots 0/slot/0/3

COM-CHECK

COM-CHECK configuration

The COM-CHECK configuration supports safety behavior for high-power preamplifier deployments.

  • Safety measures protect the fiber intranode between the preamplifier and the mux or demux section when the total output power on the COM-TX port is up to 23 dB. These measures compensate for extremely long spans.

  • If the output power on COM-TX is less than or equal to 20 dB, the COM-CHECK port can be turned off and does not require a physical connection between the pre COM-CHECK and demux monitor port.

  • In some cases, such as spans with high power requirements, safety on the preamplifier is necessary.

  • The COM-CHECK PD9 is the safety port.

  • The COM-RX controller, such as Ots 0/s/0/0, is not part of safety.

  • The safety restart process is similar to the booster case, with some difference in the APR Check phase.

Amplifier configuration

NCS 1001 supports manual and automatic methods to control optical amplifier settings.

NCS 1001 supports two methods to control amplifiers:

  • Manual—the user controls all the amplifier settings.

  • Automatic—the internal amplifier power regulator controls all the amplifier settings.

UDC port configuration

UDC port configuration uses these slot associations and traffic-handling rules.

  • There are three UDC RJ-45 ports on the faceplate of NCS 1001. UDC1 is associated with slot 1, UDC2 is associated with slot 2, and UDC3 is associated with slot 3.

  • UDC ports are Gigabit Ethernet ports that carry any Ethernet traffic.

  • UDC traffic is added and dropped through OSC filters in the NCS1K-EDFA optical amplifier module.

  • NCS 1001 tags and untags UDC traffic based on the configured UDC VLAN.

  • The system supports tagged, multiple-tagged, and untagged traffic.

  • Full utilization is not available, because four bytes of tag data are added to each packet.

These diagrams describe the application of UDC that can be used by EPNM to manage NCS 1000 series at the remote site.

Figure 2. UDC application for remote management - scenario one
UDC application for remote management
Figure 3. UDC application for remote management - scenario two
UDC application for remote management

Configure an amplifier module

Configure the amplifier module slot, node type, grid mode, and UDC VLAN settings.

For details about amplifier module configuration parameters, see Amplifier module configuration parameters.

Procedure


Use this command to configure the amplifier module.

hw-module location 0/RP0/CPU0 slot slot-number ampli node-type value grid-mode value udc-vlan value

Example:

In this sample, the amplifier module is inserted in slot 3 and udc-vlan is set to 4000.


configure
      hw-module location 0/RP0/CPU0 slot 3 ampli
         [
             grid-mode 100GHz
             udc-vlan 4000
         ]
commit
end

The configuration is committed and the optical module uses the requested settings.

Amplifier module configuration parameters

Use this reference to choose values for the amplifier module configuration command.

This table provides information about the supported configuration parameters for the amplifier module.

Table 4. Amplifier module configuration parameters

Parameter

Description

Range or values

Default

grid-mode

Defines the optical spectrum on the interfaces of the amplifier module.

  • 100 GHz—Configures the amplifier with 100GHz grid channels and 48-channel spacing.

  • 50 GHz—Configures the amplifier with 50GHz grid channels and 96-channel spacing.

  • 75 GHz—Configures the amplifier with 75GHz grid channels and 64-channel spacing.

    Note

     

    The NCS1K-MD-64-C optical passive multiplexer and demultiplexer module, introduced in Release 7.3.1, allows you to configure the amplifier with 75GHz grid channels.

  • gridless—Configures the amplifier in flex spectrum mode.

50GHz

node-type

Defines the type of node in which the amplifier operates.

TERM, ILA

TERM

udc-vlan

Defines the VLAN associated with the selected slot and its UDC port.

2 to 4080

Configure flex channels on the amplifier module

You can optimize the optical spectrum and granularity using the gridless configuration. In gridless configuration, the fixed ITU-T grid that defines specific channel frequencies and channel widths is not considered. You can provision channels with arbitrary channel frequencies and channel widths. You can configure up to 96 channels using the gridless configuration.

Table 5. Flex channel configuration parameters

Parameter

Description

Range

flex-chan-id

Defines the channel identifier.

1 to 96

chan-central-freq

Defines the central frequency of the channel.

191350 to 196100 in multiples of 125

chan-width

Defines the width of the channel.

500 (50.0 GHz) to 8000 (800.0 GHz) in multiples of 12.5 GHz

Procedure


Step 1

Use these commands to configure flex channels on the amplifier module.

Example:


configure
hw-module location 0/RP0/CPU0 slot 2 ampli flex-mode
hw-module location 0/RP0/CPU0 slot 2 ampli grid-mode gridless
hw-module location 0/RP0/CPU0 slot 2 ampli flex-channel-id 5 chan-central-freq 1931750 chan-width 6500
commit
end

Step 2

Use the show controllers ots-och summary command to verify the configured flex channel summary.

Example:

show controllers ots-och 0/2/0/0/5 summary

Step 3

Use the show controllers ots-och command to verify the configured flex channel details.

Example:

show controllers ots-och 0/2/0/0/5

The configuration is committed and the optical module uses the requested settings.

In this sample, the amplifier module is configured in flex spectrum.


configure
      hw-module location 0/RP0/CPU0 slot 2 ampli flex-mode
      hw-module location 0/RP0/CPU0 slot 2 ampli grid-mode gridless
      hw-module location 0/RP0/CPU0 slot 2 ampli flex-channel-id 5 
      chan-central-freq 1931750 chan-width 6500
commit
end

This sample shows the configured channel with its frequency and width.

RP/0/RP0/CPU0#show controllers ots-och 0/2/0/0/5 summary

Fri Oct  9 10:43:44.002 CEST
       Port       	Type   Status   TX Power   RX Power   
                                  	  (dBm)      (dBm)    
      ----------------- -----   -------   ---------  ---------
      Ots-Och0_2_0_0_5    Com     N/A     -8.60       -8.90      
      TX psd     RX psd         Central         Channel Width
      (nW/MHz)   (nW/MHz)       Frequency(GHz)    (GHz)
      ---------  ------------   -------------    --------------   
        0.410       0.450         193175.0         650.0

RP/0/RP0/CPU0#show controllers ots-och 0/2/0/0/5


Fri Oct  9 10:46:33.046 CEST

 Controller State: Up

 Transport Admin State: Maintenance

 Port Type: Com

 Laser State: Unknown

 Optics Status::


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


         Alarm Statistics:
         -----------------
         LOW-RX-PWR = 0
         LOW-TX-PWR = 0
         RX-LOS-P = 0
         RX-LOC = 0
         AMPLI-GAIN-DEG-LOW = 0
         AMPLI-GAIN-DEG-HIGH = 0
         AUTO-LASER-SHUT = 0
         AUTO-POW-RED = 0
         AUTO-AMPLI-CTRL-DISABLED = 0
         AUTO-AMPLI-CFG-MISMATCH = 0
         SWITCH-TO-PROTECT = 0
         AUTO-AMPLI-CTRL-RUNNING = 0

         Parameter Statistics:
         ---------------------
         TX Power = -8.60 dBm
         RX Power = -8.90 dBm
         TX psd = 0.440 nW/MHz
         RX psd = 0.450 nW/MHz
         Channel Central Frequency = 193175.0 GHz
         Channel Width = 650.0 GHz

         Configured Parameters:
         ------------------------
         Rx Low Threshold = -25.0 dBm
         Tx Low Threshold = -25.0 dBm

Modify central frequency and channel width on the amplifier module

You can change the central frequency, channel width, or both for a configured channel ID. The channel ID cannot be arbitrarily changed before unconfiguring the channel.

Procedure


Step 1

Change the central frequency of the configured channel.

Example:

hw-module location 0/RP0/CPU0 slot 1 ampli flex-channel-id 24 
          chan-central-freq 1949000 chan-width 500

Step 2

Change the channel width of the same channel.

Example:

hw-module location 0/RP0/CPU0 slot 1 ampli flex-channel-id 24 
          chan-central-freq 1949000 chan-width 1500

Step 3

Change both the central frequency and channel width of the channel.

Example:

hw-module location 0/RP0/CPU0 slot 1 ampli flex-channel-id 24 
          chan-central-freq 1932625 chan-width 6125

The configuration is committed and the optical module uses the requested settings.

In-line amplifier

The optical amplifier module (NCS1K-EDFA) can be configured in In-line amplifier (ILA) mode. ILA mode is used when it is not possible to connect to terminal nodes with a single span. ILA mode is supported only in slots 1 and 3.

ILA mode supports only the operation of pre-amplifier in both directions. The booster module is switched off in ILA mode. ILA mode supports gain range 1 and 2 of the pre-amplifier and provides 23 dBm output power pre-amplification.

In ILA mode, the LINE-RX and COM-TX ports of the optical amplifier module are enabled, while the LINE-TX and COM-RX ports are disabled. The OCM reports the values for LINE-RX and COM-TX ports, and the values for LINE-TX and COM-RX ports are set to –40.00 dBm. In ILA mode, the LINE-RX port terminates on the optical amplifier module's LINE-RX, and the LINE-TX port terminates on the external OSC module (15216-FLD-OSC=).

Configure an amplifier module in ILA manual mode

When the amplifier is set to ILA, all the configurations are performed only on the pre-amplifier. After the node is set to ILA, the amplifier gain, RX-low threshold, and the amplifier tilt can be configured on the pre-amplifier.

Procedure


Use these commands to configure the required settings.

configure hw-module location 0/RP0/CPU0 slot slot-number ampli node-type value commit end controller controllertype Rack/Slot/Instance/Port ampli-control-mode {automatic | manual} ampli-gain value rx-low-threshold value ampli-tilt value commit end

Example:

In this sample, the amplifier module is configured in ILA manual mode. The node type is set to ILA. This parameter switches off the booster side and activate safety between slots 1 and 3.


configure
            hw-module location 0/RP0/CPU0 slot 3 ampli node-type iLA
            commit
            end
            controller ots 0/3/0/0
            ampli-control-mode manual
            ampli-gain 200
            rx-low-threshold -300
            ampli-tilt -10
            commit
end

The configuration is committed and the optical module uses the requested settings.

Configure an amplifier module in ILA automatic mode

The configurations performed on the amplifier module in ILA automatic mode are similar to the configurations performed on the terminal node. The configurations are performed only on the pre-amplifier as the booster is switched off in ILA mode.

Procedure


Use these commands to configure the required settings.

configure hw-module location 0/RP0/CPU0 slot slot-number ampli grid-mode value node-type value commit end controller controllertype Rack/Slot/Instance/Port ampli-control-mode {automatic | manual} ampli-channel-power value ampli-tilt value rx-low-threshold value channel-power-max-delta value ampli-gain value ampli-gain-range {normal | extended} commit end

Example:

In this sample, the amplifier module is configured in ILA automatic mode.

configure
            hw-module location 0/RP0/CPU0 slot 3 ampli
            grid-mode 50GHz
            node-type iLA
            commit
            end
            controller ots 0/3/0/0
            ampli-control-mode automatic
            ampli-channel-power 30
            ampli-tilt -10
            rx-low-threshold -331
            ampli-gain 220
            ampli-gain-range extended
            commit
      end

This is a sample of show running-config command.


line console
      exec-timeout 0 0
      !
      line default
      exec-timeout 0 0
      session-timeout 0
      !
      ntp
      server 10.58.228.1
      update-calendar
      !
      hw-module location 0/RP0/CPU0 slot 1
      ampli udc-vlan 11
      ampli grid-mode 50GHz
      ampli node-type ILA
      !
      hw-module location 0/RP0/CPU0 slot 3
      ampli udc-vlan 10
      ampli grid-mode 50GHz
      ampli node-type ILA
      !
      interface MgmtEth0/RP0/CPU0/0
      ipv4 address 10.58.229.143 255.255.252.0
      !
      interface MgmtEth0/RP0/OSC1/0
      shutdown
      !
      interface MgmtEth0/RP0/OSC2/0
      shutdown
      !
      interface MgmtEth0/RP0/OSC3/0
      shutdown
      !
      controller Ots0/1/0/0
      ampli-tilt -12
      ampli-control-mode automatic
      ampli-channel-power 22
      channel-power-max-delta 45
      !
      controller Ots0/1/0/1
      rx-low-threshold -250
      !
      controller Ots0/3/0/0
      ampli-tilt -12
      ampli-control-mode automatic
      ampli-channel-power 22
      channel-power-max-delta 45
      !
      controller Ots0/3/0/1
      rx-low-threshold -250
      !
      router static
      address-family ipv4 unicast
        0.0.0.0/0 10.58.228.1
      !
      !
      netconf-yang agent
      ssh
      !
      ssh server v2
      end

The configuration is committed and the optical module uses the requested settings.

Gridless OCM support

The Gridless OCM (Optical Channel Monitor) support feature enables transponders to use channel widths between 50 GHz and 100 GHz. In R7.1.1, the channel width can be set between 50 GHz to 800 GHz in increments of 25 GHz. In the gridless mode, the amplifier gain is calculated using the power spectral density parameter and not the per channel power parameter. The flex grid enables support for the 600G interface on NCS 1004

Limitation

The setting of a channel width disables the nearest channels.

Configure the channel width

The channel width can be set from 1000 GHz to 8000 GHz.

This command configures the channel width as 100 GHz. This means that the channels are spaced on eight slices at 12.5 GHz each.

hw-module location 0/RP0/CPU0 slot 1 ampli flex-mode
      channel-id 1 channel-width 1000

This command configures the channel width as 800 GHz. This means that the channels are spaced on eight slices at 100 GHz each.

hw-module location 0/RP0/CPU0 slot 1 ampli flex-mode
      channel-id 10 channel-width 8000

Enable automated OTS-OCH thresholds on an amplifier

You can enable or disable automated OTS-OCH thresholds on each EDFA card installed on the node. This setting applies to the EDFA OTS controllers and all related OTS-OCH controller ports.

Before you begin

This feature works only if the user has configured span loss calculation. See Span loss calculation.

When the automatic threshold function is enabled on the amplifier, the threshold value to set is determined using this formula:

rx-low-threshold= (Remote AmplChannel - RXSpanloss )-User Threshold Offset.

Where

Remote AmplChannel is the amplifier channel power set on the remote node for ots controller tx port of remote EDFA.

RXSpanloss is the RX Span Loss calculated on the local node.

User Threshold Offset is the ampli-auto-rxlow-threshold threshold-offset set on the local node for EDFA in slot 1.

Modifying any of the parameters in the formula does not automatically recalculate the rx-low threshold value. To update the rx-low threshold value, you must execute this CLI command:

hw-module slot<n>ampli-auto-rxlow-threshold threshold-offset <value>

Example: hw-module slot 1ampli-auto-rxlow-threshold threshold-offset 400

These parameters are used to configure the command:

  • <n> (1, 2, 3) : This parameter designates the specific slot where the EDFA card is installed within the device.

  • <value> (0-800) : This parameter specifies the adjustment to the amplifier RX-LOW threshold, given in tenths of dBm.

Procedure


Step 1

Configure the required settings.

Example:

hw-module location 0/RP0/CPU0 slot slot number ampli auto-threshold

Step 2

Use the show running hw-module command to verify that automatic thresholds are enabled.

Example:

show running hw-module location 0/RP0/CPU0 slot 1 ampli

The configuration is committed and the optical module uses the requested settings.

This sample enables autothreshold on an EDFA inserted in slot 1.


RP/0/RP0/CPU0:MYS-237#configure terminal 
RP/0/RP0/CPU0:MYS-237(config)#hw-module location 0/RP0/CPU0 slot 1 ampli auto-threshold 
RP/0/RP0/CPU0:MYS-237(config)#commit
RP/0/RP0/CPU0:MYS-237(config)#end

This sample checks whether the auto-threshold is configured.

#show running hw-module location 0/RP0/CPU0 slot 1 ampli
      ….
       ampli span-loss
       ampli node-type TERM
       ampli remote-node local-ipv4 10.58.xxx.xxx remote-ipv4 10.58.xxx.xxx remote-slot-id 3
       ampli auto-threshold

Protection switching module

The protection switching module (NCS1K-PSM) is an NCS 1001 optical module that switches traffic between working and protected optical paths.

  • TX section functions include these behaviors:

    • Splits input optical channels to both working and protection lines.

    • Forces the switch at the remote site by opening one of the two line paths. This is achieved by placing the related variable optical attenuator into automatic VOA shutdown.

  • RX section functions include these behaviors:

    • Selects signals from the working or protection line, and monitors each line through a photodiode.

    • Balances the two line losses by changing the variable optical attenuator attenuation value when the switch changes state.

PSM front view

Figure 4. PSM front view

PSM front view

Table 6. PSM front view callouts

1

Protected path input and output port [P - RX, TX]

2

Working path input and output port [W - RX, TX]

3

COM input and output port [COM - RX, TX]

4

Status LED

Controller and optical port mappings

This table describes the mapping of controllers and optical ports for the protection switching module.

Table 7. Controller and optical port mappings

Controller

Optical ports

Ots 0/slot/0/0

COM-TX

Ots 0/slot/0/1

Working path input and output port [W - RX, TX]

Ots 0/slot/0/2

Protected path input and output port [P - RX, TX]

Configure a protection switching module

Configure the PSM slot with the protection behavior required for the working or protected path.

For details about supported PSM parameters, see PSM module configuration parameters. For details about PSM section and path protection topologies, see PSM section and path protection.

Procedure


Step 1

Enter configuration mode.

Example:

configure terminal

Step 2

Use the hw-module location command to configure the required PSM parameter on the selected slot.

Example:

hw-module location 0/RP0/CPU0 slot 2 psm lockout-from "working"

Step 3

Commit the configuration.

Example:

commit

The PSM configuration is committed for the selected slot.

What to do next

For details about manual switching, see Switch a PSM path manually. For details about manual threshold values, see PSM manual threshold guidelines.

PSM module configuration parameters

Use this reference to choose the PSM parameter for the required protection switching behavior.

This table provides information about the PSM configuration parameters.

Table 8. PSM module configuration parameters

Parameter

Description

Values

lockout-from

Excludes the selected port from protection.

Triggers a switch when the active port is specified in the lockout.

For example, configuring lockout-from working triggers a switch to protect when the working port is active.

Configuring lockout-from protected triggers a switch to working when the protected port is active.

Working, Protected

path-protection

Enables PSM path protection.

section-protection

Enables PSM section protection.

uni-dir

Enables PSM unidirectional switching.

auto-threshold

Enables the PSM automatic threshold setting.

Switch a PSM path manually

Apply a manual switch command to move traffic to the working or protected PSM path.

A user-command switch from the path without the ILA node is bidirectional. If the ILA and terminal nodes are in section protection, manual and lockout switch commands from the path with the ILA node are unidirectional.


Note


An FPD upgrade on FW_PSMv1 from FW 1.43 and FW 1.44 to FW 1.45 affects traffic.


Procedure


Use the hw-module command to switch the selected PSM slot to the working or protected path.

hw-module slot slot-number manual-switch-to working | protected


The selected PSM slot switches traffic to the requested path.

PSM section and path protection

PSM section and path protection are protection schemes that use PSM parameters on paired modules to control working and protected optical paths.

Section protection topology

Figure 5. Section protection topology
Section protection topology

Section protection topology is available from Release 6.2.1. You can set the section protection parameter on both PSMs. Insert the PSM in slot 2 for a section protection topology. Connect the EDFA in slot 1 to the protected port on the PSM. Connect the EDFA in slot 3 to the working port of the PSM.


Note


To measure the correct switching time when testing section protection, wait 120 seconds between any two switching events or between a switching event and restoration. This waiting period allows the EDFAs to stabilize after the first switch. It also prevents power at the PSM from oscillating around the threshold.


Path protection topology

Figure 6. Path protection topology
Path protection topology

Path protection topology is available from Release 6.3.2. You can set the path protection parameter on both the PSMs.

PSM manual threshold guidelines

Use this reference to choose manual RX-low threshold values for PSM path protection and three-way topology deployments.

The switch operates in all conditions when autothreshold is enabled. When path protection is configured with a manual threshold, use these guidelines:

  • During the first installation, set the PSM RX-low threshold three dB less than the minimum power for a single channel. The value must allow the PSM to switch on with a single channel or when the EDFA is in APR (+8 dBm).

  • When the system is running with the final number of channels, set the PSM RX-low threshold three dB less than the target power.

  • After a fiber cut and restore, set the PSM RX-low threshold to a value similar to the value used during the first installation so the PSM can switch on.

PSM autothreshold configuration is highly recommended for a three-way topology.

In a three-way topology, incorrect manual threshold configuration can cause these issues:

  • The switch may not be bidirectional.

  • A double switch can occur on PSM path protection when it is set in three-way configuration.

You can configure parameters such as rx-enable and tx-enable in OTS controllers 1 or 2. These controllers represent the working or protected port of the PSM card.

For details about OTS controllers, see Configure an OTS controller.

PSM autothreshold behavior

Use this reference to understand how PSM autothreshold changes current RX-low thresholds for working and protected RX ports.

PSM threshold behavior depends on whether autothreshold is enabled.

  • When autothreshold is not enabled, the active RX-low threshold value on PSM working and protected RX ports is either the value configured by the user or the default value.

  • The current threshold equals the configured value if the configured values are available in the show controller command output.

  • The current threshold is –38 dBm when the user has not configured a value for the threshold parameters.

When autothreshold is enabled on the PSM card, the RX-low threshold values configured by the user for ports 1 and 2 are ignored.

  • If optical power at the Working-RX and Protected-RX ports remains within ±1 dB for two minutes, the related RX-low threshold automatically becomes the RX power minus three dB.

  • If power is not stable, the related thresholds do not change.

  • W-RX and P-RX thresholds are regulated independently.

LOS-P alarm behavior changes how autothreshold maintains or restores RX-low threshold values.

  • When a LOS-P alarm is detected on the working or protected RX port with autothreshold enabled, the related threshold remains the same. This behavior occurs when RX power is less than the related threshold on the working or protected RX port.

  • When the LOS-P alarm clears within the first 30 seconds, the autothreshold mechanism applies. After two minutes of stable RX power, the RX-low threshold becomes the new RX power minus three dB.

  • When LOS-P is present after 30 seconds, the RX-low threshold automatically moves to the values configured by the user.

  • When LOS-P clears, the ordinary autothreshold mechanism is applied again if RX power is higher than the related current threshold.

Configure rx-low threshold for PSM

Configure the rx-low-threshold before you enable auto-threshold on PSM ports.

The PSM auto-threshold feature monitors the W-RX and P-RX ports of the PSM module for actual received power. When the received power is stable, the feature sets the rx-low-threshold value of the W-RX and P-RX ports to the current power value. The threshold is then set to three dB lower than the received power. If a loss of signal (LOS) occurs at the W-RX or P-RX ports due to a fiber cut or a temporary power disruption, the feature restores the rx-low-threshold value to the configured value.

RP/0/RP0/CPU0:ios#show controllers ots 0/2/0/1
      Parameter Statistics:
      -----------------------
               RX Power = -4.00 dBm
               Rx Low Threshold Current = -7.0 dBm   <<< current value (auto-threshold)

      Configured Parameters:
      -----------------------
               Rx Low Threshold = -38.0 dBm <<< configured value (user configured)

We recommend configuring both the rx-low-threshold and auto-threshold values of the PSM module according to these guidelines:

Procedure


Step 1

Configure the working rx-low threshold in manual mode. For details about the working rx-low threshold in manual mode, see Configure the working RX-low threshold in manual mode.

Step 2

Configure the protected rx-low threshold in manual mode. For details about the protected rx-low threshold in manual mode, see Configure the protected RX-low threshold in manual mode.

Step 3

Configure the working rx-low threshold in automatic mode. For details about the working rx-low threshold in automatic mode, see Configure the working RX-low threshold in automatic mode.

Step 4

Configure the protected rx-low threshold in automatic mode. For details about the protected rx-low threshold in automatic mode, see Configure the protected RX-low threshold in automatic mode.


The selected PSM port has an RX-low threshold that matches the amplifier control mode and observed power values.

Configure the working rx-low-threshold in manual mode

Configure the rx-low-threshold for the selected PSM port using the value required by the amplifier control mode.

Procedure


Step 1

Use the show hw-module slot 3 channel-trail-view active command and identify the required power value.

Example:

Channel Trail View - Active - dBm
          ===========================================
                                                                        BST: 0/COM=>1/LINE              PRE: 1/LINE=>0/COM
          Och Name       Wavelength(nm)Freq(GHz) Width(GHz)Rx pwr(dBm) Tx pwr(dBm) Rx pwr(dBm)  Tx pwr(dBm)
          ------------------------------------------------------------------------------------------------------------------------
          Ots-Och0_2_0_0_1  1528.77    196100.0    50.0     -6.10       -4.90       -2.50         6.20
          Ots-Och0_2_0_0_2  1529.16    196050.0    50.0     -5.90       -4.60       -2.20         6.50
          Ots-Och0_2_0_0_3  1529.55    196000.0    50.0     -6.00       -4.80       -2.30         6.30
          Ots-Och0_2_0_0_4  1529.94    195950.0    50.0     -6.10       -4.90       -2.40         6.20
          Ots-Och0_2_0_0_5  1530.33    195900.0    50.0     -6.30       -5.20       -2.60         6.00
          Ots-Och0_2_0_0_6  1530.72    195850.0    50.0     -6.50       -5.30       -2.80         5.90

Examine the PRE: 1/LINE=>0/COM column in the command output and choose the lowest channel Tx pwr value from all the active channels.

Step 2

Enter the configuration mode.

Example:

configure

Step 3

Use the controller ots command to configure the rx-low threshold value.

Example:

controller ots 0/2/0/1 rx-low-threshold 49

Set the threshold value manually to the lowest channel Tx power minus 1 dBm. In this example, channel Ots-Och0_2_0_0_6 is at the lowest Tx power 5.90 dBm. Therefore, the threshold value on the PSM W/RX port is 5.90 minus 1, which equals 4.90 dBm.

If the system works without any grid mode configuration, the channel-trail-view command is not available because channel mapping configuration is not available.

To identify the lowest channel Tx pwr value, use this show command.

show controllers ots0/3/0/0 spectrum-info

Tx power :
       ----------------------------------------------------------------------------------
       spectrum-slice num                        Tx-power values (dBm)
       ----------------------------------------------------------------------------------
         1 - 8               -47.20 -47.20 -47.20 -36.40     -47.20 -47.20 -47.20 -47.20
         9 - 16              -47.20 -47.20 -43.70 -43.70     -47.20 -36.60 -47.20 -43.20
        17 - 24              -47.20 -35.80 -47.20 -47.10     -41.90 -43.20 -42.20 -40.30
        25 - 32              -40.30 -47.20 -41.70 -41.70     -37.50 -47.20 -47.20 -41.90
        33 - 40              -41.90 -47.20 -45.90 -42.10     -42.10 -46.30 -41.60 -39.10
        41 - 48              -41.20 -47.20 -35.80 -45.10     -45.30 -45.30 -40.10 -40.10
        49 - 56              -45.50 -42.60 -45.30 -47.20     -47.20 -40.50 -47.20 -45.80
        57 - 64              -38.60 -40.30 -40.30 -47.20     -47.20 -39.40 -43.10 -43.10
        65 - 72              -42.20 -42.20 -47.20 -47.20     -38.80 -47.20 -47.20 -41.30
        73 - 80              -47.20 -43.00 -40.10 -40.10     -47.20 -36.10 -39.40 -45.70
        81 - 88              -47.20 -41.50 -39.00 -42.50     -47.20 -47.20 -34.30 -47.20
        89 - 96              -47.20 -47.20 -39.90 -39.70     -47.20 -47.20 -47.20 -47.20
        97 - 104             -47.20 -45.10 -39.90 -41.30     -47.20 -39.80 -37.80 -42.00

All the slice power values are expressed in PSD (Power Spectral Density) units of measure [dBm/12.5GHz]. Each slice value is converted to linear mW using the formula 10^(N/10). For example, -20 dBm is equal to 0.01 mW(calculated as 10^(-20/10)), and 0 dBm is equal to 1 mW (calculated as 10^0).

Each slice group that composes a channel is algebraically added to obtain the integral channel power. For example, the first channel of 50 GHz occupies the slice range 1 to 4, and the second channel occupies 5 to 8. The first channel of 75 GHz occupies the slice range 1 to 5 and 6 to 11. The first channel of 100 GHz occupies the slice range 1 to 6 and 7 to 14.

Each channel power that falls below the rx-low-threshold value is excluded from the list of active channels. The channel that has the least value above the rx-low-threshold value is chosen.


Configure the protected rx-low-threshold in manual mode

Configure the rx-low-threshold for the selected PSM port using the value required by the amplifier control mode.

Procedure


Step 1

Use the show hw-module slot 1 channel-trail-view active command and identify the required power value.

Example:

Channel Trail View - Active - dBm
          ===========================================
                                                                        BST: 0/COM=>1/LINE              PRE: 1/LINE=>0/COM
          Och Name      Wavelength(nm)Freq(GHz) Width(GHz)Rx pwr(dBm) Tx pwr(dBm)  Rx pwr(dBm)  Tx pwr(dBm)
          ------------------------------------------------------------------------------------------------------------------------
          Ots-Och0_2_0_0_1 1528.77    196100.0    50.0     -6.10       -4.90        -2.50         5.00
          Ots-Och0_2_0_0_2 1529.16    196050.0    50.0     -5.90       -4.60        -2.20         5.20
          Ots-Och0_2_0_0_3 1529.55    196000.0    50.0     -6.00       -4.80        -2.30         5.10
          Ots-Och0_2_0_0_4 1529.94    195950.0    50.0     -6.10       -4.90        -2.40         5.00
          Ots-Och0_2_0_0_5 1530.33    195900.0    50.0     -6.30       -5.20        -2.60         5.00
          Ots-Och0_2_0_0_6 1530.72    195850.0    50.0     -6.50       -5.30        -2.80         4.80

Examine the PRE: 1/LINE=>0/COM column in the command output and choose the lowest channel Tx pwr value from all the active channels.

Step 2

Enter configuration mode.

Example:

configure

Step 3

Use the controller ots command to configure the RX-low threshold value.

Example:

controller ots 0/2/0/2 rx-low-threshold 38

Set the threshold value manually to the lowest channel Tx power minus 1 dBm. In this example, channel Ots-Och0_2_0_0_6 is at the lowest Tx power 4.80 dBm. Therefore, the threshold value on the PSM W/RX port is 4.80 minus 1, which equals 3.80 dBm.


Configure the working rx-low-threshold in automatic mode

Configure the rx-low-threshold for the selected PSM port using the value required by the amplifier control mode.

Procedure


Step 1

Use the show controllers ots 0/3/0/0 command and identify the required power value.

Example:

Configured Parameters:

          -------------------------
                   Ampli Channel power = 0.00 dBm

Examine the ampli-channel-power Tx value in the command output.

Step 2

Enter configuration mode.

Example:

configure

Step 3

Use the controller ots command to configure the rx-low-threshold value.

Example:

controller ots 0/2/0/1 rx-low-threshold -10

Set the threshold value manually to ampli-channel-power minus 1 dBm. In this example, ampli-channel-power Tx value is 0 dBm. Therefore, the threshold value on the PSM W/RX port is 0 minus 1, which equals -1 dBm.


Configure the protected rx-low-threshold in automatic mode

Set the rx-low-threshold for the selected PSM port using the value required by the amplifier control mode.

Procedure


Step 1

Use the show controllers ots 0/1/0/0 command and identify the required power value.

Example:

Configured Parameters:

          -------------------------
                   Ampli Channel power = 2.00 dBm

Examine the ampli-channel-power Tx value in the command output.

Step 2

Enter configuration mode.

Example:

configure

Step 3

Use the controller ots command to configure the rx-low-threshold value.

Example:

controller ots 0/2/0/2 rx-low-threshold 10

Set the threshold value manually to ampli-channel-power minus 1 dBm. In this example, ampli-channel-power Tx value is 2 dBm. Therefore, the threshold value on the PSM W/RX port is 2 minus 1, which equals 1 dBm.


Enable autothreshold for PSM

Before you begin

Configure rx-low-threshold for PSM

Procedure


Use the hw-module location command to enable autothreshold for PSM.

Example:


configure
hw-module location 0/RP0/CPU0 slot 1 psm auto-threshold
commit
end

The configuration is committed and the optical module uses the requested settings.

Configure a relative switch threshold for PSM

A relative switch threshold lets you configure the delta threshold on PSM that triggers the working path to switch to the protected path. You can configure this threshold only if auto-threshold or revertive wtr are not configured.

Procedure


Use the hw-module location command to configure a relative switch threshold for PSM.

Example:


configure terminal
hw-module location 0/RP0/CPU0 slot 1 psm relative-switch-threshold 120 relative-switch-threshold-offset -150
commit
end

The configuration is committed and the optical module uses the requested settings.

PSM virtual photodiode

The PSM virtual photodiode provides an optical power reading even when photodiodes are not available. The PSM does not have a photodiode on the COM-RX port. Two photodiodes are present on the Working-TX port and the Protected-TX port, located after the VOA

Details

The power value on COM-RX is real if at least one of the W-TX or P-TX power values is not equal to -40 dB (the related port is in AVS).

If both the power of W-TX and P-TX equal -40 dB (both related VOAs are in AVS-Automatic VOA Shutdown), it is impossible to calculate the real power on the COM-RX port, so the value is displayed as -40 dB.

The feature does not require any configuration. Only the show controllers ots 0/<slot>/0/0 command is changed to display the RX power on the COM-RX port. The RX low power alarm is not managed on the COM-RX port.

Example for show controller


RP/0/RP0/CPU0:ios#show controllers ots 0/2/0/0 
Wed Jan 24 14:33:22.898 CET

 Controller State: Up 

 Transport Admin State: In Service 

 Port Type: Com 

 Laser State: Unknown 

 Optics Status:: 


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


 Alarm Statistics:
 -----------------
 LOW-RX-PWR = 0 
 LOW-TX-PWR = 0 
 RX-LOS-P = 0 
 RX-LOC = 0 
 AMPLI-GAIN-DEG-LOW = 0 
 AMPLI-GAIN-DEG-HIGH = 0 
 AUTO-LASER-SHUT = 0 
 AUTO-POW-RED = 0 
 AUTO-AMPLI-CTRL-DISABLED = 0 
 AUTO-AMPLI-CFG-MISMATCH = 0 
 SWITCH-TO-PROTECT = 0 
 AUTO-AMPLI-CTRL-RUNNING = 0 

 Parameter Statistics:
 ---------------------
 TX Power = 15.30 dBm 
 RX Power = 5.30 dBm 
 tx-enable = 1 
 rx-enable = 1 

 Configured Parameters:
 -------------
 tx-enable = 1 
 rx-enable = 1 

PSM three-way protection

NCS 1001 supports PSM three-way protection scheme formed by combining a section protection scheme with a path protection scheme. No configuration change is required in PSM to implement the three-way protection scheme. The path protection scheme is inserted into one of the two paths in the section protection scheme.

Topology

Use the PSM automatic threshold configuration for the outer section protection.

Figure 7. Three-way protection network topology

Limitations

The three-way protection scheme has these limitations:

  • For each PSM, switching the bi-directionality is not definite.

  • Manual switching used to change the active path is sometimes unsuccessful.

Apply the lockout configuration on all four PSMs of the protection scheme to control switching from one path to another. Apply the lockout configuration on both the local and the corresponding remote PSM to ensure bi-directionality.

PSM revertive switch

When a loss of signal (LOS) alarm occurs on the primary path because of a fiber cut, traffic moves from the primary path to the secondary path. The PSM revertive switch feature allows traffic to return to the primary path when the fiber cut is resolved and the LOS alarm is cleared. This switch back to the primary path is not immediate; it depends on several parameters.

Parameters of PSM revertive switch

  • WTR (Wait To Restore): WTR is the time delay, in seconds, introduced after the LOS alarm on the primary path is cleared. When the WTR timer elapses, traffic moves to the primary path.

  • Threshold hysteresis: The threshold hysteresis parameter prevents transient or fluctuating power readings near the threshold monitoring the primary RX port.

    If set, the threshold hysteresis parameter works with the WTR timer. After the fiber cut is fixed and the alarm is cleared, the system starts the WTR timer only when the power on the primary RX port is higher than the combined value of the rx-low-threshold and threshold hysteresis (rx-low-threshold-delta).


Note


The suggested values for WTR and threshold hysteresis parameters are 120 seconds and one dBm, respectively. You must choose both parameter values appropriately based on conditions, such as the power received, the type of PSM protection scheme, whether manual threshold values are provisioned on PSM, or if auto-threshold is enabled.


Limitations

  • PSM revertive switch feature is supported only on section protection or path protection schemes.

  • PSM revertive switch feature is not supported on PSM three-way protection scheme.

  • PSM revertive switch feature is not supported on section protection or path protection schemes involving one or more ILA nodes.

  • The PSM revertive switch feature is triggered only when traffic switches from the primary path to the secondary path because of a fiber cut. It does not activate if the switch occurs due to user commands, such as manual-to or lock-out-from.

Configure a PSM revertive switch

Procedure


Step 1

Use this command to configure PSM revertive switch.

hw-module location 0/RP0/CPU0 slot psm-slot-number psm revertive wtr wtr-value primary-path path

wtr-value must be an integer. The primary path is set to WORKING by default. The user can change this path from WORKING to PROTECTED but cannot delete it.

Example:


configure
hw-module location 0/RP0/CPU0 slot 2 psm
revertive wtr 120
primary-path WORKING
commit
end

Step 2

Use this command to configure the threshold hysteresis for the selected OTS controller.

controller rack/slot/instance/port rx-low-threshold-delta rx-low-threshold-delta-value

rx-low-threshold-delta is the threshold hysteresis. The value 10 is expressed in units of 0.1 dBm. In this example, the value of threshold hysteresis is set as 1.0 dBm.

Example:


configure terminal
controller 0/2/0/1 rx-low-threshold-delta 10
commit
end

Step 3

Use this command to verify the revertive switch and threshold hysteresis values.

show controllers ots rack/slot/instance/port

Example:

RP/0/RP0/CPU0:ios# show controllers ots 0/2/0/1
        Controller State: Up 

       Transport Admin State: In Service 

       Port Type: Working 

       Port Status: Standby 

       Laser State: Unknown 
       
       Optics Status:: 

               Alarm Status:
               -------------
               Detected Alarms: 
                       
               Alarm Statistics:
               -----------------
               LOW-RX-PWR = 0          
               LOW-TX-PWR = 0          
               RX-LOS-P = 735        
               RX-LOC = 0          
               AMPLI-GAIN-DEG-LOW = 0          
               AMPLI-GAIN-DEG-HIGH = 0          
               AUTO-LASER-SHUT = 0          
               AUTO-POW-RED = 0          
               AUTO-AMPLI-CTRL-DISABLED = 0          
               AUTO-AMPLI-CFG-MISMATCH = 0          
               SWITCH-TO-PROTECT = 4          
               AUTO-AMPLI-CTRL-RUNNING = 0          
                
               Parameter Statistics:
               ---------------------
               TX Power = -16.70 dBm 
               RX Power = -21.00 dBm 
               RX Voa Attenuation = 0.00 dB 
               TX Voa Attenuation = 0.00 dB 
               TX Enable = Enabled 
               RX Enable = Enabled 
               Rx Low Threshold Current = -38.0 dBm 
               Wait Time to Restore = 120 secs 
                
                
               Configured Parameters:
               -------------
               Rx Low Threshold = -38.0 dBm 
               RX Voa Attenuation = 0.0 dB 
               TX Voa Attenuation = 0.0 dB 
               TX Enable = Enabled 
               RX Enable = Enabled 
               Rx Low Threshold Delta = 1.0 dBm

The configuration is committed and the optical module uses the requested settings.

Optical service channel

The Optical Service Channel (OSC) is an out-of-band channel that is added to and removed from the optical amplifier module. OSC supports 1510 nm and 1610 nm wavelengths.

Details

OSC provides a communication channel for these types of traffic.

  • Traffic coming from a UDC port

  • Traffic for remote management of NCS 1001

Configure remote management

Configure remote management reachability between local and remote NCS 1001 nodes.

The Remote Management feature, introduced in R6.3.1, allows you to configure the IP addresses of local and remote nodes to enable remote management of NCS 1001.

Three OSC interfaces are configured to support remote management. They provide static routes to remote nodes. Each interface is statically associated with a slot: OSC1 with slot 1, OSC2 with slot 2, and OSC3 with slot 3.

Procedure


Step 1

Configure the management and OSC interfaces. For details about management and OSC interfaces, see Configure management and OSC interfaces.

Step 2

Configure static routes for remote node reachability. For details about static routes, see Configure static routes.


The NCS 1001 node has management reachability to remote nodes across the OSC links.

Configure management and OSC interfaces

Procedure


Use these commands to configure management and OSC interfaces.

interface mgmtEth rack/slot/instance/port

ipv4 address ipv4-address subnet-mask

These are samples of configuring the management and OSC interfaces.

Example:

configure
      interface MgmtEth 0/RP0/CPU0/0
      ipv4 address 10.58.227.198 255.255.255.0
      shutdown
      exit
configure
      interface MgmtEth 0/RP0/OSC1/0
      ipv4 address 10.1.1.1 255.255.255.0
      shutdown
      exit
configure
      interface MgmtEth 0/RP0/OSC2/0
      ipv4 address 10.1.2.1 255.255.255.0
      shutdown
      exit
configure
      interface MgmtEth 0/RP0/OSC3/0
      ipv4 address 10.1.3.1 255.255.255.0
      shutdown
      exit

Configure static routes

This procedure configures all the static routes into the NCS 1001 node.

Procedure


Use the router static address-family command to configure static routes.

router static address-family ipv4 unicast 0.0.0.0/0 default-gateway

This sample shows the NCS 1001 node connected to three different nodes using static routes.

Example:

configure
      router static address-family ipv4 unicast
      0.0.0.0/0 MgmtEth 0/RP0/CPU0/0 10.58.227.1
      10.1.1.0/24 MgmtEth 0/RP0/OSC1/0 10.1.1.2
      10.1.2.0/24 MgmtEth 0/RP0/OSC2/0 10.1.2.2
      10.1.3.0/24 MgmtEth 0/RP0/OSC3/0 10.1.3.2
      exit

Configure network topology discovery

Configure topology discovery for compatible NCS 1001 nodes connected through OSC links.

The network topology discovery feature enables discovery of NCS 1001 nodes that are connected to each other through OSC links, without the need to configure static routes. This feature is based on the OSPF protocol and is introduced in Release 6.3.2

You must configure OSPF on NCS 1001 nodes by defining the name, router ID, and interfaces in Area 0. You can optionally configure the interfaces as passive. OSPF and OSPFv3 protocols are supported.

These network topologies are supported:

  • Point-to-Point

  • Point-to-Point with ILA nodes (up to three ILA nodes)

Procedure


Step 1

Configure management and OSC interfaces. For details, see Configure management and OSC interfaces.

Step 2

Configure OSPF routes. For details, see Configure OSPF routes.

Step 3

Verify the OSPF routing table. For details, see Verify the OSPF routing table.


The NCS 1001 node can discover compatible nodes through OSPF over OSC links.

Configure OSPF routes

Procedure


Use these commands to configure OSPF routes.

router ospf process-id

router-id ip-address

area area-id

This is a sample of configuring OSPF routes.

Example:

configure
      interface MgmtEth0/RP0/CPU0/0
       ipv4 address 10.1.1.2 255.255.255.0
      !
      interface MgmtEth0/RP0/OSC1/0
       shutdown
      !
      interface MgmtEth0/RP0/OSC2/0
       ipv4 address 10.1.3.2 255.255.255.0
      !
      interface MgmtEth0/RP0/OSC3/0
       ipv4 address 10.1.4.2 255.255.255.0
      !
      router ospf remote
       router-id 10.1.1.2
       area 0
        interface MgmtEth0/RP0/CPU0/0
         passive enable
        !
        interface MgmtEth0/RP0/OSC2/0
        !
        interface MgmtEth0/RP0/OSC3/0
        !
       !
      !
      end

Verify the OSPF routing table

Procedure


Use the show ospf routes command to verify the OSPF routing table.

Example:

RP/0/RP0/CPU0:ios# show ospf routes 
Sat Jul 29 09:54:25.937 UTC

          Topology Table for ospf local with ID 10.1.4.1

          Codes: O - Intra area, O IA - Inter area
                 O E1 - External type 1, O E2 - External type 2
                 O N1 - NSSA external type 1, O N2 - NSSA external type 2

          O    10.1.1.0/24, metric 1
                 10.1.1.2, directly connected, via MgmtEth0/RP0/CPU0/0
          O    10.1.3.0/24, metric 1
                 10.1.3.2, directly connected, via MgmtEth0/RP0/OSC2/0
          O    10.1.7.0/24, metric 2
                 10.1.3.1, from 10.58.227.198, via MgmtEth0/RP0/OSC2/0
          O    10.58.227.0/24, metric 1
                 10.1.3.1, from 10.58.227.198, via MgmtEth0/RP0/OSC2/0

The command output shows whether the expected OSPF routes are present.

Network troubleshooting commands

Troubleshooting must be performed by checking the status of the interfaces, subnets, static routing, and OSPF sections.

Problem

Command

Interfaces are in down state.

show interfaces MgmtEth rack/slot/instance/port

Route to default gateway is not defined.

show running-config

The design phase included incorrect IP addresses or subnets.

show running-config

Static routes were defined incorrectly and overwrite OSPF routes.

Compare the output of show ip route command with the show ospf routes command

The OSPF configuration does not include all the interfaces.

show running-config

The OSPF configuration sets certain interfaces to passive mode.

show running-config

Troubleshoot UDC port configurations

Troubleshoot UDC port configurations by clearing statistics and checking port attributes, port state, VLAN lists, and port counters.

Table 9. Feature History

Feature Name

Release

Description

Troubleshooting User Data Channel (UDC) Port Configurations

Cisco IOS XR Release 7.8.1

The hw-module and show hw-module commands have been enhanced with additional keywords to improve the troubleshooting of issues on UDC ports. Apart from viewing the UDC port state, VLAN list, and port statistics, you can clear UDC port configurations and enable or disable configurations on each UDC port.

From Release 7.8.1, the hw-module eth-switch and show hw-module eth-switch commands provide options to troubleshoot UDC ports and view the current configuration.


Note


The hw-module eth-switch clear-stats command clears all the counters on the selected port and turns off the Clear-On-Read attribute. You can re-enable Clear-On-Read with the enable-clear-on-read attribute.


Procedure


Step 1

Clear the statistics configured for UDC port 1.

Example:


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module eth-switch clear-stats port Rj45Udc1
RP/0/RP0/CPU0:ios(config)#commit

Step 2

Clear the statistics configured for all the ports.

Example:


RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module eth-switch clear-stats all
RP/0/RP0/CPU0:ios(config)#commit

Step 3

Display the configured attributes of the UDC ports.

Example:

RP/0/RP0/CPU0:ios#show hw-module eth-switch ports-attrs

This output shows the attributes of all the configured ports.

Thu Nov 10 13:24:16.932 CET
Ports Attributes:
Port SfpUdc3  # 0 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)     Clear-On-Read
Port SfpUdc2  # 4 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)     Clear-On-Read
Port SfpUdc1  # 8 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)     Clear-On-Read
Port Rj45Udc1 # 12 (enable)     Link DOWN       Half-Duplex  9600 [1 Gbps] 3(SGMII)     Clear-On-Read
Port Rj45Udc2 # 16 (enable)     Link DOWN       Half-Duplex  9600 [1 Gbps] 3(SGMII)     Clear-On-Read
Port Rj45Udc3 # 20 (enable)     Link DOWN       Half-Duplex  9600 [1 Gbps] 3(SGMII)     Clear-On-Read
Port CpuMgmt  # 24 (enable)     Link UP         Full-Duplex  1522 [1 Gbps] 6(1000BASE_X)      
Port          # 25 (enable)     Link UP         Full-Duplex  1522 [1 Gbps] 6(1000BASE_X)      
Port Rj45Mgmt # 26 (enable)     Link UP         Full-Duplex  1522 [1 Gbps] 3(SGMII)      
Port SfpMgmt  # 27 (enable)     Link DOWN       Half-Duplex  1522 [1 Gbps] 3(SGMII)      

The command output displays the link state, duplex mode, maximum transmission unit, speed, interface type, and Clear-On-Read status for each configured port.

Step 4

Display the counters that are related to the CpuMgmt port.

Example:

RP/0/RP0/CPU0:ios#show hw-module eth-switch stats port CpuMgmt

This output displays the counter values for the CpuMgmt port.

Mon May 16 09:10:24.491 UTC

****************** START ******************
 PORT MAC COUNTERS - Test cmd [1] [Port:0x18]
  goodPktsSent          0
  goodPktsRcv           0
  ucPktsSent            17
  ucPktsRcv             2
  mcPktsSent            1489
  mcPktsRcv             0
  brdcPktsSent          349
  brdcPktsRcv           1
  goodOctetsSent        200863
  goodOctetsRcv         474
  pkts64Octets          614
  pkts65to127Octets     872
  pkts128to255Octets    86
  pkts256to511Octets    286
  pkts512to1023Octets   0
  pkts1024tomaxOoctets  0
  pkts1024to1518Octets  0

The command output displays MAC counter values, including packets, octets, and packet-size counters for the CpuMgmt port.

Step 5

Enable MAC counters Clear-On-Read for the Rj45Udc1 port.

Enabling or disabling MAC counters Clear-On-Read affects the corresponding port pairs: SfpUdc3 #0 and SfpUdc2 #4, and Rj45Udc1 #12 and Rj45Udc2 #16. Configuring this attribute on Rj45Udc1 #12 also affects Rj45Udc2 #16 and the other way around.

Example:

RP/0/RP0/CPU0:ios#configure
RP/0/RP0/CPU0:ios(config)#hw-module eth-switch port Rj45Udc1 enable-clear-on-read
RP/0/RP0/CPU0:ios(config)#commit

Step 6

Verify the hardware module Ethernet switch port attributes.

Example:

RP/0/RP0/CPU0:ios#show hw-module eth-switch ports-attrs
Ports Attributes:
Port SfpUdc3  # 0 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)      
Port SfpUdc2  # 4 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)      
Port SfpUdc1  # 8 (enable)      Link UP         Full-Duplex  9604 [1 Gbps] 6(1000BASE_X)      
Port Rj45Udc1 # 12 (enable)     Link UP      Half-Duplex  9600 [1 Gbps] 3(SGMII)     Clear-On-Read
Port Rj45Udc2 # 16 (enable)     Link UP      Half-Duplex  9600 [1 Gbps] 3(SGMII)     Clear-On-Read
Port Rj45Udc3 # 20 (enable)     Link UP         Full-Duplex  9600 [1 Gbps] 3(SGMII)      
Port CpuMgmt  # 24 (enable)     Link UP         Full-Duplex  1522 [1 Gbps] 6(1000BASE_X)      
Port          # 25 (enable)     Link UP         Full-Duplex  1522 [1 Gbps] 6(1000BASE_X)      
Port Rj45Mgmt # 26 (enable)     Link UP         Full-Duplex  1522 [100 Mbps] 3(SGMII)      
Port SfpMgmt  # 27 (enable)     Link DOWN       Half-Duplex  1522 [1 Gbps] 3(SGMII)

The command output shows whether Clear-On-Read is enabled for the expected UDC ports.


The UDC port statistics and Clear-On-Read behavior are updated and verified from the hardware module Ethernet switch command output.