Installieren Sie Odoo 14 auf CentOS 8

Odoo ist die beliebteste All-in-One-Unternehmenssoftware der Welt. Es bietet eine Reihe von Geschäftsanwendungen, darunter CRM, Website, E-Commerce, Fakturierung, Buchhaltung, Fertigung, Lager, Projektmanagement, Inventar und vieles mehr, die alle nahtlos integriert sind.

Odoo kann je nach Anwendungsfall und verfügbaren Technologien auf unterschiedliche Weise installiert werden. Der einfachste und schnellste Weg, Odoo zu installieren, ist die Verwendung der offiziellen Odoo APTrepositories.

Durch die Installation von Odoo in einer virtuellen Umgebung oder die Bereitstellung als Dockercontainer erhalten Sie mehr Kontrolle über die Anwendung und können mehrere Odoo-Instanzen auf demselben System ausführen.

In diesem Artikel wird erläutert, wie Sie Odoo 14 in einer virtuellen Python-Umgebung unter CentOS 8 installieren und bereitstellen. Wir laden Odoo aus dem offiziellen GitHub-Repository herunter und verwenden Nginx als Reverse-Proxy.

Installationsvoraussetzungen #

Odoo ist in Python geschrieben. Der erste Schritt besteht darin, Python 3, Git, Pip und alle Bibliotheken und Tools zu installieren, die zum Erstellen von Odoo aus den Quellen erforderlich sind:

sudo dnf install python3 python3-devel git gcc sassc redhat-rpm-config libxslt-devel  \    bzip2-devel openldap-devel libjpeg-devel freetype-devel

Erstellen eines Systembenutzers #

Das Ausführen von Odoo unter dem Root-Benutzer ist nicht erlaubt, da dies ein Sicherheitsrisiko darstellt. Erstellen Sie einen neuen Systembenutzer und eine neue Gruppe mit dem Home-Verzeichnis /opt/odoo das den Odoo-Dienst ausführt:

sudo useradd -m -U -r -d /opt/odoo14 -s /bin/bash odoo14

Sie können den Benutzer beliebig benennen; Stellen Sie einfach sicher, dass Sie einen PostgreSQL-Benutzer mit demselben Namen erstellen.

PostgreSQL installieren und konfigurieren #

Odoo verwendet PostgreSQL als Datenbank-Backend. Wir installieren PostgreSQL12 aus den Standard-Repositories von CentOS 8:

sudo dnf install @postgresql:12

Erstellen Sie nach Abschluss der Installation einen neuen PostgreSQL-Datenbankcluster:

sudo postgresql-setup initdb

Aktivieren und starten Sie den PostgreSQL-Dienst:

sudo systemctl enable --now postgresql

Erstellen Sie einen PostgreSQL-Benutzer mit demselben Namen wie der zuvor erstellte Systembenutzer. In diesem Beispiel ist das odoo14 :

sudo su - postgres -c "createuser -s odoo14"

Installation von Wkhtmltopdf #

wkhtmltopdf ist eine Reihe von Open-Source-Befehlszeilentools zum Rendern von HTML-Seiten in PDF und verschiedene Bildformate. Um PDF-Berichte in Odoo zu drucken, müssen Sie wkhtmltox installieren Paket. Die empfohlene Version für Odoo ist Version 0.12.5 , die von Github heruntergeladen und installiert werden kann:

sudo dnf install https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox-0.12.5-1.centos8.x86_64.rpm

Installieren und Konfigurieren von Odoo 14 #

Wir installieren Odoo von der Quelle in einer isolierten virtuellen Python-Umgebung.

Wechseln Sie zunächst zum Benutzer „odoo14“:

sudo su - odoo14

Klonen Sie den Quellcode von Odoo 14 aus dem Odoo GitHub-Repository:

git clone https://www.github.com/odoo/odoo --depth 1 --branch 14.0 /opt/odoo14/odoo

Navigieren Sie zu /opt/odoo14 Verzeichnis und erstellen Sie eine neue virtuelle Python-Umgebung für die Odoo-Installation:

cd /opt/odoo14python3 -m venv venv

Aktivieren Sie die Umgebung mit source Befehl:

source venv/bin/activate

Installieren Sie die erforderlichen Python-Module:

