Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?

 
ON THIS PAGE
 

Troubleshoot using the vRouter CLI

Read this topic to learn about the various troubleshooting commands available in the vRouter CLI including vif, dpdkinfo, flow, rt, nh commands.

Accessing the vRouter CLI

Refer to Access vRouter CLI to learn how to access the vRouter CLI.

Troubleshooting via the vRouter CLI

You can run commands in the CLI to learn about the state of the vRouter.

Verify vRouter Interfaces via the vif Command

Here is the list of options available for the vif command.

The command shown below allows you to see which interfaces are present on the vRouter:

View the running configuration of the vRouter

To see the status of the vRouter, enter the following command in the vRouter CLI:

The output contains several elements.

Table 1: vRouter Status Attributes
Flag Meaning
--allow=<PCI Id>

The PCI ID of fabric and fabric workload interfaces. More than one ID can appear in the output. These IDs serve as an allowlist.
--ddp

Enable Intel DDP support.

We enable DDP by default in the values.yaml file in the vRouter.

Note:

The Intel XL710 NIC does not support DDP.

View status and statistics of DPDK using the dpdkinfo Command

The dpdkinfo command provides insight into the status and statistics of DPDK. The dpdkinfo command has many options. The following sections describe the available options and the example output from the dpdkinfo command. You can run the dpdkinfo command only from within the vRouter-agent CLI.

The command dpdkinfo -c shows the Lcores assigned to DPDK VF fabric interfaces and the queue ID for each interface.

The command dpdkinfo -m all shows all of the memory pool information.

The command dpdkinfo -n 3 displays statistical information for a specific interface.

The command dpdkinfo -x 3 displays extended statistical information for a specific interface.

Troubleshooting L2 Configuration and Statistics

View L2 Configuration and Statistics

  • Here is the list of options for the bd command.

  • Verify the bridge domain information on vRouter using the bd command:
  • The command below shows the MAC addresses that the vRouter has dynamically learned. Broadcast route is created for each bridge domain. This command also shows the broadcast route's next hop.
  • From the command output above, broadcast route in bridge domain (BD) 2 points to next hop 31. You can get more details about the next hop using the nh --get nhID command.

    The highlighted Oif values correspond to vif1 and vif6 interfaces that are a part of BD 2.

  • The Layer 2 stats are available using the vif utility.
  • Use the following command to clear L2 stats:

Packet Tracing via the dropstats Command

The vRouter tracks the packets that it drops and includes the reason for dropping them. The table below shows the common reasons for vRouter to drop a packet. When you execute the dropstats command, the vRouter does not show a counter if the count for that counter is 0.

Table 2: Dropstats Counters
Counter Name Meaning
L2 bd table drop No interfaces in bridge domain
L2 untag pkt drop Untagged packet arrives on trunk or sub-interface
L2 Invalid Vlan Packet VLAN does not match interface VLAN
L2 Mac Table Full No more entries available in the MAC table
L2 ACL drop Packet matched firewall filter (ACL) drop rule
L2 Src Mac lookup fail Unable to match (or learn) the source MAC address

Example output from the dropstats command looks like:

Troubleshooting L3 Configuration and Statistics

Display routes and next hops using the rt and nh Commands for L3 Deployments

Here is the list of options available for the rt command.

For example, for IPv4 traffic:

For example, for IPv6 traffic:

Display all active flows using the flow Command for L3 Deployment

Use the flow command to display all active flows in a system. For example:

Use the command to display all routes in a VRF. The command enables you to inspect the next hops that are known by the vRouter. Next hops tell the vRouter the next location to send a packet in the path to its final destination.