Bugfix updates¶
Introductie¶
Om te kunnen profiteren van de nieuwste verbeteringen, beveiligingsoplossingen, bugcorrecties en prestatieverbeteringen, moet je mogelijk jouw Odoo-installatie van tijd tot tijd updaten.
Deze handleiding is alleen van toepassing als je Odoo op je eigen hostinginfrastructuur gebruikt. Als je een van de Odoo Cloud-oplossingen gebruikt, worden updates automatisch voor je uitgevoerd.
De terminologie rond software-updates is vaak verwarrend, dus hier zijn enkele definities:
- Updaten (een Odoo-installatie)
Verwijst naar het proces voor het verkrijgen van de laatste herziening van de broncode voor jouw huidige Odoo-editie. Bijvoorbeeld het updaten van jouw Odoo Enterprise 13.0 naar de laatste revisie. Dit veroorzaakt niet direct enige wijziging in de inhoud van jouw Odoo-database en kan ongedaan worden gemaakt door de vorige revisie van de broncode opnieuw te installeren.
- Upgraden (een Odoo-database)
Verwijst naar een complexe gegevensverwerking waarbij de structuur en inhoud van jouw database permanent wordt gewijzigd om deze compatibel te maken met een nieuwe release van Odoo. Deze operatie is onomkeerbaar en wordt doorgaans uitgevoerd via Odoo’s database-upgradeservice, wanneer je besluit over te schakelen naar een nieuwere versie van Odoo. Historisch gezien werd dit proces ook wel een ‘migratie’ genoemd, omdat het gaat om het verplaatsen van gegevens binnen de database, ook al kan de database na de upgrade op dezelfde fysieke locatie terechtkomen.
Deze pagina beschrijft de typische stappen die nodig zijn om een Odoo-installatie te bijwerken naar de nieuwste versie. Als je meer informatie wilt over het upgraden van een database, ga dan naar de Odoo Upgrade-pagina.
In een notendop¶
Het updaten van Odoo wordt bereikt door simpelweg de nieuwste versie van jouw Odoo Editie opnieuw te installeren bovenop jouw huidige installatie. Hierdoor blijven jouw gegevens behouden zonder enige wijziging, zolang je PostgreSQL (de database-engine die bij Odoo wordt geleverd) niet verwijdert.
De belangrijkste referentie voor updates is logischerwijs onze installatiegids, waarin de gebruikelijke installatiemethoden worden uitgelegd.
Het updaten kan ook het meest geschikt worden uitgevoerd door de persoon die Odoo in eerste instantie heeft geïmplementeerd, omdat de procedure zeer vergelijkbaar is.
Notitie
We raden altijd aan om een compleet nieuwe, up-to-date versie van Odoo te downloaden, in plaats van handmatig patches toe te passen, zoals de beveiligingspatches die bij Beveiligingsadviezen worden geleverd. De patches zijn vooral bedoeld voor installaties die sterk op maat zijn gemaakt, of voor technisch personeel dat er de voorkeur aan geeft tijdelijk minimale wijzigingen aan te brengen tijdens het testen van een volledige update.
Stap 1: Download een bijgewerkte Odoo-versie¶
De centrale downloadpagina is https://www.odoo.com/page/download. Als je een link “Kopen” ziet voor de Odoo Enterprise-download, zorg er dan voor dat ujeingelogd bent op Odoo.com met dezelfde login als die gekoppeld is aan je Odoo Enterprise-abonnement.
Als alternatief kun je de unieke downloadlink gebruiken die is meegeleverd met jouw Odoo Enterprise-aankoopbevestigingsmail.
Notitie
Het downloaden van een bijgewerkte versie is niet nodig als je via Github hebt geïnstalleerd (zie hieronder)
Stap 2: Maak een back-up van jouw database¶
De updateprocedure is redelijk veilig en zou je gegevens niet moeten wijzigen. Het is echter altijd het beste om een volledige databaseback-up te maken voordat je wijzigingen aan jouw installatie doorvoert, en deze op een veilige plek op een andere computer op te slaan.
Als je het databasemanagerscherm niet hebt uitgeschakeld (zie :ref:`hier<security> ` waarom zou je dat doen), kunt je deze gebruiken (link onderaan jouw databaseselectiescherm) om een back-up van jouw database(s) te downloaden. Als je dit hebt uitgeschakeld, gebruikt je dezelfde procedure als voor jouw gebruikelijke back-ups.
Stap 3: Installeer de bijgewerkte versie¶
Kies de methode die past bij jouw huidige installatie:
Verpakte installatieprogramma’s¶
Als je Odoo hebt geïnstalleerd met een installatiepakket dat je op onze website hebt gedownload (de aanbevolen methode), is het updaten heel eenvoudig. Het enige wat je hoeft te doen is het installatiepakket dat overeenkomt met jouw systeem te downloaden (zie stap #1) en het op je server te installeren. Ze worden dagelijks bijgewerkt en bevatten de nieuwste beveiligingsoplossingen. Meestal kunt je eenvoudigweg dubbelklikken op het pakket om het bovenop de huidige installatie te installeren. Zorg ervoor dat je na het installeren van het pakket de Odoo-service opnieuw opstart of je server opnieuw opstart, en je bent helemaal klaar.
Broninstallatie (Tarball)¶
Als je Odoo oorspronkelijk hebt geïnstalleerd met de “tarball”-versie (broncode-archief), moet je de installatiemap vervangen door een nieuwere versie. Download eerst de nieuwste tarball van Odoo.com. Ze worden dagelijks bijgewerkt en bevatten de nieuwste beveiligingsoplossingen (zie stap #1). Na het downloaden van het pakket pak je het uit naar een tijdelijke locatie op je server.
Je krijgt een map met de versie van de broncode, bijvoorbeeld “odoo-13.0+e.20190719”, die een map “odoo.egg-info” bevat en de daadwerkelijke broncodemap met de naam “odoo” (voor Odoo 10 en hoger) of “openerp” voor oudere versies. Je kunt de map odoo.egg-info negeren. Zoek de map waarin jouw huidige installatie is geïmplementeerd en vervang deze door de nieuwere map ‘odoo’ of ‘openerp’ die zich in het archief bevond dat je zojuist hebt uitgepakt.
Zorg ervoor dat de mapindeling overeenkomt. De nieuwe map “addons” die in de broncode is opgenomen, moet bijvoorbeeld precies op hetzelfde pad terechtkomen als voorheen. Let vervolgens op eventuele specifieke configuratiebestanden die je mogelijk handmatig in de oude map hebt gekopieerd of gewijzigd, en kopieer ze naar de nieuwe map. Start ten slotte de Odoo-service opnieuw op of start de machine opnieuw op, en je bent helemaal klaar.
Broninstallatie (Github)¶
Als je Odoo oorspronkelijk hebt geïnstalleerd met een volledige Github-kloon van de officiële repositories, vereist de updateprocedure dat je de nieuwste broncode via git ophaalt. Ga naar de map voor elke repository (de belangrijkste Odoo-repository en de Enterprise-repository) en voer de volgende opdrachten uit:
git fetch
git rebase --autostash
De laatste opdracht kan broncodeconflicten tegenkomen als je de Odoo-broncode lokaal had bewerkt. Het foutbericht geeft je een lijst met bestanden met conflicten, en je moet de conflicten handmatig oplossen door ze te bewerken en te beslissen welk deel van de code je wilt behouden.
Als alternatief kunt je de volgende opdracht gebruiken als je de conflicterende wijzigingen eenvoudigweg wilt negeren en de officiële versie wilt herstellen:
git reset --hard
Start ten slotte de Odoo-service opnieuw op of start de machine opnieuw op, en je zou klaar moeten zijn.
Dokwerker¶
Raadpleeg onze Docker image-documentatie voor specifieke update-instructies.