.. _bgp-user-guide-labeled-family: IP Labeled Unicast Family ========================= The BGP Labeled Unicast (BGP-LU) Multiprotocol extension is used to distribute a MPLS label that is mapped to a particular route. It can be used to advertise a MPLS transport path between IGP regions and Autonomous Systems. Also, BGP-LU can help to solve the Inter-domain traffic-engineering problem and can be deployed in large-scale data centers along with MPLS and Spring. In addition, IPv6 Labeled Unicast can be used to interconnect IPv6 islands over IPv4/MPLS networks using 6PE. .. contents:: Contents :depth: 2 :local: Configuration ^^^^^^^^^^^^^ This section shows a way to enable IPv4 and IPv6 Labeled Unicast family in BGP speaker and peer configuration. BGP Speaker ''''''''''' To enable IPv4 and IPv6 Labeled Unicast support in BGP plugin, first configure BGP speaker instance: **URL:** ``/rests/data/openconfig-network-instance:network-instances/network-instance=global-bgp/protocols`` **Method:** ``POST`` .. tabs:: .. tab:: XML **Content-Type:** ``application/xml`` **Request Body:** .. code-block:: xml bgp-example x:BGP 192.0.2.2 65000 x:IPV4-LABELLED-UNICAST x:IPV6-LABELLED-UNICAST .. tab:: JSON **Content-Type:** ``application/json`` **Request Body:** .. code-block:: json { "protocol": [ { "identifier": "openconfig-policy-types:BGP", "name": "bgp-example", "bgp-openconfig-extensions:bgp": { "global": { "config": { "router-id": "192.0.2.2", "as": 65000 }, "afi-safis": { "afi-safi": [ { "afi-safi-name": "openconfig-bgp-types:IPV4-LABELLED-UNICAST" }, { "afi-safi-name": "openconfig-bgp-types:IPV6-LABELLED-UNICAST" } ] } } } } ] } BGP Peer '''''''' Here is an example for BGP peer configuration with enabled IPv4 and IPv6 Labeled Unicast family. **URL:** ``/rests/data/openconfig-network-instance:network-instances/network-instance/global-bgp/openconfig-network-instance:protocols/protocol/openconfig-policy-types:BGP,bgp-example/bgp/neighbors`` **Method:** ``POST`` .. tabs:: .. tab:: XML **Content-Type:** ``application/xml`` **Request Body:** .. code-block:: xml 192.0.2.1 x:IPV4-LABELLED-UNICAST x:IPV6-LABELLED-UNICAST .. tab:: JSON **Content-Type:** ``application/json`` **Request Body:** .. code-block:: json { "neighbor": [ { "neighbor-address": "192.0.2.1", "afi-safis": { "afi-safi": [ { "afi-safi-name": "openconfig-bgp-types:IPV4-LABELLED-UNICAST" }, { "afi-safi-name": "openconfig-bgp-types:IPV6-LABELLED-UNICAST" } ] } } ] } IP Labeled Unicast API ^^^^^^^^^^^^^^^^^^^^^^ Following trees illustrate the BGP IP Labeled Unicast routes structures. IPv4 Labeled Unicast Route '''''''''''''''''''''''''' .. code-block:: console :(labeled-unicast-routes-case) +--ro labeled-unicast-routes +--ro labeled-unicast-route* [route-key path-id] +--ro route-key string +--ro label-stack* | +--ro label-value? netc:mpls-label +--ro prefix? inet:ip-prefix +--ro path-id path-id +--ro attributes ... IPv6 Labeled Unicast Route '''''''''''''''''''''''''' .. code-block:: console :(labeled-unicast-ipv6-routes-case) +--ro labeled-unicast-ipv6-routes +--ro labeled-unicast-route* [route-key path-id] +--ro route-key string +--ro label-stack* | +--ro label-value? netc:mpls-label +--ro prefix? inet:ip-prefix +--ro path-id path-id +--ro attributes ... Usage ^^^^^ The IPv4 Labeled Unicast table in an instance of the speaker's Loc-RIB can be verified via REST: **URL:** ``/rests/data/bgp-rib:bgp-rib/rib/bgp-example/loc-rib/tables/bgp-types:ipv4-address-family/bgp-labeled-unicast:labeled-unicast-subsequent-address-family/bgp-labeled-unicast:labeled-unicast-routes?content=nonconfig`` **Method:** ``GET`` .. tabs:: .. tab:: XML **Response Body:** .. code-block:: xml 0 MAA+gRQAAA== 100 200.10.0.101 igp 1000 20.0.0.0/24 .. tab:: JSON **Response Body:** .. code-block:: json { "bgp-labeled-unicast:labeled-unicast-routes": { "labeled-unicast-route": { "route-key": "MAA+gRQAAA==", "path-id": 0, "label-stack": { "label-value":1000 }, "attributes": { "origin": { "value": "igp" }, "local-pref": { "pref": 100 }, "ipv4-next-hop": { "global": "200.10.0.101" } }, "prefix":"20.0.0.0/24" } } } Programming ^^^^^^^^^^^ IPv4 Labeled '''''''''''' This examples show how to originate and remove IPv4 labeled route via programmable RIB. Make sure the *Application Peer* is configured first. **URL:** ``/rests/data/bgp-rib:application-rib/10.25.1.9/tables/bgp-types:ipv4-address-family/bgp-labeled-unicast:labeled-unicast-subsequent-address-family/bgp-labeled-unicast:labeled-unicast-routes`` **Method:** ``POST`` .. tabs:: .. tab:: XML **Content-Type:** ``application/xml`` **Request Body:** .. code-block:: xml label1 1.1.1.1/32 0 800322 199.20.160.41 igp 100 .. tab:: JSON **Content-Type:** ``application/json`` **Request Body:** .. code-block:: json { "labeled-unicast-route": [ { "route-key": "label1", "path-id": 0, "prefix": "1.1.1.1/32", "label-stack": [ { "label-value": 800322 } ], "attributes": { "origin": { "value": "igp" }, "local-pref": { "pref": 100 }, "ipv4-next-hop": { "global": "199.20.160.41" } } } ] } ----- In addition, BGP-LU Spring extension allows to attach BGP Prefix SID attribute to the route, in order to signal the BGP-Prefix-SID, where the SR is applied to MPLS dataplane. .. tabs:: .. tab:: XML .. code-block:: xml 322 800000 4095 .. tab:: JSON .. code-block:: json { "bgp-prefix-sid": [ { "label-index-tlv": 322 }, { "srgb-value": { "base": 800000, "range": 4095 } } ] } ----- To remove the route added above, following request can be used: **URL:** ``/rests/data/bgp-rib:application-rib/10.25.1.9/tables/bgp-types:ipv4-address-family/bgp-labeled-unicast:labeled-unicast-subsequent-address-family/bgp-labeled-unicast:labeled-unicast-routes/bgp-labeled-unicast:labeled-unicast-route/label1/0`` **Method:** ``DELETE`` IPv6 Labeled '''''''''''' This examples show how to originate and remove IPv6 labeled route via programmable RIB. **URL:** ``/rests/data/bgp-rib:application-rib/10.25.1.9/tables/bgp-types:ipv4-address-family/bgp-labeled-unicast:labeled-unicast-subsequent-address-family/bgp-labeled-unicast:labeled-unicast-ipv6-routes`` **Method:** ``POST`` .. tabs:: .. tab:: XML **Content-Type:** ``application/xml`` **Request Body:** .. code-block:: xml label1 2001:db8:30::3/128 0 123 2003:4:5:6::7 igp 100 .. tab:: JSON **Content-Type:** ``application/json`` **Request Body:** .. code-block:: json { "labeled-unicast-route": [ { "route-key": "label1", "path-id": 0, "prefix": "2001:db8:30::3/128", "label-stack": [ { "label-value": 123 } ], "attributes": { "origin": { "value": "igp" }, "local-pref": { "pref": 100 }, "ipv6-next-hop": { "global": "2003:4:5:6::7" } } } ] } ----- To remove the route added above, following request can be used: **URL:** ``/rests/data/bgp-rib:application-rib/10.25.1.9/tables/bgp-types:ipv4-address-family/bgp-labeled-unicast:labeled-unicast-subsequent-address-family/bgp-labeled-unicast:labeled-unicast-ipv6-routes/bgp-labeled-unicast:labeled-unicast-route/label1/0`` **Method:** ``DELETE`` References ^^^^^^^^^^ * `Carrying Label Information in BGP-4 `_ * `Segment Routing Prefix SID extensions for BGP `_ * `Connecting IPv6 Islands over IPv4 MPLS Using IPv6 Provider Edge Routers (6PE) `_ * `BGP-Prefix Segment in large-scale data centers `_ * `Egress Peer Engineering using BGP-LU `_