Upgrade validation
Verify alerts are updated
If pre/post upgrades were successfully executed, backend should not be getting queries with 1 second step. Verify this by looking at the query-service logs (grep for step:[1] and there shouldn’t be any)
Verify deepstore settings
During an upgrade it’s extremely important that deepstore settings are retained, and that we don’t accidentally remove the deepstore configuration. In order to verify that, we can run helm diff
plugin to check the differences.
As a prerequisite install the helm diff
plugin by running:
helm plugin install https://github.com/databus23/helm-diff
You can build this plugin from the source and install it too. You can find instructions for building from source here.
Run the following command to generate the diff with the new version:
helm diff upgrade kfuse oci://us-east1-docker.pkg.dev/mvp-demo-301906/kfuse-helm/kfuse --version <kfuse-version> --values values.yaml,[aws|gcp].yaml[,custom_values.yaml] > /tmp/kfuse_upgrade_diff
Ensure that you’ve run docker login
before running the diff command. To run the correct command for login, please refer to this section in the Installation page.
If you’re running your cluster on GCP cluster and have a custom values file called custom_values.yaml
and upgrading to kfuse version 1.0.5, then you can the above command as:
helm diff upgrade kfuse oci://us-east1-docker.pkg.dev/mvp-demo-301906/kfuse-helm/kfuse --version 1.0.5 --values values.yaml,gcp.yamlcustom_values.yaml > /tmp/kfuse_upgrade_diff
If the deepstore settings have changed, then you’ll changes in pinot-controller.conf
and pinot-server.conf
(search or grep for them in /tmp/kfuse_upgrade_diff
file):
This sample output shows that the deepstore settings will change from enabled to not enabled with the upgrade. In that case, double-check your deepstore settings in your custom values file.
If you’re unsure about where to find the deepstore settings and how to fix it, reach out to us on our slack channel or email us. Check out this page on how to reach us.