GreLwtTunnelRecipe

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

Bases: PauseFramesHWConfigMixin, OffloadSubConfigMixin, BaseTunnelRecipe

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

               .--------.
        .------| switch |-----.
        |      '--------'     |
        |                     |
.-------|------.      .-------|------.
|    .--'-.    |      |    .--'-.    |
|    |eth0|    |      |    |eth0|    |
|    '----'    |      |    '----'    |
|      | |     |      |      | |     |
|  ----' '---  |      |  ----' '---  |
|  gre tunnel  |      |  gre 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 Gre 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 Gre 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)]

get_packet_assert_config(ping_config): The packet assert test configuration contains filter for gre protocol and grep patterns to match the ICMP or ICMP6 echo requests encapsulated by Gre.

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.