2025.09.00

Prerequisites

Access to the Helm chart version 2.6.0. You may need to run helm repo update to grab the latest version.
kubectl
Helm

Guide

Before any upgrade takes place, ensure you have taken a snapshot or backup of all your running PVCs in your AKS cluster. This is very important as databases may be upgraded during this process.

Stage 1: Prepare for upgrade

Connect to your cluster using the kubeconfig.
Export your current Helm values file. Keep one copy for the upgrade process and another as a backup.

In the values file, update the following properties:

 global:
   image:
     tag: "2025.09.00"
   strategy:
     type: Recreate

 application:
   cluedin:
     components:
       packages:
       - name: "CluedIn.Connector.AzureEventHub"
         version: "4.5.1"
       - name: "CluedIn.Connector.Dataverse"
         version: "4.6.0"
       - name: "CluedIn.Connector.Http"
         version: "4.5.0"
       - name: "CluedIn.EventHub"
         version: "4.6.0"
       - name: "CluedIn.Vocabularies.CommonDataModel"
         version: "4.6.0"
       - name: "CluedIn.Connector.AzureDataLake"
         version: "4.6.0"
       - name: "CluedIn.Connector.AzureDedicatedSqlPool"
         version: "4.0.3"
       - name: "CluedIn.Connector.AzureServiceBus"
         version: "4.5.0"
       - name: "CluedIn.Connector.OneLake"
         version: "4.6.0"
       - name: "CluedIn.ExternalSearch.Providers.DuckDuckGo.Provider"
         version: "4.6.0"
       - name: "CluedIn.ExternalSearch.Providers.PermId.Provider"
         version: "4.6.0"
       - name: "CluedIn.ExternalSearch.Providers.Web"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Bregg"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.ClearBit"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.CompanyHouse"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.CVR"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Gleif"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.GoogleMaps"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.KnowledgeGraph"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Libpostal"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.OpenCorporates"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Providers.VatLayer"
         version: "4.6.0"
       - name: "CluedIn.Purview"
         version: "4.6.0"
       - name: "CluedIn.PowerApps"
         version: "4.6.0"
       - name: "CluedIn.EnterpriseFlows.PowerAutomate"
         version: "4.5.0"
       - name: "CluedIn.Connector.SqlServer"
         version: "4.5.0"
       - name: "CluedIn.Connector.FabricOpenMirroring"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Providers.AzureOpenAI"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.GoogleImages"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.RestApi"
         version: "4.6.0"
       - name: "CluedIn.Provider.ExternalSearch.Providers.ArtificialIntelligence"
         version: "4.6.0"

Apply the values file from your shell by running the following:

 # ${CustomValues} refers to the values file you have amended with the above changes. Please type the full path here.

 helm upgrade cluedin-platform -n cluedin cluedin/cluedin-platform \
     --version 2.6.0 \
     --values ${CustomValues} \
     --set application.system.upgradeMode=true \
     --set application.system.runDatabaseJobsOnUpgrade=true \
     --set application.system.runNugetFullRestore=true \
     --wait \
     --timeout 10m0s

After a few minutes, it should complete successfully.

Wait until the deployment finishes.
Perform the validation:
- Make sure that all pods are healthy and all jobs are completed.
- Ensure that there are no errors in the pod logs.

If there are any issues during the upgrade process, please do not hesitate to reach out to CluedIn support.

Stage 2: Run Data Upgrade

Apply data upgrade by running following command:

 kubectl apply -f - <<EOF
 apiVersion: api.cluedin.com/v1
 kind: DataUpgrade
 metadata:
   annotations:
     meta.helm.sh/release-name: cluedin-platform
     meta.helm.sh/release-namespace: cluedin
   labels:
     app: cluedin
     app.kubernetes.io/instance: cluedin-platform
     app.kubernetes.io/managed-by: Helm
     app.kubernetes.io/name: application
     helm.sh/chart: application-2.6.0
     release: cluedin-platform
   name: data-upgrade-460
   namespace: cluedin
 spec:
   toVersion: Version460
 EOF

Validation:
- ❗ Confirm the data upgrade completed successfully.

Stage 3: Finalize Upgrade

Run the final stage of the upgrade to bring the system back online (disable upgrade mode):

 # ${CustomValues} refers to the values file you have amended with the above changes. Please type the full path here.

 helm upgrade cluedin-platform -n cluedin cluedin/cluedin-platform \
   --version 2.6.0 \
   --values ${CustomValues} \
   --set application.system.upgradeMode=false \
   --set application.system.runDatabaseJobsOnUpgrade=false \
   --set application.system.runNugetFullRestore=false

Validation:
- Ensure no errors in the pod logs.
- Verify the server starts in normal mode.
- Ensure cluedin-ui pod is Running..