Update auf Mongo 8.0

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 der folgenden Anleitung.
Dabei sind die veränderten Versionen/Pakete aus den nachfolgenden Links zu entnehmen

Update auf Mongo 5.0 II: Update klassische Umgebung (Ubuntu)

Schritt 1 - Update auf Version 4.4

  1. MongoDB Prozess stoppen: sudo service mongod stop

  2. Die installierten Mongo-DB Pakete deinstallieren: sudo apt-get purge mongodb-org*

  3. Um zu überprüfen, ob die Deinstallation erfolgreich war: service mongod status

  4. Für die Installation der MongoDB müssen folgende Schritte durchgeführt werden:

    • Installation "gnupg" (wenn noch nicht vorhanden): sudo apt-get install gnupg

    • Führen Sie den folgende Befehl aus, um den öffentlichen Schlüssel für die MongoDB zu importieren:
      curl -fsSL https://pgp.mongodb.com/server-4.4.asc
      sudo gpg -o /usr/share/keyrings/mongodb-server-4.4.gpg --dearmor

  5. Create the /etc/apt/sources.list.d/mongodb-org-4.4.list file for Ubuntu 20.04 (Focal):
    echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-4.4.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/4.4 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-4.4.list

  6. Update der lokalen Paket-Datenbank: sudo apt-get update

  7. MongoDB-Pakete installieren:
    sudo apt-get install -y mongodb-org=4.4.20 mongodb-org-server=4.4.20 mongodb-org-shell=4.4.20 mongodb-org-mongos=4.4.20 mongodb-org-tools=4.4.20

  8. Um zu überprüfen, ob die Installation vollständig durchgeführt ist: mongo –version

  9. Service starten: sudo service mongod start

  10. Verbinden Sie sich über den Mongo-Client und führen folgende Befehle aus:

    • db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

    • db.adminCommand( { setFeatureCompatibilityVersion: "4.4" } )

Schritt 2 - Update auf 5.0

  1. MongoDB Prozess stoppen: sudo service mongod stop

  2. Die installierten Mongo-DB Pakete deinstallieren: sudo apt-get purge mongodb-org*

  3. Um zu überprüfen, ob die Deinstallation erfolgreich war: service mongod status

  4. Für die Installation der MongoDB müssen folgende Schritte durchgeführt werden:

  5. Create the /etc/apt/sources.list.d/mongodb-org-5.0.list file for Ubuntu 20.04 (Focal):
    echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-5.0.gpg ] https://repo.mongodb.org/apt/ubuntu focal/mongodb-org/5.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-5.0.list

  6. Update der lokalen Paket-Datenbank: sudo apt-get update

  7. MongoDB-Pakete installieren:
    sudo apt-get install -y mongodb-org=5.0.16 mongodb-org-database=5.0.16 mongodb-org-server=5.0.16 mongodb-org-shell=5.0.16 mongodb-org-mongos=5.0.16 mongodb-org-tools=5.0.16

  8. Um zu überprüfen, ob die Installation vollständig durchgeführt is t: mongo –version

  9. Service starten: sudo service mongod start

  10. Verbinden Sie sich über den Mongo-Client und führen folgende Befehle aus:

    • db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

    • db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )