Cisco IOS IP Routing: LISP Command Reference
LISP Clear Commands
Downloads: This chapterpdf (PDF - 1.35MB) The complete bookPDF (PDF - 4.0MB) | The complete bookePub (ePub - 462.0KB) | Feedback

LISP Clear Commands

LISP Clear Commands

clear ip lisp map-cache

To clear the Locator/ID Separation Protocol (LISP) map cache, use the clear ip lisp map-cache command in privilege EXEC mode.

clear ip lisp map-cache [ EID-prefix/prefix-length ]

Syntax Description

EID-prefix/prefix-length

(Optional) IPv4 endpoint identifier (EID) prefix to clear from LISP map cache

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)XB

This command was introduced.

Cisco IOS XE Release XA

This command was integrated into Cisco IOS XE Release 2.5.1XA.

Cisco IOS XE Release 3.3.0S

This command was integrated into Cisco IOS XE Release 3.3.0S.

15.1(4)M

This command was integrated into Cisco IOS Release15.1(4)M.

Usage Guidelines

The clear ip lisp map-cache command removes all IPv4 dynamic LISP map-cache entries stored by the router. When an optional IPv4 EID prefix is added to the command, only that IPv4 EID prefix is cleared from the LISP map-cache.

Examples

The following example shows how to display all LISP map-cache entries and then clear the LISP map cache for the IPv4 EID prefix 172.16.10.0/24.

Router# show ip lisp map-cache
LISP IPv4 Mapping Cache, 2 entries
0.0.0.0/0, uptime: 01:18:22, expires: never, via static
153.16.10.0/24, uptime: 00:00:04, expires: 23:59:55, via map-reply, complete
Locator                     Uptime    State      Pri/Wgt
172.16.10.0/24              00:00:04  up           1/50
192.168.65.94               00:00:04  up           1/50
2001:468:D01:9C::80DF:9C86  00:00:04  up           2/100
Router# clear ip lisp map-cache 172.16.10.0/24
Router# show ip lisp map-cache
LISP IPv4 Mapping Cache, 1 entries
0.0.0.0/0, uptime: 01:18:42, expires: never, via static
Router#

Related Commands

Command

Description

show ip lisp map-cache

Displays current dynamic and static IPv4 EID-to-RLOC map-cache entries.

clear ip lisp route-import

To clear the current IPv4 routing information base (RIB) routes imported into Locator ID Separation Protocol (LISP), use the clear ip lisp route-import command in privilege EXEC mode.

clear ip lisp route-import [ eid-table vrf vrf-name | instance-id iid ]

Syntax Description

eid-table vrf vrf-name

(Optional) Clear the referenced EID table.

instance-id iid

(Optional) Clears the referenced instance ID.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(4)XB5

This command was introduced.

15.2(3)T

This command was integrated into Cisco IOS Release 15.2(3)T.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Usage Guidelines

The clear ip lisp route-import command operates differently from other clear commands. Most clear commands remove the respective entries or counters only.

However, when the clear ip lisp route-import command is entered, all route-import routes are marked stale and then re-evaluated according to the ip lisp route-import command and remaining stale routes are removed. Thus, entering the clear ip lisp route-import command may or may not result in changes to the imported routes. The show ip lisp route-import command provides a listing of the current route imports.

To restrict the clear functions to a specific EID table, use the eid-table vrf vrf-name keyword and argument. To restrict the clear functions to a specific LISP instance ID, use the instance-id iid keyword and argument.

Examples

The following example shows all IPv4 LISP route-import entries using the show ip lisp route-import command and then clears the IPv4 LISP route-import entries. The debug lisp control-plane rib-rloc-watch command is enabled to indicate the effect of using the clear ip lisp route-import command.

