-
Cisco IOS XR MPLS Command Reference, Release 3.7
-
Preface
-
MPLS Label Distribution Protocol Commands on Cisco IOS XR Software
-
MPLS Forwarding Commands on Cisco IOS XR Software
-
MPLS Traffic Engineering Commands on Cisco IOS XR Software
-
RSVP Infrastructure Commands on Cisco IOS XR Software
-
MPLS Optical User Network Interface Commands on Cisco IOS XR Software
-
MPLS OAM Commands on Cisco IOS XR Software
-
Virtual Private Network Commands on Cisco IOS XR Software
-
Virtual Private LAN Services Commands on Cisco IOS XR Software
-
Index
-
Table Of Contents
MPLS Optical User Network Interface Commands on Cisco IOS XR Software
show mpls optical-uni checkpoint
show mpls optical-uni diagnostics
show mpls optical-uni interface
show mpls optical-uni timers all
show mpls optical-uni timers global
show mpls optical-uni timers interfaces
show mpls optical-uni timers nodes
MPLS Optical User Network Interface Commands on Cisco IOS XR Software
This chapter describes the commands used to configure, monitor, and troubleshoot an Optical User Network Interface (O-UNI). It provides a description of the Static Link Management Protocol (LMP) commands. LMP is a user-configured version of the Internet Engineering Task Force's (IETF) LMP; hence, the keyword lmp is used in the management commands.
The Unified Control Plane (UCP) (sometimes referred to as the Optical Control Plane [OCP]) is a standards-based approach toward an open architecture for the control and provisioning of optical transport elements and capacity. It allows customers to establish standards-based Optical Internetworking Forum (OIF) connections through heterogeneous optical networks (OTNs) based on the Synchronous Optical Network (SONET) and Synchronous Digital Hierarchy (SDH) specifications. These connections are made across OTNs comprising Cisco equipment or third-party vendor equipment.
For detailed information about MPLS concepts, configuration tasks, and examples, refer to the
Cisco IOS XR MPLS Configuration Guide.destination address ipv4
To establish an O-UNI connection to a specific destination transport network address (TNA), use the destination address ipv4 command in MPLS O-UNI interface mode. To return to the default behavior, use the no form of this command.
destination address ipv4 destination-TNA
no destination address ipv4 destination-TNA
Syntax Description
Defaults
No default behavior or values
Command Modes
MPLS O-UNI interface
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the destination address ipv4 command whenever an O-UNI connection is established by the router. Both O-UNI-C sides participating in an O-UNI connection is configured with the destination address ipv4 command. In this case, the destination TNA specified by each side must correspond to the TNA configured by the other side.
Note
Based on the contention detection and backoff mechanisms defined in O-UNI 1.0, one of the routers acts as though configured with the passive command.
Task ID
Examples
The following example shows how to configure the interface to initiate an O-UNI connection to TNA 10.10.10.10:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# interface POS 0/1/0/1RP/0/RP0/CPU0:router(config-mpls-ouni-if)# destination address ipv4 10.10.10.10Related Commands
ipcc routed
To configure an Internet Protocol Control Channel (IPCC) that is routable, use the ipcc routed command in O-UNI LMP neighbor configuration mode. To return to the default behavior, use the no form of this command.
ipcc routed
no ipcc routed
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
O-UNI LMP neighbor configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
This type of IPCC is IPv4 routed to the O-UNI neighbor to which it is connected. Ensure that the O-UNI neighbor is configured with a reachable IPv4 node ID.
When a routed IPCC is configured to a given neighbor, control traffic destined to that neighbor is IP routed to the configured remote router ID for that neighbor. A correctly configured routed IPCC to a given LMP neighbor is required before an O-UNI label switched path (LSP) connection to that neighbor is established.
Task ID
Examples
The following example shows how to configure a routed IPCC for O-UNI neighbor router1 where the destination IP address is the node ID of the neighbor router1 on an interface determined dynamically by an IP routing protocol:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# lmp neighbor router1RP/0/RP0/CPU0:router(config-ouni-nbr-router1)# ipcc routedlmp neighbor
To configure or update a new or existing O-UNI specific LMP neighbor and its associated parameters, use the lmp neighbor command in MPLS O-UNI configuration mode. To return to the default behavior, use the no form of this command.
lmp neighbor neighbor-name
no lmp neighbor neighbor-name
Syntax Description
Defaults
No default behavior or values
Command Modes
MPLS O-UNI configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Neighbor names must be unique. A neighbor does not become operational until both the remote node ID and a routed Internet Protocol Control Channel (IPCC) are configured for that neighbor.
Note
Task ID
Examples
The following example shows how to enter LMP neighbor configuration mode for neighbor router 1, and create the LMP neighbor if it does not already exist.
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# lmp neighbor router 1Related Commands
neighbor (O-UNI)
To associate an interface with a given LMP neighbor, use the neighbor command in O-UNI LMP datalink adjacency configuration mode. To return to the default behavior, use the no form of this command.
neighbor neighbor-name
no neighbor neighbor-name
Syntax Description
neighbor-name
String of alphanumeric characters that defines the name of the LMP neighbor to create or modify.
Defaults
No default behavior or values
Command Modes
O-UNI LMP datalink adjacency configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
You can specify a forward reference to a neighbor that you have not yet configured. A neighbor does not become operational until both the remote node ID and a routed Internet Protocol Control Channel (IPCC) is configured for that neighbor. LMP neighbors are configured under the MPLS O-UNI configuration mode.
Task ID
Examples
The following example shows how to associate the neighbor router1 with the datalink PoS interface 0/1/0/1:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# interface POS 0/1/0/1RP/0/RP0/CPU0:router(config-mpls-ouni-if)# lmp data-link adjacencyRP/0/RP0/CPU0:router(config-mpls-ouni-if-adj)# neighbor router1Related Commands
Configures or updates a new or existing O-UNI specific LMP neighbor and its associated parameters.
passive (MPLS O-UNI)
To terminate an O-UNI connection, use the passive command in the MPLS O-UNI interface configuration mode. To return to the default behavior, use the no form of this command.
passive
no passive
Syntax Description
This command has no arguments or keywords.
Defaults
No default behavior or values
Command Modes
MPLS O-UNI interface configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the passive command whenever the router is to terminate an O-UNI connection. The interface accepts the incoming connection request of any O-UNI-C. The router does not actively attempt to create a connection, but rather waits for an incoming connection request.
Note
Task ID
Examples
The following example shows how to configure PoS interface 0/1/0/1 as the passive end of an O-UNI:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# interface POS 0/1/0/1RP/0/RP0/CPU0:router(config-mpls-ouni-if)# passiveRelated Commands
remote interface-id
To configure the remote datalink interface ID, use the remote interface-id command in O-UNI LMP neighbor adjacency configuration mode. To return to the default behavior, use the no form of this command.
remote interface-id remote-interface-id
no remote interface-id remote-interface-id
Syntax Description
Defaults
No remote datalink interface ID is configured.
Command Modes
O-UNI LMP neighbor adjacency configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The remote interface ID must be set to the local interface ID at the neighbor end of the datalink.
Task ID
Examples
The following example shows how to configure the interface ID for the remote neighbor of the datalink that is associated with PoS interface 0/1/0/1:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# interface pos 0/2/0/0 lmp data-link adjacencyRP/0/RP0/CPU0:router(config-mpls-ouni-if)# lmp data-link adjacencyRP/0/RP0/CPU0:router(config-mpls-ouni-if-adj)# remote interface-id 2Related Commands
remote node-id
To configure the remote node ID for an O-UNI LMP neighbor, use the remote node-id command in LMP neighbor configuration mode.
remote node-id A.B.C.D.
Syntax Description
Defaults
No default behavior or values
Command Modes
LMP neighbor configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
The remote node ID must be set to the local LMP node ID of the neighbor.
Task ID
Examples
The following example shows how to configure the node ID for a neighbor node:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# lmp neighbor router1RP/0/RP0/CPU0:router(config-ouni-nbr-router1)# remote node-id 192.168.20.10Related Commands
router-id (MPLS O-UNI)
To configure the local O-UNI LMP node ID, also known as a router ID, on a router, use the router-id command in MPLS O-UNI configuration mode.
router-id {A.B.C.D. | interface-name}
Syntax Description
A.B.C.D.
IPv4 address to use as the router ID.
interface-name
Name of an interface whose address is used as the LMP node ID.
Defaults
No default behavior or values
Command Modes
MPLS O-UNI configuration
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following example shows how to configure the node ID for a neighbor node:
RP/0/RP0/CPU0:router# configRP/0/RP0/CPU0:router(config)# mpls optical-uniRP/0/RP0/CPU0:router(config-mpls-ouni)# router-id pos 0/6/4/1show mpls lmp clients
To display information about LMP clients, use the show mpls lmp clients command in EXEC mode.
show mpls lmp clients
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use this command to display a list of LMP client names with associated job IDs, the nodes on which the client is running, and the client uptime.
Task ID
Examples
The following is sample output from the show mpls lmp clients command:
RP/0/RP0/CPU0:router# show mpls lmp clientsCurrent time: Thu June 20 6 07:26:27 2006Total Number of Clients = 2Client | Job ID | Node | Uptime | Since-------------+--------+-----------+------------------+-------------------------rsvp 114 node0_0_0 36m13s Tue Jun 20 11:22:39 2006ucp_O-UNI 116 node0_0_0 28m51s Tue Feb 20 11:30:01 2006Table 71 describes the significant fields shown in the display.
Table 71 show mpls ldp clients Field Descriptions
Client
Process name registered with LMP OLM1 server.
Job ID
Job ID of the client process.
Node
Node ID of the client.
Uptime
Time connection has been established.
Since
Time when the connection was successfully established. This field is empty until a connection is established.
1 Optical Link Manager
show mpls lmp interface-id
To display the local LMP interface ID (also known as port ID, or component interface ID) for a given interface, use the show mpls lmp interface-id command in EXEC mode.
show mpls lmp interface-id type interface-id
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Task ID
Examples
The following is sample output from the show mpls lmp interface-id command:
RP/0/RP0/CPU0:router# show mpls lmp interface-id pos 0/7/0/0Local LMP interface ID: Hex = 0xa, Dec = 10Table 72 describes the significant fields shown in the display.
Related Commands
show mpls optical-uni
To display information about the state of O-UNI connections, use the show mpls optical-uni command in EXEC mode.
show mpls optical-uni
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show mpls optical-uni command to display brief information for the state of O-UNI connection states.
Task ID
Examples
The following is sample output from the show mpls optical-uni command:
RP/0/RP0/CPU0:router# show mpls optical-uniIndex of abbreviations:----------------------M=O-UNI configuration Mode.P=PassiveAR =active/receiverAS=active/senderU=UnknownInterface TunID M Sig State CCT Up Since Remote Addr--------- --------- --- ----------- -------------------- -----------POS2/0/0/0 000001 AS Connected 27/02/2002 05:20:35 10.3.4.2Table 73 describes the significant fields shown in the display.
Table 73 show mpls optical-uni Field Descriptions
Interface
Name of the O-UNI configured interface.
TunID
Tunnel ID used in performing the signaling operation.
M
Mode of operation for the interface, as follows:
•
•
•
•
Sig State
Indicates the signaling state of the O-UNI connection. The following states exist:
No Connection—A connection could not be initiated on the interface
Wait Resv—A Path message was sent, and a Resv message is awaited.
Connected—A O-UNI connection is established.
Wait PErr PSR—The graceful deletion procedure has been initiated from the interface acting as the O-UNI-C source, a Path(D&R) message has been sent towards the destination O-UNI-C node, and a PathErr(PSR) message is awaited.
Wait Path—A path is awaited to initiate the O-UNI connection establishment procedures.
Wait Resvconf—At an O-UNI-C destination side, a Path message has been received, a Resv message has been sent towards the O-UNI-C source and now the O-UNI system awaits the ResvConf message to complete the connection setup.
Wait PTear—The graceful deletion procedure has been initiated from the interface acting as an O-UNI-C destination, a Resv(D&R) message has been sent towards source O-UNI-C, and the O-UNI system waits for a PathTear message to complete the deletion.
Path Retry—A previous attempt to establish a connection on the interface as an O-UNI-C source has failed, and the O-UNI system waits for a Retry timer to expire to make the next attempt.
CCT Up Since
The time at which a connection was successfully established. This field is empty until a connection is established.
Remote Addr
The remote address of a connection. If the interface has a passive configuration, this field is populated only after a connection is established.
Related Commands
show mpls optical-uni checkpoint
To display O-UNI information used during restart operations, use the show mpls optical-uni checkpoint command in EXEC mode.
show mpls optical-uni checkpoint
Syntax Description
This command has no arguments or keywords.
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show mpls optical-uni checkpoint command to display O-UNI information used during restart operations.
Note
Task ID
Examples
The following is sample output from the show mpls optical-uni checkpoint command:
RP/0/RP0/CPU0:router# show mpls optical-uni checkpointInterface TunID LspID CCT Up Since--------------- ----- ----- --------------------POS0_2_0_2 00004 00004 04/11/2006 15:01:07Table 74 describes the significant fields shown in the display.
show mpls optical-uni diagnostics
To display diagnostics information for an O-UNI connection for a specific interface, use the show mpls optical-uni diagnostics command in EXEC mode.
show mpls optical-uni diagnostics [interface type interface-id | all]
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use the show mpls optical-uni diagnostics command to display O-UNI diagnostics information for a specific interface.
Task ID
Examples
The following is sample output from the show mpls optical-uni diagnostics command:
RP/0/RP0/CPU0:router# show mpls optical-uni diagnostics interface POS 0/2/0/2Interface [POS0/2/0/2]Configuration: Active->UserSignaling State: [Path Retry]Connection to OLM/LMP established? YesO-UNI to OLM/LMP DB sync. status: SynchronizedConnection to RSVP established? YesRSVP to OLM/LMP DB sync. status: SynchronizedThe neighbor [router1] has been configured, and has the node id [55.56.57.58]Found a route to the neighbor [router1]Remote switching capability is TDM.TNA [10.0.0.5] configured.All required configs have been entered.Global Code: No Error/ Success @ unknown timeDatalink Code: PathErr Received @ 04/11/2006 17:06:48Table 75 describes the significant fields in the sample display shown above.
Related Commands
show mpls optical-uni interface
To display detailed O-UNI information for a specific interface, use the show mpls optical-uni interface command in EXEC mode.
show mpls optical-uni interface type interface-id
Syntax Description
Command Modes
EXEC
Command History
Usage Guidelines
To use this command, you must be in a user group associated with a task group that includes the proper task IDs. For detailed information about user groups and task IDs, see the Configuring AAA Services on Cisco IOS XR Software module of the Cisco IOS XR System Security Configuration Guide.
Use this command to display O-UNI information for a specific interface.
Task ID
