VxlanLwtTunnelRecipe

class lnst.Recipes.ENRT.VxlanLwtTunnelRecipe.VxlanLwtTunnelRecipe(**kwargs)

Bases: PauseFramesHWConfigMixin, OffloadSubConfigMixin, BaseTunnelRecipe

This class implements a recipe that configures a simple Vxlan lightweight tunnel between two hosts.

               .--------.
        .------| switch |-----.
        |      '--------'     |
        |                     |
.-------|------.      .-------|------.
|    .--'-.    |      |    .--'-.    |
|    |eth0|    |      |    |eth0|    |
|    '----'    |      |    '----'    |
|      | |     |      |      | |     |
|  ----' '---  |      |  ----' '---  |
| vxlan tunnel |      | vxlan tunnel |
|  ----------  |      |  ----------  |
|              |      |              |
|    host1     |      |    host2     |
'--------------'      '--------------'

The actual test machinery is implemented in the BaseEnrtRecipe class.

The test wide configuration is implemented in the BaseTunnelRecipe class.

The recipe provides additional parameter:

param carrier_ipversion:

This parameter specifies whether IPv4 or IPv6 addresses are used for the underlying (carrier) network. The value is either ipv4 or ipv6

configure_underlying_network(config: EnrtConfiguration) → tuple[RemoteDevice, RemoteDevice]: The underlying network for the tunnel consists of the Ethernet devices on the matched hosts.

create_tunnel(config: EnrtConfiguration, tunnel_endpoints: tuple[RemoteDevice, RemoteDevice]) → tuple[RemoteDevice, RemoteDevice]

The Vxlan tunnel devices are created with external flag specified so that the encapsulation can be defined externally by routes.

Routes for IPv4 and IPv6 networks to be tunneled through the Vxlan are added.

IPv4 and IPv6 addresses of the tunneled networks are configured on the loopback devices of the matched hosts.

generate_ping_endpoints(config)

The ping endpoints for this recipe are the loopback devices that are configured with IP addresses of the tunnelled networks.

Returned as:

[PingEndpoints(self.matched.host1.lo, self.matched.host2.lo)]

generate_perf_endpoints(config: EnrtConfiguration) → list[Collection[EndpointPair[IPEndpoint]]]: The perf endpoints for this recipe are the loopback devices that are configured with IP addresses of the tunnelled networks.

get_packet_assert_config(ping_config): The packet assert test configuration contains filter for source and destination addresses matching the carrier network with udp header bits specific to VXLAN tunneling. The grep patterns match the ICMP or ICMP6 echo requests encapsulated by Vxlan.