Come installare ERPNext Open Source ERP su Ubuntu 17.04

• Prerequisiti
• Installa strumenti di sviluppo
• Installa il server MariaDB
• Installa Nginx, Node.js e Redis
• Installa PDF Converter
• Installa il banco
• Installa ERPNext usando Bench
• Setup Supervisor e Nginx
• Conclusione

ERP o Enterprise Resource Planning è una suite di applicazioni aziendali utilizzata per gestire i processi aziendali principali. ERPNext è un'applicazione ERP self-hosted gratuita e open source scritta in Python. Utilizza Node.js per il front-end e MariaDB per archiviare i suoi dati. ERPNext fornisce un'interfaccia Web di facile utilizzo che consente alle aziende di gestire le attività quotidiane. Contiene moduli per contabilità, CRM, gestione delle risorse umane, produzione, POS, gestione dei progetti, acquisti, gestione delle vendite, gestione del magazzino e altro ancora. ERPNext può essere utilizzato per gestire diversi settori come fornitori di servizi, produzione, vendita al dettaglio e scuole.

Prerequisiti

• Un'istanza del server Vultr Ubuntu 17.04.
• Un utente sudo .

Nota: per questa esercitazione, useremo erp.example.comcome nome di dominio puntato al server. Assicurati di sostituire tutte le occorrenze di erp.example.comcon il tuo vero nome di dominio .

Prima di iniziare, assicurati che il tuo server sia aggiornato.

sudo apt update
sudo apt -y upgrade

Installa strumenti di sviluppo

ERPNext ha bisogno di Python versione 2.7 per funzionare. Installa Python 2.7.

sudo apt -y install python-minimal

Dovresti essere in grado di verificarne la versione.

python -V

Vedrai il seguente output.

user@vultr:~$ python -V
Python 2.7.13

Installa alcune dipendenze in più.

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

Installa lo pipstrumento di Python . Pip è il gestore delle dipendenze per i pacchetti Python.

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

Assicurarsi di disporre dell'ultima versione di pipe setuptools.

sudo pip install --upgrade pip setuptools

Installa Ansible usando Pip. Ansible automatizza il provisioning del software, la gestione della configurazione e la distribuzione delle applicazioni.

sudo pip install ansible

Installa il server MariaDB

Aggiungi il repository MariaDB nel sistema.

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'

Installa MariaDB.

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

Fornire una password complessa per l'utente root MariaDB quando richiesto.

Il motore di archiviazione Barracuda è necessario per la creazione di database ERPNext, quindi sarà necessario configurare MariaDB per utilizzare il motore di archiviazione Barracuda. Modifica il file di configurazione predefinito di MariaDB my.cnf.

sudo nano /etc/mysql/my.cnf

Aggiungi le seguenti righe sotto la [mysqld]riga.

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

Inoltre, aggiungi la seguente riga sotto la [mysql]riga.

default-character-set = utf8mb4

Riavvia MariaDB e abilita l'avvio automatico all'avvio.

sudo systemctl restart mariadb
sudo systemctl enable mariadb

Prima di configurare il database, è necessario proteggere MariaDB. Puoi proteggerlo eseguendo lo mysql_secure_installationscript.

sudo mysql_secure_installation

Ti verrà chiesta la password di root di MariaDB corrente. Fornire la password impostata durante l'installazione. Ti verrà chiesto se desideri modificare la password esistente dell'utente root del tuo server MariaDB. Puoi saltare l'impostazione di una nuova password, poiché hai già fornito una password complessa durante l'installazione. Rispondi "Y" a tutte le altre domande che vengono poste.

Installa Nginx, Node.js e Redis

Aggiungi il repository Nodesource per Node.js 8.x.

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

Installa Nginx, Node.js e Redis.

sudo apt -y install nginx nodejs redis-server

Avvia Nginx e abilitalo all'avvio.

sudo systemctl start nginx
sudo systemctl enable nginx

Avvia Redis e abilitalo all'avvio.

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

Installa PDF Converter

Il wkhtmltopdfprogramma è uno strumento da riga di comando che converte HTML in PDF utilizzando il motore di rendering QT Webkit. Installa le dipendenze richieste.

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

Scarica l'ultima versione di wkhtmltopdf.

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

Estrai l'archivio.

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

Il comando sopra estrarrà l'archivio in /opt/wkhtmltox. Creare un softlink cosicché wkhtmltopdfe wkhtmltoimagepuò essere eseguita globalmente come un comando.

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

Ora puoi eseguire wkhtmltopdf -Vper verificare se funziona, vedrai questo.

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

A questo punto, abbiamo installato tutte le dipendenze richieste. Ora puoi procedere con l'installazione di Bench.

Installa il banco

Benchè un'utilità della riga di comando fornita da Frappe per installare e gestire l'applicazione ERPNext su un sistema basato su Unix sia per scopi di sviluppo che di produzione. Bench può anche creare e gestire configurazioni Nginx e supervisore.

Crea un nuovo utente per eseguire processi di Bench in un ambiente isolato.

sudo adduser bench --home /opt/bench

Fornire sudoautorizzazioni benchall'utente.

sudo usermod -aG sudo bench

Accedi come l' benchutente appena creato .

sudo su - bench

Clonare il repository Bench in /opt/bench.

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

Installare il banco usando pip.

sudo pip install -e bench-repo

