2022-04-01 12:16:46 +02:00
<!DOCTYPE html>
< html class = "writer-html5" lang = "en" >
< head >
< meta charset = "utf-8" />< meta name = "generator" content = "Docutils 0.17.1: http://docutils.sourceforge.net/" />
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" />
2022-10-31 23:26:32 +00:00
< title > Troubleshooting — BNG Blaster 0.8 documentation</ title >
2022-04-01 12:16:46 +02:00
< link rel = "stylesheet" href = "_static/pygments.css" type = "text/css" />
< link rel = "stylesheet" href = "_static/css/theme.css" type = "text/css" />
< link rel = "stylesheet" href = "_static/tabs.css" type = "text/css" />
< script data-url_root = "./" id = "documentation_options" src = "_static/documentation_options.js" ></ script >
< script src = "_static/jquery.js" ></ script >
< script src = "_static/underscore.js" ></ script >
< script src = "_static/doctools.js" ></ script >
< script src = "_static/js/theme.js" ></ script >
< link rel = "index" title = "Index" href = "genindex.html" />
< link rel = "search" title = "Search" href = "search.html" />
2022-11-02 10:25:07 +00:00
< link rel = "next" title = "Frequently Asked Questions" href = "faq.html" />
2023-02-15 21:24:51 +00:00
< link rel = "prev" title = "Performance Guide" href = "performance.html" />
2022-04-01 12:16:46 +02:00
</ head >
< body class = "wy-body-for-nav" >
< div class = "wy-grid-for-nav" >
< nav data-toggle = "wy-nav-shift" class = "wy-nav-side" >
< div class = "wy-side-scroll" >
< div class = "wy-side-nav-search" >
< a href = "index.html" class = "icon icon-home" > BNG Blaster
< img src = "_static/rtbrick_logo.png" class = "logo" alt = "Logo" />
</ a >
< div role = "search" >
< form id = "rtd-search-form" class = "wy-form" action = "search.html" method = "get" >
< input type = "text" name = "q" placeholder = "Search docs" />
< input type = "hidden" name = "check_keywords" value = "yes" />
< input type = "hidden" name = "area" value = "default" />
</ form >
</ div >
</ div >< div class = "wy-menu wy-menu-vertical" data-spy = "affix" role = "navigation" aria-label = "Navigation menu" >
< ul class = "current" >
< li class = "toctree-l1" >< a class = "reference internal" href = "install.html" > Installation</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "quickstart.html" > Quickstart Guide</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "interfaces.html" > Interfaces</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "access/index.html" > Access Protocols</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "routing/index.html" > Routing Protocols</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "streams.html" > Traffic Streams</ a ></ li >
2023-06-30 11:07:35 +00:00
< li class = "toctree-l1" >< a class = "reference internal" href = "http.html" > HTTP Emulation</ a ></ li >
2022-04-01 12:16:46 +02:00
< li class = "toctree-l1" >< a class = "reference internal" href = "reports.html" > Reports</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "configuration/index.html" > Configuration</ a ></ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "api/index.html" > API/CLI</ a ></ li >
2022-05-02 17:40:37 +02:00
< li class = "toctree-l1" >< a class = "reference internal" href = "controller.html" > Controller</ a ></ li >
2023-02-15 21:24:51 +00:00
< li class = "toctree-l1" >< a class = "reference internal" href = "performance.html" > Performance Guide</ a ></ li >
2022-04-01 12:16:46 +02:00
< li class = "toctree-l1 current" >< a class = "current reference internal" href = "#" > Troubleshooting</ a >< ul >
< li class = "toctree-l2" >< a class = "reference internal" href = "#logging" > Logging</ a ></ li >
2022-04-06 23:03:25 +02:00
< li class = "toctree-l2" >< a class = "reference internal" href = "#pcap" > PCAP</ a >< ul >
< li class = "toctree-l3" >< a class = "reference internal" href = "#wireshark-plugin" > Wireshark Plugin</ a ></ li >
</ ul >
</ li >
2022-04-01 12:16:46 +02:00
</ ul >
</ li >
< li class = "toctree-l1" >< a class = "reference internal" href = "faq.html" > Frequently Asked Questions</ a ></ li >
</ ul >
</ div >
</ div >
</ nav >
< section data-toggle = "wy-nav-shift" class = "wy-nav-content-wrap" >< nav class = "wy-nav-top" aria-label = "Mobile navigation menu" >
< i data-toggle = "wy-nav-top" class = "fa fa-bars" ></ i >
< a href = "index.html" > BNG Blaster</ a >
</ nav >
< div class = "wy-nav-content" >
< div class = "rst-content" >
< div role = "navigation" aria-label = "Page navigation" >
< ul class = "wy-breadcrumbs" >
< li >< a href = "index.html" class = "icon icon-home" ></ a > » </ li >
< li > Troubleshooting</ li >
< li class = "wy-breadcrumbs-aside" >
< a href = "_sources/troubleshooting.rst.txt" rel = "nofollow" > View page source</ a >
</ li >
</ ul >
< hr />
</ div >
< div role = "main" class = "document" itemscope = "itemscope" itemtype = "http://schema.org/Article" >
< div itemprop = "articleBody" >
< section id = "troubleshooting" >
< h1 > Troubleshooting< a class = "headerlink" href = "#troubleshooting" title = "Permalink to this headline" > </ a ></ h1 >
< section id = "logging" >
2023-02-06 22:10:49 +00:00
< span id = "id1" ></ span >< h2 > Logging< a class = "headerlink" href = "#logging" title = "Permalink to this headline" > </ a ></ h2 >
2022-10-31 23:26:32 +00:00
< p > The BNG Blaster can log events to the standard output
or the logging window of the interactive courses interface.
2022-11-02 14:27:01 +00:00
Those events could be also logged into files using the argument
2022-04-01 12:16:46 +02:00
< code class = "docutils literal notranslate" >< span class = "pre" > -L</ span > < span class = "pre" > < file> </ span ></ code > .</ p >
2022-10-31 23:26:32 +00:00
< p > Per default, only events classified as < cite > info</ cite > or < cite > error</ cite > are logged.
2022-04-01 12:16:46 +02:00
The following list shows all supported logging options.</ p >
< ul class = "simple" >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > debug</ span ></ code > : debug events</ p ></ li >
2022-11-02 14:27:01 +00:00
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > info</ span ></ code > : informational events</ p ></ li >
2022-04-01 12:16:46 +02:00
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > error</ span ></ code > : error events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > igmp</ span ></ code > : igmp events with join and leave time</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > io</ span ></ code > : interface input/output events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > pppoe</ span ></ code > : pppoe events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > pcap</ span ></ code > : PCAP related events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > ip</ span ></ code > : log learned IP addresses</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > loss</ span ></ code > : log traffic loss with sequence number</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > l2tp</ span ></ code > : log L2TP (LNS) events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > dhcp</ span ></ code > : log DHCP events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > isis</ span ></ code > : log ISIS events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > bgp</ span ></ code > : log BGP events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > tcp</ span ></ code > : log TCP events</ p ></ li >
2022-11-02 14:27:01 +00:00
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > lag</ span ></ code > : log link aggregation (LAG) events</ p ></ li >
< li >< p >< code class = "docutils literal notranslate" >< span class = "pre" > dpdk</ span ></ code > : log DPDK events</ p ></ li >
2022-04-01 12:16:46 +02:00
</ ul >
< div class = "highlight-none notranslate" >< div class = "highlight" >< pre >< span ></ span > $ sudo bngblaster -C test.json -L test.log -l ip -l isis -l bgp
</ pre ></ div >
</ div >
</ section >
< section id = "pcap" >
2023-02-06 22:10:49 +00:00
< span id = "capture" ></ span >< h2 > PCAP< a class = "headerlink" href = "#pcap" title = "Permalink to this headline" > </ a ></ h2 >
2022-04-01 12:16:46 +02:00
< p > You can start the BNG Blaster with the argument < code class = "docutils literal notranslate" >< span class = "pre" > -P</ span > < span class = "pre" > < file> </ span ></ code >
2022-10-31 23:26:32 +00:00
to capture all traffic sent and received by the BNG Blaster
2022-04-01 12:16:46 +02:00
into a single PCAP file. This file includes all traffic from all
interfaces in use with proper meta header to filter by interface
names.</ p >
2022-10-31 23:26:32 +00:00
< p > This helps to verify if traffic is received or how it has been received.
2022-04-01 12:16:46 +02:00
Some network interfaces drop the most outer VLAN which can be easily
verified using the capture file.</ p >
2022-04-06 23:03:25 +02:00
< p > The configuration option < code class = "docutils literal notranslate" >< span class = "pre" > capture-include-streams</ span ></ code > allows to
2022-11-08 21:43:35 +00:00
include or exclude (default behavior) traffic streams from capture.</ p >
2023-09-15 07:11:54 +00:00
< div class = "highlight-json notranslate" >< div class = "highlight" >< pre >< span ></ span >< span class = "p" > {</ span >
< span class = "w" > </ span >< span class = "nt" > " interfaces" </ span >< span class = "p" > :</ span >< span class = "w" > </ span >< span class = "p" > {</ span >
< span class = "w" > </ span >< span class = "nt" > " capture-include-streams" </ span >< span class = "p" > :</ span >< span class = "w" > </ span >< span class = "kc" > true</ span >
< span class = "w" > </ span >< span class = "p" > }</ span >
< span class = "p" > }</ span >
2022-04-06 23:03:25 +02:00
</ pre ></ div >
</ div >
2022-11-02 14:27:01 +00:00
< p > Traffic streams send or received on threaded interfaces will be also not captured.
All other traffic is still captured on threaded interfaces.</ p >
2022-04-06 23:03:25 +02:00
< section id = "wireshark-plugin" >
< h3 > Wireshark Plugin< a class = "headerlink" href = "#wireshark-plugin" title = "Permalink to this headline" > </ a ></ h3 >
< p > Traffic streams generated with the BNG Blaster include the
2022-11-02 10:25:07 +00:00
< a class = "reference internal" href = "streams.html#bbl-header" >< span class = "std std-ref" > BNG Blaster Header</ span ></ a > which can be analyzed
2022-04-06 23:03:25 +02:00
with the Wireshark BNG Blaster Header Dissector.</ p >
< p > Download the LUA dissector script
< a class = "reference external" href = "https://github.com/rtbrick/bngblaster/tree/main/wireshark" > bbl_header.lua</ a >
2022-10-31 23:26:32 +00:00
and start Wireshark as shown below from the directory where the script is placed.</ p >
2022-04-06 23:03:25 +02:00
< div class = "highlight-none notranslate" >< div class = "highlight" >< pre >< span ></ span > $ wireshark -X lua_script:bbl_header.lua
</ pre ></ div >
</ div >
</ section >
2022-04-01 12:16:46 +02:00
</ section >
</ section >
</ div >
</ div >
< footer >< div class = "rst-footer-buttons" role = "navigation" aria-label = "Footer" >
2023-02-15 21:24:51 +00:00
< a href = "performance.html" class = "btn btn-neutral float-left" title = "Performance Guide" accesskey = "p" rel = "prev" >< span class = "fa fa-arrow-circle-left" aria-hidden = "true" ></ span > Previous</ a >
2022-11-02 10:25:07 +00:00
< a href = "faq.html" class = "btn btn-neutral float-right" title = "Frequently Asked Questions" accesskey = "n" rel = "next" > Next < span class = "fa fa-arrow-circle-right" aria-hidden = "true" ></ span ></ a >
2022-04-01 12:16:46 +02:00
</ div >
< hr />
< div role = "contentinfo" >
2023-01-13 16:02:11 +00:00
< p > © Copyright 2020-2023, RtBrick, Inc..</ p >
2022-04-01 12:16:46 +02:00
</ div >
Built with < a href = "https://www.sphinx-doc.org/" > Sphinx</ a > using a
< a href = "https://github.com/readthedocs/sphinx_rtd_theme" > theme</ a >
provided by < a href = "https://readthedocs.org" > Read the Docs</ a > .
</ footer >
</ div >
</ div >
</ section >
</ div >
< script >
jQuery ( function () {
SphinxRtdTheme . Navigation . enable ( true );
});
</ script >
</ body >
</ html >
