Skip to content

Command line_Interface_CLI_Guide

Jump to bottom
Dave Wallace edited this page Apr 11, 2026 · 1 revision

Introduction

The vpp contain a set of commands to set and debug LISP. Access VPP's CLI over telnet, assuming cli-listen localhost:5002 is configured under unix{} in the startup.conf, with:


telnet 0 5002

Telnet LISP CLI a.k.a debug CLI

Following is a list of CLI commands used by LISP.

Enabling LISP

For turning on LISP functionality type:


vpp# lisp enable

...and this will disable LISP


vpp# lisp disable

To display LISP status use


vat# show lisp status
feature: enabled
gpe: enabled

where 'feature' field show status of LISP - both control plane and dataplane. 'gpe' is dataplane status indicator which can be enabled/disabled with its own set of commands:


vat# lisp gpe enable
vat# lisp gpe disable

Locator set

To add new locator set and assigning locator(s) to it use "lisp locator-set add":


vpp# lisp locator-set add ls1 iface host-intervpp1 p 1 w 1

Where p is priority and w is weight .

To delete a specific locator set, use "lisp locator-set del"


vpp# lisp locator-set del ls1

To display current locator sets and their locators:


vpp# show lisp locator-set
     Locator-set         Locator        Priority         Weight
     ls1                      6               1               1

Locator

To extend existing locator set with a new locator use "lisp locator add":


vpp# lisp locator add locator-set ls1 iface host-intervpp1 p 1 w 1

Where locator-set is locator-set name , p is priority and w is weight .

To delete a specific locator set, use "lisp locator del"


vpp# lisp locator-set del locator-set ls1 iface host-intervpp1 p 1 w 1

Manipulating EID table

EID table contains mappings between EIDs and a locator sets. For adding an entry use following command:


vpp# lisp eid-table add eid 6.0.1.0/24 locator-set ls1

Currently an EID can be IPv4, IPv6 or MAC address.

To delete a specific entry from EID table use "lisp eid-table del"


vpp# lisp eid-table del eid 6.0.1.0/24

To list EID table use show lisp eid-table [local|remote] [eid ]


DBGvpp# show lisp eid-table
EID                      type           locators            ttl       autoritative
[0] 6.0.2.0/24           local(ls1)     host-xtr_rtr1       0         0

It is also possible to specify a filter that will output only local or remote EID entries. You can also specify a EID entry that prints only info about it if found.

Map resolver

To add new map resolver, use "lisp map-resolver":


vpp# lisp map-resolver add 6.0.3.100

To delete a specific map resolver address, use "lisp map-resolver del":


vpp# lisp map-resolver del 6.0.3.100

Proxy-ITR (PITR)

VPP can be used as a proxy ITR by specifying a locator set:


vpp# lisp pitr ls ls1

Where ls is locator-set name .

To disable PITR use:


vpp# lisp pitr disable ls ls1

Following command tells if VPP is in PITR mode. If yes it also shows the name of locator set.


vpp# show lisp pitr
     pitr
    disable

Remote mapping

This command provides a way to configure remote mappings programmed statically without a need of a map resolver. To add new remote mapping use "lisp remote-mapping add":


vpp# lisp remote-mapping add vni 0 eid 6.2.1.0/24 rloc 6.0.1.1

Where vni is Virtual Network Identifier , eid is eid prefix and rloc is remote locator

To disable remote mapping, use "lisp remote-mapping del":


vpp# lisp remote-mapping del vni 0 eid 6.2.1.0/24

Clone this wiki locally