Database Retry Settings

You can control how DataSync handles failed database connection attempts by adjusting settings in the shareappsettings.json file.

Locate the shared settings file

All retry settings are configured in the shared application settings file, typically named shareappsettings.json. This file is usually found at the root of your DataSync installation and governs connection behavior for all DataSync APIs.

Handle failed database connections

The key section controlling this behavior is DbRetrySettings. This section determines how DataSync reacts if it cannot connect to its required databases during startup. The retry options listed here only affect the initial connection attempts when the service starts.

You can adjust the following properties:

Property	Description
RetryCounts	Number of times DataSync will attempt to reconnect after a failed attempt.
RetryDelay	Time interval to wait between retries, formatted as hh:mm:ss.

There are no strict minimum or maximum values; set them to fit your environment.

Example

If you want DataSync to keep trying to connect to your databases during startup — up to 10 attempts, with a 10‑second pause between each attempt — configure the settings as shown below. With this configuration, DataSync will retry for a total of 100 seconds before reporting a connection failure.

"DbRetrySettings": {
    "RetryCounts": 10,
    "RetryDelay": "00:00:10"
}

note

DataSync APIs are resilient. If a dependency (such as authentication services) is temporarily unavailable, DataSync will automatically retry and resume operation when the service becomes available. No additional manual action is needed.