Update auf Mongo 8.0

Zuletzt geändert von MACH ProForms GmbH am 05.03.2025

Allgemeine Hinweise

Für das Update auf die Version 4.105 ist ein Update der MongoDB zwingend erforderlich. Diese Anleitung beschreibt den kompletten Update-Prozess inkl. der Aktualisierung der Software.

Bitte beachten Sie, dass Sie ggf. zusätzliche Module manuell updaten müssen. Hierzu gehört z.B. das Modul "data-export.war". Sollte sich dieses Modul im "deployment" Verzeichnis des Wildfly-Servers befinden, kontaktieren Sie bitte unseren Support.

Ablauf

  1. Backup durchführen
  2. Abhängig von der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen
  3. Update-Prozess der Software durchführen
  4. Vergewissern Sie sich, dass Ihre Skripte wie z.B. "db-backup.sh" nach dem Update ordnungsgemäß funktionieren. In der Regel muss ... fs mongo:5.0 ... durch ... fs mongo:8.0 ... getauscht werden.

Vorbereitung

Für dieses Update ist es wichtig, dass das Timeout für das Deployment entsprechend dem Artikel Deployment-Timeout eingestellt ist. Bitte kontrollieren und passen Sie die Einstellungen entsprechend an, bevor Sie das Update einspielen. Diese Werte können nach dem Update beibehalten werden und müssen nicht zurückgestellt werden.

Docker-Umgebung

Manuell

Version 5 auf 6

  1. Alle Container stoppen: docker-compose down
  2. MongoDB-Image (docker images) entfernen docker image rm <img-id>
  3. docker-compose.yml Datei anpassen, Image "mongo"
    - Eigenschaft "version" von 5.0 auf 6.0 ändern
    - Eigenschaft "Command" den Parameter "--auth" entfernen, wenn vorhanden
  4. Docker-Container "mongo" starten: docker-compose up -d mongo
  5. Aktivierung der Feature-Kompatibilität.
    Dazu gehen Sie direkt in den Container docker-compose exec mongo mongosh und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus:
    db.adminCommand( { setFeatureCompatibilityVersion: "6.0" })
  6. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
    db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  7. Mongo Container entfernen: docker-compose rm -sf mongo

Version 6 auf 7

  1. MongoDB-Image (docker images) entfernen docker image rm <img-id>
  2. docker-compose.yml Datei anpassen, Image "mongo"
    - Eigenschaft "version" von 6.0 auf 7.0 ändern
  3. Docker-Container "mongo" starten: docker-compose up -d mongo
  4. Aktivierung der Feature-Kompatibilität.
    Dazu gehen Sie direkt in den Container docker-compose exec mongo mongosh und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus: db.adminCommand( { setFeatureCompatibilityVersion: "7.0", confirm:true })
  5. Mongo Container entfernen: docker-compose rm -sf mongo

Version 7 auf 8

  1. MongoDB-Image (docker images) entfernen docker image rm <img-id>
  2. docker-compose.yml Datei anpassen, Image "mongo"
    - Eigenschaft "version" von 7.0 auf 8.0 ändern
  3. Docker-Container "mongo" starten: docker-compose up -d mongo
  4. Aktivierung der Feature-Kompatibilität.
    Dazu gehen Sie direkt in den Container docker-compose exec mongo mongosh und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus: db.adminCommand( { setFeatureCompatibilityVersion: "8.0", confirm:true })
  5. Mongo Container entfernen: docker-compose rm -sf mongo
  6. docker-compose.yml Datei anpassen:
    Image "mongo" - Eigenschaft "Command" den Parameter "--auth" (wenn vorhanden war) hinzufügen
  7. Container Web, Mongo und MariaDB starten

Native Umgebung

Es gelten die Schritte aus diesem Tutorial. Dabei sind die veränderten Versionen/Pakete aus den nachfolgenden Links zu entnehmen