ERPNext 14 常规安装流程记录

Wed, 21 Jun 2023 11:58:37 +0800

1. 安装基础依赖

1
2
3

sudo apt update
sudo apt upgrade
sudo apt dist-upgrade

sudo apt install git python3 python3-pip \
    python3-venv software-properties-common \
    mariadb-server mariadb-client \
    redis-server curl nodejs npm xvfb \
    libfontconfig wkhtmltopdf \
    default-libmysqlclient-dev supervisor

2. 配置 Mariadb Server

2.1. 初始化 Mariadb

`1`	`sudo mysql_secure_installation`

2.2. 编辑配置文件

`1`	`sudo vim /etc/mysql/mariadb.conf.d/50-server.cnf`

[mysqld]
bind-address                   = 0.0.0.0    # 此处根据需要修改

character-set-client-handshake = FALSE
character-set-server           = utf8mb4
collation-server               = utf8mb4_unicode_ci

2.3. 重启 Mariadb 服务

重启服务，使配置文件生效。

`1`	`sudo systemctl restart mariadb`

3. 安装 Yarn

`1`	`sudo npm install -g yarn`

4. 配置 Redis

4.1. 新增两份配置

frappe-bench-redis-cache 和 frappe-bench-redis-queue 需要用到。

1
2

sudo cp /etc/redis/redis.conf /etc/redis/redis-frappe-queue.conf
sudo cp /etc/redis/redis.conf /etc/redis/redis-frappe-cahce.conf

修改 /etc/redis/redis-frappe-queue.conf 配置：

`1`	`port 11000`

修改 /etc/redis/redis-frappe-cache.conf 配置：

`1`	`port 13000`

4.2. 启动服务

1
2

sudo /usr/bin/redis-server /etc/redis/redis-frappe-queue.conf --daemonzie yes
sudo /usr/bin/redis-server /etc/redis/redis-frappe-cahce.conf --daemonzie yes

4.3. 检查服务是否启动

1
2

redis-cli -h localhost -p 11000 ping
redis-cli -h localhost -p 13000 ping

5. 使用 Frappe Bench 创建站点

5.1. 安装

`1`	`pip3 install frappe-bench ansible --break-system-packages`

5.2. 初始化 Frappe Bench

`1`	`bench init --frappe-branch version-14 frappe-bench`

5.3. 切换工作目录

`1`	`cd frappe-bench`

5.4. 修改用户目录权限

`1`	`sudo chmod -R o+rx /home/[frappe-user]/`

5.5. 创建新的站点

`1`	`bench new-site [your-site-name]`

6. 安装 ERPNext 和其他应用

6.1. 下载必要的应用

1
2
3

bench get-app payments
bench get-app --branch version-14 erpnext
bench get-app hrms

6.2. 安装应用

1
2

bench --site [your-site-name] install-app erpnext
bench --site [your-site-name] install-app hrms

7. 配置生产环境

7.1. 启用 scheduler 服务

`1`	`bench --site [your-site-name] enable-scheduler`

7.2. 关闭维护模式

`1`	`bench --site [your-site-name] set-maintenance-mode off`

7.3. 切换到生产环境配置

`1`	`sudo bench setup production [frappe-user]`

7.4. 配置 Nginx

`1`	`bench setup nginx`

7.5. 配置最终服务

`1`	`sudo supervisorctl restart all`

`1`	`sudo bench setup production [frappe-user]`

8. 访问 ERPNext

浏览器输入服务器IP即可访问，初始用户名为：Administrator，初始密码为安装 Frappe 时的密码。

附1：文章修订记录

2023-06-21
- 文章初次发表
2023-09-28
- 修正文中多处错误

Erpnext on Void Fox