Router# debug lisp control-plane rib-rloc-watch
LISP control plane RIB RLOC watch debugging is on
Router# show ip lisp route-import
LISP IPv4 imported routes for EID-table default (IID 0)
Config: 1, Entries: 4
Prefix         Uptime     Source    Map-cache   State
10.0.1.0/24    00:07:49   static 		 installed
10.0.2.0/24    00:07:49   static 		 installed
10.0.3.0/24    00:07:49   static 		 installed
10.0.4.0/24    00:07:49   static 		 installed
Router# clear ip lisp route-import
*Jun 27 21:42:12.215: LISP: AF IPv4, rtimp re-eval marking stale.
*Jun 27 21:42:12.215: LISP: AF IPv4, rtimp re-eval walking rib.
*Jun 27 21:42:12.215: LISP: AF IPv4, rtimp re-eval delete stale.
*Jun 27 21:42:12.215: LISP: AF IPv4, rtimp re-eval done.
Router# show ip lisp route-import
LISP IPv4 imported routes for EID-table default (IID 0)
Config: 1, Entries: 4
Prefix 														Uptime 		  Source 		Map-cache 		State
10.0.1.0/24 									00:08:20   static 		installed
10.0.2.0/24 									00:08:20   static 		installed
10.0.3.0/24 									00:08:20   static 		installed
10.0.4.0/24									 00:08:20   static 		installed
Router#  

In this example, when clear ip lisp route-import is entered, all route-import routes are marked stale and then re-evaluated according to the ip lisp route-import command and remaining stale routes removed, as displayed in the debug output.

Related Commands

Command

Description

clear ip lisp map-cache

Clears the LISP map cache.

debug lisp control-plane rib-rloc-watch

Displays messages related to the up/down local/remote status of local locators in the RIB.

show ip lisp map-cache

Displays the current dynamic and static IPv4 EID-to-RLOC map-cache entries.

show ip lisp route-import

Displays the current IPv4 RIB routes imported into LISP.

clear ip lisp statistics

To clear Locator/ID Separation Protocol (LISP) Ingress Tunnel Router (ITR) andEgress Tunnel Router (ETR) IPv4 address-family packet count statistics, use the clear ip lisp statistics command in privilege EXEC mode.

clear ip lisp statistics

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)XB1

This command was introduced.

Cisco IOS XE Release 2.5.1XA

This command was integrated into Cisco IOS XE Release 2.5.1XA.

Cisco IOS XE Release 3.3.0S

This command was integrated into Cisco IOS XE Release 3.3.0S.

15.1(4)M

This command was integrated into Cisco IOS Release 15.1(4)M.

Usage Guidelines

The clear ip lisp statistics command clears all of the LISP ITR and ETR IPv4 address-family packet count statistics. IPv4 address family packet count statistics are maintained for all LISP control plane packets. These packet counters are displayed using the show ip lisp statistics command.

Examples

The following example shows how to display all IPv4 LISP control plane statistics (packet counters) and then clears these statistics.

Router# show ip lisp statistics
LISP Statistics - last cleared: never
Control Packets:
  Map-Requests in/out:                      2451/2184
    Encapsulated Map-Requests in/out:       2428/1156
    RLOC-probe Map-Requests in/out:         23/1028
  Map-Reply records in/out:                 2183/2428
    Authoritative records in/out:           1035/2428
---<skip>---
Router# clear ip lisp statistics
Router# show ip lisp statistics
LISP Statistics - last cleared: 00:00:06
Control Packets:
  Map-Requests in/out:                      0/0
    Encapsulated Map-Requests in/out:       0/0
    RLOC-probe Map-Requests in/out:         0/0
  Map-Reply records in/out:                 0/0
    Authoritative records in/out:           0/0
---<skip>---
Router#

Related Commands

Command

Description

show ip lisp statistics

Displays LISP IPv4 address-family statistics.

clear ipv6 lisp map-cache

To clear the Locator/ID Separation Protocol (LISP) map cache, use the clear ipv6 lisp map-cache command in privilege EXEC mode.

clear ipv6 lisp map-cache [ EID-prefix/prefix-length ]

Syntax Description

EID-prefix/prefix-length

(Optional) IPv6 endpoint identifier (EID) prefix to clear from the LISP map-cache.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)XB1

This command was introduced.

Cisco IOS XE Release 2.5.1XA

