Tip

This is the documentation for the 23.06 version. Looking for the documentation of the latest version? Have a look here.

TNSR 22.10 Release Notes

About the TNSR 22.10 Release

This is a regularly scheduled TNSR software release including new features and bug fixes.

TNSR 22.10 revision 2

There is a minor revision to the initial release, TNSR software version 22.10-2. This revision corrects update URLs in the ISO image and includes an OpenSSL security update.

Note

This is not a point release or new full release, but a rebuild of TNSR 22.10 to address errata.

For users already running TNSR 22.10-1, use the Updating via the shell method to pull in the latest updates for Ubuntu and TNSR to get 22.10-2. Afterward, use the following command to ensure key TNSR packages are updated to the latest revisions:

$ sudo apt install tnsr=22.10-2 tnsr-dataplane-netns=22.10-2

This does not apply to users upgrading from 22.06 to 22.10-2 as that process will pull in the latest version of the packages automatically.

General

Changes

Changes in TNSR software version 22.10

ACLs

  • Added: Include clixon show acl output in tnsr-diag [8957]

CLI

  • Changed: Remove deprecated CLI commands from 22.06 release [7909]

  • Fixed: BGP as-path objects cannot be deleted from the running configuration [8382]

  • Fixed: Incorrect CLI commands generated for trace match UDP port configuration output [8397]

  • Fixed: CLI ospf and ospf6 modes do not offer names of route-map entries for help list or tab completion [8988]

DHCP Client

  • Fixed: Default gateway received via DHCP is not added to the routing table when the interface uses a non-default VRF [7254]

  • Fixed: Changing VRF for an interface configured as a DHCP client does not trigger dhclient restart [8689]

Dataplane

  • Fixed: Multiple large routing table insertions crash VPP [8286]

  • Changed: Update VPP to 22.06 stable branch [8437]

  • Changed: Set vfio-pci as default UIO driver on AWS [8483]

  • Fixed: VPP crash with IPsec when using IPSECMB and 6 workers [8938]

  • Added: Option to enable interrupt mode for dispatching asynchronous cryptographic operations [9030]

General

  • Added: Script to backup/restore configuration and certificates (tnsr-backup) [4903]

  • Fixed: Cannot commit a candidate database which removes tunnel next-hop entries [8759]

IPsec

  • Added: Certificate-based authentication for IPsec [1105]

  • Added: Support for IPv6 IPsec tunnel endpoints [2396]

  • Fixed: Buffer exhaustion with TCP/UDP when using c62x QAT device prevents traffic from passing [6711]

  • Fixed: CLI requires integrity algorithm on IPsec tunnel using AEAD cipher when a PRF should be sufficient [6926]

  • Added: Support for ChaCha20-Poly1305 encryption with IPsec [8340]

  • Fixed: strongSwan and swanctl log errors about failing to load some modules [8914]

  • Changed: Update strongswan to 5.9.8 [9089]

Interfaces

  • Added: Support for interrupt mode on hardware interfaces [7802]

  • Fixed: Validation does not prevent setting interface MTU below 1280 when an IPv6 address is configured [8246]

  • Fixed: Interface link MTU can be implicitly decreased below 1280 when an IPv6 address is configured [8377]

  • Fixed: Remove unnecessary decap-next-node VXLAN option [8434]

  • Added: Support for new Intel i226 interface PHY identifiers in DPDK [8908]

  • Fixed: Interrupt mode state is not correctly reflected in Clixon [9033]

LACP

  • Fixed: LACP status includes incorrect PTX state values [8630]

NAT

  • Fixed: Value of “Last Used” field in output of show nat sessions verbose is expressed in seconds since VPP startup [8277]

  • Fixed: Endpoint Independent NAT mode is limited to 259 addresses in a NAT pool [8706]

  • Fixed: NAT pool content in show nat output is not in IP address order [8708]

Operating System

  • Changed: Upgrade TNSR base OS to Ubuntu Jammy 22.04.1 [8684]

PKI

  • Fixed: Validate PKI key names [8371]

  • Added: SSH key management [9036]

RESTCONF

  • Fixed: RESTCONF returns invalid JSON output for NTP state raw values [8347]

  • Fixed: Validate RESTCONF configuration database values [8370]

