[james-project] 17/18: JAMES-3594 Upgrade instruction note

[bt...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

btellier pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/james-project.git

commit 9c59742e263e1dde15c49b43b484b9d7c93f44bb
Author: Benoit Tellier <bt...@linagora.com>
AuthorDate: Wed Jun 9 09:27:40 2021 +0700

    JAMES-3594 Upgrade instruction note
---
 upgrade-instructions.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/upgrade-instructions.md b/upgrade-instructions.md
index 4dd8d32..bb7049d 100644
--- a/upgrade-instructions.md
+++ b/upgrade-instructions.md
@@ -17,6 +17,24 @@ Changes to apply between 3.5.x and 3.6.x will be reported here.
 Change list:
 
  - [Drop Cassandra schema version prior version 8](#drop-cassandra-schema-version-prior-version-8)
+ - [Adopt UnboundID as a LDAP library](#drop-cassandra-schema-version-prior-version-8)
+ 
+### Adopt UnboundID as a LDAP library
+
+Date 09/06/2021
+
+JIRA: https://issues.apache.org/jira/browse/JAMES-3594
+
+The previous LDAP implementation was based on JNDI and was causing operational concerns by opening a connection
+for each user authentication. These limitations were inherent to JNDI thus to mitigate those we decided to migrate to
+a newer LDAP library: [UnboundID](https://ldap.com/unboundid-ldap-sdk-for-java/).
+
+As part of this migration the following change took place:
+
+ - `useConnectionPool` : Removed. UnboundId implementation relies on a pool by default.
+ - `poolSize` : Added. Allow controlling the count of connection in the pool.
+ 
+The "group restriction" feature should furthermore be considered experimental, its usage is discouraged.
 
 ### Drop Cassandra schema version prior version 8
 

---------------------------------------------------------------------
To unsubscribe, e-mail: notifications-unsubscribe@james.apache.org
For additional commands, e-mail: notifications-help@james.apache.org