Как установить виртуальную машину битрикс на windows 10

Виртуальная машина Bitrix – бесплатное решение, которое позволяет получить виртуальный сервер, настроенный, протестированный и адаптированный для работы с продуктами 1С-Битрикс и PHP-приложениями. 

VMBitrix.CRM – решение на основе виртуальной машины Bitrix, которое предназначено для развертывания CRM. Внутри машины то же, что и внутри VMBitrix, однако некоторые пункты убраны из меню – например, нет управления хостами, MySQL и репликацией, отсутствует расширенное управление сайтами.

Компания WRP предоставляет услуги по разработке сайтов и переносу существующих проектов на CMS Bitrix c использованием виртуальной машины Битрикс. Профессионализм и опыт работы наших сотрудников позволяет реализовать максимально сложные решения в минимальные сроки. 

Установка виртуальной машины VMBitrix

Установка виртуальной машины Битрикс выполняется двумя способами:

1. Автоматическая инсталляция при заказе нового сервера с Bitrix. Такое решение предлагает, например, Timeweb Cloud.

2. Ручное развертывание ПО на базе сервера с «чистой» системой CentOS версий 6 или 7 с помощью BitrixEnv.

Разница между BitrixVM и BitrixEnv

BitrixVM – образ CentOS, на котором установлено все необходимое ПО для развертывания сайтов на 1С-Битрикс. Он подготовлен разработчиками 1С. Высокая производительность достигается также за счет оптимизации настроек сервера под работу с CMS.

BitrixEnv – это shell-скрипт, с помощью которого вы можете самостоятельно установить набор ПО, необходимый для работы сайтов на 1С-Битрикс. Он подходит для ситуаций, когда настройка сервера Битрикс невозможна с нуля. Например, у вас уже есть заказанный сервер. С помощью виртуального окружения вы можете настроить на нем конфигурацию под Битрикс так, как нужно для вашего проекта.

Ручная установка ВМ

С автоматической установкой все понятно – достаточно заказать сервер нужной конфигурации. Разберем ручную установку.

Подключитесь к серверу по SSH.

Получите установочный файл:

wget http://repos.1c-bitrix.ru/yum/bitrix-env.sh

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

chmod +x bitrix-env.sh

Запустите установочный файл:

./bitrix-env.sh

На этом установка завершена.

Настройка ВМ

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

/root/menu.sh

При первом использовании система предложит изменить пароль. Введите новый пароль для root и подтвердите изменения.

Чтобы на сервере можно было размещать сайты, необходимо создать пул. 

1. Выберите в меню управления первый пункт – Create management pool. Для этого нажмите цифру 1 на клавиатуре.

2. Укажите имя хоста. Можно оставить имя по умолчанию, нажав Enter.

3. Еще раз нажмите Enter, чтобы создать пул.

На экране отобразится полное меню, в котором представлены основные настройки виртуальной машины Битрикс. 

Создание первого сайта

В качестве примера создадим первый сайт. Чтобы начать, выберите в меню пункт 6 – Configure pool sites.

Затем выберите пункт 1 – Create a site. Запустится мастер настройки, который в режиме диалога проведет вас через основные этапы.

1. Укажите домен.

2. Выберите тип kernel. Это нужно для того, чтобы можно было осуществить подключение к БД Битрикс.

3. Задайте кодировку сайта – обычно это UTF-8.

4. Включите cron, если на передающем хосте есть задачи для вашего нового проекта.

Следующие этапы помогают выполнить на Битрикс подключение к базе данных. В диалоге появится вопрос, хотите ли вы кастомизировать имя и пароль от БД. Введите ‘y’, чтобы установить их вручную.

1. Укажите имя БД.

2. Введите имя пользователя. Оно может совпадать с именем БД.

3. Укажите пароль от БД и подтвердите его повторным вводом.

Сайт появится в списке через некоторое время. Чтобы обновить список, нажмите Enter.

Дальше вы можете настраивать ресурс на свое усмотрение. Например, установить phpMyAdmin командой:

yum install -y phpmyadmin

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

ln -s /usr/share/phpMyAdmin /home/bitrix/www/phpmyadmin

Для настройки конфигурации Apache откройте файл:

vim /etc/httpd/bx/conf/default.conf

Перед ‘ErrorLog logs/error_log’ добавьте строки:

<Directory /home/bitrix/www/phpmyadmin>

php_admin_value mbstring.func_overload 0

</Directory>

Сохраните файл и перезапустите веб-сервер:

systemctl restart httpd

Чтобы защитить сайт, нужно установить SSL. Через меню Bitrix можно получить бесплатный сертификат Let’s Encrypt. Чтобы выпустить и установить его:

1. Пройдите в меню по пути: ‘8. Manage pool web servers -> 3. Configure certificates -> 1. Configure Let’s encrypt certificate’.

2. Укажите сайты, для которых заказываете сертификат, их доменные имена, а также контактную почту для уведомлений.

3. Введите ‘y’, чтобы подтвердить выпуск и установку.

Вы также можете установить другие бесплатные и платные сертификаты в ручном режиме. Для этого нужно отредактировать конфигурационный файл для SSL-зоны сайта.

Заключение

Мы посмотрели, как на BitrixVM создать базу данных сайта и подключиться к ней. Также разобрали установку SSL и настройку phpMyAdmin. Еще один важный момент – теперь вы точно знаете, чем BitrixVM отличается от BitrixEnv и какое решение в каких ситуациях больше подходит.

Если вам нужна помощь с управлением сервером, закажите услугу администрирования в Timeweb Cloud. Можно делегировать специалистам Timeweb и отдельные задачи – например, перенос сайта, организацию резервного копирования или настройку дополнительных модулей. 

Хотите отказаться от самописных CMS и CRM, а также платформ, разработанных зарубежными компаниями? Сделать работу сайта более эффективной и сократить затраты на его поддержку? Воспользуйтесь помощью экспертов из WRP. Мы выполним перенос в минимальные сроки и без остановки работы IT-инфраструктуры компании. 

Получить дополнительные консультации и оформить заявку можно по телефону +7 (495) 230-20-53 или через форму обратной связи на сайте.

Виртуальная машина VMBitrix v7.x

/path/to/openssl rsa -in /path/to/originalkeywithpass.key -out /path/to/newkeywithnopass.key

Что нового?

Архив изменений

VMBitrix v7.2.х (Стабильная версия)

Обсуждение версии 7.2.x на форуме.

Установка «1С-Битрикс: Веб-окружение» — Linux (BitrixEnv)

./bitrix-env.sh [-s] [-p [-H hostname]] [-F] [-m mysql_version] [-M mysql_root_password]

./bitrix-env.sh -s -p -H server1 -F -m 8.0 -M '111111'

./bitrix-env.sh -h
./bitrix-env-crm.sh -h

/root/menu.sh

Запуск виртуальной машины BitrixVM

/root/menu.sh

VMBitrix.CRM

VMBitrix.CRM собирается на базе BitrixVM. Это готовое решение для CRM – внутри машины тоже самое, что и в основной машине BitrixVM.

Но есть отличия:

1. Из меню VMBitrix.CRM убрано:
   • управление хостами
   • расширенное управление сайтами (убрано создание, удаление, ntlm, композит для nginx)
   • управление MySQL и репликацией
   • управление memcache, sphinx
   • управление web ролью и мониторингом

2. При старте VMBitrix.CRM сразу:

   • создается пул
   • настроен memcache
   • установлен и работает push-сервер

Скачать VMBitrix.CRM можно с сайта 1С-Битрикс под нужный вид виртуализации.

Далее нужно только установить Битрикс24.CRM (или восстановить копию), настроить почту и ssl-сертификат. И у вас готовый Битрикс24 с CRM!

Для отдельного сервера на базе CentOS 7 можно загрузить скрипт установки VMbitrix.CRM через консоль и запустить его командами:

wget http://repo.bitrix.info/yum/bitrix-env-crm.sh && chmod +x bitrix-env-crm.sh && ./bitrix-env-crm.sh

Также для VMBitrix.CRM есть вариант поставки exe-файла для тех, кто хочет в пару кликов познакомиться с Битрикс24.CRM и не обладает достаточными техническими знаниями. Совместим с Windows 7, 8, 10, Windows Server 2008 2012 2016.

Этот инсталлятор:

• скачает и установит VirtualBox
• скачает образ виртуальной машины VMBitrix.CRM и импортирует его в VirtualBox
• установит сервис по вашему желанию
• запустит машину и получит IP

После останется установить Битрикс24.CRM или восстановить копию проекта.

Примечание: Если устанавливается как сервис, то при перезагрузке компьютера виртуальная машина будет запущена в фоновом режиме. Для работы как сервиса у пользователя Windows должен быть установлен пароль.

Установка и перенос продуктов «1С-Битрикс» в BitrixVM/BitrixEnv

Установка и перенос продуктов «1С-Битрикс» может быть осуществлена несколькими способами.

Установка дистрибутива сайта в BitrixVM/BitrixEnv

Для установки продукта «1С-Битрикс» нужно:

1. Перейти по адресу [dw]bitrix url[/dw][di][/di], указанному в BitrixVM или BitrixEnv в браузере. Откроется страница с выбором варианта установки:

   

2. Для продолжения необходимо выбрать один из вариантов:

   • Установить — в этом случае будет запущен мастер, который позволяет скачать и установить новый сайт средствами продуктов компании «1C-Битрикс». Шаги этого варианта аналогичны шагам, рассмотренным в главе Установка продукта с помощью BitrixSetup.

   • Восстановить копию — в этом случае будет запущен мастер, с помощью которого можно будет перенести существующий проект (восстановить проект из резервной копии).

Перенос продукта «1C-Битрикс» в виртуальную среду BitrixVM/BitrixEnv

1. Управление серверами пула (1. Manage servers in the pool)

Для начала работы с сервисами нужно создать и настроить пул сервера. Для этого нужно выбрать пункт главного меню 1. Create Management pool of server и ввести название сервера в данном пуле.

Мастер создания пула откроет все необходимые порты в CentOS для корректной работы сервисов продуктов «1С-Битрикс»:

• 22 – ssh доступ;
• 80 / 443 – http / https web-сервер;
• 8890 / 8891 – http/https ntlm;
• 8893 / 8894 – http/https сервер мгновенных сообщений;
• 5222 / 5223 – http/https xmpp-сервер.

Если пул не создан, то открыты только 22, 80 и 443 порты.

Для большинства проектов достаточно всего лишь одного сервера в пуле, который создается на начальном этапе установки BitrixEnv (см выше).

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

После создания пула в основном меню добавятся новые пункты в главном меню:

1. Добавление нового хоста в пул (1. Add new host to the pool)

Добавление нового сервера в пул (кластер) осуществляется с помощью меню 1. Manage servers in the pool > 1. Add new host to the pool.

Для этого необходимо задать ip-адрес или DNS-имя сервера, выбрать короткое имя (в примере — server2) и ввести пароль root для подключаемого сервера:

Примечание: Имя сервера можно выбрать любое, можно указать, что хотите: bx1, server10, mysite.com (можно и имя домена, если он один) и т.д.

Таким образом, можно добавлять любое количество серверов в пул:

Теперь можно управлять любым сервером пула с одной машины.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Удаление хоста из пула (2. Remove host from the pool)

Удаление хоста, находящегося в пуле, осуществляется с помощью меню 1. Manage servers in the pool > 2. Remove host from the pool . Если на хосте есть хоть какие-то роли, то удаление хоста невозможно.

Для этого необходимо задать ip-адрес или DNS-имя хоста удаляемого из пула сервера:

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

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

3. Перезапуск хоста (3. Reboot host)

Перезагрузка хоста, находящегося в пуле, осуществляется с помощью меню 1. Manage servers in the pool > 3. Reboot host.

Для этого необходимо задать имя хоста (в данном примере — server2) и согласиться на перезапуск сервера:

4. Обновление пакетов на хосте (4. Update packages on host)

С помощью менеджера пула можно удаленно обновлять Веб-окружение и компоненты системы на любом хосте, входящем в пул.

Например, в пул добавлена виртуальная машина версии 7.4.0, нам нужно обновить ее до 7.4.х.

• Выбираем пункт меню 1. Manage servers in the pool > 4. Update packages on host, система спросит имя хоста для обновления и выбор, что обновлять – только окружение (bitrix) или полностью систему и окружение (all):

  

• Менеджер пула запустит задачу обновления Веб-окружения на удаленном хосте:

  

  Важно! В процессе обновления BitrixVM версии PHP и MySQL автоматически не обновляются. Обновить их можно в ручном режиме с помощью пункта меню виртуальной машины 1. Manage hosts in the pool — 8. Update PHP and MySQL.

• Через некоторое время система на удаленном хосте обновится до последней версии (в данном примере — 7.4.3)

  

Таким же образом можно обновлять включенные в пул виртуальные машины ранних версий.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

5. Смена пароля пользователя bitrix (5. Change ‘bitrix’ user password on host)

Смена пароля для пользователя bitrix осуществляется через пункт меню 1. Manage servers in the pool > 5. Change ‘bitrix’ user password on host.

Будет выдан запрос имени хоста, на котором нужно сменить пароль пользователя bitrix, новый пароль и согласие на смену пароля:

Внимание! Сменить пароль пользователя root через меню виртуальной машины нельзя. Для этого необходимо воспользоваться системными командами ОС. Например, для Centos 6/7 консольная команда смены пароля пользователя root: passwd.

6. Настройка таймзоны в пуле (6. Configure pool timezone)

Настройка таймзоны – очень важный параметр, который обязательно нужно проверить и при необходимости настроить правильно. Параметр влияет на синхронизацию с 1С, календари, заказы и многое другое, где требуется дата и время.

Дата и время на сервере – это не одна конкретная дата и время, это фактически три различных даты и три различных времени со своими часовыми поясами:

• Время сервера
• Время PHP
• Время MySQL

Примечание: По умолчанию в BitrixVM выставлена зона Europe/Moscow (MSK, UTC+03).

Смена таймзоны происходит через пункт меню веб-окружения 1. Manage servers in the pool > 6. Configure pool timezone, и меняет дату и время, в трех местах сразу, т.к это очень важный момент, что все три места работают с одинаковыми параметрами времени и даты.

• После выбора континента, страны и города будет выведен запрос на согласие применения данной таймзоны:

  

• После этого будет предложено также изменить таймзону для PHP:

  

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

  

Примечание: Корректность установки времени у PHP и MySQL можно проверить также через административный веб интерфейс продуктов «1C-битрикс»: Настройки > Инструменты > Проверка системы.

7. Удаление конфигурации пула (7. Remove pool configuration)

Удаление конфигурации пула осуществляется с помощью меню 1. Manage servers in the pool > 7. Remove pool configuration. После подтверждения конфигурация пула будет удалена:

Меню же вернется к своему первоначальному состоянию:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

8. Обновление PHP и MySQL (8. Update PHP and MySQL)

Обновлять версии PHP и MySQL необходимо, исходя из рекомендуемых системных требований продуктов «1С-Битрикс».

В процессе обновления VMBitrix PHP и MySQL автоматически не обновляются. Обновить их нужно в ручном режиме с помощью пункта меню виртуальной машины 1. Manage servers in the pool — 8. Update PHP and MySQL.

Примечание: Пункт меню 1. Manage servers in the pool — 8. Update PHP and MySQL присутствует в BitrixVM, начиная с версии 5.1.х и выше.

Укажите all для обновления только PHP на всех машинах с ролью web, входящих в пул, либо укажите машину с конкретным именем хоста hostname для обновления PHP и MySQL:

Далее можно выбрать варианты PHP или MySQL:

1. Upgrade PHP

Для обновления версии выберите подходящий пункт Update PHP to version х.х:

Примечание: На данный момент возможные версии PHP: 5.6, 7.0, 7.1, 7.2, 7.3, 7.4, 8.0, 8.1.

2. Downgrade PHP

Аналогичным способом можно и понизить версию PHP, выбрав нужную с помощью пункта меню Downgrade PHP to version х.х. Для VMbitrix.CRM минимальная версия PHP – 7.0.

3. Upgrade MySQL version

Если вы обновили VMBitrix до версии 7.1 и выше, то у вас появится возможность обновить версию MySQL до 5.7 Percona DB. Сделать это можно, выбрав пункт Upgrade MySQL to 5.7 version:

После обновления MySQL до версии 5.7 появится возможность обновить MySQL до версии 8.0 – Upgrade MySQL to 8.0 version:

Внимание! После обновления MySQL до версии 8.0 обратно понизить версию до 5.7 через меню VMBitrix нельзя.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

9. Изменить имя хоста (9. Change hostname)

Смена имени хоста в пуле осуществляется через пункт меню 1. Manage servers in the pool > 5. Change hostname.

Будет выдан запрос имени хоста, на котором нужно сменить его имя, новое имя и согласие на смену имени хоста:

После успешного выполнения задачи, хост получит новое имя:

10. Использование бета-версии BitrixEnv (10. Enable or disable bitrix-env beta versions)

yum clean all

Cleaning repos: base bitrix-beta bitrix-source epel ...

2. Управление локальным сервером (2. Configure localhost settings)

• 1. Configure hostname — задается название хоста виртуального сервера;
• 2. Configure network interface via DHCP — настройка IP-адреса сервера через DHCP;
• 3. Configure network interface manually — настройка IP-адреса сервера вручную;
• 4. Reboot server — перезагрузка виртуального сервера;
• 5. Shutdown server — выключение виртуального сервера;
• 6. Update server — обновление компонентов операционной системы виртуальной машины;
• 7. Enable or disable bitrix-env beta versions — отслеживание изменений в версиях файлов и новых возможностей.
• 0. Previous screen or exit — возвращение к главному меню.

1. Изменение имени хоста (1. Configure hostname)

Чтобы задать имя хоста локального сервера, нужно перейти в главном меню 2. Manage localhost — 1. Configure hostname.

Далее согласиться на изменение имени хоста и ввести название Input hostname — например server1 (по умолчанию имя хоста — localhost.localdomain):

После чего системе будет присвоено новое имя:

Примечание: Имя хоста можно выбрать любое, можно указать, что хотите: bx1, server10, mysite.com (можно и имя домена, если он один) и т.д.

2. Настройка IP-адреса сервера через DHCP (2. Configure network interface via DHCP)

При первом старте BitrixVM получение IP-адреса сервером происходит автоматически, если в сети есть настроенный DHCP-сервер.

Чтобы сменить или обновить IP-адрес локального сервера с помощью DHCP-сервера, нужно:

• Перейти в главном меню 2. Manage localhost — 2. Configure network interface via DHCP.
• Выбрать сетевой интерфейс (в данном примере — ens33) и автоматически будет получен IP-адрес от DHCP-сервера:

  

3. Настройка IP-адреса сервера вручную (3. Configure network inteface manually)

Для задания IP-адреса в ручном режиме необходимо:

• Перейти в главном меню 2. Manage localhost — 3. Configure network interface manually.
• Выбрать сетевой интерфейс (в данном примере — ens33).
• Ввести данные:

  

  • Type IP address — новый IP-адрес сервера;
  • Type broadcast — широковещательный адрес сети;
  • Type network mask — маска подсети;
  • Type default gateway — шлюз по умолчанию;
  • Type DNS server — адрес DNS-сервера.
• Проверить введенные данные и дать согласие на изменение параметров сети сервера:

  

4. Перезагрузка сервера (4. Reboot server)

Чтобы перезапустить сервер виртуальной машины BitrixVM, нужно перейти в главном меню 2. Manage localhost — 4. Reboot server.

Далее согласиться на перезапуск сервера:

5. Выключение сервера (5. Shutdown server)

Чтобы выключить сервер виртуальной машины BitrixVM, нужно перейти в главном меню 2. Manage localhost — 5. Shutdown server.

Далее согласиться на остановку сервера:

6. Обновление локального сервера (6. Update server)

7. Использование бета-версии BitrixEnv (7. Enable or disable bitrix-env beta versions)

yum clean all

Cleaning repos: base bitrix-beta bitrix-source epel ...

3. Настройка службы MySQL для пула (3. Configure MySQL service for the pool)

1. Обновить настройки для всех MySQL-серверов (1. Update settings for all MySQL servers)

Чтобы обновить настройки для всех MySQL-серверов, нужно перейти в главном меню 3. Configure MySQL service for the pool — 1. Update settings for all MySQL servers:

Опция обновляет конфигурацию одного или нескольких MySQL-серверов в пуле (если такое имеется) и приводит их к дефолтным настройкам для виртуальной машины.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Изменить пароль пользователя root для MySQL (2. Change password for MySQL root user)

Внимание! В BitrixVM/BitrixEnv версии 7.x+ пароль root для MySQL-сервера не может быть пустым. При первом запуске BitrixVM он автоматически создается, а при установке BitrixEnv будет выдан запрос на создание пароля root для MySQL-сервера.

Если вам понадобилось сменить пароль root MySQL-сервера, нужно перейти в главном меню 3. Configure MySQL service for the pool — 2.Change password for MySQL root user.

Далее выбрать нужный сервер (имя хоста), согласиться на изменение и ввести новый пароль.

3. Остановить/Запустить службу MySQL на сервере (3. Stop/Start MySQL service on the server)

Остановить или запустить MySQL-сервер можно в главном меню 3. Configure MySQL service for the pool — 3. Stop/Start MySQL service on the server
.

Далее выбрать нужный сервер (имя хоста), согласиться на остановку или старт MySQL-сервера:

4. Создать slave MySQL-сервер (4. Create MySQL slave)

5. Смена master сервера MySQL (5. Change master MySQL server)

Для переноса master сервера MySQL на другую машину необходимо:

• Выбрать пункт меню 3. Configure MySQL service for the pool > 5. Change master MySQL server.

  Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 slave-сервер MySQL с помощью меню 3. Configure MySQL servers > 4. Create slave MySQL server.

• Ввести имя хоста для будущего master сервера MySQL из списка доступных slave (например server2):

  

• Подождать, пока задача по смене master cервера MySQL будет закончена.
• В итоге серверы MySQL станут: master (server2) и два slave (server1 и server3):

  

Таким образом, мы перенесли master сервер MySQL с машины server1 на server2.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

6. Удаление slave сервера MySQL (6. Remove slave MySQL server)

Для удаления slave сервера MySQL необходимо:

• Выбрать пункт меню 3. Configure MySQL service for the pool > 6. Remove slave MySQL server.

  Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 slave-сервер MySQL с помощью меню 3. Configure MySQL servers > 4. Create slave MySQL server.

• Ввести имя хоста удаляемого slave сервера MySQL (например server1):

  

• Подождать, пока задача по удалению slave cервера MySQL будет закончена.
• В итоге серверы MySQL станут: master (server2) и один slave (server3):

  

Таким образом, мы освободили ресурсы машины server1 под другие роли.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

4. Настройка службы Memcached для пула(4.Configure Memcached service for the pool)

Продукты «1С-Битрикс» позволяют использовать пул серверов memcached для работы с кешем данных.

Это обеспечивает:

• высокую эффективность — за счет централизованного использования кеша веб-приложением;
• надежность — за счет устойчивости подсистемы кеширования к выходу из строя отдельных компонентов;
• неограниченную масштабируемость — за счет добавления новых memcached-серверов.

