fix: update mongo dependecy, create pre-upgrade job to increase FCV of mongo

Author: omrozowicz-splunk

charts/splunk-connect-for-snmp/Chart.lock

@@ -1,12 +1,12 @@
 dependencies:
 - name: mongodb
   repository: https://charts.bitnami.com/bitnami
-  version: 15.6.26
+  version: 16.5.11
 - name: redis
   repository: https://charts.bitnami.com/bitnami
   version: 20.2.2
 - name: mibserver
   repository: https://pysnmp.github.io/mibs/charts/
-  version: 1.15.18
-digest: sha256:64bdee405118b51b47588ca86fada284233e4beb19c7539635dd833c706e1b4d
-generated: "2025-05-21T14:10:06.503084+02:00"
+  version: 1.15.19
+digest: sha256:63eced767b2a3f13d819163a5d91bc7570e9ad7ade67673c5445a5cb4d6c18bd
+generated: "2025-05-26T15:52:21.870704+02:00"

charts/splunk-connect-for-snmp/Chart.yaml

@@ -23,7 +23,7 @@ appVersion: "1.12.3-beta.2"
 #
 dependencies:
   - name: mongodb
-    version: ~15.6.0
+    version: ~16.5.9
     repository: https://charts.bitnami.com/bitnami
   - name: redis
     version: ~20.2.0

charts/splunk-connect-for-snmp/templates/mongodb-6.0-upgrade-job.yaml

@@ -0,0 +1,52 @@
+{{- $configMapName := printf "%s-config" (include "splunk-connect-for-snmp.name" .) }}
+{{- $existingRelease := (lookup "v1" "ConfigMap" .Release.Namespace $configMapName) }}
+{{- if $existingRelease }}
+  {{- $chartLabel := index $existingRelease.metadata.labels "helm.sh/chart" }}
+  {{- $namePrefix := printf "%s-" (include "splunk-connect-for-snmp.name" .) }}
+  {{- $prevVersion := trimPrefix $namePrefix $chartLabel }}
+apiVersion: batch/v1
+kind: Job
+metadata:
+  name: mongo-fcv-upgrade-to-7
+  annotations:
+    "helm.sh/hook": pre-upgrade
+    "helm.sh/hook-delete-policy": hook-succeeded,before-hook-creation
+spec:
+  backoffLimit: 1
+  template:
+    spec:
+      containers:
+        - name: mongo-fcv-check
+          image: {{ .Values.mongodb.image.repository }}:{{ .Values.mongodb.image.tag }}
+          command:
+            - /bin/bash
+            - -c
+            - |
+              set -e
+
+              PREV_VERSION="{{ $prevVersion }}"
+              TARGET_VERSION="{{ .Chart.AppVersion }}"
+
+              echo "Previous app version: $PREV_VERSION"
+              echo "Target app version: $TARGET_VERSION"
+
+              if [ "$(printf '%s\n' "$PREV_VERSION" "1.12.3" | sort -V | head -n1)" != "1.12.3" ]; then
+                echo "ERROR: Cannot upgrade directly from app version $PREV_VERSION to $TARGET_VERSION."
+                echo "Please upgrade to the intermediate version 1.12.3 first."
+                echo "You can do it with a command:"
+                echo "microk8s helm3 upgrade --install snmp -f values.yaml splunk-connect-for-snmp/splunk-connect-for-snmp --namespace=sc4snmp --create-namespace --version 1.12.3" >&2
+                exit 1
+              fi
+
+              echo "Checking current mongo FCV"
+              FCV=$(mongosh --host {{ include "splunk-connect-for-snmp.mongodbHost" . | quote }} --quiet --eval 'db.adminCommand({ getParameter: 1, featureCompatibilityVersion: 1 }).featureCompatibilityVersion.version')
+              echo "Current Mongo Feature Compatibility Version: $FCV"
+
+              if [[ "$FCV" < "7.0" ]]; then
+                echo "FCV < 7.0, setting to 7.0"
+                mongosh --host {{ include "splunk-connect-for-snmp.mongodbHost" . | quote }}  --eval 'db.adminCommand({ setFeatureCompatibilityVersion: "7.0", confirm: true })'
+              else
+                echo "FCV >= 7.0, nothing to be changed"
+              fi
+      restartPolicy: Never
+{{- end }}

charts/splunk-connect-for-snmp/templates/mongodb-7.0-upgrade-job.yaml

@@ -24,7 +24,7 @@ MIBSERVER_TAG=latest
 REDIS_IMAGE=docker.io/bitnami/redis
 REDIS_TAG=7.2.1-debian-11-r0
 MONGO_IMAGE=docker.io/bitnami/mongodb
-MONGO_TAG=6.0.9-debian-11-r5
+MONGO_TAG=8.0.9-debian-12-r2
 
 # Splunk instance configuration
 SPLUNK_HEC_HOST=

docker_compose/.env

@@ -26,4 +26,33 @@ If the `mongo-fcv-upgrade-to-6` job fails for any reason, there are two recovery
      db.adminCommand( { setFeatureCompatibilityVersion: "6.0" })
      ```
 
-    Replace `<mongodb-pod-id>` with the actual Pod ID of your MongoDB instance.
+    Replace `<mongodb-pod-id>` with the actual Pod ID of your MongoDB instance.
+
+
+### Upgrading SC4SNMP from 1.12.3 to 1.13.0
+
+When upgrading SC4SNMP from version `1.12.3` to `1.13.0`, the subchart version of MongoDB will be updated from `15.6.26` to `16.5.9`. This upgrade requires an increase in the MongoDB `Feature Compatibility Version (FCV)` from `6.0` to `7.0`.
+
+To facilitate this change, a new pre-upgrade job has been introduced in SC4SNMP: `mongo-fcv-upgrade-to-7`. This job automatically updates the Feature Compatibility Version on MongoDB before the installation of MongoDB version `16.5.9`.
+
+#### Pre-Upgrade Job: `mongo-fcv-upgrade-to-7`
+
+- The `mongo-fcv-upgrade-to-7` job is designed to ensure compatibility by running the FCV update prior to upgrading MongoDB.
+
+#### Handling Job Failures
+
+If the `mongo-fcv-upgrade-to-7` job fails for any reason, there are two recovery options:
+
+1. **Reinstall SC4SNMP**:
+
+    [Reinstall SC4SNMP](../../microk8s/sc4snmp-installation#restart-splunk-connect-for-snmp) with **Persistent Volume Claim (PVC) deletion**.
+
+2. **Manually Update MongoDB**:
+
+    [Update MongoDB's Feature Compatibility Version](https://www.mongodb.com/docs/manual/release-notes/6.0-upgrade-standalone/#upgrade-procedure) manually by executing the following command:
+     ```bash
+     microk8s exec -it pod/<mongodb-pod-id> -n sc4snmp mongosh
+     db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm: true })
+     ```
+
+    Replace `<mongodb-pod-id>` with the actual Pod ID of your MongoDB instance.