If you encounter an issue refer to the following list of common issues and fixes. If you cannot find a solution to the issue that you are encountering, contact IOTech Support.
Starting the Server Components - bind: address already in useDescription:
If you start the server components and any of the ports specified for use by the Edge Builder containers is already in use by another process, docker-compose generates an error.
If you use the following command, where <controller-ip> is the IP address of the Edge Builder Controller and port 50066 is in use by another process, the eb_container container fails to start:
An error similar to the following is generated by docker-compose:
sudo edgebuilder-server up -a <controller-ip>
ERROR: for eb_controller Cannot start service eb_controller: driver failed programming external connectivity on endpoint eb_controller (f5aef4c7c92b9d1001f96c34e2f6444625f0bbda22a882f8e9b581c833569dc3): Error starting userland proxy: listen tcp 0.0.0.0:50066: bind: address already in use
To resolve this issue, identify the process using the port. If the process can be terminated, terminate the process and run the edgebuilder-server up command again.
For example, on Linux systems, you can enter the following command to see which process is using port 50066:
sudo lsof -i:50066
Logging into the CLI - Exit Code 12 (raspios-buster)Description:
Logging into the CLI on raspios-buster can cause the following error:
ERROR: Exit Code (12): mkdir /opt/edgebuilder/cli: permission denied
You must modify the ownership and permissions of the /opt/edgebuilder folder, for example, using the following commands:
sudo chown -R pi:pi edgebuilder/ chmod -R 777 edgebuilder/
Docker-ce installed, docker.io requiredDescription:
The Edge Builder server and node packages assume the use of docker.io. If you have docker-ce installed, you must uninstall it before installing the Edge Builder packages.
To do this, enter the following command:
sudo apt-get purge docker-ce docker-ce-cli containerd.io
Restarting a Node stuck in a down StateDescription:
In rare circumstances it is possible for a node to become stuck in a down state.
To resolve this, you must clean up the node and re-add it. This can be done as follows:
- Clean all Edge Builder artefacts, enter the following command where <node> is the name or ID of the node in the Down state:
edgebuilder-cli node rm -n <node> --force
- Log in to, or open an SSH tunnel connection with the node
- Enter the following command:
sudo edgebuilder-node down
- Add the node again using the following command:
edgebuilder-cli node add