|
|
Table Of Contents
topology neighbor agent ip-address
Topology Neighbor Commands
Use the following commands to configure and monitor network topology neighbors.
show topology
To display information about the global physical network topology configuration, use the show topology command.
show topology
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
•
•
Usage Guidelines
Use this command to display the global physical network topology configuration information.
Examples
The following example shows how to display the topology hold-time interval. (See Table 11-1 for field descriptions.)
Switch# show topologyGlobal Physical Topology configuration:Maximum Hold Time = 300 secsTrap interval = 60 secs
Related Commands
Displays network topology information.
Configures the network topology SNMP trap notification throttle interval.
Modifies the interval to hold a nonstatic topology node entry.
show topology neighbor
To display the network topology neighbors for the shelf, use the show topology neighbor command.
show topology neighbor [detail]
Syntax Description
Defaults
Displays summary information.
Command Modes
Privileged EXEC
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
Use this command to display the network topology neighbors for the shelf.
Examples
The following example shows how to display network topology neighbor information for the shelf. (See Table 11-2 for field descriptions.)
Switch# show topology neighborPhysical Topology:Local Port Neighbor Node Neighbor Port Link Dirn---------- ------------- ------------- ---------Wdm0/0 ham2 Wdm0/1 BothWdm0/1 ham2 Wdm0/0 Both
The following example shows how to display detailed network topology neighbor information for the shelf. (See Table 11-3 for field descriptions.)
Switch# show topology neighbor detailPhysical Topology:Local Port: Wdm0/0Neighbor Node : ham2Neighbor Port : Wdm0/1Neighbor Agent Address: 1.1.1.10Neighbor Discovery : Via CDP (Proxy Port: Wave2/1)Link Direction : BothLocal Port: Wdm0/1Neighbor Node : ham2Neighbor Port : Wdm0/0Neighbor Agent Address: 172.20.42.27Neighbor Discovery : Via CDP (Proxy Port: Wave2/0)Link Direction : Both
Related Commands
topology hold-time
To modify the interval to hold nonstatic topology node entries, use the topology hold-time command. To return the hold-time interval to its default value, use the no form of the command.
topology hold-time seconds
no topology hold-time
Syntax Description
Defaults
300 seconds
Command Modes
Global configuration
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
Use this command to modify the network topology hold-time timer interval. This timer helps avoid reconstructing a nonstatic topology entry when a node leaves the network for only a brief time.
Examples
The following example shows how to modify the network topology hold time.
Switch# configure terminalSwitch(config)# topology hold-time 60Related Commands
Displays global physical topology configuration.
Configures the network topology SNMP trap notification throttle interval.
Enables CDP on wdm interfaces.
topology neighbor
To manually add a static entry for an esconphy, gigabitphy, multirate, OSC wave, oscfilter, transparent, twogigabitphy, voain, wdm, or wdmsplit interface to the network topology, use the topology neighbor command. To remove the interface from the network topology, use the no form of the command or the topology neighbor disable command.
topology neighbor {name node-name| ip-address ip-address |
mac-address mac-address} {port name port-name | port ip-address port-ip-address |
port mac-address port-mac-address} [transmit | receive]no topology neighbor
Syntax Description
Defaults
CDP (Cisco Discovery Protocol) is enabled on wdm interfaces.
Both directions.
No topology is configured on transparent or wdmsplit interfaces.
Command Modes
Interface configuration
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
Use this command to manually add esconphy, gigabitphy, multirate, wdm, thru, oscfilter, OSC wave, twogigabitphy, wdmsplit, and transparent interfaces to the network topology. You must also configure the network management agent IP address with the topology neighbor agent ip-address command. By default, CDP is enabled on all these interface types.
For esconphy, gigabitphy, multirate, twogigabitphy, and transparent interfaces, you must use the topology neighbor command to add the interface to the network topology because the transparent interfaces do not support CDP. For wdm interfaces, use either the topology neighbor command or the topology neighbor cdp command to populate the network topology.
For wdmsplit interfaces, you must use the topology neighbor command to add both the west and east interfaces on the PSM to the network topology.
For y-cable protected configurations, add both associated transparent, gigabitphy, or twogigabitphy interfaces to the network topology.
You can also use the topology neighbor disable command to remove an interface from the network topology.
Use the direction option to distinguish between bidirectional link neighbors and unidirectional (transmit or receive) link neighbors.
Examples
The following example shows a configuration example of network topology neighbor for the shelf. This allows either 1 bidirectional neighbor or 2 unidirectional neighbors on 1 interface.(See Table 11-2 for field descriptions.)
Switch(config)# interface transparent 8/0/0Switch(config-if)# topology neighbor name edfa1 port name inport transmitSwitch(config-if)# topology neighbor name edfa2 port name outport receiveSwitch(config-if)# topology neighbor agent ip-address 10.0.0.31 transmitSwitch(config-if)# topology neighbor agent ip-address 10.0.0.32 receiveSwitch(config-if)# exitSwitch(config)# interface transparent 8/0/0Switch(config-if)# topology neighbor name 15530-box2 port name wdm0/0Switch(config-if)# topology neighbor agent ip-address 10.0.0.20Switch(config-if)# endSwitch#The following example shows how to connect an OADM module to an OADM module in another node.
Switch# configure terminalSwitch(config)# interface wdm 0/0Switch(config-if)# topology neighbor name NodeA port name wdm0/0Switch(config-if)# topology neighbor agent ip-address 10.1.1.1The following example shows how to connect a transponder line card to an interface on client equipment.
Switch# configure terminalSwitch(config)# interface transparent 2/0/0Switch(config-if)# topology neighbor name Router1 port name gigabitethernet2/1Switch(config-if)# topology neighbor agent ip-address 10.2.2.2The following example shows how to connect a PSM to the PSM on another node.
Switch# configure terminalSwitch(config)# interface wdmsplit 0/1/0Switch(config-if)# topology neighbor name NodeB port name wdmsplit0/1/0Switch(config-if)# topology neighbor agent ip-address 10.3.3.3Related Commands
topology neighbor agent ip-address
To specify the network management agent address on a remote node, use the topology neighbor agent ip-address command. To remove the network management agent address from an interface, use the no form of the command.
topology neighbor agent ip-address ip-address [transmit | receive]
no topology neighbor agent ip-address ip-address [transmit | receive]
Syntax Description
Defaults
Both directions
Command Modes
Interface configuration
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
Use this command if you have configured a network topology manually with the topology neighbor command. Use this command on both wdm and transparent interfaces.
The network management agent IP address is usually the IP address of the NME on the node.
Note
Examples
The following example shows how to configure a network management agent on a wdm interface.
Switch# configure terminalSwitch(config)# interface wdm 0/2Switch(config-if)# topology neighbor name NodeA port name wdm0/0Switch(config-if)# topology neighbor agent ip-address 209.165.202.129The following example shows how to configure a network management agent on a transparent interface.
Switch# configure terminalSwitch(config)# interface transparent 2/0/0Switch(config-if)# topology neighbor name Router2 port name gigabitethernet 2/2Switch(config-if)# topology neighbor agent ip-address 209.165.202.130The following example shows how to configure directional parameters for a network management agent.
Switch(config)# interface transparent 8/0/0Switch(config-if)# topology neighbor name edfa1 port name inport transmitSwitch(config-if)# topology neighbor name edfa2 port name outport receiveSwitch(config-if)# topology neighbor agent ip-address 10.0.0.31 transmitSwitch(config-if)# topology neighbor agent ip-address 10.0.0.32 receiveSwitch(config-if)# exitRelated Commands
Displays the topology configuration.
Adds a static entry for an interface to the network topology.
v
topology neighbor cdp
To enable physical topology discovery through CDP on wdm and tengigethernetphy interfaces, use the topology neighbor cdp command. To disable CDP topology discovery on the interface, use the no form of the command or the topology neighbor disable command.
topology neighbor cdp [proxy interface]
no topology neighbor cdp [proxy interface]
Syntax Description
proxy interface
Specifies the interface capable of learning the topology to use as a proxy for CDP. Only OSC wave interfaces and ethernetdcc interfaces can be used as proxy interfaces.
Defaults
Topology discovery enabled when a valid proxy interface is available.
For wdm interfaces, the OSC wave interface patched to the oscfilter interface on an OADM module is the default proxy interface.
For tengigethernetphy interfaces, the ethernetdcc interface on the same 10-Gbps uplink card is the default proxy interface.
Command Modes
Interface configuration
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
CDP learns about the neighboring nodes in the network topology. For CDP discovery to function properly the OSC or the in-band message channel, and CDP must be present and configured on the system. For wdm interfaces, use the proxy option to specify either an OSC wave interface or an ethernetdcc interface on a 10-Gbps ITU trunk card. These types of interfaces are capable of learning the topology using CDP.
Note
Note
You can use the topology neighbor command to statically add a wdm or tengigethernetphy interface to the network topology, but you must first disable CDP on the interface. To configure a client side interface as part of the network topology, use the topology neighbor command.
Note
Examples
The following example shows how to enable CDP on a wdm interface.
Switch# configure terminalSwitch(config)# interface wdm 0/0Switch(config-if)# topology neighbor cdp proxy wave 2/0Related Commands
topology neighbor disable
To remove an interface from the network topology, use the topology neighbor disable command.
topology neighbor disable
Syntax Description
This command has no other arguments or keywords.
Defaults
None
Command Modes
Interface configuration
Command History
This table includes the following release-specific history entries:
•
•
•
Usage Guidelines
Use this command to remove an interface from the network topology, whether it was added with the topology neighbor command or the topology neighbor cdp command.
Examples
The following example shows how to remove an interface from the network topology.
Switch# configure terminalSwitch(config)# interface wdm 0/2Switch(config-if)# topology neighbor disableRelated Commands
Displays the system connections.
Adds a static entry for an interface to the network topology.
Enables CDP on the interface.
Posted: Mon Feb 27 03:19:16 PST 2006
All contents are Copyright © 1992--2006 Cisco Systems, Inc. All rights reserved.
Important Notices and Privacy Statement.
