Как установить ERPNext на Ubuntu 20.04 LTS

ERPNext — это бесплатное и открытое ERP-программное обеспечение, созданное с использованием Python, JavaScript и Frappe Framework. Это современная, простая в использовании бесплатная бизнес-система, используемая производителями, дистрибьюторами и сервисами. Она предназначена для малых и средних предприятий, которые помогают компаниям управлять всеми аспектами их бизнес-операций. Это одно из лучших открытых ERP-управляющих программ, используемое тысячами компаний по всему миру для управления своими ERP-процессами.

В этом руководстве я объясню, как установить ERPNext на сервер Ubuntu 20.04.

Предварительные требования

Сервер с установленной Ubuntu 20.04.
Действующий домен, указывающий на ваш сервер.
Настроенный пароль root на вашем сервере.

Начало работы

Перед началом вам нужно будет установить необходимые зависимости Python в вашей системе. Вы можете установить их все с помощью следующей команды:

apt-get install python3-dev libffi-dev git python3-pip python3-testresources libssl-dev wkhtmltopdf gcc g++ make -y

После установки зависимостей Python ERPNext также использует Node.js для своего фронтенда. Поэтому добавьте репозиторий Node.js с помощью следующей команды:

curl -sL https://deb.nodesource.com/setup_12.x | bash -

Затем установите Node.js и сервер Redis с помощью следующей команды:

apt-get install nodejs redis-server -y

После установки обоих пакетов установите пакет Yarn, выполнив следующую команду:

npm install -g yarn

Когда вы закончите, вы можете перейти к следующему шагу.

Установка и настройка базы данных MariaDB

По умолчанию MariaDB доступна в стандартном репозитории Ubuntu 20.04. Вы можете установить его с помощью следующей команды:

apt-get install mariadb-server -y

После установки защитите MariaDB и установите пароль root для MariaDB с помощью следующей команды:

mysql_secure_installation

Ответьте на все вопросы, как показано ниже, чтобы установить пароль root для MariaDB и защитить установку:

Введите текущий пароль для root (нажмите Enter для отсутствия):
Установить пароль root? [Y/n] Y
Новый пароль:
Повторите новый пароль:
Удалить анонимных пользователей? [Y/n] Y
Запретить удаленный вход root? [Y/n] Y
Удалить тестовую базу данных и доступ к ней? [Y/n] Y
Перезагрузить таблицы привилегий сейчас? [Y/n] Y

После защиты MariaDB войдите в консоль MariaDB с помощью следующей команды:

mysql -u root -p

Затем измените плагин аутентификации MariaDB с помощью следующей команды:

MariaDB [(none)]>USE mysql;  
MariaDB [(none)]>UPDATE user SET plugin='mysql_native_password' WHERE User='root';

Затем сбросьте привилегии и выйдите из оболочки MariaDB с помощью следующей команды:

MariaDB [(none)]> FLUSH PRIVILEGES;  
MariaDB [(none)]> EXIT;

Далее вам нужно будет изменить формат файла Innodb MariaDB на Barracuda. Вы можете сделать это, отредактировав файл /etc/mysql/mariadb.conf.d/50-server.cnf:

nano /etc/mysql/mariadb.conf.d/50-server.cnf

Добавьте / измените следующие строки:

[mysqld]
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

[mysql]
default-character-set = utf8mb4

Сохраните и закройте файл, затем перезапустите службу MariaDB, чтобы применить изменения:

systemctl restart mariadb

Установка ERPNext

В этом разделе мы покажем вам, как создать пользователя ERPNext, установить инструмент bench и установить ERPNext в вашей системе.

Создание пользователя ERPNext

Сначала создайте нового пользователя для запуска ERPNext с помощью следующей команды:

useradd -m -s /bin/bash erpnext

Затем установите пароль для ERPNext с помощью следующей команды:

passwd erpnext

Затем добавьте пользователя ERPNext в группу sudo с помощью следующей команды:

usermod -aG sudo erpnext

Затем войдите в пользователя ERPNext и настройте переменную окружения с помощью следующей команды:

su - erpnext  
nano ~/.bashrc

Добавьте следующую строку:

PATH=$PATH:~/.local/bin/

Сохраните файл, затем активируйте переменную окружения с помощью следующей команды:

source ~/.bashrc

Установка инструмента Bench

Сначала переключитесь в директорию пользователя ERPNext и создайте директорию для ERPNext с помощью следующей команды:

su - erpnext  
sudo mkdir /opt/bench

