Difference between revisions of "ONE/Command-line Interface CLI Guide"
(→Telnet LISP CLI) |
|||
| Line 6: | Line 6: | ||
</pre> | </pre> | ||
| − | == Telnet LISP CLI == | + | == 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: | |
<pre> | <pre> | ||
| − | vpp# lisp | + | vpp# lisp enable |
</pre> | </pre> | ||
| − | + | ...and this will disable LISP | |
<pre> | <pre> | ||
| − | vpp# lisp | + | vpp# lisp disable |
</pre> | </pre> | ||
| − | To display | + | To display LISP status use |
<pre> | <pre> | ||
vat# show lisp status | vat# show lisp status | ||
feature: enabled | feature: enabled | ||
gpe: enabled | gpe: enabled | ||
| + | </pre> | ||
| + | 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: | ||
| + | <pre> | ||
| + | vat# lisp gpe enable | ||
| + | vat# lisp gpe disable | ||
</pre> | </pre> | ||
| − | === | + | === Locator set === |
| − | To add new | + | To add new locator set and assigning locator(s) to it use "lisp locator-set add": |
<pre> | <pre> | ||
vpp# lisp locator-set add ls1 iface host-intervpp1 p 1 w 1 | vpp# lisp locator-set add ls1 iface host-intervpp1 p 1 w 1 | ||
| Line 33: | Line 39: | ||
Where <tt>p</tt> is <tt>priority</tt> and <tt>w</tt> is <tt>weight</tt>. | Where <tt>p</tt> is <tt>priority</tt> and <tt>w</tt> is <tt>weight</tt>. | ||
| − | To delete a specific | + | To delete a specific locator set, use "lisp locator-set del" |
<pre> | <pre> | ||
vpp# lisp locator-set del ls1 | vpp# lisp locator-set del ls1 | ||
</pre> | </pre> | ||
| − | To display | + | To display current locator sets and their locators: |
<pre> | <pre> | ||
vpp# show lisp locator-set | vpp# show lisp locator-set | ||
| Line 46: | Line 52: | ||
=== Locator === | === Locator === | ||
| − | To | + | To extend existing locator set with a new locator use "lisp locator add": |
<pre> | <pre> | ||
vpp# lisp locator add locator-set ls1 iface host-intervpp1 p 1 w 1 | vpp# lisp locator add locator-set ls1 iface host-intervpp1 p 1 w 1 | ||
| Line 52: | Line 58: | ||
Where <tt>locator-set</tt> is <tt>locator-set name</tt>, <tt>p</tt> is <tt>priority</tt> and <tt>w</tt> is <tt>weight</tt>. | Where <tt>locator-set</tt> is <tt>locator-set name</tt>, <tt>p</tt> is <tt>priority</tt> and <tt>w</tt> is <tt>weight</tt>. | ||
| − | To delete a specific | + | To delete a specific locator set, use "lisp locator del" |
<pre> | <pre> | ||
vpp# lisp locator-set del locator-set ls1 iface host-intervpp1 p 1 w 1 | vpp# lisp locator-set del locator-set ls1 iface host-intervpp1 p 1 w 1 | ||
</pre> | </pre> | ||
| − | === | + | === Manipulating EID table === |
| − | + | EID table contains mappings between EIDs and a locator sets. For adding an entry use following command: | |
<pre> | <pre> | ||
vpp# lisp eid-table add eid 6.0.1.0/24 locator-set ls1 | vpp# lisp eid-table add eid 6.0.1.0/24 locator-set ls1 | ||
</pre> | </pre> | ||
| + | Currently an EID can be IPv4, IPv6 or MAC address. | ||
| − | To delete a specific | + | To delete a specific entry from EID table use "lisp eid-table del" |
<pre> | <pre> | ||
| − | vpp# lisp eid-table del eid 6.0.1.0/24 | + | vpp# lisp eid-table del eid 6.0.1.0/24 |
</pre> | </pre> | ||
| − | To | + | To list EID table use <tt>show lisp eid-table [local|remote] [eid <eid>]</tt> |
<pre> | <pre> | ||
| − | + | DBGvpp# show lisp eid-table | |
| − | + | EID type locators ttl autoritative | |
| − | 6.0.2.0/24 | + | [0] 6.0.2.0/24 local(ls1) host-xtr_rtr1 0 0 |
</pre> | </pre> | ||
| + | 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 === | === Map resolver === | ||
| Line 86: | Line 94: | ||
</pre> | </pre> | ||
| − | === | + | === Proxy-ITR (PITR) === |
| − | + | VPP can be used as a proxy ITR by specifying a locator set: | |
<pre> | <pre> | ||
vpp# lisp pitr ls ls1 | vpp# lisp pitr ls ls1 | ||
</pre> | </pre> | ||
| − | Where <tt>ls</tt> is <tt>locator-set name</tt> | + | Where <tt>ls</tt> is <tt>locator-set name</tt>. |
| − | To disable | + | To disable PITR use: |
<pre> | <pre> | ||
vpp# lisp pitr disable ls ls1 | vpp# lisp pitr disable ls ls1 | ||
</pre> | </pre> | ||
| − | + | Following command tells if VPP is in PITR mode. If yes it also shows the name of locator set. | |
<pre> | <pre> | ||
vpp# show lisp pitr | vpp# show lisp pitr | ||
| Line 105: | Line 113: | ||
</pre> | </pre> | ||
| − | === Remote | + | === 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": | To add new remote mapping use "lisp remote-mapping add": | ||
<pre> | <pre> | ||
Latest revision as of 15:13, 1 August 2016
Contents
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 <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</vni> is <tt>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
