Important

You are viewing documentation for an older version of Confluent Platform. For the latest, click here.

Troubleshooting¶

If the start script does not complete successfully, please go through the following troubleshooting steps.

Docker¶

Verify that the status of all the Docker containers show Up state.
```
docker-compose ps
```
In the advanced Docker preferences settings, verify the following resources are allocated to Docker:
- Memory: at least 8 GB (default is 2 GB)
- CPU cores: at least 2 cores
Verify you have not run out of disk storage needed for Docker’s “disk image” file (Docker documentation).

If the script errors out before completing, or if there are Docker containers that are not in Up state, view the container’s logs with the command docker-compose logs [container] and look for error messages and exceptions.
```
docker-compose logs
```
If there are any errors that indicate issues with TLS communication, verify that the TLS certificates were properly generated and that there are no errors in the following files:
```
ls scripts/security/*.log
```

If there are any errors that indicate issues with TLS communication, force TLS certificates to be regenerated by starting the script with CLEAN=true:
```
CLEAN=true ./scripts/start.sh
```
If a command that communicates with ZooKeeper appears to be failing with the error org.apache.zookeeper.KeeperException$NoAuthException, change the container you are running the command from to be either kafka1 or kafka2. This is because ZooKeeper is configured for SASL/DIGEST-MD5, and any commands that communicate with ZooKeeper need properties set for ZooKeeper authentication.

Verify there are messages in the |ak| topics, including wikipedia.parsed:
```
./scripts/consumers/listen.sh
```
Run the :devx-cp-demo:`validation scripts|scripts/validate/` to verify that they pass.
```
cd scripts/validate/
```