So migrieren Sie Dolibarr auf einen neuen Server ohne Datenverlust: Eine vollständige Anleitung

Inhaltsverzeichnis

1. Einführung

2. Warum Sie möglicherweise Dolibarr migrieren müssen

3. Die Datei- und Datenbankstruktur von Dolibarr verstehen

4. Vorbereitung einer Migration: Backup-Strategie

5. Auswählen Ihrer neuen Hosting-Umgebung

6. Installieren der Voraussetzungen auf dem neuen Server

7. Sichern der Dolibarr-Datenbank

8. Exportieren der Dokument- und Konfigurationsdateien von Dolibarr

9. Sichere Übertragung von Dateien auf den neuen Server

10. Wiederherstellen der Datenbank auf dem neuen Server

11. Anpassen der Konfigurationsdatei (conf.php)

12. Festlegen von Berechtigungen und Verzeichniseigentümern

13. Testen der wiederhergestellten Instanz

14. Überlegungen zur DNS- und Domänenverbreitung

15. Umgang mit Versionsunterschieden während der Migration

16. Aufräumen und Optimieren nach der Migration

17. Häufige Fehler und deren Behebung

18. Migrieren von benutzerdefinierten Modulen und Plugins

19. Sicherstellung der Kompatibilität mit externen Integrationen

20. Datenintegritätsprüfungen nach der Migration

21. Handhabung des Benutzerzugriffs während der Umstellung

22. Endgültiger Backup- und Rollback-Plan

23. Bewährte Sicherheitspraktiken während der Migration

24. Planen von Ausfallzeiten und Kommunikation mit Stakeholdern

25. Fazit: Zuverlässige Migration ohne Datenverlust

1. Einleitung

Die Migration Ihres Dolibarr ERP/CRM-Systems auf einen neuen Server kann schwierig sein, insbesondere wenn Datenintegrität und Servicekontinuität von entscheidender Bedeutung sind. Egal, ob Sie den Hosting-Anbieter wechseln, die Hardware aktualisieren oder in eine private Cloud migrieren – dieser Leitfaden führt Sie Schritt für Schritt durch den Migrationsprozess – ohne Datenverlust.

2. Warum Sie Dolibarr möglicherweise migrieren müssen

Häufige Szenarien sind:

• Wechsel von Shared Hosting zu VPS oder Dedicated Hosting

• Von einem Testserver zur Produktion wechseln

• Wechsel zu einem Cloud-Anbieter

• Upgrade des Betriebssystems oder der Infrastruktur

Bei richtiger Durchführung sorgt die Migration für bessere Leistung, Flexibilität oder Sicherheit.

3. Die Datei- und Datenbankstruktur von Dolibarr verstehen

Dolibarr basiert auf zwei Hauptkomponenten:

• Datenbank (MySQL/MariaDB): Speichert alle Geschäftsdaten – Kunden, Rechnungen, Inventar usw.

• Dateisystem: Enthält Konfigurationsdateien, Module, vom Benutzer hochgeladene Dokumente (PDFs, Bilder) und die /htdocs/ Bewerbungsmappe

Für eine vollständige Migration benötigen Sie beides.

4. Vorbereitung einer Migration: Backup-Strategie

Bevor Sie etwas tun:

• Sichern Sie die Datenbank mit automatisierten mysqldump

• Archivieren Sie das vollständige Dolibarr-Verzeichnis (z.B, /var/www/dolibarr)

• Speichern Sie Backups an zwei sicheren Orten

Es ist außerdem ratsam, Benutzer über das Wartungsfenster zu informieren und den Schreibzugriff vorübergehend zu deaktivieren.

5. Auswahl Ihrer neuen Hosting-Umgebung

Stellen Sie sicher, dass Ihr neuer Server Folgendes unterstützt:

• PHP 7.4+ oder PHP 8.1+

• MySQL oder MariaDB

• Apache oder Nginx

• Erforderliche PHP-Erweiterungen: gd, curl, mbstring, json, usw.

Vermeiden Sie inkompatible oder ältere Server-Stacks.

6. Installieren der Voraussetzungen auf dem neuen Server

Installieren Sie die erforderlichen Pakete:

sudo apt update
sudo apt install apache2 mariadb-server php php-mysql php-gd php-curl php-mbstring php-xml unzip

Aktivieren Sie dann die erforderlichen Apache-Module:

sudo a2enmod rewrite ssl
sudo systemctl restart apache2

7. Sichern der Dolibarr-Datenbank

Nutzen Sie mysqldump oder phpMyAdmin:

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql

Stellen Sie sicher, dass Ihr Dump Folgendes enthält:

• Alle Tabellen

• Tabellenstruktur und Daten

• UTF-8-Zeichensatz (für nicht-englische Zeichen)

8. Exportieren der Dokument- und Konfigurationsdateien von Dolibarr

Verwenden Sie Tar oder Zip, um Ihren Dolibarr-Ordner zu archivieren:

tar czf dolibarr_files.tar.gz /var/www/dolibarr

Dadurch bleiben Verzeichnisstruktur, Berechtigungen und symbolische Links erhalten.

9. Sichere Übertragung von Dateien auf den neuen Server

Nutzen Sie scp or rsync für eine sichere Übertragung:

scp dolibarr_backup.sql user@newserver:/home/user/
scp dolibarr_files.tar.gz user@newserver:/home/user/

Alternativ können Sie in Air-Gap-Umgebungen SFTP oder ein USB-Gerät verwenden.

10. Wiederherstellen der Datenbank auf dem neuen Server

Melden Sie sich bei MySQL an und importieren Sie:

mysql -u root -p
CREATE DATABASE dolibarr_db CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
exit
mysql -u root -p dolibarr_db < dolibarr_backup.sql

