Upgraden¶
Een upgrade houdt in dat een database van een oudere versie naar een nieuwere ondersteunde versie wordt verplaatst (bv. van Odoo 16.0 naar Odoo 18.0). Regelmatige upgrades zijn cruciaal omdat elke versie nieuwe functies, bugfixes en beveiligingspatches biedt. Het gebruik van een ondersteunde versie wordt sterk aanbevolen. Elke hoofdversie wordt drie jaar ondersteund.
Afhankelijk van het hostingtype en de gebruikte Odoo-versie kan een database-upgrade verplicht zijn.
Als een database op een hoofdversie staat (bv. 16.0, 17.0, 18.0), is elke twee jaar een upgrade verplicht.
Als een database op een nevenversie staat (bv. 17.1, 17.2, 17.4), is een upgrade verplicht enkele weken nadat de volgende versie is uitgebracht. Nevenversies worden meestal elke twee maanden uitgebracht.
Na de eerste drie jaar ondersteuning heb je nog twee jaar om de upgrade te voltooien. Je ontvangt een melding wanneer een upgrade vereist is.
Je kunt voor onbepaalde tijd op dezelfde versie blijven, ook al wordt dit niet aanbevolen. Houd er rekening mee dat hoe kleiner het versieverschil, hoe gemakkelijker de upgrade zou moeten zijn.
Je ontvangt enkele weken voor een verplichte upgrade automatisch wordt uitgevoerd een melding in je database. Je hebt de controle over het proces zolang de deadline niet is bereikt.
Concreet voert Odoo’s Upgrade Team een stille testupgrade uit van elke database die moet worden geüpgraded. Als de test slaagt en minder dan 20 minuten duurt, kun je de upgrade direct vanuit de database activeren. Als de test mislukt, kun je een upgrade testen via de databasebeheerder.
Wanneer je wordt uitgenodigd om te upgraden, wordt sterk aanbevolen om eerst een geüpgradede testdatabase aan te vragen en tijd te besteden aan het testen ervan.
Een automatische upgrade naar de volgende versie wordt geactiveerd als er vóór de opgegeven vervaldatum geen actie wordt ondernomen.
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
Als je database aangepaste modules bevat, kan deze pas worden geüpgraded wanneer er een versie van je aangepaste modules beschikbaar is voor de doelversie van Odoo. Voor klanten die hun eigen aangepaste modules onderhouden, raden we aan het proces te parallelliseren door een geüpgradede database aan te vragen en tegelijkertijd de broncode van je aangepaste modules te upgraden.
Upgraden in een notendop¶
Vraag een geüpgradede testdatabase aan (zie een geüpgradede testdatabase verkrijgen).
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).
Test de geüpgradede database grondig (zie de nieuwe versie van de database testen).
Meld eventuele problemen die tijdens het testen zijn opgetreden aan Odoo door naar de Ondersteuningspagina te gaan en “Een probleem met betrekking tot mijn toekomstige upgrade (ik test een upgrade)” te selecteren.
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.
Vraag de upgrade aan voor de productiedatabase, waardoor deze niet beschikbaar is voor de tijd die nodig is om het proces te voltooien (zie productiedatabase upgraden).
Meld eventuele problemen die tijdens de upgrade zijn opgetreden bij Odoo door naar de supportpagina te gaan en “Een probleem met betrekking tot mijn upgrade (productie)” te selecteren.
Het verkrijgen van een geüpgradede testdatabase¶
De upgradepagina is het hoofdplatform voor het aanvragen van een geüpgradede database. Afhankelijk van het hostingtype kun je echter upgraden vanaf de opdrachtregel (on-premise), de Odoo Online databasebeheerder of je 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.
Een Odoo Online database upgraden:
Open de database manager.
Selecteer de database en klik op Manage.
Klik op Upgrade in het gedeelte Database.
In de popup:
Selecteer de versie van Odoo waarnaar je wilt upgraden, meestal de nieuwste versie.
Voer het Email to notify in, dat een link naar de geüpgrade database ontvangt.
Selecteer het Purpose van de upgrade, dat automatisch is ingesteld op Test voor je eerste upgrade verzoek.
Klik op Upgrade.
In de database manager wordt de Connect knop vervangen door een niet-klikbare Upgrading… knop tot voltooiing. Zodra het proces succesvol is, wordt er een e-mail met een link naar de geüpgrade testdatabase gestuurd naar het opgegeven adres. De testdatabase is ook toegankelijk vanuit de database manager door te klikken op de (caret down) knop vóór de databasenaam om de testdatabase weer te geven, en vervolgens te klikken op Connect.
Odoo.sh is geïntegreerd met het upgradeplatform om het upgradeproces te vereenvoudigen.
De nieuwste dagelijkse automatische back-up van de productiedatabase wordt vervolgens naar het upgradeplatform verzonden.
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
Deze opdracht stelt enkele eisen aan de omgeving waarin deze wordt uitgevoerd:
Enkele externe opdrachten die door het besturingssysteem moeten worden geleverd, normaal gesproken aanwezig in elke Linux-distributie (inclusief WSL). Er wordt een fout weergegeven als een of meer hiervan ontbreken.
De systeemgebruiker die de opdracht uitvoert, moet geconfigureerd zijn met toegang tot de database. Raadpleeg de PostgreSQL-documentatie van de clientomgeving of het clientwachtwoordbestand voor deze vereiste.
Het script moet een of meer servers van het upgradeplatform kunnen bereiken, zowel op TCP-poort 443 als op een willekeurige TCP-poort in het bereik tussen 32768 en 60999. Dit kan in strijd zijn met je restrictieve firewall en kan een uitzondering vereisen die aan de firewallconfiguratie wordt toegevoegd.
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
Een geüpgradede testdatabase kan ook worden aangevraagd via de upgradepagina.
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¶
Het is essentieel om de geüpgradede testdatabase te testen om ervoor te zorgen dat je niet vastloopt in je dagelijkse activiteiten door een wijziging in weergaven, gedrag of een foutmelding zodra de upgrade live gaat.
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.
Als je een probleem tegenkomt tijdens het testen van je geüpgradede testdatabase, kun je de hulp van Odoo inroepen door naar de supportpagina te gaan en “Een probleem met betrekking tot mijn toekomstige upgrade (ik test een upgrade)” te selecteren. In elk geval is het essentieel om elk probleem dat tijdens het testen wordt aangetroffen te melden, zodat dit kan worden opgelost voordat je productiedatabase wordt geüpgraded.
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 upgraden van de productiedatabase¶
Zodra de tests zijn voltooid en je ervan overtuigd bent dat de geüpgradede database zonder problemen als je hoofddatabase kan worden gebruikt, is het tijd om de livegang te plannen.
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)
Het proces van het upgraden van een productiedatabase is vergelijkbaar met het upgraden van een testdatabase, maar met een paar uitzonderingen.
Het proces is vergelijkbaar met een geüpgradede testdatabase verkrijgen, behalve de doeloptie, die moet worden ingesteld op Productie in plaats van 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.
Het proces is vergelijkbaar met een geüpgradede testdatabase verkrijgen op de Productie-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>
Een geüpgradede productiedatabase kan ook worden aangevraagd via de upgradepagina.
Zodra de database is geüpload, zal elke wijziging aan je productiedatabase niet aanwezig zijn in je geüpgradede database. Daarom raden we aan deze niet te gebruiken tijdens het upgradeproces.
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 geval van een probleem met je productiedatabase kun je de hulp van Odoo inroepen door naar de supportpagina te gaan en “Een probleem met betrekking tot mijn upgrade (productie)” te selecteren.
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;
de upgrade van extra modules die niet onder een onderhoudscontract vallen die intern of door derden zijn gemaakt, inclusief Odoo-partners; en
training over het gebruik van de functies en workflows van de geüpgradede versie.