You are currently reviewing an older revision of this page.

KB-XXXX Unable to acquire a Read connection. Safe to retry

Symptoms

The following error in seen in the application server log:

com.appiancorp.kougar.driver.exceptions.SafeRetryException: Unable to acquire a Read connection. Safe to retry.

Cause

The error indicates that the application server is unable to communicate with the engines within a reasonable amount of time. This error is often seen when starting up an environment. It can also be seen at other times when the environment is already up and running, but there is a high load on the engines/the engines are busy processing work.

Action

If you are running Appian version 17.2 or prior, run the checkengine script to diagnose any potential engine related issues: <APPIAN_HOME>/server/_scripts/diagnostic/checkengine.bat|.sh.

If you are running Appian version 17.3 or above, run the status script to diagnose any potential engine related issues: <APPIAN_HOME>/services/bin/status.bat|.sh.

If the engines are up and running without any issues, the error message is simply indicating that the particular request could not be handled at the time because the engines are busy processing work and will be retried later once resources are freed up. Review the performance logs from the time that the error was encountered to see if there was an unusually high load on the system. 

Affected Versions

This article applies to all versions of Appian.

Last Reviewed: December 2017