Trendz Analytics Kubernetes 1.8.x Upgrade Instructions

Prepare for upgrading Trendz Analytics

Obtain Trendz Kubernetes scripts

Use the Kubernetes configuration files from your original installation. If you no longer have them, re-clone the repository and fill in your configuration values as described in the installation guide:

git clone https://github.com/thingsboard/trendz-k8s.git --depth 1

Connect to your Kubernetes cluster

Select the correct kube-config context before running any commands:

kubectl config get-contexts

kubectl config use-context <your-config-name>

Set trendz as the default namespace, so the commands below run in it:

kubectl config set-context --current --namespace=trendz

Back up the database

Back up the trendz database with pg_dump or your PostgreSQL provider's backup tools.

Upgrading Trendz Analytics to 1.8.2

Update image versions

Set the image versions to 1.8.2. Do not apply the files yet.

trendz-app-deployment.yml: thingsboard/trendz:1.8.2
trendz-python-executor-deployment.yml: thingsboard/trendz-python-executor:1.8.2

Stop Trendz

kubectl scale deployment trendz-app-deployment --replicas=0
kubectl wait --for=delete pod -l app=trendz-app-pod-label --timeout=120s

If the pods are already gone, kubectl wait may print no matching resources found. This is expected.

Create the upgrade job

apiVersion: batch/v1
kind: Job
metadata:
  name: trendz-upgrade
  namespace: trendz
spec:
  backoffLimit: 0
  template:
    spec:
      restartPolicy: Never
      containers:
        - name: trendz-upgrade
          image: thingsboard/trendz:1.8.2
          env:
            - name: UPGRADE_TRENDZ
              value: "true"
          envFrom:
            - configMapRef:
                name: trendz-app-db-config
          volumeMounts:
            - name: trendz-app-config
              mountPath: /trendz-config-files
      volumes:
        - name: trendz-app-config
          configMap:
            name: trendz-app-config
            items:
              - key: trendz.conf
                path: trendz.conf
              - key: logback.xml
                path: logback.xml

The ConfigMap names, keys and namespace must match your trendz-app-deployment.yml. Installations created before 1.15 use the keys conf and logback.

Run the upgrade job

kubectl apply -f trendz-upgrade.yml
kubectl wait --for=condition=complete job/trendz-upgrade --timeout=900s

Verify the upgrade

kubectl logs job/trendz-upgrade

Expected output:

Start upgrading Trendz from version …
…
Current version is …, upgrade is not needed.

Delete the job

kubectl delete job trendz-upgrade

Start Trendz

kubectl apply -f trendz-python-executor-deployment.yml
kubectl apply -f trendz-app-deployment.yml

If you run more than one pod, restore the replica count:

kubectl scale deployment trendz-app-deployment --replicas=<pod-count>

Upgrading Trendz Analytics to 1.8.1

Reduce pod count

Scale the deployment to one pod:

kubectl scale deployment trendz-app-deployment --replicas=1

Create upgrade flag file

Get the pod name:

kubectl get pods -l app=trendz-app-pod-label

Create the flag file in the pod. Replace <POD_NAME> and set the version you are currently running:

kubectl exec <POD_NAME> -- sh -c "echo '1.7.0' > /data/.upgradeversion"

Update image version

In trendz-app-deployment.yml, set the image to thingsboard/trendz:1.8.1 and apply it:

kubectl apply -f trendz-app-deployment.yml

Verify the upgrade

Check the pod logs:

kubectl logs -f <trendz-pod-name>

Expected output:

Upgrading Trendz from version …
…
Current version is …, upgrade is not needed
…
Started TrendzApplication in …

Restore pod count

kubectl scale deployment trendz-app-deployment --replicas=<pod-count>

Was this helpful?