This command was integrated into Cisco IOS XE Release 2.5.1XA.

Cisco IOS XE Release 3.3.0S

This command was integrated into Cisco IOS XE Release 3.3.0S.

15.1(4)M

This command was integrated into Cisco IOS Release 15.1(4)M.

Usage Guidelines

The clear ipv6 lisp map-cache command removes all IPv6 dynamic LISP map-cache entries stored by the router. When an optional IPv6 EID prefix is added to the command, only that IPv6 EID prefix is cleared from the LISP map cache.

Examples

The following example shows how to display all LISP map-cache entries and then clears the LISP map cache for the IPv6 EID prefix 2610:D0:2104::/48.

Router# show ipv6 lisp map-cache
::/0, uptime: 00:23:36, expires: never, via static
  Negative cache entry, action: send-map-request
2001:DB8:AB::/48, uptime: 00:06:52, expires: 23:55:32, via map-reply, complete
  Locator   Uptime    State      Pri/Wgt
  10.0.0.6  00:18:02  up           1/100
Router# clear ipv6 lisp map-cache 2001:DB8:AB::/48
Router# show ipv6 lisp map-cache
LISP IPv6 Mapping Cache, 1 entries
::/0, uptime: 00:24:13, expires: never, via static
  Negative cache entry, action: send-map-request
Router#

Related Commands

Command

Description

show ipv6 lisp map-cache

Displays the current dynamic and static IPv6 EID-to-RLOC map-cache entries.

clear ipv6 lisp statistics

To clear Locator/ID Separation Protocol (LISP) Ingress Tunnel Router (ITR) and Egress Tunnel Router (ETR) IPv6 address-family packet count statistics, use the clear ipv6 lisp statistics command in privilege EXEC mode.

clear ipv6 lisp statistics

Syntax Description

This command has no arguments or keywords.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)XB1

This command was introduced.

Cisco IOS XE Release 2.5.1XA

This command was integrated into Cisco IOS XE Release 2.5.1XA.

Cisco IOS XE Release 3.3.0S

This command was integrated into Cisco IOS XE Release 3.3.0S.

15.1(4)M

This command was integrated into Cisco IOS Release 15.1(4)M.

Usage Guidelines

The clear ipv6 lisp statistics command clears the LISP ITR and ETR IPv6 address-family packet count statistics. IPv6 address family packet count statistics are maintained for all LISP control plane packets. These packet counters are displayed using the show ipv6 lisp statistics command.

Examples

The following example shows how to display all IPv6 LISP control plane statistics (packet counters), and then clears these statistics.

Router# show ipv6 lisp statistics
LISP Statistics - last cleared: never
Control Packets:
  Map-Requests in/out:                      6/27
    Encapsulated Map-Requests in/out:       6/2
    RLOC-probe Map-Requests in/out:         0/25
  Map-Reply records in/out:                 24/29
    Authoritative records in/out:           24/29
---<skip>---
Router# clear ipv6 lisp statistics
Router# show ipv6 lisp statistics
LISP Statistics - last cleared: 00:00:02
Control Packets:
  Map-Requests in/out:                      0/0
    Encapsulated Map-Requests in/out:       0/0
    RLOC-probe Map-Requests in/out:         0/0
  Map-Reply records in/out:                 0/0
    Authoritative records in/out:           0/0
---<skip>---
Router#

Related Commands

Command

Description

show ipv6 lisp statistics

Displays LISP IPv6 address-family statistics.

clear ipv6 lisp route-import

To clear the current IPv6 routing information base (RIB) routes imported into Locator ID Separation Protocol (LISP), use the clear ipv6 lisp route-import command in privilege EXEC mode.

clear ipv6 lisp route-import [ eid-table vrf vrf-name | instance-id iid ]

Syntax Description

eid-table vrf vrf-name

(Optional) Clears the referenced EID table.

instance-id iid

(Optional) Clears the referenced instance ID.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(4)XB5

This command was introduced.

15.2(3)T

This command was integrated into Cisco IOS Release 15.2(3)T.

