Upgrade¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 16.0 to Odoo 18.0). Regular upgrades are crucial as each version offers new features, bug fixes, and security patches. Using a supported version is strongly recommended. Each major version is supported for three years.
Je nach Hosting-Typ und verwendeter Odoo-Version kann ein Datenbank-Upgrade erforderlich sein.
If a database is on a major version (e.g., 16.0, 17.0, 18.0), an upgrade is mandatory every two years.
If a database is on a minor version (e.g., 17.1, 17.2, 17.4), an upgrade is mandatory a few weeks after the next version is released. Minor versions are usually released every two months.
Nach den ersten drei Jahren der Unterstützung haben Sie weitere zwei Jahre Zeit, um das Upgrade abzuschließen. Sie werden benachrichtigt, wenn ein Upgrade erforderlich ist.
Sie können auf unbestimmte Zeit bei derselben Version bleiben, auch wenn dies nicht empfohlen wird. Beachten Sie, dass das Upgrade umso einfacher sein sollte, je kleiner der Versionsunterschied ist.
Einige Wochen vor der automatischen Durchführung eines obligatorischen Upgrades erhalten Sie eine Benachrichtigung in Ihrer Datenbank. Solange die Frist nicht erreicht ist, haben Sie die Kontrolle über den Prozess.
Konkret führt das Upgrade-Team von Odoo ein stilles Test-Upgrade jeder Datenbank durch, die aktualisiert werden sollte. Wenn der Test erfolgreich ist und weniger als 20 Minuten dauert, können Sie das Upgrade direkt von der Datenbank aus auslösen. Wenn der Test fehlschlägt, können Sie ein Upgrade mit dem Datenbankmanager testen.
Wenn Sie zu einem Upgrade eingeladen werden, wird dringend empfohlen, zunächst eine :ref:` geupgradete Testdatenbank anzufragen <upgrade-request-test>` und diese ausführlich zu:ref:testen <upgrade-testing>
.
Wenn vor dem angegebenen Fälligkeitsdatum keine Aktion durchgeführt wird, wird automatisch ein Upgrade auf die nächste Version durchgeführt.
Folgendes beinhaltet ein Upgrade nicht:
Downgrade auf eine frühere Version von Odoo
Edition wechseln (z. B. von Community zu Enterprise)
Hostingtyp ändern (z. B. von On-premise zu Odoo Online)
Migration aus einem anderen ERP zu Odoo
Warnung
Wenn Ihre Datenbank benutzerdefinierte Module enthält, kann sie erst dann aktualisiert werden, wenn eine Version Ihrer benutzerdefinierten Module für die Zielversion von Odoo verfügbar ist. Für Kunden, die ihre eigenen benutzerdefinierten Module pflegen, empfehlen wir, den Prozess zu parallelisieren, indem Sie eine aktualisierte Datenbank anfordern und gleichzeitig den Quellcode Ihrer benutzerdefinierten Module aktualisieren.
Upgrade kurz erklärt¶
Fordern Sie eine aktualisierte Testdatenbank an (siehe Eine aktualisierte Testdatenbank erhalten).
Aktualisieren Sie gegebenenfalls den Quellcode Ihres benutzerdefinierten Moduls, damit es mit der neuen Version von Odoo kompatibel ist (siehe Upgrade a customized database).
Testen Sie die aktualisierte Datenbank gründlich (siehe Die neue Version der Datenbank testen).
Melden Sie Odoo jedes Problem, das während des Tests auftritt, indem Sie zur Supportseite gehen und „Ein Problem im Zusammenhang mit meinem zukünftigen Upgrade (Ich teste gerade ein Upgrade)“ auswählen.
Sobald alle Probleme behoben sind und Sie sicher sind, dass die aktualisierte Datenbank ohne Probleme als Hauptdatenbank verwendet werden kann, planen Sie das Upgrade Ihrer Produktionsdatenbank.
Fordern Sie das Upgrade für die Produktionsdatenbank an und machen Sie sie für die Zeit, die für den Abschluss des Prozesses benötigt wird, nicht verfügbar (siehe Upgrade der Produktionsdatenbank).
Melden Sie Odoo jedes Problem, das während des Upgrades auftritt, indem auf der Supportseite „Ein Problem im Zusammenhang mit meinem Upgrade (Produktion)“ auswählen.
Eine upgegradete Testdatenbank erhalten¶
Die Upgrade-Seite ist die wichtigste Plattform, um eine aktualisierte Datenbank anzufordern. Je nach Hostingtyp können Sie das Upgrade jedoch auch über die Befehlszeile (On-Premise), den Odoo-Online-Datenbankmanager oder Ihr Odoo.sh Projekt durchführen.
Bemerkung
Für die Upgrade-Plattform gelten dieselben Datenschutzbestimmungen wie für die anderen Dienstleistungen von Odoo.com. Besuchen Sie die Seite Datenschutz-Grundverordnung (DSGVO), um mehr darüber zu erfahren, wie Odoo mit Ihren Daten und Ihrer Privatsphäre umgeht.
Odoo-Online-Datenbanken können manuell über den `Datenbankmanager <https://www.odoo.com/my/databases>`_aktualisiert werden.
Im Datenbankmanager werden alle Datenbanken angezeigt, die mit dem Konto des Benutzers verbunden sind. Bei allen Datenbanken, die noch nicht auf der neuesten Version von Odoo sind, wird neben dem Datenbanknamen ein Pfeil in einem Kreis angezeigt, der darauf hinweist, dass die Datenbank aktualisiert werden kann.
Klicken Sie auf das Symbol Pfeil im Kreis, um den Upgrade-Prozess zu starten. Geben Sie in dem Pop-up-Fenster Folgendes ein:
Die Version von Odoo, auf die Sie aktualisieren möchten, normalerweise die neueste Version
Die E-Mail-Adresse, die den Link zur aktualisierten Datenbank erhalten soll
Der Zweck des Upgrades, der bei Ihrer ersten Upgrade-Anfrage automatisch auf Test gesetzt wird
Das Stoichwort Upgrade im Gange wird bis zur Fertigstellung neben dem Datenbanknamen angezeigt. Sobald der Vorgang erfolgreich abgeschlossen ist, wird eine E-Mail mit einem Link zur aktualisierten Testdatenbank an die angegebene Adresse gesendet. Sie können auch über den Datenbankmanager auf die Datenbank zugreifen, indem Sie auf den Dropdown-Pfeil vor dem Datenbanknamen klicken.
Odoo.sh ist in die Upgrade-Plattform integriert, um den Upgrade-Prozess zu vereinfachen.
Das aktuellste tägliche automatische Produktions-Back-up wird an die Upgrade-Plattform gesendet.
Nachdem die Upgrade-Plattform das Upgrade des Back-ups und das Hochladen abgeschlossen hat, befindet der Zweig sich jetzt in einem besonderen Modus: jedes Mal, wenn ein Commit auf den Zweig übertragen wird, findet ein Wiederherstellungsvorgang des aktualisierten Back-ups statt, und es erfolgt ein Update aller benutzerdefinierten Module. Auf diese Weise können Sie Ihre benutzerdefinierten Module mit einer unveränderten Kopie der aktualisierten Datenbank testen. Die Protokolldatei des Upgrade-Prozesses finden Sie unter ~/logs/upgrade.log
in Ihrem neu aktualisierten Staging-Build.
Wichtig
Bei Datenbanken, in denen benutzerdefinierte Module installiert sind, muss deren Quellcode auf dem neuesten Stand der Zielversion von Odoo sein, bevor das Upgrade durchgeführt werden kann. Wenn dies nicht der Fall ist, wird der Modus „Update bei Commit“ übersprungen, die aktualisierte Datenbank wird erstellt, sobald sie von der Upgrade-Plattform übertragen wird, und der Upgrade-Modus wird beendet.
Weitere Informationen finden Sie auf der Seite Upgrade a customized database.
Der Standard-Upgrade-Prozess kann durch Eingabe der folgenden Befehlszeile auf dem Rechner, auf dem die Datenbank gehostet wird, eingeleitet werden:
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Bemerkung
Dieser Befehl stellt einige Anforderungen an die Umgebung, in der er ausgeführt wird:
Einige externe Befehle, die vom Betriebssystem bereitgestellt werden müssen, sind normalerweise in jeder Linux-Distribution (einschließlich WSL) enthalten. Wenn einer oder mehrere davon fehlen, wird ein Fehler angezeigt.
Der Systembenutzer, der den Befehl ausführt, muss mit Zugriff auf die Datenbank konfiguriert werden. Weitere Informationen zu dieser Anforderung finden Sie in der PostgreSQL-Dokumentation der Client-Umgebung oder der Client-Kennwortdatei.
Das Skript muss in der Lage sein, einen oder mehrere Server der Upgrade-Plattform sowohl über den TCP-Port 443 als auch über einen beliebigen TCP-Port im Bereich zwischen 32768 und 60999 zu erreichen. Dies kann zu Konflikten mit Ihrer restriktiven Firewall führen und erfordert möglicherweise das Hinzufügen einer Ausnahme zur Firewall-Konfiguration.
Mit dem folgenden Befehl können Sie die allgemeine Hilfe und die wichtigsten Befehle anzeigen:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
Eine aktualisierte Testdatenbank kann auch über die Upgrade-Seite angefordert werden.
Wichtig
Bei Datenbanken, in denen benutzerdefinierte Module installiert sind, muss deren Quellcode auf die Zielversion von Odoo aktualisiert werden, bevor das Upgrade durchgeführt werden kann. Weitere Informationen finden Sie auf der Seite Upgrade a customized database.
Bemerkung
Aus Sicherheitsgründen kann nur die Person, die die Upgrade-Anfrage gestellt hat, diese herunterladen.
Aus Speicherplatzgründen wird die Kopie der Datenbank ohne einen Dateispeicher an den Upgrade-Server übermittelt. Daher enthält die aktualisierte Datenbank nicht den Produktionsdateispeicher.
Bevor Sie die aktualisierte Datenbank wiederherstellen, muss ihr Dateispeicher mit dem Produktionsdateispeicher zusammengeführt werden, damit die Tests unter denselben Bedingungen wie in der neuen Version durchgeführt werden können.
Die aktualisierte Datenbank enthält:
Eine
dump.sql
-Datei, die die aktualisierte Datenbank enthältEin Ordner
filestore
, der Dateien enthält, die aus den Datensätzen in der Datenbank in Anhänge extrahiert wurden (falls vorhanden), sowie neue Odoo-Standarddateien aus der neuen Odoo-Version (z. B. neue Bilder, Symbole, Logos der Zahlungsanbieter usw.). Dies ist der Ordner, der mit dem Produktionsdateispeicher zusammengeführt werden sollte, um den vollständigen aktualisierten Dateispeicher zu erhalten.
Bemerkung
Sie können mehrere Testdatenbanken anfordern, wenn Sie ein Upgrade mehr als einmal testen möchten.
Bemerkung
Wenn eine Upgrade-Anfrage abgeschlossen ist, wird der E-Mail zur Bestätigung des erfolgreichen Upgrade ein Upgrade-Bericht angehängt und er steht auch in der Dialog-App für Benutzer, die Teil der Gruppe „Administration/Einstellungen“, zur Verfügung. Dieser Bericht gibt wichtige Informationen zu den durch die neue Version eingegebenen Änderungen.
Die neue Version der Datenbank testen¶
Es ist essenziell, etwas die geupgradete Testdatenbank zu testen, um sicherzustellen, dass Sie nicht bei alltäglichen Aktivitäten durch eine Änderungen in Ansichten, Verhalten oder einer Fehlermeldung gehemmt werden, wenn das Upgrade live ist.
Bemerkung
Testdatenbanken werden neutralisiert und Funktionen werden deaktiviert, um zu verhindern, dass sie sich auf die Produktionsdatenbank auswirken:
Geplante Aktion sind deaktiviert.
Ausgangsmailserver werden deaktiviert, indem die vorhandenen Server archiviert und ein gefälschter Server hinzugefügt wird.
Zahlungsanbieter und Zustelldienste werden auf die Testumgebung zurückgesetzt.
Die Bankensynchronisierung ist deaktiviert. Wenn Sie die Synchronisierung testen möchten, wenden Sie sich an Ihren Bankensynchronisationsanbieter, um Sandbox-Zugangsdaten zu erhalten.
Es wird dringend empfohlen, so viele Ihrer Geschäftsabläufe wie möglich zu testen, um sicherzustellen, dass sie korrekt funktionieren und um sich mit der neuen Version vertraut zu machen.
Checkliste für allgemeinen Test
Gibt es Ansichten, die in Ihrer Testdatenbank deaktiviert, aber in Ihrer Produktionsdatenbank aktiv sind?
Werden Ihre üblichen Ansichten noch korrekt angezeigt?
Werden Ihre Berichte (Rechnung, Verkaufsauftrag usw.) korrekt erstellt?
Funktionieren die Seiten Ihrer Website korrekt?
Sind Sie in der Lage, Datensätze zu erstellen und zu ändern? (Verkaufsaufträge, Rechnungen, Einkäufe, Benutzer, Kontakte, Unternehmen usw.)
Gibt es Probleme mit Ihren E-Mail-Vorlagen?
Gibt es Probleme mit gespeicherten Übersetzungen?
Sind Ihre Suchfilter noch vorhanden?
Können Sie Ihre Daten exportieren?
Prüfen Sie ein zufälliges Produkt in Ihrem Produktkatalog und vergleichen Sie dessen Test- und Produktionsdaten, um sicherzustellen, dass alles übereinstimmt (Produktkategorie, Verkaufspreis, Einkaufspreis, Lieferant, Konten, Routen usw.).
Kaufen Sie dieses Produkt (Einkaufsapp).
Bestätigen Sie den Erhalt des Produkts (Lagerapp).
Prüfen Sie, ob die Route zum Erhalt dieses Produkts ist dieselbe in Ihrer Produktionsdatenbank (Lagerapp).
Verkaufen Sie dieses Produkt (Verkaufsapp) an einen beliebigen Kunden.
Öffnen Sie Ihre Kundendatenbank (Kontakte-App), wählen Sie den Kunden (oder das Unternehmen) aus und prüfen Sie die Daten.
Versenden Sie dieses Produkt (Lagerapp).
Prüfen Sie, ob die Route zum Versand dieses Produkts ist dieselbe wie in Ihrer Produktionsdatenbank (Lagerapp).
Validieren Sie eine Kundenrechnung (Rechnungsstellungs- oder Buchhaltungsapp).
Erstellen Sie die Rechnung (Erstellung einer Gutschrift) und prüfen Sie, ob es in Ihrer Produktsdatenbank funktioniert.
Prüfen Sie die Ergebnisse Ihrer Berichte (Buchhaltungsapp).
Prüfen Sie stichprobenartig Ihre Steuern, Währungen, Bankkonten und das Geschäftsjahr (Buchhaltungsapp).
Tätigen Sie eine Online-Bestellung (Website-App) aus der Produktauswahl in Ihrem Shop bis der Kassiervorgang beginnt und prüfen Sie, ob alles in Ihrer Produktionsdatenbank funktioniert.
Die Liste ist nicht vollständig. Erweitern Sie das Beispiel auf Ihre anderen Apps, basierend auf Ihrer Verwendung von Odoo.
Wenn während des Tests der geupgradeten Datenbank ein Problem auftritt, können Sie Odoo um Hilfe bitten, indem Sie auf der Supportseite „Ein Problem im Zusammenhang mit meinem zukünftigen Upgrade (Ich teste gerade ein Upgrade)“. In jedem Fall ist es wichtig, dass Sie jedes Problem, das während des Tests auftritt, melden, um es zu beheben, bevor Sie Ihre Produktionsdatenbank aktualisieren.
Während des Testens können Sie erhebliche Unterschiede bei Standardansichten, Funktionen, Feldern und Modellen feststellen. Diese Änderungen können nicht von Fall zu Fall rückgängig gemacht werden. Wenn jedoch eine Änderung, die durch eine neue Version eingeführt wurde, eine Anpassung zunichte macht, liegt es in der Verantwortung des Instandhalters Ihres benutzerdefinierten Moduls, es mit der neuen Version von Odoo kompatibel zu machen.
Tipp
Vergessen Sie nicht, Folgendes zu testen:
Integrationen mit externer Software (EDI, API usw.)
Arbeitsabläufe zwischen unterschiedlichen Apps (Online-Verkäufe mit E-Commerce, Umwandlung eines Leads zum Verkaufsauftrag, Lieferung von Produkten usw.)
Datenexporte
Automatisierte Aktionen
Severaktionen im Aktionsmenü auf Formularansichten sowie Auswahl mehrerer Datensätze auf Listenansichten
Upgrade der Produktionsdatenbank¶
Sobald die Tests abgeschlossen sind und Sie sicher sind, dass die aktualisierte Datenbank ohne Probleme als Hauptdatenbank verwendet werden kann, planen Sie die Inbetriebnahme Ihrer Datenbank.
Ihre Produktionsdatenbank ist während des Upgrades nicht verfügbar. Daher empfehlen wir Ihnen, das Upgrade zu einem Zeitpunkt zu planen, an dem die Datenbank nur noch wenig genutzt wird.
Da sich die Standard-Upgrade-Skripte und Ihre Datenbank ständig weiterentwickeln, ist es außerdem empfehlenswert, mehrfach eine weitere aktualisierte Testdatenbank anzufragen, um sicherzustellen, dass der Upgrade-Prozess weiterhin erfolgreich verläuft, insbesondere wenn er lange dauert. **Wir empfehlen auch, den Upgrade-Prozess am Tag vor dem Upgrade der Produktionsdatenbank gründlich zu proben.
Wichtig
Wenn Sie ohne vorherige Tests zum Produktionszweig übergehen, kann Folgendes geschehen:
Benutzer, die sich nicht an die Änderungen und neuen Funktionen gewöhnen können
Geschäftsunterbrechungen (z. B. keine Möglichkeit mehr, eine Aktion zu validieren)
schlechte Kundenerfahrungen (z. B. eine E-Commerce-Website, die nicht richtig funktioniert)
Der Upgrade-Prozess einer Produktionsdatenbank ist ähnlich wie der Upgrade-Prozess einer Testdatenbank, aber mit einigen Ausnahmen.
Der Prozess ist ähnlich wie beim Erhalt einer geupgradeten Testdatenbank, mit Ausnahme der „Zweck“-Option, die auf Produktion statt Test gesetzt werden muss.
Warnung
Sobald das Upgrade angefordert wird, ist die Datenbank nicht mehr verfügbar, bis das Upgrade abgeschlossen ist. Sobald der Vorgang abgeschlossen ist, ist es nicht mehr möglich, zur vorherigen Version zurückzukehren.
Der Prozess ist ähnlich wie beim Erhalt einer geupgradeten Testdatenbank auf dem Produktionszweig.
Der Prozess wird ausgelöst, sobald ein neuer Commit im Zweig vorgenommen wird. Dadurch kann der Upgrade-Prozess mit der Bereitstellung des geupgradeten Quellcodes der benutzerdefinierten Module synchronisiert werden. Wenn es keine benutzerdefinierten Module gibt, wird der Upgrade-Prozess sofort ausgelöst.
Wichtig
Die Datenbank ist während des Prozesses nicht verfügbar. Wenn etwas schief geht, macht die Plattform das Upgrade automatisch rückgängig, so wie es auch bei einer regulären Aktualisierung der Fall wäre. Im Erfolgsfall wird ein Backup der Datenbank vor dem Upgrade erstellt.
Die Aktualisierung Ihrer benutzerdefinierten Module muss erfolgreich sein, damit der gesamte Upgrade-Prozess abgeschlossen werden kann. Stellen Sie sicher, dass der Status Ihres Staging-Upgrades erfolgreich ist, bevor Sie es in der Produktion ausprobieren. Weitere Informationen, wie Sie Ihre benutzerdefinierten Module upgraden können, finden Sie unter Upgrade a customized database.
Der Befehl zum Upgrade einer Datenbank auf die Produktionsversion ähnelt dem des Upgrades einer Testdatenbank, mit Ausnahme des Arguments test
, das durch production
ersetzt werden muss:
$ python <(curl -s https://upgrade.odoo.com/upgrade) production -d <your db name> -t <target version>
Eine aktualisierte Produktionsdatenbank kann auch über die Upgrade-Seite angefordert werden.
Sobald die Datenbank hochgeladen ist, werden alle Änderungen an Ihrer Produktionsdatenbank nicht in Ihrer geugradeten Datenbank übernommen. Deshalb empfehlen wir, die Datenbank während des Upgrades nicht zu verwenden.
Wichtig
Wenn Sie eine geupgradeten Datenbank für Produktionszwecke anfragen, wird die Kopie ohne Dateispeicher eingereicht. Daher muss der aktualisierte Datenbank-Dateispeicher mit dem Produktionsdateispeicher zusammengeführt werden, bevor die neue Version bereitgestellt wird.
Bei Problemen mit Ihrer Produktionsdatenbank können Sie Odoo um Hilfe bitten, indem Sie auf die Supportseite „Ein Problem im Zusammenhang mit meinem zukünftigen Upgrade (Ich teste gerade ein Upgrade)“ auswählen.
Service-Level-Agreement (SLA)¶
Mit Odoo Enterprise ist das Upgrade einer Datenbank auf die neueste Version von Odoo kostenlos, einschließlich des erforderlichen Supports zur Behebung möglicher Unstimmigkeiten in der aktualisierten Datenbank.
Informationen über die in der Enterprise-Lizenz enthaltenen Upgrade-Services finden Sie in der Odoo-Enterprise-Abo-Vereinbarung. In diesem Abschnitt wird jedoch erläutert, welche Upgrade-Services Sie erwarten können.
Upgrade-Services, die durch die SLA abgedeckt sind¶
Datenbanken, die auf den Cloud-Plattformen von Odoo (Odoo Online und Odoo.sh) gehostet werden oder selbst gehostet sind (On-Premise), können jederzeit von den Upgrade-Services profitieren:
das Upgrade aller Standardapps;
das Upgrade aller mit Studio erstellten Anpassungen, vorausgesetzt Studio ist noch installiert und das entsprechende Abonnement ist noch aktiv; und
das Upgrade aller Entwicklungen und Anpassungen, die durch ein Abonnement für die Wartung von Anpassungen abgedeckt sind.
Die Upgrade-Services beschränken sich auf die technische Konvertierung und Anpassung einer Datenbank (Standardmodule und Daten), um sie mit der Version kompatibel zu machen, auf die das Upgrade abzielt.
Upgrade-Services, die nicht durch die SLA abgedeckt sind¶
Die folgenden Upgrade-bezogenen Leistungen sind nicht enthalten:
die Bereinigung bereits vorhandener Daten und Konfigurationen während des Upgrades;
the upgrade of additional modules not covered by a maintenance contract that are created in-house or by third parties, including Odoo partners; and
Schulung zur Verwendung der Funktionen und Arbeitsabläufe der aktualisierten Version.
Siehe auch