Hur man installerar ERPNext Open Source ERP på Ubuntu 17.04

Förutsättningar

Installera utvecklingsverktyg

Installera MariaDB Server

Installera Nginx, Node.js och Redis

Installera PDF Converter

Installera bänk

Installera ERPNext med hjälp av Bench

Setup Supervisor och Nginx

Slutsats

ERP eller Enterprise Resource Planning är en företagsapplikationssvit som används för att hantera kärnverksamhetens processer. ERPNext är en fri och öppen källkod, självvärd ERP-applikation skriven i Python. Den använder Node.js för gränssnittet och MariaDB för att lagra sina data. ERPNext tillhandahåller ett lättanvänt webbgränssnitt som låter företag hantera dagliga uppgifter. Den innehåller moduler för redovisning, CRM, HRM, tillverkning, POS, projektledning, inköp, försäljningsledning, lagerhantering med mera. ERPNext kan användas för att hantera olika branscher som tjänsteleverantörer, tillverkning, detaljhandel och skolor.

Förutsättningar

• En Vultr Ubuntu 17.04-serverinstans.
• En sudo-användare .

Obs: För denna handledning kommer vi att använda erp.example.comsom domännamnet pekade på servern. Se till att ersätta alla förekomster av erp.example.commed ditt faktiska domännamn .

Innan vi börjar, se till att din server är uppdaterad.

sudo apt update
sudo apt -y upgrade

Installera utvecklingsverktyg

ERPNext behöver Python version 2.7 för att fungera. Installera Python 2.7.

sudo apt -y install python-minimal

Du bör kunna verifiera dess version.

python -V

Du kommer att se följande utdata.

user@vultr:~$ python -V
Python 2.7.13

Installera några fler beroenden.

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

Installera Pythons pipverktyg. Pip är beroendehanteraren för Python-paket.

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

Se till att du har den senaste versionen av pipoch setuptools.

sudo pip install --upgrade pip setuptools

Installera Ansible med Pip. Ansible automatiserar programvaruprovisionering, konfigurationshantering och applikationsdistribution.

sudo pip install ansible

Installera MariaDB Server

Lägg till MariaDB-förvaret i systemet.

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'

Installera MariaDB.

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

Ange ett starkt lösenord för MariaDB root-användaren när du blir tillfrågad.

Barracuda-lagringsmotorn krävs för att skapa ERPNext-databaser, så du måste konfigurera MariaDB för att använda Barracuda-lagringsmotorn. Redigera standardkonfigurationsfilen för MariaDB my.cnf.

sudo nano /etc/mysql/my.cnf

Lägg till följande rader under [mysqld]raden.

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

Lägg också till följande rad under [mysql]raden.

default-character-set = utf8mb4

Starta om MariaDB och låt den starta automatiskt vid uppstart.

sudo systemctl restart mariadb
sudo systemctl enable mariadb

Innan du konfigurerar databasen måste du säkra MariaDB. Du kan säkra det genom att köra mysql_secure_installationskriptet.

sudo mysql_secure_installation

Du kommer att bli ombedd att ange det aktuella MariaDB root-lösenordet. Ange lösenordet du har angett under installationen. Du kommer att bli tillfrågad om du vill ändra det befintliga lösenordet för rotanvändaren på din MariaDB-server. Du kan hoppa över att ställa in ett nytt lösenord, eftersom du redan har angett ett starkt lösenord under installationen. Svara "Y" på alla andra frågor som ställs.

Installera Nginx, Node.js och Redis

Lägg till Nodesource-förrådet för Node.js 8.x.

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

Installera Nginx, Node.js och Redis.

sudo apt -y install nginx nodejs redis-server

Starta Nginx och låt den starta vid uppstart.

sudo systemctl start nginx
sudo systemctl enable nginx

Starta Redis och låt den starta vid uppstart.

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

Installera PDF Converter

Det wkhtmltopdfprogrammet är en kommandorad verktyg som konverterar HTML till PDF med hjälp av QT Webkit renderingsmotor. Installera nödvändiga beroenden.

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

Ladda ner den senaste versionen av wkhtmltopdf.

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

Extrahera arkivet.

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

Ovanstående kommando extraherar arkivet till /opt/wkhtmltox. Skapa en mjuklänk så att wkhtmltopdfoch wkhtmltoimagekan köras globalt som ett kommando.

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

Du kan nu köra för wkhtmltopdf -Vatt kontrollera om det fungerar, du kommer att se detta.

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

Vid det här laget har vi alla nödvändiga beroenden installerade. Du kan nu fortsätta att installera Bench.

Installera bänk

Benchär ett kommandoradsverktyg som tillhandahålls av Frappe för att installera och hantera ERPNext-applikationen på ett Unix-baserat system för både utvecklings- och produktionsändamål. Bench kan också skapa och hantera Nginx- och supervisorkonfigurationer.

Skapa en ny användare för att köra Bench-processer i den isolerade miljön.

sudo adduser bench --home /opt/bench

Ge användaren sudobehörigheter bench.

sudo usermod -aG sudo bench

Logga in som nyskapad benchanvändare.

sudo su - bench

Klona Bench-förvaret i /opt/bench.

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

Installera bänk med pip.

sudo pip install -e bench-repo

När Bench är installerad, fortsätt vidare för att installera ERPNext med Bench.

Installera ERPNext med hjälp av Bench

