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.

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

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" } )