/usr/share/doc/libcommons-httpclient-java/docs/troubleshooting.html is in libcommons-httpclient-java-doc 3.1-14.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"><html><head><title>HttpClient - Trouble Shooting HttpClient</title><style type="text/css" media="all">
@import url("./style/maven-base.css");
@import url("./style/maven-theme.css");@import url("./style/project.css");</style><link rel="stylesheet" href="./style/print.css" type="text/css" media="print"></link><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"></meta><meta name="author" content="Adrian Sutton"></meta><meta name="email" content="adrian@ephox.com"></meta></head><body class="composite"><div id="banner"><a href="http://jakarta.apache.org/" id="organizationLogo"><img alt="Apache Software Foundation" src=""></img></a><a href="http://jakarta.apache.org/httpcomponents/httpclient-3.x/" id="projectLogo"><img alt="HttpClient" src="./images/httpclient_logo.png"></img></a><div class="clear"><hr></hr></div></div><div id="breadcrumbs"><div class="xleft">Last published: 18 August 2007
<span class="separator">|</span> Doc for 3.1
</div><div class="xright"></div><div class="clear"><hr></hr></div></div><div id="leftColumn"><div id="navcolumn"><div id="menuOverview"><h5>Overview</h5><ul><li class="none"><a href="features.html">Features</a></li><li class="none"><a href="news.html">News</a></li><li class="none"><a href="status.html">Status</a></li><li class="none"><a href="downloads.html">Download</a></li><li class="none"><a href="http://wiki.apache.org/jakarta-httpclient/" class="externalLink" title="External Link">Wiki</a></li><li class="expanded"><a href="userguide.html">User Guide</a><ul><li class="none"><a href="authentication.html">Authentication Guide</a></li><li class="none"><a href="charencodings.html">Character Encodings</a></li><li class="none"><a href="cookies.html">Cookies</a></li><li class="none"><a href="exception-handling.html">Exception Handling</a></li><li class="none"><a href="logging.html">Logging Guide</a></li><li class="none"><a href="methods.html">Methods</a></li><li class="none"><a href="performance.html">Optimization Guide</a></li><li class="none"><a href="preference-api.html">Preference Architecture</a></li><li class="none"><a href="redirects.html">Redirects Handling</a></li><li class="none"><a href="http://svn.apache.org/viewvc/jakarta/httpcomponents/oac.hc3x/trunk/src/examples/" class="externalLink" title="External Link">Sample Code</a></li><li class="none"><a href="sslguide.html">SSL Guide</a></li><li class="none"><a href="threading.html">Threading</a></li><li class="none"><strong><a href="troubleshooting.html">Trouble Shooting</a></strong></li><li class="none"><a href="tutorial.html">Tutorial</a></li></ul></li><li class="none"><a href="developerguide.html">Developer Guide</a></li></ul></div><div id="menuProject_Documentation"><h5>Project Documentation</h5><ul><li class="none"><a href="index.html">About</a></li><li class="collapsed"><a href="project-info.html">Project Info</a></li><li class="collapsed"><a href="maven-reports.html">Project Reports</a></li><li class="none"><a href="development-process.html">Development Process</a></li></ul></div><div id="legend"><h5>Legend</h5><ul><li class="externalLink">External Link</li><li class="newWindow">Opens in a new window</li></ul></div><a href="http://maven.apache.org/" title="Built by Maven" id="poweredBy"><img alt="Built by Maven" src="./images/logos/mavenlogo_builtby_w.png"></img></a></div></div><div id="bodyColumn"><div class="contentBox"><div class="section"><a name="Introduction"></a><h2>Introduction</h2>
<p>This document outlines some of the techniques that often help when
trying to track down a problem in <em>HttpClient</em>. Please try the suggestions
on this page before emailing the user or dev lists with questions. If
none of these things help, please provide the information they provide to
help the developers track down the problem.</p>
</div><div class="section"><a name="Things_To_Try"></a><h2>Things To Try</h2>
<ol>
<li>Try connecting with a normal browser and make sure the server gives
the right response.</li>
<li>If you're using a proxy server try without it if possible.</li>
<li>Try the same code on a different server (preferably running
different server software).</li>
<li>Check that your code matches the general pattern for using
<em>HttpClient</em> as described in the <a href="tutorial.html">tutorial</a>.</li>
<li>Set the <code>User-Agent</code> request header to masquerade <em>HttpClient
</em> as a popular browser such as IE or Firefox. Certain web sites are optimized
to work with just one or a number of specific browser applications. These sites
frequently reject requests originating from user agents they do not recognize.
For example, setting the <code>User-Agent</code> request header to <code>
Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.0)</code> would deceive the target
server into believing that the request was issues by Microsoft Internet Explorer
6.0 on Windows 2000.
</li>
<li>Set the <a href="logging.html">logging level</a> to debug and check
the output for the cause of the problem.</li>
<li>Enable the <a href="logging.html">wire trace</a> and follow the
communication between the client and server to determine where the
problem is occurring.</li>
<li>Consult the "Known limitations and problems" section of the
<a href="sslguide.html#Known%20limitations%20and%20problems">SSL Guide</a>
and the <a href="authentication.html#Known%20limitations%20and%20problems">
Authentication Guide</a> to see if this is a known problem and follow the
instructions given in these resources</li>
<li>Use telnet or netcat to manually send the request to the server.
This is particularly useful once you think you know what the problem is
and you want to easily test that changing what <em>HttpClient</em> sends will
fix it.</li>
<li>Use netcat in listen mode to act as the server and check how
<em>HttpClient</em> handles various responses.</li>
<li>Try updating to the latest nightly build of <em>HttpClient</em>. Bugs
happen and they are generally fixed pretty quickly so testing against
the latest build is often worthwhile.</li>
</ol>
</div><div class="section"><a name="Asking_For_Help"></a><h2>Asking For Help</h2>
<p>If you've tried the things above and still can't work out how to fix
the problem, it might be time to contact the <a href="mail-lists.html">mailing list</a> for support. All questions, bug
reports etc should be directed to the HttpClient user list.</p>
<p>When you do send off the email, please include as much detail as you
can, particularly inlined wire trace logs as there is almost
nothing we can do to help without them.
If you are seeing exceptions being thrown, the full stack
trace is essential to tracking down the problem. Any of the information
you gained from the "things to try" section above are probably worth
mentioning.</p>
</div><div class="section"><a name="Reporting_Bugs"></a><h2>Reporting Bugs</h2>
<p>If you're fairly certain that the problem is a bug in <em>HttpClient</em>,
log it in <a href="http://issues.apache.org/jira/browse/HTTPCLIENT" class="externalLink" title="External Link">JIRA</a>.
Make sure you spend some time searching the existing bugs to make sure it
hasn't already been logged. If you're unsure about whether or not to log
something in JIRA, it's probably worth bringing it up on the
developer mailing list to clarify the situation.</p>
</div></div></div><div class="clear"><hr></hr></div><div id="footer"><div class="xright">© 2001-2007, Apache Software Foundation</div><div class="clear"><hr></hr></div></div></body></html>
|