Skip to main content

         This documentation site is for previous versions. Visit our new documentation site for current releases.      

Troubleshooting Kafka

Updated on August 3, 2020

Review the following troubleshooting scenarios to find solutions to problems with Kafka.

Stream service nodes are NORMAL, but data flow hangs

Even though all nodes are in the NORMAL state, the data flow hangs.


Some ports of any Kafka brokers within the cluster are unreachable.


Perform the following actions:

  1. Check whether the Kafka broker port is exposed for the rest of the nodes.

    The default port is 9092.

  2. If the port is not exposed, change the pyBrokerPort setting in the prconfig.xml file.


Stream service nodes fail to run on WebSphere 8.5


By default, Java 6 is used, while Kafka supports Java 7 and later versions (in the case of IBM JVM 7.1).


Check which WebSphere version is used.

This node cannot be replaced in the current production level as data will be lost


The message appears during the replacement of the stream node if the Kafka data or metadata already exists.


Perform one of the following actions:

  • If some Kafka data is present on the stream cluster and you want to keep that data, disregard the message because this is expected behavior.
  • If no Kafka data exists on the stream cluster or if you want to remove the existing data, clean the Kafka metadata by running the following SQL command, and then retry replacing the node:
    DELETE FROM pr_data_stream_nodes;
    DELETE FROM pr_data_stream_sessions;


To view the main outline for this article, see Kafka as a streaming service.

Have a question? Get answers now.

Visit the Support Center to ask questions, engage in discussions, share ideas, and help others.

Did you find this content helpful?

Want to help us improve this content?

We'd prefer it if you saw us at our best. is not optimized for Internet Explorer. For the optimal experience, please use:

Close Deprecation Notice
Contact us