Cisco IOS XE Release 3.6S

This command was integrated into Cisco IOS XE Release 3.6S.

Usage Guidelines

The clear ipv6 lisp route-import command operates differently from other clear commands.

However, when the clear ipv6 lisp route-import command is entered, all route-import routes are marked stale, then re-evaluated according to the ipv6 lisproute-import command, and remaining stale routes removed. Thus, entering clear ipv6 lisp route-import command may or may not result in changes to the imported routes. The show ipv6 lisp route-import command provides a listing of the current route imports.

To restrict the clear functions to a specific EID table, use the eid-table vrf vrf-name keyword and argument. To restrict the clear functions to a specific LISP instance ID, use the instance-id iid keyword and argument.

Examples

The following example shows all IPv6 LISP route-import entries using the show ipv6 lisp route-import command and then clears the IPv6 LISP route-import entries. The debug lisp control-plane rib-rloc-watch command is enabled to indicate the affect of using the clear ipv6 lisp route-import command.

Router# debug lisp control-plane rib-rloc-watch
LISP control plane RIB RLOC watch debugging is on
Router# show ipv6 lisp route-import
LISP IPv6 imported routes for EID-table default (IID 0)
Config: 1, Entries: 2
Prefix 																							Uptime 			  Source 		Map-cache 		State
2001:DB8:B::/48               02:13:53    static 		installed
2001:DB8:C::/48               02:13:53    static 		installed
Router# clear ipv6 lisp route-import
*Jun 27 23:50:02.911: LISP: AF IPv6, rtimp re-eval marking stale.
*Jun 27 23:50:02.911: LISP: AF IPv6, rtimp re-eval walking rib.
*Jun 27 23:50:02.911: LISP: AF IPv6, rtimp re-eval delete stale.
*Jun 27 23:50:02.911: LISP: AF IPv6, rtimp re-eval done.
Router# show ipv6 lisp route-import
LISP IPv6 imported routes for EID-table default (IID 0)
Config: 1, Entries: 2
Prefix 																							Uptime 			  Source 		Map-cache 		State
2001:DB8:B::/48 														02:14:05 	  static 		installed
2001:DB8:C::/48 														02:14:05 	  static 		installed
Router#

In this example, when clear ipv6 lisp route-import is entered, all route-import routes are marked stale and then re-evaluated according to the ipv6 lisp route-import command and remaining stale routes are removed, as displayed in the debug output.

Related Commands

Command

Description

clear ipv6 lisp map-cache

Clears the LISP map cache.

debug lisp control-plane rib-rloc-watch

Displays messages related to the up/down local/remote status of local locators in the RIB.

show ipv6 lisp map-cache

Displays the current dynamic and static IPv6 EID-to-RLOC map-cache entries.

show ipv6 lisp route-import

Displays the current IPv6 RIB routes imported into LISP.

clear lisp ddt

To clear the DDT referral cache that is stored on a DDT-enabled map resolver, use the clear lisp ddt command in privileged EXEC mode.

clear lisp ddt referral-cache [ instance-id iid | eid | statistics ]

Syntax Description

referral-cache

Clears the DDT referral cache contents.

instance-ID iid

(Optional) Displays the DDT referral cache related to this single instance ID.

eid

(Optional) Displays the DDT referral cache related to this single Endpoint ID (EID).

statistics

(Optional) Clears use statistics without deleting cache entries.

Command Modes

