|
|
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:
•
EY-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 statisticsSwitch# clear oscp trafficRelated Commands
Displays 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:
•
•
•
•
•
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% of the OSCP Hello interface timer.
Note
Examples
The following example shows how to configure the OSCP timer Hello hold-down interval.
Switch# configure terminalSwitch(config)# oscp timer hello holddown 300Related Commands
Enables 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:
•
•
•
•
•
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
Examples
The following example shows how to configure the OSCP timer Hello interval.
Switch# configure terminalSwitch(config)# oscp timer hello interval 200Related Commands
Enables 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:
•
•
•
•
•
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
Examples
The following example shows how to set the OSCP timer Hello inactivity factor to 3.
Switch# configure terminalSwitch(config)# oscp timer inactivity-interval 3Related Commands
Enables 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:
•
•
•
•
•
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 infoOSCP protocol version 1, Node ID 0000.1644.28fbNo. of interfaces 1, No. of neighbors 1Hello interval 50 tenth of sec, inactivity factor 5,Hello hold-down 1 tenth of secSupported OSCP versions: newest 1, oldest 1
Related Commands
Modifies 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 the OSC interfaces, use the show oscp interface command.
show oscp interface [wave slot]
Syntax Description
Defaults
Displays OSCP status information for all OSC wave interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
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 interfaceCodes: OSC - dedicated wavelength channel, CDL - in-band wavelength channelOSCP Interface(s)Local Port Port ID Type OSCP St Rem Port ID Rem Node Id~~~~~~~~~~~~~~~~~~~ ~~~~~~~~ ~~~~ ~~~~~~~ ~~~~~~~~~~~ ~~~~~~~~~~~~~~Wave0 02000000 OSC down 00000000 0000.0000.0000Wave1 02020000 OSC down 00000000 0000.0000.0000
Related Commands
Displays 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:
•
•
•
•
•
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 neighborOSCP NeighborsNeighbor Node Id: 0000.1644.28ff Port list:Local Port Port ID Rem Port ID OSCP state~~~~~~~~~~~~~ ~~~~~~~~ ~~~~~~~~~~~ ~~~~~~~~~Wave0 1000000 1000000 2way
Related Commands
Displays 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]
Syntax Description
Defaults
Displays OSCP statistics for all OSC wave interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
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.
•
•
•
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 0OSCP Hello Statistics:interface Wave0Event Count~~~~~~~~~~~~ ~~~~~~~~~~hold down 3Hello Tx pkts 2262Hello Rx pkts 2259Hello discards in 0Hello discards out 0OSCP go down events 2Event Time (seconds)~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~Next Tx Hello due 2Last Hello sent 2Last Hello received 4Inactivity interval 25.0Time until port dropped 20
Related Commands
Modifies 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]
Syntax Description
Defaults
Displays OSCP Hello message traffic information for all OSC wave interfaces in the system.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•
•
•
•
•
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 0OSC Traffic Statistics:interface Wave0Description Count~~~~~~~~~~~~ ~~~~~~~~~~Tx IP pkt 0Rx IP pkt 0Tx CDP pkt 198Rx CDP pkt 195Rx pkt dropped 0
Related Commands
Posted: Sun Feb 19 15:10:04 PST 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
