|
Table Of Contents
OSCP Commands
OSCP (Optical Supervisory Channel Protocol) provides out-of-band network management over a 33rd channel. Use the following commands to configure and monitor OSCP operations.
clear oscp
To clear OSCP statistics or traffic counters, use the clear oscp command.
clear oscp {statistics | traffic}
Syntax Description
Defaults
None
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to perform a one-time clear of the specified OSCP statistics or traffic tables. This command is useful for debugging or monitoring OSCP performance.
Examples
The following example shows how to clear OSCP statistics and traffic tables.
Switch# clear oscp statistics
Switch# clear oscp traffic
Related Commands
Command DescriptionDisplays OSCP Hello statistics information.
Display OSCP Hello traffic information.
oscp timer hello holddown
To modify the OSCP timer Hello hold-down interval, use the oscp timer hello holddown command. To return the Hello hold-down interval to its default value, use the no form of the command.
oscp timer hello holddown milliseconds
no oscp timer hello holddown
Syntax Description
Defaults
3000 milliseconds
Command Modes
Global configuration
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to control the amount of OSCP Hello activity that is generated on the network. The Hello hold-down timer specifies the interval during which no more than one Hello packet can be sent. If more than one Hello packet is generated during the hold-down period, the extra packets are delayed. Increasing the hold-down timer limits the number of Hello packets triggered in response to Hello packets received from a neighboring node and reduces the likelihood of Hello packets flooding the OSC.
To ensure proper functioning of the OSCP, the Hello hold-down timer value can be no more that 75 percent of the OSCP Hello interface timer.
Note There is a trade-off between the frequency of generating Hello packets and the speed in which the system detects that the OSCP has gone down. In certain OSCP failure scenarios, a shorter Hello interval leads to faster detection of the OSCP failure.
Examples
The following example shows how to configure the OSCP timer Hello hold-down interval.
Switch# configure terminal
Switch(config)# oscp timer hello holddown 300
Related Commands
Command DescriptionEnables debugging of OSCP activity.
Modifies the OSCP timer Hello interval.
Modifies the OSCP timer inactivity factor.
Displays OSCP configuration information.
oscp timer hello interval
To modify the OSCP timer Hello interval, use the oscp timer hello interval command. To return the Hello interval to its default value, use the no form of the command.
oscp timer hello interval milliseconds
no oscp timer hello interval
Syntax Description
milliseconds
Specifies, in milliseconds, the periodic generation of OSCP Hello packets. The range is 100 to 10000 milliseconds.
Defaults
100 milliseconds
Command Modes
Global configuration
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to control how often OSCP Hello messages are sent. The OSCP sends Hello packets to adjacent nodes at a configured interval. When five packets fail to get a response from the receiving node, that node is declared "down." By decreasing the interval at which Hello packets are sent, reaction time to a failed node can be lessened. Increasing the interval reduces the amount of Hello packet traffic.
Note There is a trade-off between the frequency of generating Hello packets and the speed in which the system detects that the OSCP has gone down. In certain OSCP failure scenarios, a shorter Hello interval leads to faster detection of the OSCP failure.
Examples
The following example shows how to configure the OSCP timer Hello interval.
Switch# configure terminal
Switch(config)# oscp timer hello interval 200
Related Commands
Command DescriptionEnables debugging of OSCP activity.
Modifies the OSCP timer Hello hold-down interval.
Modifies the OSCP timer Hello inactivity factor.
Displays OSCP configuration information.
oscp timer inactivity-factor
To modify the OSCP timer Hello inactivity factor, use the oscp timer inactivity-factor command. To return the Hello inactivity factor to its default value, use the no form of the command.
oscp timer inactivity-factor factor
no oscp timer inactivity-factor
Syntax Description
Defaults
5 seconds
Command Modes
Global configuration
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
The system uses this attribute to determine when a neighbor node, or the link to it, has gone down. The link to a neighbor node is considered inactive if an OSCP Hello packet is not received for a time interval determined by the inactivity factor. The time interval is calculated by multiplying the inactivity factor by the advertised hold-down interval. For example, if the neighbor node's advertised hold-down interval is 5 seconds and the local node's inactivity factor is 5, the time interval that the local node will wait until declaring the neighbor node down is 25 seconds.
Note There is a trade-off between the frequency of generating Hello packets and the speed in which the system detects that the OSCP has gone down. In certain OSCP failure scenarios, a shorter Hello interval leads to faster detection of the OSCP failure.
Examples
The following example shows how to set the OSCP timer Hello inactivity factor to 3.
Switch# configure terminal
Switch(config)# oscp timer inactivity-interval 3
Related Commands
Command DescriptionEnables debugging of OSCP activity.
Modifies the OSCP timer Hello hold-down interval.
Modifies the OSCP timer Hello interval.
Displays OSCP configuration information.
show oscp info
To display OSCP (Optical Supervisory Channel Protocol) configuration information, use the show oscp info command.
show oscp info
Syntax Description
This command has no other arguments or keywords.
Defaults
None
Command Modes
EXEC and privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to display OSCP configuration information for the system.
Examples
The following example shows how to display OSCP configuration information for the system. (See Table 5-1 for field descriptions.)
Switch# show oscp info
OSCP protocol version 1, Node ID 0000.1644.28fb
No. of interfaces 1, No. of neighbors 1
Hello interval 50 tenth of sec, inactivity factor 5,
Hello hold-down 1 tenth of sec
Supported OSCP versions: newest 1, oldest 1
Related Commands
Command DescriptionModifies the OSCP timer Hello hold-down interval.
Modifies the OSCP timer Hello interval.
Modifies the OSCP timer inactivity factor.
show oscp interface
To display OSCP (Optical Supervisory Channel Protocol) status information for OSC wave interfaces and ethernetdcc interfaces, use the show oscp interface command.
show oscp interface [wave slot/subcard | ethernetdcc slot/subcard/port | sdcc slot/subcard/port]
Syntax Description
wave slot
Specifies an OSC wave interface.
ethernetdcc slot/subcard/port
Specifies an ethernetdcc interface.
sdcc slot/subcard/port
Specifies an sdcc interface.
Defaults
Displays OSCP status information for all OSC wave interfaces, ethernetdcc interfaces, and sdcc interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to display status information for the local and remote interfaces running OSCP.
Examples
The following example shows how to display status information for the local and remote interfaces running OSCP. (See Table 5-2 for field descriptions.)
Switch# show oscp interface
Codes: OSC - dedicated wavelength channel, CDL - in-band wavelength channel
OSCP Interface(s)
Local Port Port ID Type OSCP St Rem Port ID Rem Node Id
~~~~~~~~~~~~~~~~~~~ ~~~~~~~~ ~~~~ ~~~~~~~ ~~~~~~~~~~~ ~~~~~~~~~~~~~~
EthernetDcc1/0/0 00020000 CDL 2way 00020000 0009.7c1a.ce50
Related Commands
Command DescriptionDisplays OSCP neighbor information.
Displays OSCP activity statistics.
Displays OSCP message traffic information.
show oscp neighbor
To display OSCP (Optical Supervisory Channel Protocol) neighbor information, use the show oscp neighbor command.
show oscp neighbor
Syntax Description
This command has no other arguments or keywords.
Defaults
None
Command Modes
EXEC and privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to display information about the identity of the neighbors communicating with the system through OSCP.
Examples
The following example shows how to display information about the identity of the neighbors communicating with the system through OSCP. (See Table 5-3 for field descriptions.)
Switch# show oscp neighbor
OSCP Neighbors
Neighbor Node Id: 0000.1644.28ff Port list:
Local Port Port ID Rem Port ID OSCP state
~~~~~~~~~~~~~ ~~~~~~~~ ~~~~~~~~~~~ ~~~~~~~~~
Wave3/0 1000000 1000000 2way
Related Commands
Command DescriptionDisplays OSCP information for an interface.
Displays OSCP activity statistics.
Displays OSCP message traffic information.
show oscp statistics
To display OSCP (Optical Supervisory Channel Protocol) Hello statistics, use the show oscp statistics command.
show oscp statistics [wave slot/subcard | ethernetdcc slot/subcard/port | sdcc slot/subcard/port]
Syntax Description
wave slot
Specifies an OSC wave interface.
ethernetdcc slot/subcard/port
Specifies an ethernetdcc interface.
sdcc slot/subcard/port
Specifies an sdcc interface.
Defaults
Displays OSCP statistics for all OSC wave interfaces , ethernetdcc interfaces, and sdcc interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to display OSCP Hello statistics for an OSC interface.
This command displays the following OSCP statistics, which can be used to debug the OSCP.
•hold down—Shows how many times a hold down has been applied to avoid excessive generation of OSCP Hello packets.
•Hello Tx pkts and Hello Rx pkts—Shows the number of OSCP Hello packets that have been transmitted and received at an interface.
•OSCP go down—Shows the number of times an OSC interface has gone out of two-way state.
Examples
The following example shows how to display OSCP control statistics for an OSC interface. (See Table 5-4 for field descriptions.)
Switch# show oscp statistics wave 3/0
OSCP Hello Statistics:
interface Wave3/0
Event Count
~~~~~~~~~~~~ ~~~~~~~~~~
hold down 3
Hello Tx pkts 2262
Hello Rx pkts 2259
Hello discards in 0
Hello discards out 0
OSCP go down events 2
Event Time (seconds)
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~
Next Tx Hello due 2
Last Hello sent 2
Last Hello received 4
Inactivity interval 25.0
Time until port dropped 20
Related Commands
Command DescriptionModifies the OSCP timer Hello hold-down interval.
Modifies the OSCP timer Hello interval.
show oscp traffic
To display OSCP (Optical Supervisory Channel Protocol) Hello message traffic information, use the show oscp traffic command.
show oscp traffic [wave slot/subcard | ethernetdcc slot/subcard/port | sdcc slot/subcard/port]
Syntax Description
wave slot
Specifies an OSC wave interface.
ethernetdcc slot/subcard/port
Specifies an ethernetdcc interface.
sdcc slot/subcard/port
Specifies an sdcc interface.
Defaults
Displays OSCP Hello message traffic information for all OSC wave interfaces, ethernetdcc interfaces, and sdcc interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•EV-Release
•SV-Release
•S-Release
Usage Guidelines
Use this command to display OSCP control traffic statistics, which show the count of different protocol packets that have been transmitted over the optical supervisory channel.
Examples
The following example shows how to display OSCP control traffic statistics, which show the count of different protocol packets that have been transmitted over the optical supervisory channel. (See Table 5-5 for field descriptions.)
Switch# show oscp traffic wave 3/0
OSC Traffic Statistics:
interface Wave3/0
Description Count
~~~~~~~~~~~~ ~~~~~~~~~~
Tx IP pkt 0
Rx IP pkt 0
Tx CDP pkt 198
Rx CDP pkt 195
Rx pkt dropped 0
Related Commands
Posted: Mon Feb 27 03:15:55 PST 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.