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。

从自身经验来看，完全按照官方安装文档进行安装，并不能顺利完成，最主要的原因包括网络问题、一些所需文件的版本问题等。不过作为开源软件来说，有这些问题也是正常的，毕竟开发团队本身也是商业公司。

接下来各位就需要根据需求对其进行调配了。