Внимание! Перед тем как начинать использовать пул серверов memcached в BitrixVM/BitrixEnv нужно предварительно установить продукты «1С-Битрикс: Управление сайтом» или в «Битрикс24 в коробке» с модулем Веб-кластер. Данный модуль входит только в старшие редакции продуктов «1С-Битрикс».

1. Настройка службы memcached (1.Configure memcached service)

Для создания memcached сервера нужно:

• Выбрать пункт меню Configure Memcached service for the pool > 1. Configure memcached service.
• Ввести имя хоста в пуле, на котором будет запущен сервер memcached (в данном примере — server1):

  

• Подождать, пока задача по запуску cервера memcached будет закончена:

  

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Обновить настройки memcached сервера (2. Update settings on all memcached servers)

Чтобы обновить настройки для всех memcached -серверов, нужно перейти в главном меню 4. Configure memcached servers — 2. Update settings on all memcached servers:

Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 memcached-сервер с помощью меню 4. Configure memcached servers > 1. Create memcached server.

Эта опция запускает проверку текущей конфигурации одного или нескольких memcached -серверов в пуле (если такие имеются).

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

3. Удаление memcached сервера (3. Remove memcached server)

Для удаления memcached сервера необходимо:

• Выбрать пункт меню 4. Configure memcached servers > 3. Remove memcached server.

  Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 memcached-сервер с помощью меню 4. Configure memcached servers > 1. Create memcached server.

• Ввести имя хоста удаляемого memcached сервера (например server1):

  

• Подождать, пока задача по удалению memcached cервера будет закончена.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

5. Мониторинг (5. Configure pool monitoring)

При разворачивании проектов на базе BitrixVM/BitrixEnv необходимо следить за состоянием сервера и отдельных его компонентов.

В составе BitrixVM/BitrixEnv уже имеются системы мониторинга — Munin и Nagios, которые имеют большое количество различных компонентов по отслеживанию функционирования всех систем сервера или нескольких серверов в составе кластера.

1. Настроить сервисы мониторинга (1. Configure monitoring services)

2. Выключить сервисы мониторинга (2. Disable monitoring services)

Для выключения сервисов мониторинга Nagios и Munin необходимо:

• Выбрать пункт меню 5. Configure pool monitoring > 2. Disable monitoring services:

  

• Согласиться на действие:

  

• Подождать, пока задача выключения сервисов мониторинга будет закончена.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Configure pool monitoring > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

3. Добавить хосты для мониторинга (3. Add new host(s) on monitoring)

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

Пункт меню 5. Configure pool monitoring > 3. Add new host(s) on monitoring позволяет вручную запустить добавление нового хоста в систему мониторинга, если по каким-либо причинам он не добавился в мониторинг:

Примечание: При выборе 5. Configure pool monitoring > 3. Add new host(s) on monitoring) задача на автоматическое добавление нового хоста в мониторинг запустится сразу, без каких-либо запросов.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

6. Управление сайтами (6. Configure pool sites)

1. Создание сайта (1. Create site)

Мастер создания дополнительных сайтов, позволяет развернуть на одной виртуальной машине несколько сайтов, как на независимых установках «1С-Битрикс», так и в рамках многосайтовости.

Внимание! В BitrixVMBitrixEnv версии 7.х root пароль к MySQL не может быть пустым, он задается для BitrixEnv на этапе установки, а для BitrixVM автоматически при первом старте. Изменить root пароль к MySQL можно в меню 3. Configure MySQL service for the pool > 2. Change password for mysql user root . Если root пароль к MySQL будет пустым, то при добавлении нового сайта будет выдана ошибка.

Для добавления дополнительного сайта необходимо:

• Предварительно настроить DNS-записи в управлении доменами или в случае локальной установки указать доменное имя в /etc/hosts на виртуальной машине, а также на всех компьютерах, с которых будет осуществляться доступ к данному сайту.
• Далее из административного меню запустить мастер 6. Configure pool sites > 1 Create site:

  

  

  и указать:

  1. Enter site name — доменное имя дополнительного сайта без www;

     Внимание! Если у вас домен в национальной кодировке (например, кириллический домен), то в данное поле нужно вводить имя домена в Punycode-формате, воспользовавшись любым Unicode-Punycode конвертером (например этим).

  2. Enter site type — тип установки ядра «1С-Битрикс»:
     • kernel — в случае создания дополнительного сайта в рамках отдельной установки — отдельное ядро продукта «1С-Битрикс» в новой директории сайта.
     • ext_kernel — отдельное ядро продукта «1С-Битрикс» в новой директории сайта для создания линков на это ядро в рамках многосайтовости, ядро будет недоступно напрямую, а только через дополнительные сайты (работает в паре с сайтами типа link).
     • link — в случае создания дополнительного сайта в рамках многосайтовости — общее ядро и данные в общей базе с уже установленным продуктом «1С-Битрикс» (работает в паре с ядром ext_kernel).
  3. Enter full path to the Bitrix installation directory — указать путь до ядра продукта «1С-Битрикс», на которые будут сделаны симлинки (для ядра типа link).
  4. Enter site encoding — указать кодировку будущего сайта: UTF-8 или windows 1251 (для ядра типа kernel и ext_kernel).
  5. Do you want to enable cron task on site — включить ли выполнение заданий на cron для будущего сайта (для ядра типа kernel и ext_kernel).
  6. Do you want to specify them — по умолчанию название, логин и пароль базы данных и root-директория сайта создаются автоматически (в файлах dbconn.php и .settings.php (с версии 20.900.0 — только в .settings.php)), но с помощью данной опции можно указать свои, выбрав ответ y (для ядра типа kernel и ext_kernel).
• В процессе работы мастера будет создана директория на сервере: /home/bitrix/ext_www/{название_хоста}, в которой будут:
  • символические ссылки на директорию ядра, которую выбрали ранее (если был выбран вариант link).
  • директории и скрипт BitrixSetup для установки или восстановления продукта (если был выбран вариант kernel).
  • директории и скрипт BitrixSetup для восстановления продукта (если был выбран вариант ext_kernel).
• После завершения задачи по добавлению сайта он будет готов к использованию.

  Примечание: Количество дополнительных сайтов ограничивается лишь лицензией «1С-Битрикс» данной установки.

Внимание! Если был выбран вариант ядра ext_kernel и установлено ядро в /home/bitrix/ext_www/{название_хоста}, то в списке сайтов виртуальной машины данное ядро не появится до тех пор, пока не будет создан хотя бы один сайт (link) на это ядро.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Удалить сайт (2. Delete site)

Для удаления записи о дополнительном сайте необходимо в административном меню выбрать пункт 6. Configure pool sites > 2. Delete site и выбрать директорию удаляемого сайта (Enter site directory):

Внимание! Мастер удаления дополнительного сайта удаляет папку и базу данных дополнительного сайта, поэтому необходимо предварительно сделать бекап важных данных.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

3. Настройка задач cron (3. Change cron tasks on site)

По умолчанию в виртуальной машине cron уже включен. Если по каким-либо причинам нужно отключить службу cron, то для этого необходимо:

• Перейти в главном меню в 6. Configure pool sites > 3. Change cron tasks on site и ввести директорию сайта, для которого нужно отключить службу cron:

  

• Согласиться на отключение cron и дождаться пока задача будет закончена:

  

Аналогичным способом осуществляется включение cron:

Внимание! Информацию о том, как настроить в продуктах «1С-Битрикс» обработку всех агентов на cron, можно прочитать здесь.

4. Настройка SMTP (4. Change e-mail settings on site)

Внимание! При использовании нескольких физических веб-серверов в пуле (веб-кластер) автоматически не создается конфигурация msmtp на других серверах пула. Для работы конфигурации msmtp на spare-нодах кластера нужно скопировать вручную через ssh файл /home/bitrix/.msmtprc с master-ноды на spare-ноды
и сменить владельца/группу у этих файлов на bitrix:bitrix. Далее на spare-нодах создать файл /etc/@msmtprc и сделать симлинк с него на файл /home/bitrix/.msmtprc.

Настройки для почтовых сервисов

5. Настройка https на сайте (5. Change https settings on site)

6. Настройка резервного копирования сайта (6. Change backup settings on site)

/opt/webdir/bin/bx-sites -a backup -d sitemanager0 --enable --minute=10 --hour=23 --day=1 --month=any --weekday=any -o json | python -mjson.tool  
...
            "BackupCronFile": "/etc/crontab",
            "BackupDay": "1",
            "BackupFolder": "/home/bitrix/backup/archive",
            "BackupHour": "23",
            "BackupMinute": "10",
            "BackupMonth": "*",
            "BackupTask": "enable",
            "BackupVersion": "v5",
            "BackupWeekDay": "*", 
...

bitrix/cache
bitrix/managed_cache
bitrix/stack_cache
bitrix/local_cache
bitrix/backup
bitrix/tmp
upload/tmp
upload/resize_cache

/opt/webdir/bin/bx_backup.sh sitemanager /home/bitrix/backup/archive

tar xzvvf www_backup_dbvm04_22.08.2018_YBC0dLJe.tar.gz
-rw-rw-r-- bitrix/bitrix      490 2017-11-22 17:46 ./telephony/lines.php
-rw-rw-r-- bitrix/bitrix      543 2017-11-22 17:46 ./telephony/editgroup.php
-rw-rw-r-- bitrix/bitrix       42 2017-11-22 17:46 ./telephony/.access.php
-rw-rw-r-- bitrix/bitrix      496 2017-11-22 17:46 ./telephony/groups.php
drwxrwxr-x bitrix/bitrix        0 2017-11-22 17:26 ./auth/
-rw-rw-r-- bitrix/bitrix      593 2017-11-22 17:26 ./auth/.left.menu.php
-rw-rw-r-- bitrix/bitrix      534 2017-11-22 17:26 ./auth/index.php
-rw-rw-r-- bitrix/bitrix      248 2017-11-22 17:26 ./auth/.section.php
-rw-rw-r-- bitrix/bitrix  5794692 2018-08-22 16:29 home/bitrix/mysql_dump_dbvm04_22.08.2018_YBC0dLJe.sql
drwxr-xr-x                     Creating directory: home
drwxr-xr-x                     Creating directory: home/bitrix
-rw-rw-r-- bitrix/bitrix       44 2018-08-22 16:29 home/bitrix/mysql_dump_dbvm04_22.08.2018_YBC0dLJe_after_connect.sql

mysql sitemanager0 < home/bitrix/mysql_dump_sitemanager_30.01.2015_bnnW1NPm_after_connect.sql

SET PASSWORD FOR 'bitrix'@'localhost' = PASSWORD('ПАРОЛЬ');

rsync -av home/bitrix/ext_www/ /home/bitrix/ext_www/

7. Настройка NTLM-авторизации на всех сайтах (7. Configure NTLM auth for all sites)

Настройка NTLM-авторизации…

net ads testjoin

8. Настройка xmppd|smtpd сервисов для сайта (8. Configure optional services (xmppd|smtpd) for site)

Мастер позволяет управлять работой сервисов XMPP и SMTP с помощью Cron. Это может понадобится, если необходимо рассылать jabber- и почтовые сообщения в случае, если на сайте нет активности, т.е если все события на сайте работают на хитах.

Для управления необходимо:

• Из административного меню запустить мастер 6. Configure pool sites > 8 Configure optional services (xmppd|smtpd) for site:

  

• Далее указать:
  • Enter site-name — имя сайта;
  • Enter service name — имя сервиса xmppd или smtpd.
• И согласиться на активацию работы сервисов через Cron:

  

• После завершения данной задачи jabber-уведомления и почтовые сообщения будут отправляться по cron-расписанию, независимо от активности на сайте.

Аналогичным образом отключается данные опции:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

9. Настройка nginx для работы с композитом (9. Configure nginx for composite)

/opt/webdir/bin/bx-sites -o json -a composite --enable --site=default

/opt/webdir/bin/bx-sites -o json -a composite --disable --site=default

Условия работы композитного кеша

map $uri $composite_key {
  default                         $uri;
  ~^(?P.+)/$           $non_slash;
  ~^(?P.+)/index.php$  $non_index;
  ~^(?P.+)/index.html$ $non_index;
}

Конфигурационный файл сайта

Проверки для включения технологии на стороне NGINX используются в конфигурационном файле сайта, который в виртуальном окружении находится в каталоге /etc/nginx/bx/site_enabled. В случае стандартной конфигурации, файл обычно содержит следующие настройки:

    # Include parameters common to all websites
    include bx/conf/bitrix.conf;

При включенной технологии Композитный сайт, настройки зависят от выбранного хранилища.

Указанные в этом подразделе настройки производить не нужно. Здесь для ознакомления дано описание того, что происходит при включении настроек NGINX на технологию Композитный сайт в BitrixVM.

10. Настроить опции сайта (10. Configure site options)

1. Настроить параметр proxy_ignore_client_abort (1. Configure proxy_ignore_client_abort for site)

Внимание! Включение глобально параметра nginx proxy_ignore_client_abort нужно делать в крайних случаях, обычно это делать не требуется. Лучше это делать вручную и для конкретных location, а не глобально на весь сервер. В следующих версиях BitrixVM/BitrixEnv этот пункт меню будет переработан.

Включение параметра nginx proxy_ignore_client_abort может быть полезным при неполадках в работе Телефонии, Открытых линиях. Данный параметр определяет, закрывать ли соединение с проксированным сервером в случае, если клиент закрыл соединение, не дождавшись ответа.

Для управления необходимо:

• Из меню запустить мастер 10. Configure site options > 1. Configure proxy_ignore_client_abort for site, ввести имя сайта и согласиться на включение параметра proxy_ignore_client_abort:

  

• Дождаться завершения данной задачи.

Аналогичным образом отключается данный параметр:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

11. Сайты с ошибками (11. Show sites with errors)

Если по каким-либо причинам на сайтах появились серьезные ошибки: отсутствие модулей на сайте или нет подключения к БД (не получается подключиться с данными настроек сайта), то в меню виртуальной машины появляется пункт меню 6. Manage sites in the pool > 11. Show sites with errors:

Выбрав этот пункт меню, отобразится список сайтов с кратким описанием ошибки (в данном примере — нет соединения с базой данных mysql):

Примечание: Пункт меню 6. Configure pool sites > 11. Show sites with errors является скрытым и появляется только тогда, когда есть ошибки на сайтах под управлением виртуальной машиной BitrixVM или linux-окружением BitrixEnv. Как только ошибки будут исправлены, данный пункт снова скроется.

7. Управление Sphinx (7. Configure Sphinx service for the pool)

Использование Sphinx в качестве поискового механизма позволит значительно увеличить скорость поиска и снизит нагрузку на сервер.

1. Создать инстанс sphinx на сервере (1. Create sphinx instance on server)

Для установки Sphinx на сервер необходимо:

• Установить и обновить проект до последней актуальной версии;
• В меню виртуальной машины выбрать пункт 7. Configure Sphinx service for the pool > 1. Create sphinx instance on server:

  

• Далее ввести имя хоста, где будет запущен сервер поиска Sphinx (в данном примере server1):

  

• Выбрать базу данных ядра системы сайта из списка:

  

• Дать согласие на запуск полной переиндексации после установки сервера Sphinx:

  

• Подождать, пока задача по установке Sphinx и переиндексации будет закончена:

  

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

Примечание: Ручная настройка поискового механизма Sphinx описана в данном уроке.

2. Обновить настройки sphinx (создать индекс) (2. Update sphinx instance on server (add index))

Чтобы обновить настройки для всех Sphinx-инстансов, нужно перейти в главном меню 7. Configure Sphinx service for the pool > 2. Update sphinx instance on server (add index):

• 

  Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 Sphinx-инстанс с помощью меню 7. Configure Sphinx service for the pool > 1. Create sphinx instance on server.

• Далее ввести имя хоста, где будет запущен сервер поиска Sphinx (в данном примере server1):

  

• Выбрать базу данных ядра системы сайта из списка:

  

• Дать согласие на запуск полной переиндексации после установки сервера Sphinx:

  

• Подождать, пока задача по установке Sphinx и переиндексации будет закончена.

Эта опция запускает проверку текущей конфигурации одного или нескольких Sphinx-инстансов в пуле (если такие имеются) и запускает принудительную переиндексацию.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

Примечание: Ручная настройка поискового механизма Sphinx описана в данном уроке.

3. Удалить sphinx на сервере (3. Remove sphinx instance on server)

Для удаления Sphinx-инстанса с сервера необходимо:

• Выбрать пункт меню 7. Manage sphinx in the pool > 3. Remove sphinx instance on server.

  Примечание: Данный пункт меню появится только тогда, когда будет создан хотя бы 1 Sphinx-инстанс с помощью меню 7. Configure Sphinx service for the pool > 1. Create sphinx instance on server.

• Ввести имя хоста удаляемого Sphinx-инстанса (например server1):

  

• Выбрать базу данных ядра системы сайта из списка:

  

• Подождать, пока задача по удалению Sphinx-инстанса будет закончена.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

8. Управление веб-серверами (8. Manage pool web servers)

В «1C-Битрикс: Виртуальная машина» можно быстро развернуть кластеризацию веб-сервера в «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке».

При разделении проекта на несколько веб-серверов необходимо решить две задачи:

• синхронизация данных (файлов) между серверами
• балансировка нагрузки между серверами

Внимание! Перед тем как начинать использовать кластеризацию веб-сервера в BitrixVM/BitrixEnv нужно предварительно установить «1С-Битрикс: Управление сайтом» или в «Битрикс24 в коробке» с модулем Веб-кластер. Данный модуль входит только в старшие редакции продуктов «1С-Битрикс».

1. Создание веб-сервера (1. Create web role on server)

Для создания роли веб-сервера нужно:

• Выбрать пункт меню 8. Manage pool web servers > 1. Create web role on server и ввести имя хоста в пуле, на котором будет создан веб-сервер (в данном примере — server3):

  

• Выбрать вариант создания роли:
  1. one step — все действия по созданию web-роли будут произведены за 1 шаг. Данный вариант рекомендуется на простых проектах, где не так много данных.
  2. two steps — действия по созданию web-роли будут произведены за 2 шага для уменьшения ошибок в процессе создания роли. Данный вариант рекомендуется на крупных проектах, где очень много данных.

     Внимание! Если вы выбрали вариант two steps, после выполнения задачи 1-го шага нужно запустить 2-й шаг таким же образом на этом же сервере.

  

• Подождать, пока задачи по созданию веб-сервера будут закончены. И мы увидим, что у нас 2 сервера с ролью web в пуле: server1 и server3:

  

• Добавим еще одному серверу в пуле web-роль (server2) аналогичным способом. Мы видим, что у сервера с балансировщиком web-роль имеет тип main, а у дополнительных серверов пула — spare:

  

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Настроить модули PHP (2. Manage PHP extensions)

В разделе 8. Manage pool web servers > 2. Manage PHP extensions можно включить дополнительные модули PHP, которые могут понадобится в продуктах «1C-Битрикс».

На данный момент можно включить модуль SSH2 для PHP:

Выключается данный модуль аналогично:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

3. Настройка сертификатов (3. Configure certificates)

SSL-сертификат – это цифровая подпись сайта, она обеспечивает шифрованное соединение между посетителем сайта и сервером. Еще с помощью этого сертификата подтверждается подлинность сайта – любой посетитель может проверить, действительно ли этот сайт принадлежит данной компании.

Начиная с версии BitrixVM 7.2.0, добавилась возможность подключения SSL-сертификатов как бесплатного Let’s Encrypt, так и своего собственного сертификата, выпущенного любым авторизованным центром сертификации.

Центр сертификации Let’s Encrypt выдает SSL-сертификаты с проверкой домена (DV, Domain-validated certificate) бесплатно, срок их действия – 90 дней. Эти сертификаты
начального уровня подтверждают домен, а также шифруют и защищают данные при передаче с помощью протокола https. Установить его себе на сайт могут как физические лица, так и организации. Такие SSL-сертификаты подойдут для небольших сайтов и маленьких проектов, когда нет необходимости в большом доверии со стороны клиентов и посетителей сайта. В BitrixVM SSL-сертификаты Let’s Encrypt выпускаются в течение нескольких минут, а продление производится автоматически, примерно за месяц до истечения срока действия.

Если вам нужен SSL-сертификат, который предполагает высокое доверие к вашим продуктам, компании и сервисам, то такие сертификаты выпускают центры сертификации, при этом проводится более тщательная проверка:

• SSL-сертификаты с проверкой компании (OV, Organization validation) – кроме защиты информации гарантируется принадлежность домена конкретной организации. Сертификат выдается только юридическим лицам с подтвержденным номером телефона. На сайте с таким сертификатом посетитель может найти информацию об организации-владельце сайта, обычно просто щелкнув по иконке замочка.

• SSL-сертификаты с расширенной проверкой (EV, Extended validation) – то же, что и OV, только проверяется уже налоговая и коммерческая деятельность компании, причем более тщательно. На сайте рядом с замочком появляется название компании. Чаще всего такие сертификаты можно встретить у банков, онлайн-систем с большим количеством посетителей.

Собственные SSL-сертификаты, выпущенные авторизованными центрами, нужно выпускать и продлевать самостоятельно. В BitrixVM такие сертификаты нужно подключать каждый раз, когда происходит их перевыпуск в центре сертификации.

1. Настройка сертификата Let’s encrypt (1. Configure «Let’s encrypt» certificate)

Важно! Прежде, чем выпускать сертификат Let’s Encrypt, убедитесь, что у вас создан сайт на тот хост (и он доступен из интернета), на который выпускается сертификат, а также указаны правильные DNS-настройки у регистратора или хостера DNS для этого домена. Иначе сертификат не будет выпущен. Плюс к этому есть лимит – 5 ошибок в час выпуска сертификата на аккаунт для одного домена.

Для создания SSL-сертификата Let’s Encrypt нужно:

• Перейти в меню 8. Manage pool web servers > 3. Configure certificates:

  

• Выбрать пункт меню 1. Configure «Let’s encrypt» certificate и ввести:
  • site name – имя сайта или несколько имен сайтов, для которых нужно выпустить сертификат(ы) Let’s encrypt (в данном примере: test2.b24test.site)
  • dns name(s) – все домены данного сайта, для которых должен быть выпущен сертификат, включая домен с www и без, вводить несколько доменов через запятую
  • email for LE notifications – почтовый адрес для уведомлений сервиса Lets Encrypt

  и подтвердить ввод:

  

• Мастер самостоятельно запросит и установит сертификат в течение нескольких минут. Пути SSL-сертификатов будут указаны в этом же разделе:

  

• Проверить выпущенный сертификат можно легко – перейти на ваш сайт по протоколу https, у валидного сертификата будет замочек:

  

Срок действия сертификата – 90 дней. Перевыпуск сертификата происходит автоматически за 20 дней до окончания срока его действия.

Ручное обновление сертификата

С версии BitrixVM 7.4.0 проверка сертификатов автоматически производится еженедельно в субботу в 2 часа ночи по cron-у.

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

Также вы можете вручную обновить сертификаты командой:

