Zum Inhalt springen

Update auf Mongo 5.0

Zuletzt geändert von MACH ProForms GmbH am 24.05.2023

Allgemeine Hinweise

Für das Update auf die Version 4.86 ist ein Update der MongoDB zwingend Voraussetzung. Diese Anleitung beschreibt den kompletten Updateprozess inkl. der Aktualisierung der Software.

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

Im Bereich des automatischen Abmeldeprozesses für die Nutzenden mussten neue Eigenschaftsnamen definiert werden. Sollten Sie hierzu individuelle Anpassungen vorgenommen haben müssen Sie sich bei uns im Support melden. Der bisherige und neue Wert für das automatische Abmelden beträgt 10 Stunden.

Ablauf

  1. Backup durchführen
  2. Abhängig der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen
  3. Updateprozess der Software durchführen

Vorbereitung

Für dieses Update ist es wichtig, dass der 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 und müssen nicht zurückgestellt werden.

I: a) Update Docker-Umgebung mittels Skript

Für das Update steht Ihnen auch folgendes Skript zur Verfügung:

Download-Link

Dieses Skript bündelt die in I: b) aufgelisteten manuellen Schritte in einen automatisierbaren Prozess.

I: b) Update Docker-Umgebung manuell

  1. Alle Container stoppen: docker-compose down
  2. docker-compose.yml Datei anpassen, Image "mongo"
    - Eigenschaft "version" von 4.2 auf 4.4 ändern
    - Eigenschaft "Command" den Parameter "--auth" (wenn vorhanden) entfernen
  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 mongo und verbinden sich mit der Datenbank. Anschließend führen Sie folgenden Befehl aus:
    db.adminCommand( { setFeatureCompatibilityVersion: "4.4" })
  5. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
    db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  6. Docker-Container "mongo" löschen: docker-compose rm -sf mongo
  7. docker-compose.yml Datei anpassen, Image "mongo"
    - Eigenschaft "version" von 4.4 auf 5.0 ändern
  8. Docker-Container "mongo" starten: docker-compose up -d mongo
  9. Aktivierung der Feature-Kompatibilität. Dazu gehen Sie direkt im Container auf die Datenbank und führen den folgenden Befehl aus:
    db.adminCommand( { setFeatureCompatibilityVersion: "5.0" })
  10. Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
    db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
  11. Container "mongo" löschen: docker-compose rm -sf mongo
  12. docker-compose.yml Datei anpassen:
    Image "mongo" - Eigenschaft "Command" den Parameter "--auth" (wenn vorhanden war) hinzufügen

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üsselfü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:
    - curl -fsSL https://pgp.mongodb.com/server-5.0.asc
    - sudo gpg -o /usr/share/keyrings/mongodb-server-5.0.gpg --dearmor
  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 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: "5.0" } )