Difference between revisions of "VPP/BugReports"

From fd.io
< VPP
Jump to: navigation, search
(Image version and operating environment)
 
(28 intermediate revisions by 3 users not shown)
Line 1: Line 1:
=== Introduction ===
+
=== Documentation Moved ===
  
This page describes data which will help make efficient use of everyone's time when dealing with vpp bugs. Before you press the Jira button to create a bug report, please ask yourself whether there's enough information for someone else to reproduce the issue given a reasonable amount of effort.
+
Please see [[https://fd.io/docs/vpp/master/contributing/reportingissues/index.html How To Report an Issue]]
 
+
==== Image version and operating environment ====
+
 
+
Please make sure to include the vpp image version:
+
 
+
vpp# show version verbose
+
vpp v1.0.0-188~geef4d99 built by vagrant on localhost at Wed Feb 24 08:52:13 PST 2016
+
Built in /home/vagrant/git/vpp
+
Compiled with GCC 4.8.4
+
DPDK version is RTE 2.2.0
+
DPDK EAL init arguments: -c 1 -n 4 --socket-mem 1024 --huge-dir /run/vpp/hugepages --file-prefix vpp
+
                          -b 0000:02:00.0 -b 0000:02:01.0 --master-lcore 0
+
 
+
Please attempt to reproduce issues using unmodified vpp engine images.
+
 
+
With respect to the operating environment: if misbehavior involving a specific VM / container / bare-metal environment is involved, please describe the environment in detail:
+
 
+
* Linux Distro (e.g. Ubuntu 14.04.3 LTS, CentOS-7, etc.)
+
* NIC type(s) (ixgbe, i40e, enic, etc. etc.), vhost-user, tuntap
+
* NUMA configuration if applicable
+
 
+
==== "Show" Command Output ====
+
 
+
Every situation is different. If the issue involves a sequence of debug CLI command, please enable CLI command logging, and send the sequence involved. Note that the debug CLI is a developer's tool - '''no warranty express or implied''' - and that we may choose not to fix debug CLI bugs.
+
 
+
Please include "show error" [error counter] output. It's often helpful to "clear error", send a bit of traffic, then "show error" on noisy networks.
+
 
+
Please include ip4 / ip6 / mpls FIB contents ("show ip fib", "show ip6 fib", "show mpls fib", "show mpls tunnel").
+
 
+
Please include "show hardware", "show interface", and "show interface address" output
+
 
+
==== Network Topology ====
+
 
+
Please include a crisp description of the network topology, including L2 / IP / MPLS / segment-routing addressing details. If you expect folks to reproduce and debug issues, this is a must.
+
 
+
At or above a certain level of topological complexity, it becomes problematic to reproduce the original setup.
+
 
+
==== Packet Tracer Output ===
+
 
+
If you capture packet tracer output which seems relevant, please include it:
+
 
+
vpp# trace add dpdk-input 100  # or similar
+
<send-traffic>
+
vpp# show trace
+
 
+
==== Binary API Trace ====
+
 
+
If the issue involves a sequence of control-plane API messages - even a very long sequence - please enable control-plane API tracing. Control-plane API post-mortem traces end up in /tmp/api_post_mortem.<pid>. Please provide a pointer [accessible to the general public!] to the binary API trace. These API traces are especially helpful in cases where the vpp engine is throwing traffic on the floor, e.g. for want of a default route or similar.
+
 
+
==== Core Files ====
+

Latest revision as of 08:52, 4 November 2021

Documentation Moved

Please see [How To Report an Issue]