Odoo ist eine beliebte Open-Source-Suite von Geschäftsanwendungen. Es bietet eine Reihe von Anwendungen, darunter CRM, E-Commerce, Website-Builder, Rechnungsstellung, Buchhaltung, Fertigung, Lager, Projektmanagement, Inventar und vieles mehr, die alle nahtlos integriert sind.
Odoo kann je nach Anwendungsfall und verfügbaren Technologien auf verschiedene Arten installiert werden. Der einfachste und schnellste Weg, Odoo zu installieren, ist die Verwendung der offiziellen Odoo APT-Repositories.
Durch die Installation von Odoo in einer virtuellen Umgebung oder die Bereitstellung als Dockercontainer haben Sie mehr Kontrolle über die Einrichtung des Systems und können mehrere Odoo-Versionen auf demselben System ausführen.
In diesem Leitfaden führen wir Sie durch die Installation und Bereitstellung von Odoo 13 in einer virtuellen Python-Umgebung auf Ubuntu 18.04. Wir laden Odoo aus ihrem Github-Repository herunter und verwenden Nginx als Reverse-Proxy.
Installationsvoraussetzungen #
Melden Sie sich als sudo-Benutzer bei Ihrem Ubuntu an und aktualisieren Sie den Apt-Cache:
sudo apt update
Installieren Sie Git, Pip, Node.js und die Tools, die zum Erstellen von Odoo-Abhängigkeiten erforderlich sind:
sudo apt install git python3-pip build-essential wget python3-dev python3-venv python3-wheel libxslt-dev libzip-dev libldap2-dev libsasl2-dev python3-setuptools node-less
Erstellen eines Systembenutzers #
Erstellen Sie einen Systembenutzer namens odoo13
, der Odoo ausführt mit Heimatverzeichnis /opt/odoo13
:
sudo useradd -m -d /opt/odoo13 -U -r -s /bin/bash odoo13
Sie können den Namen des Benutzers beliebig festlegen, solange Sie einen PostgreSQL-Benutzer mit demselben Namen erstellen.
PostgreSQL installieren und konfigurieren #
Odoo verwendet PostgreSQL als Datenbank-Backend. Um PostgreSQL zu installieren, führen Sie den folgenden Befehl aus:
sudo apt install postgresql
Sobald die Installation abgeschlossen ist, erstellen Sie einen PostgreSQL-Benutzer mit dem gleichen Namen wie der zuvor erstellte Systembenutzer, in unserem Fall ist das odoo13
:
sudo su - postgres -c "createuser -s odoo13"
Installation von Wkhtmltopdf #
Die wkhtmltox
Paket bietet eine Reihe von Open-Source-Befehlszeilentools, die HTML in PDF und verschiedene Bildformate rendern können. Um PDF-Berichte drucken zu können, müssen Sie wkhtmltopdf
installieren Werkzeug. Die empfohlene Version für Odoo ist 0.12.5
, die in den standardmäßigen Ubuntu 18.04-Repositories nicht verfügbar ist.
Laden Sie das Paket mit dem folgenden wget-Befehl herunter:
wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb
Sobald der Download abgeschlossen ist, installieren Sie das Paket, indem Sie Folgendes eingeben:
sudo apt install ./wkhtmltox_0.12.5-1.bionic_amd64.deb
Installieren und Konfigurieren von Odoo 13 #
Wie bereits erwähnt, installieren wir Odoo von der Quelle in einer isolierten virtuellen Python-Umgebung.
Wechseln Sie zunächst zum Benutzer „odoo13“:
sudo su - odoo13
Klonen Sie den Quellcode von Odoo 13 von GitHub:
git clone https://www.github.com/odoo/odoo --depth 1 --branch 13.0 /opt/odoo13/odoo
Sobald der Download abgeschlossen ist, erstellen Sie eine neue virtuelle Python-Umgebung für Odoo:
cd /opt/odoo13
python3 -m venv odoo-venv
Aktivieren Sie die Umgebung mit dem folgenden Befehl:
source odoo-venv/bin/activate
Installieren Sie alle erforderlichen Python-Module mit pip3:
Wenn während der Installation ein Kompilierungsfehler auftritt, vergewissern Sie sich, dass alle erforderlichen Abhängigkeiten in denpip3 install wheel
pip3 install -r odoo/requirements.txt
Installing Prerequisites
aufgeführt sind Abschnitt installiert sind. Wenn Sie fertig sind, deaktivieren Sie die Umgebung, indem Sie Folgendes eingeben:
deactivate
Wir erstellen ein neues Verzeichnis, das die Add-Ons von Drittanbietern enthalten wird.
mkdir /opt/odoo13/odoo-custom-addons
Später fügen wir dieses Verzeichnis zum addons_path
hinzu Parameter. Dieser Parameter definiert eine Liste von Verzeichnissen, in denen Odoo nach Modulen sucht.
Wechseln Sie zurück zu Ihrem sudo-Benutzer:
exit
Erstellen Sie eine Konfigurationsdatei mit folgendem Inhalt:
sudo nano /etc/odoo13.conf
/etc/odoo13.conf[options]
; This is the password that allows database operations:
admin_passwd = my_admin_passwd
db_host = False
db_port = False
db_user = odoo13
db_password = False
addons_path = /opt/odoo13/odoo/addons,/opt/odoo13/odoo-custom-addons
Vergessen Sie nicht, das my_admin_passwd
zu ändern zu etwas Sichererem. Erstellen einer Systemd-Unit-Datei #
Öffnen Sie Ihren Texteditor und erstellen Sie eine Service-Unit-Datei mit dem Namen odoo13.service
mit folgendem Inhalt:
sudo nano /etc/systemd/system/odoo13.service
/etc/systemd/system/odoo13.service[Unit]
Description=Odoo13
Requires=postgresql.service
After=network.target postgresql.service
[Service]
Type=simple
SyslogIdentifier=odoo13
PermissionsStartOnly=true
User=odoo13
Group=odoo13
ExecStart=/opt/odoo13/odoo-venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
StandardOutput=journal+console
[Install]
WantedBy=multi-user.target
Systemd benachrichtigen, dass eine neue Unit-Datei existiert:
sudo systemctl daemon-reload
Starten Sie den Odoo-Dienst und ermöglichen Sie ihm, beim Booten zu starten, indem Sie Folgendes ausführen:
sudo systemctl enable --now odoo13
Überprüfen Sie den Dienststatus:
sudo systemctl status odoo13
Die Ausgabe sollte in etwa so aussehen, was anzeigt, dass der Odoo-Dienst aktiv ist und ausgeführt wird.
● odoo13.service
Loaded: loaded (/etc/systemd/system/odoo13.service; enabled; vendor preset: enabled)
Active: active (running) since Sat 2019-10-19 20:06:23 UTC; 3s ago
Main PID: 1860 (python3)
Tasks: 4 (limit: 2362)
CGroup: /system.slice/odoo13.service
└─1860 /opt/odoo13/odoo-venv/bin/python3 /opt/odoo13/odoo/odoo-bin -c /etc/odoo13.conf
Verwenden Sie den folgenden Befehl, um die vom Odoo-Dienst protokollierten Nachrichten anzuzeigen:
sudo journalctl -u odoo13
Testen der Installation #
Öffnen Sie Ihren Browser und geben Sie Folgendes ein:http://<your_domain_or_IP_address>:8069
Vorausgesetzt, die Installation ist erfolgreich, wird ein Bildschirm ähnlich dem folgenden angezeigt:
Konfigurieren von Nginx als SSL-Terminierungsproxy #
Der standardmäßige Odoo-Webserver bedient Datenverkehr über HTTP. Um die Odoo-Bereitstellung sicherer zu machen, werden wir Nginx als SSL-Terminierungsproxy konfigurieren, der den Datenverkehr über HTTPS bedient.
Der SSL-Terminierungsproxy ist ein Proxyserver, der die SSL-Verschlüsselung/-Entschlüsselung übernimmt. Das bedeutet, dass der Termination Proxy (Nginx) eingehende TLS-Verbindungen (HTTPS) verarbeitet und entschlüsselt und die Anfragen unverschlüsselt an den internen Dienst (Odoo) weiterleitet. Der Datenverkehr zwischen Nginx und Odoo wird nicht verschlüsselt (HTTP).
Die Verwendung eines Reverse-Proxys bietet Ihnen viele Vorteile wie Load Balancing, SSL-Terminierung, Caching, Komprimierung, Bereitstellung statischer Inhalte und mehr.
Stellen Sie sicher, dass Sie die folgenden Voraussetzungen erfüllt haben, bevor Sie mit diesem Abschnitt fortfahren:
- Domänenname, der auf Ihre öffentliche Server-IP verweist. Wir verwenden
example.com
. - Nginx installiert.
- SSL-Zertifikat für Ihre Domain. Sie können ein kostenloses SSL-Zertifikat von Let’s Encrypt installieren.
Öffnen Sie Ihren Texteditor und erstellen/bearbeiten Sie den Domänenserverblock:
sudo nano /etc/nginx/sites-enabled/example.com.conf
Die folgende Konfiguration richtet SSL-Terminierung, HTTP-zu-HTTPS-Umleitung, WWW-zu-Nicht-WWW-Umleitung ein, speichert die statischen Dateien und aktiviert die GZip-Komprimierung.
/etc/nginx/sites-enabled/example.com.conf# Odoo servers
upstream odoo {
server 127.0.0.1:8069;
}
upstream odoochat {
server 127.0.0.1:8072;
}
# HTTP -> HTTPS
server {
listen 80;
server_name www.example.com example.com;
include snippets/letsencrypt.conf;
return 301 https://example.com$request_uri;
}
# WWW -> NON WWW
server {
listen 443 ssl http2;
server_name www.example.com;
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
include snippets/letsencrypt.conf;
return 301 https://example.com$request_uri;
}
server {
listen 443 ssl http2;
server_name example.com;
proxy_read_timeout 720s;
proxy_connect_timeout 720s;
proxy_send_timeout 720s;
# Proxy headers
proxy_set_header X-Forwarded-Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header X-Real-IP $remote_addr;
# SSL parameters
ssl_certificate /etc/letsencrypt/live/example.com/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/example.com/privkey.pem;
ssl_trusted_certificate /etc/letsencrypt/live/example.com/chain.pem;
include snippets/ssl.conf;
include snippets/letsencrypt.conf;
# log files
access_log /var/log/nginx/odoo.access.log;
error_log /var/log/nginx/odoo.error.log;
# Handle longpoll requests
location /longpolling {
proxy_pass http://odoochat;
}
# Handle / requests
location / {
proxy_redirect off;
proxy_pass http://odoo;
}
# Cache static files
location ~* /web/static/ {
proxy_cache_valid 200 90m;
proxy_buffering on;
expires 864000;
proxy_pass http://odoo;
}
# Gzip
gzip_types text/css text/less text/plain text/xml application/xml application/json application/javascript;
gzip on;
}
Vergessen Sie nicht, example.com durch Ihre Odoo-Domain zu ersetzen und den richtigen Pfad zu den SSL-Zertifikatsdateien festzulegen. Die in dieser Konfiguration verwendeten Snippets werden in dieser Anleitung erstellt. Wenn Sie fertig sind, starten Sie den Nginx-Dienst neu:
sudo systemctl restart nginx
Als nächstes müssen wir Odoo sagen, dass es den Proxy verwenden soll. Öffnen Sie dazu die Konfigurationsdatei und fügen Sie die folgende Zeile hinzu:
/etc/odoo13.confproxy_mode = True
Starten Sie den Odoo-Dienst neu, damit die Änderungen wirksam werden:
sudo systemctl restart odoo13
An diesem Punkt ist der Reverse-Proxy konfiguriert und Sie können auf Ihre Odoo-Instanz zugreifen unter:https://example.com
Ändern der Bindungsschnittstelle #
Dieser Schritt ist optional, aber eine gute Sicherheitspraxis.
Standardmäßig lauscht der Odoo-Server auf Port 8069
auf allen Schnittstellen. Um den direkten Zugriff auf die Odoo-Instanz zu deaktivieren, können Sie entweder den Port 8069
blockieren für alle öffentlichen Schnittstellen oder zwingen Sie Odoo, nur auf der lokalen Schnittstelle zu lauschen.
Wir werden Odoo so konfigurieren, dass es nur auf 127.0.0.1
lauscht . Öffnen Sie die Konfiguration und fügen Sie am Ende der Datei die folgenden zwei Zeilen hinzu:
xmlrpc_interface = 127.0.0.1
netrpc_interface = 127.0.0.1
Speichern Sie die Konfigurationsdatei und starten Sie den Odoo-Server neu, damit die Änderungen wirksam werden:
sudo systemctl restart odoo13
Multiprocessing aktivieren #
Standardmäßig arbeitet Odoo im Multithreading-Modus. Für Produktionsbereitstellungen wird empfohlen, auf den Multiprocessing-Server umzusteigen, da er die Stabilität erhöht und die Systemressourcen besser nutzt.
Um Multiprocessing zu aktivieren, müssen Sie die Odoo-Konfiguration bearbeiten und eine Anzahl von Worker-Prozessen ungleich Null festlegen. Die Anzahl der Worker wird basierend auf der Anzahl der CPU-Kerne im System und dem verfügbaren RAM-Speicher berechnet.
Gemäß der offiziellen Odoo-Dokumentation können Sie zur Berechnung der Anzahl der Arbeiter und der erforderlichen RAM-Speichergröße die folgenden Formeln und Annahmen verwenden:
Arbeiterzahlberechnung
- Theoretische maximale Anzahl an Workern =(system_cpus * 2) + 1
- 1 Worker kann ~=6 gleichzeitige Benutzer bedienen
- Cron-Worker benötigen auch CPU
Berechnung der RAM-Speichergröße
- Wir gehen davon aus, dass 20 % aller Anfragen schwere und 80 % leichtere Anfragen sind. Schwere Anforderungen verwenden etwa 1 GB RAM, während leichtere etwa 150 MB RAM verwenden
- Benötigter Arbeitsspeicher =
number_of_workers * ( (light_worker_ratio * light_worker_ram_estimation) + (heavy_worker_ratio * heavy_worker_ram_estimation) )
Wenn Sie nicht wissen, wie viele CPUs Sie auf Ihrem System haben, verwenden Sie das folgende grep
Befehl:
grep -c ^processor /proc/cpuinfo
Nehmen wir an, Sie haben ein System mit 4 CPU-Kernen, 8 GB RAM-Speicher und 30 gleichzeitigen Odoo-Benutzern.
30 users / 6 = **5**
(5 ist die theoretische Anzahl der benötigten Arbeiter)(4 * 2) + 1 = **9**
(9 ist die theoretische maximale Anzahl von Arbeitern)
Basierend auf der obigen Berechnung können Sie 5 Worker + 1 Worker für den Cron-Worker verwenden, also insgesamt 6 Worker.
Berechnen Sie den RAM-Speicherverbrauch basierend auf der Anzahl der Worker:
RAM = 6 * ((0.8*150) + (0.2*1024)) ~= 2 GB of RAM
Die Berechnung zeigt, dass die Odoo-Installation etwa 2 GB RAM benötigt.
Um in den Multiprocessing-Modus zu wechseln, öffnen Sie die Konfigurationsdatei und hängen Sie die berechneten Werte an:
/etc/odoo13.conflimit_memory_hard = 2684354560
limit_memory_soft = 2147483648
limit_request = 8192
limit_time_cpu = 600
limit_time_real = 1200
max_cron_threads = 1
workers = 5
Starten Sie den Odoo-Dienst neu, damit die Änderungen wirksam werden:
sudo systemctl restart odoo13
Die restlichen Systemressourcen werden von anderen Diensten verwendet, die auf diesem System ausgeführt werden. In dieser Anleitung haben wir Odoo zusammen mit PostgreSQL und Nginx auf demselben Server installiert. Abhängig von Ihrer Einrichtung können auch andere Dienste auf Ihrem Server ausgeführt werden.