KOTS - Reset tenant state

James Ressler
James Ressler
  • Updated

Author: James Ressler

Date: December 15, 2023

Audience: Everyone

Environmental details: Self hosted


Sometimes the tenant state needs to be reset. These steps can be tried if you see:

  • tenant-manager pods continuously being created and crashing repeatedly
  • the Admin Console reports that application is "Unavailable"
  • core-0 pod showing running but not ready. Last line in logs org.apache.catalina.startup.Catalina.start Server startup in [54810] milliseconds


On the database server

Truncate the tenantstate table in the jama database

truncate table jama.tenantstate;

Check that tenantstate has no rows

select * from jama.tenantstate;

On the application server

Remove the tenant configuration files from the core pod and delete the tenant manager job and the related statefulsets

kubectl exec core-0 -- sh -c 'rm -rf /home/contour/tenant_properties /home/contour/tenant.properties /home/contour/setup.properties /home/contour/services.properties /home/contour/node.properties /home/contour/database.properties'
kubectl delete job/tenant-manager
kubectl delete sts/hazelcast sts/activemq sts/core

Redeploy the application from the KOTS Admin Console

Related to

Was this article helpful?

0 out of 0 found this helpful

Have more questions? Submit a request



Please sign in to leave a comment.