Environment
Retain (all versions)
Situation
You see an error: "RetainServer-ERROR encountered on item:..."
Resolution
This error means the Retain Server was not able to store a particular message in the SQL database after receiving it from the Retain Worker. There are three main possible causes of this:
- Your database engine is not running or responding. This is usually the case if you see hundreds or thousands or these errors during a job. Make sure MySQL, MSSQL, Oracle or PostreSQL is running and functioning properly. If your database engine was not running or you decide to restart it, we suggest you also restart retain-tomcat to assure the JDBC connection is reestablished.
- The Retain server file system may be in read-only mode. There will be no new log entries. Trying to restart tomcat or touching a file will reveal that the items cannot be changed as the the file system is read-only.
- The email message has incomplete or unexpected data. If this is the case, the Retain Server log will show:
EXCEPTION : com.gwava.exceptions.FatalRetainServerException: Mismatch in length of subtypeParts vs nameParts If you see this "Mismatch" error, please send the RetainServer.log to support for further analysis.
Additional Information
This article was originally published in the GWAVA knowledgebase as article ID 1576.