Table Of Contents
show tag-switching tdp discovery
show tag-switching tdp neighbors
show tag-switching tdp parameters
show tag-switching tsp-tunnels
show xtagatm cross-connect
show xtagatm vc
tag-control-protocol vsi
tag-switching advertise-tags
tag-switching atm allocation-mode
tag-switching atm control-vc
tag-switching atm maxhops
tag-switching atm multi-vc
tag-switching atm vc-merge
tag-switching atm vpi
tag-switching atm vp-tunnel
tag-switching cos-map
tag-switching ip (global configuration)
tag-switching ip (interface configuration)
tag-switching ip default-route
tag-switching mtu
tag-switching prefix-map
tag-switching tag-range downstream
tag-switching tdp discovery
tag-switching tdp holdtime
tag-switching tsp-tunnels (global configuration)
tag-switching tsp-tunnels (interface configuration)
tunnel mode tag-switching
tunnel mpls traffic-eng affinity
tunnel mpls traffic-eng autoroute announce
tunnel mpls traffic-eng autoroute metric
tunnel mpls traffic-eng bandwidth
tunnel mpls traffic-eng path-option
tunnel mpls traffic-eng priority
tunnel mode mpls traffic-eng
tunnel tsp-hop
show tag-switching tdp discovery
To display the status of the LDP discovery process, use the show tag-switching tdp discovery command in privileged EXEC mode. Status of the LDP discovery process means a list of interfaces over which LDP discovery is running.
show tag-switching tdp discovery
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Examples
The following is sample output from the show tag-switching tdp discovery command.
show tag-switching tdp discovery
Table 83 describes the significant fields in this display.
Table 83 show tag-switching tdp discovery Field Descriptions
Field
|
Description
|
Local TDP Identifier
|
The LDP identifier for the local router. A LDP identifier is a 6-byte quantity displayed as an IP address:number.
The Cisco convention is to use a router ID for the first 4 bytes of the LDP identifier, and integers starting with 0 for the final two bytes of the IP address:number.
|
Interfaces
|
Lists the interfaces engaging in LDP discovery activity. xmit indicates that the interface is transmitting LDP discovery hello packets; recv indicates that the interface is receiving LDP discovery hello packets.
|
Related Commands
show tag-switching tdp neighbors
To display the status of Label Distribution Protocol (LDP) sessions, use the show tag-switching tdp neighbors command in privileged EXEC mode.
show tag-switching tdp neighbors [address | interface] [detail]
Syntax Description
address
|
(Optional) The neighbor that has this IP address.
|
interface
|
(Optional) LDP neighbors accessible over this interface.
|
detail
|
(Optional) Displays information in long form.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
The neighbor information branch can give information about all LDP neighbors, or it can be limited to
•
The neighbor with a specific IP address
•
LDP neighbors known to be accessible over a specific interface
Examples
The following is sample output from the show tag-switching tdp neighbors command:
show tag-switching tdp neighbors
Peer TDP Ident: 10.220.0.7:1; Local TDP Ident 172.27.32.29:1
TCP connection: 10.220.0.7.711 - 172.27.32.29.11029
State: Oper; PIEs sent/rcvd: 17477/17487; Downstream on demand
Peer TDP Ident: 210.10.0.8:0; Local TDP Ident 172.27.32.29:0
TCP connection: 210.10.0.8.11004 - 172.27.32.29.711
State: Oper; PIEs sent/rcvd: 14656/14675; Downstream
Addresses bound to peer TDP Ident:
99.101.0.8 172.27.32.28 10.105.0.8 10.92.0.8
Table 84 describes the significant fields in this display.
Table 84 show tag-switching tdp neighbors Field Descriptions
Field
|
Description
|
Peer TDP Ident
|
The LDP identifier of the neighbor (peer device) for this session.
|
Local TDP Ident
|
The LDP identifier for the local LSR (TSR) for this session.
|
TCP connection
|
The TCP connection used to support the LDP session. The format for displaying the TCP connection is
peer IP address.peer port local IP address.local port
|
State
|
The state of the LDP session. Generally this is Oper (operational), but Transient is another possible state.
|
PIEs sent/rcvd
|
The number of LDP protocol information elements (PIEs) sent to and received from the session peer device. The count includes the transmission and receipt of periodic keepalive PIEs, which are required for maintenance of the LDP session.
|
Downstream
|
Indicates that the downstream method of label distribution is being used for this LDP session. When the downstream method is used, a LSR advertises all of its locally assigned (incoming) labels to its LDP peer device (subject to any configured access list restrictions).
|
Downstream on demand
|
Indicates that the downstream-on-demand method of label distribution is being used for this LDP session. When the downstream-on-demand method is used, a LSR advertises its locally assigned (incoming) labels to its LDP peer device only when the peer device asks for them.
|
Up time
|
The length of time the LDP session has existed.
|
TDP discovery sources
|
The source(s) of LDP discovery activity that led to the establishment of this LDP session.
|
Addresses bound to peer TDP Ident
|
The known interface addresses of the LDP session peer device. These are addresses that may appear as next-hop addresses in the local routing table. They are used to maintain the Label Forwarding Information Base (LFIB).
|
Related Commands
show tag-switching tdp parameters
To display available LDP (TDP) parameters, use the show tag-switching tdp parameters command in privileged EXEC mode.
show tag-switching tdp parameters
Syntax Description
This command has no arguments or keywords.
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Examples
The following is sample output from the show tag-switching tdp parameters command:
show tag-switching tdp parameters
Downstream tag pool: min tag: 10; max_tag: 10000; reserved tags: 16
Session hold time: 15 sec; keep alive interval: 5 sec
Discovery hello: holdtime: 15 sec; interval: 5 sec
Discovery directed hello: holdtime: 15 sec; interval: 5 sec
Accepting directed hellos
Table 85 describes the significant fields in this display.
Table 85 show tag-switching tdp parameters Field Descriptions
Field
|
Description
|
Protocol version
|
Indicates the version of the Label Distribution Protocol (LDP) running on the platform.
|
Downstream tag pool
|
Describes the range of labels available for the platform to assign for Label Switching. The labels available run from the smallest label value (min label) to the largest label value (max label), with a modest number of labels at the low end of the range (reserved labels) reserved for diagnostic purposes.
|
Session hold time
|
Indicates the time to maintain a LDP session with a LDP peer device without receiving LDP traffic or a LDP keepalive from the peer device.
|
keep alive interval
|
Indicates the interval of time between consecutive transmission LDP keep alive messages to a LDP peer device.
|
Discovery hello
|
Indicates the amount of time to remember that a neighbor platform wants a LDP session without receiving a LDP Hello from the neighbor (holdtime), and the time interval between transmitting LDP Hello messages to neighbors (interval).
|
Discovery directed hello
|
Indicates the amount of time to remember that a neighbor platform wants a LDP session when (1) the neighbor platform is not directly connected to the router and (2) the neighbor platform has not sent an LDP Hello message. The interval is known as holdtime.
Also indicates the time interval between the transmission of Hello messages to a neighbor not directly connected to the router.
|
Accepting directed hellos
|
Indicates that the platform will accept and act on Directed LDP Hello messages. This field may not be present.
|
Related Commands
show tag-switching tsp-tunnels
To display information about the configuration and status of selected tunnels, use the show tag-switching tsp-tunnels command in privileged EXEC mode.
show tag-switching tsp-tunnels [{head | middle | tail | all | remote | address}
[interface-number]] [brief]
Syntax Description
head
|
(Optional) Displays information for tunnels that originate at the node.
|
middle
|
(Optional) Displays information for tunnels that pass through the node.
|
tail
|
(Optional) Displays information for tunnels that terminate at the node.
|
all
|
(Optional) Displays the combination of head, middle, and tail information for tunnels.
|
remote
|
(Optional) Displays information for tunnels that originate elsewhere; it is thus the combination of middle and tail.
|
address
|
(Optional) Displays information for tunnels that use the specified address in their identifier.
|
interface-number
|
(Optional) Displays information for tunnels that use the specified number in their identifier.
|
brief
|
(Optional) Displays a brief summary of tunnel status and configuration.
|
Command Modes
Privileged EXEC
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
The optional keywords restrict the set of tunnels displayed. With no optional keywords, the command displays all tunnels passing through the node.
Each LSP tunnel has a globally unique identifier. When signalling, the LSP tunnel is signaled and is available at each hop, this identifier is used. This identifier is a combination of the originating IP address and the number of the Cisco IOS tunnel interface used in configuring the LSP tunnel at the headend.
Examples
The following is sample output from the show tag-switching tsp-tunnels command:
show tag-switching tsp-tunnels
TSP Tunnels Process: running
TUNNEL ID DESTINATION STATUS CONNECTION
10.106.0.6 0 10.2.0.12 up up
Table 86 describes the significant fields in this display.
Table 86 show tag-switching tsp-tunnels Field Descriptions
Field
|
Description
|
Signalling Summary
|
The status of the signalling and forwarding mechanism that is required in order for LSP tunnels to be signaled through the router.
|
TSP Tunnels Process
|
The status of the LSP tunnel signalling process. This process interacts with the signalling protocol to manage signaled tunnels and monitors the state of established tunnels.
|
RSVP Process
|
The status of the RSVP process. You use the RSVP protocol to signal tunnels.
|
Forwarding
|
The status of the forwarding mechanism used to switch data through local LSP tunnel segments.
|
TUNNEL ID
|
The identity of the tunnel being summarized as shown in the previous display output. The tunnel ID includes an IP address part and a number part, and is unique within the entire network.
|
DESTINATION
|
The destination of the LSP tunnel being summarized as shown in the previous display output—the IP address of the tunnel tail.
|
STATUS
|
The configuration status of the tunnel. At the head, this is an indication of whether the tunnel has been completely configured. It also refers to the status of the associated software and hardware interfaces.
|
CONNECTION
|
The connection status of the tunnel. This is an indication of whether the local signalling/configuration information shows that the tunnel is up. Typically the tunnel becomes "up" at the tail hop first, and then at the second to the last hop, and so forth, until signalling brings it up at the first hop.
|
Related Commands
show xtagatm cross-connect
To display information about the LSC's view of the cross-connect table on the remotely controlled ATM switch, use the show xtagatm cross-connect command in EXEC mode.
show xtagatm cross-connect [traffic] [interface interface [vpi vci] | descriptor descriptor [vpi
vci]]
Syntax Description
traffic
|
(Optional) Displays receive and transmit cell counts for each connection.
|
interface interface
|
(Optional) Displays only connections with an endpoint of the specified interface.
|
vpi vci
|
(Optional) Displays only detailed information on the endpoint with the specified VPI/VCI on the specified interface.
|
descriptor descriptor
|
(Optional) Displays only connections with an endpoint on the interface with the specified physical descriptor.
|
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Examples
Each connection is listed twice in the sample output from the show xtagatm vc cross-connect command, once under each interface that is linked by the connection. Connections are marked as "->" (unidirectional traffic flow, into the first interface), "<-" (unidirectional traffic flow, away from the interface) or "<->" (bidirectional).
The following is sample output from the show xtagatm cross-connect command:
show xtagatm cross-connect
Phys Desc VPI/VCI Type X-Phys Desc X-VPI/VCI State
10.1.0 1/37 -> 10.3.0 1/35 UP
10.1.0 1/34 -> 10.3.0 1/33 UP
10.1.0 1/33 <-> 10.2.0 0/32 UP
10.1.0 1/32 <-> 10.3.0 0/32 UP
10.1.0 1/35 <- 10.3.0 1/34 UP
10.2.0 1/57 -> 10.3.0 1/49 UP
10.2.0 1/53 -> 10.3.0 1/47 UP
10.2.0 1/48 <- 10.1.0 1/50 UP
10.2.0 0/32 <-> 10.1.0 1/33 UP
10.3.0 1/34 -> 10.1.0 1/35 UP
10.3.0 1/49 <- 10.2.0 1/57 UP
10.3.0 1/47 <- 10.2.0 1/53 UP
10.3.0 1/37 <- 10.1.0 1/38 UP
10.3.0 1/35 <- 10.1.0 1/37 UP
10.3.0 1/33 <- 10.1.0 1/34 UP
10.3.0 0/32 <-> 10.1.0 1/32 UP
Table 87 lists the significant fields in this display.
Table 87 show xtagatm cross-connect Field Descriptions
Field
|
Description
|
Phys desc
|
Physical descriptor. A switch-supplied string identifying the interface on which the endpoint exists.
|
VPI/VCI
|
The virtual path identifier and virtual channel identifier for this endpoint.
|
Type
|
"->" indicates an ingress endpoint, where traffic is only expected to be received into the switch; "<-" indicates an egress endpoint, where traffic is only expected to be transmitted out the interface; "<->" indicates that traffic is expected to be both transmitted and received at this endpoint.
|
X-Phys desc
|
The physical descriptor for the interface of the other endpoint belonging to the cross-connect.
|
X-VPI/VCI
|
The virtual path identifier and virtual channel identifier of the other endpoint belonging to the cross-connect.
|
State
|
Indicates the status of the cross-connect to which this endpoint belongs. Is typically "UP"; other values, all of which should be transient, include:
DOWN
ABOUT_TO_DOWN
ABOUT_TO_CONNECT
CONNECTING
ABOUT_TO_RECONNECT
RECONNECTING
ABOUT_TO_RESYNC
RESYNCING
NEED_RESYNC_RETRY
ABOUT_TO_RESYNC_RETRY RETRYING_RESYNC
ABOUT_TO_DISCONNECT
DISCONNECTING
|
A sample of the detailed information provided for a single endpoint is:
show xtagatm cross-connect descriptor 12.1.0 1 42
Intf type: switch control port
X-Intf type: extended tag ATM
Cast-type: point-to-point
Rx service type: Tag COS 0
Tx service type: Tag COS 0
Table 88 lists the significant fields in this display.
Table 88 show xtagatm cross-connect descriptor Field Descriptions
Field
|
Description
|
Phys desc
|
Physical descriptor. A switch-supplied string identifying the interface on which the endpoint exists.
|
Interface
|
The (IOS) interface name.
|
Intf type
|
Interface type. Either "extended label ATM" or "switch control port".
|
VPI/VCI
|
The virtual path identifier and virtual channel identifier for this endpoint.
|
X-Phys desc
|
The physical descriptor for the interface of the other endpoint belonging to the cross-connect.
|
X-Interface
|
The (IOS) name for the interface of the other endpoint belonging to the cross-connect.
|
X-Intf type
|
The interface type for the interface of the other endpoint belonging to the cross-connect.
|
X-VPI/VCI
|
The virtual path identifier and virtual channel identifier of the other endpoint belonging to the cross-connect.
|
Conn-state
|
Indicates the status of the cross-connect to which this endpoint belongs. Is typically "UP"; other values, all of which should be transient, include
DOWN ABOUT_TO_DOWN ABOUT_TO_CONNECT
CONNECTING
ABOUT_TO_RECONNECT
RECONNECTING
ABOUT_TO_RESYNC
RESYNCING
NEED_RESYNC_RETRY
ABOUT_TO_RESYNC_RETRY
RETRYING_RESYNC
ABOUT_TO_DISCONNECT
DISCONNECTING.
|
Conn-type
|
"input" indicates an ingress endpoint where traffic is only expected to be received into the switch; "output" indicates an egress endpoint, where traffic is only expected to be transmitted out the interface; "input/output" indicates that traffic is expected to be both transmitted and received at this endpoint.
|
Cast-type
|
Indicates whether or not the cross-connect is multicast. In the first release, this is always point-to-point.
|
Rx service type
|
Class of service type for the receive, or ingress, direction. This will be "Label COS <n>," (Label Class of Service <n>), where n is in the range from 0 to 7, for input and input/output endpoints; this will be "n/a" for output endpoints. (In the first release, n will be either 0 or 7.)
|
Rx cell rate
|
(Guaranteed) cell rate in the receive, or ingress, direction. In the first release, this is always "n/a".
|
Rx peak cell rate
|
Peak cell rate in the receive, or ingress, direction, in cells per second. This is "n/a" for an output endpoint.
|
Tx service type
|
Class of service type for the transmit, or egress, direction. This will be "Label COS <n>," (Label Class of Service <n>), where n is in the range from 0 to 7, for output and input/output endpoints; this will be "n/a" for input endpoints. (In the first release, n will be either 0 or 7.)
|
Tx cell rate
|
(Guaranteed) cell rate in the transmit, or egress, direction. In the first release, this is always "n/a."
|
Tx peak cell rate
|
Peak cell rate in the transmit, or egress, direction, in cells per second. This is "n/a" for an input endpoint.
|
show xtagatm vc
To display information about terminating VCs on extended label ATM (XTagATM) interfaces, use the show xtagatm vc command in EXEC mode.
show xtagatm vc [vcd [interface]]
Syntax Description
vcd
|
(Optional) Virtual circuit descriptor (virtual circuit number). If you specify the vcd argument, then detailed information about all VCs having that vcd is displayed. If you do not specify the vcd argument, then a summary description of all VCs on all XTagATM interfaces is displayed.
|
interface
|
(Optional) Interface number. If you specify the interface and the vcd arguments, then the single VC having the specified vcd on the specified interface is selected.
|
Each connection is listed twice in the sample output from the show xtagatm vc cross-connect command under each interface that is linked by the connection. Connections are marked as input (unidirectional traffic flow, into the interface), output (unidirectional traffic flow, away from the interface) or in/out (bidirectional).
Command Modes
EXEC
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
The columns marked VCD, VPI, and VCI display information for the corresponding private VC on the control interface. The private VC connects the XTagATM VC to the external switch. It is termed "private" because its VPI and VCI are used only for communication between the LSC and the switch, and is different from the VPI and VCI seen on the XTagATM interface and the corresponding switch port.
Examples
The following is sample output from the show xtagatm vc command:
AAL / Control Interface
Interface VCD VPI VCI Type Encapsulation VCD VPI VCI Status
XTagATM0 1 0 32 PVC AAL5-SNAP 2 0 33 ACTIVE
XTagATM0 2 1 33 TVC AAL5-MUX 4 0 37 ACTIVE
XTagATM0 3 1 34 TVC AAL5-MUX 6 0 39 ACTIVE
Table 89 lists the significant fields in this display.
Table 89 show xtagatm vc Field Descriptions
Field
|
Description
|
VCD
|
Virtual circuit descriptor (virtual circuit number).
|
VPI
|
Virtual path identifier.
|
VCI
|
Virtual circuit identifier.
|
Control Interf. VCD
|
VCD for the corresponding private VC on the control interface.
|
Control Interf. VPI
|
VPI for the corresponding private VC on the control interface.
|
Control Interf. VCI
|
VCI for the corresponding private VC on the control interface.
|
Encapsulation
|
Displays the type of connection on the interface.
|
Status
|
Displays the current state of the specified ATM interface.
|
Related Commands
Command
|
Description
|
show atm vc
|
Displays all ATM VCs (PVCs and SVCs) and traffic information.
|
show xtagatm cross-connect
|
Displays information about the LSC view of the cross-connect table on the remotely controlled ATM switch.
|
tag-control-protocol vsi
To configure the use of VSI on a particular master control port, use the tag-control-protocol vsi command in interface configuration mode. To disable VSI, use the no form of this command.
tag-control-protocol vsi [id controller-id] [base-vc vpi vci] [slaves slave-count]
[keepalive timeout] [retry timeout count]
no tag-control-protocol vsi [id controller-id] [base-vc vpi vci] [slaves slave-count]
[keepalive timeout] [retry timeout count]
Syntax Description
id controller-id
|
(Optional) Determines the value of the controller-id field present in the header of each VSI message.
The default is 1.
|
base-vc vpi vci
|
(Optional) Determines the VPI/VCI value for the channel to the first slave. Together with the slaves value, this determines the VPI/VCI values for the channels to all the slaves, which are
vpi/vci
vpi/vci+1, and so on.
vpi/vci+slave_count-1.
The default is 0/40.
|
slaves slave-count
|
(Optional) Determines the number of slaves reachable through this master control port.
The default is 14 (suitable for the BPX).
In the first release, at most twelve sessions will be established with the BPX. The default of 14 will attempt sessions with cards 7 and 8, but such sessions are not used in this release and is always marked as UNKNOWN.
|
keepalive timeout
|
(Optional) Determines the value of the keepalive timer (in seconds). Note that the keepalive timer value should be greater than the value of the retry_timer times the retry_count+1.
The default is 15 seconds.
|
retry timeout count
|
(Optional) Determines the value of the message retry timer (in seconds) and the maximum number of retries.
The defaults are 8 seconds and 10 retries.
|
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
The command is available only on interfaces that can serve as VSI master control ports. It is recommended that all options to the tag-control-protocol command be entered at once.
Once VSI is active on the control interface (through an earlier tag-control-protocol vsi command), reentering the command may cause all associated XTagATM interfaces to go down and come back up. In particular, reentering the tag-control-protocol vsi command with any of the following options causes VSI to be shut down and reactivated on the control interface:
•
id
•
base-vc
•
slaves
VSI remains continuously active (that is, will not be shut down and reactivated) if tag-control-protocol vsi command is reentered with only one or more of the following options:
•
keepalive
•
retry
In either case, reentering the tag-control-protocol vsi command causes the specified options to take on the newly specified values; the other options retain their previous values. To restore default values to all the options, enter the no tag-control-protocol command, followed by the tag-control-protocol vsi command.
Examples
The following example shows you how to configure the VSI driver on the control interface:
tag-control-protocol vsi 0 51
tag-switching advertise-tags
To control the distribution of locally assigned (incoming) labels via the Label Distribution Protocol (LDP), use the tag-switching advertise-tags command in global configuration mode. To disable label advertisement, use the no form of this command.
tag-switching advertise-tags [for access-list-number [to access-list-number]]
no tag-switching advertise-tags [for access-list-number [to access-list-number]]
Syntax Description
for access-list-number
|
(Optional) Specifies which destinations should have their labels advertised.
|
to access-list-number
|
(Optional) Specifies which LSR neighbors should receive label advertisements.
A LSR is identified by the router ID that is the first 4 bytes of its 6-byte LDP identifier.
|
Defaults
The labels of all destinations are advertised to all LSR neighbors.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
To enable the distribution of all locally assigned labels to all LDP neighbors, use the tag-switching advertise-tags command.
You can enter multiple tag-switching advertise-tags commands. Taken together, they determine how local labels are advertised.
Note
This command has no effect for a TC-ATM interface. The effect is always as if the tag-switching advertise-tags command had been executed.
Examples
In the following example, the router is configured to advertise all locally assigned labels to all LDP neighbors. This is the default.
tag-switching advertise-tags
In the following example, the router is configured to advertise to all LDP neighbors labels for networks 10.101.0.0 and 10.221.0.0 only.
access-list 1 permit 10.101.0.0 0.0.255.255
access-list 4 permit 10.221.0.0 0.0.255.255
tag-switching advertise-tags for 1
tag-switching advertise-tags for 4
In the following example, the router is configured to advertise all labels to all LDP neighbors except neighbor 10.101.0.8.
access-list 1 permit any
access-list 2 deny 10.101.0.8
tag-switching advertise-tags
tag-switching advertise-tags for 1 to 2
tag-switching atm allocation-mode
To control the mode used for handling label binding requests on TC-ATM interfaces, use the tag-switching atm allocation-mode command in global configuration mode. To disable this feature, use the no form of this command t.
tag-switching atm allocation-mode {optimistic | conservative}
no tag-switching atm allocation-mode {optimistic | conservative}
Syntax Description
optimistic
|
Label binding is returned immediately, and packets are discarded until the downstream setup is complete.
|
conservative
|
Label binding is delayed until the label VC has been set up downstream.
|
Defaults
The default is conservative.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Examples
In the following example, the mode for handling binding requests is set to optimistic on a TC-ATM interface:
tag-switching atm allocation-mode optimistic
tag-switching atm control-vc
To configure the VPI and VCI values to be used for the initial link to the Label Switching peer, use the tag-switching atm control-vc command in interface configuration mode. This link is used to establish the LDP session and to carry non-IP traffic.
tag-switching atm control-vc vpi vci
no tag-switching atm control-vc vpi vci
Syntax Description
vpi
|
Virtual path identifier, in the range from 0 to 255.
|
vci
|
Virtual circuit identifier, in the range from 1 to 65535.
|
Defaults
0/32
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
On an extended label ATM (XTagATM) interface, the default VPI range to be used for labeled VCs is the configured VPI range that is learned from the switch. This default range should be sufficient for most applications. Use the tag-switching vpi command on an XTagATM interface only when it is necessary to override these defaults.
For the tag-switching atm vpi command, the VPI range specified must lie within the range that was configured on the BPX for the corresponding BPX interface.
Examples
The following example shows how to create a Label Switching subinterface on a router and how to select VPI 1 and VCI 34 as the control VC.
interface atm4/0.1 tag-switching
tag-switching atm control-vc 1 34
Related Commands
Command
|
Description
|
tag-switching ip (interface)
|
Enables Label Switching of IPv4 packets on an interface.
|
tag-switching atm maxhops
To limit the maximum hop count to a value you have specified, use the tag-switching atm maxhops command in global configuration mode. To ignore the hop count, use the no form of this command.
tag-switching atm maxhops [number]
no tag-switching atm maxhops
Syntax Description
number
|
(Optional) Maximum hop count.
|
Defaults
The default is 254.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
When an ATM LSR receives a BIND REQUEST, it does not send a BIND back if the value in the request is equal to the maxhops value. Instead, the ATM-LSR or LSR returns an error that specifies that the hop count has been reached.
When an ATM-LSR initiates a request for a label binding, it includes a parameter specifying the maximum number of hops that the request should travel before reaching the edge of the ATM Label Switching region. This is used to prevent forwarding loops in setting up label paths across the ATM region.
Examples
The following example sets the hop count limit to 2:
tag-switching atm maxhops 2
Related Commands
tag-switching atm multi-vc
To configure a router subinterface to create one or more tag-VCs over which packets of different classes are sent, use the tag-switching atm multi-vc command in ATM subinterface submode. To disable this option, use the no form of this command.
tag-switching atm multi-vc
no tag-switching atm multi-vc
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values.
Command Modes
ATM subinterface submode
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
Usage Guidelines
This option is valid only on ATM MPLS subinterfaces.
Examples
The following commands configure interface a2/0/0.1 on the router for MPLS CoS multi-VC mode.
Enter configuration commands, one per line. End with CNTL/Z.
int a2/0/0.1 tag-switching
tag-switching atm vc-merge
To control whether vc-merge (multipoint-to-point) is supported for unicast label VCs, use the tag-switching atm vc-merge command in global configuration mode. To disable this feature, use the no form of this command.
tag-switching atm vc-merge
no tag-switching atm vc-merge
Syntax Description
This command has no arguments or keywords.
Defaults
The default is enabled if the hardware supports the ATM-VC merge capability.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Examples
The following example disables VC merge:
no tag-switching atm vc-merge
Related Commands
tag-switching atm vpi
To configure the range of values to use in the VPI field for label VCs, use the tag-switching atm vpi command in interface configuration mode. To clear the interface configuration, use the no form of this command.
tag-switching atm vpi vpi [- vpi]
no tag-switching atm vpi vpi [- vpi]
Syntax Description
vpi
|
Virtual path identifier, low end of range (1 to 255).
|
- vpi
|
(Optional) Virtual path identifier, high end of range (1 to 255).
|
Defaults
1-1
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
To configure ATM Label Switching on a router interface (for example, an ATM Interface Processor), you must enable a Label Switching subinterface.
Note
The tag-switching atm control-vc and tag-switching atm vpi subinterface level configuration commands are available on any interface that can support ATM labeling.
Use this command to select an alternate range of VPI values for ATM label assignment on this interface. The two ends of the link negotiate a range defined by the intersection of the range configured at each end.
Examples
The following example shows how to create a subinterface and how to select a VPI range from VPI 1 to VPI 3:
interface atm4/0.1 tag-switching
tag-switching atm vpi 1-3
Related Commands
Command
|
Description
|
tag-switching atm control-vc
|
Configure the VPI and VCI values to be used for the initial link to the MPLS peer.
|
tag-switching atm vp-tunnel
To specify an interface or a subinterface as a VP tunnel, use the tag-switching atm vp-tunnel command in interface configuration mode.
tag-switching atm vp-tunnel vpi
Syntax Description
vpi
|
Provides the VPI value for the local end of the tunnel.
|
Defaults
No default behavior or values.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
12.0(3)T
|
This command was introduced.
|
Usage Guidelines
The tag-switching atm vp-tunnel and tag-switching atm vpi commands are mutually exclusive.
This command is available on both extended label ATM interfaces and on TC-ATM subinterfaces of ordinary router ATM interfaces. The command is not available on the 1010, where all subinterfaces are automatically VP tunnels.
On an XTagATM interface, the tunnel/non-tunnel status and the VPI value to be used in case the XTagATM interface is a tunnel are normally learned from the switch through VSI interface discovery. Therefore, it should not be necessary to use the tag-switching atm vp-tunnel command on an XTagATM interface in most applications.
Examples
The following example shows how to specify a Label Switching subinterface VP tunnel, with a VPI value 4.
tag-switching atm vp-tunnel 4
tag-switching cos-map
To create a class map that specifies how classes map to label-VCs when combined with a prefix map, use the tag-switching cos-map command in global configuration mode.
tag-switching cos-map number
Syntax Description
number
|
Unique number for a CoS map (1 to 255).
|
Defaults
No default behavior or values.
Command Modes
Global configuration
Command History
Release
|
Modification
|
12.0(5)T
|
This command was introduced.
|
Examples
This example shows how to create a class map.
Related Commands
Command
|
Description
|
class (MPLS)
|
Configures an MPLS CoS map that specifies how classes map to LVCs when combined with a prefix map.
|
show tag-switching cos-map
|
Displays the CoS map used to assign quantity of label virtual circuits and associated CoS of those LVCs.
|
tag-switching ip (global configuration)
To allow Label Switching of IPv4 packets, use the tag-switching ip command in global configuration mode. To disable IP Label Switching across all interfaces, use the no form of this command.
tag-switching ip
no tag-switching ip
Syntax Description
This command has no arguments or keywords.
Defaults
Label Switching of IPv4 packets is allowed.
Command Modes
Global configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
Dynamic Label Switching (that is, distribution of labels based on routing protocols) is allowed by this optional command, but it is not actually enabled until the interface-level tag-switching ip command is issued on at least one interface. The no form of this command stops the distribution of dynamic labels and the sending of outgoing labeled packets on all interfaces. The command does not affect the sending of labeled packets through LSP tunnels.
For a TC-ATM interface, the no form of this command prevents the establishment of label VCs beginning at, terminating at, or passing through the platform.
Examples
The following example prevents the distribution of dynamic labels on all interfaces:
Related Commands
tag-switching ip (interface configuration)
To enable Label Switching of IPv4 packets on an interface, use the tag-switching ip command in interface configuration mode. To disable IP Label Switching on this interface, use the no form of this command.
tag-switching ip
no tag-switching ip
Syntax Description
This command has no arguments or keywords.
Defaults
Label Switching of IPv4 packets is disabled on this interface.
Command Modes
Interface configuration
Command History
Release
|
Modification
|
11.1 CT
|
This command was introduced.
|
Usage Guidelines
The first time this command is issued on any interface, dynamic Label Switching is enabled on the router as a whole. LDP hello messages are issued on this interface. When an outgoing label for a destination routed out through this interface is received, packets sent to that destination are assigned with that label.
The no form of this command causes packets routed out through this interface to be sent unlabeled, and outgoing LDP hello messages are no longer sent.
When the no form is issued on the only interface of a router for which Label Switching was enabled, dynamic Label Switching is disabled on the router as a whole.
For a TC-ATM interface, the no form of this command prevents the establishment of label VCs beginning at, terminating at, or passing through the platform.
Examples
The following example, enables Label Switching on the specified Ethernet interface:
Related Commands