Cách cài đặt ERPNext trên Debian 9

[theanh]

ERPNext là phần mềm ERP mã nguồn mở miễn phí được viết bằng Python trên nền tảng Frappe và bao gồm Kế toán, Hàng tồn kho, Sản xuất, CRM, Bán hàng, Mua hàng, Quản lý dự án, HRMS, v.v. ERPNext là hệ thống ERP đơn giản, mạnh mẽ và dễ sử dụng. Nó đi kèm với giao diện web đẹp mắt có thể được sử dụng để quản lý các tác vụ hàng ngày từ một vị trí trung tâm.

Trong hướng dẫn này, chúng ta sẽ tìm hiểu cách cài đặt phần mềm ERPNext trên máy chủ Debian 9.

Điều kiện tiên quyết​

• Một máy chủ chạy Debian 9.
• Một người dùng không phải root có quyền sudo.

Bắt đầu​

Trước khi bắt đầu, bạn nên cập nhật kho lưu trữ gói của mình lên phiên bản mới nhất. Bạn có thể thực hiện điều này bằng cách chạy lệnh sau:

sudo apt-get update -y
sudo apt-get upgrade -y

Tiếp theo, khởi động lại hệ thống để áp dụng tất cả các thay đổi.

Cài đặt Dependencies​

ERPNext yêu cầu Python phiên bản 2.7 để hoạt động bình thường. Bạn có thể cài đặt Python và các gói bắt buộc khác bằng cách chạy lệnh sau:

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

Bạn cũng sẽ cần cài đặt công cụ pip của Python để cài đặt các dependency của Python. Bạn có thể thực hiện việc này bằng cách chạy lệnh sau:

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

Tiếp theo, cài đặt ansible bằng lệnh pip:

sudo pip install ansible

Cài đặt Node.js, Redis và Nginx​

Theo mặc định, phiên bản mới nhất của Node.js không khả dụng trong Debian 9. Vì vậy, bạn sẽ cần thêm kho lưu trữ Nodesource cho Node.js 8.x. Bạn có thể thực hiện điều này bằng cách chạy lệnh sau:

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

Tiếp theo, cài đặt Node.js, Nginx và Redis bằng cách chạy lệnh sau:

sudo apt-get install nodejs redis-server nginx -y

Sau khi tất cả các gói được cài đặt, hãy khởi động dịch vụ Nginx và Redis và cho phép chúng khởi động khi khởi động bằng lệnh sau:

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

Cài đặt và cấu hình MariaDB​

Theo mặc định, phiên bản mới nhất của MariaDB không có trong kho lưu trữ Debian 9. Vì vậy, bạn sẽ cần thêm kho lưu trữ MariaDB cho mục đích đó.

Đầu tiên, hãy tải xuống và thêm khóa ký vào hệ thống của bạn bằng lệnh sau:

sudo apt-get install software-properties-common dirmngr
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8

Tiếp theo, hãy thêm kho lưu trữ MariaDB bằng lệnh sau:

sudo add-apt-repository 'deb [arch=amd64,i386,ppc64el] http://ftp.utexas.edu/mariadb/repo/10.2/debian stretch main'

Cuối cùng, hãy cài đặt máy chủ MariaDB bằng lệnh sau:

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

Tiếp theo, bạn sẽ cần thêm công cụ lưu trữ Barracuda vào tệp cấu hình MariaDB để tạo cơ sở dữ liệu ERPNext. Bạn có thể thực hiện việc này bằng cách chỉnh sửa tệp my.cnf:

sudo nano /etc/mysql/my.cnf

thêm các dòng sau:

[mysqld]innodb-file-format=barracudainnodb-file-per-table=1innodb-large-prefix=1character-set-client-handshake = FALSEcharacter-set-server = utf8mb4collation-server = utf8mb4_unicode_ci[mysql]default-character-set = utf8mb4

Lưu và đóng tệp khi bạn hoàn tất, sau đó khởi động dịch vụ MariaDB và cho phép dịch vụ này khởi động khi khởi động bằng lệnh sau:

sudo systemctl restart mysql
sudo systemctl enable mysql

Tiếp theo, bảo mật MariaDB bằng cách chạy tập lệnh mysql_secure_installation:

sudo mysql_secure_installation

Tập lệnh này sẽ đặt mật khẩu gốc, xóa người dùng ẩn danh, không cho phép đăng nhập gốc từ xa và xóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào MariaDB an toàn như được hiển thị bên dưới:

