Установка CRM Битрикс24 на Linux CentOS
Обновлено:
Опубликовано:
Есть несколько способов установить CRM Битрикс24 — развернуть готовую виртуальную машину BitrixVM или установить коробку с помощью готового веб окружения. В данной инструкции мы будем использовать второй метод.
Установка веб-окружения
Установка Битрикс24
Доступ к порталу по https
Добавление еще одного типа сайта
Настройки после установки
Настройка кэширования
Обновление PHP
Решение возможных проблем
Дополнительная информация
Установка битрикс окружения
Битрикс24 является веб приложением и для своей работы требует установленного и настроенного веб-сервера. Для этого у 1С есть готовый скрипт — нам просто нужно его загрузить и запустить.
И так, скачиваем скрипт:
yum install curl
curl -sOL http://repos.1c-bitrix.ru/yum/bitrix-env.sh
* первая команда установит утилиту curl, если ее нет.
Даем права скрипту на выполнение:
chmod +x bitrix-env.sh
... и запускаем его:
./bitrix-env.sh
Мы увидим приветствие, в котором говорится, что на все вопросы по умолчанию будет ответ «Да» (Yes) и при необходимости ответить «Нет» нужно ввести n. Также скрипт должен быть запущен от пользователя root:
====================================================================
Bitrix Environment for Linux installation script.
Yes will be assumed as a default answer.
Enter 'n' or 'no' for a 'No'. Anything else will be considered a 'Yes'.
This script MUST be run as root, or it will fail.
====================================================================
... и следом, если на сервере работает SELinux, первый вопрос — согласны ли мы его отключить. Отвечаем утвердительно, нажав Enter:
You have to disable SElinux before installing Bitrix Environment.
Do you want to disable SELinux?(Y|n)
Скрипт вернет ответ, что SELinux выключен и потребует перезагрузки сервера:
SELinux status changed to disabled in the config file /etc/selinux/config.
SELinux status changed to disabled in the config file /etc/sysconfig/selinux.
Please reboot the system! (cmd: reboot)
... перезагружаем (если отключали SELinux):
shutdown -r now
После перезагрузки снова запускаем скрипт:
./bitrix-env.sh
* перед этим необходимо перейти в каталог, куда мы его скачивали.
Начнется процесс установки обновлений, загрузки пакетов и развертывания необходимого программного обеспечения — просто ждем.
В конце мы должны увидеть следующее:
Bitrix Environment bitrix-env has been installed successfully.
Смотрим пароль для подключения к базе mysql:
cat /root/.my.cnf
Мы увидим что-то на подобие:
...
password='3XJ2|~HnBJB7jsS~L8F7'
...
* где 3XJ2|~HnBJB7jsS~L8F7 — пароль для подключения к базе данных.
Веб-окружение установлено.
На момент обновления данной инструкции, вместе с окружением битрикс устанавливался PHP версии 7.4. Однако в панели Битрикс24 система пишет оповещение о прекращении поддержки данной версии. Необходимо вручную обновить интерпретатор.
Обратите внимание на 2 важных момента, которые произойдут в системе:
- Для пользователя root будет установлен флаг о необходимости сменить пароль при следующем входе.
- Утилита управления брандмауэром firewalld будет удалена. Использовать нужно будет iptables.
Установка Битрикс24
Открываем браузер и переходим по ссылке https://<IP-адрес сервера>/bitrixsetup.php — откроется окно приветствия. Меняем язык на русский и кликаем по кнопке Установить:
В открывшемся окне выбираем дистрибутив 1С-Битрикс24 и демонстрационную версию (если у нас есть ключ, то можно выбрать коммерческую лицензию и ввести его), после нажимаем по кнопке Загрузить:
... начнется процесс загрузки дистрибутива. После его окончания откроется мастер установки — на первой странице принимаем лицензионное соглашение и нажимаем Далее:
На странице «Регистрация продукта» можно снять галочку для заполнения формы регистрации:
Начнется процесс установки Битрикс24. Ждем — откроется окно создания учетной записи администратора. Заполняем веб-формы и кликаем Далее.
Откроется страница настройки портала. Кликаем Далее до пункта «Настройка Битрикс24» — отмечаем нужные нам галочки и кликаем Установить:
Откроется последняя страница — нажимаем по Перейти в Битрикс24. Установка завершена.
Настройка HTTPS
Для корректной работы портала необходимо на него заходить по https, а для этого нужен сертификат. Мы рассмотрим пример получения бесплатного сертификата от Let's Encrypt. Подробнее в статье Получение бесплатного SSL сертификата Let's Encrypt.
Открываем на редактирование файл:
vi /etc/nginx/bx/site_enabled/s1.conf
В раздел server добавляем следующее:
server {
...
location ~ /.well-known {
root /usr/share/nginx/html;
allow all;
}
...
}
Открываем второй файл:
vi /etc/nginx/bx/site_enabled/ssl.s1.conf
Также добавим:
server {
...
location ~ /.well-known {
root /usr/share/nginx/html;
allow all;
}
...
}
* данная настройка укажет веб серверу искать файлы в каталоге /usr/share/nginx/html, если мы обратимся к странице /.well-known.
Если у нас несколько сайтов, данную операцию нужно повторить для конфигурационных файлов всех этих сайтов. Они находятся в каталоге /etc/nginx/bx/site_enabled.
Проверяем корректность настройки NGINX и если ошибок нет, перезапускаем службу:
nginx -t && nginx -s reload
Устанавливаем утилиту certbot:
yum install certbot
С помощью даннай утилиты получим сертификат:
certbot certonly --webroot --agree-tos --email postmaster@dmosk.ru --webroot-path /usr/share/nginx/html/ -d bitrix.dmosk.ru
* в данном примере мы запрашиваем сертификат для домена bitrix.dmosk.ru. Предполагается, что именно на нем у меня работает битрикс.
Теперь открываем файл:
vi /etc/nginx/bx/conf/ssl.conf
Редактируем значения для ssl_certificate и ssl_certificate_key:
ssl_certificate /etc/letsencrypt/live/bitrix.dmosk.ru/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/bitrix.dmosk.ru/privkey.pem;
* в данном примере мы указываем пути до полученных сертификатов. Где bitrix.dmosk.ru — имя нашего сайта, для которого был получен сертификат.
Перезапускаем nginx:
systemctl restart nginx
Можно открывать портал по доменному имени по https.
Для автоматической переадресации с http на https в корне каталога с сайтом создаем файл .htsecure. В нашем примере, сайт находится в каталоге /home/bitrix/www:
touch /home/bitrix/www/.htsecure
И зададим в качестве владельца созданного файла пользователя bitrix:
chown bitrix:bitrix /home/bitrix/www/.htsecure
Добавление другого типа сайта
На первом этапе мы выбрали установку и настройку CRM-системы. Вы могли выбрать Интернет-магазин или обычный сайт. Так или иначе, нам может понадобиться на том же сервере развернуть новый тип веб-приложения.
Для этого заходим на сервер по SSH. Если мы зашли не под пользователем root, вводим команду:
/root/menu.sh
Если мы заходим в данное меню впервые, система запросит установить пароль для пользователя bitrix — вводим его дважды.
Создаем пул для управления:
Available actions:
1. Create management pool on the server
2. Configure localhost settings
0. Exit.
Enter your choice: 1
Вводим домен для портала, который будет крутиться на новом пуле:
Please enter master server name (default: bitrix.dmosk.ru): shop.dmosk.ru
Мы должны увидеть сообщение, что пул успешно создан:
Pool has been created successfully. Please enter any key
Нажимаем Enter — загрузится меню управления и выбираем управление пулом сайтов:
Available actions:
1. Manage servers in the pool
2. Configure localhost settings
3. Configure MySQL service for the pool
4. Configure Memcached service for the pool
5. Configure pool monitoring
6. Configure pool sites
7. Configure Sphinx service for the pool
8. Manage pool web servers
9. Configure Push/RTC service for the pool
10. Background pool tasks
11. Configure Transformer service
0. Exit.
Enter your choice: 6
Теперь создаем новый сайт:
Available actions:
1. Create a site
2. Delete a site
3. Change a site's cron settings
4. Change a site's email settings
5. Change a site's https settings
6. Change a site's backup settings
7. Configure NTLM auth for sites
8. Configure optional services (xmppd|smtpd) for a site
9. Configure nginx to use composite cache
10. Configure additional site's options
0. Previous screen or exit
Enter your choice: 1
Вводим имя сайта (доменное):
Enter the site name (e.g. example.org) or 0 to exit: shop.dmosk.ru
Теперь необходимо ввести kernel, чтобы создать новый сайт с отдельной базой данных:
The following site types are available:
link - the new site will share database and kernel files with an existing site;
web server configuration files will be created
kernel - the new site will have a dedicated database
and a private set of kernel files;
web server configuration files will be created
ext_kernel - the new site will have a dedicated database and a private set of kernel files;
it will not be accessible from the web
Default: link
Enter site type (link|kernel|ext_kernel): kernel
Выбираем кодировку:
Enter site encoding (UTF-8|windows-1251): UTF-8
Разрешаем cron:
Do you want to enable cron for this site? (N|y) y
Теперь система предложит изменить параметры базы данных и пользователя. Если есть желание, можно их изменить, но в моем примере мы ответим нет:
Do you want to customize them? (N|y) n
Готово. Теперь в браузере переходим по адресу созданного сайта, в данном примере, http://shop.dmosk.ru — откроется окно, в котором можно создать новый портал, по инструкции, описанной выше.
Настройка (проверка системы)
Для правильной работы портала необходимы дополнительные настройки системы. Анализ ошибок и предупреждений при настройке можно получить на странице Настройки - Инструменты - Проверка системы.
Попробуем рассмотреть некоторые из ошибок и способы из решения.
1. Работа с сокетами
Является основной настройкой для портала, так как на ее основе строится много других провером. Нет смысла продолжать работу с Битрикс24, если при проверке работы с сокетами система возвращает ошибку.
Для корректной работы необходимо:
- Перейти на использование https с настройкой корректного сертификата.
- Установить (обновить) корневые центры сертификации.
После данных действий проверка должна пройти корректно.
2. Выполнение агентов на cron
Чтобы портал мог выполнять фоновые задания, необходимо настроить cron.
Открываем конфигурационный файл:
vi /home/bitrix/www/bitrix/php_interface/dbconn.php
Проверяем, чтобы была строка:
define('BX_CRONTAB_SUPPORT', true);
Открываем на редактирование crontab (для пользователя bitrix):
crontab -e -u bitrix
Добавляем задание:
* * * * * /usr/bin/php -f /home/bitrix/www/bitrix/modules/main/tools/cron_events.php
* в данном примере мы запускаем на исполнение скрипт /home/bitrix/www/bitrix/modules/main/tools/cron_events.php каждую минуту.
Если не заработает, переходим в панели Битрикс в раздел Настройки - Инструменты - Командная PHP-строка и вводим команду:
COption::SetOptionString("main", "agents_use_crontab", "Y");
COption::SetOptionString("main", "check_agents", "Y");
3. Битрикс24.Диск. Быстрая работа с файлами
Переходим в раздел Настройки - Настройки продукта - Настройка модулей. Мы окажемся в разделе «Главный модуль». В подразделе «Файлы» ставим галочку Быстрая отдача файлов через Nginx:
Нажимаем Применить.
4. Настройка почтовых уведомлений
Для отправки почты прочитайте инструкцию Настройка корректной отправки почты в Битрикс24.
5. Сервер очередей Push and Pull
Переходим в раздел Настройки продукта - Настройки модулей. Выбираем в настройках Push and Pull:
В разделе Использовать "Push server" выбираем Использовать облачный сервер "1С-Битрикс" и кликаем по кнопке Зарегистрироваться:
6. Параметры настройки UTF (mbstring и константа BX_UTF)
Открываем файл:
vi /etc/php.d/bitrixenv.ini
Необходимо убедиться в наличие строк:
; Utf-8 support
default_charset = UTF-8
mbstring.func_overload=2
Перезапускаем сервис:
systemctl restart httpd
7. Временная папка не существует
У нас могут не проходить тесты загрузки файлов с ошибкой Ошибка! Временная папка не существует (BX_TEMPORARY_FILES_DIRECTORY: /home/bitrix/tmp/bak). Где /home/bitrix/tmp/bak — конкретный путь к каталогу, каторого нет.
Для решения проблемы просто создадим данный каталог:
mkdir -p /home/bitrix/tmp/bak
И задаем права:
chown bitrix:bitrix /home/bitrix/tmp/bak
Настройка кеширования
Для увеличения производительности, стоит настроить кэширование. У нас на выбор разные технологии для настройки кэширования:
- apc
- files
- redis
- xcache
- memcached
Мы рассмотрим пример с memcached. Для начала, устанавливаем его:
yum install memcached php-pecl-memcached
Откроем конфигурационный файл memcached:
vi /etc/sysconfig/memcached
Отредактируем некоторые директивы:
CACHESIZE="1024"
OPTIONS="-t 8"
* где:
- CACHESIZE — используемый объем памяти.
- OPTIONS="-t 8" — разрешить 8 потоков.
Разрешаем автозапуск сервиса и запускаем его:
systemctl enable memcached --now
Перезапускаем веб-сервер apache:
systemctl restart httpd
Memcache установлен и подключен. Чтобы убедиться в этом, вводим следующую команду:
php -i | grep "memcached support"
Мы должны увидеть:
memcached support => enabled
Создаем конфигурационный файл битрикс:
vi /home/bitrix/www/bitrix/.settings_extra.php
<?php
return array (
'cache' => array (
'value' => array (
'type' => array (
'class_name' => '\\Bitrix\\Main\\Data\\CacheEngineMemcache',
'extension' => 'memcache'
),
'memcache' => array(
'host' => '127.0.0.1',
'port' => '11211',
),
'sid' => $_SERVER["DOCUMENT_ROOT"]."#01"
),
),
);
?>
* если в файле уже есть какое-то содержимое, то просто добавляем настройки cache.
Открываем конфигурационный файл dbconn.php:
vi /home/bitrix/www/bitrix/php_interface/dbconn.php
Добавляем строки (или приводим значения к виду):
define("BX_CACHE_TYPE", "memcache");
define("BX_CACHE_SID", $_SERVER["DOCUMENT_ROOT"]."#01");
define("BX_MEMCACHE_HOST", "127.0.0.1");
define("BX_MEMCACHE_PORT", "11211");
* в данном примере мы указали, что наш сервер memcache находится на том же сервере, что и Битрикс24 (127.0.0.1), а сам кэширующий сервис слушает на порту 11211.
Готово. Можно перейти в панель проверики производительности и на вкладке PHP проверить результат.
Обновление PHP
Портал Битрикс24 разработан с использованием PHP. Время от времени разработчик предупреждает о прекращении поддержки установленной версии и необходимости обновления, например:
Рассмотрим пример обновления PHP в CentOS подробнее.
Важно отметить потенциальную опасность данного обновления. Портал может использовать расширения, которые не будут поддерживаться новой версией PHP, что приведет систему в неработоспособное состояние.
Перед выполнением процедуры лучше сделать снапшот (если наш портал работает на виртуальной машине).
На веб-портале в разделе Администрироване - Marketplace устанавливаем все обновления, которые даст установить битрикс.
Подключаемся к серверу по SSH и добавляем репозиторий PHP:
rpm -Uvh http://rpms.remirepo.net/enterprise/remi-release-7.rpm
По нашему сообщению (из скриншота) нам нужно установить версию 8.1. Включаем репозиторий для соответствующей версии:
yum-config-manager --enable remi-php81
Если мы получим ошибку bash: yum-config-manager: command not found, необходимо установить yum-utils:
yum install yum-utils
Устанавливаем PHP:
yum install php
Система обновит кэш репозиториев и выполнит установку как PHP, так и расширений, которые необходимо обновить со старой версии на новую.
Чтобы Битрикс24 увидел обновления, вводим:
systemctl restart httpd
Проверяем работоспособность портала. Посмотреть используемую версию PHP можно в панели администратора, разделе Настройки - Производительность - PHP.
Откат PHP
Если после обновления PHP у нас возникли проблемы в работе портала, необходимо обратно вернуть старую версию PHP. Мы не можем штатными средствами удалить интерпретатор, но нам нужно посмотреть на список установленных расширений.
Вводим:
yum remove php-*-8*
* в данном примере мы запросим удалить все пакеты, которые начинаются на php- и имеют в названии -8, что в нашем примере соответствует восьмой версии PHP.
Но не соглашаемся на удаление, введя n.
Мы должны увидеть таблицу, на подобие:
==========================...
Package
==========================...
Удаление:
php-cli ...
php-common ...
php-gd ...
...
Удаление зависимостей:
...
Для нас важен список пакетов, начинающихся на php. Эти пакеты нам нужно удалить, но без удаления зависимостей.
Обратите внимание, что в таблице есть разделы Удаление и Удаление зависимостей. Нас интересует только первый.
И так, по очереди для каждого пакета из списка вводим команду:
rpm -e <имя пакета> --nodeps
Например:
rpm -e php-cli --nodeps
rpm -e php-common --nodeps
rpm -e php-gd --nodeps
И так для всех пакетов из раздела Удаление полученной таблицы.
Теперь удаляем и сам пакет php:
rpm -e php --nodeps
Запрещаем ранее разрешенный репозиторий по установке php версии 8 и заррешаем для версии 7.4:
yum-config-manager --disable remi-php8*
yum-config-manager --enable remi-php74
Устанавливаем PHP:
yum install php
Важно убедиться, что будет установлена версия 7.
И установим все те пакеты, которые удалили из таблицы. В моем случае, список был такой:
yum install php-cli php-common php-gd php-ldap php-mbstring php-mysqlnd php-opcache php-pdo php-pecl-memcache php-process php-pspell php-sodium php-xml
Перезапускаем apache:
systemctl restart httpd
Готово. Пробуем зайти на портал битрикс24, проверить обновления, выполнить диагностику и еще раз можно попытаться обновить PHP.
Решение проблем
Рассмотрим процесс разбора проблем, а также приведем примеры.
Включение лога
Лучший способ локализовать проблему — изучить лог. По умолчанию, в Битрикс24 отключен режим журналирования. Рассмотрим процедуру его включения.
Открываем конфигурационный файл:
vi /home/bitrix/www/bitrix/.settings.php
Находим опцию debug и задаем значение true:, а также приводим опцию log к следующему виду:
...
array (
'debug' => true,
...
'log' => array (
'settings' => array (
'file' => 'bitrix/modules/error.log',
'log_size' => 1000000,
),
),
),
В данном примере мы указали, что файл лога будет сохраняться в каталог установки Битрикс + bitrix/modules/error.log, то есть в нашем случае для просмотра журнала можно использовать команду:
tail /home/bitrix/www/bitrix/modules/error.log
Ошибка 504 при оптимизации базы данных
Оптимизация базы занимает продолжительное время. Но вместо окончиния процесса мы можем увидеть ошибку: 504 Gateway Timeout.
Причина: веб-сервер nginx ждет ответа от работы скрипта определенное время. Данное время определено с помощью опций proxy_connect_timeout, proxy_send_timeout и proxy_read_timeout. Посмотреть текущие значения можно командой:
nginx -T | egrep "proxy_.*_timeout"
Если скрипт работает дольше, то система вернет ошибку.
Решение: нам нужно указать большее значение для вышеперечисленных опций:
vi /etc/nginx/nginx.conf
http {
...
proxy_connect_timeout 3600;
proxy_send_timeout 3600;
proxy_read_timeout 3600;
* в данном примере мы указали, что nginx будет ждать час, прежде чем выдаст ошибку.
Слишком большое ожидание может привести к снижению производительности системы. Рекомендуется вернуть значения после выполнения оптимизации.
Перезапускаем сервис nginx:
nginx -t && nginx -s reload
Можно запускать оптимизацию баз.
Читайте также
Дополнительная информация по битрикс24:
