Установка комплекса ERPNext в Ubuntu 18.04

ERPNext — это набор планирования ресурсов предприятия (Enterprise Resource Planning, ERP), который позволяет использовать производительность и гибкость технологий с открытым кодом. Он отлично справляется с такими бизнес-процессами, как финансы, продажи, человеческие ресурсы, производство, снабжение, обслуживание, служба поддержки и многое другое. В числе преимуществ внедрения системы, как ERPNext, можно отметить следующее:

• Повышение производительности за счет автоматизации повторяющихся рабочих процессов
• Повышение эффективности ИТ путем совместного использования базы данных всеми подразделениями компании
• Оптимизация принятия решения благодаря комплексному видению взаимосвязи между структурными единицами

ERPNext создан на базе Frappe, платформы комплексной разработки веб-приложений, написанной на Python, со всеми преимуществами среды выполнения Node/JavaScript и использует MariaDB в качестве сервера базы данных. Одним из многих преимуществ приложений на базе Frappe, в том числе ERPNext, является утилита командной строки bench. CLI bench экономит время администратора за счет автоматизации таких задач, как установка, обновление, настройка и управление многочисленными сайтами Frappe/ERPNext.

В этом обучающем модуле мы установим и настроим комплекс ERPNext на одном сервере под управлением Ubuntu 18.04. Это позволит вам настроить стек для различных сред разработки или производства в зависимости от ваших потребностей и подготовит вас к созданию более сложной отказоустойчивой архитектуры.

• Один сервер Ubuntu 18.04 с не менее 4 Гбайт оперативной памяти и пользователем sudo без прав root. Настроить сервер и пользователя можно с помощью нашего руководства по первоначальной настройке сервера Ubuntu 18.04.

• Зарегистрированное полное доменное имя с записью A, указывающее на ваш сервер. Если вы используете дроплет DigitalOcean, воспользуйтесь этим руководством для надлежащей настройки DNS. В этом обучающем руководстве мы будем использовать your_domain.

Хотя настройка брандмауэра для разработки опциональна, для производства она является обязательной с точки зрения безопасности.

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

• 80/tcp и 443/tcp для HTTP и HTTPS соответственно
• 3306/tcp для подключения MariaDB (рекомендуется только при необходимости удаленного доступа к базе данных)
• 143/tcp и 25/tcp для IMAP и STMP соответственно
• 22/tcp для SSH (если вы еще не включили OpenSSH)
• 8000/tcp для тестирования разработки перед развертыванием вашего сайта

Чтобы сразу открыть несколько портов можно использовать следующую команду:

sudo ufw allow 22,25,143,80,443,3306,8000/tcp

Также можно разрешить подключения с определенных IP-адресов на конкретных портах с помощью этой команды:

sudo ufw allow from server_IP to any port port_number

После открытия всех необходимых портов активируйте брандмауэр:

sudo ufw enable

После активации брандмауэра проверьте статус открытых портов:

sudo ufw status

Дополнительную информацию о настройке брандмауэра можно найти в нашем руководстве «Настройка брандмауэра с UFW в Ubuntu 18.04».

Настройка соответствующего брандмауэра — это первый из двух предварительных шагов. Теперь мы настроим раскладку клавиатуры и кодирование символов на вашем сервере.

Настоятельно рекомендуется настроить раскладку клавиатуры для консоли, а также язык и кодирование символов на вашем хосте. Это необходимо, чтобы избежать возможных проблем во время установки ERPNext 12. Обратите внимание, что эта конфигурация не имеет никакого отношения к языку пользовательского интерфейса на вашей фактической платформе ERPNext, а служит для конфигурации локальных настроек системы.

Сначала обновите ваш сервер:

sudo apt update

Теперь настройте раскладку клавиатуры, язык и кодирование символов:

sudo localectl set-keymap us && sudo localectl set-locale LANG=en_US.utf8

Утилита localectl используется Ubuntu 18.04 и другими дистрибутивами Linux для контроля и изменения языковых настроек всей системы, а также настроек раскладки клавиатуры перед входом пользователя, что требует ERPNext 12.

Также вам потребуется добавить следующие строки в файл /etc/environment. Используйте nano или предпочитаемый текстовый редактор, чтобы открыть файл:

sudo nano /etc/environment

Добавьте в него следующее содержание:

LC_ALL=en_US.UTF-8
LC_CTYPE=en_US.UTF-8
LANG=en_US.UTF-8

Сохраните и закройте файл.

