svn commit: r1521608 - /db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita

[ch...@apache.org]

Author: chaase3
Date: Tue Sep 10 19:46:42 2013
New Revision: 1521608

URL: http://svn.apache.org/r1521608
Log:
DERBY-6165  The shutdown documentation should mention that a shutdown attempt could fail if login timeouts are enabled.  

Added paragraph to a Developer's Guide topic.

Patch: DERBY-6165.diff

Modified:
    db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita

Modified: db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita
URL: http://svn.apache.org/viewvc/db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita?rev=1521608&r1=1521607&r2=1521608&view=diff
==============================================================================
--- db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita (original)
+++ db/derby/docs/trunk/src/devguide/tdevdvlp40464.dita Tue Sep 10 19:46:42 2013
@@ -64,6 +64,14 @@ can shut down the database.
 <codeblock><b>// shutting down an authenticated database as database owner</b>
 DriverManager.getConnection(
     "jdbc:derby:securesample;user=joeowner;password=secret;shutdown=true");</codeblock>
+<p>If you previously called the <i>java.sql.DriverManager.setLoginTimeout</i>
+method to enable a login timeout, a shutdown of
+<ph conref="../conrefs.dita#prod/productshortname"></ph> or of an individual
+database can fail under circumstances like the following:</p>
+<ul>
+<li>Network problems which slow down LDAP authentication</li>
+<li>Heavily loaded databases which take a long time time to quiesce</li>
+</ul>
 <p>
 <note type="attention"> 
 It is good practice to close existing connections before shutting down