Network¶
This guide explains how to troubleshoot network issues with the Anapaya appliances.
Current configuration and state¶
The current network interfaces configuration can be retrieved from the appliance using the following command:
appliance-cli get config -f body.config.interfaces
To get the VPP configuration, use the following command:
appliance-cli get config -f body.config.system.vpp
To get the current network interfaces state of the appliance, use the following command:
appliance-cli info network
Note
This command is available starting with version v0.36.0.
This lists the network interfaces known to the appliance, their current state and configuration.
Note
All interfaces that are present in the configuration should be present in the state. If an interface is missing, it is likely that the configuration is incorrect.
Known issues¶
VRRP¶
When VRRP is configured, the appliance will not respond to ICMP echo requests (pings) on the VRRP IP address. This is expected behavior.
Common problems¶
IOMMU¶
If possible, IOMMU should be enabled on the appliance. This can be done in the system section.
If IOMMU is not supported by the hardware platform and it is enabled, the appliance will not be able to configure the network interfaces correctly.
If IOMMU is enabled, but the appliance is not rebooted after the change, the appliance will not be able to configure the network interfaces correctly.
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 will not be able to configure the network interfaces correctly.
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¶
Bond interfaces are configured in the bond interfaces section. Run
appliance-cli get debug/vpp/bond
to get the current state of configured bond interfaces.
VRRP¶
VRRP can be configured on most interface types with VPP driver. To check the current state of VRRP, run
appliance-cli get debug/vpp/vrrp --raw
One appliance should indicate state Master and the other appliance should
indicate state Backup.