So installieren Sie ERPNext Open Source ERP unter Ubuntu 17.04

• Voraussetzungen
• Installieren Sie die Entwicklungstools
• Installieren Sie MariaDB Server
• Installieren Sie Nginx, Node.js und Redis
• Installieren Sie den PDF Converter
• Installieren Sie die Bank
• Installieren Sie ERPNext mit Bench
• Setup Supervisor und Nginx
• Fazit

ERP oder Enterprise Resource Planning ist eine Unternehmensanwendungssuite zur Verwaltung der Kerngeschäftsprozesse. ERPNext ist eine kostenlose und selbst gehostete Open Source-ERP-Anwendung, die in Python geschrieben wurde. Es verwendet Node.js für das Frontend und MariaDB zum Speichern seiner Daten. ERPNext bietet eine benutzerfreundliche Weboberfläche, mit der Unternehmen alltägliche Aufgaben verwalten können. Es enthält Module für Buchhaltung, CRM, HRM, Fertigung, POS, Projektmanagement, Einkauf, Verkaufsmanagement, Lagerverwaltung und mehr. Mit ERPNext können verschiedene Branchen wie Dienstleister, Fertigung, Einzelhandel und Schulen verwaltet werden.

Voraussetzungen

• Eine Vultr Ubuntu 17.04-Serverinstanz.
• Ein Sudo-Benutzer .

Hinweis: In diesem Lernprogramm wird erp.example.comder Domänenname verwendet, der auf den Server verweist. Bitte stellen Sie sicher, dass alle Vorkommen von erp.example.comdurch Ihren tatsächlichen Domainnamen ersetzt werden .

Bevor wir beginnen, stellen Sie sicher, dass Ihr Server auf dem neuesten Stand ist.

sudo apt update
sudo apt -y upgrade

Installieren Sie die Entwicklungstools

ERPNext benötigt Python Version 2.7, um zu funktionieren. Installieren Sie Python 2.7.

sudo apt -y install python-minimal

Sie sollten in der Lage sein, die Version zu überprüfen.

python -V

Sie sehen die folgende Ausgabe.

user@vultr:~$ python -V
Python 2.7.13

Installieren Sie einige weitere Abhängigkeiten.

sudo apt -y install git build-essential python-setuptools python-dev libffi-dev libssl-dev

Installieren Sie das Python- pipTool. Pip ist der Abhängigkeitsmanager für Python-Pakete.

wget https://bootstrap.pypa.io/get-pip.py
sudo python get-pip.py

Stellen Sie sicher, dass Sie über die neueste Version von pipund verfügen setuptools.

sudo pip install --upgrade pip setuptools

Installieren Sie Ansible mit Pip. Ansible automatisiert die Softwarebereitstellung, das Konfigurationsmanagement und die Anwendungsbereitstellung.

sudo pip install ansible

Installieren Sie MariaDB Server

Fügen Sie das MariaDB-Repository zum System hinzu.

sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://mirror.nodesdirect.com/mariadb/repo/10.2/ubuntu xenial main'

Installieren Sie MariaDB.

sudo apt update
sudo apt -y install mariadb-server libmysqlclient-dev

Geben Sie ein sicheres Kennwort für den MariaDB-Root-Benutzer ein, wenn Sie dazu aufgefordert werden.

Die Barracuda-Speicher-Engine wird für die Erstellung von ERPNext-Datenbanken benötigt. Daher müssen Sie MariaDB für die Verwendung der Barracuda-Speicher-Engine konfigurieren. Bearbeiten Sie die Standard-MariaDB-Konfigurationsdatei my.cnf.

sudo nano /etc/mysql/my.cnf

Fügen Sie die folgenden Zeilen unter der [mysqld]Zeile hinzu.

innodb-file-format=barracuda
innodb-file-per-table=1
innodb-large-prefix=1
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

Fügen Sie außerdem die folgende Zeile unter der [mysql]Zeile hinzu.

default-character-set = utf8mb4

