Navigation


Changes between Version 4 and Version 5 of Troubleshooting


Ignore:
Timestamp:
Mar 3, 2011, 5:12:28 PM (13 years ago)
Author:
Administrator
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Troubleshooting

    v4 v5  
    22= Troubleshooting =
    33
    4 This page describes a few steps that you can follow in order to track a problem with {{{freeDiameter}}}.
     4This page describes a few steps that you can follow in order to better understand a problem you are encountering with {{{freeDiameter}}}.
    55
    66== Gathering debug messages ==
     
    88If your problem occurs following a reproductible sequence of events, you may get useful information by:
    99 * Compiling the framework with DEBUG support.
    10    This is done by selecting for example CMAKE_BUILD_TYPE=Debug
    11    during the build configuration
     10   This is done by building freeDiameter with CMAKE_BUILD_TYPE=Debug option
    1211   (see [wiki:Installation#cmakeflags] for more information).
    1312
     
    1514   Default is level 1 : INFO.
    1615   The level is increased by passing one or more {{{-d}}} flags on the command line.
    17    In most cases, {{{-ddd}}} should give enough feedback to get a precise
     16   In many cases, {{{-dd}}} or {{{-ddd}}} should give enough feedback to get a precise
    1817   idea of what is going on.
    1918   The levels are defined in [source:freeDiameter/include/freeDiameter/libfdproto.h libfdproto.h] as follow:
     
    2322   * FULL (2) : Additional information, allowing to follow the execution.
    2423   * ANNOYING (4) : Very verbose level, including for example loops contents.
    25    * FCTS (6) : Traces entry in most functions, with their parameters.
     24   * FCTS (6) : Traces entry inside most framework functions, with their parameters.
    2625   * CALL (9) : Traces almost all function calls.
    2726
    2827   The levels above 3 will result in a lot of information being displayed,
    29    and a slowing of the daemon's execution. These must be used with care.
     28   and a slowing of the framework's execution. These must be used with care.
    3029   To get level 3 for example (assuming default is 1), use:
    3130{{{
     31#!sh
    3232$ freeDiameterd -dd
    3333}}}
     
    3939== Reporting a problem ==
    4040
    41 Please use the help function of this site first to look for similar reports. This searches both the existing tickets and the mailing-list archives.
     41Please use the "Search" function of this site first to look for similar reports. This searches both the existing tickets and the mailing-list archives.
    4242
    43 If your problem is not already solved, please report to the support mailing-list: help@freediameter.net. If possible, include as much useful information as possible, including: your configuration file (if relevant, strip / alter any confidential information), the debug messages showing the problem, the Operating System on which you are running the framework, the steps to reproduce the problem. In some cases, a network capture (realized with ''wireshark'' for example) may also be helpful.
     43If your problem is not already solved, please report to the support mailing-list: help@freediameter.net. If possible, include as much useful information as possible, including:
     44 * your configuration file -- if relevant, strip / alter any confidential information
     45 * the debug messages showing the problem
     46 * the Operating System on which you are running the framework
     47 * the steps to reproduce the problem.
     48In some cases, a network capture (realized with ''wireshark'' for example) may also be helpful.
    4449
    4550----