Initiera en bänkkatalog med frappe-ramverket installerat. För att hålla allt snyggt kommer vi att arbeta under /opt/benchkatalogen. Bench kommer också att ställa in regelbundna säkerhetskopieringar och automatiska uppdateringar en gång om dagen.

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

Skapa en ny Frappe-sajt.

bench new-site erp.example.com

Kommandot ovan kommer att uppmana dig att ange MySQL root-lösenordet. Ange lösenordet som du har angett för MySQL root-användaren tidigare. Den kommer också att be dig att ange ett nytt lösenord för administratörskontot. Du kommer att behöva detta lösenord senare för att logga in på administratörspanelen .

Ladda ner ERPNext-installationsfiler från fjärrförrådet git med hjälp av Bench.

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

Installera ERPNext på din nyskapade webbplats.

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

Du kan starta programmet omedelbart för att kontrollera om programmet har installerats framgångsrikt.

bench start

Du bör dock stoppa exekveringen och gå vidare för att ställa in applikationen för produktionsanvändning.

Setup Supervisor och Nginx

Som standard lyssnar ERPNext-applikationen på port 8000, inte standard HTTP-port 80. Dessutom rekommenderas inte att köra den inbyggda webbservern för produktionsanvändning eftersom vi kommer att exponera servern för världen. Du bör använda en produktionswebbserver som en omvänd proxy som Apache eller Nginx. Vi kommer att använda Nginx som en omvänd proxy eftersom den kan konfigureras automatiskt med hjälp av Bench. Bench kan automatiskt generera och installera konfigurationen enligt ERPNext-inställningen.

Även om vi kan starta applikationen med kommandot 'bänkstart', kommer exekveringen av ERPNext att stoppas så snart du stänger terminalen. För att lösa det här problemet bör du använda Supervisor, som är till stor hjälp för att köra applikationen kontinuerligt i en produktionsmiljö. Supervisor är ett processtyrningssystem som gör att du kan övervaka och kontrollera ett antal processer på Linux-operativsystem. När Supervisor är konfigurerad kommer den automatiskt att starta programmet vid uppstart samt vid fel. Bench kan automatiskt konfigurera Supervisor för ERPNext-applikationen.

Installera Supervisor.

sudo apt -y install supervisor

Starta Supervisor och låt den starta automatiskt vid uppstart.

sudo systemctl start supervisor
sudo systemctl enable supervisor

Installationsbänk för produktionsanvändning.

 sudo bench setup production bench

Kommandot ovan kan fråga dig innan du ersätter den befintliga standardkonfigurationsfilen för Supervisor med en ny. Välj yatt fortsätta. Bench lägger till ett antal processer i Supervisor-konfigurationsfilen. Ovanstående kommando kommer också att fråga dig om du vill ersätta den nuvarande Nginx-konfigurationen med en ny. Enter för yatt fortsätta. När Bench har avslutat installationen av konfigurationen, ge andra användare att köra filerna i din hemkatalog för Bench-användaren.

chmod o+x /opt/bench/

Du kan nu komma åt sidan på http://erp.example.com.

Du kan kontrollera status för processerna genom att köra.

sudo supervisorctl status all

Du bör se följande utdata.

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

För att stoppa alla ERPNext-processer.

sudo supervisorctl stop all

För att starta alla ERPNext-processer.

sudo supervisorctl start all

Konfigurera SSL med Let's Encrypt

Let's Encrypt tillhandahåller gratis SSL-certifikat till användarna. SSL kan installeras manuellt eller automatiskt via Bench. Bench kan automatiskt installera Let's Encrypt-klienten och få certifikaten. Dessutom uppdaterar den automatiskt Nginx-konfigurationen för att använda certifikaten.

Domännamnet som du använder för att erhålla certifikaten från Let's Encrypt CA måste peka mot servern. Klienten verifierar domänmyndigheten innan certifikaten utfärdas .

Aktivera DNS multi-tenancy för ERPNext-applikationen.

bench config dns_multitenant on

Kör Bench för att konfigurera Let's Encrypt på din webbplats.

sudo bench setup lets-encrypt erp.example.com

Under körningen av skriptet kommer Let's Encrypt-klienten att be dig att tillfälligt stoppa Nginx-webbservern. Den kommer automatiskt att installera de nödvändiga paketen och Let's Encrypt-klienten. Klienten kommer att uppmana dig att ange din e-postadress. Du måste också acceptera villkoren. När certifikaten har genererats kommer Bench också att generera den nya konfigurationen för Nginx som använder SSL-certifikaten. Du kommer att bli tillfrågad innan du ersätter den befintliga konfigurationen. Bench skapar också en crontabpost för att automatiskt förnya certifikaten varje månad.

Slutligen, aktivera schemaläggaren för att automatiskt köra de schemalagda jobben.

bench enable-scheduler

Du bör se denna utdata.

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

Slutsats

När processen är klar kan du komma åt din ansökan på https://erp.example.com. Logga in med användarnamnet Administratoroch lösenordet du angav under installationen. Du kommer att tas till skrivbordet där du kommer att behöva tillhandahålla information för att ställa in ERPNext ERP enligt ditt företag. Du kan nu använda applikationen för att hantera ditt företag.

Grattis, du har en fullt fungerande ERPNext-applikation installerad på din Ubuntu 17.04-server.