KB-1431 "Unable to acquire a Read/Write connection. Safe to retry."

Symptoms

At least once of the following messages in seen in the application server log:

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

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

Cause

This message indicates that the application server sent a request to a particular engine, but did not receive a response within an acceptable time frame. 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 system. 

Action

1. To check the responsiveness, availability, and status of the Appian engine servers, run the appropriate script based on the Appian version.

   Appian 17.2 and prior

   Run the checkengine script to diagnose any potential engine related issues and work to resolve them based on the documentation: <APPIAN_HOME>/server/_scripts/diagnostic/checkengine.bat|.sh.

   Appian 17.3 and above

   Run the status script to diagnose any potential engine related issues and work to resolve them based on the documentation: <APPIAN_HOME>/services/bin/status.bat|.sh.
   
   

2. 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 engine is busy processing work. The request will be retried again 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