wiki:ReportingABug

Version 1 (modified by killyourtv, 6 years ago) (diff)

How to Submit a Bug Report

Submitting good bug reports is very important.

Before you Submit any bug

  • If you're reporting a bug in I2P, it is important that you include as many details of the bug as you can. Version information, which is located at the top of http://127.0.0.1:7657/logs, should also be included in any ticket filed.
  • If you're having a problem with the Debian or Ubuntu package, check to see if a new package has been uploaded (sudo apt-get update && sudo apt-get upgrade). If not, continue.
  • If your report is about a crash or a third-party plugin:

Remember: we don't support third-party plugins. We didn't develop those plugins and can't help you with those issues.

  1. Make sure your plugins are of the most current version available.
  1. Disable plugins you have loaded (one by one) until you eliminate the source of the crash.
  • If you're experiencing very high RAM or CPU usage
  1. Make sure you're using a recommended version of Java. Oracle Java Version 7, OpenJDK 7, or IcedTea7 are recommended for most systems. On the Raspberry Pi, use Oracle 8 Early Access. PowerPC users should try IBM SDK 7.
  1. If you're running on plugins such as Seedless or I2P-Bote, try disabling them to see if the problem goes away.

  • If your bug is other than third-party plugin or crash -related (new features, improvements, etc.), follow the steps below.

Steps for Bug Report Submission

  1. Check that your problem is not related to a third-party plugin or a crash (read above). If your problem is related to a crash (whether or not it's also related to a third-party plugin), you will have to get the proper log (read below).
  1. Search for existing bug reports, in order not to submit a duplicated one.
  1. Create a new ticket.

    To file a new ticket, you'll need to log in or create an account first. Unfortunately the old passwords were lost so if you're unable to login to your account you can reset your password here.

Obtaining a thread dump

If asked to obtain a thread dump, the following steps will help you do so.

  1. If you can access the router console (usually at http://127.0.0.1:7657), go to the service tab. In the Debugging section will be a Dump Threads button. Click it.
  2. The thread dump will be visible in the wrapper.log file. The location of wrapper.log will also be listed on the router console's logs page.
  3. Copy & paste the thread dump to http://pastethis.i2p, noting the URL in the ticket, or attach a file with the thread dump to the ticket.

If you cannot load the router console and you're running Linux, OSX, *BSD, or Solaris, try running i2prouter dump to dump the threads to your wrapper.log.