pip3 install -r odoo/requirements.txt

Wenn während der Installation ein Kompilierungsfehler auftritt, vergewissern Sie sich, dass alle erforderlichen Abhängigkeiten in den Installing Prerequisites aufgeführt sind Abschnitt installiert sind.

Wenn Sie fertig sind, deaktivieren Sie die Umgebung, indem Sie Folgendes eingeben:

deactivate

Erstellen Sie ein neues Verzeichnis für die benutzerdefinierten Add-Ons:

mkdir /opt/odoo14/odoo-custom-addons

Wir fügen 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/odoo14.conf

/etc/odoo14.conf

[options]
admin_passwd = superadmin_passwd
db_host = False
db_port = False
db_user = odoo14
db_password = False
addons_path = /opt/odoo14/odoo/addons, /opt/odoo14/odoo-custom-addons

Speichern und schließen Sie die Datei.

Vergessen Sie nicht, das superadmin_passwd zu ändern zu etwas Sichererem.

Systemd-Unit-Datei erstellen #

Öffnen Sie Ihren Texteditor und erstellen Sie eine Service-Unit-Datei mit dem Namen odoo14.service mit folgendem Inhalt:

sudo nano /etc/systemd/system/odoo14.service

Fügen Sie den folgenden Inhalt ein:

/etc/systemd/system/odoo14.service

[Unit]
Description=Odoo14
Requires=postgresql.service
After=network.target postgresql.service

[Service]
Type=simple
SyslogIdentifier=odoo14
PermissionsStartOnly=true
User=odoo14
Group=odoo14
ExecStart=/opt/odoo14/venv/bin/python3 /opt/odoo14/odoo/odoo-bin -c /etc/odoo14.conf
StandardOutput=journal+console

[Install]
WantedBy=multi-user.target

Systemd benachrichtigen, dass eine neue Unit-Datei existiert:

sudo systemctl daemon-reload

Starten und aktivieren Sie den Odoo-Dienst:

sudo systemctl enable --now odoo14

Überprüfen Sie mit dem folgenden Befehl, ob Odoo ausgeführt wird:

sudo systemctl status odoo14

Die Ausgabe sollte in etwa so aussehen und zeigen, dass der Odoo-Dienst aktiv ist und ausgeführt wird:

● odoo14.service - Odoo14
   Loaded: loaded (/etc/systemd/system/odoo14.service; enabled; vendor preset: disabled)
   Active: active (running) since Mon 2020-11-02 20:12:24 UTC; 3s ago
...

Verwenden Sie den folgenden Befehl, um die vom Odoo-Dienst protokollierten Nachrichten anzuzeigen:

sudo journalctl -u odoo14

Testen Sie die 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:

Wenn Sie nicht auf die Seite zugreifen können, stellen Sie sicher, dass Port 8069 ist in Ihrer Firewall geöffnet ist:

sudo firewall-cmd --permanent --zone=public --add-port=8069/tcpsudo firewall-cmd --reload

Konfigurieren von Nginx als SSL-Terminierungsproxy #

Der standardmäßige Odoo-Webserver bedient Datenverkehr über HTTP. Um die Odoo-Instanz 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 heißt, der Termination Proxy (Nginx) verarbeitet und entschlüsselt eingehende TLS-Verbindungen (HTTPS) und leitet die Anfragen unverschlüsselt an den internen Dienst (Odoo) weiter. 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/conf.d/example.com

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/conf.d/example.com

# 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;

    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/odoo14.conf

proxy_mode = True

Starten Sie den Odoo-Dienst neu, damit die Änderungen wirksam werden:

sudo systemctl restart odoo14

An diesem Punkt ist der Reverse-Proxy konfiguriert und Sie können unter https://example.com auf Ihre Odoo-Instanz zugreifen .

Ä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:

/etc/odoo14.conf

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 odoo14

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 anhand der Anzahl der CPU-Kerne und des verfügbaren Arbeitsspeichers berechnet.

Gemäß der offiziellen Odoo-Dokumentation können Sie die folgenden Formeln und Annahmen verwenden, um die Anzahl der Arbeiter und die erforderliche RAM-Speichergröße zu berechnen:

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-Verbrauch 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/odoo14.conf

limit_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 odoo14

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.