Inhaltsverzeichnis

  1. Einführung

  2. Warum Sie Dolibarr auf dem neuesten Stand halten sollten

  3. Den Veröffentlichungszyklus von Dolibarr verstehen

  4. Überprüfen Ihrer aktuellen Dolibarr-Version

  5. Überlegungen vor dem Update

  6. Sichern Ihrer Installation

  7. Auswerten von Anpassungen und Kompatibilität

  8. Vorbereiten einer Staging-Umgebung

  9. Auswählen der richtigen Update-Methode

  10. Methode 1: Manuelles Update durch Dateiersetzung

  11. Methode 2: Verwenden von Git für Updates

  12. Methode 3: Verwenden von Softaculous oder Installer Tools

  13. Ausführen des Dolibarr-Update-Assistenten

  14. Häufige Fehler beim Update und wie man sie behebt

  15. Überprüfen des Datenbankschemas und der Integrität

  16. Konfigurationsschritte nach dem Update

  17. Aktualisieren benutzerdefinierter Module und Designs

  18. Testen nach dem Update

  19. Verfolgen zukünftiger Updates

  20. Fazit


1. Einleitung

Dolibarr ist eine Open-Source-ERP/CRM-Lösung, die von Unternehmen weltweit eingesetzt wird. Wie bei jeder Softwareplattform ist es wichtig, stets auf der neuesten Version zu bleiben, um Zugriff auf neue Funktionen, verbesserte Leistung, Fehlerbehebungen und Sicherheitsverbesserungen zu erhalten. Diese Anleitung führt Sie Schritt für Schritt durch die Aktualisierung Ihrer Dolibarr-Installation auf die neueste stabile Version, unabhängig davon, ob Sie eine kleine Geschäftsinstanz oder eine groß angelegte Bereitstellung betreiben.


2. Warum Sie Dolibarr auf dem neuesten Stand halten sollten

  • Sicherheit: Patches schließen Schwachstellen, die Daten offenlegen könnten.

  • Eigenschaften: Neue Versionen enthalten erweiterte Funktionen.

  • Kompatibilität: Aktualisierte Integrationen und Bibliotheken gewährleisten kontinuierlichen Support.

  • Fehlerbehebung: Kritische Fehlerbehebungen sind in jeder neuen Version enthalten.

  • Community Support: Die meisten Foren und Entwickler beziehen sich auf die neueste Version.

Beim Ausführen veralteter Versionen besteht das Risiko von Datenverlust, Funktionseinschränkungen und Integrationsfehlern.


3. Den Release-Zyklus von Dolibarr verstehen

Dolibarr folgt einem vorhersehbaren Versionierungsmuster:

  • Hauptversionen (z. B. 17.0.0) bringen strukturelle Änderungen mit sich.

  • Kleinere Updates (z. B. 17.0.3) umfassen Fehlerbehebungen und Patches.

Neue stabile Versionen werden etwa alle 6 bis 12 Monate veröffentlicht. Bleiben Sie informiert über www.dolibarr.org oder GitHub.


4. Überprüfen Ihrer aktuellen Dolibarr-Version

Melden Sie sich als Administrator an und gehen Sie zu Startseite > Über Dolibarr. Dort finden Sie die installierte Version und Build-Details. Alternativ können Sie oben im htdocs/filefunc.inc.php Datei für die $dolibarr_version variabel.


5. Überlegungen vor dem Update

Bevor Sie fortfahren:

  • Versionshinweise lesen Veränderungen zu verstehen

  • Auflisten von benutzerdefinierten Modulen und Überschreibungen Sie haben implementiert

  • Serveranforderungen bestätigen passen zur neuen Version (PHP, MySQL usw.)

  • Benutzer benachrichtigen über mögliche Ausfallzeiten

Behandeln Sie Updates mit der gleichen Ernsthaftigkeit wie Systemmigrationen.


6. Sichern Ihrer Installation

Immer sichern:

  • Datenbank mit automatisierten mysqldump oder Ihr Bedienfeld

  • Dateien und Verzeichnisse, besonders:

    • /htdocs/

    • /documents/

    • /conf/

Beispielbefehl:

mysqldump -u root -p dolibarr_db > dolibarr_backup.sql
zip -r dolibarr_files.zip /var/www/html/dolibarr/

Speichern Sie Backups sicher und stellen Sie sicher, dass sie wiederhergestellt werden können.


7. Anpassungen und Kompatibilität bewerten

  • Überprüfen Sie alle geänderten Dateien unter /core/ oder Modulordner

  • Testen Sie, ob benutzerdefinierte Module mit der neuen Version kompatibel sind

  • Erwägen Sie die Verwendung der /custom/ Verzeichnis, um Konflikte zu vermeiden

  • Überprüfen Sie die Community-Foren auf bekannte Probleme mit Themen oder Modulen von Drittanbietern


8. Vorbereiten einer Staging-Umgebung

Die beste Vorgehensweise besteht darin:

  • Klonen Sie Ihre Live-Site auf einen Staging-Server

  • Führen Sie dort zunächst das Update durch

  • Validieren Sie alle Workflows und Integrationen

Dies minimiert das Risiko und ermöglicht umfassende Tests, bevor die Produktion beeinträchtigt wird.


9. Die richtige Update-Methode wählen