Перезагрузите ваш сервер для внесения всех изменений:

sudo reboot

Дайте своему серверу несколько минут на перезагрузку, а затем снова выполните вход через ssh. Теперь вы готовы установить свою базу данных.

Теперь добавьте MariaDB в стек сервера. Для работы ERPNext 12 требуется версия MariaDB 10.2 или выше, однако в официальный репозиторий Ubuntu 18.04 входит версия 10.1, то есть вам нужно будет самостоятельно установить нужную версию. В этом обучающем модуле мы будем использовать последнюю стабильную версию MariaDB (версия 10.4 на момент написания этого документа).

Для установки MariaDB 10.4 в Ubuntu 18.04 вам нужно будет добавить соответствующий ключ подписи и репозиторий. Эту информацию можно найти в мастере репозитория MariaDB Foundation. Откройте этот URL-адрес в браузере. В разделе 1. Choose a Distro нажмите Ubuntu. Откроется второй столбец с заголовком 2. Choose a Release. Нажмите под этим заголовком 18.04 LTS “bionic”. Появится третий столбец с заголовком 3.Choose a Version. Под этим столбцом нажмите 10.4 stable. Появится еще один столбец с заголовком 4.Choose a Mirror. Выберите зеркало в зависимости от вашего расположения, и MariaDB заполнит необходимые команды для выбранной установки.

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

sudo apt-get install software-properties-common && sudo apt-key adv --fetch-keys 'https://mariadb.org/mariadb_release_signing_key.asc' && sudo add-apt-repository 'deb [arch=amd64,arm64,ppc64el] http://mirror.klaus-uwe.me/mariadb/repo/10.4/ubuntu bionic main'

После добавления репозитория выполните установку MariaDB:

sudo apt install mariadb-server

После установки mariadb-server установите следующие пакеты:

sudo apt install libmysqlclient-dev python3-mysqldb

ERPNext 12 — приложение Python, и ему требуется библиотека python3-mysqldb для управления базами данных. Пакеты libmysqlclient-dev, mariadb-client и libmariadbclient18 позволяют пользователям взаимодействовать со службой MariaDB, а ntpdate и libdate-manip-perl используются ERPNext для синхронизации времени сервера.

Затем добавьте базовый уровень безопасности на сервер MariaDB, запустив скрипт mysql_secure_installation:

sudo mysql_secure_installation

Скрипт mysql_secure_installation будет давать подсказки с помощью вопросов:

• В первом диалоговом окне вам будет предложено ввести пароль root, но так как пароль еще не задан, нажмите ENTER.
• Затем вам нужно будет решить, будете ли вы использовать аутентификацию Unix. Ответьте Y, чтобы принять этот метод аутентификации.
• Когда вам будет предложено изменить пароль пользователя root для MariaDB, ответьте N. Использование пароля по умолчанию с аутентификацией Unix рекомендуется для систем на базе Ubuntu, потому что учетная запись root тесно связана с автоматическими задачами по обслуживанию системы.
• Оставшиеся вопросы будут связаны с удалением анонимного пользователя базы данных для ограничения возможности входа в учетную запись root дистанционно на localhost, удалением тестовой базы данных и перезагрузкой таблиц привилегий. На эти вопросы можно спокойно ответить Y.

После завершения выполнения скрипта mysql_secure_installation MariaDB начнет запуск с использованием настройки по умолчанию. Для стандартной установки ERPNext используется пользователь root для всех операций базы данных. Хотя этот подход может быть удобен для настроек одного сервера, он не является оптимальным с точки зрения безопасности. Поэтому в следующем разделе вы узнаете, как избежать этой проблемы путем создания нового пользователя со специальными привилегиями.

sudo mysql

CREATE DATABASE sammy;

SHOW DATABASES;

Output
+--------------------+
| Database           |
+--------------------+
| information_schema |
| mysql              |
| performance_schema |
| sammy             |
+--------------------+

GRANT ALL PRIVILEGES ON *.* TO 'sammy'@'%' IDENTIFIED BY 'mariadb_password' WITH GRANT OPTION;

SELECT host, user, Super_priv FROM mysql.user;

Output
+-----------+-------+------------+
| Host      | User  | Super_priv |
+-----------+-------+------------+
| localhost | root  | Y          |
| localhost | mysql | Y          |
| %         | sammy | Y          |
+-----------+-------+------------+
3 rows in set (0.001 sec)

FLUSH PRIVILEGES;

exit

