“Something unexpected occurred: An uncaught server error was thrown. Check the log for details” error after upgrading Puppet Enterprise from 2021.3 to 2021.7

After upgrading Puppet Enterprise, you can’t log in to the PE console, and Puppet runs fail.

Error messages and logs

After upgrading PE, you get this error message in the PE Console:

Something unexpected occurred: An uncaught server error was thrown. Check the log for details. 

Failed agent runs get this error:

# puppet agent -t 
Info: Using environment 'its_unix_production' 
Info: Retrieving pluginfacts 
Info: Retrieving plugin 
Info: Loading facts 
Error: Could not retrieve catalog from remote server: Error 500 on SERVER: Server Error: Failed when searching for node [NODE NAME] failed due to a Node Manager service error. Please check /var/log/puppetlabs/console-services/console-services.log on the node(s) running the Node Manager service for more details. 
Warning: Not using cache on failed catalog 
Error: Could not retrieve catalog; skipping run 

Version and installation information

PE version: 2021.3

Solution

After upgrading PE, LDAP information, such as your password, didn’t migrate to the current version. To update your LDAP information, follow these steps:

1. On the primary server as root run:

   su pe-postgres -c /opt/puppetlabs/server/bin/psql -s /bin/bash 

2. At pe-postgres=# run command:

   \c pe-rbac 
   DELETE from external_access_config where config_type = "LDAP"; 

3. After the run completes, type exit and systemctl restart pe-console-services.

4. Enter your LDAP information in the PE console using our documentation.