/home/bitrix/dehydrated/dehydrated -c

Система проверит сроки действия сертификатов и при необходимости запустит обновление.

Лог обновления сертификатов можно посмотреть по пути: /home/bitrix/dehydrated_update.log.

2. Настройка собственного сертификата (2. Configure own certificate)

3. Восстановление сертификата по умолчанию (3. Restore default certificate)

Если что-то пошло не так или вы хотите восстановить самоподписанный сертификат, который создается при первом запуске BitrixVM, то для этого нужно:

• Перейти в меню 8. Manage pool web servers > 3. Configure certificates:

  

• Выбрать пункт меню 3. Restore default certificate и ввести certificate file path – это путь к сертификату, который указан в таблице в поле Certificate (в данном примере: /home/bitrix/dehydrated/certs/test2.b24test.site/fullchain.pem) и подтвердить действие:

  

• Мастер самостоятельно восстановит SSL-сертификат по умолчанию в /etc/nginx/ssl/cert.pem:

  

4. Удаление роли web c сервера (4. Remove web role from server)

Для удаления веб-сервера необходимо:

• Выбрать пункт меню 8. Manage pool web servers > 4. Remove web role from server:

  

• Ввести имя хоста сервера, у которого удаляется роль web (например server3):

  

  Внимание! Удалять web-роль можно только типа spare, тип main (сервер с балансировщиком) удалять нельзя.

• Подождать, пока задача по удалению роли будет закончена.
• В итоге из 3 веб-серверов только на двух останется web-роль (main — server1, spare — server2):

  

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

9. Настроить сервис Push/RTC (9. Configure Push/RTC service for the pool)

Внимание! Данный пункт меню доступен в VMBitrix с версии 7.1.0.

Push-сервер (pulling-сервер, сервер мгновенных сообщений) предназначен для быстрого обмена сообщениями между пользователями, которые заходят на портал через браузер или подключаются с помощью настольного или мобильного приложений.

По умолчанию в VMBitrix для Push&Pull сервера используется модуль Nginx-PushStreamModule. Главный его недостаток — если сервис падает по какой-либо причине, то недоставленные сообщения теряются, что порождает высокую нагрузку на PHP-бэкенд из-за особенностей работы модуля nginx. Новый модуль на NodeJS лишен этих недостатков.

По умолчанию в VMBitrix.CRM для Push&Pull сервера используется модуль на NodeJS.

1. Настроить NodeJS RTC сервис (1. Install/Update NodeJS RTC Service)

Модуль сервера очередей Nginx-PushStreamModule устарел и может работать нестабильно (зависание сообщений, падения). В результате чего сообщения могут не доставляться, это вызывает высокую нагрузку на службу PHP из-за особенностей работы модуля Nginx. Также он ограничен в функционале – в нем нет поддержки protobuf и персональных каналов, которые работают без сервера, нет возможности опроса публичного канала, чтобы узнать, кто в сети, и т.д.

Поэтому крайне рекомендуется использовать вместо устаревшего Nginx-PushStreamModule новый NodeJS-Pushserver.

Чтобы перейти на новый модуль NodeJS RTC вместо Nginx-PushStreamModule, нужно:

1. В главном меню виртуальной машины выбрать пункт 9. Configure Push/RTC service for the pool > 1. Install/Update NodeJS RTC Service:

   

2. Ввести имя хоста, где нужно запустить NodeJS RTC сервис (в примере мы выбрали server1 c запущенным сервисом NginxStreamModule), согласиться на смену модуля NginxStreamModule на NodeJS Push:

   

3. Подождать, пока задачи по запуску NodeJS RTC Push&Pull сервера будут закончены:

   

Примечание В пуле может быть только один сервис Push&Pull. Если у вас запущен Push&Pull сервис на одном сервере, и вы выбираете в качестве сервера другую машину, то мастер остановит Push&Pull сервис на первой машине и запустит его на другой.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

Доп. материалы:

• Настройка сервера очередей Push and Pull
• Переход с Nginx-PushStreamModule на Bitrix Push server 2.0
• Переход с Bitrix Push server 1.0 на Bitrix Push server 2.0
• Использование отдельного сервера очередей
• Настройка и запуск push сервера на стороннем окружении

2. Удалить NodeJS RTC инстанс (2. Uninstall NodeJS RTC instance)

Чтобы перейти с NodeJS RTC обратно на модуль Nginx-PushStreamModule, нужно:

1. В главном меню виртуальной машины выбрать пункт 9. Configure Push/RTC service for the pool > 2. Uninstall NodeJS RTC instance:

   

2. Ввести имя хоста, где нужно перейти обратно на Nginx-PushStreamModule (в примере мы выбрали server1 c запущенным сервисом NodeJS RTC), согласиться на удаление NodeJS RTC:

   

3. Подождать, пока задачи по запуску Nginx-PushStreamModule Push&Pull сервера будут закончены:

   

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

10. Фоновые задачи (10. Background pool tasks)

11. Настроить сервис «Конвертер файлов» (11. Configure Transformer service)

Конвертер файлов выполняет преобразование документов и видеофайлов для просмотра в постах или комментариях ленты Новостей и Задач, в Диске, а также осуществляет генерацию документов по шаблонам в CRM.

Роль Конвертер файлов в VMBitrix доступна, начиная с версии 7.5.0.

Для работы роли Конвертер файлов необходимо, чтобы в «1С-Битрикс24» были установлены:

• Модуль «Конвертер файлов» (transformer) версии 20.100.0 и выше.
• Модуль «Сервер конвертации файлов» (transformercontroller) версии 20.100.0 и выше.

Внимание! Модуль «Сервер конвертации файлов» (transformercontroller) доступен только в редакции «1С-Битрикс24: Энтерпрайз». Роли Конвертер файлов нет в меню VMBitrix.CRM в связи с недоступностью модуля «Сервер конвертации файлов» (transformercontroller) в редакции «1C-Битрикс24.CRM»

После установки модулей их настройка не требуется, новая роль при ее активации сама настроит нужные опции для вашего сайта.

1. Настроить сервис «Конвертер файлов» (1. Configure Transformer service)

Для настройки роли Transformer:

1. В главном меню виртуальной машины выберите пункт 11. Configure Transformer service – 1. Configure Transformer service:

   

2. Введите имя сайта (в примере vm1.local):

   

3. Перед запуском роли Transformer будет выдано оповещение об устанавливаемом ПО. После этого запустится задача configure_transformer_**********, которая:
   • установит пакеты erlang, rabbitmq, libreoffice6.4, ffmpeg и их связи;
   • настроит модули Конвертер файлов (transformer) и Сервер конвертации файлов (transformercontroller) для указанного сайта.

   

4. После завершения задачи в модулях Сервер конвертации файлов (transformercontroller) и Конвертер файлов (transformer) будут прописаны все необходимые настройки:

   

5. Далее убедитесь, что в Настройках Битрикс24 публичной части или в административном интерфейсе в настройках модуля Диск (Настройки – Настройки продукта – Настройки модулей – Диск) установлена опция Просматривать документы с помощью Битрикс24:

   

6. Все готово.

Уроки по теме

Для дальнейшей эксплуатации могут понадобиться другие учебные материалы:

• Установка и настройка сервера конвертации файлов
• Нагрузка и логирование
• Использование сервера конвертации файлов другими сайтами

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

2. Удалить сервис «Конвертер файлов» (2. Remove Transformer service)

Чтобы удалить роль Конвертер файлов, нужно:

• В главном меню виртуальной машины выбрать пункт 11. Configure Transformer service – 2. Remove Transformer service:

  

• Выбрать пункт 1. Remove Transformer service и согласиться на удаление роли:

  

• Запустится задача, которая деактивирует запущенные раннее сервисы, удалит их данные и сбросит настройки модулей «Конвертер файлов» (transformer) и «Сервер конвертации файлов» (transformercontroller).

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 10. Background pool tasks > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

Дополнительные настройки BitrixVM/BitrixEnv

Изменение стандартных настроек BitrixVM без отключения автоподстройки

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

При запуске виртуальной машины BitrixVM или физического сервера с установленным пакетом BitrixEnv сервисом bvat автоматически настраиваются основные параметры Apache, PHP, MySQL и nginx в зависимости от количества доступной памяти. Это позволяет обеспечивать оптимальные настройки сервера.

Но в ряде случаев возникает необходимость изменения некоторых параметров без отключения сервиса bvat. Для внесения таких изменений в настройки сервера предусмотрены специальные конфигурационные файлы, позволяющие переопределять параметры, устанавливаемые сервисом bvat. Они имеют свое название и хранятся в директориях:

• MySQL: /etc/mysql/conf.d/z_bx_custom.cnf

• Apache: /etc/httpd/bx/custom/z_bx_custom.conf

• nginx:
  • /etc/nginx/bx/site_ext_enabled/ — конфигурационные файлы своих дополнительных сайтов для всего сервера (например, bx_ext.conf, bx_ext_custom1.conf, ext_custom_site.com.conf и т.п)
  • /etc/nginx/bx/settings/ — конфигурационные файлы настроек для уровня http всего сервера (например, z_bx_custom.conf, z_bx_custom1.conf и т.п)
  • /etc/nginx/bx/site_settings/<SITE_NAME>/ — персональные настройки конкретного сайта, начиная с версии BitrixVM 7.5 или бета версии 7.4.10 (например, /etc/nginx/bx/site_settings/site.com/myconfig.conf).

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

• PHP: /etc/php.d/z_bx_custom.ini

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

Увеличение дискового пространства BitrixVM

При использование виртуальной машины BitrixVM или ami-образа BitrixVM, со временем может возникнуть проблема нехватки свободного места.

Решить эту проблему можно двумя способами:

1. добавить в виртуальную машину еще один жесткий диск, смонтировать его в системе и перенести на него часть контента (наиболее оптимальный способ);
2. увеличить размер существующего виртуального жесткого диска.

Добавление дополнительного жесткого диска BitrixVM

Так как основной объем дискового пространства потребляется контентом сайтов и их резервными копиями, расположенными в /home/bitrix, а также БД, расположенной в /var/lib/mysql, то на отдельные диски следует выносить именно эти разделы.

Рассмотрим данную задачу на примере переноса на отдельный диск папки /home с контентом сайтов и их резервными копиями.

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

  

  

• После добавления диска, для его инициализации, возможно, потребуется перезагрузить сервер. Увидеть новый диск и присвоенное ему буквенное обозначение можно, выполнив команду:

  fdisk -l

  

• Запускаем утилиту fdisk для работы с диском /dev/sdb:

  fdisk /dev/sdb

  И командой n создаем новый раздел:

  • основной (primary partition) — команда p и Partition number (1-4): 1;
  • первый и последний сектора при этом выбираем по умолчанию — таким образом, будет создан раздел, используя все свободное пространство на диске:

  

Для сохранения изменений на диск и выхода из fdisk введите команду w.

