Upgrade¶
An upgrade involves moving a database from an older version to a newer supported version (e.g., from Odoo 15.0 to Odoo 17.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.
Depending on the hosting type and Odoo version used, a database upgrade can be mandatory.
If a database is on a major version (e.g., 15.0, 16.0, 17.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 three months.
After the initial three years of support, you will have another two years to complete the upgrade. You will be notified when an upgrade is required.
You can stay on the same version indefinitely, even if it is not recommended. Note that the smaller the version gap, the easier the upgrade should be.
You will receive a notification in your database a few weeks before a mandatory upgrade will be automatically carried out. You are in control of the process as long as the deadline is not reached.
Concretely, Odoo’s Upgrade Team performs a silent test upgrade of every database that should be upgraded. If the test is successful and lasts less than 20 minutes, you can directly trigger the upgrade from the database. If the test fails, you can test an upgrade using the database manager.
When you are invited to upgrade, it is strongly recommended to request an upgraded test database first and spend time testing it.
An automatic upgrade to the next version will be triggered if no action is taken before the specified due date.
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
If your database contains custom modules, it cannot be upgraded until a version of your custom modules is available for the target version of Odoo. For customers maintaining their own custom modules, we recommend to parallelize the process by requesting an upgraded database while also upgrading the source code of your custom modules.
Upgrade kurz erklärt¶
Request an upgraded test database (see obtaining an upgraded test database).
Aktualisieren Sie gegebenenfalls den Quellcode Ihres benutzerdefinierten Moduls, damit es mit der neuen Version von Odoo kompatibel ist (siehe Upgrade a customized database).
Thoroughly test the upgraded database (see testing the new version of the database).
Report any issue encountered during the testing to Odoo by going to the Support page and selecting „An issue related to my future upgrade (I am testing an upgrade)“.
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.
Request the upgrade for the production database, rendering it unavailable for the time it takes to complete the process (see upgrading the production database).
Report any issue encountered during the upgrade to Odoo by going to the Support page and selecting „An issue related to my upgrade (production)“.
Eine upgegradete Testdatenbank erhalten¶
The Upgrade page is the main platform for requesting an upgraded database. However, depending on the hosting type, you can upgrade from the command line (on-premise), the Odoo Online database manager, or your Odoo.sh project.
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 databases can be manually upgraded via the database manager.
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.
The latest production daily automatic backup is then sent to the Upgrade platform.
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
This command has some requirements on the environment it runs in:
Some external commands that must be provided by the operating system, normally found in any Linux distribution (including WSL). An error will be displayed if one or several of them are missing.
The system user that executes the command needs to be configured with access to the database. Please refer to the PostgreSQL documentation of the client environment or the client password file for this requirement.
The script needs to be able to reach one or multiple servers of the upgrade platform both on TCP port 443 and to any random TCP port in the range between 32768 and 60999. This can be in conflict with your restrictive firewall and may need an exception added to the firewall configuration.
Mit dem folgenden Befehl können Sie die allgemeine Hilfe und die wichtigsten Befehle anzeigen:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
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¶
It is essential to test the upgraded test database to ensure that you are not stuck in your day-to-day activities by a change in views, behavior, or an error message once the upgrade goes live.
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.
If you face an issue while testing your upgraded test database, you can request the assistance of Odoo by going to the Support page and selecting „An issue related to my future upgrade (I am testing an upgrade)“. In any case, it is essential to report any problem encountered during the testing to fix it before upgrading your production database.
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¶
Once the tests are completed and you are confident that the upgraded database can be used as your main database without any issues, it is time to plan the go-live day.
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)
The process of upgrading a production database is similar to upgrading a test database, but with a few exceptions.
The process is similar to obtaining an upgraded test database, except for the purpose option, which must be set to Production instead of Test.
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.
The process is similar to obtaining an upgraded test database on the Production branch.
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>
An upgraded production database can also be requested via the Upgrade page.
Once the database is uploaded, any modification to your production database will not be present on your upgraded database. This is why we recommend not using it during the upgrade process.
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.
In case of an issue with your production database, you can request the assistance of Odoo by going to the Support page and selecting „An issue related to my future upgrade (I am testing an upgrade)“.
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;
das Upgrade von benutzerdefinierten Modulen, die selbst oder von Dritten, einschließlich Odoo-Partnern, erstellt wurden;
Zeilen von Code, der zu Standardmodulen hinzugefügt wurde, d. h. Anpassungen, die außerhalb der Studio-App erstellt wurden, manuell eingegebener Code und automatisierte Aktionen mit Python-Code; und
Schulung zur Verwendung der Funktionen und Arbeitsabläufe der aktualisierten Version.
Siehe auch