summaryrefslogtreecommitdiff
path: root/doc/HOWTO_collect_debug_information.txt
diff options
context:
space:
mode:
authorRussell Bryant <russell@russellbryant.com>2010-11-11 22:14:25 +0000
committerRussell Bryant <russell@russellbryant.com>2010-11-11 22:14:25 +0000
commit893ca656af419e58c8dd675274d4a4d59b22cc03 (patch)
tree8b9307baeee40cb5429b1fada5b3da28ec15b536 /doc/HOWTO_collect_debug_information.txt
parent99a698efb7c0bc8548c032b37692da8ec13be9ea (diff)
Merged revisions 294740 via svnmerge from
https://origsvn.digium.com/svn/asterisk/branches/1.8 ........ r294740 | russell | 2010-11-11 16:13:38 -0600 (Thu, 11 Nov 2010) | 11 lines Remove most of the contents of the doc dir in favor of the wiki content. This merge does the following things: * Removes most of the contents from the doc/ directory in favor of the wiki - http://wiki.asterisk.org/ * Updates the build_tools/prep_tarball script to know how to export the contents of the wiki in both PDF and plain text formats so that the documentation is still included in Asterisk release tarballs. ........ git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@294741 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'doc/HOWTO_collect_debug_information.txt')
-rw-r--r--doc/HOWTO_collect_debug_information.txt89
1 files changed, 0 insertions, 89 deletions
diff --git a/doc/HOWTO_collect_debug_information.txt b/doc/HOWTO_collect_debug_information.txt
deleted file mode 100644
index b9a04ae6b..000000000
--- a/doc/HOWTO_collect_debug_information.txt
+++ /dev/null
@@ -1,89 +0,0 @@
-===============================================================================
-===
-=== HowTo: Collect Debug Information for the Asterisk Issue Tracker
-===
-=== Written by: Paul Belanger
-=== Last updated: 2010-04-12
-===============================================================================
-
-This document will provide instructions on how to collect debugging logs from an
-Asterisk machine, for the purpose of helping bug marshals troubleshoot an issue
-on https://issues.asterisk.org
--------------------------------------------------------------------------------
---- PREREQUISITES
--------------------------------------------------------------------------------
-
-- Asterisk 1.4.30 or greater.
-
--------------------------------------------------------------------------------
---- STEPS
--------------------------------------------------------------------------------
-
-1. Edit the logger.conf file to enable debug output to your filesystem.
-
- Add the following line. The word "myDebugLog" can be changed to anything you
- want, as that is the filename the logging will be written to. A good example
- might be something like: issue_12345_full_log
-
- myDebugLog => notice,warning,error,debug,verbose,dtmf
-
-2. From the Asterisk CLI, restart the logger module:
-
- *CLI> core set verbose 15
- *CLI> core set debug 15
- *CLI> module reload logger
-
- Optionally, if you've used this file to record data previously, then rotate
- the logs:
-
- *CLI> logger rotate
-
-2.1. Depending on your issue, be sure to enable the channel driver logging.
-
- SIP (1.6.0 or higher)
-
- *CLI> sip set debug on
-
- SIP (1.4)
-
- *CLI> sip set debug
-
- IAX2 (1.6.0 or higher)
-
- *CLI> iax2 set debug on
-
- IAX2 (1.4)
-
- *CLI> iax2 set debug
-
-3. Reproduce your issue.
-
-4. Once finished, be sure to disable the extra debbuging:
-
- *CLI> core set verbose 0
- *CLI> core set debug 0
-
-4.1. Again, remember to disable any extra logging if you enabled it in the
- channel driver.
-
- SIP (1.4 or higher)
-
- *CLI> sip set debug off
-
- IAX2 (1.4 or higher)
-
- *CLI> iax2 set debug off
-
-5. Upload the file located in /var/log/asterisk/myDebugLog to the issue tracker.
-
- *** IMPORTANT ***
- Do NOT post the output of your file as a comment. This clutters the issue
- and will only result in your comment being deleted.
-
-6. Disable logging to the filesystem. Edit the logger.conf file and comment out
- or delete the line you added in step 1. Using a semi-colon as the first
- character on the line will comment out the line.
-
- Then reload the logger module like in step 2:
-
- *CLI> module reload logger