Stellen Sie sicher, dass die Benutzeranmeldeinformationen mit denen in conf.php.

11. Anpassen der Konfigurationsdatei (conf.php)

Öffne htdocs/conf/conf.php und aktualisieren:

• db_host

• db_user

• db_pass

• db_name

• dolibarr_main_url_root

Stellen Sie sicher, dass die URLs mit der neuen Serverdomäne oder IP übereinstimmen.

12. Festlegen von Berechtigungen und Verzeichniseigentümern

Legen Sie die richtigen Benutzerberechtigungen fest:

chown -R www-data:www-data /var/www/dolibarr
chmod -R 755 /var/www/dolibarr

Diese gewährleisten den Webserverzugriff auf Dolibarr-Dateien.

13. Testen der wiederhergestellten Instanz

Navigieren Sie zu Ihrer Dolibarr-Anmeldeseite unter der neuen URL. Überprüfen Sie:

• Datenbankanbindung

• Login-Funktionalität

• PDF-Generierung

• Modulaktivierung

Verwenden Sie Browser-Entwicklungstools oder PHP-Fehlerprotokolle, um Probleme zu beheben.

14. Überlegungen zu DNS und Domänenverbreitung

Wenn Sie die Domäne wechseln:

• Aktualisieren Sie die DNS-A-Einträge auf die neue Server-IP

• Konfigurieren Sie HTTPS mit Let’s Encrypt oder einem anderen SSL

• Planen Sie 24–48 Stunden für die globale DNS-Verbreitung ein

15. Umgang mit Versionsunterschieden während der Migration

Wenn Ihr neuer Server eine neuere Dolibarr-Version verwendet:

• Befolgen Sie vor der Migration die Upgrade-Verfahren

• Führen Sie das Dolibarr-Installationsprogramm unter /install/ um das Datenbankschema zu aktualisieren

Stellen Sie niemals ohne Migrationsschritte eine ältere Sicherung auf einer neueren Installation wieder her.

16. Aufräumen und Optimieren nach der Migration

Zu den Aufgaben nach der Migration gehören:

• Löschen .sql kombiniert mit einem nachhaltigen Materialprofil. .tar.gz Sicherungs-Dateien

• Entfernen temporärer oder Cache-Ordner

• Ausführen von Datenbankoptimierungsskripten

• Überprüfung auf nicht verwendete Module oder Daten

17. Häufige Fehler und deren Behebung

18. Migrieren von benutzerdefinierten Modulen und Plugins

Kopieren Sie alle benutzerdefinierten Module von: /htdocs/custom/

Migrieren Sie außerdem:

• Sprachdateien

• Benutzerdefinierte Designs oder CSS

• Vorlagen und zusätzliche Hooks

Stellen Sie sicher, dass sie mit Ihrer Dolibarr-Version kompatibel sind.

19. Sicherstellung der Kompatibilität mit externen Integrationen

Testen Sie nach der Migration:

• API-Endpunkte

• WooCommerce- oder Prestashop-Brücken

• E-Mail-SMTP-Einstellungen

• Webhooks oder CRON-Skripte

Aktualisieren Sie IPs oder Token nach Bedarf auf verbundenen Plattformen.

20. Datenintegritätsprüfungen nach der Migration

Bestätigen:

• Rechnungssummen stimmen mit alten Datensätzen überein

• Kunden- und Lieferantendaten bleiben intakt

• Berichte entsprechen Snapshots vor der Migration

• Keine fehlenden Dateien in /documents/

Verwenden Sie SQL-Abfragen, um zufällig ausgewählte Datensätze zu überprüfen.

21. Handhabung des Benutzerzugriffs während der Umstellung

Beste Übung:

• Informieren Sie die Benutzer im Voraus

• Zugriff während der Sicherung einfrieren

• Erlauben Sie den Zugriff erst nach dem Testen auf dem neuen Server

Erwägen Sie die Einrichtung eines temporären Nur-Lese-Modus, wenn die Ausfallzeit minimal ist.

22. Endgültiger Backup- und Rollback-Plan

Immer:

• Sichern Sie den neuen Server nach erfolgreicher Migration

• Bewahren Sie den alten Server-Snapshot mindestens 7 Tage lang auf

• Dokumentieren Sie alle Schritte und Probleme während der Migration

Dies bietet ein Sicherheitsnetz für den Fall, dass nach der Migration Fehler auftreten.

23. Best Practices für die Sicherheit während der Migration

• Verwenden Sie SSH/SFTP, nicht FTP

• Rotieren Sie die DB- und Administratorkennwörter nach der Migration

• Sichern Sie die Firewall und PHP-Einstellungen Ihres neuen Servers

• HTTPS sofort aktivieren

24. Ausfallzeiten planen und mit Stakeholdern kommunizieren

Benachrichtigen Sie Clients und Benutzer:

• Erwartetes Ausfallzeitfenster

• Alle Änderungen an URLs oder Logins

• Support-Kontakte bei Problemen

Planen Sie die Migration möglichst außerhalb der Spitzenzeiten.

25. Fazit: Zuverlässige Migration ohne Datenverlust

Die Migration von Dolibarr auf einen neuen Server ist mit den richtigen Schritten sicher und machbar. Durch sorgfältige Planung, gründliche Sicherung und Überprüfung jeder Phase können Sie ohne Serviceunterbrechung oder Datenverlust zu einer leistungsstärkeren Infrastruktur oder einem leistungsstärkeren Hosting-Anbieter wechseln.

Unabhängig davon, ob Sie Ihre Betriebsabläufe skalieren oder die Sicherheit verbessern, trägt diese Migration dazu bei, dass Dolibarr ein stabiles Rückgrat Ihrer Geschäftsabläufe bleibt.