После установки и обеспечения безопасности MariaDB пришло время для отладки подключений ERPNext.

Сначала остановите mariadb.service:

sudo systemctl stop mariadb

Теперь с помощью nano или вашего любимого текстового редактора создайте файл конфигурации MariaDB под названием settings.cnf:

sudo nano /etc/mysql/conf.d/settings.cnf

Добавьте шаблон конфигурации ERPNext:

[mysqld]

# GENERAL #
user                           = mysql
default-storage-engine         = InnoDB
socket                         = /var/lib/mysql/mysql.sock
pid-file                       = /var/lib/mysql/mysql.pid

# MyISAM #
key-buffer-size                = 32M
myisam-recover                 = FORCE,BACKUP

# SAFETY #
max-allowed-packet             = 256M
max-connect-errors             = 1000000
innodb                         = FORCE

# DATA STORAGE #
datadir                        = /var/lib/mysql/

# BINARY LOGGING #
log-bin                        = /var/lib/mysql/mysql-bin
expire-logs-days               = 14
sync-binlog                    = 1

# REPLICATION #
server-id                      = 1

# CACHES AND LIMITS #
tmp-table-size                 = 32M
max-heap-table-size            = 32M
query-cache-type               = 0
query-cache-size               = 0
max-connections                = 500
thread-cache-size              = 50
open-files-limit               = 65535
table-definition-cache         = 4096
table-open-cache               = 10240

# INNODB #
innodb-flush-method            = O_DIRECT
innodb-log-files-in-group      = 2
innodb-log-file-size           = 512M
innodb-flush-log-at-trx-commit = 1
innodb-file-per-table          = 1
innodb-buffer-pool-size        = 5462M
innodb-file-format             = barracuda
innodb-large-prefix            = 1
collation-server               = utf8mb4_unicode_ci
character-set-server           = utf8mb4
character-set-client-handshake = FALSE
max_allowed_packet             = 256M

# LOGGING #
log-error                      = /var/lib/mysql/mysql-error.log
log-queries-not-using-indexes  = 0
slow-query-log                 = 1
slow-query-log-file            = /var/lib/mysql/mysql-slow.log

[mysql]
default-character-set = utf8mb4

[mysqldump]
max_allowed_packet=256M

!includedir /etc/mysql/mariadb.conf.d/

Сохраните и закройте файл. Для получения дополнительной информации об этих настройках посмотрите этот файл шаблона в репозитории ERPNext Github. Это полезное начало для изучения этих опций.

Создайте еще один файл с именем erpnext.cnf:

sudo nano /etc/mysql/mariadb.conf.d/erpnext.cnf

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

[mysqld]
pid-file        = /var/run/mysqld/mysqld.pid
socket          = /var/run/mysqld/mysqld.sock
bind-address    = 0.0.0.0

Первый файл, /etc/mysql/conf.d/settings.cnf, дополняет и перезаписывает несколько значений, включенных по умолчанию в конфигурацию MariaDB, расположенную в файле /etc/mysql/my.cnf. Этот файл дает вам шаблон с рекомендациями, который значительно повышает производительность базы данных для ERPNext. Хотя этот шаблон является отличным началом, ничто не мешает вам еще больше повысить производительность MariaDB, настроив эти параметры в соответствии с вашими потребностями.

Второй файл, /etc/mysql/mariadb.conf.d/erpnext.cnf, также перезаписывает некоторые значения, добавляя конкретную информацию по подключению вашей базы данных.

sudo systemctl start mariadb

mysql --user sammy --password mariadb_password --host=localhost --protocol=tcp --port=3306 test

Output
mysql  Ver 15.1 Distrib 10.4.13-MariaDB, for debian-linux-gnu (x86_64) using readline 5.2
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Usage: mysql [OPTIONS] [database]

Default options are read from the following files in the given order:
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf

...

  --ssl-verify-server-cert
                      Verify server's "Common Name" in its cert against
                      hostname used when connecting. This option is disabled by
                      default.
  -t, --table         Output in table format.
  --tee=name          Append everything into outfile. See interactive help (\h)
                      also. Does not work in batch mode. Disable with
                      --disable-tee. This option is disabled by default.
  -u, --user=name     User for login if not current user.
  -U, --safe-updates  Only allow UPDATE and DELETE that uses keys.
  -U, --i-am-a-dummy  Synonym for option --safe-updates, -U.
  -v, --verbose       Write more. (-v -v -v gives the table output format).

...