Starten Sie MariaDB neu und aktivieren Sie es, damit es beim Booten automatisch gestartet wird.

sudo systemctl restart mariadb
sudo systemctl enable mariadb

Bevor Sie die Datenbank konfigurieren, müssen Sie MariaDB sichern. Sie können es sichern, indem Sie das mysql_secure_installationSkript ausführen.

sudo mysql_secure_installation

Sie werden nach dem aktuellen MariaDB-Root-Passwort gefragt. Geben Sie das Kennwort ein, das Sie während der Installation festgelegt haben. Sie werden gefragt, ob Sie das vorhandene Kennwort des Root-Benutzers Ihres MariaDB-Servers ändern möchten. Sie können das Festlegen eines neuen Kennworts überspringen, da Sie bereits während der Installation ein sicheres Kennwort angegeben haben. Beantworten Sie alle anderen gestellten Fragen mit "Y".

Installieren Sie Nginx, Node.js und Redis

Fügen Sie das Nodesource-Repository für Node.js 8.x hinzu.

sudo curl --silent --location https://deb.nodesource.com/setup_8.x | sudo bash -

Installieren Sie Nginx, Node.js und Redis.

sudo apt -y install nginx nodejs redis-server

Starten Sie Nginx und aktivieren Sie es, um es beim Booten zu starten.

sudo systemctl start nginx
sudo systemctl enable nginx

Starten Sie Redis und aktivieren Sie es, um es beim Booten zu starten.

sudo systemctl start redis-server
sudo systemctl enable redis-server

Installieren Sie den PDF Converter

Das wkhtmltopdfProgramm ist ein Befehlszeilenprogramm, das HTML mithilfe der QT Webkit-Rendering-Engine in PDF konvertiert. Installieren Sie die erforderlichen Abhängigkeiten.

sudo apt -y install libxrender1 libxext6 xfonts-75dpi xfonts-base

Laden Sie die neueste Version von herunter wkhtmltopdf.

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.4/wkhtmltox-0.12.4_linux-generic-amd64.tar.xz

Extrahieren Sie das Archiv.

sudo tar -xf wkhtmltox-0.12.4_linux-generic-amd64.tar.xz -C /opt

Der obige Befehl extrahiert das Archiv nach /opt/wkhtmltox. Erstellen Sie einen symbolischen Link , so dass wkhtmltopdfund wkhtmltoimagekann global als Befehl ausgeführt werden.

sudo ln -s /opt/wkhtmltox/bin/wkhtmltopdf /usr/bin/wkhtmltopdf
sudo ln -s /opt/wkhtmltox/bin/wkhtmltoimage /usr/bin/wkhtmltoimage

Sie können jetzt ausführen wkhtmltopdf -V, um zu überprüfen, ob es funktioniert. Sie werden dies sehen.

user@vultr:~$ wkhtmltopdf -V
wkhtmltopdf 0.12.4 (with patched qt)

Zu diesem Zeitpunkt sind alle erforderlichen Abhängigkeiten installiert. Sie können nun mit der Installation von Bench fortfahren.

Installieren Sie die Bank

Benchist ein von Frappe bereitgestelltes Befehlszeilenprogramm zum Installieren und Verwalten der ERPNext-Anwendung auf einem Unix-basierten System für Entwicklungs- und Produktionszwecke. Bench kann auch Nginx- und Supervisor-Konfigurationen erstellen und verwalten.

Erstellen Sie einen neuen Benutzer, um Bench-Prozesse in der isolierten Umgebung auszuführen.

sudo adduser bench --home /opt/bench

Geben Sie sudodem benchBenutzer Berechtigungen .

sudo usermod -aG sudo bench

Melden Sie sich als neu erstellter benchBenutzer an.

sudo su - bench

Klonen Sie das Bench-Repository in /opt/bench.

cd /opt/bench
git clone https://github.com/frappe/bench bench-repo

Installieren Sie die Bank mit pip.

sudo pip install -e bench-repo

Fahren Sie nach der Installation von Bench mit der Installation von ERPNext mithilfe von Bench fort.

