Troubleshooting Integration Controller issues
When you install Integration Controller by using the installation command, Docker Engine and Docker Compose are installed automatically (if they were not installed earlier). For information about how to install Integration Controller, see Installing and configuring sites to run on-premises connectors. If you experience issues during the Integration Controller installation or usage, refer to the following information for troubleshooting.
The following table shows issues that might occur while installing and using Integration Controller, and corresponding corrective actions to fix them:
|Unable to install Docker Engine||
Upgrade the operating system. Recommended versions are as follows:
|Docker Compose fails to pull or start containers||
Cannot connect to Integration Service from an on-premises network that is behind a proxy. Docker login fails during installation with error message:
|The site goes offline, even though Integration Controller is installed and the same site was previously online||Restart Docker from your installation directory.|
To access Integration Controller logs
For more information about the errors that might occur during Integration Controller usage, you can check the Integration Controller logs. To access them, perform the following actions:
- On the server where Integration Controller is installed, run the following command:
The list of all docker containers is displayed.
- Access the logs of a particular container by using the container name or the container ID, and running one of the following commands:
docker logs container_name
docker logs container_ID
- The logs of the specified container are displayed.
To learn the advanced options of Docker logs processing, see .