Cisco IOS XR Routing Command Reference for the Cisco CRS Router, Release 4.2.x
LISP Commands on Cisco IOS XR Software
Downloads: This chapterpdf (PDF - 1.24MB) The complete bookPDF (PDF - 13.04MB) | Feedback

LISP Commands on Cisco IOS XR Software

LISP Commands on Cisco IOS XR Software

This module describes the commands used to configure and monitor Locator/ID Separation Protocol (LISP) on Cisco IOS XR.

Locator/ID Separation Protocol on Cisco IOS XR

Locator/ID Separation Protocol (LISP) is a simple, incremental, network-based protocol designed to implement separation of Internet addresses into Endpoint Identifiers (EIDs) and Routing Locators (RLOCs).

LISP stands for Locator/ID Separation Protocol and is a next-generation IP routing feature that creates a new paradigm in how IP addressing is assigned and interpreted by splitting the device identity, known as an endpoint identifier (EID), and its location, known as its routing locator (RLOC), into two different namespaces. Creating separate IP addresses for EID and RLOC functions yields several advantages, including improved scalability of the routing system through greater aggregation of RLOCs and improved multihoming efficiency and ingress traffic engineering. Hosts do not have to change IP addresses and therefore, no IP address numbering costs are involved with the LISP implementation.

LISP sites use IP addresses in the EID namespace to address hosts and in Domain Name System (DNS) in exactly the same way they are currently used. These addresses are not advertised within the non-LISP RLOC namespace (that is, the Internet), but instead are advertised by the LISP mapping services. The LISP site router supports the LISP functionality of Ingress Tunnel Router (ITR) and Egress Tunnel Router (ETR).

LISP is a pull model analogous to DNS and is massively scalable. LISP is address family agnostic and can be deployed incrementally.

LISP creates a Level of indirection with two namespaces: EID and RLOC. The EID (Endpoint Identifier) is the IP address of a host. The RLOC (Routing Locator) is the IP address of the LISP router for the host. EID-to-RLOC mapping is the distributed architecture that maps EIDs to RLOCs. The LISP Map Lookup is analogous to a DNS lookup. DNS resolves IP addresses for URLs. LISP resolves locators for queried identifiers or EID prefix.

LISP in Cisco IOS XR supports:
  • Proxy Ingress Tunnel Router (PITR) and Proxy Egress Tunnel Router (PETR). PITR must be configured using map resolver (no ALT support).
  • Default table support for EID and RLOC space.
  • CRS-3 hardware supports IPv4 over IPv4 and IPv6 over IPv4 topologies.
  • The router lisp command in global configuration mode enables LISP configuration mode.

Note


The LISP command line interface, show commands output, and schema is to be changed in Cisco IOS XR Release 4.3.1 to be similar to the LISP command line interface on Cisco IOS.


address-family (LISP)

To enter Locator ID and separation protocol (LISP) address family configuration mode, use the address-family command in LISP configuration mode. To exit the LISP address family configuration mode, use the no form of this command.

address-family { ipv4 | ipv6 } unicast

no address-family { ipv4 | ipv6 } unicast

Syntax Description

ipv4

Selects IPv4 address family.

ipv6

Select IPv6 address family.

unicast

Selects unicast address prefixes.

Command Default

LISP address family configuration is disabled.

Command Modes

LISP configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example shows how to enable IPv6 address family configuration for LISP:

RP/0/RP0/CPU0:router#configure 
RP/0/RP0/CPU0:router(config)#router lisp 
RP/0/RP0/CPU0:router(config-lisp)#address-family ipv6 unicast 
RP/0/RP0/CPU0:router(config-lisp-afi)#

Related Commands

Command

Description

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

itr map-resolver

To configure an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR, when sending Map-Requests for IPv4 EID-to-RLOC mapping resolution, use the itr map-resolver command in LISP address family configuration mode. To remove the configured locator address of the LISP Map-Resolver, use the no form of this command.

itr map-resolver map-resolver-address

no itr map-resolver map-resolver-address

