Skip to main content

Network

This guide explains how to troubleshoot network issues with the Anapaya appliances.

Important notes​

warning

Do not use Linux networking tools such as ip or ifconfig to modify the network configuration of the appliance, this will leave the appliance in an inconsistent state. Always use the appliance CLI to modify the configuration.

warning

The ethtool command can be used to query and control network device driver and hardware settings. It is only supported for interfaces with the LINUX driver. Using ethtool on interfaces with the VPP_* driver is not supported.

Current configuration and state​

Use the appliance CLI to get an overview of the network state:

appliance-cli info network

This lists the network interfaces known to the appliance, their current state and configuration.

Inspect the network interfaces configuration:

appliance-cli get config -f body.config.interfaces
must be consistent with the state

All interfaces that are present in the configuration should be present in the state. If there is inconsistency, the configuration is probably incorrect.

Inspect the VPP configuration:

appliance-cli get config -f body.config.system.vpp
tip

You may also use the ip command to inspect the network state of the appliance.

Known issues​

VRRP​

When VRRP is configured, the appliance does not respond to ICMP echo requests (pings) on the VRRP IP address. This is an expected behavior.

Common problems​

IOMMU​

If possible, enable IOMMU on the appliance. Refer to System for doing this.

  • If IOMMU is not supported by the hardware platform and it is enabled, the appliance cannot correctly configure the network interfaces.
  • If IOMMU is enabled, but the appliance is not rebooted after the change, the appliance cannot correctly configure the network interfaces.

Virtual functions​

  • Virtual functions can only be configured on hardware platforms that support them. If the appliance is configured to use virtual functions, but the hardware platform does not support them, the appliance cannot correctly configure the network interfaces.
  • Virtual functions cannot be configured on virtual machines.
  • Virtual functions cannot be configured on top of virtual functions.

Missing DPDK support​

If an interface is configured with the VPP_DPDK driver but the NIC does not support DPDK, the appliance will not be able to configure the network interface.

This has the effect that the appliance will not be able to configure the network interface with the corresponding IP address.

Investigate advanced configurations​

Bond interfaces​

Refer to Configuration reference for detailed information on the configuration of bond interfaces and to Bond interfaces configuration for an example of configuring bond interfaces.

Get the current state of configured bond interfaces:

appliance-cli get debug/vpp/bond

VRRP​

VRRP can be configured on most interface types with VPP driver. Check the current state of VRRP:

appliance-cli get debug/vpp/vrrp --raw

One appliance should indicate state Master and the other appliance should indicate state Backup.