CISCO 8000 Series Routers Configuring Generic UDP Encapsulation User Guide
- June 15, 2024
- Cisco
Table of Contents
Configuring Generic UDP Encapsulation
Read this section to get an overview and know how to configure the Generic UDP Encapsulation.
Table 1: Feature History Table
Feature Name | Release Information | Feature Description |
---|---|---|
Generic UDP Encapsulation | Release 7.3.1 | This feature enables you to add an |
additional header to packets to identify or authenticate the data using UDP. Encapsulating packets in UDP leverages the use of the UDPsource port to provide entropy to Equal Cost Multi-Path (ECMP) hashing. It provides significant performance benefits for load-balancing.
This command is introduced for this feature:
decapsulate gue
- Understand Generic UDP Encapsulation, on page 1
- Flexible Assignment of UDP Port Numbers for Decapsulation, on page 7
Understand Generic UDP Encapsulation
UDP encapsulation is a technique of adding network headers to packets and then encapsulating the packets within the User Datagram Protocol (UDP).
Encapsulating packets using UDP facilitates efficient transport across networks. By leveraging Receive Side Scaling (RSS) and Equal Cost Multipath (ECMP) routing, UDP provides significant performance benefits for load- balancing. The use of the UDP source port provides entropy to ECMP hashing and provides the ability to use the IP source or destination, and the L4 Port for load-balancing entropy.
Traditional mechanisms like Generic Routing Encapsulation (GRE) can handle only the outer Source IP address and parts of the destination address. They may not provide sufficient load balancing entropy.
Generic UDP Encapsulation (GUE) is a UDP-based network encapsulation protocol that encapsulates IPv4 and IPv6 packets. GUE provides native UDP encapsulation and defines an additional header, which helps to determine the payload carried by the IP packet. The additional header can include items, such as a virtual networking identifier, security data for validating or authenticating the GUE header, congestion control data, and so on.
In GUE, the payload is encapsulated in an IP packet that can be IPv4 or IPv6 Carrier. The UDP header is added to provide extra hashing parameters, and optional payload demultiplexing. At the decapsulation node, the Carrier IP and UDP headers are removed, and the packet is forwarded based on the inner payload.
A GUE packet has the general format:
Figure 1: GUE Packet Format
UDP/IP header
GUE Header
Encapsulated packet or control message
520902
For example, in this scenario, if the data stream is sent from Host 1 to Host 2. The server acts as a GUE encapsulator that sends the packets from Host 1. The server, on the other end receiving the data, validates the data for the valid carrier IP and UDP header and decapsulates the data.
- Host 1
- Host 2
- Encapsulation server (Source)
- Decapsulation server (Destination)
- Layer 3 Network
GUE has various variants, but variant 1 of GUE allows direct encapsulation of IPv4 and IPv6 in UDP. This technique saves encapsulation overhead on links for the use of IP encapsulation, and also need not allocate a separate UDP port number for IP-over-UDP encapsulation.
Variant 1 has no GUE header, but a UDP packet carries an IP packet. The first two bits of the UDP payload is the GUE variant field and match with the first two bits of the version number in the IP header.
Benefits of using GUE
-
Allows direct encapsulation of payloads, such as IPv4 and IPv6 in the UDP packet.
• You can use UDP port for demultiplexing payloads.
• You can use a single UDP port, allowing systems to employ parsing models to identify payloads. -
Leverages the UDP header for entropy labels by encoding a tuple-based source port.
-
Leverages source IP addresses for load-balance encoding. The destination too could be terminated based on a subnet providing additional bits for entropy.
-
Avoids special handling for tranist nodes because they only see an IP-UDP packet with some payload..
-
Eases implementation of UDP tunneling with GUE. This is because of the direct encapsulation method of the payloads into UDP.
Restrictions
-
Supports Generic UDP Decapsulation for only variant 1.
-
Receives IPv4 packets with the defined GUE port of 6080.
-
Decapsulates IPv6 packets with the defined GUE port of 6615.
-
Receives MPLS packets with the UDPoMPLS port of 6635.
-
Range of source or destination ports is not supported.
-
Range, Source, or Destination addresses are not supported, but subnet mask enteries are allowed.
-
To perform decapsulation, a destination Port is mandatory.
-
Terminating GRE after GUE or GUE after GRE is not supported.
-
Terminating a label such as a VPN Deaggregation after GUE termination is not supported.
-
Slow path support is not supported. To resolve the inner IP Adjacency, use the cef proactive-arp-nd
enable command. -
Running the clear all command doesn’t clear the interface of all its existing configurations.
Configure GUE
Use the following configuration workflow to configure GUE:
- Configure hw-module profile load-balance algorithm ip-tunnel.
- Configure a traffic class: Create a traffic class and specify various criteria for classifying packets using the match commands, and an instruction on how to evaluate these match commands.
- Configure a policy map: Define a policy map and associate the traffic class with the traffic policy.
- Apply the policy for each VRF, and apply this policy on all the interfaces that are part of the VRF.
Configuration Example
1. Configure hw-module profile load-balance algorithm ip-tunnel.
Router# configure
Router# hw-module profile load-balance algorithm ip-tunnel
Router# commit
Note While adding or removing the hw-module profile load-balance algorithm
ip-tunnel command, you must reload the router.
2. Configure a traffic class:
Router# configure
Router(config)# class-map type traffic match-all udp-v4
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0 255.255.255.0
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 6080
Router(config-cmap)# end-class-map
Router(config)# commit
Router(config)# class-map type traffic match-all udp-mpls1
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0 255.255.255.0
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 6635
Router(config-cmap)# end-class-map
Router(config)# commit
Router(config)# class-map type traffic match-all udp-v6
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0 255.255.255.0
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 6615
Router(config-cmap)# end-class-map
Router(config)# commit
3. Define a policy map, and associate the traffic class with the traffic policy:
Router(config)# policy-map type pbr magic-decap
Router(config-pmap)# class type traffic udp-v4
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# class type traffic udp-v6
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
!
Router(config-pmap)# class type traffic udp-mpls1
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# class type traffic class-default
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# end-policy-map
Router(config)# commit
Router(config)# exit
4. Apply the policy for each VRF:
Router# configure
Router(config)# vrf-policy
Router(config-vrf-policy)# vrf default address-family ipv4 policy type pbr
input magic-decap Router(config-vrf-policy)# commit
Running Configuration:
class-map type traffic match-all udp-v4
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 6080
end-class-map
!
class-map type traffic match-all udp-v6
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 6080
end-class-map
!
class-map type traffic match-all udp-mpls1
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 6635
end-class-map
!
policy-map type pbr magic-decap
class type traffic udp-v4
decapsulate gue variant 1
!
class type traffic udp-v6
decapsulate gue variant 1
!
class type traffic udp-mpls1
decapsulate gue variant 1
!
class type traffic class-default
!
end-policy-map
!
vrf-policy
vrf default address-family ipv4 policy type pbr input magic-decap
!
Verification
To view the set of counter values accumulated for the packets that match the
class-map:
Router# show policy-map type pbr addr-family ipv4 statistics
VRF Name: default
Policy-Name: pmap
Policy Type: pbr
Addr Family: IPv4
Class: cmap-loop1
Classification statistics (packets/bytes)
Matched : 0/0
Transmitted statistics (packets/bytes)
Total Transmitted : 0/0
Class: cmap-loop6
Classification statistics (packets/bytes)
Matched : 0/0
Transmitted statistics (packets/bytes)
Total Transmitted : 0/0
Class: cmap-loop2
Classification statistics (packets/bytes)
Matched : 0/0
Transmitted statistics (packets/bytes)
Total Transmitted : 0/0
Class: cmap-loop3
Classification statistics (packets/bytes)
Matched : 198325306/17849277540
Transmitted statistics (packets/bytes)
Total Transmitted : 198325306/17849277540
Class: ^DEœ?¿^?
Classification statistics (packets/bytes)
Matched : 0/0
Transmitted statistics (packets/bytes)
Total Transmitted : 0/0
To clear the policy-map counters for each class-map rule, use the clear vrf command:
Router# clear vrf default address-family ipv4 statistics
Flexible Assignment of UDP Port Numbers for Decapsulation
Table 2: Feature History Table
Feature Name | Release Information | Feature Description |
---|---|---|
Flexible Assignment of UDP Port Numbers for Decapsulation | Release 7.3.3 | This |
feature gives you the flexibility to assign UDP port numbers from 1000 through 6400, through which IPv4, IPv6, and MPLSpackets can be decapsulated. Such flexibility allows you to segregate the ingress traffic based on a QoS policy.
In earlier releases, you could assign only default ports for decapsulation.
The following command is introduced for this feature:
hw-module profile gue
udp-dest-port ipv4 <port
number> ipv6
mpls
This feature provides decapsulation support for GUE packets. In GUE, the payload is encapsulated in an IP packet–IPv4 or IPv6 carrier. The UDP header is added to provide extra hashing parameters and optional payload demultiplexing. At the decapsulation node, the carrier IP and UDP headers are removed, and the packet is forwarded based on the inner payload. Prior to Release 7.3.3, packets were decapsulated using UDP port numbers 6080, 6615, and 6635 for IPv4, IPv6, and MPLS payloads respectively. Starting from Release 7.3.3, you can assign UDP port numbers from 1000 through 64000 to decapsulate IPv4, IPv6, and MPLS packets. Define different port numbers for IPv4, IPv6, and MPLS.
Guidelines for Setting up Decapsulation Using Flexible Port Numbers
Apply these guidelines while assigning flexible port numbers for decapsulation:
Packet | IPv4 | IPv6 | MPLS |
---|---|---|---|
UDP Outer Header | Configure IPv4 port on the hardware module. | Configure IPv6 | |
port on the hardware module. | Configure MPLS port on the hardware module. | ||
Encapsulation Outer Header | Configure an IPv4 encapsulation outer header that |
matches with the class map source.
Inner Payload| Note that packets are forwarded based on the inner IPv4
payload.| Note that packets are forwarded based on the inner IPv6 payload.|
Note that packets are forwarded based on the inner MPLS payload.
Note
-
During the decapsulation of the IPv4, IPv6, and MPLS packets, the following headers are removed:
• The UDP outer header
• The IPv4 encapsulation outer header -
Select different values for each of these protocols. Valid port numbers are from 1000 through 64000.
Restrictions
The following restrictions are applicable while configuring unique GUE destination port numbers to decapsulate IPv4, IPv6, and MPLS packets using UDP:
-
While configuring the tunnel, select one of the following:
• Match only 16 unique source IP addresses as shown in the example:
Router(config-cmap)# match source-address ipv4 210.100.20.0 255.255.255.255
• Match a combination of 64 unique source and destination IP addresses as shown in the example:
Router(config-cmap)# match destination-address ipv4 220.100.20.0 255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0 255.255.255.0 -
The Classless Inter-Domain Routing (CIDR) value in the source IP address subnet mask must be only /32.
-
The destination address subnet mask supports all CIDR values. However, the destination address along with the subnet mask must be unique for all the three UDP payload types–IPv4, IPv6, and MPLS. The configuration fails when the destination IP address and the subnet mask are the same for all three payloads as seen in this example:
Router(config)# class-map type traffic match-all SRTE-GUE-DECAP-IPv4
Router(config-cmap)# match destination-address ipv4 10.216.101.0 255.255.255.0
..
Router(config)# class-map type traffic match-all SRTE-GUE-DECAP-IPv6
Router(config-cmap)# match destination-address ipv4 10.216.101.0 255.255.255.0
..
Router(config)# class-map type traffic match-all SRTE-GUE-DECAP-MPLS
Router(config-cmap)# match destination-address ipv4 10.216.101.0 255.255.255.0
..
Configuring Port Numbers for Decapsulation
By configuring different port numbers on the destination router, you can match and direct traffic to different paths. For example, traffic for a specific video service can be decapsulated and sent through different ports. The steps that are involved in configuring port numbers for decapsulation are:
- Configure the UDP destination ports for decapsulation of the required payloads.
- Configure the traffic class to match the ports.
- Define a policy map, and associate the traffic class with the traffic policy.
- Apply the policy for each VRF.
Note For the hardware module flexible port configuration to take effect you must reload the line card.
Configuration Example
Hw-module configuration:
Router# hw-module gue udp dest-port-ipv4 1001 dest-port-ipv6 1002 dest-port- mpls 1003
Class-map configuration:
Router# configure
Router(config)# class-map type traffic match-all udp-v4
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0
255.255.255.255
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 1001
Router(config-cmap)# end-class-map
Router(config)# commit
Router(config)# class-map type traffic match-all udp-v6
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0
255.255.255.255
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 1002
Router(config-cmap)# end-class-map
Router(config)# commit
Router(config)# class-map type traffic match-all udp-mpls1
Router(config-cmap)# match destination-address ipv4 220.100.20.0
255.255.255.0
Router(config-cmap)# match source-address ipv4 210.100.20.0
255.255.255.255
Router(config-cmap)# match protocol udp
Router(config-cmap)# match destination-port 1003
Router(config-cmap)# end-class-map
Router(config)# commit
Ingress Policy-map configuration:
Router(config)# policy-map type pbr magic-decap
Router(config-pmap)# class type traffic udp-v4
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# class type traffic udp-v6
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# class type traffic udp-mpls1
Router(config-pmap-c)# decapsulate gue variant 1
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# class type traffic class-default
Router(config-cmap)# match protocol udp
Router(config-pmap-c)# exit
Router(config-pmap)# end-policy-map
Router(config)# commit
Router(config)# exit
Applying policy per VRF:
Router# configure
Router(config)# vrf-policy
Router(config-vrf-policy)# vrf default address-family ipv4 policy type pbr
input magic-decap
Router(config-vrf-policy)# commit
Running Configuration
!! File saved at 16:01:32 UTC Mon Feb 07 2022 by cisco
!! IOS XR Configuration 7.3.3.10I
!! Last configuration change at Mon Feb 7 15:35:11 2022 by cisco
!
logging console disable
username cisco
group root-lr
group cisco-support
secret 10
$6$gHKmE1YZAo71BE1.$3KYogrvOdJxTRPZgYPGXUXkO4PqQMr2E6oYvJO4ngBmuaGsF2nAB/m1NP5Il3zh9HTzBI/k4r8PwWSbsARsmp.
!
vrf vrf-gre
address-family ipv4 unicast
!
address-family ipv6 unicast
!
!
line console
exec-timeout 0 0
absolute-timeout 0
session-timeout 0
!
line default
exec-timeout 0 0
absolute-timeout 0
session-timeout 0
!
!arp vrf default 29.0.1.2 0000.1122.2929 ARPA
call-home
service active
contact smart-licensing
profile CiscoTAC-1
active
destination transport-method http
!
!
ipv6 access-list abf6-gre
1 permit ipv6 any any nexthop1 ipv6 201:0:1::2
!
ipv4 access-list abf-gre
1 permit ipv4 any any nexthop1 ipv4 201.0.1.2
!
class-map type traffic match-all udp-v4
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 1001
end-class-map
!
class-map type traffic match-all udp-v6
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 1002
end-class-map
!
class-map type traffic match-all udp-mpls1
match destination-address ipv4 220.100.20.0 255.255.255.0
match source-address ipv4 210.100.20.0 255.255.255.0
match protocol udp
match destination-port 1003
end-class-map
!
policy-map type pbr pbr-gre
class type traffic class-default
redirect ipv4 nexthop 202.0.1.2
!
end-policy-map
!
policy-map type pbr magic-decap
class type traffic udp-v4
decapsulate gue variant 1
!
class type traffic udp-v6
decapsulate gue variant 1
!
class type traffic udp-mpls1
decapsulate gue variant 1
!
class type traffic class-default
!
end-policy-map
!
interface Bundle-Ether25
ipv4 address 25.0.1.1 255.255.255.0
ipv6 address 25:0:1::1/64
ipv6 enable
shutdown
!
interface Bundle-Ether28
ipv4 address 28.0.1.1 255.255.255.0
!
interface Loopback0
ipv4 address 10.10.10.1 255.255.255.255
!