docs/user-guide/bgpcep-guide/bgp/bgp-user-guide-troubleshooting.rst

   1 .. _bgp-user-guide-troubleshooting:
   2
   3 Troubleshooting
   4 ===============
   5 This section offers advices in a case OpenDaylight BGP plugin is not working as expected.
   6
   7 .. contents:: Contents
   8    :depth: 2
   9    :local:
  10
  11 BGP is not working...
  12 ^^^^^^^^^^^^^^^^^^^^^
  13 * First of all, ensure that all required features are installed, local and remote BGP configuration is correct.
  14
  15 * Check OpenDaylight Karaf logs:
  16
  17 From Karaf console:
  18
  19 .. code-block:: console
  20
  21    log:tail
  22
  23 or open log file: ``data/log/karaf.log``
  24
  25 Possibly, a reason/hint for a cause of the problem can be found there.
  26
  27 * Try to minimise effect of other OpenDaylight features, when searching for a reason of the problem.
  28
  29 * Try to set DEBUG severity level for BGP logger via Karaf console commands, in order to collect more information:
  30
  31 .. code-block:: console
  32
  33    log:set DEBUG org.opendaylight.protocol.bgp
  34
  35 .. code-block:: console
  36
  37    log:set DEBUG org.opendaylight.bgpcep.bgp
  38
  39 Bug reporting
  40 ^^^^^^^^^^^^^
  41 Before you report a bug, check `BGPCEP Jira <https://jira.opendaylight.org/browse/BGPCEP-756?jql=project%20%3D%20BGPCEP%20AND%20component%20%3D%20BGP>`_ to ensure same/similar bug is not already filed there.
  42
  43 Write an e-mail to bgpcep-users@lists.opendaylight.org and provide following information:
  44
  45 #. State OpenDaylight version
  46
  47 #. Describe your use-case and provide as much details related to BGP as possible
  48
  49 #. Steps to reproduce
  50
  51 #. Attach Karaf log files, optionally packet captures, REST input/output