Export Map Server Site Database in Map Server

The Export Map Server Site Database in Map Server feature exports endpoint identifier (EID) prefixes for registered Locator ID Separation Protocol (LISP) sites into the routing information base (RIB).

Finding Feature Information

Your software release may not support all the features documented in this module. For the latest caveats and feature information, see Bug Search Tool and the release notes for your platform and software release. To find information about the features documented in this module, and to see a list of the releases in which each feature is supported, see the feature information table.

Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.

Information About Export Map Server Site Database in Map Server

This feature supports the installation of Locator ID Separation Protocol (LISP) routes in the routing information base (RIB) corresponding to dynamic site registrations learned by a LISP Map Server (MS). These LISP routes can be redistributed into other routing protocols, such as Interior Gateway Protocol (IGP) and Border Gateway Protocol (BGP), in order to attract traffic from non-LISP sources to the router that is advertising for these registered endpoint identifier (EID) addresses.

When configured, EID routes are installed by the MS into its RIB and point to the Null0 interface. For example, if an egress tunnel router (ETR) registers a prefix 192.0.2.0/24 with the MS, and this feature is configured, the MS will install 192.0.2.0/24 as a route in its RIB, with the protocol source as LISP and pointing to the Null0 interface. When installed in the MS RIB, additional capabilities are extended to the LISP mapping system.


Note

For a standalone MS, LISP-installed routes may be redistributed into another routing protocol for use with other devices. For example, LISP-installed routes may be redistributed into BGP and advertised to a separate LISP Proxy ingress tunnel router (PITR). The PITR may then redistribute site EID registrations into a routing protocol such as IGP or BGP for advertisement from a PITR into a non-LISP core network to attract non-LISP traffic to the PITR. In addition, the PITR can also automatically populate its map cache with these same entries in order to program the LISP prefixes it is responsible to proxy.

For a single device acting as a combination MS/PITR, installed routes may be directly redistributed into a routing protocol (IGP or BGP) for advertisement from a PITR into a non-LISP core network and used to automatically populate the map cache of the PITR.

The feature also provides the ability for a combined MS and (P)xTR, which is a device that functions both as a Map Server and an ingress Tunnel Router (ITR) or Proxy Ingress Tunnel Router (PITR), to install map-cache entries corresponding to the site registration prefixes, with an associated forwarding action of “send-map-request.” Continuing with the example above, when this feature is configured, the ITR or PITR installs a map-cache entry for 192.0.2.0/24 in its map cache, with an action of send-map-request, based on this prefix being registered with the MS function running on the same device. This map-cache entry indicates that the packet received first with a destination matching this entry should trigger the sending of a map request to the mapping system, which results in the full population of the map cache with the positive entry indicating the locator of the ETR that registered 192.0.2.0/24.

This feature introduces:

  • the ability to export registered LISP EID prefixes into the routing information base (RIB).

  • the ability to dynamically populate map-cache entries directly from site registrations.

How to Configure Export Map Server Site Database in Map Server

Configuring Support for Site Entry Redistribution into the RIB

Perform this task to export Locator ID Separation Protocol (LISP) site registrations to the routing information base (RIB).

Before You Begin

When you use endpoint identifier (EID) virtualization within Locator ID Separation Protocol (LISP), you must create a VRF using the vrf definition command and enable at least one address family within the VRF. In addition, you must define the LISP instance ID to which the VRF is associated. LISP virtualization options and configurations are covered in the "LISP Shared Model" and "LISP Parallel Model Virtualization" sections of this configuration guide.

Note
By default, LISP considers EID prefixes to be available in the default RIB. For default (non-virtualized) LISP configurations, VRF definition is not required prior to LISP configuration.

SUMMARY STEPS

    1.    enable

    2.    configure terminal

    3.    router lisp [lisp-instantiation-number]

    4.    eid-table vrf vrf-name instance-id iid

    5.    {ipv4 | ipv6} route-export site-registration

    6.    end