• После сохранения таблицы разделов, форматируем новый раздел и переносим на него информацию из /home:

  CentOS 6

  mkfs.ext4 /dev/sdb1 
  mount /dev/sdb1 /mnt 
  service httpd stop 
  service nginx stop
  mv -f /home/* /mnt 
  umount /mnt
  

  CentOS 7

  mkfs.ext4 /dev/sdb1 
  mount /dev/sdb1 /mnt 
  systemctl stop httpd.service
  systemctl stop nginx.service
  mv -f /home/* /mnt 
  umount /mnt
  

• Следующим шагом определяем UUID нового диска:

  blkid
  /dev/sda1: UUID="99066558-ba04-465c-9962-e827aa2928ec" TYPE="ext4" 
  /dev/sda2: UUID="8ea38ef9-1ee5-423b-a013-15fd603a678e" TYPE="swap" 
  /dev/sda3: UUID="08ec5c65-8fd8-47ac-a998-d81195c8f964" TYPE="ext4" 
  /dev/sdb1: UUID="b2e58731-b621-4bd5-909a-afe3bb5dd8a1" TYPE="ext4"
  

  и добавляем запись (в данном примере: UUID=b2e58731-b621-4bd5-909a-afe3bb5dd8a1) о нем в /etc/fstab (вместо UUID можно также использовать имя устройства /dev/sdb):

  

• Остается только примонтировать новый диск и запустить остановленные ранее службы:

  CentOS 6

  mount /home 
  service httpd start 
  service nginx start 
  

  CentOS 7

  mount /home 
  systemctl start httpd.service
  systemctl start nginx.service
  

Добавление дисков в других средах виртуализации или непосредственно на физическом сервере проходит аналогично.

Внимание! Если создаете на новом диске директорию /home/bitrix/www вручную, то убедитесь, чтобы она имела права bitrix:bitrix — 755 для директории и 644 — для файлов.

Увеличение размера существующего жесткого диска BitrixVM

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

1. Сначала измените размер системного диска на требуемый, например до 100Гб:

   Изменить размер системного диска в VMWare

   Изменить размер системного диска в VirtualBox

2. Далее необходимо запустить виртуальную машину BitrixVM, авторизоваться под root и перейти в режим командной строки (консоль), выбрав пункт меню 0. Exit в виртуальной машине.

3. Смотрим диск и присвоенное ему буквенное обозначение консольной командой:

   fdisk -c -u -l

   

   где для диска /dev/sda:

   • sda1 — загрузочный сектор диска;
   • sda2 — файл подкачки (swap);
   • sda3 — раздел, в котором установлена операционная система и который как раз и нужно увеличить.
4. Запускаем утилиту fdisk для работы с диском /dev/sda:

   fdisk -c -u /dev/sda

5. Командой d удаляем раздел sda3, выбрав Partition number (1-4): 3:

   

   Внимание! Данные с диска при этом никуда не удаляются, в данном случае удаляется лишь запись о разделе из таблицы разделов диска.

6. Далее командой n создаем новый раздел:
   • основной (primary partition) — команда p и Partition number (1-4): 3;
   • первый и последний сектора при этом выбираем по умолчанию — таким образом, будет создан раздел, используя все свободное пространство на диске.

   

7. Для сохранения обновленной таблицы разделов и выхода из fdisk введите команду w:

   

8. Чтобы система подгрузила новую таблицу разделов, необходима перезагрузка виртуальной машины:

   reboot

9. После перезагрузки с помощью утилиты resize2fs увеличиваем размер файловой системы раздела /dev/sda3:

   resize2fs /dev/sda3

   

Проверить, что раздел увеличен можно с помощью команды df:

Изменение размера дисков в других средах виртуализации проходит аналогично.

Увеличение размера LVM-раздела BitrixEnv

Пусть размер системного диска был увеличен с 20 ГБ до 100Гб, как было сделано ранее в VMWare или VirtualBox (пункт 1).

Тогда действия по изменению размера LVM-раздела будут такими:

1. Смотрим, что в системе на данный момент есть из устройств/разделов командой:

   fdisk -l

   

2. Убеждаемся, что место в системе автоматически не увеличилось при помощи команды:

   df -h

   

   Здесь мы также видим и запоминаем имя группы томов и имя тома – centos_vb1-root (у вас они будут другие):

   • centos_vb1 – имя группы томов;
   • root – имя тома.

3. Создаем новый раздел sda3 – тип раздела: Linux LVM (код типа 8e) на неразмеченной области. Для этого начинаем работу с устройством sda c помощью команды:

   fdisk /dev/sda

4. Далее командой n создаем новый раздел:
   • основной (primary partition) – команда p и Partition number (1-3, default 3): 3 (так как у нас было 2 логических раздела sda1 и sda2 – см. п.1);
   • первый и последний сектора при этом выбираем по умолчанию – нажмите Enter, таким образом, будет создан раздел, используя все свободное пространство на диске;
   • укажем тип раздела – команда t и Partition number (1-3, default 3): 3;
   • вводим код типа раздела, соответствующий Linux LVM – 8e;
   • смотрим таблицу разделов – команда p и убеждаемся, что все верно;
   • Раздел sda3 создан. Для сохранения обновленной таблицы разделов и выхода из fdisk – команда w.

     

5. Чтобы система подгрузила новую таблицу разделов, необходима перезагрузка виртуальной машины:

   reboot

6. После перезагрузки необходимо создать физический том sda3:

   pvcreate /dev/sda3

7. Далее расширяем группу томов на новое пространство, используя имя группы томов centos_vb1 (которое мы запомнили ранее в п.2):

   vgextend /dev/centos_vb1 /dev/sda3

8. Теперь расширим логический том, используя имя тома root (которое мы запомнили ранее в п.2):

   lvextend -l+100%FREE /dev/centos_vb1/root

9. Сканируем диски на предмет наличия групп томов и активируем все найденные группы томов:

   vgscan
   vgchange -ay
   

   

10. Узнаем тип файловой системы:

    file -s /dev/sda1

    

    Видим, что файловая система XFS.

11. И наконец, расширяем файловую систему XFS (может потребоваться время):

    xfs_growfs /dev/centos_vb1/root

    

    Внимание! Если файловая система не XFS, а, например, ext4 или reiserfs, то команды будут такие (с учетом centos_vb1 – имя группы томов и root – имя тома из п.2):

    • resize2fs /dev/centos_vb1/root – для ext4;
    • resize_reiserfs /dev/centos_vb1/root – для reiserfs;
12. Проверяем итоговый результат:

    df -h

    

Подключение Swap-раздела

Виртуальная машина BitrixVM поставляется с swap-разделом 256 МБ, а в образе ami он по умолчанию не подключен. Поэтому в процессе эксплуатации может возникнуть необходимость в расширении раздела подкачки.

Как и в случае с увеличением свободного места, наиболее простой способ — добавить дополнительный диск и разместить раздел подкачки на нем, либо создать файл подкачки.

Для этого:

• подключаем к виртуальной машине диск или создаем файл подкачки:

  dd if=/dev/zero of=/swapfile bs=1M count=1024
  

• создаем на диске:

  mkswap /dev/sdb1
  

  или в файле swap-раздел:

  mkswap /swapfile
  

• подключаем раздел подкачки:

  swapon /dev/sdb1
  

  или файл подкачки:

  chmod 600 /swapfile
  swapon /swapfile
  

• и наконец, добавляем запись о новом разделе подкачки в /etc/fstab, чтобы не включать после каждой перезагрузки вручную:

  /dev/sdb1 none swap sw 0 0
  

  или о файле подкачки:

  /swapfile none swap sw 0 0
  

Ручная настройка memcached

Исправление ошибок в старых сайтах с кодировкой windows-1251

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

При обновлении старых сайтов в кодировке Windows-1251, созданных в VMBitrix версии 7.4.3 или ниже, могут быть следующие ошибки:

• Не работает Система обновлений продуктов «1С-Битрикс» – требует наличия параметра mb_internal_encoding('Windows-1251'); в dbconn.php.

• При включенных предупреждениях Система обновлений не работает из-за предупреждения: «PHP Warning: htmlspecialchars(): charset `latin’ not supported, assuming utf-8».

• Проверка системы выдает ошибку «Строковые функции strtoupper и strtolower работают некорректно».

При обновлении VMBitrix до версии 7.5 и выше данные ошибки в установленных ранее сайтах в кодировке Windows-1251 автоматически не исправляются, поэтому вам нужно исправить их вручную для каждого такого сайта.

1. Добавьте в файл /bitrix/php_interface/dbconn.php сайта строку:

   mb_internal_encoding('Windows-1251');
   

2. В конфигурационном файле Apache для вашего сайта /etc/httpd/bx/conf/bx_ext_[ваш_сайт].conf замените строку:

   php_admin_value default_charset latin
   

   на такую:

   php_admin_value default_charset cp1251
   

   И перезапустите Apache:

   systemctl restart httpd.service
   

3. Проверьте, есть ли локаль ru_RU.cp1251 в системе. Если ответ 0 – значит локали ru_RU.cp1251 нет, если 1 – есть:

   locale -a | grep ru_RU.cp1251 -ic
   

   Если локали ru_RU.cp1251 нет, выполните команду:

   localedef -c -i ru_RU -f CP1251 ru_RU.CP1251
   

4. Далее добавьте в файл /bitrix/php_interface/dbconn.php вашего сайта в кодировке windows-1251 две строки:

   setlocale(LC_ALL, 'ru_RU.CP1251' );
   setlocale(LC_NUMERIC, 'C' );
   

   И перезапустите Apache:

   systemctl restart httpd.service
   

5. Все готово. Проделайте эти действия для каждого сайта с кодировкой windows-1251, установленного ранее.

Примечание: В VMBitrix 7.5 и выше новые сайты, создаваемые в кодировке Windows-1251, проблем с однобайтовыми кодировками не имеет.

Корректное монтирование Windows-ресурсов

В случае необходимости подключения сетевого диска Windows в качестве хранилища для WebDAV можно воспользоваться следующей командой:

mount.cifs \\xxx.xxx.xxx.xxx\folder /home/bitrix/www/docs/folder/smb -o user=XXXX,password=XXXX,uid=600,gid=600,file_mode=0777,noserverino  

где:

• uid — идентификатор пользователя bitrix;
• gid — идентификатор группы bitrix;
• \\xxx.xxx.xxx.xxx\folder — путь к сетевому ресурсу \xxx.xxx.xxx.xxxfolder ( используется для экранирования символов);
• /home/bitrix/www/docs/folder/smb — папка, куда будет смонтирован диск.

Примечание: Использование опции noserverino является обязательным, так как в PHP есть уязвимость.

Выполнение всех агентов на Cron

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

COption::SetOptionString("main", "mail_event_bulk", "20"); 
echo COption::GetOptionString("main", "mail_event_bulk", "5");

// если скрипт выполняется кроном, то лимит подключения к БД - 600 секунд, иначе - 60
@set_time_limit(php_sapi_name() == "cli" ? 600 : 60);

Опции монтирования

Для обеспечения более высокой производительности файловой системы рекомендуем отключать изменение метки времени при чтении файлов и директорий: noatime, nodiratime.

Для этого в /etc/fstab нужно отредактировать (добавить в текущую строку) параметры в строке со своим UUID:

UUID=abd9bdaa-e17d-40b3-aee5-37ef53a57b16 /    ext4    defaults,noatime,nodiratime    1 1

где UUID=abd9bdaa-e17d-40b3-aee5-37ef53a57b16 — уникальный идентификатор диска, который можно узнать в консоли по команде blkid.

Примечание: Вместо UUID можно также использовать имя устройства: /dev/sda1, /dev/sda2, /dev/sda3. Или метку тома если она задана, например: LABEL=root.

После перезагрузки новые настройки начнут действовать.

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

mount -o remount,noatime,nodiratime /

Подключение IDE

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

Для упрощения работы с Bitrix Framework в виртуальную машину включён Xdebug. Работает он по схеме:

Перед изменением настроек надо переименовать файл xdebug.ini.disabled в xdebug.ini и перезапустить httpd.

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

$ cat /etc/php.d/xdebug.ini
; Enable xdebug extension module
zend_extension=/usr/lib64/php/modules/xdebug.so
xdebug.remote_enable=on
xdebug.remote_host=192.168.205.1
xdebug.remote_port=9000

Примечание: Xdebug требует использовать proxy при работе через Network Address Translation (NAT), необходимо открыть порт 9000.

Исходные коды пакетов (начиная с версии 7.3.0!)

При разработке своих решений на основе виртуальной машины BitrixEnv/VMBitrix.CRM, может понадобиться отслеживание изменений в версиях файлов. Для этого вы можете подключить репозиторий исходников виртуальной машины.

Внимание! Исходные коды пакетов доступны для стабильных и бета-версий VMBitrix/VMBitrix.CRM, начиная с версии 7.3.0.

Стабильная VMBitrix/VMBitrix.CRM

1. Добавляем файл для репозитория /etc/yum.repos.d/bitrix-source-stable.repo с содержимым:

   [bitrix-source-stable]
   name=$OS $releasever - source
   failovermethod=priority
   baseurl=https://repo.bitrix.info/yum/SRPMS
   enabled=1
   gpgcheck=1
   gpgkey=https://repo.bitrix.info/yum/RPM-GPG-KEY-BitrixEnv
   

2. Проверяем, что есть пакет yum-utils:

   yum clean all && yum install yum-utils
   

3. Скачиваем исходники виртуальной машины:

   • VMBitrix:

     yumdownloader --source bitrix-env
     

     Примерный ответ в консоли для обычной VMBitrix

   • VMBitrix.CRM

     yumdownloader --source bitrix-env-crm
     

     Примерный ответ в консоли для VMBitrix.CRM

Бета VMBitrix/VMBitrix.CRM

1. Добавляем файл для репозитория /etc/yum.repos.d/bitrix-source-beta.repo с содержимым:

   [bitrix-source-beta]
   name=$OS $releasever - source
   failovermethod=priority
   baseurl=https://repo.bitrix.info/yum-beta/SRPMS
   enabled=1
   gpgcheck=1
   gpgkey=https://repo.bitrix.info/yum/RPM-GPG-KEY-BitrixEnv
   

2. Проверяем, что есть пакет yum-utils:

   yum clean all && yum install yum-utils
   

3. Скачиваем исходники виртуальной машины:

   • VMBitrix:

     yumdownloader --source bitrix-env
     

   • VMBitrix.CRM

     yumdownloader --source bitrix-env-crm
     

Ручное включение php-расширений

yum list php-imap*

yum install php-imap

Настройка проксирования в BitrixVM

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

Очень частая ситуация, когда BitrixVM располагают внутри локальной сети офиса и проксируют запросы на нее из внешней сети Интернет.

Под проксированием будем понимать http-прокси, который имеет внешний адрес и позволяет организовать подключение пользователей к сайту, расположенному на виртуальной машине BitrixVM, а также сетевое оборудование, которое позволяет на уровне TCP/IP организовать подключение.

Настройка сервера

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

server {
	listen 1137;
	listen 1139 default_server ssl;

	#access_log off;

	server_name _;

	# ssl settings
	include bx/conf/ssl.conf;


	# Include im subscrider handlers
	include bx/conf/im_subscrider.conf;

	location / {
		deny all; 
	}
}

service nginx restart

systemctl restart nginx.service

iptables -I INPUT -p tcp -m state --state NEW -m tcp --dport 1137 -j ACCEPT
iptables -I INPUT -p tcp -m state --state NEW -m tcp --dport 1139 -j ACCEPT
iptables-save > /etc/sysconfig/iptables

firewall-cmd --permanent --add-port=1137/tcp
firewall-cmd --permanent --add-port=1139/tcp
firewall-cmd --reload

'pull_s1' => 'BEGIN GENERATED PUSH SETTINGS. DON'T DELETE COMMENT!!!!',
'pull' => Array(
    'value' =>  array(
...
        'path_to_websocket' => 'ws://#DOMAIN#:1137/bitrix/subws/',
        'path_to_websocket_secure' => 'wss://#DOMAIN#:1139/bitrix/subws/',
...
    ),
),
'pull_e1' => 'END GENERATED PUSH SETTINGS. DON'T DELETE COMMENT!!!!',

Проксирование запросов

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

Предположим, что в качестве внешнего прокси выступает nginx сервер.

При желании можно данные настройки адаптировать и для других прокси-сервисов.

location ~* ^/bitrix/subws/ {
    access_log off;
    proxy_pass http://nodejs_sub;
    # http://blog.martinfjordvald.com/2013/02/websockets-in-nginx/
    # 12h+0.5
    proxy_max_temp_file_size 0;
    proxy_read_timeout  43800;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $replace_upgrade;
    proxy_set_header Connection $connection_upgrade;
}

location ~* ^/bitrix/sub/ {
    access_log off;
    rewrite ^/bitrix/sub/(.*)$ /bitrix/subws/$1 break;
    proxy_pass http://nodejs_sub;
    proxy_max_temp_file_size 0;
    proxy_read_timeout  43800;
}

location ~* ^/bitrix/rest/ {
    access_log off;
    proxy_pass http://nodejs_pub;
    proxy_max_temp_file_size 0;
    proxy_read_timeout  43800;
}

iptables -I INPUT -p tcp --match multiport --dport 8010:8015 -j ACCEPT
iptables -I INPUT -p tcp --match multiport --dport 9010:9011 -j ACCEPT
iptables-save > /etc/sysconfig/iptables

firewall-cmd --permanent --add-port=8010-8015/tcp
firewall-cmd --permanent --add-port=9010-9011/tcp
firewall-cmd --reload

set_real_ip_from BALANCER_IP;
real_ip_header X-Forwarded-For;

service nginx restart

systemctl restart nginx.service

proxy_set_header X-Forwarded-Proto $scheme;

map $http_x_forwarded_proto $balancer_port {
   default 80;
   "https" 443;
}

map $http_x_forwarded_proto $balancer_https {
    default "NO";
    "https" "YES";
}

proxy_set_header Host $host:80;

proxy_set_header Host $host:$balancer_port;
proxy_set_header HTTPS $balancer_https;

service nginx restart

systemctl restart nginx.service

BitrixVM API для провайдеров

В главе описывается API, помощью которого можно подключить процедуру заказа/создания машины в управлении пулом в продуктах «1С-Битрикс».

Провайдеры

Вся работа с провайдерами осуществляется с помощью плагинов, расположенных в определенном каталоге (на текущий момент всё управление сделано на файлах):
/opt/webdir/providers.

Для каждого провайдера предусмотрены:

• обязательные параметры командной строки для универсализации доступа к их возможностям;
• стандартизированный вывод по завершению обработки результатов.

Скрипт плагина, который будет использован в web-интерфейсе продуктов «1С-Битрикс», должен быть раcположен по адресу:

/opt/webdir/providers/{provider_name}/bin/{provider_name}

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

• help — отображает поддерживаемые аргументы командной строки:

  {
    "options": [
      "help",
      "configs",
      "order",
      "order_status"
    ],
    "status": "enabled"
  }
  

  Массив options должен содержать список поддерживаемых опций (например, в данном случае отсутствует опция init, которая позволяет подключиться на этапе создания мастер сервера).

  Опция status может содержать следующие значения: disabled или enabled, что позволяет определить включен или выключен провайдер на конкретном сервере.

• configs — отображает список поддерживаемых конфигураций:

  {
    "configurations": [
      {
        "id": "1",
        "descr": "Bitrix-env, 1 month, Centos-6 x86_64, CPU 2x1.0 Ghz, Memory 1Gb, HDD 20Gb"
      }
    ],
    "status": "enabled"
  }
  

  configurations — содержит список сервисов/конфигураций, которые может заказать пользователь, используя web интерфейс «1С-Битрикс».

  На текущий момент поддерживается два параметра по каждой конфигурации:

  • id — идентификатор конфигурации, который будет использован в заказе,
  • descr — описание для пользователя.
• order — позволяет заказать сервер/VPS выбранной конфигурации, вторым параметром в данном случае будет передан номер конфигурации:

  {"task_id":"24"}
  

  task_id должен содержать номер задания, который используется для дальнейшего опроса и старта добавления машины по завершению.

• order_status — позволяет получить информацию по заказу:

  {
    "server_password": "XXXXXXXXXXXXXX",
    "status": "finished",
    "server": "xxx.xxx.xxx.xxx",
    "task_id": "24"
  }
  

  где:

  • status — содержит информацию по заказу, может содержать следующие значения:
    • in_progress — находится на обработке со стороны провайдера/хостера;
    • finished — обработка завершена, можно добавлять машину в пул;
    • error — во время выполнения произошла ошибка.
  • server — содержит ip address или имя машины;
  • server_password — содержит пароль пользователя root для копирования ssh-ключей при подключение сервера в пул.

  Любое из действий может сообщить об ошибке с помощью значений в полях error и error_message. Например:

  {
    "error_message": "get_task error N102, No task found",
    "error": 1
  }
  

Внимание! Информацию о работе скрипта, который использует возможности провайдеров и позволяет подключить их в web- интерфейс, см Скрипт работы с провайдерами.

Скрипт работы с провайдерами

Данный скрипт нужен для встраивания плагинов провайдеров в web- интерфейс продуктов «1C-Битрикс».

На текущий момент реализованы следующие методы:

• list — отображает список всех провайдеров, для которых существуют подкаталоги в директории /opt/webdir/providers на машине:

  {
    "params": {
      "providers": {
        "superprovider": {
          "status": "enabled"
        },
        "amazon": {
          "error": 1,
          "message": "bxProvider::optionsProvider: Provider amazon not exist on the host"
        }
      }
    }
  }
  

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

  В случае если провайдеров нет на хосте, список будет пустым:

  {
    "params": {
      "providers": {
        
      }
    }
  }
  

• status — покажет статус для провайдера:

  /opt/webdir/bin/bx-provider -a status --provider superprovider -o json
  {
    "params": {
      "provider_options": {
        "superprovider": {
          "options": {
            "order_status": 1,
            "order": 1,
            "help": 1,
            "configs": 1,
            "init": 0
          },
          "status": "enabled",
          "files": {
            "execute": "/opt/webdir/providers/superprovider/bin/superprovider",
            "holder": "/opt/webdir/providers/superprovider",
            "config": "/opt/webdir/providers/superprovider/etc/superprovider.conf"
          },
          "name": "superprovider",
          "config": "exists"
        }
      }
    }
  }
  

  В данном случае печатает внутреннюю информацию (используется как есть внутри обработчика), по сути, такой статус больше подходит для отладки работы провайдера, чем для использования в web-интерфейсе.

• install и uninstall — создает/удаляет данные для провайдера (на текущий момент больше для отладки, возможно, в дальнейшем с помощью этих методов хостеры смогут установить свой плагин на сервер и удалить его):

  /opt/webdir/bin/bx-provider -a install --provider amazon --archive /tmp/amazon-v01.tar.gz
  

• configs — отображает список всех конфигураций провайдера:

  /opt/webdir/bin/bx-provider -a configs --provider superprovider -o json
  {
    "params": {
      "provider_configs": {
        "superprovider": {
          "configurations": [
            {
              "id": "1",
              "descr": "Bitrix-env, 1 month, Centos-6 x86_64, CPU 2x1.0 Ghz, Memory 1Gb, HDD 20Gb"
            }
          ],
          "status": "enabled"
        }
      }
    }
  }
  

• order — заказывает виртуальный сервер или VPS:

  /opt/webdir/bin/bx-provider -a order --provider superprovider --config_id 1 -o json
  {
    "params": {
      "provider_order": {
        "superprovider": {
          "task_id": "25"
        }
      }
    }
  }
  

• order_status — отображает статус заказа:

  /opt/webdir/bin/bx-provider -a order_status --provider superprovider --task_id 25 -o json 
  {
    "params": {
      "provider_order": {
        "superprovider": {
          "server_password": "XXXXXXXXXXXXXXX",
          "status": "complete",
          "server": "xxx.xxx.xxx.xxx"
          "task_id": "25"
        }
      }
    }
  }
  

• orders_list — список всех заказов, сделанных на хосте:

  /opt/webdir/bin/bx-provider -a orders_list --provider superprovider -o json
  {
    "params": {
      "provider_order_list": {
        "superprovider": {
          "25": {
            "status": "finished",
            "mtime": 1403445981,
            "error": 0,
            "message": ""
          },
          "22": {
            "status": "error",
            "mtime": 1403441000,
            "error": 1,
            "message": "cannot add ssh key to the server"
          },
          "21": {
            "status": "complete",
            "mtime": 1403440979,
            "error": 0,
            "message": ""
          },
          "23": {
            "status": "finished",
            "mtime": 1403441229,
            "error": 0,
            "message": ""
          }
        }
      }
    }
  }
  

  Тут добавлен еще один статус по задаче: complete — это значит, что сервер из данного задания был добавлен в пул.

• order_to_host — запускает процедуру добавления сервера в пул с параметрами, переданными в статусе заказа:

  /opt/webdir/bin/bx-provider -a order_to_host --provider superprovider --task_id 25 -o json
  

Конфигурация и настройка web-кластера

Веб-кластер: конфигурация, бэкапы, восстановление

/etc/httpd/bx/conf/
/etc/nginx/bx/
<каталог(и) сайта(ов)>

"bitrix/cache/",
"bitrix/managed_cache/",
"bitrix/stack_cache/",
"upload/resize_cache/",
"*.log",
"bitrix/.settings.php",
"php_interface/*.php",

Как сделать образ BitrixVM для клонирования

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

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

Рассмотрим установку часто используемых сервисов виртмашины:

• push-server
• memcached сервер

Существует 2 способа перенести виртуальную машину BitrixVM – ручное создание клона существующей машины с необходимыми сервисами и автоматическое развертывание готового образа (рекомендуемый).

Мы рекомендуем использовать автоматическое развертывание готового образа.

Клонирование образа

План создания клона виртуальной машины BitrixVM выглядит примерно так:

1. Для установки ПО нужно включить пул управления для машины
2. Поставить необходимое ПО через меню или с помощью скриптов
   • Установка push-server
   • Установка memcached сервера
3. Удалить настройки пула
4. Дополнительные очистки системы и ssh-ключей
5. Сделать образ машины

1. Включение пула управления на машине

Данный шаг необходим, чтобы получить доступ к настройкам сервера, установки push-server и memcached.

Если на чистом сервере в меню выбрать пункт 1. Create Management pool of server, то он как раз проведет по необходимым настройкам.

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

/opt/webdir/bin/wrapper_ansible_conf -a create -H SERVER_NAME -I NET_INTERFACE

где:
-H SERVER_NAME – это имя сервера, которое будет использовано в настройках.
-I NET_INTERFACE – это сетевой интерфейс, чей IP-адрес будет использован в настройках пула.

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

message
...
Run configuration pool job task_id=common_7874274840
All operations complete

Дождаться завершения можно, отслеживая состояние лог-файла:

tailf /opt/webdir/temp/common_7874274840/status
...
srv1                       : ok=75   changed=30   unreachable=0    failed=0

Если в полях unreachable и failed будут нулевые значения, значит все хорошо и можно продолжать.

2.1. Установка push-server

Установить push-server можно через меню или с помощью команды:

/opt/webdir/bin/bx-sites -a push_configure_nodejs -H  SERVER_NAME

Дожидаемся завершения задания.

info:bxDaemon:pushserver_2042054462:7097:1594650283::running:::

По умолчанию сценарий виртуальной машины настроит сервис на использование на рабочем IP-адресе, чтобы в случае подключения других машины в пул они могли использовать его.

Предполагается, что образ будет использован для копирования виртуальной машины, поэтому адрес на новой установке, скорее всего, будет другой и указанные настойки не сработают. Чтобы это обойти, мы меняем адрес сервиса на localhost, который есть на любом Linux-хосте.

Для этого в файле /etc/sysconfig/push-server-multi меняем параметр на:

WS_HOST=127.0.0.1

И пересоздаем конфиги push-server:

systemctl stop push-server

/etc/init.d/push-server-multi reset

Nginx проксирует запросы на push-server на основание имени хоста. Чтобы он правильно определил, куда и как проксировать, меняем запись в /etc/hosts:

127.0.0.1 SERVER_NAME

2.2. Установка memcached сервера

Устанавливаем memcached сервер:

/opt/webdir/bin/bx-mc -a create -s SERVER_NAME

Тут про адрес при копировании можно не задумываться, т.к. сервис слушает все и доступ ограничивается настройками iptables/firewalld.

3. Удаление настроек пула

Если машина в пуле одна, то это стоит сделать хотя бы для того, чтобы на новой машине создать заново ssh-ключи и другие настройки безопасности.

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

Для этого нужно удалить файлы и каталоги конфигурации для ansible:

rm -rf /etc/ansible/{host_vars,group_vars,hosts,ansible-roles}

Или выполнить команду ansible:

/opt/webdir/bin/wrapper_ansible_conf -a delete_pool

4. Дополнительные очистки

Удаляем правила Udev для интерфейсов:

/bin/rm -f /etc/udev/rules.d/70*

Очищаем записи MAC-адресов и UUID устройств:

/bin/sed -i ‘/^(HWADDR|UUID)=/d’ /etc/sysconfig/network-scripts/ifcfg-eth0

Удаляем ssh-ключи. При старте новая машина создаст для себя новые ключи:

/bin/rm –f /etc/ssh/*key*

Очищаем логи сценариев:

/bin/rm -fr /opt/webdir/temp/*
/bin/rm -fr /opt/webdir/logs/*

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

Если копия (образ) делается для бэкапа и воссоздание из нее будет всегда той же самой машины, т.е. нет смены адреса, нет смены ключей, пул остается там, где был, то можно не выполнять вышеописанные действия.

Автоматическая настройка готового образа виртуальной машины (рекомендуется)

Можно настраивать чистый образ автоматически. Для этого просто добавьте приведенные выше команды в свой сценарий или bash-скрипт:

# создание пула
/opt/webdir/bin/wrapper_ansible_conf -a create -H SERVER_NAME -I NET_INTERFACE

# настройка пуш-сервера
/opt/webdir/bin/bx-sites -a push_configure_nodejs -H  SERVER_NAME

# настройка memcached сервиса
/opt/webdir/bin/bx-mc -a create -s SERVER_NAME

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

Каждый запуск – это будет фоновое задание, статус которого можно отслеживать, как показано выше.

Из чего состоит BitrixVM

В этом разделе рассматривается более углубленное описание виртуальной машины BitrixVM.

Введение

Что нужно для работы Bitrix-сайта?

Для работы «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке» необходимо:

• Сервер – виртуальный или железный, количество серверов и их мощность зависит от потребностей.

• Web-службы – в BitrixVM используется схема из двух сервисов frontend-backend:
  • frontend – nginx. К нему обращается браузер и через него отдается статика (js/css/картинки и т.п.), а также используется для организации различных пользовательских сценариев – отдача файлов из облака (X-Accel-Redirect), работа с сервером мгновенных сообщений (push-server) и многое другое.
  • backend – apache/httpd. Служба обрабатывает весь динамический контент.

• База данных – в BitrixVM используется Percona Server for MySQL версии 5.6 и 5.7.

• Кеширование данных – в BitrixVM для организации быстрого хранилища в памяти используются Memcached и Redis.

• Cервис обмена мгновенными сообщениями – в BitrixVM используются модуль nginx-push-stream-module или сервер на NodeJS.

Варианты поставки BitrixVM

«1C-Битрикс: Виртуальная машина» поставляется в 2 вариантах:

1. «1С-Битрикс: Веб-окружение» — Linux (BitrixEnv)

   Это специальный скрипт bitrix-env.sh для быстрой и простой установки всего ПО, необходимого для работы продуктов и решений «1С-Битрикс» на Linux-платформах CentOS 6 (i386, x86_64) и CentOS 7 (x86_64).

   Установка производится на железный или виртуальный сервер несколькими командами. Подробнее про установку можно прочитать в уроке Установка «1С-Битрикс: Веб-окружение» — Linux (BitrixEnv).

2. Готовые образы «1C-Битрикс: Виртуальная машина» VMBitrix.

   «1C-Битрикс: Виртуальная машина» специально сконфигурирована для быстрого исполнения программных продуктов «1С-Битрикс»: разворачивается за минуты и сразу же готова к работе! На виртуальную машину можно не только установить ознакомительные версии продуктов «1С-Битрикс», но и перенести уже готовые проекты.

   • Образы VMBitrix доступны для гипервизоров: VMWare, Sphere, VirtualBox и HyperV.

     Скачать их можно на странице загрузки.

   • Предконфигурированные образы BitrixVM (AMI-образы) для быстрого запуска приложений «1С-Битрикс» в Amazon EC2.

     Список AMI-образов для различных регионов Amazon EC2 можно взять в специальном разделе.

Оба варианта очень похожи – готовые образы «1C-Битрикс: Виртуальная машина» VMBitrix собираются на основе того же скрипта bitrix-env.sh, только в каждый образ включаются дополнительные драйверы для работы со своим гипервизором и скрипты для сервиса Amazon EC2.

Пакеты bitrix-env.sh обновляются чаще, чем образы BitrixVM. Поэтому при первом запуске образа, желательно запустить обновление BitrixVM через меню.

Репозиторий Bitrix

Для установки bitrix-env используется операционная система CentOS версий 6 или 7. Выбор в пользу CentOS был сделан из-за распространенности данной ОС, большого сообщества, а также из-за опыта использования в рамках инфраструктуры Битрикс24.

Репозиторий – это файловое хранилище, организованное определенным образом. В нем хранятся пакеты программ, доступных для дальнейшего распространения.

Пакеты виртуальной машины BitrixVM содержатся в специальном yum-репозитории Bitrix, расположенном в CloudFront (AmazonCDN).

Репозиторий Bitrix содержит пакеты:

• bitrix-env и bitrix-env-crm – основная виртуальная машина, содержит необходимые сервисы, конфигурационные файлы, сценарии ansible и скрипты.

  Пакет bitrix-env – полная виртуальная машина BitrixVM, подходит под любую установку продуктов «1С-Битрикс». Скачиваются пакеты необходимых сервисов, создаются настройки сервера в зависимости от кофигурации оборудования, создается директория сайта по умолчанию /home/bitrix/www/ с необходимыми скриптами и кофигурационными файлами для выбора установки продуктов «1С-Битрикс».

  Пакет bitrix-env-crm – частный случай bitrix-env, разработан для редакции Битрикс24.СRM. Скачиваются пакеты необходимых сервисов, создаются настройки сервера в зависимости от кофигурации оборудования, запускается Push-сервис, устанавливается редакция коробочной версии Битрикс24.СRM в /home/bitrix/www/.

• push-server – Node.js сервис для работы push && pull модуля в продуктах «1С-Битрикс». Данный сервис обеспечивает обмен мгновенными сообщениями.
• bx-nginx – собранный из исходников nginx (stable) без патчей, но с добавлением ряда модулей, которые нужны для работы окружения и продуктов «1С-Битрикс». Например, модуль mod_zip, который позволяет отдавать файлы архивом на стороне nginx сервера.
• bx-ansible – собранный из исходников ansible без патчей, но зафиксированная версия – чтобы обновления от RedHat не ломали работу виртуальной машины из-за частой несовместимости версий ansible между собой.

Дополнительные репозитории, используемые для BitrixVM:

• REMI – используется для пакетов php 7.x.
• Epel – для зависимостей пакетов из REMI-репозитория.
• Percona – пакеты percona-server 5.7, percona-toolkit.
• NodeJS – пакет nodejs.

Состав пакетов BitrixVM

В составе bitrix-env используются стандартные пакеты из репозиториев, но с дополнительными настройками.

bx-nginx

В пакет bx-nginx, помимо самого nginx (stable), входят дополнительные модули:

• Модуль push-stream-module – это модуль мгновенных сообщений, не является обязательным, т.к на текущий момент мы рекомендуем использовать NodeJS push-server. Хотя небольшие проекты, где нет большой нагрузки на количество отсылаемых мгновенных сообщений, могут использовать именно его, он менее требователен к мощности сервера. А также оставлен для совместимости с предыдущими версиями BitrixVM.
• Модули mod-zip и headers-more используются в паре для быстрой отдачи архива файлов средствами nginx-сервера.
• Модуль pagespeed – позволяет оптимизировать сервер для высокой скорости отдачи контента без каких-либо изменений содержимого контента. Есть в сборке bx-nginx, но не используется в BitrixVM. Включен был по просьбам клиентов, настройка через меню BitrixVM не планируется, т.к в продуктах 1С-Битрикс используется технология Композит.
• Модуль brotli – модуль для поддержки нового стандарта компрессии данных, разработанный Google. Входит в сборку bx-nginx без настроек, конфигурация под него планируется в следующих версиях BitrixVM.

При установке bitrix-env создаются для nginx:

• настройки подключенных модулей bx-nginx (кроме модуля pagespeed).

• настройки отдачи через nginx файлов в облачных хранилищах Яндекс, Google, Cloudflare и др.

  В настройках главного модуля в продуктах 1С-Битрикс есть опция Быстрая отдача файлов через Nginx, при активации которой c помощью заголовка X-Accel-Redirect формируется специальная ссылка. Эта ссылка обрабатывается сервером nginx, а он уже проксирует запрос в подключенное хранилище и отдает запрошенный файл клиенту. Таким образом, освобождаются ресурсы backend-службы, которая обрабатывает php-запросы, а сама отдача файла выполняется обычно быстрее.

• настройки различных правил для Bitrix-сайта, в том числе блокировки доступа к ресурсам. Статика отдается nginx, динамика уходит на Apache.

Также есть варианты дополнительных настроек из сценариев через меню виртуальной машины:

• установка ssl-сертификатов Let’s Encrypt,
• создание новых сайтов (в самом начале есть только один).
• работа только через https и др.

Apache/PHP

В качестве backend-а используется Apache – стандартный пакет, актуальная версия из EPEL-репозитория.

PHP – стандартные пакеты из REMI-репозитория. Виртуальная машина BitrixVM поддерживает возможность переключения версий PHP: 5.6 – 7.0 – 7.1 – 7.2 – 7.3 – 7.4 – 8.0 и обратно. Опция переключения на PHP 8.0 пока экспериментальная, полной поддержки ее в продуктах «1С-Битрикс» пока нет.

При установке bitrix-env создаются для Apache конфигурации:

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

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

• включение и выключение нужных для работы PHP- модулей.
• включение NTLM авторизации через модуль Apache.
• переключение версий PHP с 5.6 до 8.0 и обратно.
• создание нескольких backend серверов для распараллеливания нагрузки.

MySQL Percona Server

В виртуальной машине BitrixVM в качестве MySQL используется стандартный пакет Percona Server. Не запрещено устанавливать другие варианты. Официальная поддержка версии MySQL 8.0 есть.

При установке bitrix-env создаются для mysqld конфигурации:

• статическая и динамическая настройка параметров в зависимости от конфигурации сервера в момент запуска

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

• создание и удаление реплик.
• перенос мастера на другой хост.
• обновление MySQL с версии на версию.

Ansible

Почему был выбран Ansible для управления?

Ansible – система управления конфигурациями, с использованием декларативного языка разметки для описания конфигураций для автоматизации настройки и развертывания программного обеспечения.

Ansible легок в настройке, все, что нужно для его работы – это ssh-доступ к серверу. Также имеется простая точка входа, как в плане конфигурации – сценарии (ini-, yml- и json-форматы), шаблоны (jinja2), так и в написании плагинов на достаточном количестве языков (bash и др). Имеет понятную документацию и крупное сообщество с большой базой примеров.

В виртуальной машине BitrixVM сделано следующем образом: в меню виртуальной машины можно выбрать, что хотите сделать (настроить ssl-сертификат, создать сайт, включить cron-задания для сайта и т.п), затем из интерфейса стартует задача (task) на изменение через API – это и есть ansible-сценарий со всеми необходимыми опциями.

Интерфейсы управления

Инвентарь Ansible

Все конфигурационные файлы, сценарии и прочее для работы ansible хранятся в директории /etc/ansible/.

Самое главное – это описание хостов, которыми управляет виртуальная машина. В самом простом случае – это локальный сервер, на котором установлено Bitrix-окружение.

В инвентарь входят:

• файл /etc/ansible/hosts – или файл инвентаря (описание конфигурации), содержит описание хостов, которыми можно управлять.

  В случае виртуальной машины BitrixVM мы храним только группы и хосты, которые входят в эти группы.

  Внутри файла /etc/ansible/hosts есть разделение по группам. Группам соответствуют роли, которые выполняют серверы. Один и тот же сервер может находится в нескольких группах.

  Пример:

  # Bitrix VM default configuration group
  [bitrix-hosts]
  vm03 ansible_ssh_host=192.168.1.215
  vm04 ansible_connection=local ansible_ssh_host=192.168.1.227
  
  ..
  [bitrix-push]
  vm03 ansible_ssh_host=192.168.1.215
  

  Группа [bitrix-hosts] содержит все хосты, которыми можно управлять.

  Группа [bitrix-push] содержит хосты, которые выполняют роль push-сервера. В данном примере: сервер vm03 выполняет роль сервера мгновенных сообщений.

  Внимание! Не добавляйте один и тот же хост через разные интерфейсы в инвентарь!

• файлы в каталогах /etc/ansible/host_vars/ и /etc/ansible/group_vars/ – персональные настройки серверов и групп соответственно.

  Пример:

  bx_connect: ipv4
  bx_host: vm04
  bx_hostname: vm04
  bx_netaddr: 192.168.1.227
  

Сценарии, роли, API

ansible-playbook /etc/ansible/<PLAY>.yml -e ansible_playbook_file=/opt/webdir/temp/<TASK_ID>/opts.yml

Конфигурации служб

В главе описаны планы конфигурации служб виртуальной машины BitrixVM.

Конфигурация nginx

Конфигурация apache/httpd

Конфигурация mysql

Сценарии BitrixVM

Пул

Пул – это группа серверов, которой можно управлять посредством ansible-сценариев. По сути пул – это все сервера в группе bitrix-hosts в ansible-инвентаре.

В самом простом случае в пуле будет единственный сервер, на котором настроено Bitrix-окружение.

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

Создание и удаление пула

Добавление и удаление сервера в пуле

Сайты

Типы сайтов

Типы установки ядра «1С-Битрикс»:

• kernel – отдельное ядро продукта «1С-Битрикс» в новой директории сайта. Содержит в себе базу данных, файлы сайта, конфиги веб-служб.

• ext_kernel – отдельное ядро продукта «1С-Битрикс» в новой директории сайта для создания линков на это ядро в рамках многосайтовости. Ядро будет недоступно напрямую, а только через дополнительные сайты (работает в паре с сайтами типа link). Содержит в себе базу данных, файлы сайта.

• link – в случае создания дополнительного сайта в рамках многосайтовости. Общее ядро и данные в общей базе с уже установленным продуктом «1С-Битрикс» (работает в паре с ядром ext_kernel или kernel). Содержит в себе файлы (но не все) и конфиги веб-служб. Подкаталоги bitrix, upload имеют ссылки на ext_kernel или kernel.

Создание и удаление сайтов

/opt/webdir/bin/bx-sites -a create -s  -t kernel

ansible-playbook /etc/ansible/web.yml -e ansible_playbook_file=/opt/webdir/temp/<TASK_ID>/opts.yml

/opt/webdir/bin/bx-sites -a delete -r /path/to/doc/root

ansible-playbook /etc/ansible/web.yml -e ansible_playbook_file=/opt/webdir/temp/<TASK_ID>/opts.yml

Архив

Виртуальная машина BitrixVM v5.x (архив)

Внимание! BitrixVM версии 5.x устарела и не поддерживается. Актуальная версия BitrixVM — 7.х, информацию о которой можно найти здесь.

«1C-Битрикс: Виртуальная машина» — бесплатный программный продукт, готовый к немедленному использованию виртуальный сервер, полностью настроенный, протестированный и адаптированный для оптимальной работы как с продуктами «1С-Битрикс», так и с любыми PHP-приложениями.

Виртуальная машина сэкономит время и силы на правильное развертывание и администрирование сайта или внутреннего информационного ресурса на базе продуктов «1С-Битрикс».

С помощью специальных ВМ-решений вы можете быстро получить оптимально сконфигурированный сервер, не уступающий по производительности BitrixVM, а по масштабируемости — превосходящий виртуальную машину «1С-Битрикс». Пакеты подготовлены специалистами «1С-Битрикс» и доступны для скачивания и использования.

Решения для оптимизации установки продуктов «1С-Битрикс»:

1. «1C-Битрикс: Виртуальная машина 5.x»

   «1C-Битрикс: Виртуальная машина 5.x» специально сконфигурирована для быстрого исполнения программных продуктов «1С-Битрикс»: разворачивается за минуты и сразу же готова к работе! На виртуальную машину можно не только установить ознакомительные версии продуктов «1С-Битрикс», но и перенести свои, уже готовые проекты.

   Дистрибутивы BitrixVM доступны для:

   • VMWare;
   • VirtualBox;
   • HyperV.
2. «1С-Битрикс: Веб-окружение» — Linux

   «1С-Битрикс»: Веб-окружение» — Linux служит для быстрой и простой установки всего ПО, необходимого для работы продуктов и решений «1С-Битрикс» на Linux-платформах Fedora 12-15 (i386, x86_64), CentOS 5/6 (i386, x86_64), Red Hat Enterprise Linux 5/6 (i386, x86_64).

3. Virtuozzo Application Template для запуска оптимизированного VPS «Битрикс»

   Пакет Virtuozzo VZ Application Template для «Битрикс» с использованием решения «1С-Битрикс: Веб-окружение» — Linux 2.0. Шаблон предназначен для установки (создания) Virtuozzo контейнеров на основе Fedora 8-12 32-bit и CentOS 5 32-bit / x86_64 packaged as a Virtuozzo EZ Template.

4. Amazon Elastic Compute Cloud (Amazon EC2)

   Amazon EC2 — это веб-сервис, предоставляющий масштабируемые вычислительные мощности и созданный для быстрого и простого разворачивания веб-приложений на площадках (в облаках) Amazon. Специалистами «1С-Битрикс» подготовлены предконфигурированные образы BitrixVM (AMI-образы) для быстрого запуска приложений «1С-Битрикс» в Amazon EC2, которые включают:

   • CentOS 6.7;
   • NGINX + Apache2;
   • PHP 5.6+;
   • MySQL5 with InnoDB support;
   • Mail server agent;
   • UNIX-like Control Menu with common tasks;
   • IP address via DHCP, or configured by Amazon Elastic IP;
   • HTTPS support.

   Список ami-образов по регионам можно посмотреть на странице BitrixVM.

Внимание!«1C-Битрикс: Виртуальная машина» версии 5.x также позволяет управлять масштабированием серверов пула в простом визуальном режиме в административном интерфейсе с помощью модуля Управление масштабированием.

Глава предназначена для администраторов и пользователей продуктов «1С-Битрикс», устанавливающих для ознакомления либо переносящих готовые проекты на виртуальную машину BitrixVM. Аналогичным способом можно переносить проекты с удаленного сайта на виртуальную машину, между виртуальными машинами и т.д. В документе рассматриваются процедуры установки всех необходимых приложений для работы продукта на виртуальной машине BitrixVM.

Описание установки ПО виртуализации не входит в данное руководство. По всем вопросам установки этой программы обращайтесь к документации соответствующего ПО.

Если у вас возникнут вопросы по процессу установки продуктов компании «1С-Битрикс», вы можете обратиться в службу Технической поддержки. Обсуждение работы BitrixVM доступно на специализированном форуме или в группе Виртуальные машины Битрикс социальной сети компании «1С-Битрикс».

Внимание! Информацию по «1C-Битрикс: Виртуальная машина» версии 4.3 можно прочитать здесь.

Внимание! Все названия хостов, адреса e-mail, серверов, ip-адреса и т.п информация в учебном курсе указываются в качестве примера. Поэтому при настройке виртуальной машины необходимо использовать свои данные.

Внимание! Если на BitrixVM или в «1С-Битрикс: Веб-окружение» — Linux меняется ssl сертификат с установленного по умолчанию на свой, и сертификат запаролен, то это вызовет проблему в работе мастеров и при перезапуске сервисов. Будет постоянно запрашиваться ввод пароля. Чтобы избежать подобных проблем можно удалить пароль из сертификата:
/path/to/openssl rsa -in /path/to/originalkeywithpass.key -out /path/to/newkeywithnopass.key.

Установка «1С-Битрикс: Веб-окружение» — Linux 5.x

«1С-Битрикс: Веб-окружение» — Linux будет полезно:

• Для пользователей и разработчиков, которые использовали продукт «1С-Битрикс: Виртуальная машина» в процессе подготовки сайта и столкнулись с проблемой переноса конфигурации на хостинг или на невиртуальное оборудование и потерей производительности.
• Для специалистов хостинг-партнеров, планирующих создать шаблоны различных VPS для продуктов «1С-Битрикс».
• Для системных администраторов, которым требуется быстро подготовить производительную платформу для установки или миграции сайтов на основе «1С-Битрикс».
• Для программистов и системных администраторов, которым требуется быстро развернуть кластер для проектов на основе «1С-Битрикс».

«1С-Битрикс: Веб-окружение» — Linux позволяет быстро и с минимальными затратами развернуть оптимальное окружение для работы продуктов и решений «1С-Битрикс» на Linux-платформе CentOS 5/6 (i386, x86_64):

• mysql-server 5.*
• web-server (Apache 2.2.*)
• php 5.6.*
• nginx 1.6.2
• memcached
• stunnel
• catdoc
• xpdf
• munin
• nagios
• sphinx

Рассмотрим установку «1С-Битрикс: Веб-окружение» — Linux на оборудовании с уже установленной CentOS 6 (i386, x86_64).

• Авторизуемся на сервер под административным аккаунтом.
• Загружаем скрипт «1С-Битрикс: Веб-окружение» — Linux и запускаем его командами:

  wget http://repo.bitrix.info/yum/bitrix-env.sh   
  chmod +x bitrix-env.sh  
  ./bitrix-env.sh
  

  Примечание: Если на сервере нет утилиты для загрузки файлов wget, то ее можно установить командой yum install wget

• В процессе установки будет задан вопрос, какую версию «Веб-окружения» нужно установить (выбираем версию 5) и ждем окончания установки:

  

• Далее после завершения установки нужно открыть порты, которые необходимы для нормальной работы продуктов «1С-Битрикс» в Веб-окружении:

  iptables -I INPUT -p tcp --dport 25 -j ACCEPT
  iptables -I INPUT -p tcp --dport 80 -j ACCEPT
  iptables -I INPUT -p tcp --dport 443 -j ACCEPT
  iptables -I INPUT -p tcp --dport 5222 -j ACCEPT
  iptables -I INPUT -p tcp --dport 5223 -j ACCEPT
  iptables -I INPUT -p tcp --dport 8890 -j ACCEPT
  iptables -I INPUT -p tcp --dport 8891 -j ACCEPT
  iptables -I INPUT -p tcp --dport 8893 -j ACCEPT
  iptables -I INPUT -p tcp --dport 8894 -j ACCEPT
  

  где порты обозначают и используются для следующих сервисов:

  • 25 — smtp сервер;
  • 80 — http ;
  • 443 — https;
  • 5222 — bitrix xmpp сервер;
  • 5223 — bitrix xmpp сервер по ssl;
  • 8890 — ntlm авторизация;
  • 8891 — ntlm авторизация по ssl;
  • 8893 — http сервер мгновенных сообщений;
  • 8894 — https сервер мгновенных сообщений.
• Порты прописаны, необходимо сохранить таблицу командой:

  service iptables save
  

  Внимание! При установке «1С-Битрикс: Веб-окружение» — Linux версии 7.x+ нужно только сменить пароли при первой авторизации (см. ниже) и создать пул (1. Create Management pool of server). Мастер создания пула откроет все необходимые порты.

• Установка закончена.
• Перезагружаем сервер командой reboot, чтобы посмотреть, что все установилось корректно, на экране будет отображено, что запущена машина и ее текущая версия.

  

• При первом входе на сервер с логином root будет предложено сменить пароль у пользователя bitrix:

  

Можно приступать к работе.

Запуск виртуальной машины BitrixVM

• Загрузите дистрибутив настроенной виртуальной машины BitrixVM.
• Загруженный архив распакуйте в любую папку, например, С:BitrixVM и запустите виртуальную машину с помощью подходящего ПО:



• Начнется процесс загрузки операционной системы, установленной на виртуальной машине. В конце загрузки откроется окно:

  

• Примечание: Для суперпользователя root по умолчанию задан пароль bitrix.

  При первом запуске виртуальной машины будет предложено сменить пароли суперпользователя root и пользователя bitrix:

  

  • В строках localhost login укажите текущий логин (root), а в поле Password пароль (по умолчанию bitrix).
  • В строке (current) UNIX password укажите текущий пароль (bitrix) и нажмите Enter.
  • Введите новый пароль в строке Enter new UNIX password и нажмите Enter.
  • Повторите ввод нового пароля в строке Retype new UNIX password и нажмите Enter.

  Аналогично происходит смена пароля пользователя bitrix:

  

  Примечание: Сменить пароль пользователя bitrix можно позднее в панели управления виртуальным сервером с помощью пункта меню 1. Create Management pool of server — Change bitrix password.

В результате виртуальный сервер готов для использования. Первоначальное меню BitrixVM Available actions выглядит так:

• 1. Create Management pool of server — создает пул управления сервером;
• 2. Manage localhost — управление локальным виртуальным сервером;
• 0. Exit — выход в консоль операционной системы.

Для перехода к выполнению любого действия введите число (от 0 до 2) и нажмите Enter. Например, для настройки локального виртуального сервера в строке наберите 2 (Manage localhost) и нажмите Enter.

Чтобы вернуться в вашу ОС, нажмите Ctrl+Alt.

Чтобы вернуться из shell в меню виртуальной машины, введите команду:

/root/menu.sh

Примечание: При клонировании виртуальной машины BitrixVM или в другом случае при смене MAC-адреса сетевого интерфейса eth0 может возникнуть ошибка IP4: undefined. В таком случае необходимо открыть файл /etc/udev/rules.d/70-persistent-net.rules и в нем удалить (или закомментировать) все строчки для интерфейса eth0 и eth1, сохранить файл и перезагрузить машину командой reboot.

Далее необходимо набрать IP-адрес (полученный в виртуальной машине — IP4) в браузере (в нашем примере это http://192.168.2.15 или https://192.168.2.15). Откроется страница с выбором варианта работы:

Для продолжения необходимо выбрать один из вариантов:

1. Новая установка — в этом случае будет запущен мастер, который позволяет скачать, установить и создать новый сайт средствами продуктов компании «1C-Битрикс». Шаги этого варианта аналогичны шагам, рассмотренным в главе Установка продукта с помощью BitrixSetup.
2. Восстановить проект — в этом случае будет запущен мастер, с помощью которого можно будет перенести существующий проект (восстановить проект из резервной копии). Шаги этого варианта аналогичны шагам, рассмотренным в главе Перенос продукта.

Перенос продукта «1C-Битрикс» на виртуальную среду BitrixVM/BitrixEnv

Для переноса сайта с хостинга или локального сервера на виртуальную среду BitrixVM или BitrixEnv необходимы: архив сайта и настроенная виртуальная среда BitrixVM или BitrixEnv. Этот процесс состоит из двух этапов:

• Создание архива сайта.
• Копирование сайта в виртуальную среду BitrixVM/BitrixEnv.

Создание архива сайта

1. Перейти на страницу Резервное копирование (Настройки > Инструменты > Резервное копирование) :

   

   • архив сайта может быть сохранен в облаке «1С-Битрикс»;

     Примечание: Опция копирования в облако «1С-Битрикс» доступна пользователям с активной лицензией. Также, в целях безопасности, все резервные копии сайта отправляются в облако «1С-Битрикс» всегда зашифрованными. Компания «1С-Битрикс» не может восстановить или поменять пароль! Будьте внимательны, без знания этого пароля восстановить архив не удастся!

   • либо в папке сайта (архив сайта будет сохранен в папке /bitrix/backup/ хостинга с уникальным именем файла).
2. На вкладке Параметры можно выбрать экспертные настройки создания резервной копии:

   

   Примечание: Для безопасности данных рекомендуется включить опцию Шифровать данные резервной копии и ввести пароль для архива сайта.

3. После успешного создания архива сайта он будет доступен на странице Список резервных копий (Настройки > Инструменты > Список резервных копий) . Здесь будут показаны все резервные копии:

   

4. Далее понадобится Получить ссылку для переноса с помощью одноименного меню действий:

   

   и в появившемся окне скопировать ее в буфер обмена:

   

5. Также можно скачать архив сайта на локальный компьютер с помощью пункта меню Скачать.

Копирование сайта в виртуальную среду BitrixVM/BitrixEnv

1. Запустить предварительно настроенную виртуальную среду BitrixVM или BitrixEnv.
2. В адресной строке браузера ввести http://адрес_виртуальной_машины/ (можно указать домен или ip-адрес).
3. Откроется мастер установки продукта «1С-Битрикс», где нужно выбрать Восстановить проект:

   

4. На этапе загрузки резервной копии выбрать нужный способ хранения архива сайта (в данном случае — ввести ссылку из буфера обмена, полученную на странице со списком резервных копий сайта):

   

   Примечание: Также есть возможность загрузить архив из облака «1С-Битрикс» (понадобится лицензионный ключ с действующей лицензией) или с локального компьютера, если эти способы были выбраны на этапе создания архива сайта.

5. После скачивания архива, если архив был зашифрован, то будет предложено ввести пароль:



6. Далее необходимо настроить подключение к базе данных:

   

   Настройки подключения к MySQL по умолчанию в виртуальной машине BitrixVM:

   • Сервер: localhost
   • Пользователь БД: bitrix0
   • Пароль: <подставляется автоматически>
   • Имя БД: sitemanager0

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

7. После успешного восстановления базы данных в целях безопасности необходимо Удалить локальную резервную копию и служебные скрипты, нажав на одноименную кнопку:

   

8. Перенос продукта «1C-Битрикс» на виртуальную среду BitrixVM/BitrixEnv закончен:

   

Управление хостами (Manage Hosts in the pool)

Для начала работы с сервисами нужно создать и настроить пул сервера или нескольких серверов. Для этого нужно выбрать пункт главного меню 1. Create Management pool of server и ввести название сервера в данном пуле.

После создания пула в основном меню добавятся новые пункты как в главном меню:

Так и в меню Manage Hosts in the pool:

Добавление нового хоста в пул (Add new host in the pool)

Добавление нового хоста в пул (кластер) осуществляется с помощью меню 1. Manage Hosts in the pool > 1. Add new host in the pool.

Для этого необходимо задать ip-адрес или DNS-имя хоста и выбрать короткое имя для подключаемого сервера:

Таким образом, можно добавлять любое количество серверов в пул:

Теперь можно управлять любым сервером пула с одной машины.

Удаление хоста из пула (Delete host from pool)

Удаления хоста, находящегося в пуле, осуществляется с помощью меню 1. Manage Hosts in the pool > 2. Delete host from pool .

Для этого необходимо задать ip-адрес или DNS-имя хоста удаляемого из пула сервера:

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

Перезапуск хоста (Reboot host)

Перезагрузка хоста, находящегося в пуле, осуществляется с помощью меню 1. Manage Hosts in the pool > 3. Reboot host.

Для этого необходимо задать имя хоста (в данном примере — server4) и согласиться на перезапуск сервера:

Обновление BitrixEnv на хосте (Update BitrixEnv on host)

С помощью менеджера пула можно удаленно обновлять Веб-окружение и компоненты системы на любом хосте, входящем в пул.

Например, в пул добавлена виртуальная машина версии 5.0.37, нам нужно обновить ее до 5.0.44.

• Выбираем пункт меню 1. Manage Hosts in the pool > 4. Update BitrixEnv on host, система спросит имя хоста для обновления и подтверждение действия:

  

• Менеджер пула запустит задачу обновления Веб-окружения на удаленном хосте:

  

• Через некоторое время система на удаленном хосте обновится до последней версии (в данном примере — 5.0.44)

  

Таким же образом можно обновлять включенные в пул виртуальные машины версии 4.3.

Смена пароля пользователя bitrix (Change password for bitrix user on host)

Смена пароля для пользователя bitrix осуществляется через пункт меню 1. Manage Hosts in the pool > 5. Change password for bitrix user on host.

Будет выдан запрос имени хоста, на котором нужно сменить пароль пользователя bitrix, и согласие на это действие:

Внимание! Сменить пароль пользователя root через меню виртуальной машины нельзя. Для этого необходимо воспользоваться системными командами ОС. Например, для Centos 6.х консольная команда смены пароля пользователя root: passwd.

Настройка таймзоны в пуле (Configure timezone in the pool)

Настройка таймзоны — очень важный параметр, который обязательно нужно проверить и при необходимости настроить правильно. Параметр влияет на синхронизацию с 1С, календари, заказы и многое другое, где требуется дата и время.

Дата и время на сервере — это не одна конкретная дата и время, это фактически три различных даты и три различных времени со своими часовыми поясами:

• Время сервера
• Время PHP
• Время MySQL

Смена таймзоны происходит через пункт меню веб-окружения 1. Manage Hosts in the pool > 6. Configure timezone in the pool, и меняет дату и время, в трех местах сразу, т.к это очень важный момент, что все три места работают с одинаковыми параметрами времени и даты.

• После выбора континента, страны и города будет выведен запрос на согласие применения данной таймзоны:

  

• После этого будет предложено также изменить таймзону для PHP:

  

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

  

Примечание: Корректность установки времени у PHP и MySQL можно проверить также через административный веб интерфейс продуктов «1C-битрикс»: Настройки > Инструменты > Проверка системы.

Обновление PHP и MySQL (Upgrade php and mysql versions)

В процессе обновления BitrixVM до версии 5.1.х и выше PHP и MySQL автоматически не обновляются. Обновить их можно в ручном режиме с помощью пункта меню виртуальной машины 1. Manage hosts in the pool — 8. Upgrade php and mysql versions.

Примечание: Пункт меню 1. Manage hosts in the pool — 8. Upgrade php and mysql versions появится только при обновлении BitrixVM с предыдущих версий до версии 5.1.х и выше.

Управление локальным сервером (Manage localhost)

• 1. Configure hostname — задается название хоста виртуального сервера;
• 2. Configure network interface via DHCP — получение нового IP-адреса автоматически с помощью DHCP-сервера;
• 3. Configure network interface manually — настройка IP-адреса сервера вручную;
• 4. Reboot server — перезагрузка виртуального сервера;
• 5. Shutdown server — выключение виртуального сервера;
• 6. Update server — обновление компонентов операционной системы виртуальной машины.
• 0. Previous screen or exit — возвращение к главному меню.

Изменение названия хоста

Чтобы задать имя хоста локального сервера, нужно перейти в главном меню 2. Manage localhost — Configure hostname:

Далее согласиться на изменение имени хоста и ввести название Input hostname — например server1 (по умолчанию имя хоста — localhost.localdomain):

После чего системе будет присвоено новое имя:

Настройка IP-адреса сервера

При первом старте BitrixVM получение IP-адреса сервером происходит автоматически, если в сети есть настроенный DHCP-сервер.

Если по каким-либо причинам необходимо сменить IP-адрес сервера, можно сделать это в двух режимах: автоматическом и ручном.

Автоматическое получение IP-адреса через DHCP-сервер

• Чтобы сменить IP-адрес локального сервера с помощью DHCP-сервера, нужно перейти в главном меню 2. Manage localhost — 2. Configure network interface via DHCP.
• Выбрать сетевой интерфейс (в данном примере — eth0) и автоматически будет получен IP-адрес от DHCP-сервера:

  

Ручное изменение IP-адреса

• Для задания IP-адреса в ручном режиме необходимо перейти в главном меню 2. Manage localhost — 3. Configure network interface manually.
• Выбрать сетевой интерфейс (в данном примере — eth0).
• Ввести данные:

  

  • Type IP address — новый IP-адрес сервера;
  • Type broadcast — широковещательный адрес сети;
  • Type network mask — маска подсети;
  • Type default gateway — шлюз по умолчанию;
  • Type DNS server — адрес DNS-сервера.
• Проверить введенные данные и дать согласие на изменение параметров сети сервера:

  

Обновление локального сервера

Внимание! Обновление продукта «1C-Битрикс: Виртуальная машина» — сложная операция, в процессе которой происходит обновление системных файлов операционной системы виртуальной машины, и для этого необходимы соответствующие знания администрирования *nix-систем. Перед запуском обновления рекомендуется сделать полный бекап «Виртуальной машины».

Для обновления локальной виртуальной машины необходимо выбрать в административном меню пункт 2. Manage localhost — 6. Update server.

Скрипт автоматически проверит обновления компонентов, выдаст общий объем для загрузки и запрос на установку.

Внимание! Этот пункт меню запускает обновление компонентов лишь текущей виртуальной машины. Если у вас несколько серверов в пуле (кластер), то целесообразно производить обновление для всех виртуальных машин, входящих в этот пул.

Примечания:

• Если после обновления, что-то перестанет работать, то можно вернуть полностью или частично старые файлы настроек соответствующей службы, т.к. конфигурационные файлы при обновлении не перезаписываются, а сохраняются в файлах *.ori.(метка времени).
• Также в процессе обновления могут отключиться некоторые модули php. Для их включения необходимо выполнить следующие команды:

  mv -f /etc/php.d/(имя модуля).ini.disabled /etc/php.d/(имя модуля).ini
  service httpd restart
  

Настройка MySQL (Configure MySQL servers)

В «1C-Битрикс: Виртуальная машина» можно быстро развернуть кластерную конфигурацию master-slave «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке».

Ключевые особенности:

• гибкая балансировка нагрузки SQL
• простота администрирования
• дешевое и быстрое неограниченное масштабирование
• он-лайн бэкап
• не требуется доработка логики веб-приложения

Схема «master — slave» реализуется средствами MySQL. Платформа «1С-Битрикс» позволяет гибко балансировать нагрузку между серверами, участвующими в репликации.

Внимание! Для создания конфигурации MySQL master-slave необходим модуль Веб-кластер, который входит не во все редакции продуктов «1С-Битрикс».

Создание slave сервера MySQL (Create slave MySQL server)

Для создания slave сервера MySQL нужно:

• Выбрать пункт меню 3. Configure MySQL servers > 2. Create slave MySQL server, придумать и ввести пароли репликации и кластера:

  

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

• Ввести имя хоста в пуле, на котором будет создан slave сервер MySQL (в данном примере — server3):

  

• Подождать, пока задача по добавлению slave cервера MySQL будет закончена.
• Создадим аналогичным образом еще один slave сервер MySQL (server4). В итоге получим три сервера MySQL: master (server1) и два slave (server3 и server4):

  

Смена master сервера MySQL (Change master MySQL server)

Для переноса master сервера MySQL на другую машину необходимо:

• Выбрать пункт меню 3. Configure MySQL servers > 3. Change master MySQL server.
• Ввести имя хоста для будущего master сервера MySQL из списка доступных slave (например server3):

  

• Подождать, пока задача по смене master cервера MySQL будет закончена.
• В итоге серверы MySQL станут: master (server3) и два slave (server1 и server4):

  

Удаление slave сервера MySQL (Remove slave MySQL server)

Для удаления slave сервера MySQL необходимо:

• Выбрать пункт меню 3. Configure MySQL servers > 4. Remove slave MySQL server.
• Ввести имя хоста удаляемого slave сервера MySQL (например server1):

  

• Подождать, пока задача по удалению slave cервера MySQL будет закончена.
• В итоге серверы MySQL станут: master (server3) и один slave (server4):

  

Таким образом, мы перенесли master сервер MySQL с машины server1 на server3, создали дополнительный slave сервер MySQL на машине server4 и освободили ресурсы машины server1 под другие роли.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Настройка memcached (Configure memcached servers)

Продукты «1С-Битрикс» позволяет использовать пул серверов memcached для работы с кешем данных.

Это обеспечивает:

• высокую эффективность — за счет централизованного использования кеша веб-приложением;
• надежность — за счет устойчивости подсистемы кеширования к выходу из строя отдельных компонентов;
• неограниченную масштабируемость — за счет добавления новых memcached-серверов.

Внимание! Для использования пула серверов memcached необходим модуль Веб-кластер, который входит не во все редакции продуктов «1С-Битрикс».

Создание memcached сервера (Create memcached server)

Для создания memcached сервера нужно:

• Выбрать пункт меню 4. Configure memcached servers > 1. Create memcached server.
• Ввести имя хоста в пуле, на котором будет запущен сервер memcached (в данном примере — server2):

  

• Подождать, пока задача по запуску cервера memcached будет закончена:

Удаление memcached сервера (Remove memcached server)

Для удаления memcached сервера необходимо:

• Выбрать пункт меню 4. Configure memcached servers > 3. Remove memcached server:
• Ввести имя хоста удаляемого memcached сервера (например server5):

  

• Подождать, пока задача по удалению memcached cервера будет закончена.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Фоновые задачи (Background tasks in the pool)

Все изменения в виртуальной машине — настройки, запуск каких-либо служб, синхронизация и др. осуществляются с помощью скриптов — задач.

Просмотреть историю задач, а также выполняемые в данный момент задачи, можно с помощью пункта меню 5. Background tasks in the pool:

Просмотреть запущенную в данный момент задачу можно с помощью пункта меню 5. Background tasks in the pool > 1. View running tasks:

Для остановки запущенной в данный момент задачи нужно перейти в пункт меню 5. Background tasks in the pool > 1. View running tasks > 1. Stop task и ввести идентификатор задачи:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера.

Чтобы очистить историю задач нужно выбрать пункт меню 5. Background tasks in the pool > 2. Clean history:

Далее выбрать количество дней, за которое нужно оставить историю задач, и фильтр, по которому выбирать задачи (к примеру, выберем все задачи с TaskID common):

После этого будут выведены все задачи, удовлетворяющие заданному интервалу и фильтру, и далее запрос на очистку истории:

Внимание! Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

Управление сайтами (Manage sites in the pool)

Примечание: При создании сайта через BitrixVM, в Базе данных создается пользователь с двумя записями. Одна запись используется для хоста localhost, вторая — для %. Вторая запись используется для создания кластерной конфигурации или переноса mysql сервера на отдельный хост.

Создание и удаление сайта (CreateDelete site)

Мастер создания дополнительных сайтов, позволяет развернуть на одной виртуальной машине несколько сайтов, как на независимых установках «1С-Битрикс», так и в рамках многосайтовости.

Добавление дополнительного сайта

Для добавления дополнительного сайта необходимо:

• Предварительно настроить DNS-сервер или в случае локальной установки указать доменное имя в /etc/hosts на виртуальной машине, а также на всех машинах, с которых будет осуществляться доступ к данному сайту.
• Далее из административного меню запустить мастер 6. Manage sites in the pool > 1 Create site:

  

  

  и указать:

  1. Enter site name — доменное имя дополнительного сайта без www;

     Внимание! Если у вас домен в национальной кодировке (например, кириллический домен), то в данное поле нужно вводить имя домена в Punycode-формате, воспользовавшись любым Unicode-Punycode конвертером (например этим).

  2. Enter site type — тип установки ядра «1С-Битрикс»:
     • kernel — в случае создания дополнительного сайта в рамках отдельной установки — отдельное ядро продукта «1С-Битрикс» в новой директории сайта.
     • ext_kernel — отдельное ядро продукта «1С-Битрикс» в новой директории сайта для создания линков на это ядро в рамках многосайтовости, ядро будет недоступно напрямую, а только через дополнительные сайты (работает в паре с сайтами типа link).
     • link — в случае создания дополнительного сайта в рамках многосайтовости — общее ядро и данные в общей базе с уже установленным продуктом «1С-Битрикс» (работает в паре с ядром ext_kernel).
  3. Enter full path to the Bitrix installation directory — указать путь до ядра продукта «1С-Битрикс», на которые будут сделаны симлинки (для ядра типа link).
  4. Enter site encoding — указать кодировку будущего сайта: UTF-8 или windows 1251 (для ядра типа kernel и ext_kernel).
  5. Do you want to enable cron task on site — включить ли выполнение заданий на cron для будущего сайта (для ядра типа kernel и ext_kernel).
  6. Do you want to specify them — по умолчанию название, логин и пароль базы данных и root-директория сайта создаются автоматически (в файлах dbconn.php до версии 20.900.0 и только .settings.php с этой же версии), но с помощью данной опции можно указать свои, выбрав ответ y (для ядра типа kernel и ext_kernel).
• В процессе работы мастера будет создана директория на сервере: /home/bitrix/ext_www/{название_хоста}, в которой будут:
  • символические ссылки на директорию ядра, которую выбрали ранее (если был выбран вариант link).
  • директории и скрипт BitrixSetup для установки или восстановления продукта (если был выбран вариант kernel).
  • директории и скрипт BitrixSetup для восстановления продукта (если был выбран вариант ext_kernel).
• После завершения задачи по добавлению сайта он будет готов к использованию.

  Примечание: Количество дополнительных сайтов ограничивается лишь лицензией «1С-Битрикс» данной установки.

Внимание! Если был выбран вариант ядра ext_kernel и установлено ядро в /home/bitrix/ext_www/{название_хоста}, то в списке сайтов виртуальной машины данное ядро не появится до тех пор, пока не будет создан хотя бы один сайт (link) на это ядро.

Удаление дополнительного сайта

Для удаления записи о дополнительном сайте необходимо в административном меню «1C-Битрикс: Виртуальная машина» выбрать пункт 6. Manage sites in the pool > 2. Delete site и выбрать директорию удаляемого сайта (Enter site directory):

Внимание! Мастер удаления дополнительного сайта удаляет папку и базу данных дополнительного сайта, поэтому необходимо предварительно сделать бекап важных данных.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

• Виртуальная машина: многосайтовость для перехода на «1С-Битрикс24»

Настройка задач cron (Change cron tasks on site)

По умолчанию в виртуальной машине cron уже включен. Если по каким-либо причинам нужно отключить службу cron, то для этого необходимо:

• Перейти в главном меню в 6. Manage sites in the pool > 3. Change cron tasks on site и ввести директорию сайта, для которого нужно отключить службу cron:

  

• Согласиться на отключение cron и дождаться пока задача будет закончена:

  

Аналогичным способом осуществляется включение cron:

Внимание! Информацию о том, как настроить в продуктах «1С-Битрикс» обработку всех агентов на cron, можно прочитать здесь.

Настройка почтового сервера (Change e-mail settings on site)

Для настройки интегрированного почтового сервера выполните следующее:

1. Перейти в главном меню в 6. Manage sites in the pool > 4. Change e-mail settings on site и ввести имя хоста, для которого нужно настроить отправку почты:

   

2. Далее ввести необходимые данные для почтового сервера:

   

   • from address — адрес отправителя, от которого будет осуществляться пересылка писем.
   • server address or DNS — ip- или dns-адрес почтового сервера. Если нажать Enter, то будет использован адрес по умолчанию (127.0.0.1)
   • server port — порт сервера. Порт зависит от типа соединения, 25 — для обычного и 465 — для зашифрованного (с использованием SSL). Если нажать Enter, то будет использован порт по умолчанию (25).
   • Если необходима SMTP-авторизация, то в строке SMTP authentication наберите y и введите логин и пароль для доступа к SMTP-серверу, в противном случае — n.
   • Если выбрана опция SMTP-авторизации, то понадобится ввести тип авторизации type of authentication method: auto, plain, scram-sha-1, cram-md5, gssapi, external, digest-md5, login, ntlm.
   • Если необходим TLS-протокол защищенной передачи данных, то в строке TLS enabled наберите y, в противном случае — n.
3. Дождаться пока задача по настройке почтового сервера будет закончена.
4. Убедиться в правильности введенных данных настройки почтового сервера можно снова в 6. Manage sites in the pool > 4. Change e-mail settings on site:

   

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Настройка https на сайте (Change https settings on site)

По умолчанию в виртуальной машине включена поддержка доступа к сайтам через протоколы HTTP и HTTPS.

Если необходимо оставить доступ к сайту только по защищенному протоколу HTTPS, то для этого нужно:

• Перейти в главном меню в 6. Manage sites in the pool > 5. Change https settings on site и ввести имя хоста, для которого нужно настроить протокол доступа:

  

• Согласиться на отключение HTTP доступа и дождаться пока задача будет закончена:

  

  Внимание! Для доступа к сайту только по протоколу HTTPS необходим SSL-сертификат от доверенного центра сертификации, иначе браузеры будут выдавать ошибку, что сертификат безопасности сайта не является доверенным.

Аналогичным способом осуществляется возврат доступа к сайту по протоколу HTTP:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Настройка резервного копирования сайта (Change backup settings on site)

При разворачивании проектов на базе BitrixVM, часто встает задача создания резервной копии проекта по расписанию.

В «1C-Битрикс: Виртуальная машина» версии 4.х появился функционал автоматического резервного копирования сайта, находящегося в директории /bitrix/home/www/, и базы данных. Бекап будет создан по расписанию в виде архива .tar.gz и записан в директории /home/bitrix/backup/archive/.

У данного способа есть как преимущества, так и недостатки в сравнении с встроенным в продукты «1С-Битрикс» механизмом создания резервной копии:

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

Для создания расписания автоматического резервного копирования средствами BitrixVM необходимо:

• В меню виртуальной машины выбрать пункт 6. Manage sites in the pool > 6. Change backup settings on site.
• Выбрать из списка имя хоста и согласиться на изменение настроек расписания автоматического резервного копирования:

  

• Выбрать периодичность и час запуска автоматического резервного копирования:

  

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

  /opt/webdir/bin/bx-sites -a backup -d dbcp --enable --minute=10 --hour=18 --day=any --month=any --weekday=any
  

  Примечание: Как настроить правильное время в «1C-Битрикс: Виртуальная машина» см. здесь.

• На этом работа мастера настройки завершена, и в Cron (/etc/crontab) добавляется задача резервного копирования проекта:

  

  Бэкап делается для ядра (сайта типа kernel и ext_kernel) и всех его link, если такие существуют.
  Для этого создается задание в crontab-файле:

  10 22 * * * bitrix /opt/webdir/bin/bx_backup.sh sitemanager0 /home/bitrix/backup/archive
  

  В качестве первой опции указывается имя БД, второй опцией указывается каталог, в котором будет создан архив.

  В итоге скрипт создаст архив следующего вида: www_backup__DD.MM.YYYY_<random_string>.tar.gz (например — www_backup_dbcp_21.10.2014_1RJKXbMv.tar.gz).

  Внутри архива должны присутствовать следующие файлы:

  1. дамп БД /home/bitrix/mysql_dump__DD.MM.YYYY_.sql
  2. данные сайта ядра
  3. данные сайтов типа ссылок с полным путем

Управление бэкапами через bx-sites

• -a|--action — действие по управлению сайтами, в данном случае это backup
• -d|--database — название БД (в бэкапе будут содержаться данные для всех сайтов, которые используют эту БД)
• --enable|--disable — включение или отключение бэкапа для сайтов
• --minute — параметры записи в crontab файле (минуты)
• --hour — параметры записи в crontab файле (часы)
• --day — параметры записи в crontab файле (день)
• --month — параметры записи в crontab файле (месяц)
• --weekday — параметры записи в crontab файле (день недели)

В случае успешного выполнения утилита вернет новые опции для сайта:

/opt/webdir/bin/bx-sites -a backup -d sitemanager0 --enable --minute=10 --hour=23 --day=1 --month=any --weekday=any -o json | python -mjson.tool  
...
            "BackupCronFile": "/etc/crontab",
            "BackupDay": "1",
            "BackupFolder": "/home/bitrix/backup/archive",
            "BackupHour": "23",
            "BackupMinute": "10",
            "BackupMonth": "*",
            "BackupTask": "enable",
            "BackupVersion": "v5",
            "BackupWeekDay": "*", 
...

Списки исключений

Ряд файлов/каталогов необходимо исключить из резервной копии. Список таких исключений можно найти в файле /opt/webdir/bin/ex.txt.

По умолчанию, в нем находятся следующие подкаталоги:

bitrix/cache
bitrix/managed_cache
bitrix/stack_cache
bitrix/local_cache
bitrix/backup
bitrix/tmp
upload/tmp
upload/resize_cache

Содержимое бэкапа/восстановление

Как уже сказано выше, в бэкап включается:

• сам каталог сайта ядра (kernel или ext_kernel);
• файл dump БД (/home/bitrix/mysql_dump_<db>.sql);
• каталоги сайтов (link), которые используют ядро.

Например команда:

/opt/webdir/bin/bx_backup.sh sitemanager0 /home/bitrix/backup/archive

создает файл www_backup_sitemanager0_30.01.2015_bnnW1NPm.tar.gz в директории /home/bitrix/backup/archive/

Для восстановления, нужно перейти в DocumentRoot ядра, выполнить:

tar xzvvf www_backup_sitemanager0_30.01.2015_zEQkXREd.tar.gz ./
...  
-rw-r--r-- bitrix/bitrix    5013 2015-01-30 14:02 ./workgroups/.left.menu_ext.php
-rw-r--r-- bitrix/bitrix     319 2015-01-30 14:01 ./.top_links.menu.php
-rw-r--r-- root/root     5313008 2015-01-30 14:22 home/bitrix/mysql_dump_sitemanager0_30.01.2015_bnnW1NPm.sql
drwxr-xr-x                    Creating directory: home
drwxr-xr-x                    Creating directory: home/bitrix
-rw-r--r-- root/root          44 2015-01-30 14:22 home/bitrix/mysql_dump_sitemanager0_30.01.2015_bnnW1NPm_after_connect.sql

После чего нужно восстановить БД:

mysql sitemanager0 < home/bitrix/mysql_dump_sitemanager0_30.01.2015_bnnW1NPm_after_connect.sql

И данные дополнительных сайтов, если они есть:

rsync -av home/bitrix/ext_www/ /home/bitrix/ext_www/

Примечание: Не забывайте следить за свободным местом на диске и периодически удалять старые резервные копии.

Настройка NTLM-авторизации на всех сайтах (Configure NTLM auth for all sites)

Для поддержки механизма NTLM-авторизации продуктами «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке» необходим модуль AD/LDAP интеграция версии 11.5.0 и выше.

После включения и настройки новый механизм NTLM-авторизации начинает работать следующим образом:

• неавторизованный посетитель приходит на проект, где обработчиком события он перенаправляется на открытый порт Apache (8890 для http или 8891 для https);
• Apache выполняет NTLM-авторизацию пользователя и пользователь перенаправляется назад на 80 или 443 порт (для http и https соответственно);
• следующие переходы по сайту пользователь выполняет в обычном режиме.

Рассмотрим настройку на примере «Битрикс24 в коробке».

Настройка NTLM-авторизации пользователей в «Битрикс24 в коробке»

• Во время установки, в мастере выбираем Разрешить пользователям Active Directory авторизовываться на портале:

  

• Далее вводим настройки подключения к домену AD, проверяем соединение:

  

• Указываем соответствия групп в AD группам корпоративного портала:

  

• После завершения установки в административном разделе портала открываем страницу Active Directory / LDAP серверы (Настройки > AD/LDAP):

  

• редактируем параметры сервера Active Directory, указывая домен для NTLM авторизации:

  

• После этого заходим в настройки модуля AD/LDAP и устанавливаем Использовать NTLM авторизацию:

  

Продукт «1С-Битрикс» готов к использованию NTLM-авторизации, осталось настроить виртуальную машину.

Настройка NTLM-авторизации пользователей в «1С-Битрикс: Виртуальная машина»

Для настройки виртуальной машины необходимо подключитьcя к ней под пользователем root, выбрать пункт меню 6. Manage sites in the pool > 7. Configure NTLM auth for all sites и ввести необходимые данные:

После подтверждения корректности введенных данных мастер настроит и запустит все необходимые службы, а также подключит виртуальную машину в домен.

net ads testjoin

Настройка завершена, для успешной NTLM-авторизации осталось проверить настройки браузеров.

Настройка NTLM-авторизации в браузерах

• Internet Explorer

  Для успешной NTLM-авторизации нужно, чтобы веб-сервер находился в зоне Local Intranet (при необходимости нужно добавить):

  

• Mozilla Firefox:

  Добавить веб-сервер к списку доверенных URI для автоматической NTLM-авторизации (через параметр network.automatic-ntlm-auth.trusted-uris на странице Firefox: about:config)

  

Примечание: Действия по включению NTLM-авторизации на уже установленном продукте «Битрикс24 в коробке», а также в «1С-Битрикс: Управление сайтом» аналогичны перечисленным выше, за исключением того, что сервер Active Directory добавляется вручную в административном разделе.

Настройка xmppd|smtpd сервисов для сайта (Configure optional services (xmppd|smtpd) for site)

Мастер позволяет управлять работой сервисов XMPP и SMTP с помощью Cron. Это может понадобится, если необходимо рассылать jabber- и почтовые сообщения в случае, если на сайте нет активности, т.е если все события на сайте работают на хитах.

Для управления необходимо:

• Из административного меню запустить мастер 6. Manage sites in the pool > 8 Configure optional services (xmppd|smtpd) for site:

  

• Далее указать:
  • Enter site-name — имя сайта;
  • Enter service name — имя сервиса xmppd или smtpd.
• И согласиться на активацию работы сервисов через Cron:

  

• После завершения данной задачи jabber-уведомления и почтовые сообщения будут отправляться по cron-расписанию, независимо от активности на сайте.

Аналогичным образом отключается данные опции:

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Настройки NGINX в BitrixVM для работы с композитом

Внимание! Настройки в виртуальной машине BitrixVM должны производиться после осуществления настроек Композитного сайта в Административном разделе. Если такие настройки выполнены в колонке Composite должно стоять Y.

/opt/webdir/bin/bx-sites -o json -a composite --enable --site=default

/opt/webdir/bin/bx-sites -o json -a composite --disable --site=default

Условия работы композитного кеша

Примечание: Указанные в этом уроке настройки производить не нужно. Здесь дано описание того, что происходит при включении настроек NGINX на технологию Композитный сайт в BitrixVM только для ознакомления.

map $uri $composite_key {
  default                         $uri;
  ~^(?P.+)/$           $non_slash;
  ~^(?P.+)/index.php$  $non_index;
  ~^(?P.+)/index.html$ $non_index;
}

Конфигурационный файл сайта

Примечание: Указанные в этом уроке настройки производить не нужно. Здесь для ознакомления дано описание того, что происходит при включении настроек NGINX на технологию Композитный сайт в BitrixVM.

    # Include parameters common to all websites
    include bx/conf/bitrix.conf;

Сайты с ошибками (Show sites with errors)

Если по каким-либо причинам на сайтах появились серьезные ошибки: отсутствие модулей на сайте или нет подключения к БД (не получается подключиться с данными настроек сайта), то в меню виртуальной машины появляется пункт меню 6. Manage sites in the pool > 10. Show sites with errors:

Выбрав этот пункт меню, отобразится список сайтов с кратким описанием ошибки (в данном примере — нет соединения с базой данных mysql):

Примечание: Пункт меню 6. Manage sites in the pool > 10. Show sites with errors является скрытым и появляется только тогда, когда есть ошибки на сайтах под управлением виртуальной машиной BitrixVM или linux-окружением BitrixEnv. Как только ошибки будут исправлены, данный пункт снова скроется.

Управление sphinx (Manage sphinx in the pool)

Использование Sphinx в качестве поискового механизма позволит значительно увеличить скорость поиска и снизит нагрузку на сервер.

Для его установки необходимо:

• Установить и обновить проект до последней актуальной версии;
• В меню виртуальной машины выбрать пункт 7. Manage sphinx in the pool > 1. Create sphinx instance on server:

  

• Далее ввести имя хоста, где будет запущен сервер поиска Sphinx (в данном примере server2):

  

• Выбрать базу данных ядра системы сайта из списка:

  

• Дать согласие на запуск полной переиндексации после установки сервера Sphinx:

  

• Подождать, пока задача по установке Sphinx и переиндексации будет закончена:

  

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Примечание: Ручная настройка поискового механизма Sphinx описана в данном уроке.

Управление веб-серверами (Manage web nodes in the pool)

В «1C-Битрикс: Виртуальная машина» можно быстро развернуть кластеризацию веб-сервера в «1С-Битрикс: Управление сайтом» и «Битрикс24 в коробке».

При разделении проекта на несколько веб-серверов необходимо решить две задачи:

• синхронизация данных (файлов) между серверами
• балансировка нагрузки между серверами

Внимание! Для кластеризации веб-сервера необходим модуль Веб-кластер, который входит не во все редакции продуктов «1С-Битрикс».

Создание веб-сервера (Create web instance on server)

Для создания веб-сервера нужно:

• Выбрать пункт меню 8. Manage web nodes in the pool > 1. Create web instance on server, :

  

• Ввести имя хоста в пуле, на котором будет создан веб-сервер (в данном примере — server5):

  

• Подождать, пока задача по созданию веб-сервера будет закончена.

Удаление веб-сервера (Remove web instance on server)

Для удаления веб-сервера необходимо:

• Выбрать пункт меню 8. Manage web nodes in the pool > 2. Remove web instance on server.
• Ввести имя хоста удаляемого веб-сервера (например server1):

  

• Подождать, пока задача по удалению веб-cервера будет закончена.
• В итоге из двух веб-серверов останется один на машине server5:

  

Таким образом, мы перенесли веб-сервер с машины server1 на server5, освободив ресурсы машины server1 под другие роли.

Внимание! Задачи могут выполняться довольно длительное время (до 2-3 часов и более) в зависимости от сложности задачи, объема данных, используемых в этих задачах, мощности и загруженности сервера. Проверить текущие выполняемые задачи можно с помощью меню 5. Background tasks in the pool > 1. View running tasks.

Мониторинг (Monitoring in pool)

При разворачивании проектов на базе BitrixVM необходимо следить за состоянием сервера и отдельных его компонентов.

В составе «1C-Битрикс: Виртуальная машина» версии 5.х уже имеются системы мониторинга такие как Munin и Nagios, которые имеют большое количество различных компонентов по отслеживанию функционирования всех систем сервера.

Для начала работы систем мониторинга необходимо:

• В главном меню виртуальной машины выбрать пункт 9. Monitoring in pool > 1. Enable monitoring in the pool:

  

• Затем мастер сделает необходимые настройки и запустит сервисы мониторинга сервера:

  

Для мониторинга сервера из браузера нужно зайти по адресам и авторизоваться под учетными записями мониторинга:

• Munin — http://адрес_сервера/munin/:
  логин: admin
  пароль: muninBitrixMon

  

• Nagios — http://адрес_сервера/nagios/:
  логин: nagiosadmin
  пароль: nagiosBitrixMon

  

Дополнительные настройки BitrixVM

Внимание! Для операций, описанных в данной главе, необходимы начальные знания администрирования. Перед началом проведения данных операций рекомендуется сделать полный бэкап «Виртуальной машины».

Изменение стандартных настроек BitrixVM без отключения автоподстройки

При запуске виртуальной машины BitrixVM или физического сервера с установленным пакетом BitrixEnv сервисом bvat автоматически настраиваются основные параметры Apache, PHP, MySQL в зависимости от количества доступной памяти. Это позволяет обеспечивать оптимальные настройки сервера.

Но в ряде случаев возникает необходимость изменения некоторых параметров без отключения сервиса bvat. Для внесения таких изменений в настройки сервера предусмотрены специальные конфигурационные файлы, позволяющие переопределять параметры, устанавливаемые сервисом bvat. Они хранятся в директориях:

• MySQL — /etc/mysql/conf.d/z_bx_custom.cnf
• Apache — /etc/httpd/bx/custom/z_bx_custom.conf
• nginx — /etc/nginx/bx/settings/z_bx_custom.conf
• PHP — /etc/php.d/z_bx_custom.ini

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

Увеличение дискового пространства BitrixVM

Внимание! Для операций, описанных в данной главе, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

При использование виртуальной машины BitrixVM или ami-образа BitrixVM, со временем может возникнуть проблема нехватки свободного места.

Решить эту проблему можно двумя способами:

1. добавить в виртуальную машину еще один жесткий диск, смонтировать его в системе и перенести на него часть контента (наиболее оптимальный способ);
2. увеличить размер существующего виртуального жесткого диска.

Добавление дополнительного жесткого диска BitrixVM

Внимание! Для операций, описанных в данном уроке, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

Так как основной объем дискового пространства потребляется контентом сайтов и их резервными копиями, расположенными в /home/bitrix, а также БД, расположенной в /var/lib/mysql, то на отдельные диски следует выносить именно эти разделы.

Рассмотрим данную задачу на примере переноса на отдельный диск папки /home с контентом сайтов и их резервными копиями.

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

  

  

• После добавления диска, для его инициализации, возможно, потребуется перезагрузить сервер. Увидеть новый диск и присвоенное ему буквенное обозначение можно, выполнив команду:

  fdisk -l

  

• Запускаем утилиту fdisk для работы с диском /dev/sdb:

  fdisk /dev/sdb

  И командой n создаем новый раздел:

  • основной (primary partition) — команда p и Partition number (1-4): 1;
  • первый и последний сектора при этом выбираем по умолчанию — таким образом, будет создан раздел, используя все свободное пространство на диске:

  

Для сохранения изменений на диск и выхода из fdisk введите команду w.

• После сохранения таблицы разделов, форматируем новый раздел и переносим на него информацию из /home:

  mkfs.ext4 /dev/sdb1 
  mount /dev/sdb1 /mnt 
  service httpd stop 
  service nginx stop
  mv -f /home/* /mnt 
  umount /mnt
  

• Следующим шагом определяем UUID нового диска:

  blkid
  /dev/sda1: UUID="99066558-ba04-465c-9962-e827aa2928ec" TYPE="ext4" 
  /dev/sda2: UUID="8ea38ef9-1ee5-423b-a013-15fd603a678e" TYPE="swap" 
  /dev/sda3: UUID="08ec5c65-8fd8-47ac-a998-d81195c8f964" TYPE="ext4" 
  /dev/sdb1: UUID="b2e58731-b621-4bd5-909a-afe3bb5dd8a1" TYPE="ext4"
  

  и добавляем запись (в данном примере: UUID=b2e58731-b621-4bd5-909a-afe3bb5dd8a1) о нем в /etc/fstab (вместо UUID можно также использовать имя устройства /dev/sdb):

  

• Остается только примонтировать новый диск и запустить остановленные ранее службы:

  mount /home 
  service httpd start 
  service nginx start 
  

Добавление дисков в других средах виртуализации или непосредственно на физическом сервере проходит аналогично.

Увеличение размера существующего жесткого диска BitrixVM

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

В данном примере воспользуемся виртуальной машиной BitrixVM для VMWare и покажем, как увеличить размер системного диска до 100Гб.

1. Для этого необходимо запустить VMWare Player, в списке виртуальных машин выбрать виртуальную машину BitrixVM и нажать Edit virtual machine settings:

   

2. В окне устройств выбрать Hard Disk, размер которого нужно увеличить, и активировать в меню Utilities пункт Expand:

   

3. В открывшемся окне Expand Disk Capacity в поле Maximum disk size (GB) указать необходимый объем виртуального диска в гигабайтах (в данном примере — 100Гб):

   

4. Далее необходимо запустить виртуальную машину BitrixVM, авторизоваться под root и перейти в режим командной строки (консоль), выбрав пункт меню 0. Exit в виртуальной машине.
5. Смотрим диск и присвоенное ему буквенное обозначение консольной командой:

   fdisk -c -u -l

   

   где для диска /dev/sda:

   • sda1 — загрузочный сектор диска;
   • sda2 — файл подкачки (swap);
   • sda3 — раздел, в котором установлена операционная система и который как раз и нужно увеличить.
6. Запускаем утилиту fdisk для работы с диском /dev/sda:

   fdisk -c -u /dev/sda

7. Командой d удаляем раздел sda3, выбрав Partition number (1-4): 3:

   

   Внимание! Данные с диска при этом никуда не удаляются, в данном случае удаляется лишь запись о разделе из таблицы разделов диска.

8. Далее командой n создаем новый раздел:
   • основной (primary partition) — команда p и Partition number (1-4): 3;
   • первый и последний сектора при этом выбираем по умолчанию — таким образом, будет создан раздел, используя все свободное пространство на диске.

   

9. Для сохранения обновленной таблицы разделов и выхода из fdisk введите команду w:

   

10. Чтобы система подгрузила новую таблицу разделов, необходима перезагрузка виртуальный машины:

    reboot

11. После перезагрузки с помощью утилиты resize2fs увеличиваем размер файловой системы раздела /dev/sda3:

    resize2fs /dev/sda3

    

Проверить, что раздел увеличен можно с помощью команды df:

Изменение размера дисков в других средах виртуализации проходит аналогично.

Дополнительно:

Если нужен диск объёмом более [dw]2 Тб[/dw][di]Утилита fdisk умеет расширять диск не более чем на 2Тб.[/di], это можно сделать так.

Увеличение размера LVM-раздела BitrixVM

Внимание! Для операций, описанных в данном уроке, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

Внимание! По умолчанию в CentOS 7 устанавливается менеджер логических томов LVM2 при автоматической разбивке диска на этапе установки системы (в случае установки BitrixEnv c помощью скрипта bitrix_env.sh на готовый CentOS 7). В таком случае изменение размера LVM-раздела будет отличаться от предыдущих способов.

Пусть размер системного диска был увеличен с 20 ГБ до 100Гб, как было сделано ранее в VMWare Player.

Тогда действия по изменению размера LVM-раздела будут такими:

1. Смотрим, что в системе на данный момент есть из устройств/разделов командой:

   fdisk -l

   

2. Убеждаемся, что место в системе автоматически не увеличилось при помощи команды:

   df -h

   

   Здесь мы также видим и запоминаем имя группы томов и имя тома (у вас они будут другие):

   • cl — имя группы томов;
   • root — имя тома.

3. Создаем новый раздел sda3 — тип раздела: Linux LVM (код типа 8e) на неразмеченной области. Для этого начинаем работу с устройством sda c помощью команды:

   fdisk /dev/sda

4. Далее командой n создаем новый раздел:
   • основной (primary partition) — команда p и Partition number (1-3, default 3): 3 (так как у нас было 2 логических раздела sda1 и sda2 — п.1);
   • первый и последний сектора при этом выбираем по умолчанию — таким образом, будет создан раздел, используя все свободное пространство на диске;
   • укажем тип раздела — команда t и Partition number (1-3, default 3): 3;
   • вводим код типа раздела, соответствующий Linux LVM — 8e;
   • смотрим таблицу разделов — команда p и убеждаемся, что все верно;
   • Раздел sda3 создан. Для сохранения обновленной таблицы разделов и выхода из fdisk — команда w.

     

5. Чтобы система подгрузила новую таблицу разделов, необходима перезагрузка виртуальной машины:

   reboot

6. После перезагрузки необходимо создать физический том sda3:

   pvcreate /dev/sda3

7. Далее расширяем группу томов на новое пространство, используя имя группы томов cl (которое мы запомнили ранее в п.2):

   vgextend /dev/cl /dev/sda3

8. Теперь расширим логический том, используя имя тома root (которое мы запомнили ранее в п.2):

   lvextend -l+100%FREE /dev/cl/root

9. Сканируем диски на предмет наличия групп томов и активируем все найденные группы томов:

   vgscan
   vgchange -ay
   

   

10. Узнаем тип файловой системы:

    file -s /dev/sda1

    

    Видим, что файловая система XFS.

11. И наконец, расширяем файловую систему XFS (может потребоваться время):

    xfs_growfs /dev/cl/root

    

    Внимание! Если файловая система не XFS, а, например, ext4 или reiserfs, то команды будут такие (с учетом cl — имя группы томов и root — имя тома из п.2):

    • resize2fs /dev/cl/root — для ext4;
    • resize_reiserfs /dev/cl/root — для reiserfs;
12. Проверяем итоговый результат:

    df -h

    

Добавление ssl-сертификатов в BitrixVM

Предположим у нас есть сайт http://site1.bx, и нам нужно переключить работу сайта на защищенный протокол https.

Наши действия будут такими:

1. Сначала вы должны получить SSL-сертификат от центра сертификации, который вы выбираете сами. У вас должны быть файлы:
   • site1.bx.key — приватный ключ домена (созданный вами на этапе отправки заявки на получение сертификата или присланный центром сертификации)
   • site1.bx.crt — публичный сертификат домена (присланный центром сертификации)
2. Далее загружаем полученные сертификаты от центра сертификации, например, в директорию /etc/nginx/ssl/ с помощью любого менеджера файлов по протоколу sftp (например WinSCP).
3. Дальнейшие команды выполняются в консоли виртуальной машины BitrixVM/BitrixEnv (0. Exit в главном меню) либо аналогичные действия в менеджере файлов, как удобнее.
4. При обновлении виртуальной машины BitrixVM/BitrixEnv возможна автоматическая перезапись стандартных файлов nginx, поэтому скопируем файл конфигурации ssl.conf в новый файл site1.bx_ssl.conf (название файла может быть любым). Для удобства, это делается для каждого сайта, если их у вас несколько:

   cp /etc/nginx/bx/conf/ssl.conf /etc/nginx/bx/conf/site1.bx_ssl.conf
   

5. Затем редактируем файл /etc/nginx/bx/conf/site1.bx_ssl.conf и указываем расположение site1.bx.key (приватный ключ домена) и site1.bx.crt (публичный сертификат домена) в директивах nginx ssl_certificate_key и ssl_certificate соответственно.

   ssl_certificate /etc/nginx/ssl/site1.bx.crt;	# публичный сертификат домена
   ssl_certificate_key /etc/nginx/ssl/site1.bx.key;# приватный ключ домена
   

6. Открываем файл /etc/nginx/bx/site_avaliable/bx_ext_ssl_site1.bx.conf и ищем в нем строку:

   include bx/conf/ssl.conf;
   

   и меняем на:

   include bx/conf/site1.bx_ssl.conf;
   

   Примечание: Для сайта по умолчанию s1 (который находится в директории /home/bitrix/www) файл будет называться /etc/nginx/bx/site_avaliable/s1.ssl.conf, а для дополнительных сайтов (которые создаются в директории /home/bitrix/ext_www/название_хоста) — /etc/nginx/bx/site_avaliable/bx_ext_ssl_название_хоста.conf.

7. Проверяем, что конфигурационные файлы nginx без ошибок:

   nginx -t
   

8. И если все в порядке, перезапускаем nginx:

   CentOS 6:

   service nginx restart
   

   CentOS 7:

   systemctl restart nginx.service
   

9. Далее можно переключить работу сайта только по протоколу https в меню 6. Mange sites in the pool > 5. Change https settings on site. Как это сделать написано здесь.
10. И в административном интерфейсе произвести необходимые настройки для контента сайта. Рекомендации прочитать можно здесь.

Внимание! В случае использования NTLM-авторизации по протоколу https нужно еще также указать пути до SSL-сертификата в файле /etc/httpd/bx/conf/ntlm_bitrix.conf.

Теперь даже после обновления виртуальной машины BitrixVM/BitrixEnv, если стандартные файлы конфигурации nginx будут изменены, то сайт продолжит работать по протоколу https.

Подключение Swap-раздела

Внимание! Для операций, описанных в данном уроке, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

Виртуальная машина BitrixVM поставляется с swap-разделом 256 МБ, а в образе ami он по умолчанию не подключен. Поэтому в процессе эксплуатации может возникнуть необходимость в расширении раздела подкачки.

Как и в случае с увеличением свободного места, наиболее простой способ — добавить дополнительный диск и разместить раздел подкачки на нем, либо создать файл подкачки.

Для этого:

• подключаем к виртуальной машине диск или создаем файл подкачки:

  dd if=/dev/zero of=/swapfile bs=1M count=1024
  

• создаем на диске:

  mkswap /dev/sdb1
  

  или в файле swap-раздел:

  mkswap /swapfile
  

• подключаем раздел подкачки:

  swapon /dev/sdb1
  

  или файл подкачки:

  swapon /swapfile
  

• и наконец, добавляем запись о новом разделе подкачки в /etс/fstab, чтобы не включать после каждой перезагрузки вручную:

  /dev/sdb1 none swap sw 0 0
  

  или о файле подкачки:

  /swapfile none swap sw 0 0
  

Дополнительные настройки и отладка msmtp

Данная информация пригодится для ручной настройки и диагностики ошибок с почтой в Виртуальная машина BitrixVM/BitrixEnv v.5.x.

Примечание: Для Виртуальная машины BitrixVM/BitrixEnv v7.x никакой ручной настройки, как правило, не требуется. Нужно только создать пул и настроить почту с помощью мастера настройки почты в меню виртуальной машины.

Изменения в конфигурационных файлах

В настройке используется пакет msmtp (он идет в стандартных зависимостях для пакета bitrix-env).
Из пакета приходят настройки php-модуля в файле /etc/php.d/bitrixenv.ini:

sendmail_path = msmtp -t -i

При конфигурации из веб-интерфейса или из консольного меню:

1. создается или обновляется конфигурационный файл /home/bitrix/.msmtprc:

   # smtp account configuration for default
   account default
   logfile /home/bitrix/msmtp_default.log
   host 192.168.0.25
   port 25
   from name@site.ru
   keepbcc on
   auth on
   user name@site.ru
   password XXXXXXXXXXXXXX
   tls on
   tls_certcheck off
   

2. Аккаунт с именем default используется по умолчанию для всех сайтов. Если настраивается почтовый ящик для сайта, отличного от default, то вносятся изменения в конфигурационный файл apache (конфигурационный файл сайта):

     <Directory /home/bitrix/www/> 
           ...     
           php_admin_value sendmail_path "msmtp -t -i -a <ИМЯ_САЙТА>" 
    </Directory> 
   

3. создается символическая ссылка с /home/bitrix/.msmtprc на /etc/msmtprc (данное действие необходимо для заданий отправки почты, которые выполняются через crontab).

Используемые скрипты

Данные рекомендации будут полезны для автоматизации тестирования.

Для создания из web или консоли используется скрипт /opt/webdir/bin/bx-sites.

При настройке почты он принимает следующие параметры:

 bx-sites -o json -a email --smtphost=smtp.yandex.ru 
  --smtpuser='ivan@yandex.ru' --password=XXXXXXXXXX 
  --email='ivan@yandex.ru' --smtptls -s alice

где:

• -a email — тип действия, которое мы выполняем для сайта (-h позволит получить весь доступный список);
• --smtphost — IP адрес или DNS имя хоста, через который будет отправляться почта;
• --smtpuser — логин пользователя (в случае, если не используется данный параметр, можно опустить);
• --password — пароль для авторизации на почтовом сервере;
• --email — поле from в письме;
• --smtptls — включает TLS при отправке почты;
• -s|--site — название сайта (по умолчанию будет использован default).

Проблемы и их решение

В разделе описаны найденные и решенные проблемы, а также способы отладки почтовых проблем.

1. msmtp ведет лог отправки уведомлений. Например, в логе можно найти информацию, почему письмо не ушло:

   Сен 04 14:41:11 host=smtp.yandex.ru tls=on auth=on user=bx@ya.ru from=bx@ya.ru recipients=3458@gmail.com smtpstatus=554  
   smtpmsg='554 5.7.1 Message rejected under suspicion of SPAM adxPcTaXWc-fB4SvmKU' errormsg='the server did not accept the mail' exitcode=EX_UNAVAILABLE 
   

2. msmtp не пишет информацию, если не смог запустится или конфигурация некорректна. Запускаем отправку из консоли (меняем адрес получателя на свой):

   echo -e "test message" | /usr/bin/msmtp --debug -t -i name@site.ru
   

   тут может быть ошибка, например, загрузки конфигурации:

   ignoring system configuration file /etc/msmtprc: Нет такого файла или каталога
   ignoring user configuration file /.msmtprc: Нет такого файла или каталога
   falling back to default account
   

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

3. если в п.2 все хорошо и письма все еще не ходят:
   • Поместить данный скрипт test_email.sh в каталог /usr/bin/ и выставить права на исполнение:

     #!/bin/bash
     export HOME=/home/bitrix
     
     tmp_dir=/tmp/mail
     
     args=$@
     if [[ ! -d $tmp_dir ]]; then
             mkdir $tmp_dir
             chmod 777 $tmp_dir
     fi
     
     message_body=""
     while read line; do
       message_body="$message_body$linen"
     done < /dev/stdin
     
     tmp_file=$(mktemp $tmp_dir/$(date +%Y%m%d_%H%M%S)_XXXXXXXXX)
     
     echo "=========================================" > $tmp_file
     echo "ARGV: /usr/bin/msmtp --debug -t -i $args" >> $tmp_file
     echo "=========================================" >> $tmp_file
     echo -e "BODY: $message_body" >> $tmp_file
     echo "=========================================" >> $tmp_file
     
     # send message
     echo -e "$message_body" | /usr/bin/msmtp --debug -t -i $args >> $tmp_file && 2>&1
     

   • В конфигурации /etc/php.d/bitrixenv.ini изменить настройки почты:

     sendmail_path = /usr/bin/test_email.sh
     

   • Перезапустить apache.
   • Данный скрипт запускает msmtp с опцией debug и по каждому отправленному письму сохранит информацию о параметрах отправки, о теле письма, а также о результатах запуска команды.

     При создании письма из web-интерфейса вся информация сохраняется в каталоге /tmp/mail, каждое письмо будет сохранено в отдельном файле.

Проблема:
Не отправляются письма уведомлений о заказах с сайта, статистика за день в BitrixVM v5.0.44-5.0.45.

Решение:
Причина в том, что домашний каталог скриптов выставлен в HOME=/, поэтому письма, отправка которых происходит из задания в Cron, не отправляются.

Для решения необходимо:

• либо создать символическую ссылку с /home/bitrix/.msmtprc на /etc/msmtprc — конфигурационный файл /etc/msmtprc является системным файлом для утилиты и позволяет решить нахождение конфигурационного файла при таком параметре HOME.
• либо обновить BitrixVM до версии 5.0.46 и выше.

Проблема:
Не отправляется почта по Cron-у, хотя символическая ссылка с /home/bitrix/.msmtprc на /etc/msmtprc есть.

Решение:
Проблема может быть в том, что для Cron не установлено правильное значение переменной PATH.


Для решения необходимо:

1. Зайти по ssh под логином bitrix и в консоли выполнить команду:

   >echo $PATH
   

2. Получите ответ вида:

   /usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/bitrix/bin
   

3. Далее в файле Cron добавить первой строкой:

   PATH=/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:/sbin:/home/bitrix/bin
   

Корректное монтирование Windows-ресурсов

Внимание! Для операций, описанных в данном уроке, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

В случае необходимости подключения сетевого диска Windows в качестве хранилища для WebDAV можно воспользоваться следующей командой:

mount -t cifs -o -fstype=cifs,iocharset=utf8,username=XXXX,password=XXXX,uid=500,gid=501,fmode=0777,noserverino //xxx.xxx.xxx.xxx/folder /home/bitrix/www/docs/folder/smb

где:

• uid — идентификатор пользователя bitrix;
• gid — идентификатор группы bitrix;
• //xxx.xxx.xxx.xxx/folder — путь к сетевому ресурсу;
• /home/bitrix/www/docs/folder/smb — папка, куда будет смонтирован диск.

Примечание: Использование опции noserverino является обязательным, так как в PHP есть уязвимость.

Настройка отправки Nagios-уведомлений в BitrixVM 5.1.3

Внимание! Данный способ актуален для BitrixVM до версии 5.1.3. В версии BitrixVM 5.1.4 и выше была добавлена возможность настроить email-уведомления для системы мониторинга Nagios. Данная настройка осуществляется в меню настройки мониторинга.

Внимание! Для отправки уведомлений Nagios-ом на email необходимо предварительно включить в меню BitrixVM Мониторинг (Monitoring in pool).

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

1. В /etc/nagios/objects/contacts.cfg указываем параметр email — email пользователя, кому будет отправляться нотификация:

   define contact{
   	contact_name	nagiosadmin		; Short name of user
   	use			generic-contact		; Inherit default values from generic-contact template (defined above)
   	alias		Nagios Admin		; Full name of user
   	email		email@myaddress.com	; <<***** CHANGE THIS TO YOUR EMAIL ADDRESS ******
   	}
   

   Примечание: Можно создать новый контакт, но не забудьте прописать его в секции CONTACT GROUPS в этом же файле. Как это сделать см. в документации Nagios.

2. Далее в /etc/nagios/objects/commands.cfg меняем строки в секции SAMPLE NOTIFICATION COMMANDS запуска MTA на:

   # 'notify-host-by-email' command definition
   define command{
      command_name   notify-host-by-email
      command_line   /usr/bin/printf "%b" "Subject: ** $NOTIFICATIONTYPE$ Host Alert: $HOSTNAME$ is $HOSTSTATE$ **nn ***** Nagios *****nnNotification Type: $NOTIFICATIONTYPE$nHost: $HOSTNAME$nState: $HOSTSTATE$nAddress: $HOSTADDRESS$nInfo: $HOSTOUTPUT$nnDate/Time: $LONGDATETIME$n" | /usr/bin/msmtp --host=hostname --port=number --user=username --passwordeval=eval --from=mailfrom@email.com $CONTACTEMAIL$   
      }
   
   # 'notify-service-by-email' command definition
   define command{
      command_name   notify-service-by-email
      command_line   /usr/bin/printf "%b" "Subject: ** $NOTIFICATIONTYPE$ Service Alert: $HOSTALIAS$/$SERVICEDESC$ is $SERVICESTATE$ **nn ***** Nagios *****nnNotification Type: $NOTIFICATIONTYPE$nnService: $SERVICEDESC$nHost: $HOSTALIAS$nAddress: $HOSTADDRESS$nState: $SERVICESTATE$nnDate/Time: $LONGDATETIME$nnAdditional Info:nn$SERVICEOUTPUT$n" | /usr/bin/msmtp --host=hostname --port=number --user=username --passwordeval=eval --from=mailfrom@email.com $CONTACTEMAIL$   
      } 
   

   где:

   • --host=hostname — адрес smtp-сервера;
   • --port=number — порт smtp-сервера;
   • --user=username — логин для авторизации на smtp-сервере;
   • --passwordeval=eval — пароль для авторизации на smtp-сервере;
   • --from=mailfrom@email.com — от кого будет уходить письмо.

   Примечание: Также можно настроить дополнительные ключи msmtp (TLS-опции и др.), список всех ключей msmtp можно посмотреть консольной командой:
   msmtp --help.

3. Обязательно сделать рестарт Nagios для применения настроек:

   service nagios restart

Т.е, по сути, в конфигурационном файле Nagios мы меняем MTA с mail на msmtp c ключами и немного модифицируем текст сообщения: т.к у msmtp нет ключа Subject: (Тема сообщения), то мы его включаем в тело письма, и оно при получении почтовым клиентом обработается корректно.

Проверить работу нотификаций можно, например, остановив МySQL:

service mysqld stop

По умолчанию Nagios будет записывать в лог 3 сообщения со статусом CRITICALSOFT каждую минуту, а 4-му сообщению даст статус CRITICALHARD. Далее будет инициирована команда notify-service-by-email, которая отправит текст сообщения через msmtp c ключами, настроенными выше. В итоге, в течение 4-5 минут сообщение примерно такого содержания должно уйти на почту:

Subject: ** PROBLEM Service Alert: test1/MySQL: connection to 3306 is CRITICAL ** 

 ***** Nagios *****

Notification Type: PROBLEM

Service: MySQL: connection to 3306
Host: server1
Address: 192.168.2.130
State: CRITICAL

Date/Time: Tue Jan 27 20:15:15 MSK 2015

Additional Info:

Connection refused

После запуска службы MySQL командой # service mysqld start должно прийти сообщение на почту:

Subject: ** RECOVERY Service Alert: server1/MySQL: connection to 3306 is OK **

 ***** Nagios *****

Notification Type: RECOVERY

Service: MySQL: connection to 3306
Host: server1
Address: 192.168.2.130
State: OK

Date/Time: Wed Jan 28 12:30:50 MSK 2015

Additional Info:

TCP OK - 0.001 second response time on port 3306

Выполнение всех агентов на Cron

На больших и не очень проектах часто возникает вопрос с переносом исполнения некоторых особо тяжелых агентов на Cron.

• Для начала полностью отключим выполнение агентов на хите. Для этого необходимо выполнить команду в php-консоли административного меню продукта «1С-Битрикс» /bitrix/admin/php_command_line.php?lang=ru:

  COption::SetOptionString("main", "agents_use_crontab", "N"); 
  echo COption::GetOptionString("main", "agents_use_crontab", "N"); 
  
  COption::SetOptionString("main", "check_agents", "N"); 
  echo COption::GetOptionString("main", "check_agents", "Y");
  

  В результате выполнения должно быть NN.

• Убираем из файла /bitrix/php_interface/dbconn.php определение следующих констант:

  define("BX_CRONTAB_SUPPORT", true);
  define("BX_CRONTAB", true);
  

  И добавляем:

  if(!(defined("CHK_EVENT") && CHK_EVENT===true))
     define("BX_CRONTAB_SUPPORT", true);
   

• Далее создаем файл проверки агентов и рассылки системных сообщений /bitrix/php_interface/cron_events.php:

  <?
  $_SERVER["DOCUMENT_ROOT"] = realpath(dirname(__FILE__)."/../..");
  $DOCUMENT_ROOT = $_SERVER["DOCUMENT_ROOT"];
  
  define("NO_KEEP_STATISTIC", true);
  define("NOT_CHECK_PERMISSIONS",true); 
  define('CHK_EVENT', true);
  
  require($_SERVER["DOCUMENT_ROOT"]."/bitrix/modules/main/include/prolog_before.php");
  
  CMain::FinalActions();
  
  @set_time_limit(0);
  @ignore_user_abort(true);
  
  CAgent::CheckAgents();
  define("BX_CRONTAB_SUPPORT", true);
  define("BX_CRONTAB", true);
  CEvent::CheckEvents();
  ?>
  

• И добавляем данный скрипт в Cron:

   */5 * * * * /usr/bin/php -f /home/bitrix/www/bitrix/php_interface/cron_events.php
  

