|
|
| (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 ====
| + | |