Đặt mật khẩu gốc? [Y/n] yXóa người dùng ẩn danh? [Y/n] yKhông cho phép đăng nhập gốc từ xa? [Y/n] yXóa cơ sở dữ liệu thử nghiệm và quyền truy cập vào cơ sở dữ liệu đó? [Y/n] yTải lại bảng đặc quyền ngay bây giờ? [Y/n] y

Cài đặt PDF Converter​

Bạn cũng sẽ cần cài đặt wkhtmltopdf để chuyển đổi HTML thành PDF bằng công cụ kết xuất QT Webkit. Trước tiên, hãy cài đặt các phụ thuộc bắt buộc bằng lệnh sau:

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

Tiếp theo, tải xuống phiên bản mới nhất của wkhtmltopdf bằng lệnh sau:

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

Tiếp theo, giải nén tệp đã tải xuống vào thư mục /opt:

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

Tiếp theo, tạo liên kết mềm cho wkhtmltopdf bằng lệnh sau:

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

Cài đặt Bench​

Tiếp theo, bạn sẽ cần cài đặt Bench để cài đặt và quản lý ứng dụng ERPNext vào hệ thống của mình. Bench cũng được sử dụng để tạo và quản lý cấu hình Nginx và giám sát.

Trước khi cài đặt Bench, bạn sẽ cần thêm người dùng cho Bench.

Đầu tiên, tạo người dùng Bench bằng lệnh sau:

sudo adduser bench

Tiếp theo, cấp quyền sudo cho người dùng bench.

sudo usermod -aG sudo bench

Tiếp theo, đăng nhập bằng người dùng Bench và sao chép kho lưu trữ Bench bằng lệnh sau:

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

Cuối cùng, cài đặt Bench bằng lệnh pip:

sudo pip install -e bench-repo

Cài đặt ERPNext​

Tiếp theo, khởi tạo thư mục bench với frappe framework đã cài đặt.

bench init erpnext

Tiếp theo, hãy thay đổi thư mục thành erpnext và tạo một site Frappe mới bằng lệnh sau:

cd erpnext
bench new-site test.example.com

Lệnh trên sẽ yêu cầu cung cấp mật khẩu gốc MySQL và yêu cầu bạn đặt mật khẩu mới cho tài khoản quản trị viên. Mật khẩu quản trị viên sẽ cần phải đăng nhập vào bảng điều khiển quản trị viên sau.

Tiếp theo, tải xuống các tệp cài đặt ERPNext từ kho lưu trữ Git bằng lệnh sau:

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

Tiếp theo, Cài đặt ERPNext trên trang web mới tạo của bạn.

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

Cuối cùng, khởi động ứng dụng Bench bằng lệnh sau:

bench start

Sau khi ứng dụng khởi động thành công, bạn sẽ thấy đầu ra sau:

