Anleitungen - Update auf Mongo 5.0

Page / - zuletzt bearbeitet von Form-Solutions GmbH am 24.05.2023

Update auf Mongo 5.0

zuletzt bearbeitet von Form-Solutions GmbH

am 24.05.2023

Inhaltsverzeichnis

Allgemeine Hinweise

Ablauf

Vorbereitung

I: a) Update Docker-Umgebung mittels Skript

I: b) Update Docker-Umgebung manuell

II: Update klassische Umgebung (Ubuntu)

Schritt 1 - Update auf Version 4.4

Schritt 2 - Update auf 5.0

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

Backup durchführen

Abhängig der verwendeten Umgebung die nachfolgende Anleitung für das MongoDB Update durchführen

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

Alle Container stoppen: docker-compose down

docker-compose.yml Datei anpassen, Image "mongo"
- Eigenschaft "version" von 4.2 auf 4.4 ändern
- Eigenschaft "Command" den Parameter "--auth" (wenn vorhanden) entfernen

Docker-Container "mongo" starten: docker-compose up -d mongo

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

Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

Docker-Container "mongo" löschen: docker-compose rm -sf mongo

docker-compose.yml Datei anpassen, Image "mongo"
- Eigenschaft "version" von 4.4 auf 5.0 ändern

Docker-Container "mongo" starten: docker-compose up -d mongo

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

Bei Bedarf - folgender Befehl kann für die Überprüfung innerhalb des Containers genutzt werden:
db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )

Container "mongo" löschen: docker-compose rm -sf mongo

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

MongoDB Prozess stoppen: sudo service mongod stop

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

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

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

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

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

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

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

Service starten: sudo service mongod start

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

MongoDB Prozess stoppen: sudo service mongod stop

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

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

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

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

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

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

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

Service starten: sudo service mongod start

Verbinden Sie sich über den Mongo-Client und führen folgende Befehle aus:
- db.adminCommand( { getParameter: 1, featureCompatibilityVersion: 1 } )
- db.adminCommand( { setFeatureCompatibilityVersion: "5.0" } )