Bron installatie¶
De bron-‘installatie’ gaat niet over het installeren van Odoo, maar over het rechtstreeks vanaf de bron uitvoeren.
Het gebruik van de Odoo-broncode kan handiger zijn voor moduleontwikkelaars, omdat deze gemakkelijker toegankelijk is dan het gebruik van verpakte installatieprogramma’s.
Het maakt het starten en stoppen van Odoo flexibeler en explicieter dan de diensten die zijn opgezet door de verpakte installatieprogramma’s. Het maakt het ook mogelijk instellingen te overschrijven met behulp van opdrachtregelparameters zonder dat een configuratiebestand hoeft te worden bewerkt.
Ten slotte biedt het meer controle over de systeeminstellingen en maakt het het gemakkelijker om meerdere versies van Odoo naast elkaar te houden (en uit te voeren).
Haal de bronnen op¶
Er zijn twee manieren om de broncode van Odoo te verkrijgen: als ZIP archief of via Git.
Archiveren¶
Community-editie:
Bedrijfseditie:
Git¶
Notitie
Het is vereist dat Git geïnstalleerd is, en het wordt aanbevolen om een basiskennis van Git-commando’s te hebben om verder te kunnen gaan.
To clone a Git repository, choose between cloning with HTTPS or SSH. In most cases, the best option is HTTPS. However, choose SSH to contribute to Odoo source code or when following the Getting Started developer tutorial.
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
C:\> git clone https://github.com/odoo/odoo.git
C:\> git clone https://github.com/odoo/enterprise.git
C:\> git clone git@github.com:odoo/odoo.git
C:\> git clone git@github.com:odoo/enterprise.git
$ git clone https://github.com/odoo/odoo.git
$ git clone https://github.com/odoo/enterprise.git
$ git clone git@github.com:odoo/odoo.git
$ git clone git@github.com:odoo/enterprise.git
Notitie
De Enterprise git-repository bevat niet de volledige Odoo-broncode. Het is slechts een verzameling extra add-ons. De hoofdservercode bevindt zich in de Community-editie. Het uitvoeren van de Enterprise-versie betekent dat de server wordt uitgevoerd vanaf de Community-versie met de optie addons-path
ingesteld op de map met de Enterprise-editie. Het is vereist om zowel de Community- als de Enterprise-repository te klonen om een werkende Odoo Enterprise-installatie te hebben.
Voorbereiden¶
Python¶
Odoo requires Python 3.7 or later to run.
Gebruik indien nodig een pakketbeheerder om Python 3 te downloaden en te installeren.
Download de nieuwste versie van Python 3 en installeer deze.
Vink tijdens de installatie Python 3 aan PATH toevoegen aan, klik vervolgens op Installatie aanpassen en zorg ervoor dat pip is aangevinkt.
Notitie
If Python 3 is already installed, make sure that the version is 3.7 or above, as previous versions are not compatible with Odoo.
$ python3 --version
C:\> python --version
$ python3 --version
Controleer of pip ook voor deze versie is geïnstalleerd.
$ pip3 --version
C:\> pip --version
$ pip3 --version
PostgreSQL¶
Odoo gebruikt PostgreSQL als databasebeheersysteem.
Gebruik een pakketbeheerder om PostgreSQL te downloaden en te installeren (ondersteunde versies: 12.0 of hoger). Dit kan worden bereikt door het volgende uit te voeren:
$ sudo apt install postgresql postgresql-client
Download PostgreSQL (ondersteunde versies: 12.0 of hoger) en installeer het.
Gebruik Postgres.app om PostgreSQL te downloaden en te installeren (ondersteunde versie: 12.0 of hoger).
Tip
Om de opdrachtregelhulpmiddelen die bij Postgres.app worden geleverd beschikbaar te maken, moet je ervoor zorgen dat je de variabele $PATH
instelt door de instructies voor `Postgres.app CLI-hulpmiddelen te volgen <https://postgresapp.com/documentation/cli-tools.html >`_.
Standaard is de enige gebruiker postgres
. Omdat Odoo het verbinden als postgres
verbiedt, moet je een nieuwe PostgreSQL-gebruiker maken.
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Notitie
Omdat de PostgreSQL-gebruiker dezelfde naam heeft als de Unix-login, is het mogelijk om zonder wachtwoord verbinding te maken met de database.
Voeg de map
bin
van PostgreSQL toe (standaard:C:\Program Files\PostgreSQL\<version> \bin
) naarPATH
.Maak een postgres-gebruiker met een wachtwoord met behulp van de pg admin gui:
Open pgAdmin.
Dubbelklik op de server om een verbinding tot stand te brengen.
Selecteer :menuselectie:`Object --> Maken --> Login/Groepsrol`.
Voer de gebruikersnaam in het veld Rolnaam in (bijvoorbeeld
odoo
).Open het tabblad Definitie, voer een wachtwoord in (bijvoorbeeld
odoo
) en klik op Opslaan.Open het tabblad Rechten en stel Kan inloggen? in op
Ja
en Database aanmaken? opJa
.
$ sudo -u postgres createuser -s $USER
$ createdb $USER
Notitie
Omdat de PostgreSQL-gebruiker dezelfde naam heeft als de Unix-login, is het mogelijk om zonder wachtwoord verbinding te maken met de database.
Afhankelijkheden¶
Het gebruik van distributiepakketten is de beste manier om afhankelijkheden te installeren. Je kunt ook de Python-afhankelijkheden installeren met pip.
Op Debian/Ubuntu zouden de volgende opdrachten de vereiste pakketten moeten installeren:
$ cd odoo #CommunityPath
$ sudo ./setup/debinstall.sh
The setup/debinstall.sh
script will parse the debian/control
<https://github.com/odoo/odoo/blob/15.0/debian/control>
file and install the found packages.
Waarschuwing
Using pip may lead to security issues and broken dependencies; only do this if you know what you are doing.
Omdat sommige Python-pakketten een compilatiestap nodig hebben, vereisen ze dat systeembibliotheken worden geïnstalleerd.
Op Debian/Ubuntu zou het volgende commando deze vereiste bibliotheken moeten installeren:
$ sudo apt install python3-pip libldap2-dev libpq-dev libsasl2-dev
Odoo-afhankelijkheden worden vermeld in het bestand:file:requirements.txt
dat zich in de hoofdmap van de Odoo Community-directory bevindt.
Notitie
De Python-pakketten in requirements.txt
zijn gebaseerd op hun stabiele/LTS Debian/Ubuntu-corresponderende versie op het moment van de Odoo-release. Voor Odoo 15.0 is de pakketversie python3-babel
bijvoorbeeld 2.8.0 in Debian Bullseye en 2.6.0 in Ubuntu Focal. De laagste versie wordt dan gekozen in de requirements.txt
.
Tip
Het kan de voorkeur verdienen om Python-modulepakketten niet te combineren tussen verschillende exemplaren van Odoo of met het systeem. Het is echter mogelijk om virtualenv te gebruiken om geïsoleerde Python-omgevingen te creëren.
Navigeer naar het pad van de Odoo Community-installatie (CommunityPath
) en voer pip uit op het vereistenbestand om de vereisten voor de huidige gebruiker te installeren.
$ cd /CommunityPath
$ pip install -r requirements.txt
Voordat je de afhankelijkheden installeert, downloadt en installeert je de Build Tools for Visual Studio. Selecteer C++ build tools op het tabblad Workloads en installeer ze wanneer daarom wordt gevraagd.
Odoo-afhankelijkheden worden vermeld in het requirements.txt
-bestand dat zich in de hoofdmap van de Odoo Community-directory bevindt.
Tip
Het kan de voorkeur verdienen om Python-modulepakketten niet te combineren tussen verschillende exemplaren van Odoo of met het systeem. Het is echter mogelijk om virtualenv te gebruiken om geïsoleerde Python-omgevingen te creëren.
Navigeer naar het pad van de Odoo Community-installatie (CommunityPath
) en voer pip uit op het vereistenbestand in een terminal met beheerdersrechten:
C:\> cd \CommunityPath
C:\> pip install setuptools wheel
C:\> pip install -r requirements.txt
Odoo-afhankelijkheden worden vermeld in het requirements.txt
-bestand dat zich in de hoofdmap van de Odoo Community-directory bevindt.
Tip
Het kan de voorkeur verdienen om Python-modulepakketten niet te combineren tussen verschillende exemplaren van Odoo of met het systeem. Het is echter mogelijk om virtualenv te gebruiken om geïsoleerde Python-omgevingen te creëren.
Navigeer naar het pad van de Odoo Community-installatie (CommunityPath
) en voer pip uit in het vereistenbestand:
$ cd /CommunityPath
$ pip3 install setuptools wheel
$ pip3 install -r requirements.txt
Notitie
Voor talen die een van rechts naar links-interface gebruiken (zoals Arabisch of Hebreeuws), is het pakket rtlcss
vereist.
Download en installeer nodejs en npm met een pakketbeheerder.
Installeer
rtlcss
:$ sudo npm install -g rtlcss
Download en installeer nodejs.
Installeer
rtlcss
:C:\> npm install -g rtlcss
Bewerk de variabele
PATH
van de systeemomgeving om de map toe te voegen waarrtlcss.cmd
zich bevindt (meestal:C:\Users\<user> \AppData\Roaming\npm\
).
Waarschuwing
wkhtmltopdf
is not installed through pip and must be installed manually in version 0.12.5 for it to support headers and
footers. Check out the wkhtmltopdf wiki for
more details on the various versions.
Odoo jeitvoeren¶
Zodra alle afhankelijkheden zijn ingesteld, kan Odoo worden gestart door odoo-bin
uit te voeren, de opdrachtregelinterface van de server. Het bevindt zich in de hoofdmap van de Odoo Community-map.
Om de server te configureren, specificeer je opdrachtregelargumenten of een configuratiebestand.
Tip
Voor de Enterprise-editie voeg je het pad naar de enterprise
-add-ons toe aan het addons-path
-argument. Merk op dat het vóór de andere paden in addons-path
moet komen om add-ons correct te laden.
Veel voorkomende noodzakelijke configuraties zijn:
PostgreSQL-gebruiker en wachtwoord.
Aangepaste add-onpaden die verder gaan dan de standaardwaarden om aangepaste modules te laden.
Een typische manier om de server te laten draaien is:
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Waar ‘CommunityPath’ het pad is van de Odoo Community-installatie, en ‘mydb’ de naam is van de PostgreSQL-database.
C:\> cd CommunityPath/
C:\> python odoo-bin -r dbuser -w dbpassword --addons-path=addons -d mydb
Waar CommunityPath
het pad is van de Odoo Community-installatie, dbuser
de PostgreSQL-login is, dbpassword
het PostgreSQL-wachtwoord is en mydb
de naam is van de PostgreSQL-database.
$ cd /CommunityPath
$ python3 odoo-bin --addons-path=addons -d mydb
Waar ‘CommunityPath’ het pad is van de Odoo Community-installatie, en ‘mydb’ de naam is van de PostgreSQL-database.
Nadat de server is gestart (het INFO-logboek odoo.modules.loading: Modules geladen.
wordt afgedrukt), open je http://localhost:8069 in een webbrowser en logt je in op de Odoo-database met het basisbeheerdersaccount: gebruik ` admin` als e-mailadres en nogmaals admin
als wachtwoord.
Tip