Agile Central - On-premises: ALM will not start after configuring LDAP

Document ID : KB000127954
Last Modified Date : 26/02/2019
Show Technical Document Details
Issue:
After configuring LDAP in the control panel and restarting the services, the Agile Central services will no longer start up.
One of the  following errors is observed in the startup.log in /home/appuser/domains/alm/logs/
sh: -DLDAP_URL=ldap://onprem-ad1.rallyonprem.local:389: No such file or directory
2019-02-25 12:25:40 -0700-INFO: Connection refused - connect(2) for "localhost" port 7001. Retries exhausted.
2019-02-25 12:25:40 -0700-ERROR: Java process failed to start correctly!

- or -

Error: Could not find or load main class Admin,CN=Users,DC=rallyonprem,DC=local

Cause:
There can be two causes for this
  1. This can be caused by using certain special characters in the LDAP user password.  Characters that need to be avoided are the greater than symbol (>) and the pipe symbol (|).
  2. Using quote (") characters in the Bind Username DN field
Resolution:
  1. Update the password being used for LDAP connectivity so that it does not contain the special characters > or |
  2. Remove the quotes from the Bind Username DN field