KB484041: Force no-reuse-LDAP-connection due to crashes in libldap_r.so

There were reports of crashes in the Open LDAP library, libldap_r.so, on the Linux platform. The crashes resulted in the shut down of the Intelligence Server or the restart of the Intelligence Server. A common factor in these cases was that the setting use LDAP connection pool was enabled. This settings shares one LDAP connection handler in multiple threads. Unfortunately, libldap_r.so does not handle multiple thread situations well. As such, turning off the setting to use LDAP connection pool prevents the Intelligence Server from crashing or restarting.
Beginning in Strategy 2020 Update 1, when the Intelligence Server is running on Linux and libldap_r.so is used as the LDAP connectivity library, the setting to use LDAP connection pool is ignored and the LDAP connection is not re-used among LDAP authorizations. 
 

How to Disable Use LDAP Connection Pool

Beginning 2020 Update 1, Strategy recommends turning the use LDAP connection pool setting off when libldap_r.so is used on the Linux platform.
To turn off this setting, you can use Strategy Workstation or Developer.

via Workstatoin

1. Open Strategy Workstation.
2. In the Navigation pane, click Environments.
3. Right-click the connected environment and choose Directory Service > Configure Directory Service.
4. Select the Advanced tab.
5. Use the toggle to disable Reuse Connection.
6. Click Save.

via Developer

In Developer, you can disable this setting using the Intelligence Server Configuration window or using the LDAP Connectivity Wizard.

Disable Using the Intelligence Server Configuration

1. In Developer, right-click your project source and select Configure Strategy Intelligence Server.
2. Go to LDAP > Server.
3. Under LDAP Server Settings, deselect the Use connection pooling checkbox.
4. Click OK.

Disable Using the LDAP Connectivity Wizard

1. In Developer, open the LDAP Connectivity Wizard.
2. Click Next through until you reach the Authentication Options page.
3. Deselect the Use connection pooling checkbox.
4. Click Finish.

Note: This only applies to the Intelligence Server running on the Linux platform when openldap library is used as the LDAP connectivity library.
There is no change on the Intelligence Server running on Windows, where Windows ADS SDK is used as the LDAP connectivity library, since no crashes have been reported when the setting is on.

How to Enable Use LDAP Connection Pool

To enable this setting on the Linux platform, perform the following steps on the Linux machine where the Intelligence Server is running.
Note: It is not recommend to turn on the use LDAP connection pool setting on the Linux platform when openldap library is used as LDAP connectivity library.

1. Add a new environment variable,

   MSTR_USE_LDAP_CONNECTION_POOL

   , with any value. 
2. Restart the Intelligence Server.

If you turn on the use LDAP connection pool setting in this manner, you can turn of the setting by deleting the environment variable.