DETAILED STEPS
     Command or ActionPurpose
    Step 1 enable


    Example: 
    Device> enable
     

    Enables privileged EXEC mode.

     
    Step 2configure terminal


    Example: 
    Device# configure terminal
     

    Enters global configuration mode.

     
    Step 3router lisp [lisp-instantiation-number]


    Example: 
    Device(config)# router lisp 15
     
    Creates the specified LISP instantiation number and enters LISP configuration mode. All subsequent LISP commands apply to that router LISP instantiation.
    Note    The use of the lisp-instantiation-number argument is optional. This argument is used when LISP parallel model virtualization is configured.
     
    Step 4 eid-table vrf vrf-name instance-id iid


    Example: 
    Device(config-router-lisp)# eid-table vrf ABC instance-id 30
     

    Configures a LISP instance ID for association with a VRF table or default table through which the EID address space is reachable and enters LISP eid-table configuration mode.

     
    Step 5 {ipv4 | ipv6} route-export site-registration


    Example: 
    Device(config-router-lisp-eid-table)# ipv4 route-export site-registration
     

    Exports LISP site registrations to the RIB.

     
    Step 6end


    Example: 
    Device(config-router-lisp-eid-table)# end
     

    Ends the current configuration session and returns to privileged EXEC mode.

     

    Configuring Redistribution Support in Routing Protocols

    Perform this task to redistribute routing information from LISP to other routing protocols:

    SUMMARY STEPS

      1.    enable

      2.    configure terminal

      3.    router protocol protocol-identifier

      4.    address-family {ipv4 | ipv6} [mdt | multicast | mvpn [vrf vrf-name] | unicast | vrf vrf-name]

      5.    redistribute lisp [metric value] [route-map map-name]

      6.    end


    DETAILED STEPS
       Command or ActionPurpose
      Step 1 enable


      Example: 
      Device> enable
       

      Enables privileged EXEC mode.

       
      Step 2configure terminal


      Example: 
      Device# configure terminal
       

      Enters global configuration mode.

       
      Step 3router protocol protocol-identifier


      Example: 
      Device(config)# router bgp 10
       

      Configures the Border Gateway Protocol (BGP) routing process and enters router configuration mode.

       
      Step 4address-family {ipv4 | ipv6} [mdt | multicast | mvpn [vrf vrf-name] | unicast | vrf vrf-name]


      Example: 
      Device(config-router)# address-family ipv4 vrf ABC
       

      Enters address family configuration mode.

       
      Step 5redistribute lisp [metric value] [route-map map-name]


      Example: 
      Device(config-router-af)# redistribute lisp metric 11 route-map ABC
       

      Redistributes routing information from LISP.

       
      Step 6end


      Example: 
      Device(config-router)# end
       

      Ends the current configuration session and returns to privileged EXEC mode.

       

      Configuring Installation of Site Registrations in the Map Cache

      Perform this task to configure static EID-to-RLOC mappings for an Ingress tunnel router (ITR) or Proxy Ingress tunnel router (PITR):

      Before You Begin

      When you use endpoint identifier (EID) virtualization within Locator ID Separation Protocol (LISP), you must create a VRF using the vrf definition command and enable at least one address family within the VRF. In addition, you must define the LISP instance ID to which the VRF is associated. LISP virtualization options and configurations are covered in the "LISP Shared Model" and "LISP Parallel Model Virtualization" sections of this configuration guide.

      Note
      By default, LISP considers EID prefixes to be available in the default RIB. For default (non-virtualized) LISP configurations, VRF definition is not required prior to LISP configuration.

      SUMMARY STEPS

        1.    enable

        2.    configure terminal

        3.    router lisp [lisp-instantiation-number]

        4.    eid-table vrf vrf-name instance-id iid

        5.    {ipv4 | ipv6} map-cache site-registration

        6.    {ipv4 | ipv6} site-registration limit

        7.    {ipv4 | ipv6} distance {alt distance | dyn-eid distance | site-registrations distance}

        8.    end


      DETAILED STEPS
         Command or ActionPurpose
        Step 1 enable


        Example: 
        Device> enable
         

        Enables privileged EXEC mode.

         
        Step 2configure terminal


        Example: 
        Device# configure terminal
         

        Enters global configuration mode.

         
        Step 3router lisp [lisp-instantiation-number]


        Example: 
        Device(config)# router lisp 22
         
        Creates the specified LISP instantiation number and enters LISP configuration mode. All subsequent LISP commands apply to that router LISP instantiation.
        Note    The use of the lisp-instantiation-number argument is optional. This argument is used when LISP parallel model virtualization is configured.
         
        Step 4 eid-table vrf vrf-name instance-id iid


        Example: 
        Device(config-router-lisp)# eid-table vrf VRF1 instance-id 10
         

        Configures a LISP instance ID for association with a VRF table or default table through which the EID address space is reachable and enters LISP eid-table configuration mode.

         
        Step 5 {ipv4 | ipv6} map-cache site-registration


        Example: 
        Device(config-router-lisp-eid-table)# ipv4 map-cache site-registration
         

        Configures static EID-to-RLOC mappings for an ITR or PITR.

         
        Step 6 {ipv4 | ipv6} site-registration limit


        Example: 
        Device(config-router-lisp-eid-table)# ipv4 site-registration limit 150
         

        (Optional) Configures the maximum number of site registrations for a given instance ID.

         
        Step 7 {ipv4 | ipv6} distance {alt distance | dyn-eid distance | site-registrations distance}


        Example: 
        Device(config-router-lisp-eid-table)# ipv4 distance site-registrations 30
         

        (Optional) Configures the administrative distance for the RIB route installation.

         
        Step 8end


        Example: 
        Device(config-router-lisp-eid-table)# end
         

        Ends the current configuration session and returns to privileged EXEC mode.

         

        Configuration Examples for Export Map Server Site Database in Map Server

        Example: Configuring Support for Site Entry Redistribution into the RIB

        The following example shows how to export Locator ID Separation Protocol (LISP) site registrations to the routing information base (RIB): 

        Device> enable
