Treating Heartbeat "Unknown Errors" as Connection Failures
The Secret Server "Heartbeat Unknown Error to Unable to Connect Translation (regex)" setting can translate UnknownError heartbeat errors into connection errors based on text, such as the error code, in the error message. Using a regular expression, which you define, Secret Server scans heartbeat UnknownError messages for specific text strings. When there is a match, Secret Server changes the UnknownError to an "Unable to Connect" heartbeat error. This setting is useful if a custom command error is interpreted as UnknownError but the message indicates it actually was unable to connect. The translated connection error will cause Secret Server to attempt another heartbeat.
Figure: Heartbeat Unknown Error to Unable to Connect Translation (regex) Setting
Logic:
(RPC UnknownError) AND (Regex match in error message) => RPC status changed to "Unable to Connect"
Example:
.*error code is 10060.*
(any error with the code 10060 changes the RPC status to "Unable to Connect")
Procedure
To configure the unknown errors to trigger connection failures:
-
Go to Admin > Remote Password Changing. The Remote Password Changing Configuration page appears:
-
Click the Configure Password Changers button. The Password Changers Configuration page appears:
-
Click the link for the desired password type. Its Account page appears:
-
If necessary, click the Advanced Settings link.
-
Click the pencil icon next to Heartbeat Unknown Error to Unable to Connect Translation (regex). The Value text box appears.
-
Determine the desired text string to search for.
-
Type the desired regex in the Value text box.
-
Click the Save icon next to the text box