Uppgradering¶
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.
En uppgradering täcker inte:
Nedgradering till en tidigare version av Odoo
Ändring av utgåvor (t.ex. från Community till Enterprise)
Ändring av hostingtyp (t.ex. från on-premise till Odoo Online)
Migrering från ett annat ERP-system till Odoo
Varning
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.
Uppgradering i ett nötskal¶
Request an upgraded test database (see obtaining an upgraded test database).
Om tillämpligt, uppgradera källkoden för din anpassade modul för att vara kompatibel med den nya versionen av Odoo (se 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)”.
När alla problem är lösta och du är säker på att den uppgraderade databasen kan användas som din huvuddatabas utan problem kan du planera uppgraderingen av din produktionsdatabas.
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)”.
Hämta en uppgraderad testdatabas¶
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.
Observera
Uppgraderingsplattformen följer samma Privacy Policy som de andra Odoo.com-tjänsterna. Besök sidan General Data Protection Regulation för att lära dig mer om hur Odoo hanterar dina uppgifter och din integritet.
Odoo Online databases can be manually upgraded via the database manager.
Databashanteraren visar alla databaser som är kopplade till användarens konto. Databaser som inte har den senaste versionen av Odoo visar en pil i en cirkel bredvid sitt namn, vilket indikerar att de kan uppgraderas.
Klicka på pilen i en cirkel för att starta uppgraderingsprocessen. Fyll i följande i popup-fönstret:
Den version av Odoo som du vill uppgradera till, vanligtvis den senaste versionen
Den email-adress som ska få länken till den uppgraderade databasen
Uppgraderingens Purpose, som automatiskt sätts till Test för din första uppgraderingsbegäran
Taggen Upgrade in progress visas bredvid databasens namn tills den är klar. När processen har slutförts skickas ett e-postmeddelande med en länk till den uppgraderade testdatabasen till den angivna adressen. Databasen kan också nås från databashanteraren genom att klicka på nedrullningspilen före databasnamnet.
Odoo.sh är integrerad med uppgraderingsplattformen för att förenkla uppgraderingsprocessen.
The latest production daily automatic backup is then sent to the Upgrade platform.
När uppgraderingsplattformen har uppgraderat säkerhetskopian och laddat upp den på filialen försätts den i ett specialäge: varje gång en commit pushas på filialen görs en restore operation av den uppgraderade säkerhetskopian och en uppdatering av alla anpassade moduler. Detta gör att du kan testa dina egna moduler på en orörd kopia av den uppgraderade databasen. Loggfilen för uppgraderingsprocessen kan hittas i din nyligen uppgraderade staging-build genom att gå till ~/logs/upgrade.log
.
Viktigt
I databaser där anpassade moduler är installerade måste deras källkod vara uppdaterad med målversionen av Odoo innan uppgraderingen kan utföras. Om det inte finns några sådana hoppar man över ”update on commit”-läget, bygger den uppgraderade databasen så snart den har överförts från uppgraderingsplattformen och avslutar uppgraderingsläget.
Mer information finns på sidan Upgrade a customized database.
Standarduppgraderingsprocessen kan inledas genom att ange följande kommandorad på den maskin där databasen finns:
$ python <(curl -s https://upgrade.odoo.com/upgrade) test -d <your db name> -t <target version>
Observera
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.
Följande kommando kan användas för att visa den allmänna hjälpen och huvudkommandona:
$ python <(curl -s https://upgrade.odoo.com/upgrade) --help
An upgraded test database can also be requested via the Upgrade page.
Viktigt
I databaser där anpassade moduler är installerade måste deras källkod vara uppdaterad med målversionen av Odoo innan uppgraderingen kan utföras. Mer information finns på sidan Upgrade a customized database.
Observera
Av säkerhetsskäl är det bara den person som skickade in begäran om uppgradering som kan ladda ner den.
Av lagringsskäl skickas databasens kopia utan filarkiv till uppgraderingsservern. Därför innehåller den uppgraderade databasen inte produktionsfillagret.
Innan den uppgraderade databasen återställs måste dess filarkiv slås samman med produktionsfilarkivet för att kunna utföra tester under samma förhållanden som i den nya versionen.
Den uppgraderade databasen innehåller:
En
dump.sql
-fil som innehåller den uppgraderade databasenEn
filestore
-mapp som innehåller filer som extraherats från poster i databasen till bilagor (om det finns några) och nya standard Odoo-filer från den riktade Odoo-versionen (t.ex. nya bilder, ikoner, betalningsleverantörens logotyper etc.). Det är den här mappen som ska slås samman med produktionsfillagret för att få det fullständigt uppgraderade fillagret.
Observera
Du kan begära flera testdatabaser om du vill testa en uppgradering mer än en gång.
Observera
När en uppgraderingsbegäran har slutförts bifogas en uppgraderingsrapport till e-postmeddelandet om lyckad uppgradering, och den blir tillgänglig i Discuss-appen för användare som ingår i gruppen ”Administration/Inställningar”. Rapporten innehåller viktig information om de ändringar som den nya versionen medför.
Test av den nya versionen av databasen¶
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.
Observera
Testdatabaserna neutraliseras och vissa funktioner inaktiveras för att förhindra att de påverkar produktionsdatabasen:
Schemalagda åtgärder är inaktiverade.
Utgående e-postservrar inaktiveras genom att de befintliga servrarna arkiveras och en falsk server läggs till.
Betalningsleverantörer och leveransföretag återställs till testmiljön.
Banksynkronisering är inaktiverad. Om du vill testa synkroniseringen kontaktar du din leverantör av banksynkronisering för att få inloggningsuppgifter till sandlådan.
Vi rekommenderar starkt att ni testar så många av era affärsflöden som möjligt för att säkerställa att de fungerar korrekt och för att bli mer bekanta med den nya versionen.
Checklista för grundläggande test
Finns det vyer som är avaktiverade i din testdatabas men aktiva i din produktionsdatabas?
Visas dina vanliga visningar fortfarande korrekt?
Är dina rapporter (faktura, försäljningsorder etc.) korrekt genererade?
Fungerar sidorna på din webbplats korrekt?
Kan du skapa och ändra poster? (försäljningsorder, fakturor, inköp, användare, kontakter, företag, etc.)
Finns det några problem med dina e-postmallar?
Finns det några problem med sparade översättningar?
Finns dina sökfilter fortfarande kvar?
Kan du exportera dina data?
Kontrollera en slumpmässig produkt i din produktkatalog och jämför dess test- och produktionsdata för att verifiera att allt är detsamma (produktkategori, försäljningspris, kostnadspris, leverantör, konton, rutter etc.).
Köpa denna produkt (Köp app).
Bekräftar mottagandet av denna produkt (Inventory app).
Kontrollera om rutten för att ta emot denna produkt är densamma i din produktionsdatabas (Inventory app).
Sälja denna produkt (försäljningsapp) till en slumpmässig kund.
Öppna din kunddatabas (appen Kontakter), välj en kund (eller ett företag) och kontrollera dess data.
Skicka denna produkt (Lager-app).
Kontrollera om rutten för att skicka denna produkt är densamma som i din produktionsdatabas (Inventory app).
Validera en kundfaktura (appen Fakturering eller Bokföring).
Kreditera fakturan (utfärda en kreditnota) och kontrollera om den beter sig som i din produktionsdatabas.
Kontrollera resultatet av dina rapporter (appen Redovisning).
Slumpmässig kontroll av dina skatter, valutor, bankkonton och räkenskapsår (appen Bokföring).
Göra en onlinebeställning (Website apps) från produktvalet i din butik till kassan och kontrollera att allt fungerar som det ska i din produktionsdatabas.
Denna lista är inte uttömmande. Utöka exemplet till dina andra appar baserat på din användning av 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.
Du kan stöta på betydande skillnader med standardvyer, funktioner, fält och modeller under testning. Dessa ändringar kan inte återställas från fall till fall. Men om en ändring som införs av en ny version bryter en anpassning, är det underhållaren av din anpassade modul som ansvarar för att göra den kompatibel med den nya versionen av Odoo.
Tips
Glöm inte att testa:
Integrationer med extern programvara (EDI, API:er etc.)
Arbetsflöden mellan olika appar (onlineförsäljning med eCommerce, konvertera ett lead hela vägen till en försäljningsorder, leverans av produkter etc.)
Export av data
Automatiserade åtgärder
Serveråtgärder i åtgärdsmenyn i formulärvyer, samt genom att välja flera poster i listvyer
Uppgradering av produktionsdatabasen¶
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.
Din produktionsdatabas kommer inte att vara tillgänglig under uppgraderingen. Därför rekommenderar vi att du planerar uppgraderingen vid en tidpunkt då databasen används minimalt.
Eftersom standarduppgraderingsskript och databas ständigt utvecklas, rekommenderas det också att ofta begära en annan uppgraderad testdatabas för att säkerställa att uppgraderingsprocessen fortfarande är framgångsrik, särskilt om det tar lång tid att slutföra. Det rekommenderas också att du repeterar uppgraderingsprocessen dagen innan du uppgraderar produktionsdatabasen.
Viktigt
Att gå in i produktion utan att först testa kan leda till:
Användare som inte anpassar sig till förändringarna och de nya funktionerna
Avbrott i verksamheten (t.ex. att inte längre ha möjlighet att validera en åtgärd)
Dålig kundupplevelse (t.ex. en e-handelswebbplats som inte fungerar korrekt)
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.
Varning
När uppgraderingen har begärts kommer databasen att vara otillgänglig tills uppgraderingen har slutförts. När processen är klar är det omöjligt att återgå till den tidigare versionen.
The process is similar to obtaining an upgraded test database on the Production branch.
Processen utlöses så snart en ny commit görs på filialen. Detta gör att uppgraderingsprocessen kan synkroniseras med distributionen av de anpassade modulernas uppgraderade källkod. Om det inte finns några anpassade moduler utlöses uppgraderingsprocessen omedelbart.
Viktigt
Databasen är inte tillgänglig under hela processen. Om något går fel återställer plattformen automatiskt uppgraderingen, precis som vid en vanlig uppdatering. Om uppgraderingen lyckas skapas en säkerhetskopia av databasen före uppgraderingen.
Uppdateringen av dina anpassade moduler måste lyckas för att hela uppgraderingsprocessen ska kunna slutföras. Se till att statusen för din staging-uppgradering är successful innan du testar den i produktion. Mer information om hur du uppgraderar dina anpassade moduler finns i Upgrade a customized database.
Kommandot för att uppgradera en databas till produktion liknar det för att uppgradera en testdatabas med undantag för argumentet test
, som måste ersättas med production
:
$ 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.
Viktigt
När du begär en uppgraderad databas för produktionsändamål skickas kopian utan filarkiv. Därför måste fillagret för den uppgraderade databasen slås samman med produktionsfillagret innan den nya versionen distribueras.
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)”.
Avtal om servicenivå (SLA)¶
Med Odoo Enterprise är det gratis att uppgradera en databas till den senaste versionen av Odoo, inklusive all support som krävs för att åtgärda eventuella avvikelser i den uppgraderade databasen.
Information om de uppgraderingstjänster som ingår i Enterprise-licensen finns i Odoo Enterprise Subscription Agreement. I detta avsnitt klargörs dock vilka uppgraderingstjänster du kan förvänta dig.
Uppgraderingstjänster som omfattas av SLA¶
Databaser som hostas på Odoos molnplattformar (Odoo Online och Odoo.sh) eller självhostas (On-Premise) kan dra nytta av uppgraderingstjänster när som helst för:
uppgradering av alla standardapplikationer;
uppgradering av alla anpassningar som skapats med Studio-appen, så länge som Studio fortfarande är installerat och respektive abonnemang fortfarande är aktivt; och
uppgradering av alla utvecklingar och anpassningar som omfattas av ett abonnemang för underhåll av anpassningar.
Uppgraderingstjänster är begränsade till teknisk konvertering och anpassning av en databas (standardmoduler och data) för att göra den kompatibel med den version som är föremål för uppgraderingen.
Uppgraderingstjänster som inte täcks av SLA¶
Följande uppgraderingsrelaterade tjänster ingår inte:
rensning av befintliga data och konfigurationer vid uppgradering;
uppgradering av anpassade moduler som skapats internt eller av tredje part, inklusive Odoo-partner;
rader med kod som lagts till i standardmoduler, dvs. anpassningar som skapats utanför Studio-appen, kod som matats in manuellt och automatiserade åtgärder med Python-koden; och
utbildning i att använda den uppgraderade versionens funktioner och arbetsflöden.