---
schema_version: "1"
id: 432359f5e91f5a3563b211388cfd272b11f3869e6d4d0e3fd7dd791e4de095d3
title: Change the Bridge Client Settings
collection: tableau
version: current
locale: en-gb
portal_url: https://docs.salesforce.com/tableau/current/en-gb/online/to_sync_change_computer_site.md
canonical_url: https://help.tableau.com/current/online/en-gb/to_sync_change_computer_site.htm
source_site: help.tableau.com
content_type: documentation
content_hash: 63f4755570b2d836526eaa5cb900fc6207a9578f4e918c50592c6f4bae567f27
description: Change Tableau Bridge client settings using the configuration file.
---
[Skip to main content](#main-content)

# Change the Bridge Client Settings

There are several Bridge client settings that the site admin can configure to change how a client runs.

## Windows Client

For Windows clients, the default location of the Configuration file is `C:\Users\jsmith\Documents\My Tableau Bridge Repository\Configuration\TabBridgeClientConfiguration.txt`. The client must be restarted for any changes made to the configuration file to take effect.

## Bridge for Linux for Containers

The `TabBridgeClientConfiguration.txt` file is generated with default configurations the first time you run the Bridge client.

To make changes to the configuration settings, edit the `TabBridgeClientConfiguration.txt` file, and create a new Docker container with the updated file. For more information about how to create and update a container, see [Containerise an application](https://docs.docker.com/get-started/02_our_app/).

## Bridge legacy schedules

In some cases, a data source owner might be responsible for some of the tasks described in this topic if they maintain their own client to run Bridge legacy schedules.

## Bridge client settings

### serviceConnectionSettings

Configuration: `serviceConnectionSettings`

Options:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>serviceUrl</code></td><td>Tableau site URL.<p><i>Not configurable</i>.</p></td></tr><tr><td><code>proxyServer</code></td><td>Proxy Server and port.<p><i>Configurable</i></p></td></tr></tbody></table>

#### Example

The client must be restarted for any changes made to the configuration file to take effect.

```
"serviceConnectionSettings" : {
	"serviceUrl" : "https://online.tableau.com",
	"proxyServer" : {
	"serverName" : "http://localhost",
	"serverPort" : 8888
	}
```

### connection

Configuration: `connection`

Options:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>connectTimeout</code></td><td>The Bridge client waiting time when trying to connect to Tableau Cloud.<p>Default value: 1 minute</p><p><i>Configurable.</i></p></td></tr><tr><td><code>operationTimeout</code></td><td>The Bridge client waiting time for each server (such as VizPortal) API call after successfully connecting to Tableau Cloud.<p>Default value: 15 minutes</p><p><i>Configurable</i>.</p></td></tr><tr><td><code>maxAttemptsToRedirectHttpRequests</code></td><td>An API call to a server can be redirected from POD to POD. This number specifies the maximum number of redirects per server API call. Default value: 20<p><i>Configurable</i>.</p></td></tr></tbody></table>

#### Example

```
"connection" : {
	"connectTimeout" : "00:01:00",
	"operationTimeout" : "00:15:00",
	"maxAttemptsToRedirectHttpRequests" : 20
	}
```

### dataSourceRefreshSettings

Configuration: `dataSourceRefreshSettings`

Options:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>shutdownTimeoutInSeconds</code></td><td><i>Not configurable</i>.</td></tr><tr><td><code>downloadDataSourcesInterval</code></td><td>The time interval for the temporary downloading of the names of live data sources and extract data sources that are assigned to the client for Bridge legacy schedules.<p>Default value: 30 minutes.<br></p><p><i>Configurable</i>.<br></p></td></tr><tr><td><code>checkRefreshDataSourcesInterval</code></td><td>The time interval for the Bridge client to check data sources assigned to the client to establish if a refresh is needed for Bridge legacy schedules.<p>Default value: 5 seconds</p><p><i>Configurable</i>.</p></td></tr><tr><td><code>extractRefreshTimeout</code></td><td>Enforces a time limit for refreshes performed by the client. The timeout limit is the longest allowable time for a single extract to complete a refresh before it's cancelled by the client. If an extract refresh is cancelled as a result of reaching the timeout limit, you will see a message in the client and an email alert will be sent to the data source owner.<p>Default value: 24 hours.</p><p>For virtual connections, the default extract refresh timeout limit is 2 hours and is controlled by Tableau Cloud. The time limit can’t be controlled by the Bridge client.</p><p><i>Configurable</i>.</p></td></tr><tr><td><code>maxRemoteJobConcurrency</code></td><td>Specifies the maximum number of concurrent remote refresh jobs (PDS Extracts) allowed for a single client.<p>Default value: 10</p><p>Minimum: 1</p><p>Maximum: 90</p><p><i>Configurable</i>.</p><p>To apply this setting:</p><ol><li value="1"><p>Unlink the client.</p></li><li value="2"><p>Relink the client and sign in.</p></li><li value="3"><p>Assign the client to a named pool.</p></li></ol><p><b>Note:</b> For Windows users, if the application reports an incorrect error requiring a different action after changing this setting, manually clear the bridge credentials from Windows Secure Storage.</p></td></tr><tr><td><code>JSONLogForExtractRefresh</code></td><td>When set to true, the client generates an additional log file in JSON format. The log captures the metrics of extract refreshes, for both Bridge legacy and Remote refreshes, with one line per extract.<p>The format of the JSON log file is readable by <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> and can be used as a data source to create live vizzes. For more information, see <a href="https://help.tableau.com/current/pro/desktop/en-gb/examples_json.htm">JSON File</a>.</p><p>An example of the log file is: <code>
							ExtractRefreshMetrics_&lt;timestamp&gt;.json</code><br>Changing the value of this configuration option requires a restart of the Bridge client.</p><p>The <code>loggerSettings </code>configuration options apply to the JSON log file.</p><p>Default value: false</p><p><i>Configurable</i>.</p></td></tr><tr><td><code>dataSources</code></td><td>Applies to Bridge legacy schedule refresh jobs. Not user editable.<br>Provides a list of mapped local file locations for file-based data sources.<p><i>Not configurable</i></p></td></tr></tbody></table>

#### Example

To govern the misuse of extracts or refreshes, you can enforce a time limit using `extractRefreshTimeout`, also known as a timeout limit, for refreshes performed by a client. The timeout limit is the longest allowable time for a single extract to complete a refresh before it's cancelled by the client.

**Note**: For extracts of virtual connections, the default for `extractRefreshTimeout` is 2 hours and can’t be controlled by the Bridge client. As an alternative, you can modify the virtual connection to refresh within the default 2-hour window or switch to a published data source.

By default, the timeout limit for a client is set to 24 hours. You can change the timeout limit for a client through the Bridge configuration file. If an extract refresh is cancelled as a result of reaching the timeout limit, you will see a message in the client and an email alert will be sent to the data source owner.

The client must be restarted for any changes made to the configuration file to take effect.

```
"dataSourceRefreshSettings" : {
	"shutdownTimeoutInSeconds" : "00:00:30",
	"downloadDataSourcesInterval" : "00:30:00",
	"checkRefreshDataSourcesInterval" : "00:00:05",
	"extractRefreshTimeout" : "24:00:00",
	"maxRemoteJobConcurrency" : 10,
	"JSONLogForExtractRefresh" : false,
	"dataSources" : [
	]
}
```

### loggerSettings

Configuration: `loggerSettings`

Options:

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"><col></colgroup><tbody><tr><td><code>maxLogFileSizeInMB</code></td><td>Maximum size of the log files in MB. When a log file exceeds the size limit, a new log file is created.<p>Default value: 25 MB.</p><p><i>Configurable</i>.</p></td></tr><tr><td><code>maxBackupLogFileCount</code></td><td>Maximum number of allowed Bridge log files. When the number of log files exceed the limit, the oldest log file is deleted.<p>Default is 40.<br></p><p><i>Configurable</i>.<br></p></td></tr><tr><td><code>remoteRequestLogFileLifeSpan</code></td><td>For each Bridge Refresh job that is sent to the client, a new set of log files is created:<p><code>tabbridgeclijob_&lt;process_id, and if the data source is JDBC-based: fjprotocolserver_&lt;process_id&gt;, and stdout_jprotocolserver_&lt;process_id&gt;</code>.</p><p>By default, the maximum amount of time the log files remain in the Logs folder before being deleted is 8 hours if the number of log files exceeds <code>maxBackupLogFileCount</code>. Otherwise, these log files remain indefinitely while the number of log files is less than or equal to <code>maxBackupLogFileCount</code>.</p><p><code>&lt;process_id&gt;</code> represents the Windows process ID.</p><p>Default value: 8 hours</p><p><i>Configurable</i>.</p></td></tr></tbody></table>

#### Example

The client creates logs of activities as part of its normal operation. You can use these logs to monitor refreshes, troubleshoot issues with Bridge or if Tableau Support requests logs from you to help resolve an issue.

You can manage the size of Bridge log files or increase the time log files remain before being deleted in the TabBridgeClientConfiguration.txt file.

Note: Log files named tabprotosrv\* vary from other Bridge log files. The maximum size is 1 MB and the maximum number of allowed log files is 8,192. These values are also not configurable.

```
"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
	"maxBackupLogFileCount" : 40,
	"remoteRequestLogFileLifeSpan" : "00:00:00"
}
```

### dataSyncRestartInterval

Configuration: `dataSyncRestartInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Sets the restart interval of the Data Sync.</p><p><i>Configurable</i>.</p></td></tr></tbody></table>

### internetConnectionMonitorInterval

Configuration: `internetConnectionMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Interval for Bridge to ping the internet to determine if there is a valid connection.</p><p>Default value: 30 seconds</p><p><i>Configurable</i>.</p></td></tr></tbody></table>

### secureStorageMonitorInterval

Configuration: `secureStorageMonitorInterval`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>Interval for Bridge to determine secure storage.<p><i>Not Configurable</i>.</p></td></tr></tbody></table>

#### cleanUpTempDirOnStartUp

Configuration: `cleanUpTempDirOnStartUp`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td><p>Determines whether to remove the temp files when the Bridge client starts.</p><p>Default value: true</p><p><i>Configurable</i>.</p></td></tr></tbody></table>

#### JSONLogForLiveQuery

Configuration: `JSONLogForLiveQuery`

<table class="table--plain" style="width: 100%;"><colgroup><col style="width: 210px;"></colgroup><tbody><tr><td>When set to true, the client generates an additional log file in JSON format. The log captures the metrics of live query request, with one line per extract<p>The format of the JSON log file is readable by <span class="mc-variable Variables.TabsProductDesktop variable">Tableau Desktop</span> and can be used as a data source to create live vizzes. For more information, see JSON File.</p><p>Changing the value of this configuration option requires a restart of the Bridge client.</p><p>Default value: true</p><p><i>Configurable</i>.</p></td></tr></tbody></table>

#### Example

```
"dataSyncRestartInterval" : "24:00:00",
"internetConnectionMonitorInterval" : "00:00:30",
"secureStorageMonitorInterval" : "00:00:30",
"cleanUpTempDirOnStartUp" : true,,
"JSONLogForLiveQuery" : true
}
```

## Default configuration file

To copy the default configuration file, click the **Copy to clipboard** icon in the upper right corner.

```
{
	"serviceConnectionSettings" : {
		"serviceUrl" : "https://online.tableau.com/",
		"connection" : {
			"connectTimeout" : "00:01:00",
			"operationTimeout" : "00:15:00",
			"maxAttemptsToRedirectHttpRequests" : 20
		},
	},
	"dataSourceRefreshSettings" : {
		"shutdownTimeoutInSeconds" : "00:00:30",
		"downloadDataSourcesInterval" : "00:30:00",
		"checkRefreshDataSourcesInterval" : "00:00:05",
		"extractRefreshTimeout" : "24:00:00",
		"maxRemoteJobConcurrency" : 10,
		"JSONLogForExtractRefresh" : false,
		"dataSources" : [
		]
	},
	"loggerSettings" : {
	"maxLogFileSizeInMB" : 25,
		"maxBackupLogFileCount" : 40,
		"remoteRequestLogFileLifeSpan" : "08:00:00"
	},
	"dataSyncRestartInterval" : "24:00:00",
	"internetConnectionMonitorInterval" : "00:00:30",
	"secureStorageMonitorInterval" : "00:00:30",
	"cleanUpTempDirOnStartUp" : true,
	"JSONLogForLiveQuery" : true
}
```

## Other articles in this section