Troubleshooting connector configuration issues

The following tables explain common troubleshooting scenarios related to connector configurations and the ways to address the connector configuration issues.

Connectivity issues

If a connector is unable to connect to a third-party application, review the following possibilities:

Possible causeCorrective action

No sites are configured

The following messages might be displayed:

  • Please configure a site
  • Please restore or configure at least one site
Configure at least one site. See Installing and configuring sites to run on-premises connectors and Adding or updating a configuration.

No sites are online

The following messages might be displayed:

  • Please restore a site
  • Please restore or configure at least one site

Restart Integration Controller for a required site by restarting Docker on the server where Integration Controller is installed. To restart Integration Controller, run the following command:

docker restart

For more information, see the docker restart topic on the Docker documentation portal.

A site selected for a connector configuration is incorrect

Verify a site selected for a connector configuration and specify a correct site.
A third-party application or service is not availableWait until the application or service is available.

If a site is in the Not Installed status

Verify that a firewall does not prevent connection between Integration Controller and a third-party application.

A connector does not run on Integration Controller

Check the status of Integration Controller. For more information, see Installing and configuring sites to run on-premises connectors.

  • If the status is other than Impaired, verify that the connector is configured for the site. 
  • If the status is Impaired, disable and then re-enable the configuration for the site. If the connector still does not run on the site, contact BMC Support.

Connector account issues

If you cannot add an account to a connector configuration, review the following possibilities:

Possible cause of the issueCorrective action
A site used by a connector is down

Start Integration Controller for a reference site.

A site selected for a connector configuration is incorrectVerify a site selected for a connector configuration and specify a correct site.
A third-party application or service is not availableWait until the application or service is available.

A connector does not run on Integration Controller

Check the status of Integration Controller. For more information, see Installing and configuring sites to run on-premises connectors.

  • If the status is other than Impaired, verify that the connector is configured for the site. 
  • If the status is Impaired, disable and then re-enable the configuration for the site. If the connector still does not run on the site, contact BMC Support.


Was this page helpful? Yes No Submitting... Thank you

Comments