How to Configure Your Confluence Cloud Connector Using Web.config
Confluence Data Center Connector
Like all BA Insight connectors, the Confluence connector has a web.config file that can be used to make specific, advanced modifications to your connector.
Caution! Modify your connector's web.config file only when necessary.
-
This file does not contain settings that are commonly changed.
-
Make changes to this file with caution.
Location of Web.config File
The web.config file is located at <ConnectorRoot>\WebService\Web.config.
Web.config File Details
The Confluence connector web.config file is shown below.
- The application settings can be found around line 20.
.NET Framework
- The .NET Framework version is set by the property
targetFramework
on lines 5 and 6 in the example below. - To use the connector as it is, you must have .NET Framework version 4.7.2 installed.
- If you have a higher .NET version and you want to keep it, then after installing the connector you must update the .net version in web.config:
- Change the property
targetFramework
to match the installed version of .NET Framework installed on your host machine.
Settings Reset
Keep in mind that the web.config file resets each time the connector is (re)installed.
Confluence Cloud Connector
Like all BA Insight connectors, the Confluence connector has a web.config file that can be used to make specific, advanced modifications to your connector.
Modify your connector's web.config file only when necessary.
This file does not contain settings that are commonly changed. Make changes to this file with caution.
Location of Web.config File
The web.config file is located at <ConnectorRoot>\WebService\Web.config.
Web.config File Details
The Confluence connector web.config file application settings are described in the table below. The application settings can be found around line 20.
Setting | Description | Example |
---|---|---|
httpTimeOut | This setting specifies a timeout limit, in seconds, for an HTTP request. | <add key="httpTimeOut" value="100"/> |
pageSize | This setting specifies the number of items that can be requested from confluence on one call. | <add key="pageSize" value="100"/> |
maxRetryCount | This setting specifies the maximum number of retries for a request. | <add key="maxRetryCount" value="5"/> |
sleepUntilNextRetryInSeconds | This setting specifies an amount, in seconds, to delay a retry request by. This excludes “Too many requests” errors). | <add key="sleepUntilNextRetryInSeconds" value="1"/> |
firstRetryDelaySeconds | This setting specifies an initial amount of time, in seconds, that the connector will wait to retry the request if it times out. | <add key="firstRetryDelaySeconds" value="5"/> |
maxRetryDelaySeconds | This setting specifies an maximum amount of time, in seconds, that the connector will wait to retry the request if it times out. | <add key="maxRetryDelaySeconds" value="30"/> |
jitterMultiplierRangeStart | This setting specifies an initial amount of time, in seconds, that the jitter multiplier will use to calculate the retry delay. | <add key="jitterMultiplierRangeStart" value="0.7"/> |
jitterMultiplierRangeEnd | This setting specifies an maximum amount of time, in seconds, that the jitter multiplier will use to calculate the retry delay. | <add key="jitterMultiplierRangeEnd" value="1.3"/> |
badRequestRetryMessages | This settings specifies a comma delimited list of accepted exceptions for 400 errors (bad request) that will be retried. | <add key="badRequestRetryMessages" value="java.util.concurrent.TimeoutException"/> |