Routing

  • Fixed: Change made to a prefix list used in an OSPF3 route map does not affect redistributed routes [3644]

  • Added: Resource Public Key Infrastructure (RPKI) support for BGP [4349]

  • Added: BGP import vrf commands to import routes from another VRF [4763]

  • Added: Policy Based Routing (ACL Based Forwarding) [6782]

  • Fixed: Extended BGP community lists do not work as expected [7772]

  • Fixed: RPC error message when using exact prefix match in show route table command for non-existent route [8088]

  • Changed: Update FRR from upstream [8372]

  • Fixed: Route maps currently used by dynamic routing protocols can be removed [8387]

  • Fixed: OSPF server configuration incorrectly includes a redistribute ospf command [8426]

  • Added: Display table ID when looking up a route for a prefix [8482]

  • Fixed: Objects referred to by a route map can be removed [8489]

  • Fixed: Route map set aggregator as command does not function properly [8779]

  • Fixed: Route map set src option is not applied by FRR [8896]

  • Fixed: FRR daemon VTY address bindings are inconsistent [8901]

  • Fixed: All BGP neighbors reset when one is enabled or disabled with cluster-id set [9041]

  • Fixed: Unable to configure match community <comm-list-name> exact-match [9095]

Tunnel Protocols

  • Added: IPIP tunnel support [3904]

  • Changed: Support for WireGuard DoS mitigation and cookie processing in VPP [5825]

  • Fixed: Only the first peer in a WireGuard instance functions properly [8106]

  • Fixed: Incorrect UDP checksum of IPv6 WireGuard packets [8163]

  • Added: WireGuard remote access and roaming support [8339]

  • Fixed: show tunnel next-hops accumulates duplicate entries when the dataplane restarts [8618]

  • Changed: Improve error processing in WireGuard backend code [8671]

  • Fixed: VPP crashes while editing an IPIP tunnel if there is an IPv6 tunnel next-hop configured [8776]

  • Fixed: WireGuard handshake packets can be sent when the tunnel interface is down [8780]

Known Issues

Known Issues in TNSR software version 22.10

BFD

  • Unable to setup delayed option for an existing BFD session via REST [2709]

  • IPv6 session is not restored when virtual direct link gets disabled/enabled [4916]

  • TNSR cannot commit configuration candidate database loaded from a file if it contains a BFD session for an interface that does not exist [7150]

Bridge

  • Bridge domain ARP entries cannot be displayed via CLI [2378]

  • Bridge domain ARP entries cannot be removed via CLI [2380]

  • Bridge domain mac-age value cannot be removed via CLI [2381]

  • Bridge domains and split-horizon groups are not functioning properly [5500]

  • Bridging fails with virtual interfaces as members [7762]

CLI

  • CLI does not always return from a shell prompt [2651]

  • Deleting the startup configuration database does not fully remove the active configuration [3723]

  • Specifying interface to traceroute requires root privileges [5376]

  • Input validation of unbound message cache slabs value does not work as expected [5472]

  • CLI and RESTCONF behavior are different for no bgp default ipv4-unicast [6303]

  • RIP information does not contain a legend for kernel routes [7230]

  • Interface vrf command is missing argument description when there are no VRFs defined [8941]

Counters

  • Contradictory output of detailed counters on bond interface in ‘broadcast’ mode [8351]

DHCP Server

  • CLI offers to delete mandatory variable in DHCP server subnet configuration [5240]

  • DHCP4 Kea config-file output shows VPP TAP interface names in its configuration instead of TNSR interface names [5264]

  • Unable to setup a custom DHCP option with certain data types in the record [5299]

DNS

  • show system output does not contain DNS resolver parameters [5397]

Dataplane

  • Link state is always up when using e1000 network drivers [2831]

  • Cannot create rx-queues for interfaces on KVM and VirtualBox [3674]

  • Static routes with an interface as the next hop using resolve-via-attached appear to break dataplane ARP [5259]

  • TNSR on AWS does not pass traffic when using the uio_pci_generic driver [7015]

  • IPv6 Neighbor Discovery starts to fail until Linux neighbor cache is cleared [9135]

General

  • Non-root users cannot access the FRR log file [4826]

  • Unable to specify TNSR interface as a source in ping and traceroute commands via REST [5605]

  • Startup entry is not created in configuration history log [7400]

  • Cannot commit a candidate configuration database if a tap interface is present [7458]

