MPLS applications can be upgraded using the In Service Software Upgrade (ISSU) process. Thus, MPLS applications are considered ISSU’s MPLS clients. The ISSU process allows Cisco IOS XE software to be updated or otherwise modified while packet forwarding continues.
Your software release may not support all the features documented in this module. For the latest caveats and feature information, see
Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table at the end of this module.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Prerequisites for ISSU MPLS Clients
Before you perform an upgrade, you need to verify that the clients you are concerned about are compatible with the intended switchover. Use the commands listed in the
Verifying the ISSU Process for an MPLS Client to determine compatibility.
The success performance of some clients in the upgraded network will depend upon their compatibility with other clients as described in the table below.
Table 1 MPLS Client Interdependencies
This client . . .
...can only work when this client is shown to be compatible
MPLS VPN
LSD Label Manager High Availability
LDP
LSD Label Manager High Availability
VRF (“Table ID”)
LSD Label Manager High Availability
LSD Label Manager High Availability
Base clients: Checkpointing and Redundancy Facility
MFI Pull
XDR
MFI Push
XDR
LSPV Push within OAM
XDR
TE
Base clients:
Checkpointing and Redundancy Facility
MPLS TE High Availability
Information About ISSU MPLS Clients
Before examining ISSU coordination of MPLS clients, you should understand the following concepts:
This section provides information about upgrading MPLS-related applications through ISSU. Those MPLS applications are considered ISSU’s MPLS “clients.”
Protocols and applications that can be upgraded through the ISSU process are considered clients of ISSU. These include at least the following:
Address Resolution Protocol (ARP)
Asynchronous Transfer Mode (ATM)
Cisco Express Forwarding
Dynamic Host Configuration Protocol (DHCP)
EtherChannel--port aggregration protocol (PagP) and Link Aggregration Control Protocol (LACP)
Frame Relay (FR)
Gateway Load Balancing Protocol (GLBP)
High-Level Data Link Control (HDLC)
Hot Standby Router Protocol (HSRP)
IEEE 802.1x and 802.3af
Internet Group Management Protocol (IGMP) snooping
IP host
Intermediate System-to-Intermediate System (IS-IS)
Multiprotocol Label Switching (MPLS)
PPP and Multilink PPP
Port security
Quality of service (QoS)
Remote File System (RFS) versioning
Simple Network Management Protocol (SNMP)
Spanning Tree Protocol (STP)
Note
For a complete list of ISSU- compliant protocols and applications that are supported for the Cisco ASR Series Routers for your release, see the Release Notes for Cisco ASR Series Aggregation Services Routers .
ISSU-Capable MPLS Feature Sets
Within the MPLS technology, ISSU supports the following feature sets as clients:
Label Distribution Protocol (LDP)
MPLS Virtual Private Network (MPLS VPN)
VPN routing and forwarding (VRF), also called the “Table ID” client
Label Switching Database Label Manager for high availability, usually called “LSD Label Manager for HA”
MPLS Forwarding Infrastructure Pull, called “MFI Pull”
MPLS Forwarding Infrastructure Push, called “MFI Push”
Label Switched Path Verification Push within Operation, Administration, and Management (OAM), called “LSPV Push”
TE
How to Verify that an MPLS Client Can Support an In Service Software Upgrade
Perform this task to verify that a particular MPLS client can be upgraded successfully during a particular ISSU session. The commands in this task also can be used to display other details about the ISSU MPLS clients, and should be entered in the order described.
Lists network applications and protocols currently supported by ISSU.
You can use this command to discover the client ID that you will need to enter in Steps 3 and 6.
Step 3
showissusessionsclientID
Example:
Router# show issu sessions 2002
Displays detailed information about a particular ISSU client that includes whether a particular client is compatible with the intended upgrade.
You can use this command to discover the session ID that you will need to enter in Steps 4 and 5.
Step 4
showissunegotiatedversionsessionID
Example:
Router#
show issu negotiated version 33
Displays details of the session’s negotiated message version.
Step 5
showissunegotiatedcapabilitysessionID
Example:
Router#
show issu negotiated capability 33
Displays results of a negotiation about the client application’s capabilities.
Step 6
showissumessagetypesclientID
Example:
Router# show issu message types 2002
Displays the message formats (“types”) and versions supported by the specified client.
Configuration Examples for ISSU MPLS Clients
To examine any ISSU client, you must specify its unique client ID when entering the
showissusessions command. If you do not already know that client ID, enter the
showissuclientscommand in user EXEC or privileged EXEC mode. Each ISSU client on the network will then be listed, with its client ID and client name on the same line, as shown in the following example:
Verifying the ISSU Process for an MPLS LDP Client Example
This example shows how to verify the ISSU process for an LDP client.
The first command shows you whether the LDP client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2011
---------------------------------------------------------------------
Client_ID = 2011, Entity_ID = 1 :
*** Session_ID = 46, Session_Name = LDP Session :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
4 34 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 46
Nego_Session_Name = LDP Session
Transport_Mtu = 3948
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, to see the negotiated message version:
Verifying the ISSU Process for an MPLS VPN Client Example
This example shows how to verify the ISSU process for an MPLS VPN client.
The first command shows you whether the VPN client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2009
---------------------------------------------------------------------
Client_ID = 2009, Entity_ID = 1 :
*** Session_ID = 39, Session_Name = MPLS VPN ISSU Session :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
3 33 PASSIVE COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 39
Nego_Session_Name = MPLS VPN ISSU Session
Transport_Mtu = 3980
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Router# show issu negotiated version 39
Session_ID = 39 :
Message_Type = 1, Negotiated_Version = 1, Message_MTU = 32
Next you can enter the same session ID into the following command to display the capability negotiation result:
Verifying the ISSU Process for an MPLS VRF (“Table ID”) Client Example
This example shows how to verify the ISSU process for an MPLS VRF (“Table ID”) client.
The first command shows you whether the VRF client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2008
---------------------------------------------------------------------
Client_ID = 2008, Entity_ID = 1 :
*** Session_ID = 19, Session_Name = TABLEID ISSU CF :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
4 13 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 19
Nego_Session_Name = TABLEID ISSU CF
Transport_Mtu = 3948
Router# show issu sessions 2008
---------------------------------------------------------------------
Client_ID = 2008, Entity_ID = 1 :
*** Session_ID = 19, Session_Name = TABLEID ISSU CF :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
4 13 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 19
Nego_Session_Name = TABLEID ISSU CF
Transport_Mtu = 3948
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Verifying the ISSU Process for an MPLS LSD Label Manager HA Client Example
This example shows how to verify the ISSU process for an MPLS LSD Label Manager HA client.
The first command shows you whether the LSD client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2007
---------------------------------------------------------------------
Client_ID = 2007, Entity_ID = 1 :
*** Session_ID = 40, Session_Name = lsd_ha :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
4 30 PRIMARY COMPATIBLE 1 1 0
(policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 40
Nego_Session_Name = lsd_ha
Transport_Mtu = 3948
Compat_Result: raw_result = COMPATIBLE, policy_result = COMPATIBLE
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Router# show issu negotiated version 40
Session_ID = 40 :
Message_Type = 1, Negotiated_Version = 2, Message_MTU = 8
Next you can enter the same session ID into the following command to display the capability negotiation result:
Verifying the ISSU Process for an MPLS MFI Pull Client Example
This example shows how to verify the ISSU process for an MPLS MFI Pull client.
The first command shows you whether the MFI Pull client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2030
---------------------------------------------------------------------
Client_ID = 2030, Entity_ID = 1 :
*** Session_ID = 131073, Session_Name = MFI Pull (6):
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
7 35 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 131073
Nego_Session_Name = MFI Pull (6)
Transport_Mtu = 4056
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Verifying the ISSU Process for an MPLS MFI Push Client Example
This example shows how to verify the ISSU process for an MPLS MFI Push client.
The first command shows you whether the MFI Push client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2031
---------------------------------------------------------------------
Client_ID = 2031, Entity_ID = 1 :
*** Session_ID = 196646, Session_Name = MFI Push (6):
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
7 36 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 196646
Nego_Session_Name = MFI Push (6)
Transport_Mtu = 4056
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Verifying the ISSU Process for an MPLS LSPV Push Client Example
This example shows how to verify the ISSU process for an MPLS LSVP Push client.
The first command shows you whether the LSPV Push client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2089
---------------------------------------------------------------------
Client_ID = 2089, Entity_ID = 1 :
*** Session_ID = 45, Session_Name = MPLS LSPV Push (6 ):
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
7 36 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 45
Nego_Session_Name = MPLS LSPV Push (6 )
Transport_Mtu = 1438
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Verifying the ISSU Process for an MPLS TE Client Example
This example shows how to verify the ISSU process for an MPLS TE client.
The first command shows you whether the TE client’s old and new software versions are compatible, and therefore are able to make use of the ISSU opportunity:
Router# show issu sessions 2053
---------------------------------------------------------------------
Client_ID = 2053, Entity_ID = 1 :
*** Session_ID = 84, Session_Name = RSVP HA Session :
Peer Peer Negotiate Negotiated Cap Msg Session
UniqueID Sid Role Result GroupID GroupID Signature
22 94 PRIMARY COMPATIBLE 1 1 0
(no policy)
Negotiation Session Info for This Message Session:
Nego_Session_ID = 84
Nego_Session_Name = RSVP HA Session
Transport_Mtu = 1392
Now you can take the session ID displayed in the previous command’s output and enter it into the next command, in order to see the negotiated message version:
Router# show issu negotiated version 84
Session_ID = 84 :
Message_Type = 1, Negotiated_Version = 2, Message_MTU = 1024
Next you can enter the same session ID into the following command to display the capability negotiation result:
Router# show issu negotiated capability 84
Session_ID = 84 :
Cap_Type = 0, Cap_Result = 1 No cap value assigned
Finally to see which message types and versions are supported by this particular client, you enter the client ID into the following command:
No new or modified standards are supported by this feature, and support for existing standards has not been modified by this feature
--
MIBs
MIB
MIBs Link
No new or modified MIBs are supported by this feature, and support for existing MIBs has not been modified by this feature
To locate and download MIBs for selected platforms, Cisco IOS XE software releases, and feature sets, use Cisco MIB Locator found at the following URL:
No new or modified RFCs are supported by this feature, and support for existing RFCs has not been modified by this feature
--
Technical Assistance
Description
Link
The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.
To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.
Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.
The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.
Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to
www.cisco.com/go/cfn. An account on Cisco.com is not required.
Table 2 Feature Information for ISSU MPLS Clients
Feature Name
Releases
Feature Information
ISSU MPLS--LDP
Cisco IOS XE Release 2.1
This feature allows In Service Software Upgrade (ISSU) support for the Label Distribution Protocol (LDP) and Multiprotocol Label Switching (MPLS) Forwarding.
MPLS applications can be upgraded using the In Service Software Upgrade (ISSU) process. Thus, MPLS applications are considered ISSU’s MPLS clients. The ISSU process allows Cisco IOS XE software to be updated or otherwise modified while packet forwarding continues.
In Cisco IOS XE Release 2.1, this feature was introduced on Cisco ASR 1000 Series Aggregation Services Routers.
The following commands were introduced or modified:
showissuclients,showissuentities,showissumessagetypes,showissunegotiated,showissuoutage,showissusessions.
ISSU--MPLS VPN (Support for IPv4 VPNs)
Cisco IOS XE Release 2.1
This feature supports In Service Software Upgrade (ISSU) for Multiprotocol Label Switching (MPLS) Virtual Private networks (VPNs) for IPv4 address families only.
In Cisco IOS XE Release 2.1, this feature was introduced on Cisco ASR 1000 Series Aggregation Services Routers.
No commands were introduced or modified for this feature.
ISSU--MPLS TE
Cisco IOS XE Release 2.3
This feature allows upgrade or downgrade of compatible Cisco IOS XE software images on the back up Route Processor (RP) while the device is operational and passing traffic on Multiprotocol Label Switching (MPLS) traffic engineering (TE) tunnels.
In Cisco IOS XE Release 2.3, this feature was introduced on Cisco ASR 1000 Series Aggregation Services Routers.
No commands were introduced or modified for this feature.