max-join-size                     1000000
secure-auth                       FALSE
show-warnings                     FALSE
plugin-dir                        (No default value)
default-auth                      (No default value)
binary-mode                       FALSE
connect-expired-password          FALSE

sudo systemctl restart mariadb

sudo systemctl enable mariadb

Теперь, после подготовки серверной части вашей базы данных, можно продолжить настройку вашего веб-приложения ERPNext. В этом разделе вы узнаете, как установить и выполнить настройку всех компонентов, необходимых для ERPNext 12, и затем установить непосредственно приложение.

Начните с подготовки сервера с помощью всех системных пакетов, необходимых для ERPNext 12. Установите общесистемные зависимости с помощью следующей команды:

 sudo DEBIAN_FRONTEND=noninteractive apt install -y curl build-essential mariadb-client python3-setuptools python3-dev libffi-dev python3-pip libcurl4 dnsmasq fontconfig git htop libcrypto++-dev libfreetype6-dev liblcms2-dev libwebp-dev libxext6 libxrender1 libxslt1-dev libxslt1.1 libffi-dev ntpdate postfix python3-dev python-tk screen vim xfonts-75dpi xfonts-base zlib1g-dev apt-transport-https libsasl2-dev libldap2-dev libcups2-dev pv libjpeg8-dev libtiff5-dev tcl8.6-dev tk8.6-dev libssl1.0-dev python3-mysqldb libdate-manip-perl logwatch

Переменная DEBIAN_FRONTEND=noninteractive была передана в команду установки для отключения подсказок Postfix. Для получения подробной информации о настройке Postfix ознакомьтесь с нашим руководством Установка и настройка Postfix в Ubuntu 18.04

Выполните обновление pip3 и установите последние версии трех дополнительных модулей Python, которые требуются ERPNext:

 sudo -H python3 -m pip install --upgrade setuptools cryptography psutil

Теперь, после установки всех необходимых глобальных зависимостей, вы установите все службы и библиотеки, необходимые для ERPNext 12.

curl -sL https://deb.nodesource.com/setup_12.x -o nodesource_setup.sh

sudo nano nodesurce_setup.sh

sudo bash nodesource_setup.sh

sudo apt install nodejs

sudo npm install -g yarn

cd /tmp

wget https://github.com/wkhtmltopdf/wkhtmltopdf/releases/download/0.12.5/wkhtmltox_0.12.5-1.bionic_amd64.deb

sudo dpkg -i wkhtmltox_0.12.5-1.bionic_amd64.deb

sudo cp /usr/local/bin/wkhtmlto* /usr/bin/

sudo chmod a+x /usr/bin/wk*

sudo apt install redis-server

sudo systemctl enable redis-server

Теперь, когда вы установили все требования стека ERPNext, вы можете свободно пользоваться возможностями утилиты командной строки bench. CLI bench была разработана для оказания помощи пользователям в процессе установки, настройки и управления такими приложениями, как ERPNext, которые созданы на базе каркаса Frappe Framework. В следующих разделах вы установите CLI bench для дальнейшего использования при выполнении настройки ERPNext 12.

Убедитесь, что пользователь Frappe (в данном случае sammy) имеет соответствующие права в своем каталоге home:

sudo chown sammy -R /home/sammy

Теперь клонируйте репозиторий frappe/bench в свой домашний каталог. Не забудьте заменить sammy вашим именем пользователя системы:

git clone https://github.com/frappe/bench /home/sammy/.bench --depth 1 --branch master

Установите CLI bench:

sudo pip3 install -e /home/sammy/.bench

В данном руководстве предполагается, что вы устанавливаете ERPNext 12 для сценариев тестирования/производства и поэтому используете ветку master. Но если вы намерены разрабатывать приложения или пользовательские модули ERPNext, лучше выбрать ветку develop. В любом случае вы готовы к установке каркаса Frappe Framework. Это последнее действие перед установкой непосредственно ERPNext.

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

bench init /home/sammy/frappe-bench --frappe-path https://github.com/frappe/frappe --frappe-branch version-12 --python python3

Output
...
Done in 82.23s.
INFO:bench.utils:setting up backups
no crontab for sammy
SUCCESS: Bench /home/sammy/frappe-bench initialized

В этом разделе вы настроите сайт на базе Frappe, а затем установите на нем приложение ERPNext 12.

Перейдите в каталог, где был инициирован Frappe.

cd /home/sammy/frappe-bench

Загрузите ERPNext 12 из репозитория с помощью инструмента командной строки bench:

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