Privileged EXEC (#)

Command History

Release Modification

15.3(1)T

This command was introduced.

Cisco IOS XE Release 3.8S

This command was integrated into Cisco IOS XE Release 3.8S.

Usage Guidelines

Use this command to clear the referral cache on a DDT map resolver.

A DDT map resolver uses an iterative process of following referrals to find the correct ETR to answer a map request; this requires a DDT map resolver to maintain additional state: a map-referral cache and a lookup queue of map requests that are going through the iterative referral process. The clear lisp ddt command clears the contents of the map-referral cache.

When the clear lisp ddt command is specified using the optional eid entry, the single referral cache entry eid is removed.

When the clear lisp ddt command is specified using the optional instance-id iid keyword, all referral cache entries related to that instance ID are removed. When the clear lisp ddt command is specified using the optional instance-id iid keyword, the single referral cache entry eid within instance-id iid is removed.

Examples

The following example clears the LISP DDT referral cache using the clear lisp ddt command, and then displays the output of show lisp ddt command:

Device> enable
Device# clear lisp ddt referral-cache
Device# show lisp ddt referral-cache
LISP-DDT Referral Cache in VRF "default", 0 entries

Related Commands

Command

Description

ddt

Configures a device to enable LISP DDT functionality.

show lisp ddt

Displays the configured LISP DDT root(s) and/or DDT delegation nodes on a device enabled for LISP DDT.

clear lisp site

To clear the registration data for the specified Locator/ID Separation Protocol (LISP) site, use the clear lisp site command in privilege EXEC mode

clear lisp site { EID-prefix /prefix-length | site-name }

Syntax Description

EID-prefix/prefix-length

IPv4 or IPv6 endpoint identifier (EID) prefix configured on any site for the LISP to clear.

site-name

LISP site for which registration data is to be cleared.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.1(1)XB2

This command was introduced.

Cisco IOS XE Release 2.5.1XB

This command was integrated into Cisco IOS XE Release 2.5.1XB.

Cisco IOS XE Release 3.3.0S

This command was integrated into Cisco IOS XE Release 3.3.0S

15.1(4)M

This command was integrated into Cisco IOS Release 15.1(4)M

Usage Guidelines

On a LISP Map-Server only, the clear lisp site command clears the registration data for the specified LISP site. When the EID-prefix argument in the command, the EID-prefix registration data is cleared from the site containing that EID prefix. If the site is active, the EID prefix will return when the site next registers. When the site-name form of the command is used, all site-specific registration information for the specified site is cleared. If the site is active, the entire site will return when the site next registers.

The registration status of LISP sites is displayed using the show lisp site command.

Examples

The following example shows how to clear the LISP registration data for the LISP site called Site1-xtr.

Map-Server# show lisp site name site1-xtr
Site name: site1-xtr
Description: LISP Site 1
Allowed configured locators: any
Allowed EID-prefixes:
  EID-prefix: 192.168.1.0/24
    First registered:     00:05:22
---<skip>---
Map-Server# clear lisp site site1-xtr
Map-Server# show lisp site name site1-xtr
Site name: site1-xtr
Description: LISP Site 1
Allowed configured locators: any
Allowed EID-prefixes:
  EID-prefix: 192.168.1.0/24
    First registered:     00:05:45
    Routing table tag:    0x0
    No registrations.
  EID-prefix: 2001:DB8:A::/48
    First registered:     00:44:13
    Routing table tag:    0x0
    No registrations.
Map-Server#

Related Commands

Command

Description

show lisp site

Displays LISP site information.

clear lisp vrf

To clear a Locator/ID Separation Protocol (LISP) reliable TCP transport session between an xTR and a Map-Server, use the clear lisp vrf command in privileged EXEC mode.

clear lisp vrf vrf-name session { peer-address | *}

Syntax Description

vrf-name

VRF instance.

The transport session information for this VRF instance will be cleared.

session

Specifies that the reliable transport session for either the specified peer address or all transport sessions be cleared, based on your choice.

peer-address

IPv4 or IPv6 peer address.

When you specify a peer-address, the TCP connection to the peer will be cleared.

*

Clears all LISP reliable transport sessions.

When you choose this option, all transport sessions are cleared.

Command Modes

Privileged EXEC (#)

Command History

Release

Modification

15.5(1)T

This command was introduced.

Cisco IOS XE Release 3.14S

This command was integrated into Cisco IOS XE Release 3.14S.

Examples

The following example shows how to clear all reliable TCP transport sessions using the * option:

Device# clear lisp vrf v1 session * 

Related Commands

Command

Description

show lisp vrf

Displays transport session information for a LISP VRF instance.