После этого все агенты и отправка системных событий будут обрабатывается из-под cron, раз в 5 минут.

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

COption::SetOptionString("main", "mail_event_bulk", "20"); 
echo COption::GetOptionString("main", "mail_event_bulk", "5");

Опции монтирования

Внимание! Для операций, описанных в данном уроке, необходимы знания администрирования *nix-систем. Перед началом проведения данных операций рекомендуется сделать полный бекап «Виртуальной машины».

Для обеспечения более высокой производительности файловой системы рекомендуем отключать изменение метки времени при чтении файлов и директорий: noatime, nodiratime.

Для этого в /etc/fstab нужно отредактировать (добавить в текущую строку) параметры в строке со своим UUID:

UUID=abd9bdaa-e17d-40b3-aee5-37ef53a57b16 /    ext4    defaults,noatime,nodiratime    1 1

где UUID=abd9bdaa-e17d-40b3-aee5-37ef53a57b16 — уникальный идентификатор диска, который можно узнать в консоли по команде blkid.

Примечание: Вместо UUID можно также использовать имя устройства: /dev/sda1, /dev/sda2, /dev/sda3. Или метку тома если она задана, например: LABEL=root.

После перезагрузки новые настройки начнут действовать.

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

mount -o remount,noatime,nodiratime /

