Put helpful info in error logs.

Our organization was having an issue with Agents not connecting to the Agent Gateways after re-configuring our Recast infrastructure.

When troubleshooting, the Agents were logging an error when calling SetupConnection(), reporting that the gateway returned a 503 (Server Unavailable) error.

At the same time, the Agent Gateways were logging a warning stating the "Client certificate failed Recast validation, subject was CN=<device hostname>".

Ultimately, this was due to the RecastAgent.sqlite file located in C:\ProgramData\Recast Software\Recast Agent not being removed on Agent uninstalls. The Agent was referring to the old file configuration to initiate a connection to the new Gateway, rather than updating to the new Management and Gateway servers.

We were referred to this article to resolve the problem: https://docs.recastsoftware.com/help/right-click-tools-troubleshooting-recast-agent-not-connecting

Since this was a known issue, it would have saved so much time and effort to get this product up and running if the error at least referred us to somewhere helpful on the Recast docs site for help.

I am unsure of any other problems that may arise in the future, but having helpful troubleshooting recommendations in the logs themselves would greatly reduce downtime waiting on Recast support when it is a simple matter of removing a known file.