Syntax Description

map-resolver-address

Specifies the IPv4 or IPv6 locator addresses of the Map-Resolver.

Command Default

No LISP Map-Resolver locator address is configured.

Command Modes

LISP IPv4  address family configuration

LISP IPv6 address family configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example configures an ITR to use the Map-Resolver located at 10.2.3.4 when sending its Map- Request messages:

RP/0/RP0/CPU0:P1_CRS-8#configure
RP/0/RP0/CPU0:P1_CRS-8(config)#router lisp
RP/0/RP0/CPU0:P1_CRS-8(config-lisp)#address-family ipv6 unicast 
RP/0/RP0/CPU0:P1_CRS-8(config-lisp-afi)#itr map-resolver 10.2.3.4

This example configures and ITR to use the Map-Resolver located at 2001:DB8:0A::1 when sending its Map-Request messages:

RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router lisp
RP/0/RP0/CPU0:router(config-lisp)#address-family ipv6 unicast 
RP/0/RP0/CPU0:router(config-lisp-afi)#itr map-resolver 2001:DB8:0A::1

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

loc-reach-algorithm rloc-probing

To configure locator reachability algorithm, RLOC Probing, and to determine reachability status for other iBGP peers through the IGP domain, use the loc-reach-algorithm rloc-probing command in LISP configuration mode. To disable the locator reachability algorithm, use the no form of this command .

loc-reach-algorithm rloc-probing

no loc-reach-algorithm rloc-probing

Syntax Description

This command has no keywords or arguments.

Command Default

The locator reachability algorithm rloc-probing is disabled.

Command Modes

LISP configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example shows how to configure the location reachability algorithm RLOC probing:

RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router lisp
RP/0/RP0/CPU0:router(config-lisp)#loc-reach-algorithm rloc-probing

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

map-cache-limit

To configure the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router, use the map-cache-limit command in LISP address family configuration mode. To remove the configured map-cache limit, use the no form of this command.

map-cache-limit map-cache-size

no map-cache-limit map-cache-size

Syntax Description

map-cache-size

Specifies the map cache size value. Range is 1 to 65535.

Command Default

Map cache size: 1000

Command Modes

LISP IPv4 address family

LISP IPv6 address family

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example configures a lisp cache-limit of 2000 entries:

RP/0/RP0/CPU0:router(config-lisp-afi)#map-cache-limit 2000

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

map-cache

To configure a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or to statically configure the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix, use the map-cache command in LISP address family configuration mode. To remove the configuration, use the no form of this command.

map-cache destination-EID-prefix / prefix-length { action { drop | map-request | native-forward } | locator locator-address priority priority-value weight weight-value }

no map-cache destination-EID-prefix / prefix-length { action { drop | map-request | native-forward } | locator locator-address priority priority-value weight weight-value }

Syntax Description

destination-EID-prefix / prefix-length

Specifies the destination IPv4/IPv6 EID-prefix/prefix-length.

action

Specifies the non LISP forwarding action for the EID prefix.

drop

Selects drop action for the EID-prefix.

map-request

Generates a map-request for the EID-prefix.

native-forward

Specifies to natively forward EID-prefix.

locator locator-address

The IPv4 or IPv6 Routing Locator (RLOC) associated with the EID-prefix/prefix-length.

priority priority-value

The priority (value between 0 and 255) assigned to the RLOC. When multiple locators have the same priority they may be used in load-shared fashion. A lower value indicates a higher priority.

weight weight-value

The weight (value between 0 and 100) assigned to the locator. Used in order to determine how to load-share traffic between multiple locators when the priorities assigned to multiple locators are the same. The value represents the percentage of traffic to be load-shared.

Command Default

No IPv6 EID-to-RLOC mapping relationships or static IPv6 EID-to-RLOC mapping destinations are configured.

Command Modes

LISP IPv4 address family

LISP IPv6 address family

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