Затем установите право собственности на пользователя erpnext:

sudo chown -R erpnext:erpnext /opt/bench

Затем измените директорию на /opt/bench и клонируйте репозиторий bench с Git Hub:

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

Затем установите репозиторий bench с помощью команды pip3:

pip3 install -e bench-repo

После установки инициализируйте директорию bench с помощью фреймворка frappe с помощью следующей команды:

bench init erpnext

Вы должны получить следующий вывод:

? Built js/checkout.min.js
? Built js/dialog.min.js
? Built js/social.min.js
? Built js/web_form.min.js
? Built js/list.min.js
? Built js/chat.js
Browserslist: caniuse-lite is outdated. Please run next command `yarn upgrade caniuse-lite browserslist`
? Built css/frappe-rtl.css
? Built css/printview.css
? Built js/bootstrap-4-web.min.js
? Built js/barcode_scanner.min.js
? Built css/list.min.css
? Built css/report.min.css
? Built frappe/css/email.css
? Built js/frappe-recorder.min.js
? Built js/desk.min.js
? Built css/frappe-chat-web.css
? Built js/frappe-web.min.js
? Built css/form.min.css
? Built css/web_form.css
? Built css/desk.min.css
? Built css/frappe-web-b4.css
? Built js/control.min.js
? Built js/form.min.js
? Built js/data_import_tools.min.js
? Built js/report.min.js
?  Done in 111.35s
Done in 113.33s.
SUCCESS: Bench erpnext initialized

Создание сайта ERPNext

Затем измените директорию на erpnext и создайте новый сайт ERPNext с помощью следующей команды:

cd /opt/bench/erpnext  
bench new-site erp.linuxbuz.com

Вам будет предложено ввести пароль root для MariaDB и пароль администратора, как показано ниже:

MySQL root password: 

Установка frappe...
Обновление DocTypes для frappe        : [========================================] 100%
Обновление информации о стране               : [========================================] 100%
Установите пароль администратора: 
Повторите пароль администратора: 
* Планировщик отключен *
Текущий сайт установлен на erp.linuxbuz.com

На этом этапе ERPNext установлен в вашей системе.

Настройка ERPNext для производственной среды

Затем вам нужно будет установить Supervisor для управления процессом ERPNext и Nginx в качестве обратного прокси.

Сначала переключитесь на пользователя ERPNext и установите Supervisor и Nginx с помощью следующей команды:

su - erpnext  
sudo apt-get install supervisor nginx -y

Затем установите frappe-bench с помощью следующей команды:

sudo pip3 install frappe-bench

Затем измените директорию на /opt/bench/erpnext и настройте ERPNext для производственной среды с помощью следующей команды:

cd /opt/bench/erpnext  
sudo /home/erpnext/.local/bin/bench setup production erpnext

После настройки ERPNext вы должны увидеть следующий вывод:

PLAY RECAP ************************************************************************************************************************************
localhost                  : ok=8    changed=4    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   

$ sudo systemctl restart supervisor
Список конфигурации портов:

Сайт erp.linuxbuz.com назначен порт: 80
$ /usr/bin/supervisorctl reread
Нет обновлений конфигурации для процессов
$ /usr/bin/supervisorctl update
$ sudo /usr/sbin/nginx -t
nginx: конфигурационный файл /etc/nginx/nginx.conf синтаксически верен
nginx: тест конфигурационного файла /etc/nginx/nginx.conf успешен
$ sudo systemctl reload nginx

На этом этапе ERPNext настроен с Nginx для производственной среды.

Доступ к веб-интерфейсу ERPNext

Теперь откройте веб-браузер и введите URL http://erp.linuxbuz.com. Вы будете перенаправлены на страницу входа в ERPNext:

Укажите имя пользователя как Administrator и пароль, который вы установили ранее, и нажмите кнопку Войти. Вы должны увидеть следующую страницу:

Выберите желаемый язык и нажмите кнопку Далее. Вы должны увидеть следующую страницу:

Выберите свою страну, часовой пояс, валюту и нажмите кнопку Далее. Вы должны увидеть следующую страницу:

Укажите свое имя, адрес электронной почты, пароль и нажмите кнопку Завершить настройку. Вы должны увидеть панель управления ERPNext на следующей странице:

Защита ERPNext с помощью Let’s Encrypt SSL

Сначала вам нужно будет установить клиент Certbot для установки и управления SSL Let’s Encrypt. Вы можете установить его с помощью следующей команды:

sudo apt-get install certbot python3-certbot-nginx -y