Host

  • Cannot remove an IP address assigned to a host interface during the installation process via TNSR CLI [3013]

  • Cannot configure the default gateway for host namespace via TNSR CLI [3702]

  • VRF interface for a custom route table persists in the operating system after restarting services [4866]

  • dns-resolver configured for host namespace remains in system after removing from TNSR [7830]

  • dns-resolver configuration values for host namespace remain in resolv.conf after restarting TNSR [7975]

  • package commands use apt, which prints console warnings [9127]

IPsec

  • IPsec daemon does not support using non-default VRF entries [7266]

  • Cannot disable IPsec dpd-interval option [8012]

  • Cannot configure IPsec with manual key type [8396]

  • Error when creating IPsec tunnel via RESTCONF with tunnel-enable set [8432]

  • IPsec tunnel without a child SA does not appear in IPsec state data [8433]

Installation

  • TNSR installer fails if interfaces are configured with IP addresses but have no Internet connectivity [7807]

Interfaces

  • VLAN subinterfaces do not work with virtio network drivers on KVM [2189]

  • Unable to set IPv6 link-local address on an interface [2394]

  • Unable to create subinterface with dot1q any tag [2652]

  • Invalid routes remain in table when next-hop IP address is no longer directly connected [3161]

  • Reassembly timeout is not working when full IP reassembly is configured [3269]

  • Shallow virtual reassembly cannot be disabled when it is implicitly enabled by other features [3361]

  • Second fragment of a packet is not virtually reassembled when max-reassemblies is set to 1 [3384]

  • Unable to delete a MAC address explicitly set for the TNSR side of a TAP interface [4433]

  • XG-1541 link speed auto-negotiation incorrect with direct connected interfaces [5323]

  • Errors indicate TNSR is attempting to assign a MAC address to IPsec ipipX interfaces [6285]

  • L3 packets can be sent from bridged interfaces [6975]

  • Unable to setup DPDK uio_pci_generic driver on XG-1541 [6981]

  • Unable to setup DPDK vfio-pci driver on XG-1537 [6985]

  • Unable to setup DPDK vfio-pci driver on various environments [6989]

  • TAP instance tcpdump method only captures received packets [7137]

  • Unable to delete a non-existent multicast-interface from VXLAN tunnel configuration [7278]

  • Pings between IPIP interfaces become intermittent when BGP is applied to them [7392]

  • Interface IP address is shown in IPv4 route table instead of associated subnet [7511]

  • Setting a new MTU value does not affect the MRU for IPv6 packets [8245]

  • Unable to delete link MTU from an interface when default MTU is set less than 1280 [8837]

Memif

  • Unable to connect to memif interface using default socket [4448]

NAT

  • Twice-NAT does not work [1023]

  • 1:1 NAT drops packets with ttl=2 from inbound interface [2849]

  • Full IP reassembly does not work with MAP [3386]

  • MAP-T adds bogus zeroes when translating short IPv4 to IPv6 [3460]

  • NAT pool route table option only available when specifying a range [3628]

  • Packets larger than 2034 bytes are dropped when performing IPv4 to IPv6 MAP translation [3742]

  • MAP-T domain usage causes IPv6 traffic class value to always be copied from IPv4 ToS value [3774]

  • TCP MSS value is not applied to IPv4 packets when IPv6 to IPv4 decapsulation is performed on MAP-E BR [3783]

  • MAP does not relay IPv6 ICMP error messages to IPv4 [3809]

  • NAT static mappings for ICMP do not work [4373]

  • NAT static mappings for TCP/UDP protocol on any port result in translation for port 0 instead [4384]

  • NAT static mappings assume external port 0 when port is omitted [4432]

  • Packets not destined to a NAT pool are dropped when NAT simple mode is configured with out2in-dpo option [4927]

  • Full IPv4 reassembly doesn’t work with NAT endpoint-independent mode [5476]

  • Cannot increase NAT Sessions per thread past ~1e6 [6550]

  • Dataplane SIGSEGV crash and backtrace when exceeding NAT session limit [6551]

  • Expired NAT sessions become active again when increasing the timeout value [7090]

  • NAT sessions do not expire in endpoint-independent mode [7098]

  • Cannot commit a clean candidate configuration database if NAT static mapping is configured [7286]

  • Unable to establish NAT hairpin connection [8014]

  • NAT in endpoint-dependent mode drops packets when it cannot identify the correct worker thread [8262]

  • Routing through NAT in EI mode doesn’t work if NAT outside interface is IPSec tunnel [8333]