Una volta installato Bench, procedere ulteriormente per installare ERPNext utilizzando Bench.

Installa ERPNext usando Bench

Inizializza una directory da banco con installato frappe framework. Per mantenere tutto in ordine, lavoreremo nella /opt/benchdirectory. Bench imposterà inoltre backup regolari e aggiornamenti automatici una volta al giorno.

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

Crea un nuovo sito Frappe.

bench new-site erp.example.com

Il comando sopra ti chiederà la password di root di MySQL. Fornisci la password che hai impostato per l'utente root MySQL in precedenza. Ti chiederà anche di impostare una nuova password per l'account amministratore. Questa password sarà necessaria in seguito per accedere alla dashboard dell'amministratore .

Scarica i file di installazione di ERPNext dal repository git remoto usando Bench.

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

Installa ERPNext sul tuo sito appena creato.

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

È possibile avviare immediatamente l'applicazione per verificare se l'applicazione è stata installata correttamente.

bench start

Tuttavia, è necessario interrompere l'esecuzione e procedere ulteriormente per configurare l'applicazione per l'uso in produzione.

Setup Supervisor e Nginx

Per impostazione predefinita, l'applicazione ERPNext è in ascolto sulla porta 8000, non sulla porta HTTP standard 80. Inoltre, non è consigliabile eseguire il server Web incorporato per l'uso in produzione poiché esponiamo il server al mondo. È necessario utilizzare un server Web di produzione come proxy inverso come Apache o Nginx. Useremo Nginx come proxy inverso in quanto può essere configurato automaticamente tramite Bench. Il banco può generare e installare automaticamente la configurazione in base alla configurazione di ERPNext.

Sebbene sia possibile avviare l'applicazione utilizzando il comando 'bench start', l'esecuzione di ERPNext si interromperà non appena si chiude il terminale. Per ovviare a questo problema, è necessario utilizzare Supervisor, che è molto utile nell'esecuzione continua dell'applicazione in un ambiente di produzione. Supervisor è un sistema di controllo dei processi che consente di monitorare e controllare una serie di processi su sistemi operativi Linux. Una volta configurato Supervisor, avvia automaticamente l'applicazione al momento dell'avvio e in caso di errori. Il banco può configurare automaticamente Supervisor per l'applicazione ERPNext.

Installa supervisore.

sudo apt -y install supervisor

Avviare Supervisor e abilitare l'avvio automatico all'avvio.

sudo systemctl start supervisor
sudo systemctl enable supervisor

Banco di installazione per uso produttivo.

 sudo bench setup production bench

Il comando precedente potrebbe richiedere di sostituire il file di configurazione predefinito del supervisore esistente con uno nuovo. Scegli ydi procedere. Il banco aggiunge una serie di processi al file di configurazione del supervisore. Il comando sopra ti chiederà anche se desideri sostituire la configurazione Nginx corrente con una nuova. Entra yper procedere. Una volta che Bench ha terminato l'installazione della configurazione, fornire ad altri utenti l'esecuzione dei file nella propria directory home dell'utente Bench.

chmod o+x /opt/bench/

Ora puoi accedere al sito su http://erp.example.com.

È possibile verificare lo stato dei processi eseguendo.

sudo supervisorctl status all

Dovresti vedere il seguente output.

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

Per interrompere tutti i processi ERPNext.

sudo supervisorctl stop all

Per avviare tutti i processi ERPNext.

sudo supervisorctl start all

Configurare SSL usando Let's Encrypt

Let's Encrypt fornisce agli utenti certificati SSL gratuiti. SSL può essere installato manualmente o automaticamente tramite Bench. Bench può installare automaticamente il client Let's Encrypt e ottenere i certificati. Inoltre, aggiorna automaticamente la configurazione di Nginx per utilizzare i certificati.

Il nome di dominio che si sta utilizzando per ottenere i certificati dalla CA Let's Encrypt deve essere puntato verso il server. Il client verifica l'autorità di dominio prima di emettere i certificati .

Abilita multi-tenancy DNS per l'applicazione ERPNext.

bench config dns_multitenant on

Esegui Bench per impostare Let's Encrypt sul tuo sito.

sudo bench setup lets-encrypt erp.example.com

Durante l'esecuzione dello script, il client Let's Encrypt ti chiederà di arrestare temporaneamente il web server Nginx. Installerà automaticamente i pacchetti richiesti e il client Let's Encrypt. Il client ti chiederà il tuo indirizzo email. Dovrai anche accettare i termini e le condizioni. Una volta che i certificati sono stati generati, Bench genererà anche la nuova configurazione per Nginx che utilizza i certificati SSL. Ti verrà chiesto prima di sostituire la configurazione esistente. Bench crea anche una crontabvoce per rinnovare automaticamente i certificati ogni mese.

Infine, abilitare lo scheduler per eseguire automaticamente i lavori pianificati.

bench enable-scheduler

Dovresti vedere questo output.

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

Conclusione

Al termine del processo, è possibile accedere all'applicazione all'indirizzo https://erp.example.com. Accedi con il nome utente Administratore la password che hai impostato durante l'installazione. Verrai indirizzato al banco in cui dovrai fornire informazioni per impostare ERPSuccessivo in base alla tua azienda. Ora puoi utilizzare l'applicazione per gestire la tua azienda.

Congratulazioni, hai un'applicazione ERPNext perfettamente funzionante installata sul tuo server Ubuntu 17.04.