Annex B -- Troubleshooting Installation Issues

1) Kafka container fails to start or keeps restarting This typically happens when Kafka cannot connect with Zookeeper. In this case, do the following:

Check if Zookeeper is running: kubectl exec zookeeper-0 -n nirmata-shared bin/zkServer.sh status

You should see:

Using config: /opt/zookeeper-3.5.1/bin/../conf/zoo.cfg
Client port not found in static config file. Looking in dynamic config file.
Client port found: 2181. Client address: zookeeper-2.zookeeper.nirmata-shared.
Mode: leader

2) Web console cannot be reached

Check if all the services are running using docker ps or kubectl get pods command. In case any service is not running, restart it. If it cannot be restarted, contact Nirmata support.

Check if the frontend load balancer is reachable using curl command:

curl https://<nirmata-url>/webclient

Check the frontend load balancer logs for any errors:

docker logs -f nginx

In case you see any errors, restart the load balancer. If it cannot be restarted, contact Nirmata support.

3) Unable to login to Nirmata

Check if all the services are running using docker ps or kubectl get pods command.

Check the logs for the users service and security service for any errors

In case you see any errors, restart the users service and security service. If they cannot be restarted, contact Nirmata support.