Automatische Migration der Datenbank auf WiredTiger

Grundinformationen

FE2 verwendet seit der ersten Veröffentlichung im Jahr 2016 als Datenbank “MongoDB”. Im Laufe der Entwicklung von FE2 wurde natürlich auch MongoDB weiterentwickelt. Mit Version 3.2 der MongoDB wurde eine neue Datenbank-Engine (WiredTiger) eingeführt, die wesentlich mehr Vorteile bietet und seit dieser Version als Standard für neu angelegte Datenbanken definiert wurde. Die Version 3.2 wurde ab FE2 2.21 verwendet.

MongoDB-Versionen älter als 3.2 hatten als Datenbank-Engine “mmapv1”. Dadurch haben alle FE2-Systeme, die mit einer Version älter als FE2 2.21 initial eingerichtet wurden, die veraltete Engine. Dies betrifft ca. 25 % unserer Kundensysteme. Kunden, die erst mit 2.21 oder neuer Kunde geworden sind, ein frisches FE2-System aufgesetzt haben und keine Übernahme der alten Konfiguration durchgeführt haben, verwenden bereits WiredTiger.

Mit dem Update auf FE2 2.30 wurde die MongoDB-Version auf 4.0 angehoben. Dies ist die letzte Version, die die Datenbank-Engine “mmapv1” unterstützt. Eine generelle Erhöhung auf neuere Versionen ist daher erst möglich, wenn die Datenbank bei allen Kundensystemen auf “WiredTiger” migriert wurde.

Wir haben daher seit Juli 2021 eine Anleitung im Handbuch, welche eine manuelle Migration der Datenbank ermöglicht.

Was ändert sich mit FE2 2.33?

Mit FE2 2.33 wird die Installation eine automatische Migration durchführen, um für zukünftige FE2-Versionen eine Aktualisierung der Datenbankversion zu ermöglichen. Die Migration betrifft ausschließlich Kunden, die FE2 bereits seit 2.20 oder älter verwenden und seitdem keine manuelle Migration durchgeführt haben oder das System in der Zwischenzeit neu aufgebaut haben. Einen Hinweis, welche Datenbank-Engine FE2 verwendet, ist in der Administration zu sehen:

Wenn Ihr System die Informationen, wie im linken Bild zu sehen, darstellt, sind Sie von der Migration betroffen.

Voraussettzungen für eine erfolgreiche Migration

Folgende Voraussetzungen müssen gegeben sein, damit eine Migration erfolgreich durchlaufen werden kann:

• Installierte FE2 2.32

• Mindestens 3-facher freier Festplattenspeicher der aktuellen Größe des Konfigurationsordners. Der freie Speicherplatz muss auf der Partition verfügbar sein, auf der das FE2-Konfigurationsverzeichnis aktuell gespeichert ist (bei 6GB Konfigurationsordner-Größe sind mind. 18GB freier Festplattenplatz erforderlich)

• kein Spezialsetup der FE2-Installation (z. B. FE2 installiert auf C: , Konfigurationsordner auf D: , Datenbank auf einem anderen Server)

• vorhandene Datei migrate_to_wired_tiger im Config-Verzeichnis (diese wurde durch Installation der FE2 2.32 automatisch erstellt, wenn die Datenbank migriert werden muss)

Manuelle Migration

Eine manuelle Migration ist selbstverständlich mit der aktuellen FE2 2.32 auch möglich. Folgen Sie hierzu einfach der oben verlinkten Migrationsanleitung und starten Sie Ihr FE2-System. Im Anschluss haben Sie Ihr System umgestellt und die Installation der FE2 2.33 führt keine automatische Migration aus.

Migration durch Alamos

Wollen Sie eine Migration der Datenbank VOR dem Update auf 2.33 durch uns durchführen lassen, so wenden Sie sich bitte per Ticketsystem an uns für eine kostenpflichtige Unterstützung.

Fragen und Anmerkungen

Sollten Sie zu dieser Migration Fragen haben, können Sie sich gerne in unserem Kundenforum melden. Die entsprechende Ankündigung mit einem Link zum Diskussionsthread finden Sie hier:

FE2: Update der Datenbankversion - Kundenforum (alamos-gmbh.com)

Sollten Sie nach einem Update auf FE2 2.33 ein nicht funktionierendes FE2-System haben, wenden Sie sich bitte per Ticketsystem an uns und geben als Betreff “Migration Datenbank FE2 2.33 fehlgeschlagen“. Damit wir Ihnen helfen können, stellen Sie bitte sicher, dass Sie vor dem Update auf 2.33 eine komplette Datensicherung durchgeführt haben!