====== Migration auf MariaDB ======

Vor dem eigentlichen Update des EDP-Systems auf die Version EDP 2023.1 oder neuer muss zunächst die Installation des neuen Datenbanksystems "MariaDB" erfolgen. Anschließend ist die automatisierte Übernahme aller Daten aus der bisherigen Datenbank vorgesehen. **Für das Durchführen der Migration ist zunächst ein Update des EDP-Server auf die Version 4.9.0.4 Build2 erforderlich.**

Erst wenn dieser Migrationsprozess erfolgreich abgeschlossen ist, sollte die eigentliche Installation des Updates erfolgen. So ist auch sichergestellt, dass bei einem Fehler während der Migration problemlos mit dem bisherigen System weitergearbeitet werden kann.

Bitte beachten Sie auch die Hinweise im [[start:changelog|Changelog]].
===== Datenbankmigration =====

**Als Datenbanksystem wird MariaDB in der Version 10.8 oder 10.11 unterstützt. Andere Versionen von MariaDB sind aktuell nicht getestet. MariaDB unterhalb der Version 10.5 ist definitiv nicht mit EDP kompatibel.**

Laden Sie zunächst das Setup für die Datenbankmigration herunter und starten anschließend den dort enthaltenen Migrationsassistenten. Während der Migration sollten alle EDP-Dienste und Anwendungen beendet sein, um ein Schreiben in die Datenbank während der Migration zu verhindern.

{{ :allgemein:migration_1.jpg |}}

Mit dem Setup wurde Maria-DB als Datenbanksystem installiert. Zunächst müssen Sie für den root-Benutzer in MariaDB ein Passwort angeben. Sollte bei Ihnen bereits MariaDB installiert sein, so erfolgt hier die Abfrage des Passworts für den root-Benutzer.

Bitte beachten Sie, dass hier ein leeres Passwort nicht zulässig ist.

Mit dem nächsten Schritt starten Sie zunächst das Anlegen einer neuen, leeren Datenbank:
{{ :allgemein:migration_2.jpg |}}

Nach dem erfolgreichen Anlegen der Datenbank in MariaDB erfolgt der Start der eigentlichen Migration der vorhandenen Daten aus der bisherigen Firebird-Datenbank in die neue Datenbank von MariaDB. Geben Sie dazu die Zugangsdaten zu Ihrer Datenbank an.

Sollten in Ihrer Datenbank eigene Felder hinzugefügt worden sein, so aktivieren Sie bitte den Haken "Eigene selbst erstellte Felder aus Firebird-Datenbank übernehmen".
{{ :allgemein:migration_fb.jpg |}} 

Im Rahmen der Migration überprüft das Migrationstool zunächst die Felderstruktur der Firebird-Datenbank mit der der neu angelegten MariaDB-Datenbank. Sollte es hier zu Abweichungen der Feldtypen kommen, wird die Migration abgebrochen und ein entsprechender Fehler signalisiert. In diesem Fall ist es erforderlich, die Feldstruktur der Firebird-Datenbank an die der MariaDB anzugleichen.

Nach erfolgreichem Abschluss der Migration ist die Auswahl der Startkonfiguration der Ribbon-Leiste erforderlich, da deren Darstellung mit der neuen EDP-Version komplett neu entwickelt wurde und die bisherige Darstellung nicht übernommen werden kann.

{{ :allgemein:migration_ende.jpg |}}
===== Verfügbaren Downloads =====

^ Bezeichnung ^ Download-Link ^ 
| Setup Migration | [[https://eifert-systems.de/EDP2023/setup_migration.exe|Download]] | 
| KEZ-Schnittstelle| [[https://eifert-systems.de/EDP2023/kezservice.zip|Download]] | 

Verwenden Sie für die restlichen Dateien bitte die aktuelle Version auf dem [[https://einsatzleitsoftware.de/downloads.php|Downloadbereich]].
===== Besondere Hinweise =====

Bitte beachten Sie aus die folgenden Hinweise im Rahmen des Updates:

^ Hinweis  ^ Beschreibung ^
|**Backup** | Mit der Umstellung auf MariaDB muss auch das [[server:datensicherung|Backup]] angepasst werden|
|**Konfig-Dateien EDP-Dienste**| Das Migrationstool versucht die Konfigurationsdateien der EDP-Dienste (EDP-Server, EDPweb, Einsatzserver und ggfs. KEZSrv) anzupassen und die die Zugangsdaten zum neuen Datenbanksystem zu hinterlegen. Bitte überprüfen Sie hier unbedingt die Ini-Dateien. Die Daten lauten für MariaDB: Host=127.0.0.1, Database=EDPdb, Username=root, Passwort=Das von Ihnen vergebene Passwort.|
|**Port-Freigaben** | Die Freigabe des Ports 3050 (Firebird) als eingehende Regel ist nicht weiter erforderlich. Dafür muss der Port 3306 als eingehende Regel für MariaDB in der Windows-Firewall des Servers ergänzt werden. Achten Sie bei dieser Portfreigabe unbedingt darauf, dass hier ein Zugriff nur innerhalb eines geschlossenen Netzwerks für die Clients möglich ist.|
|**Einsatzserver** | Im Einsatzserver können in der Datei "sql.txt" eigene SQL-Abfragen hinterlegt werden. Mit dem Update auf MariaDB sind die Befehle von Firebird-SQL u.U. nicht länger korrekt. Insbesondere eine Abfrage zum Ermitteln von Stichwort-Klartext auf Basis von Einsatzart und Stichwort oder umgekehrt ist nicht länger erforderlich, dies erfolgt bereits automatisiert durch den Einsatzserver bei Einsatzübernahme.|
|**Close-Tool für Einsätze** | Das [[einsatzserver:closeeinsatz|Tool zum automatischen Schließen von Einsätzen]] muss auch auf MariaDB aktualisiert werden.|
|**Crash-Buttons** | Sollten Sie die Funktion der Crash-Buttons nutzen, prüfen Sie bitte unbedingt diese Funktion nach dem Update, ob hier die Auslösung weiter wie gewünscht funktioniert. (Nur für Werkfeuerwehren)|
|**KEZ-Schnittstelle**|Bitte aktualisieren Sie bei Verwendung der KEZ-Schnittstelle auch die zugehörige Anwendung und Beachten die [[kez:index|Hinweise zum Umstieg auf EDP2023]].|