[DERBY-6165] The shutdown documentation should mention that a shutdown attempt could fail if login timeouts are enabled.

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 10.10.1.1
• Fix Version/s: 10.10.2.0, 10.11.1.1
• Component/s: Documentation
• Urgency: Normal
• Assignee: Camilla Haase
• Reporter: Richard N. Hillegas
• Created: 10/Apr/13 16:59
• Updated: 16/Apr/14 02:41
• Resolved: 10/Sep/13 19:56

Description

Database/engine shutdown can fail if a login timeout is enabled via DriverManager.setLoginTimeout(). This can happen, for example, for the following reasons:

A) Network problems which slow down LDAP authentication.

B) Heavily loaded databases which need a lot of time to quiesce.

We should document this fact in the "Shutting down Derby or an individual database" section of the Derby Developer's Guide. This issue was discussed on the following derby-dev email thread: http://apache-database.10148.n7.nabble.com/should-attempts-to-shut-down-the-database-timeout-if-they-exceed-DriverManager-setLoginTimeout-N-td128966.html