Device# configure terminal
Device(config)# router lisp 15
Device(config-router-lisp)# eid-table vrf ABC instance-id 30
Device(config-router-lisp-eid-table)# ipv4 route-export site-registration
Device(config-router-lisp-eid-table)# end

        Example: Configuring Redistribution Support in Routing Protocols

        The following example shows how to redistribute information from LISP into other routing protocols. This example shows the redistribution of LISP into BGP: 

        Device> enable
Device# configure terminal
Device(config)# router bgp 22
Device(config-router)# address-family ipv4 vrf ABC
Device(config-router-af))# redistribute lisp metric 11 route-map ABC
Device(config-router-af))# end

        Example: Configuring Installation of Site Registrations in the Map Cache

        The following example shows how to configure static EID-to-RLOC mappings for an Ingress tunnel router (ITR) or Proxy Ingress tunnel router (PITR): 

        Device> enable
Device# configure terminal
Device(config)# router lisp 22
Device(config-router-lisp)# eid-table vrf VRF1 instance-id 10
Device(config-router-lisp-eid-table)# ipv4 map-cache site-registration
Device(config-router-lisp-eid-table)# end

        Additional References for Export Map Server Site Database in Map Server

        Related Documents

        Related Topic

        Document Title

        Cisco IOS commands

        Cisco IOS Master Command List, All Releases

        Locator/ID Separation Protocol (LISP) commands

        Cisco IOS IP Routing: LISP Command Reference

        Standards

        Standard

        Title

        IANA Address Family Numbers

        http:/​/​www.iana.org/​assignments/​address-family-numbers/​address-family-numbers.xml

        MIBs

        MIB

        MIBs Link

        None

        To locate and download MIBs for selected platforms, Cisco IOS software releases, and feature sets, use Cisco MIB Locator found at the following URL: http:/​/​www.cisco.com/​go/​mibs

        RFCs

        RFC

        Title

        RFC 6830

        Locator/ID Separation Protocol (LISP) http:/​/​tools.ietf.org/​html/​rfc6830

        Technical Assistance

        Description

        Link

        The Cisco Support website provides extensive online resources, including documentation and tools for troubleshooting and resolving technical issues with Cisco products and technologies.

        To receive security and technical information about your products, you can subscribe to various services, such as the Product Alert Tool (accessed from Field Notices), the Cisco Technical Services Newsletter, and Really Simple Syndication (RSS) Feeds.

        Access to most tools on the Cisco Support website requires a Cisco.com user ID and password.

        http:/​/​www.cisco.com/​cisco/​web/​support/​index.html

        Feature Information for Export Map Server Site Database in Map Server

        The following table provides release information about the feature or features described in this module. This table lists only the software release that introduced support for a given feature in a given software release train. Unless noted otherwise, subsequent releases of that software release train also support that feature.

        Use Cisco Feature Navigator to find information about platform support and Cisco software image support. To access Cisco Feature Navigator, go to www.cisco.com/​go/​cfn. An account on Cisco.com is not required.
        Table 1 Feature Information for Export Map Server Site Database in Map Server

        Feature Name

        Releases

        Feature Information

        Export Map Server Site Database in Map Server

        15.4(2)T

        The Export Map Server Site Database in Map Server feature extends support for an existing Multiprotocol Label Switching (MPLS) or VPN service across third party IP networks using Locator ID Separation Protocol (LISP).

        The following commands were introduced or modified: route-export site-registrations, map-cache site-registrations, and distance.