Ubuntu 環境下安裝 ERPNext 12

前言

之前提到准備安裝ERPNext進行測試，看看是否符合公司的業務形式和需求。在先后嘗試了CentOS 8，Ubuntu20.04后，均未成功，因此將目標定在了CentOS 7上。結果，嘗試一番又以失敗告終。最終經過多次嘗試，在Ubuntu18.04上成功安裝並運行。接下來將分享一下安裝的過程。希望可以幫助到各位。以下僅針對在局域網內使用的情況，如果在服務器上需要開啟公網訪問的功能，請參閱官方說明或查找其他資料。

環境

台式機 + 局域網 + Ubuntu18.04 desktop + python3

安裝步驟

說明

在嘗試安裝的過程中遇到了很多問題，下面的過程是以官方安裝手冊為基礎，並結合所遇到問題整理出的安裝步驟。推薦使用Ubuntu18.04默認的Python3.6.5進行安裝。

前期准備

升級Ubuntu

sudo apt update
sudo apt upgrade

安裝Git

sudo apt-get install git

安裝Python3相關工具

sudo apt-get install python3-dev python3-setuptools python3-pip

安裝virtualenv

sudo apt-get install virtualenv

安裝並配置MariaDB 10.3

安裝MariaDB 10.3穩定版

sudo apt-get install software-properties-common
sudo apt-key adv --recv-keys --keyserver hkp://keyserver.ubuntu.com:80 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.ubuntu-tw.org/mirror/mariadb/repo/10.3/ubuntu xenial main'
sudo apt-get update
sudo apt-get install mariadb-server-10.3

設置MariaDB用戶密碼（如果安裝時未設置）

mysql_secure_installation

安裝MySQL開發工具

sudo apt-get install libmysqlclient-dev

打開MySQL配置文件

sudo vim /etc/mysql/my.cnf

結尾添加以下內容

[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci

[mysql]
default-character-set = utf8mb4

啟動MySQL

sudo service mysql restart

安裝Redis

sudo apt-get install redis-server

安裝Node.js

sudo apt-get install curl
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
sudo apt-get install -y nodejs

安裝yarn

sudo apt install yarn

升級yarn、browerslist、caniuse-lite

sudo npm i yarn
sudo npm i browserslist
sudo npm i caniuse-lite

擴充Ubuntu中gulp watch監視數量上限

echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p

創建、設置並切換到ERPNext的管理用戶

adduser 用戶名
usermod -aG sudo 用戶名
su - 用戶名

安裝Bench和Frappe

下載、安裝、初始化Bench

git clone https://github.com/frappe/bench
pip3 install -e ./bench

重啟系統

個人習慣重啟后登入管理員賬戶，在terminal里切換到ERPNext的管理用戶。

bench init --frappe-branch version-12 --python /usr/bin/python3 文件夾名

配置Frappe

進入剛剛創建的文件夾

cd 文件夾名

添加Frappe到python3

./env/bin/pip3 install -e apps/frappe/

開啟Bench

bench start

此時保留該terminal窗口，另外開啟一個terminal並登陸ERPNext的管理賬戶，並進入上述文件夾名下進行后續操作。

創建網站

bench new-site 域名

因為我是在局域網中使用，這里的域名我是隨便添加的。

下載、安裝ERPNext

下載ERPNext

bench get-app --branch version-12 erpnext

添加ERPNext到Python3

./env/bin/pip3 install -e apps/erpnext/

安裝ERPNext

bench --site 域名 install-app erpnext

外網訪問配置

如開頭提到的，因為目前所使用的環境是在局域網內，因此沒有嘗試對外網訪問進行配置。具體設置方式請參考官方文檔。

總結

至此，ERPNext的安裝就已經完成。

其中最重要的步驟是在安裝Bench、Frappe和ERPNext前進行以下調整：

1. 更換阿里雲的源；
2. 用Ubuntu18.04自帶的Python3；
3. 更新npm里面的browerslist和caniuse-lite。

從自身經驗來看，完全按照官方安裝文檔進行安裝，並不能順利完成，最主要的原因包括網絡問題、一些所需文件的版本問題等。不過作為開源軟件來說，有這些問題也是正常的，畢竟開發團隊本身也是商業公司。

接下來各位就需要根據需求對其進行調配了。