r292 - /website/trunk/FAQ.mdwn

[camrdale-guest at users.alioth.debian.org]

Author: camrdale-guest
Date: Sun Sep  2 22:53:22 2007
New Revision: 292

URL: http://svn.debian.org/wsvn/debtorrent/?sc=1&rev=292
Log:
Added troubleshooting section to FAQ

Modified:
    website/trunk/FAQ.mdwn

Modified: website/trunk/FAQ.mdwn
URL: http://svn.debian.org/wsvn/debtorrent/website/trunk/FAQ.mdwn?rev=292&op=diff
==============================================================================
--- website/trunk/FAQ.mdwn (original)
+++ website/trunk/FAQ.mdwn Sun Sep  2 22:53:22 2007
@@ -84,4 +84,29 @@
 
 [20]: http://en.wikipedia.org/wiki/Port_forwarding
 [30]: http://www.portforward.com/
-[40]: http://www.canyouseeme.org/
+[40]: http://www.canyouseeme.org/
+
+### Troubleshooting
+
+#### Installing a package fails? No torrents are running?
+
+First, make sure there are torrents running. To start them you should 
+have done an `apt-get update` at some point since installing DebTorrent. 
+Go to http://localhost:9988/ (replacing `localhost` with the host that 
+is running the DebTorrent client, and 9988 with the port that you use) 
+to see which torrents are running. If none are, you need to do an 
+`apt-get update` after updating your sources.list file to use 
+DebTorrent. If the proper torrent's are running, then file a bug (see 
+[[BugReporting]])
+
+#### An `apt-get update` is stuck saying "Waiting for headers"?
+
+Wait a bit to make sure it's actually stuck. The DebTorrent downloads 
+occur sequentially and can be quite slow. They also give no indication 
+of the status of their download, so be patient.
+
+If, after waiting a while nothing happens, or APT times out and says an 
+error occurred, you may want to try enabling debugging in APT to 
+determine which download is timing out (it may not be a DebTorrent 
+download, but just a stalled download from a slow mirror). See 
+[[BugReporting]] for how to enable debugging in APT.