NTP

  • NTP does not properly handle IPv6 restrictions [4626]

  • Delay in CLI display of NTP configuration when NTP has noquery set [6818]

  • Interfaces in the TNSR NTP configuration are not validated when generating the NTP daemon configuration [7153]

Neighbor / ARP / NDP

  • Packet loss during ARP transactions [2868]

  • The MAC address of a static IPv6 neighbor cannot be changed [4454]

RESTCONF

  • Adding a user via RESTCONF requires a password even when providing an ssh key [2875]

  • RESTCONF “pretty-printed” JSON contains incorrect indentation [3521]

  • OSPF interfaces are not validated when configured via RESTCONF [3528]

  • Cannot change GRE tunnel type to or from ERSPAN via RESTCONF [4353]

  • Response of /restconf/data/ and /restconf/data/netgate-interface:interfaces-state/ does not include any of *-table [5399]

  • RESTCONF allows configuring dataplane options for non-existent devices [5748]

  • RESTCONF route-state response does not contain actual state data [7115]

  • RESTCONF dataplane service does not work on interfaces in a non-default VRF [7265]

  • History version count does not match the count of REST configuration requests if they are sent without a delay [7440]

Routing

  • Changing default metric for OSPF server does not result in update on other routers [2586]

  • OSPF RIB is not updated when the ABR type is changed between standard and shortcut [2699]

  • BGP updates for new prefixes ignore the advertisement-interval value and are sent every 60 seconds [2757]

  • RIP “timeout” timer does not work [2796]

  • ttl-security hops value can be set when ebgp-multihop is already configured [2832]

  • BGP session soft reset option does not work for IPv6 peers [2833]

  • extended-nexthop capability isn’t being negotiated between IPv6 BGP peers [2850]

  • Unable to verify received prefix-list entries via CLI when using ORF capability [2864]

  • BGP network backdoor feature isn’t working without service restart [2873]

  • BGP next-hop attribute aren’t being sent unmodified to the eBGP peer when route-server-client option is configured [2940]

  • Unable to verify dynamic BGP peer information from TNSR CLI [3044]

  • Unable to delete OSPF3 config for an interface [3481]

  • TNSR does not prevent creating static routes for directly connected networks [3813]

  • OSPF conditional default route injection does not work [3846]

  • Unable to verify received routes when high number of routes received via BGP [3918]

  • TNSR allows OSPF network type for a loopback interface, which is rejected by FRR [4800]

  • Unable to set a custom path for the FRR log file [4825]

  • Reverting to the startup configuration doesn’t restore packet forwarding for BGP over IPsec prefixes [5321]

  • RIP route-map-filter option does not filter routes [5910]

  • Unable to disable IPv4 AF without BGP service restart [6393]

  • BGP failover logs “Failed to delete neighbor” error from linux-cp [6400]

  • OSPF virtual-link authentication does not work [6601]

  • Unable to remove OSPF virtual-link configuration [6962]

  • OSPF can announce interfaces from other VRFs on initial configuration [7002]

  • Cannot add a static recursive route [7010]

  • VPP crashes on applying custom VRF to loopback interface used in OSPF [7056]

  • Creating route-map, prefix-list, or access-list entries takes longer than expected [7068]

  • Cannot disable logging of adjacency changes for OSPF6 if detail option is set [7097]

  • Routes that exactly overlap an interface link route are accepted by CLI but are problematic [7101]

  • OSPF neighbor adjacency is established in wrong VRF in VirtualBox [7144]

  • Interfaces in the TNSR RIP configuration are not validated when generating the FRR RIP daemon configuration [7155]

  • Interfaces in TNSR route-map entries are not validated when generating the FRR daemon configurations [7156]

  • Interfaces in the TNSR OSPF configuration are not validated when generating the FRR OSPF daemon configuration [7177]

  • Interfaces in the TNSR BGP configuration are not validated when generating the FRR BGP daemon configuration [7218]

  • Dynamic routing protocols lose static routes after link they resolve through goes down and then comes up [7357]

  • OSPF logging for some options does not work if logging level is set explicitly [7411]

  • BGP debug option updates in <peer> does not filter messages for selected peer [7476]

  • BGP session does not become active after interface goes down and recovers [7501]

  • OSPF6 continues to redistribute connected/kernel routes resolved via interface with linkdown status [7624]

  • BGP address family neighbor option maximum-prefix restart does not work correctly [7709]

  • Malfunction of BGP process after entering maximum-prefix restart without the basic maximum-prefix limit command [7748]

  • OSPF6 does not advertise loopback address to another area if the loopback is configured first [7757]

  • Cannot set BGP unsuppress-map option for IPv6 neighbor [7760]

  • Routes remain in table after interface with VRRP configured is marked down until dataplane is restarted [7790]

  • OSPF stops working after configuring mtu-ignore option on an interface [8085]

  • Routes do not match by route-map if match criteria is set to ip next-hop ... [8148]

  • Output of show conf differs for route-map [8375]

  • Route map source-protocol match condition matches routes from any source [8381]

  • redistribute table configuration in RIP/OSPF does not affect route redistribution [8390]

  • Cannot change distance for one BGP prefix [8690]

  • Forwarding address from OSPF6 LSA5 is not installed as the next hop for the route [8732]

  • BGP bestpath med missing-as-worst command does function correctly [8805]

  • OSPFv3 repeatedly drops connection on AWS when redistribution is configured [8822]

  • Route Map with IPv6 Access List does not filter redistributed OSPF6 routes [8857]

  • Route-Map set src option does not function correctly [9045]

  • show route displays no routes for a VRF until it is placed on an interface [9073]

  • RPKI settings do not get applied until the BGP service is restarted [9122]

  • Column headers in BGP routes table are not aligned with data when RPKI status is available [9123]

  • FRR cannot connect to RPKI cache server if a route to it does not exist in default VRF [9146]

  • The redistribute kernel and import vrf BGP options do not work at the same time if the static route is redistributed with an output interface in a third-party VRF [9147]

  • ABF policy does not forward IPv6 packets when ipv6-next-hop is set to local [9149]

  • Applying a subsequent route map with import vrf cancels a previous applied route map [9156]