Подключение IDE

Для упрощения работы с Bitrix Framework в виртуальную машину включён Xdebug. Работает он по схеме:

Перед изменением настроек надо переименовать файл xdebug.ini.disabled в xdebug.ini и перезапустить httpd.

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

$ cat /etc/php.d/xdebug.ini
; Enable xdebug extension module
zend_extension=/usr/lib/php/modules/xdebug.so
xdebug.remote_enable=on
xdebug.remote_host=192.168.205.1
xdebug.remote_port=9000

Примечание: Xdebug требует использовать proxy при работе через Network Address Translation, необходимо открыть порт 9000.

BitrixVM API для провайдеров

В главе описывается API, с помощью которого можно подключить процедуру заказа/создания машины управления пулом в продуктах «1С-Битрикс».

Провайдеры

Вся работа с провайдерами осуществляется с помощью плагинов, расположенных в определенном каталоге (на текущий момент все управление сделано на файлах):
/opt/webdir/providers.

Для каждого провайдера предусмотрены:

• обязательные параметры командной строки для универсализации доступа к их возможностям;
• стандартизированный вывод по завершению обработки результатов.

Скрипт плагина, который будет использован в web-интерфейсе продуктов «1С-Битрикс», должен быть раcположен по адресу:

/opt/webdir/providers/{provider_name}/bin/{provider_name}

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

