Update your cluster
How to apply update your UltiHash cluster's software and license
Updating your UltiHash cluster ensures that you are running the latest version of the software and that any license changes are properly applied. Updates are performed using Helm, which allows you to replace pods gradually (rolling updates) or force an update when required.
Rolling updates
Rolling updates allow you to safely apply updates to UltiHash components without causing downtime. This process replaces pods incrementally so that workloads continue to run while updated pods come online. Use rolling updates whenever you upgrade to a new version or make configuration changes.
How to perform a rolling update
Confirm that the desired UltiHash version is available in the registry and ensure you have a backup of your configuration and data.
Run the following Helm command:
helm upgrade <release_name> oci://registry.ultihash.io/stable/ultihash-cluster \
-n <namespace> \
--version 1.3.0 \
--values values.yaml
Replace <release_name> with your Helm release name.
Replace <namespace> with the Kubernetes namespace where UltiHash is deployed.
Update 1.3.0 to the version you want to deploy.
If using a custom configuration, adjust values.yaml accordingly.
You can track the progress with:
kubectl get pods -n <namespace>
This will display pods terminating and new pods starting as the update rolls out.
License updates
When you update your UltiHash license through the user dashboard, the new license is automatically propagated to your cluster within one hour.
Apply a license update immediately
If you need the license change to take effect right away, you can force an update with Helm:
helm upgrade <release_name> oci://registry.ultihash.io/stable/ultihash-cluster \
-n <namespace> \
--version 1.3.0 \
--values values.yaml \
--force
Replace <release_name> with your Helm release name.
Replace <namespace> with the Kubernetes namespace where UltiHash is deployed.
Update 1.3.0 to match the version currently running.
The --force flag re-deploys all resources and applies the updated license immediately.
Last updated
Was this helpful?