Installieren Sie ERPNext mit Bench

Initialisieren Sie ein Bench-Verzeichnis mit installiertem Frappe-Framework. Um alles aufgeräumt zu halten, werden wir unter dem /opt/benchVerzeichnis arbeiten. Bench wird außerdem einmal täglich regelmäßige Backups und automatische Updates einrichten.

cd /opt/bench
bench init erpnext && cd erpnext

Erstellen Sie eine neue Frappe-Site.

bench new-site erp.example.com

Der obige Befehl fordert Sie zur Eingabe des MySQL-Root-Passworts auf. Geben Sie das Kennwort ein, das Sie zuvor für den MySQL-Root-Benutzer festgelegt haben. Sie werden außerdem aufgefordert, ein neues Kennwort für das Administratorkonto festzulegen. Sie benötigen dieses Kennwort später, um sich beim Administrator-Dashboard anzumelden .

Laden Sie ERPNext-Installationsdateien mit Bench aus dem Remote-Git-Repository herunter.

bench get-app erpnext https://github.com/frappe/erpnext

Installieren Sie ERPNext auf Ihrer neu erstellten Site.

bench --site erp.example.com install-app erpnext

Sie können die Anwendung sofort starten, um zu überprüfen, ob die Anwendung erfolgreich installiert wurde.

bench start

Sie sollten jedoch die Ausführung stoppen und fortfahren, um die Anwendung für die Verwendung in der Produktion einzurichten.

Setup Supervisor und Nginx

Standardmäßig überwacht die ERPNext-Anwendung den Port 8000und nicht den Standard-HTTP-Port 80. Außerdem wird nicht empfohlen, den integrierten Webserver für die Produktion auszuführen, da wir den Server der Welt aussetzen werden. Sie sollten einen Produktionswebserver als Reverseproxy wie Apache oder Nginx verwenden. Wir werden Nginx als Reverse-Proxy verwenden, da es automatisch mit Bench konfiguriert werden kann. Bench kann die Konfiguration automatisch gemäß dem ERPNext-Setup generieren und installieren.

Obwohl wir die Anwendung mit dem Befehl 'Bench Start' starten können, wird die Ausführung von ERPNext beendet, sobald Sie das Terminal schließen. Um dieses Problem zu beheben, sollten Sie Supervisor verwenden, was sehr hilfreich ist, um die Anwendung kontinuierlich in einer Produktionsumgebung auszuführen. Supervisor ist ein Prozesssteuerungssystem, mit dem Sie eine Reihe von Prozessen unter Linux-Betriebssystemen überwachen und steuern können. Sobald Supervisor konfiguriert ist, startet er die Anwendung automatisch beim Booten sowie bei Fehlern. Bench kann Supervisor automatisch für die ERPNext-Anwendung konfigurieren.

Installieren Sie Supervisor.

sudo apt -y install supervisor

Starten Sie Supervisor und aktivieren Sie ihn, um beim Booten automatisch zu starten.

sudo systemctl start supervisor
sudo systemctl enable supervisor

Setup Bench für den Produktionsbetrieb.

 sudo bench setup production bench

Der obige Befehl fordert Sie möglicherweise auf, bevor Sie die vorhandene Supervisor-Standardkonfigurationsdatei durch eine neue ersetzen. Wählen Sie, yum fortzufahren. Bench fügt der Supervisor-Konfigurationsdatei eine Reihe von Prozessen hinzu. Mit dem obigen Befehl werden Sie auch gefragt, ob Sie die aktuelle Nginx-Konfiguration durch eine neue ersetzen möchten. Geben Sie ein, yum fortzufahren. Geben Sie nach Abschluss der Installation der Konfiguration anderen Benutzern die Möglichkeit, die Dateien in Ihrem Home-Verzeichnis des Bench-Benutzers auszuführen.

chmod o+x /opt/bench/

Sie können jetzt auf die Site zugreifen http://erp.example.com.

Sie können den Status der Prozesse durch Ausführen überprüfen.

