CHAPTER 21-1 Cisco IOS XE REST API Management Reference Guide 21 LISP • Introduction to LISP • Resource Summary for LISP • LISP Resource: xTr Mode • LISP Resource: MS/MR Mode • LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode • LISP Resource: PxTr Mode • LISP Resource: VPN Parallel Mode Introduction to LISP Locator ID Separation Protocol (LISP) is a network architecture and protocol that implements the use of two namespaces instead of a single IP address: • Endpoint identifiers (EIDs)—Assigned to end hosts • Routing locators (RLOCs)—Assigned to devices (primarily routers) that make up the global routing system Splitting EID and RLOC functions provides several advantages, including improved routing system scalability, and improved multi-homing efficiency and ingress traffic engineering. Required Configuration of LISP Devices LISP functionality requires LISP-specific configuration of one or more LISP-related devices, such as the LISP egress tunnel router (ETR), ingress tunnel router (ITR), proxy ETR (PETR), proxy ITR (PITR), map resolver (MR), map server (MS), and LISP alternative logical topology (ALT) device. Modes There are different modes in which the device can be configured to support the LISP feature. Different modes support different configurations.
40
Embed
LISP - · PDF fileCHAPTER 20-1 Cisco IOS XE REST API Management Reference Guide 20 LISP • Introduction to LISP † Resource Summary for LISP † LISP Resource: xTr Mode
This document is posted to help you gain knowledge. Please leave a comment to let me know what you think about it! Share it to your friends and learn new things together.
Transcript
Cisco IO
C H A P T E R 21
LISP
• Introduction to LISP
• Resource Summary for LISP
• LISP Resource: xTr Mode
• LISP Resource: MS/MR Mode
• LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
• LISP Resource: PxTr Mode
• LISP Resource: VPN Parallel Mode
Introduction to LISPLocator ID Separation Protocol (LISP) is a network architecture and protocol that implements the use of two namespaces instead of a single IP address:
• Endpoint identifiers (EIDs)—Assigned to end hosts
• Routing locators (RLOCs)—Assigned to devices (primarily routers) that make up the global routing system
Splitting EID and RLOC functions provides several advantages, including improved routing system scalability, and improved multi-homing efficiency and ingress traffic engineering.
Required Configuration of LISP Devices
LISP functionality requires LISP-specific configuration of one or more LISP-related devices, such as the LISP egress tunnel router (ETR), ingress tunnel router (ITR), proxy ETR (PETR), proxy ITR (PITR), map resolver (MR), map server (MS), and LISP alternative logical topology (ALT) device.
Modes
There are different modes in which the device can be configured to support the LISP feature. Different modes support different configurations.
21-1S XE REST API Management Reference Guide
Chapter 21 LISP Resource Summary for LISP
LISP modes:
• xTr mode
– LISP Egress Tunnel Router (ETR)
– LISP Ingress Tunnel Router (ITR)
• Proxy xTR mode
– LISP Egress Tunnel Router (ETR)
– LISP Ingress Tunnel Router (ITR)
• LISP Map Server/Map Resolver
– Shared Model
– Parallel Model
• VPN mode
• Mobility mode
– First Hop Router mode
– Site Gateway mode
– xTr mobile
For additional information about the various modes above, and LISP in general, please refer to:http://www.cisco.com/c/en/us/td/docs/ios-xml/ios/iproute_lisp/configuration/xe-3s/asr1000/irl-xe-3s-asr1000-book/irl-overview.html#GUID-CD1B3F3E-99E2-4383-A558-714700A6427F
Delete a LISP Configuration: MS/MR Mode, VRF-Aware
Resource URI
Example
JSON Request
DELETE /api/v1/vrf/BLUE/routing-svc/lisp/0
JSON Response
204 No Content
Verb URI
DELETE /api/v1/vrf/<VRF-name>/lisp/<name>
21-18Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
History
Properties for FHR/Site Gateway/ xTr - Mobile Mode
Release Modification
IOS XE 3.13 Introduced for the CSR1000V platform
IOS XE 3.14 Introduced for ASR1001-X and ASR1002-X platforms
Property Type
Required for POST and PUT Description
kind string Not applicable Object Type:" object#lisp"
lisp-id number Optional Unique identifier for the LISP configuration.
Range: 0 to 65520
locator-set-name array Mandatory Array that specifies the locator set information
ip-address string Mandatory Address that the FHR uses to communicate with the site gateway xTr
priority number Mandatory Specifies the priority assigned to the RLOC
Range: 0 to 255
weight number Mandatory Specifies the weight assigned to the locator
Range: 0 to 255
eid-table-instance-id number Mandatory Specifies the instance ID to be associated with this EID table
Range: 0 to 16777215
eid-table-database-mapping
array Optional Configures an IPv4 EID-to-RLOC mapping relationship and an associated traffic policy for LISP
eid-prefix string Optional (subproperty of eid-table-database-mapping)
IPv4 or IPv6 EID prefix and length to be advertised by the router
21-19Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
locator-set string Optional (subproperty of eid-table-database-mapping)
Specifies the IPv4 routing locator (RLOC) associated with the EID prefix
dynamic-eid-name string Optional Name of a LISP dynamic-EID
dynamic-eid-notify-auth-key
string Optional Enables sending of dynamic endpoint identifier (EID) presence notifications to a gateway xTR with the specified IPv4 address along with the authentication key used with the gateway xTR
dynamic-eid-notify-group string Optional Specifies the IPv4 multicast group address used for sending and receiving site-based map-notify multicast messages
dynamic-eid-database-mapping
array Optional Configures an IPv4 mapping relationship and an associated traffic policy for LISP VM-mobility dynamic EID policy
ipv4-itr boolean Optional Specifies whether the router needs to operate in ITR mode for IPv4
ipv4-etr boolean Optional Specifies whether the router needs to operate in ETR mode for IPv4
ipv4-itr-map-resolver array Optional Comma-separated list of IP addresses to be used as map-resolvers.
Can include up to 2 map resolvers per type of IP address.
ipv4-etr-map-server-address
array Optional Comma-separated list of IP addresses to be used as map-servers.
Can include up to 2 map-servers per type of IP address.
ipv4-etr-map-server-key array Optional Comma-separated list of keys to be used with map-resolvers.
One key allowed per MS configuration.
ipv4-use-petr string Optional PETR address to use
ipv6-itr boolean Optional Specifies whether the router needs to operate in ITR mode for IPv6
ipv6-etr boolean Optional Specifies whether the router needs to operate in ETR mode for IPv6
ipv6-itr-map-resolver array Optional Comma-separated list of IP addresses to be used as map-resolvers.
Can include up to 2 MRs per type of IP address.
Property Type
Required for POST and PUT Description
21-20Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
ipv6-etr-map-server-address
array Optional Comma-separated list of IP addresses to be used as map-servers.
Can include up to 2 map-servers per type of IP address.
ipv6-etr-map-server-key array Optional Comma-separated list of keys to be used with map-resolvers.
One key allowed per MS configuration.
ipv4-use-petr string Optional PETR address to use
Property Type
Required for POST and PUT Description
21-21Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource—Mobility Mode: First Hop Router/Site Gateway/ xTr-Mobile Mode
ipv4-proxy-etr boolean Optional Specifies whether it is necessary to configure the router as IPv4 PETR
ipv6-proxy-etr boolean Optional Specifies whether it is necessary to configure it as IPv6 PETR
21-26Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource: PxTr Mode
ipv4-proxy-itr boolean Optional Specifies whether it is necessary to configure the router as IPv4 PITR
ipv6-proxy-itr boolean Optional Specifies whether it is necessary to configure the router as ipv6 PITR
ipv4-proxy-itr-address-ipv4
string Optional IPv4 address to configure the router as IPv4 PITR
ipv4-proxy-itr-address-ipv6
string Optional IPv6 address to configure the router as IPv4 PITR
ipv4-alt-vrf string Optional Specifies the VRF for the IPv4 LISP ALT
To configure which VRF instance supporting the IPv4 address-family LISP should use when sending map requests for an IPv4 endpoint identifier-to-routing locator mapping directly over the ALT
ipv4-map-cache-limit number Optional Specifies the number of entries
Default: 1000
ipv6-proxy-itr-address array Optional Comma-separated list of IP addresses to configure the router as IPv6 PITR
ipv6-proxy-itr-address-ipv6
string Optional IPv6 address to configure the router as IPv6 PITR
ipv6-alt-vrf string Optional Specifies the VRF for the IPv6 LISP ALT
ipv6-map-cache-limit number Optional Specifies the number of entries
Default: 10000
Property Type
Required for POST and PUT Description
21-27Cisco IOS XE REST API Management Reference Guide
21-33Cisco IOS XE REST API Management Reference Guide
Chapter 21 LISP LISP Resource: VPN Parallel Mode
LISP Resource: VPN Parallel ModeVPN parallel mode shares the same properties and JSON representation as in xTr mode. When creating or retrieving the LISP resource, the VRF instance is included in the URL.
History
Properties for VPN Parallel Mode
Release Modification
IOS XE 3.13 Introduced for the CSR1000V platform
IOS XE 3.14 Introduced for ASR1001-X and ASR1002-X platforms
Property Type
Required for POST and PUT Description
kind string Not applicable Object Type:" object#lisp"
lisp-id number Optional Unique identifier for the LISP configuration.
Range: 0 to 65520
database-mapping array Mandatory Array of mapping between EIDs and RLOCs with priority and weight for each
instance-id number Optional Specifies the instance ID to be associated with this EID table.
Range: 0 to 16777215
eid-prefix string Mandatory IP address (IPv4 or IPv6) for EID