• help — отображает поддерживаемые аргументы командной строки:

  {
    "options": [
      "help",
      "configs",
      "order",
      "order_status"
    ],
    "status": "enabled"
  }
  

  Массив options должен содержать список поддерживаемых опций (например, в данном случае отсутствует опция init, которая позволяет подключиться на этапе создания мастер сервера).

  Опция status может содержать следующие значения: disabled или enabled, что позволяет определить включен или выключен провайдер на конкретном сервере.

• configs — отображает список поддерживаемых конфигураций:

  {
    "configurations": [
      {
        "id": "1",
        "descr": "Bitrix-env, 1 month, Centos-6 x86_64, CPU 2x1.0 Ghz, Memory 1Gb, HDD 20Gb"
      }
    ],
    "status": "enabled"
  }
  

  configurations — содержит список сервисов/конфигураций, которые может заказать пользователь, используя web интерфейс «1С-Битрикс».

  На текущий момент поддерживается два параметра по каждой конфигурации:

  • id — идентификатор конфигурации, который будет использован в заказе,
  • descr — описание для пользователя.
• order — позволяет заказать сервер/VPS выбранной конфигурации, вторым параметром в данном случае будет передан номер конфигурации:

  {"task_id":"24"}
  

  task_id должен содержать номер задания, который используется для дальнейшего опроса и старта добавления машины по завершению.