configures a destination EID-to-RLOC mapping and associated traffic policy for the IPv6 EID-prefix block 2001:DB8:BB::/48. The locator for this EID-prefix block is 2001:DB8:0A::1 and the traffic policy for this locator has a priority of 1 and a weight of 100.

RP/0/RP0/CPU0:router#configure 
RP/0/RP0/CPU0:router(config)#router lisp 
RP/0/RP0/CPU0:router(config-lisp)#address-family ipv6 unicast 
RP/0/RP0/CPU0:router(config-lisp-afi)#map-cache
RP/0/RP0/CPU0:router(config-lisp-afi-map-cache)#2001:db8:bb::/48 locator 2001:db8:a::1 priority 1 weight 100

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

proxy-etr

To configure a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR), use the proxy-etr command in LISP address family configuration mode. To remove LISP PETR functionality, use the no form of this command.

proxy-etr

no proxy-etr

This command has no keywords or arguments.

Command Default

ETR functionality is disabled.

Command Modes

LISP IPv4 address family

LISP IPv6 address family

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example shows how to configure PETR functionality under LISP IPv6 on the router:

RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router lisp
RP/0/RP0/CPU0:router(config-lisp)#address-family ipv6 unicast 
RP/0/RP0/CPU0:router(config-lisp-afi)#proxy-etr

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

proxy-itr

To configure a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR), use the proxy-itr command in LISP address family configuration mode. To remove LISP PITR functionality, use the no form of this command.

proxy-itr IPv4-source-locator-address

noproxy-itr IPv4-source-locator-address

Syntax Description

IPv4-source-locator-address

Specifies the IPv4 source locator for PITR.

Command Default

PITR functionality is disabled.

Command Modes

LISP IPv4 address family

LISP IPv6 address family

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

lisp

read, write

Examples

This example shows how to configure LISP PITR functionality on the router:

RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router lisp
RP/0/RP0/CPU0:router(config-lisp)#address-family ipv6 unicast
RP/0/RP0/CPU0:router(config-lisp-afi)#proxy-itr 10.2.3.4

 

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

router lisp

Enters Locator and ID Separation Protocol (LISP) configuration mode.  

router lisp

To enter Locator and ID Separation Protocol (LISP) configuration mode, use the router lisp command in global configuration mode. To remove all LISP configurations and exit the LISP configuration mode, use the no form of this command.

router lisp

no router lisp

Syntax Description

This command has no keywords or arguments.

Command Default

LISP configuration is disabled.

Command Modes

Global configuration

Command History

Release Modification

Release 4.2.1

This command was introduced.

Usage Guidelines

To use this command, you must be in a user group associated with a task group that includes appropriate task IDs. If the user group assignment is preventing you from using a command, contact your AAA administrator for assistance.

Task ID

Task ID Operation

bgp

read, write

ospf

read, write

hsrp

read, write

isis

read, write

Examples

This example shows how to configure LISP configuration mode:

RP/0/RP0/CPU0:router#configure
RP/0/RP0/CPU0:router(config)#router lisp
RP/0/RP0/CPU0:router(config-lisp)#

Related Commands

Command

Description

address-family (LISP)

Enters Locator ID and separation protocol (LISP) address family configuration mode.  

itr map-resolver

Configures an IPv4 or IPv6 locator address of the LISP Map-Resolver to be used by the ITR.  

loc-reach-algorithm rloc-probing

Configures locator reachability algorithm, RLOC Probing, and determines reachability status for other iBGP peers through the IGP domain.  

map-cache-limit

Configures the maximum limit of IPv4 LISP or IPv6 LISP map-cache entries allowed to be stored by the router.  

map-cache

Configures a static IPv4 EID-to-RLOC or static IPv6 EID-to-RLOC mapping relationship and its associated traffic policy, or statically configures the packet handling behavior associated with a destination IPv4 EID-prefix or a destination IPv6 EID-prefix.  

proxy-etr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Egress Tunnel Router (PETR).  

proxy-itr

Configures a router to act as an IPv4 or IPv6 LISP Proxy Ingress Tunnel Router (PITR).