Sie können Dolibarr wie folgt aktualisieren:

  • Manueller Dateiaustausch (für die meisten Benutzer empfohlen)

  • Git-Repository (für Entwickler und Mitwirkende)

  • Softaculous/Installatron (bei Installation über cPanel)

Die Methode hängt davon ab, wie Sie Dolibarr ursprünglich installiert haben.


10. Methode 1: Manuelles Update durch Dateiersetzung

  1. Laden Sie die neueste stabile Version herunter von www.dolibarr.org

  2. Extrahieren Sie das Archiv in einen temporären Ordner

  3. Löschen Sie diese Ordner in Ihrer alten Instanz:

    • /htdocs

    • (außer /documents kombiniert mit einem nachhaltigen Materialprofil. /conf)

  4. Kopieren Sie das neue /htdocs Dateien über den alten Speicherort

  5. Behalten /documents/ kombiniert mit einem nachhaltigen Materialprofil. /conf/

  6. Wechseln zu http://yourdomain/install/

Folgen Sie dem Assistenten, um das Update abzuschließen.


11. Methode 2: Git für Updates verwenden

Wenn Sie Dolibarr von GitHub geklont haben:

cd /var/www/dolibarr
git pull origin develop

Dann renne:

php htdocs/install/upgrade.php

Stellen Sie sicher, dass Sie vor der Bereitstellung zu einer getaggten Version oder einem stabilen Zweig wechseln.


12. Methode 3: Verwenden von Softaculous oder Installer Tools

Wenn Dolibarr über Softaculous installiert wurde:

  1. Melden Sie sich bei cPanel > Softaculous an

  2. Suchen Sie Dolibarr und klicken Sie auf Jetzt

  3. Befolgen Sie die Anweisungen

Hinweis: Softaculous kann die Unterstützung für die neuesten Versionen verzögern. Manuelle Backups sind weiterhin unerlässlich.


13. Ausführen des Dolibarr-Update-Assistenten

Nach dem Ersetzen der Datei:

  • Navigieren /install/

  • Der Update-Assistent erkennt Ihre vorherige Version

  • Führen Sie das Upgrade-Skript Schritt für Schritt aus

  • Entfernen oder umbenennen Sie die /install/ Verzeichnis, wenn Sie fertig sind

Überwachen Sie alle Schemaänderungen oder Warnungen.


14. Häufige Fehler beim Update und deren Behebung

Leere Seite nach dem Update:

  • Überprüfen Sie die Dateiberechtigungen

  • Cache/Browser-Cookies löschen

Fehler „Zugriff verweigert“:

  • Verify conf.php und Datenbankanmeldeinformationen

Update-Assistent startet nicht:

  • Gewährleisten /install/ Ordner ist vorhanden

  • Einblick in das .htaccess Regeln umschreiben


15. Überprüfen des Datenbankschemas und der Integrität

Überprüfen Sie nach dem Update:

  • Alle Module sind noch aktiv

  • Datentabellen sind vorhanden und werden ordnungsgemäß geladen

  • Keine doppelten oder fehlenden Zeilen

Verwenden Sie phpMyAdmin oder Datenbankadministratortools, um den Tabellenstatus zu überprüfen.


16. Konfigurationsschritte nach dem Update

  • Einblick in das Setup > Module um deaktivierte Module wieder zu aktivieren

  • Testen Sie die PDF-Generierung, den E-Mail-Versand und externe Integrationen

  • Bestätigen Sie, dass Cron-Jobs ausgeführt werden (für wiederkehrende Rechnungen, Aufgaben)

  • Browser- und Dolibarr-Caches leeren


17. Aktualisieren benutzerdefinierter Module und Designs

  • Aktualisierte Vorlagen kopieren nach /custom/modules/

  • Überprüfen Sie Änderungen in der Kernstruktur, die Themen beschädigen könnten

  • Testen Sie visuelle Elemente und Layout auf allen Geräten

Für die Kompatibilität einiger Module von Drittanbietern sind möglicherweise neue Versionen erforderlich.


18. Testen nach dem Update

Gründlich testen:

  • Benutzeranmeldungen und Berechtigungen

  • Rechnungserstellung und Zahlungserfassung

  • Produkt- und Bestandsverwaltung

  • Benutzerdefinierte Berichte oder Dashboards

  • API-Endpunkte und Webhooks

Validieren Sie jede Kernfunktion und jeden geschäftskritischen Prozess.


19. Verfolgen zukünftiger Updates

  • Abonnieren Sie Dolibarr-Newsletter oder RSS-Feeds

  • Verfolgen Sie GitHub-Releases und Änderungsprotokolle

  • Planen Sie vierteljährliche Überprüfungs- und Aktualisierungszyklen

  • Zuweisen der Update-Verantwortung an einen Administrator oder ein IT-Team

Bleiben Sie proaktiv, um Leistung und Sicherheit zu gewährleisten.


20. Fazit

Die Aktualisierung von Dolibarr auf die neueste Version ist unerlässlich für eine sichere, stabile und funktionsreiche ERP/CRM-Umgebung. Mit dieser umfassenden Anleitung – Sichern, Testen und Überprüfen jedes Schritts – können Sie ein reibungsloses Upgrade durchführen, das die Systemleistung verbessert, ohne Ihren Geschäftsbetrieb zu beeinträchtigen.