Затем создайте новый сайт, заменив your_domain на домен, который вы связали с IP-адресом этого сервера:

bench new-site your_domain --admin-password 'erpnext_admin_password' --mariadb-root-username sammy --mariadb-root-password 'mariadb_password'

Давайте рассмотрим опции, используемые в команде выше:

• bench new-site создает новый сайт на базе каркаса Frappe Framework.
• your_domain — это имя нового сайта. Убедитесь, что DNS вашего домена имеет запись A, указывающую на IP-адрес вашего сервера.
• erpnext_admin_password — желаемый пароль для пользователя-администратора ERPNext. Сохраните этот пароль в надежном месте, он вскоре вам понадобится.
• mariadb_password — это пароль, который вы создали в начале руководства для пользователя sammy MariaDB.

Затем установите приложение ERPNext на сайт:

bench --site your_domain install-app erpnext

По завершении установки вы получите работающее приложение ERPNext 12. Теперь протестируем его с помощью команды bench:

bench start

Команда выше инициализирует консоль мониторинга в реальном времени, на которой будут отображаться различные сообщения о веб-сервере и других службах. Откройте веб-браузер и перейдите к localhost:8000 (для локальных установок) или your_domain:8000 (если вы используете удаленный сервер). Вы увидите экран входа ERPNext (мы перейдем к входу и настройке позже, после подготовки нашего сайта к производству).

После просмотра тестового развертывания вернитесь в свой терминал и нажмите CTRL+C. Это остановит ERPNext и закроет консоль мониторинга.

Если ваша главная задача — создать модули или модифицировать ERPNext 12, можно остановиться на данном этапе. Компоненты для разработки больше не требуются. Однако, если вам нужна готовая система для производства, для которой не требуется ручная инициализация, необходимо установить и настроить еще несколько компонентов. Это ваш следующий шаг.

Хотя приложение ERPNext 12 уже готово, система еще не готова к использованию в производственной среде. Чтобы обеспечить надежность и безопасность ERPNext, необходимо подключить несколько дополнительных служб:

• Fail2ban обеспечивает дополнительный слой защиты от попыток грубого вмешательства со стороны злоумышленников и ботов.
• Nginx в основном работает как прокси-сервер и перенаправляет весь трафик с порта 8000 в порт 80 (HTTP) или порт 443 (HTTPS)
• Supervisor следит за постоянным выполнением ключевых процессов ERPNext и при необходимости перезапускает их.

К этому моменту вы установили и настроили вручную ERPNext 12, что позволило вам отрегулировать процесс под ваш конкретный сценарий использования. Тем не менее для остальной части производственной настройки можно воспользоваться удобством CLI bench и автоматизировать установку и настройку остальных служб.

Убедитесь, что вы находитесь в рабочем каталоге Frappe:

cd /home/sammy/frappe-bench

Теперь используйте следующую команду для завершения настройки ERPNext 12 для производства:

sudo bench setup production sammy --yes

Команда выше установит и настроит Nginx, Supervisor и Fail2Ban установит sammy в качестве владельца среды производства.

Файлы конфигурации, созданные командой bench:

• Два файла конфигурации Nginx, расположенные в /etc/nginx/nginx.conf и /etc/nginx/conf.d/frappe-bench.conf
• Один прокси-изолятор Fail2Ban, расположенный в /etc/fail2ban/jail.d/nginx-proxy.conf и один фильтр, расположенный в /etc/fail2ban/filter.d/nginx-proxy.conf

Этих настроек по умолчанию достаточно для целей нашего обучающего модуля, но вы можете свободно изучать эти файлы и подстраивать их под свои нужды.

sudo supervisorctl stop all

And then, once you are ready, you can restart your services:

sudo supervisorctl start all

Now you are ready to test your installation.

systemctl list-unit-files | grep 'fail2ban\|nginx\|supervisor'

Output
fail2ban.service                       enabled
nginx.service                          enabled
supervisor.service                     enabled

Теперь, когда вы соответствующим образом установили приложение ERPNext 12, возможно, вы захотите начать внедрение системы для потребностей своей компании. Лучше всего начать, нажав на кнопку Getting Started (Начало работы) на панели ERPNext. ERPNext поможет вам настроить платформу для всех потребностей бизнеса и электронной коммерции.

Также вы, возможно, захотите повысить скорость ERPNext. В этом случае ознакомьтесь с документом «Настройка производительности ERPNext», где вы узнаете о лучших практиках и способах устранения проблем, связанных с производительностью.