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.com
come nome di dominio puntato al server. Assicurati di sostituire tutte le occorrenze di erp.example.com
con il tuo vero nome di dominio .
Prima di iniziare, assicurati che il tuo server sia aggiornato.
sudo apt update
sudo apt -y upgrade
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 pip
strumento 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 pip
e 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_installation
script.
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 wkhtmltopdf
programma è 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é wkhtmltopdf
e wkhtmltoimage
può 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 -V
per 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 sudo
autorizzazioni bench
all'utente.
sudo usermod -aG sudo bench
Accedi come l' bench
utente 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/bench
directory. 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 y
di 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 y
per 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 crontab
voce 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 Administrator
e 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.