• order_status — позволяет получить информацию по заказу:

  {
    "server_password": "XXXXXXXXXXXXXX",
    "status": "finished",
    "server": "xxx.xxx.xxx.xxx",
    "task_id": "24"
  }
  

  где:

  • status — содержит информацию по заказу, может содержать следующие значения:
    • in_progress — находится на обработке со стороны провайдера/хостера;
    • finished — обработка завершена, можно добавлять машину в пул;
    • error — во время выполнения произошла ошибка.
  • server — содержит ip address или имя машины;
  • server_password — содержит пароль пользователя root для копирования ssh-ключей при подключение сервера в пул.

  Любое из действий может сообщить об ошибке с помощью значений в полях error и error_message. Например:

  {
    "error_message": "get_task error N102, No task found",
    "error": 1
  }
  

Внимание! Информацию о работе скрипта, который использует возможности провайдеров и позволяет подключить их в web- интерфейс, см Скрипт работы с провайдерами.

Скрипт работы с провайдерами

Данный скрипт нужен для встраивания плагинов провайдеров в web- интерфейс продуктов «1C-Битрикс».

На текущий момент реализованы следующие методы:

• list — отображает список всех провайдеров, для которых существуют подкаталоги в директории /opt/webdir/providers на машине:

  {
    "params": {
      "providers": {
        "superprovider": {
          "status": "enabled"
        },
        "amazon": {
          "error": 1,
          "message": "bxProvider::optionsProvider: Provider amazon not exist on the host"
        }
      }
    }
  }
  

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

  В случае если провайдеров нет на хосте, список будет пустым:

  {
    "params": {
      "providers": {
        
      }
    }
  }
  

• status — покажет статус для провайдера:

  /opt/webdir/bin/bx-provider -a status --provider superprovider -o json
  {
    "params": {
      "provider_options": {
        "superprovider": {
          "options": {
            "order_status": 1,
            "order": 1,
            "help": 1,
            "configs": 1,
            "init": 0
          },
          "status": "enabled",
          "files": {
            "execute": "/opt/webdir/providers/superprovider/bin/superprovider",
            "holder": "/opt/webdir/providers/superprovider",
            "config": "/opt/webdir/providers/superprovider/etc/superprovider.conf"
          },
          "name": "superprovider",
          "config": "exists"
        }
      }
    }
  }
  

  В данном случае печатает внутреннюю информацию (используется как есть внутри обработчика), по сути, такой статус больше подходит для отладки работы провайдера, чем для использования в web-интерфейсе.

• install и uninstall — создает/удаляет данные для провайдера (на текущий момент больше для отладки, возможно, в дальнейшем с помощью этих методов хостеры смогут установить свой плагин на сервер и удалить его):

  /opt/webdir/bin/bx-provider -a install --provider amazon --archive /tmp/amazon-v01.tar.gz
  

• configs — отображает список всех конфигураций провайдера:

  /opt/webdir/bin/bx-provider -a configs --provider superprovider -o json
  {
    "params": {
      "provider_configs": {
        "superprovider": {
          "configurations": [
            {
              "id": "1",
              "descr": "Bitrix-env, 1 month, Centos-6 x86_64, CPU 2x1.0 Ghz, Memory 1Gb, HDD 20Gb"
            }
          ],
          "status": "enabled"
        }
      }
    }
  }
  

• order — заказывает виртуальный сервер или VPS:

  /opt/webdir/bin/bx-provider -a order --provider superprovider --config_id 1 -o json
  {
    "params": {
      "provider_order": {
        "superprovider": {
          "task_id": "25"
        }
      }
    }
  }
  

• order_status — отображает статус заказа:

  /opt/webdir/bin/bx-provider -a order_status --provider superprovider --task_id 25 -o json 
  {
    "params": {
      "provider_order": {
        "superprovider": {
          "server_password": "XXXXXXXXXXXXXXX",
          "status": "complete",
          "server": "xxx.xxx.xxx.xxx"
          "task_id": "25"
        }
      }
    }
  }
  

• orders_list — список всех заказов, сделанных на хосте:

  /opt/webdir/bin/bx-provider -a orders_list --provider superprovider -o json
  {
    "params": {
      "provider_order_list": {
        "superprovider": {
          "25": {
            "status": "finished",
            "mtime": 1403445981,
            "error": 0,
            "message": ""
          },
          "22": {
            "status": "error",
            "mtime": 1403441000,
            "error": 1,
            "message": "cannot add ssh key to the server"
          },
          "21": {
            "status": "complete",
            "mtime": 1403440979,
            "error": 0,
            "message": ""
          },
          "23": {
            "status": "finished",
            "mtime": 1403441229,
            "error": 0,
            "message": ""
          }
        }
      }
    }
  }
  

  Тут добавлен еще один статус по задаче: complete — это значит, что сервер из данного задания был добавлен в пул.

• order_to_host — запускает процедуру добавления сервера в пул с параметрами, переданными в статусе заказа:

  /opt/webdir/bin/bx-provider -a order_to_host --provider superprovider --task_id 25 -o json