Upgraden¶
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.
Een jepgrade dekt niet:
Downgraden naar een eerdere versie van Odoo
Van editie wisselen (bijvoorbeeld van Community naar Enterprise)
Het hostingtype wijzigen (bijvoorbeeld van on-premise naar Odoo Online)
Migreren van een ander ERP naar Odoo
Waarschuwing
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.
Upgraden in een notendop¶
Request an upgraded test database (see obtaining an upgraded test database).
Indien van toepassing, upgrade de broncode van jouw aangepaste module zodat deze compatibel is met de nieuwe versie van Odoo (zie 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)”.
Zodra alle problemen zijn opgelost en je er zeker van bent dat de geüpgradede database zonder problemen als jouw hoofddatabase kan worden gebruikt, kunt je de upgrade van jouw productiedatabase plannen.
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)”.
Het verkrijgen van een geüpgradede testdatabase¶
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.
Notitie
Het Upgrade-platform volgt hetzelfde Privacybeleid als de andere Odoo.com-diensten. Bezoek de pagina ‘Algemene Verordening Gegevensbescherming <https://www.odoo.com/gdpr>’_ voor meer informatie over hoe Odoo omgaat met jouw gegevens en privacy.
Odoo Online databases can be manually upgraded via the database manager.
De databasemanager geeft alle databases weer die aan het gebruikersaccount zijn gekoppeld. Databases die niet op de meest recente versie van Odoo staan, tonen een pijl in een cirkelpictogram naast hun naam, wat aangeeft dat ze kunnen worden geüpgraded.
Klik op het pictogram pijl in een cirkel om het upgradeproces te starten. Vul in de pop-up in:
De versie van Odoo waarnaar je wilt upgraden, meestal de nieuwste versie
Het e-mailadres dat de link naar de geüpgradede database moet ontvangen
Het Purpose van de upgrade, dat automatisch wordt ingesteld op Test voor jouw eerste upgradeverzoek
De tag Upgrade wordt uitgevoerd wordt naast de databasenaam weergegeven totdat de upgrade is voltooid. Zodra het proces slaagt, wordt er een e-mail met een link naar de geüpgradede testdatabase naar het opgegeven adres verzonden. De database is ook toegankelijk vanuit Database Manager door op de vervolgkeuzepijl vóór de databasenaam te klikken.
Odoo.sh is geïntegreerd met het upgradeplatform om het upgradeproces te vereenvoudigen.
The latest production daily automatic backup is then sent to the Upgrade platform.
Zodra het upgradeplatform klaar is met het upgraden van de back-up en het uploaden ervan naar de branch, wordt deze in een speciale modus gezet: elke keer dat een commit op de branch wordt gepusht, wordt er een **herstelbewerking van de geüpgradede back-up en een update van alle aangepaste modules vinden plaats. Hierdoor kunt je jouw aangepaste modules testen op een onberispelijke kopie van de geüpgradede database. Het logbestand van het upgradeproces kunt je vinden in jouw nieuw geüpgradede staging-build door naar ~/logs/upgrade.log
te gaan.
Belangrijk
In databases waar aangepaste modules zijn geïnstalleerd, moet hun broncode up-to-date zijn met de doelversie van Odoo voordat de upgrade kan worden uitgevoerd. Als er geen zijn, wordt de modus “update on commit” overgeslagen, wordt de geüpgradede database gebouwd zodra deze wordt overgedragen van het upgradeplatform, en wordt de upgrademodus verlaten.
Bekijk de Upgrade a customized database pagina voor meer informatie.
Het standaard upgradeproces kan worden gestart door de volgende opdrachtregel in te voeren op de machine waarop de database wordt gehost:
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Notitie
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.
Het volgende commando kan worden gebruikt om de algemene hulp en de belangrijkste commando’s weer te geven:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Belangrijk
In databases waar aangepaste modules zijn geïnstalleerd, moet hun broncode up-to-date zijn met de doelversie van Odoo voordat de upgrade kan worden uitgevoerd. Bekijk de Upgrade a customized database pagina voor meer informatie.
Notitie
Om veiligheidsredenen kan alleen de persoon die het upgradeverzoek heeft ingediend deze downloaden.
Om opslagredenen wordt de kopie van de database zonder bestandsopslag naar de upgradeserver verzonden. Daarom bevat de bijgewerkte database niet de productiebestandsopslag.
Voordat de geüpgradede database wordt hersteld, moet de bestandsopslag ervan worden samengevoegd met de productiebestandsopslag om tests te kunnen uitvoeren onder dezelfde omstandigheden als in de nieuwe versie.
De geüpgradede database bevat:
Een
dump.sql
-bestand met de bijgewerkte databaseEen map ‘filestore’ die bestanden bevat die zijn geëxtraheerd uit records in de database in bijlagen (als die er zijn) en nieuwe standaard Odoo-bestanden van de beoogde Odoo-versie (bijvoorbeeld nieuwe afbeeldingen, pictogrammen, logo’s van de betalingsprovider, enz.). Dit is de map die moet worden samengevoegd met de productiebestandsopslag om de volledige bijgewerkte bestandsopslag te krijgen.
Notitie
Als je een upgrade meerdere keren wilt testen, kunt je meerdere testdatabases aanvragen.
Notitie
Wanneer een upgradeverzoek is voltooid, wordt er een upgraderapport bijgevoegd bij de succesvolle upgrade-e-mail, en dit wordt beschikbaar in de Discuss-app voor gebruikers die deel uitmaken van de groep “Beheer / Instellingen”. Dit rapport biedt belangrijke informatie over de wijzigingen die door de nieuwe versie zijn geïntroduceerd.
Het testen van de nieuwe versie van de database¶
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.
Notitie
Testdatabases worden geneutraliseerd en sommige functies zijn uitgeschakeld om te voorkomen dat ze invloed hebben op de productiedatabase:
Geplande acties zijn jeitgeschakeld.
Uitgaande mailservers worden uitgeschakeld door de bestaande te archiveren en een nepserver toe te voegen.
Betaalaanbieders en bezorgdiensten worden gereset naar de testomgeving.
Banksynchronisatie is uitgeschakeld. Als je de synchronisatie wilt testen, neemt je contact op met jouw banksynchronisatieprovider om sandboxgegevens te verkrijgen.
Het wordt sterk aanbevolen om zoveel mogelijk van jouw bedrijfsstromen te testen om er zeker van te zijn dat ze correct werken en om meer vertrouwd te raken met de nieuwe versie.
Basistestchecklist
Zijn er weergaven die zijn gedeactiveerd in jouw testdatabase, maar actief in jouw productiedatabase?
Worden jouw gebruikelijke weergaven nog steeds correct weergegeven?
Worden jouw rapporten (factuur, verkooporder, etc.) correct gegenereerd?
Werken jouw websitepagina’s correct?
Kunt je records aanmaken en wijzigen? (verkooporders, facturen, aankopen, gebruikers, contacten, bedrijven, etc.)
Zijn er problemen met jouw e-mailsjablonen?
Zijn er problemen met opgeslagen vertalingen?
Zijn jouw zoekfilters nog aanwezig?
Kunt je jouw gegevens exporteren?
Een willekeurig product in jouw productcatalogus controleren en de test- en productiegegevens ervan vergelijken om te verifiëren dat alles hetzelfde is (productcategorie, verkoopprijs, kostprijs, leverancier, accounts, routes, enz.).
Dit product kopen (Aankoop-app).
Bevestiging van de ontvangst van dit product (Inventaris-app).
Controleren of de route om dit product te ontvangen hetzelfde is in jouw productiedatabase (Inventaris-app).
Dit product (Sales-app) verkopen aan een willekeurige klant.
Open jouw klantendatabase (app Contacten), selecteer een klant (of bedrijf) en controleer de gegevens ervan.
Dit product verzenden (Inventaris-app).
Controleren of de route om dit product te verzenden dezelfde is als in jouw productiedatabase (Inventaris-app).
Valideren van een klantfactuur (Factuur- of Boekhoudapp).
Crediteren van de factuur (uitreiken van een creditnota) en controleren of deze zich gedraagt zoals in jouw productiedatabase.
De resultaten van jouw rapporten controleren (Boekhoudapp).
Willekeurig jouw belastingen, valuta, bankrekeningen en boekjaar controleren (Accounting-app).
Een online bestelling plaatsen (website-apps) vanaf de productselectie in jouw winkel tot aan het afrekenproces en controleren of alles zich gedraagt zoals in jouw productiedatabase.
Deze lijst is niet uitputtend. Breid het voorbeeld uit naar jouw andere apps op basis van jouw gebruik van 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.
Tijdens het testen kunt je aanzienlijke verschillen tegenkomen met standaardweergaven, functies, velden en modellen. Deze wijzigingen kunnen niet van geval tot geval worden teruggedraaid. Als een wijziging die door een nieuwe versie wordt geïntroduceerd echter een aanpassing verbreekt, is het de verantwoordelijkheid van de beheerder van jouw aangepaste module om deze compatibel te maken met de nieuwe versie van Odoo.
Tip
Vergeet niet te testen:
Integraties met externe software (EDI, API’s, etc.)
Workflows tussen verschillende apps (online verkopen met eCommerce, een lead omzetten tot een verkooporder, levering van producten, etc.)
Gegevensexport
Geautomatiseerde acties
Serveracties in het actiemenu in formulierweergaven, maar ook door meerdere records in lijstweergaven te selecteren
Het jepgraden van de productiedatabase¶
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.
Jouw productiedatabase zal tijdens de upgrade niet beschikbaar zijn. Daarom raden wij aan de upgrade te plannen op een moment waarop het gebruik van de database minimaal is.
Omdat de standaard upgradescripts en jouw database voortdurend evolueren, wordt het ook aanbevolen om regelmatig een nieuwe geüpgradede testdatabase aan te vragen om er zeker van te zijn dat het upgradeproces nog steeds succesvol is, vooral als het lang duurt om te voltooien. Het wordt ook aanbevolen om het upgradeproces de dag vóór het upgraden van de productiedatabase volledig te oefenen.
Belangrijk
In productie gaan zonder eerst testen kan leiden tot:
Gebruikers kunnen zich niet aanpassen aan de veranderingen en nieuwe functies
Bedrijfsonderbrekingen (bijvoorbeeld niet langer de mogelijkheid hebben om een actie te valideren)
Slechte klantervaring (bijvoorbeeld een e-commerce website die niet correct werkt)
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.
Waarschuwing
Zodra de upgrade is aangevraagd, zal de database niet beschikbaar zijn totdat de upgrade is voltooid. Zodra het proces is voltooid, is het onmogelijk om terug te keren naar de vorige versie.
The process is similar to obtaining an upgraded test database on the Production branch.
Het proces wordt getriggerd zodra er een nieuwe commit wordt gedaan op de branch. Hierdoor kan het upgradeproces worden gesynchroniseerd met de implementatie van de geüpgradede broncode van de aangepaste modules. Als er geen aangepaste modules zijn, wordt het upgradeproces onmiddellijk geactiveerd.
Belangrijk
De database is gedurende het hele proces niet beschikbaar. Als er iets misgaat, draait het platform de upgrade automatisch terug, net als bij een reguliere update. Bij succes wordt er vóór de upgrade een back-up van de database gemaakt.
De update van jouw aangepaste modules moet succesvol zijn om het volledige upgradeproces te voltooien. Zorg ervoor dat de status van jouw staging-upgrade successful is voordat je deze in productie probeert. Meer informatie over het upgraden van jouw aangepaste modules kunt je vinden op Upgrade a customized database.
Het commando om een database naar productie te upgraden is vergelijkbaar met dat van het upgraden van een testdatabase, met uitzondering van het argument ‘test’, dat vervangen moet worden door ‘productie’:
$ 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.
Belangrijk
Bij het aanvragen van een geüpgradede database voor productiedoeleinden wordt de kopie ingediend zonder filestore. Daarom moet de bijgewerkte databasebestandsopslag worden samengevoegd met de productiebestandsopslag voordat de nieuwe versie wordt geïmplementeerd.
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)¶
Met Odoo Enterprise is het upgraden van een database naar de meest recente versie van Odoo gratis, inclusief alle ondersteuning die nodig is om potentiële discrepanties in de geüpgradede database te corrigeren.
Informatie over de upgradeservices die zijn inbegrepen in de Enterprise-licentie is beschikbaar in de :ref:`Odoo Enterprise Subscription Agreement<upgrade> `. In dit gedeelte wordt echter duidelijk gemaakt welke upgradeservices je kunt verwachten.
Upgradeservices die onder de SLA vallen¶
Databases die worden gehost op Odoo’s cloudplatforms (Odoo Online en Odoo.sh) of zelf gehost (On-Premise) kunnen te allen tijde profiteren van upgradediensten voor:
de jepgrade van alle standaardapplicaties;
de upgrade van alle aanpassingen gemaakt met de Studio-app, zolang Studio nog geïnstalleerd is en het betreffende abonnement nog actief is; En
de upgrade van alle ontwikkelingen en aanpassingen die vallen onder een abonnement voor onderhoud van aanpassingen.
Upgradediensten beperken zich tot de technische conversie en aanpassing van een database (standaardmodules en gegevens) om deze compatibel te maken met de versie waarop de upgrade betrekking heeft.
Upgradeservices die niet onder de SLA vallen¶
De volgende jepgradegerelateerde services zijn niet inbegrepen:
het opschonen van reeds bestaande gegevens en configuraties tijdens het upgraden;
the upgrade of additional modules not covered by a maintenance contract that are created in-house or by third parties, including Odoo partners; and
training over het gebruik van de functies en workflows van de geüpgradede versie.
Zie ook
Ondersteunde Odoo-versies