После установки выполните следующую команду, чтобы установить и настроить SSL Let’s Encrypt для вашего домена:

sudo certbot --nginx -d erp.linuxbuz.com

Вам будет предложено ввести ваш адрес электронной почты и принять условия обслуживания, как показано ниже:

Сохранение журнала отладки в /var/log/letsencrypt/letsencrypt.log
Выбранные плагины: Аутентификатор nginx, Установщик nginx
Введите адрес электронной почты (используется для срочного обновления и уведомлений о безопасности) (Введите 'c' для отмены): [email protected]

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Пожалуйста, прочитайте Условия обслуживания по адресу
https://letsencrypt.org/documents/LE-SA-v1.2-November-15-2017.pdf. Вы должны
согласиться, чтобы зарегистрироваться на сервере ACME по адресу
https://acme-v02.api.letsencrypt.org/directory
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(A)gree/(C)ancel: A

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Вы бы хотели поделиться своим адресом электронной почты с Electronic Frontier
Foundation, основным партнером проекта Let's Encrypt и некоммерческой
организацией, разрабатывающей Certbot? Мы хотели бы отправить вам электронное письмо о нашей работе
по шифрованию веба, новостях EFF, кампаниях и способах поддержки цифровой свободы.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
(Y)es/(N)o: Y
Получение нового сертификата
Выполнение следующих задач:
http-01 задача для erp.linuxbuz.com
Ожидание проверки...
Очистка задач
Развертывание сертификата на VirtualHost /etc/nginx/conf.d/erpnext.conf

Затем выберите, хотите ли вы перенаправить HTTP-трафик на HTTPS, как показано ниже:

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
1: Нет перенаправления - Не вносить дальнейшие изменения в конфигурацию веб-сервера.
2: Перенаправить - Сделать все запросы перенаправленными на безопасный доступ HTTPS. Выберите это для
новых сайтов или если вы уверены, что ваш сайт работает на HTTPS. Вы можете отменить это
изменение, отредактировав конфигурацию вашего веб-сервера.
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Выберите соответствующий номер [1-2], а затем [введите] (нажмите 'c' для отмены): 2

Введите 2 и нажмите Enter, чтобы завершить процесс. Вы должны увидеть следующий вывод:

Перенаправление всего трафика на порт 80 на ssl в /etc/nginx/conf.d/erpnext.conf

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Поздравляем! Вы успешно включили https://erp.linuxbuz.com

Вы должны протестировать свою конфигурацию на:
https://www.ssllabs.com/ssltest/analyze.html?d=erp.linuxbuz.com
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

ВАЖНЫЕ ЗАМЕТКИ:
 - Поздравляем! Ваш сертификат и цепочка были сохранены по адресу:
   /etc/letsencrypt/live/erp.linuxbuz.com/fullchain.pem
   Ваш файл ключа был сохранен по адресу:
   /etc/letsencrypt/live/erp.linuxbuz.com/privkey.pem
   Ваш сертификат истечет 2020-08-29. Чтобы получить новую или измененную
   версию этого сертификата в будущем, просто снова запустите certbot
   с опцией "certonly". Чтобы неинтерактивно обновить *все*
   ваши сертификаты, выполните "certbot renew"
 - Ваши учетные данные аккаунта были сохранены в вашей конфигурационной директории Certbot
   по адресу /etc/letsencrypt. Вам следует сделать
   безопасную резервную копию этой папки сейчас. Эта конфигурационная директория также будет
   содержать сертификаты и закрытые ключи, полученные Certbot, поэтому
   регулярное создание резервных копий этой папки является идеальным.
 - Если вам нравится Certbot, пожалуйста, подумайте о поддержке нашей работы:

   Пожертвование ISRG / Let's Encrypt:   https://letsencrypt.org/donate
   Пожертвование EFF:                    https://eff.org/donate-le

 - Мы не смогли подписать вас на список рассылки EFF, потому что ваш
   адрес электронной почты, похоже, недействителен. Вы можете попробовать снова позже, посетив https://act.eff.org.

На этом этапе ваш сайт ERPNext защищен с помощью Let’s Encrypt SSL. Теперь вы можете безопасно получить доступ к вашему сайту с помощью протокола HTTPS.

Заключение

В этом руководстве мы узнали, как установить ERPNext с Nginx на Ubuntu 20.04. Мы также узнали, как защитить ERPNext с помощью Let’s Encrypt SSL. Вы можете посетить страницу документации ERPNext для получения дополнительной информации.