13:40:10 system | redis_socketio.1 đã bắt đầu (pid=2618)13:40:10 system | worker_long.1 đã bắt đầu (pid=2625)13:40:10 system | watch.1 đã bắt đầu (pid=2619)13:40:10 system | redis_queue.1 đã bắt đầu (pid=2626)13:40:10 redis_socketio.1 | 2630:M 24 tháng 2 13:40:10.939 * Tăng số lượng tệp mở tối đa lên 10032 (ban đầu được đặt thành 1024).13:40:10 system | web.1 đã bắt đầu (pid=2629)13:40:11 system | schedule.1 đã bắt đầu (pid=2634)13:40:10 redis_socketio.1 | _._13:40:10 redis_socketio.1 | _.-``__ ''-._13:40:10 redis_socketio.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit13:40:10 redis_socketio.1 | .-`` .-```. ```\/ _.,_ ''-._13:40:10 redis_socketio.1 | ( ' , .-` | `, ) Chạy ở chế độ độc lập13:40:10 redis_socketio.1 | |`-._`-...-` __...-.``-._|'` _.-'| Cảng: 1200013:40:10 redis_socketio.1 | | `-._ `._ / _.-' | PID: 263013:40:10 redis_socketio.1 | `-._ `-._ `-./ _.-' _.-'13:40:10 redis_socketio.1 | |`-._`-._ `-.__.-' _.-'_.-'|13:40:10 redis_socketio.1 | | `-._`-._ _.-'_.-' | http://redis.io13:40:10 redis_socketio.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:10 redis_socketio.1 | |`-._`-._ `-.__.-' _.-'_.-'|13:40:10 redis_socketio.1 | | `-._`-._ _.-'_.-' |13:40:10 redis_socketio.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:10 redis_socketio.1 | `-._ `-.__.-' _.-'13:40:10 redis_socketio.1 | `-._ _.-'13:40:10 redis_socketio.1 | `-.__.-'13:40:10 redis_socketio.1 |Hệ thống 13:40:11 | worker_default.1 đã bắt đầu (pid=2639)13:40:10 redis_socketio.1 | 2630:M 24 tháng 2 13:40:10.973 # CẢNH BÁO: Không thể áp dụng cài đặt TCP backlog là 511 vì /proc/sys/net/core/somaxconn được đặt thành giá trị thấp hơn là 128.13:40:10 redis_socketio.1 | 2630:M 24 tháng 2 13:40:10.974 # Máy chủ đã bắt đầu, Redis phiên bản 3.0.613:40:10 redis_socketio.1 | 2630:M 24 tháng 2 13:40:10.974 # CẢNH BÁO overcommit_memory được đặt thành 0! Lưu nền có thể không thành công trong điều kiện bộ nhớ thấp. Để khắc phục sự cố này, hãy thêm 'vm.overcommit_memory = 1' vào /etc/sysctl.conf rồi khởi động lại hoặc chạy lệnh 'sysctl vm.overcommit_memory=1' để lệnh này có hiệu lực.13:40:10 redis_socketio.1 | 2630:M 24 tháng 2 13:40:10.974 # CẢNH BÁO bạn đã bật hỗ trợ Transparent Huge Pages (THP) trong kernel của mình. Điều này sẽ tạo ra các sự cố về độ trễ và sử dụng bộ nhớ với Redis. Để khắc phục sự cố này, hãy chạy lệnh 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' với tư cách là root và thêm lệnh này vào /etc/rc.local của bạn để giữ nguyên cài đặt sau khi khởi động lại. Redis phải được khởi động lại sau khi THP bị tắt.13:40:10 redis_queue.1 | 2635:M 24 tháng 2 13:40:10.976 * Tăng số lượng tệp mở tối đa lên 10032 (ban đầu được đặt thành 1024).13:40:10 redis_queue.1 | _._13:40:10 redis_queue.1 | _.-``__ ''-._13:40:10 redis_queue.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit13:40:10 redis_queue.1 | .-`` .-```. ```\/ _.,_ ''-._13:40:10 redis_queue.1 | ( ' , .-` | `, ) Chạy ở chế độ độc lập13:40:10 redis_queue.1 | |`-._`-...-` __...-.``-._|'` _.-'| Cổng: 1100013:40:10 redis_queue.1 | | `-._ `._ / _.-' | PID: 263513:40:10 redis_queue.1 | `-._ `-._ `-./ _.-' _.-'13:40:10 redis_queue.1 | |`-._`-._ `-.__.-' _.-'_.-'|13:40:10 redis_queue.1 | | `-._`-._ _.-'_.-' | http://redis.io13:40:10 redis_queue.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:10 redis_queue.1 | |`-._`-._ `-.__.-' _.-'_.-'|13:40:10 redis_queue.1 | | `-._`-._ _.-'_.-' |13:40:10 redis_queue.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:10 redis_queue.1 | `-._ `-.__.-' _.-'13:40:10 redis_queue.1 | `-._ _.-'13:40:10 redis_queue.1 | `-.__.-'13:40:10 redis_queue.1 |13:40:10 redis_queue.1 | 2635:M 24 tháng 2 13:40:10.998 # CẢNH BÁO: Không thể áp dụng cài đặt tồn đọng TCP là 511 vì /proc/sys/net/core/somaxconn được đặt thành giá trị thấp hơn là 128.13:40:10 redis_queue.1 | 2635:M 24 tháng 2 13:40:10.999 # Máy chủ đã khởi động, Redis phiên bản 3.0.613:40:11 redis_queue.1 | 2635:M 24 tháng 2 13:40:11.000 # CẢNH BÁO overcommit_memory được đặt thành 0! Lưu nền có thể không thành công trong điều kiện bộ nhớ thấp. Để khắc phục sự cố này, hãy thêm 'vm.overcommit_memory = 1' vào /etc/sysctl.conf rồi khởi động lại hoặc chạy lệnh 'sysctl vm.overcommit_memory=1' để lệnh này có hiệu lực.13:40:11 redis_socketio.1 | 2630:M 24 tháng 2 13:40:11.000 * Máy chủ hiện đã sẵn sàng chấp nhận kết nối trên cổng 1200013:40:11 hệ thống | socketio.1 đã bắt đầu (pid=2637)13:40:11 redis_queue.1 | 2635:M 24 tháng 2 13:40:11.029 # CẢNH BÁO bạn đã bật hỗ trợ Transparent Huge Pages (THP) trong kernel của mình. Điều này sẽ tạo ra các vấn đề về độ trễ và sử dụng bộ nhớ với Redis. Để khắc phục sự cố này, hãy chạy lệnh 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' với tư cách là root và thêm lệnh này vào /etc/rc.local của bạn để giữ nguyên cài đặt sau khi khởi động lại. Redis phải được khởi động lại sau khi THP bị tắt.13:40:11 redis_queue.1 | 2635:M 24 tháng 2 13:40:11.029 * Máy chủ hiện đã sẵn sàng chấp nhận kết nối trên cổng 1100013:40:11 system | redis_cache.1 đã bắt đầu (pid=2652)13:40:11 system | worker_short.1 đã bắt đầu (pid=2651)13:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.100 * Tăng số lượng tệp mở tối đa lên 10032 (ban đầu được đặt thành 1024).13:40:11 redis_cache.1 | _._13:40:11 redis_cache.1 | _.-``__ ''-._13:40:11 redis_cache.1 | _.-`` `. `_. ''-._ Redis 3.0.6 (00000000/0) 64 bit13:40:11 redis_cache.1 | .-`` .-```. ```\/ _.,_ ''-._13:40:11 redis_cache.1 | ( ' , .-` | `, ) Đang chạy ở chế độ độc lập13:40:11 redis_cache.1 | |`-._`-...-` __...-.``-._|'` _.-'| Cổng: 1300013:40:11 redis_cache.1 | | `-._ `._ / _.-' | PID: 266013:40:11 redis_cache.1 | `-._ `-._ `-./ _.-' _.-'13:40:11 redis_cache.1 | |`-._`-._ `-.__.-' _.-'|13:40:11 redis_cache.1 | | `-._`-._ _.-'_.-' | http://redis.io13:40:11 redis_cache.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:11 redis_cache.1 | | `-._`-._ `-.__.-' _.-'_.-'|13:40:11 redis_cache.1 | | `-._`-._ _.-'_.-' |13:40:11 redis_cache.1 | `-._ `-._`-.__.-'_.-' _.-'13:40:11 redis_cache.1 | `-._ `-._`-.__.-' _.-'13:40:11 redis_cache.1 | `-._ _.-'13:40:11 redis_cache.1 | `-.__.-'13:40:11 redis_cache.1 |13:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.115 # CẢNH BÁO: Không thể áp dụng cài đặt tồn đọng TCP là 511 vì /proc/sys/net/core/somaxconn được đặt thành giá trị thấp hơn là 128.13:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.115 # Máy chủ đã khởi động, Redis phiên bản 3.0.613:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.115 # CẢNH BÁO overcommit_memory được đặt thành 0! Lưu nền có thể không thành công trong điều kiện bộ nhớ thấp. Để khắc phục sự cố này, hãy thêm 'vm.overcommit_memory = 1' vào /etc/sysctl.conf rồi khởi động lại hoặc chạy lệnh 'sysctl vm.overcommit_memory=1' để lệnh này có hiệu lực.13:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.116 # CẢNH BÁO bạn đã bật hỗ trợ Transparent Huge Pages (THP) trong kernel của mình. Điều này sẽ tạo ra các sự cố về độ trễ và sử dụng bộ nhớ với Redis. Để khắc phục sự cố này, hãy chạy lệnh 'echo never > /sys/kernel/mm/transparent_hugepage/enabled' với tư cách là root và thêm lệnh này vào /etc/rc.local của bạn để giữ nguyên cài đặt sau khi khởi động lại. Redis phải được khởi động lại sau khi THP bị vô hiệu hóa.13:40:11 redis_cache.1 | 2660:M 24 tháng 2 13:40:11.116 * Máy chủ hiện đã sẵn sàng chấp nhận kết nối trên cổng 1300013:40:16 socketio.1 | lắng nghe trên *: 900013:40:34 worker_long.1 | 13:40:34 Công nhân RQ u'rq:worker:Node1.2632.long' đã bắt đầu, phiên bản 0.10.013:40:34 worker_long.1 | 13:40:34 *** Đang lắng nghe trên long...13:40:34 worker_long.1 | 13:40:34 Đang dọn dẹp sổ đăng ký cho hàng đợi: long13:40:34 worker_default.1 | 13:40:34 Công nhân RQ u'rq:worker:Node1.2646.default' đã bắt đầu, phiên bản 0.10.013:40:34 worker_default.1 | 13:40:34 *** Đang lắng nghe trên default...13:40:34 worker_default.1 | 13:40:34 Đang dọn dẹp sổ đăng ký cho hàng đợi: default13:40:34 worker_short.1 | 13:40:34 Công nhân RQ u'rq:worker:Node1.2661.short' đã bắt đầu, phiên bản 0.10.013:40:34 worker_short.1 | 13:40:34 *** Đang lắng nghe trên short...13:40:34 worker_short.1 | 13:40:34 Đang dọn dẹp sổ đăng ký cho hàng đợi: short13:40:34 web.1 | * Đang chạy trên http://0.0.0.0:8000/ (Nhấn CTRL+C để thoát)

Truy cập Giao diện web ERPNext​

ERPNext hiện đã được cài đặt và chạy trên cổng 8000. Đã đến lúc truy cập Giao diện web ERPNext.

Mở trình duyệt web của bạn và nhập URL

http://test.exaple.com:8000

, bạn sẽ được chuyển hướng đến trang sau:



Tại đây, cung cấp thông tin xác thực tài khoản Quản trị viên của bạn và nhấp vào nút Đăng nhập, bạn sẽ thấy trang sau:



Tại đây, chọn ngôn ngữ tiếng Anh và nhấp vào nút Tiếp theo, bạn sẽ thấy trang sau:



Tại đây, chọn Quốc gia, Múi giờ và Tiền tệ của bạn, sau đó nhấp vào nút Tiếp theo, bạn sẽ thấy trang sau:



Tại đây, cung cấp Tên, Email và Mật khẩu của bạn, sau đó nhấp vào nút Tiếp theo, bạn sẽ thấy trang sau:



Tại đây, chọn Tên miền của bạn theo ý muốn, sau đó nhấp vào nút Tiếp theo, bạn sẽ thấy trang sau:



Tại đây, hãy cung cấp Tên công ty và tên viết tắt của bạn, sau đó nhấp vào nút Tiếp theo, bạn sẽ thấy trang sau:



Tại đây, hãy cung cấp thông tin chi tiết về Tổ chức của bạn và nhấp vào nút Hoàn tất thiết lập, bạn sẽ thấy trang sau:





Tại đây, hãy đặt mục tiêu bạn muốn đạt được cho Công ty của mình, sau đó nhấp vào nút Tạo, bạn sẽ thấy trang sau:



Tại đây, hãy nhấp vào nút Tiếp theo để tiếp tục, bạn sẽ thấy trang sau:



Tại đây, hãy thêm khách hàng bạn muốn thêm, sau đó nhấp vào nút Tạo, bạn sẽ thấy trang sau:



Tại đây, nhấp vào nút Tiếp theo để tiếp tục, bạn sẽ thấy trang sau:



Tại đây, thêm nhà cung cấp mà bạn muốn thêm, sau đó nhấp vào nút Tạo, bạn sẽ thấy trang sau:



Tại đây, nhấp vào nút Tiếp theo để tiếp tục, bạn sẽ thấy trang sau:



Tại đây, thêm sản phẩm và dịch vụ mà bạn muốn mua hoặc bán, sau đó nhấp vào nút Tạo, bạn sẽ thấy trang sau:



Tại đây, nhấp vào nút Tiếp theo để tiếp tục, bạn sẽ thấy trang sau:



Tại đây, hãy thêm người dùng vào tổ chức của bạn, sau đó nhấp vào nút Create, bạn sẽ thấy bảng điều khiển ERPNext ở trang sau:

Kết luận​

Xin chúc mừng! bạn đã cài đặt và cấu hình ERPNext thành công trên máy chủ Debian 9. Bây giờ bạn có thể dễ dàng sử dụng ứng dụng để quản lý công ty của mình. Để biết thêm thông tin, vui lòng tham khảo trang tài liệu ERPNext chính thức tại Doc.