SNMP / IPFIX / Prometheus

  • Prometheus filters with non-alphanumeric characters can cause HTTP requests to fail [5467]

  • Prometheus filters containing spaces cannot be removed [5470]

  • SNMP does not work on interfaces in a non-default VRF [7261]

SPAN

  • Span config disappears/appears when repeatedly restarting dataplane [6526]

  • Incorrect error message when requesting SPAN info from a missing interface [7209]

  • SPAN mirroring can not be disabled [7560]

  • SPAN does not work correctly for outbound packets on VLAN subinterface [7801]

Static Routes

  • Static route next-hop options stack when updated, but only one works [5326]

  • Static route description is not showing up in show commands or REST state data [5478]

  • Static route overwrites kernel route in the operating system routing table [7215]

  • Transit traffic goes to an interface with inactive link when there is another (active) path [8041]

Tunnel Protocols

  • Changes to an existing VXLAN tunnel configuration do not apply until the dataplane is restarted [1778]

  • TNSR IPv6 interface address does not appear in traceroute when next-hop is IPsec tunnel interface [5178]

  • VxLAN with multicast destination does not pass traffic [6491]

  • GRE interface configuration remains in running config after changing GRE tunnel ID [7050]

  • Configuring option route-table in a WireGuard peer does not affect next-hop lookup of the endpoint address [8070]

  • VPP processes packets received on disabled tunnel interfaces [8111]

  • WireGuard tunnel interfaces still function with a tunnel next-hops entry having an incorrect next-hop-address [8256]

  • IPv6 VXLAN does not work over WireGuard IPv6 tunnel [8360]

  • Tunnel next-hop entries do not function in non-default VRFs [8653]

  • Incorrect WireGuard tunnel next-hop after roaming [8764]

clixon

  • log_upgrade does not print cxobj paths correctly in tnsr-upgrade.log [4747]

  • clixon_backend exhausts memory while displaying high amount of routes [5226]

  • Configuration upgrade does not run when loading configuration via history [6968]

  • Unable to set up a password that starts and finishes with a double quotation mark [7571]

  • Unable to set up a password that contains a backslash symbol [7572]