sudo supervisorctl status all

Sie sollten die folgende Ausgabe sehen.

bench@vultr:~/erpnext$ sudo supervisorctl status all
erpnext-redis:erpnext-redis-cache                 RUNNING   pid 13852, uptime 0:00:54
erpnext-redis:erpnext-redis-queue                 RUNNING   pid 13851, uptime 0:00:54
erpnext-redis:erpnext-redis-socketio              RUNNING   pid 13853, uptime 0:00:54
erpnext-web:erpnext-frappe-web                    RUNNING   pid 13856, uptime 0:00:54
erpnext-web:erpnext-node-socketio                 RUNNING   pid 13855, uptime 0:00:54
erpnext-workers:erpnext-frappe-default-worker-0   RUNNING   pid 13862, uptime 0:00:54
erpnext-workers:erpnext-frappe-long-worker-0      RUNNING   pid 13870, uptime 0:00:54
erpnext-workers:erpnext-frappe-schedule           RUNNING   pid 13869, uptime 0:00:54
erpnext-workers:erpnext-frappe-short-worker-0     RUNNING   pid 13875, uptime 0:00:54

So stoppen Sie alle ERPNext-Prozesse.

sudo supervisorctl stop all

So starten Sie alle ERPNext-Prozesse

sudo supervisorctl start all

Einrichten von SSL mit Let's Encrypt

Let's Encrypt stellt den Benutzern kostenlose SSL-Zertifikate zur Verfügung. SSL kann manuell oder automatisch über Bench installiert werden. Bench kann den Let's Encrypt-Client automatisch installieren und die Zertifikate erhalten. Darüber hinaus wird die Nginx-Konfiguration automatisch aktualisiert, um die Zertifikate zu verwenden.

Der Domänenname, mit dem Sie die Zertifikate von der Let's Encrypt-Zertifizierungsstelle erhalten, muss auf den Server gerichtet sein. Der Client überprüft die Domänenautorität, bevor er die Zertifikate ausstellt .

Aktivieren Sie die DNS-Mandantenfähigkeit für die ERPNext-Anwendung.

bench config dns_multitenant on

Führen Sie Bench aus, um Let's Encrypt auf Ihrer Site einzurichten.

sudo bench setup lets-encrypt erp.example.com

Während der Ausführung des Skripts werden Sie vom Let's Encrypt-Client aufgefordert, den Nginx-Webserver vorübergehend zu stoppen. Die erforderlichen Pakete und der Let's Encrypt-Client werden automatisch installiert. Der Kunde fordert Sie zur Eingabe Ihrer E-Mail-Adresse auf. Sie müssen auch die Allgemeinen Geschäftsbedingungen akzeptieren. Sobald die Zertifikate generiert wurden, generiert Bench auch die neue Konfiguration für Nginx, die die SSL-Zertifikate verwendet. Sie werden gefragt, bevor Sie die vorhandene Konfiguration ersetzen. Bench erstellt außerdem einen crontabEintrag, um die Zertifikate jeden Monat automatisch zu erneuern.

Aktivieren Sie schließlich den Scheduler, um die geplanten Jobs automatisch auszuführen.

bench enable-scheduler

Sie sollten diese Ausgabe sehen.

bench@vultr:~/erpnext$ bench enable-scheduler
Enabled for erp.example.com

Fazit

Sobald der Vorgang abgeschlossen ist, können Sie unter auf Ihre Anwendung zugreifen https://erp.example.com. Melden Sie sich mit dem Benutzernamen Administratorund dem Passwort an, die Sie während der Installation festgelegt haben. Sie werden zum Schreibtisch gebracht, wo Sie Informationen bereitstellen müssen, um ERPNext ERP entsprechend Ihrem Unternehmen einzustellen. Mit der Anwendung können Sie jetzt Ihr Unternehmen verwalten.

Herzlichen Glückwunsch, auf Ihrem Ubuntu 17.04-Server ist eine voll funktionsfähige ERPNext-Anwendung installiert.