Author: luke1410
Date: Fri May 20 19:53:16 2016
New Revision: 1744791
URL: http://svn.apache.org/viewvc?rev=1744791&view=rev
Log:
Add a troubleshooting section to 1.9 to help users tracing down problems
related to proxies when locking/unlocking multiple files.
* docs/release-notes/1.9.html
(troubleshooting): Add new section including http-pipelining issue
description.
Approved by: brane
Modified:
subversion/site/publish/docs/release-notes/1.9.html
Modified: subversion/site/publish/docs/release-notes/1.9.html
URL:
http://svn.apache.org/viewvc/subversion/site/publish/docs/release-notes/1.9.html?rev=1744791&r1=1744790&r2=1744791&view=diff
==============================================================================
--- subversion/site/publish/docs/release-notes/1.9.html (original)
+++ subversion/site/publish/docs/release-notes/1.9.html Fri May 20 19:53:16 2016
@@ -38,6 +38,8 @@
>Many enhancements and bug fixes</a></li>
<li><a href="#issues"
>Known issues in the release</a></li>
+ <li><a href="#troubleshooting"
+ >Troubleshooting issues specific to this release</a></li>
</ul>
<p>Apache Subversion 1.9 is a superset of all previous Subversion
@@ -1451,6 +1453,54 @@ protocol.
</div> <!-- issues -->
+<div class="h2" id="troubleshooting">
+<h2>Troubleshooting issues specific to this release
+ <a class="sectionlink" href="#troubleshooting"
+ title="Link to this section">¶</a>
+</h2>
+
+<p>Subversion 1.9 introduces new features and makes use of new techniques
+which can trigger problems not encountered in previous versions. In contrast to
+known issues, things listed here are not due to some bug or issue in Subversion
+itself and therefore cannot be fixed with a new patch release.
+This section lists all known problems and provides instructions to solve them,
+if they occur.</p>
+
+<div class="h3" id="http-pipelining-issue">
+<h3>Lock/Unlock errors related to HTTP pipelining
+ <a class="sectionlink" href="#http-pipelining-issue"
+ title="Link to this section">¶</a>
+</h3>
+
+<p>Subversion 1.9.0 introduces the use of HTTP pipelining for locking/unlocking
+multiple files. While SVN detects whether HTTP pipelining is supported (and
+falls back to non HTTP pipelining mode, if it isn't), issues can arrise, if
+there are flaws or bugs with any of the protocols/applications involved in
+processing pipelined HTTP requests.</p>
+
+<p>Especially, if there are older proxies present in the network topology, it's
+possible that you run into issues, since being a technology which was
+introduced in HTTP/1.1 (and the full performance benefit is not expected unless
+you are using HTTP/2), this feature might have not been extensively tested by
+your proxy vendor.</p>
+
+<p>To troubleshoot whether the proxy is causing an issue, try to lock/unlock
+multiple files bypassing the proxy. If that works, please get in touch with
+the proxy vendor to notify him about the problem and ask for support.</p>
+
+<p>It's also appreciated, if you would let the SVN developers know about the
+effected proxy via the users mailing list so this troubleshooting section can
+be updated.</p>
+
+<p>At the moment there is one potentially known proprietary proxy running into
+this issue: Java-SSL-tunnel. See
+<a
href="http://tortoisesvn.tigris.org/ds/viewMessage.do?dsForumId=4061&dsMessageId=3171337";>Tortoise
SVN mailing list</a>
+.</p>
+
+</div> <!-- http-pipelining-issue -->
+
+</div> <!-- troubleshooting -->
+
<div class="h2" id="svn-1.7-deprecation">
<h2>Subversion 1.7.x series no longer supported
<a class="sectionlink" href="#svn-1.7-deprecation"
