helm/infrastructure/subcharts/kong/FAQs.md

   1 # Frequently Asked Questions (FAQs)
   2
   3 #### Kong fails to start after `helm upgrade` when Postgres is used. What do I do?
   4
   5 You may be running into this issue: https://github.com/helm/charts/issues/12575.
   6 This issue is caused due to: https://github.com/helm/helm/issues/3053.
   7
   8 The problem that happens is that Postgres database has the old password but
   9 the new secret has a different password, which is used by Kong, and password
  10 based authentication fails.
  11
  12 The solution to the problem is to specify a password to the `postgresql` chart.
  13 This is to ensure that the password is not generated randomly but is set to
  14 the same one that is user-provided on each upgrade.
  15
  16 #### Kong fails to start on a fresh installation with Postgres. What do I do?
  17
  18 Please make sure that there is no `PersistentVolumes` present from a previous
  19 release. If there are, it can lead to data or passwords being out of sync
  20 and result in connection issues.
  21
  22 A simple way to find out is to use the following command:
  23
  24 ```
  25 kubectl get pv -n <your-namespace>
  26 ```
  27
  28 And then based on the `AGE` column, determine if you have an old volume.
  29 If you do, then please delete the release, delete the volume, and then
  30 do a fresh installation. PersistentVolumes can remain in the cluster even if
  31 you delete the namespace itself (the namespace in which they were present).
  32