Skip to content

Troubleshooting channelctl errors

The channelctl command line tool requires to first connect to an administration Kafka cluster. In case it is not running or is not reachable you will experience timeout or connection errors.

If you start a channel, the channelctl will connect to additional clusters to create some topics or to submit a punchline to execution. Again if the target cluster is not up and running you will be reported with errors.


  • Use the platformctl tool to ensure all the required services and clusters are running.
  • Use the channelctl audit command to ensure your various configuration files refer to existing clusters. A typo in a cluster name can typically lead to such errors.
  • In case of doubt check the file for list a valid (kafka|storm|spark|etc..) clusters.

Once all the commands report a green status, start again the channel(s).