Как безопасно обновить BitrixVM через SSH: полное руководство

Регулярное обновление серверной платформы BitrixVM — критически важная задача для поддержания безопасности, стабильности и производительности вашего проекта на 1С-Битрикс. В этой статье подробно разберём процесс обновления через командную строку (SSH) для двух основных сценариев, а также расскажем, как проверить результат и найти возможные ошибки.

Подготовка к обновлению

Перед началом любых действий обязательно выполните:

1. Полное резервное копирование сайта (файлы и база данных).
2. Резервное копирование критических конфигурационных файлов (например, /etc/nginx/bx/site_avaliable/*, /etc/php.d/*).
3. Убедитесь, что у вас есть стабильное SSH-подключение к серверу и права суперпользователя (root или через sudo).

Сценарий 1: Обновление до версии 7.5.0

Данный путь используется для первоначального перехода на стабильный релиз 7.5.0.

1. Очистка кеша пакетного менеджера и установка обновлений:

   yum clean all && yum update

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

2. Запуск встроенного скрипта конфигурации BitrixVM:

   /opt/webdir/bin/bx_update_server

   В появившемся интерактивном меню выберите пункт 6. Update server и следуйте инструкциям на экране.

Сценарий 2: Обновление с версии 7.5.1 и выше

Это стандартная процедура для регулярного обновления уже работающей платформы.

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

   yum check-update

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

2. Запуск мастер-обновления BitrixVM:

   /opt/webdir/bin/bx_update_server

   В меню, как и в первом сценарии, выберите 6. Update server. Скрипт автоматически выполнит необходимые действия.

3. Финальная проверка и установка оставшихся пакетов:

   yum update

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

Как проверить логи обновления на наличие ошибок?

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

Лог-файлы обновления PHP и других ключевых компонентов находятся в директории вида:

/opt/webdir/temp/bx_php_upgrade_php-[версия]_[id_задачи]/status

Пример пути к файлу: /opt/webdir/temp/bx_php_upgrade_php-8.2.3_12345/status

Проверить статус и содержание лога можно командами:

cat /opt/webdir/temp/bx_php_upgrade_php-8.2.3_12345/status
# Или для просмотра в реальном времени (если обновление еще идет):
tail -f /opt/webdir/temp/bx_php_upgrade_php-8.2.3_12345/status

Успешное завершение обычно отмечено статусом "Done" или "Finished successfully". Наличие слов "Error", "Failed" или "Rollback" указывает на проблему.

Что делать после обновления?

1. Перезагрузите сервер или ключевые службы: systemctl restart nginx php-fpm
2. Проверьте работоспособность сайта и административной панели.
3. Очистите кеш 1С-Битрикс (Администрирование > Настройки > Настройки продукта > Производительность).
4. Убедитесь, что все критически важные функции (почта, агенты, композитный сайт) работают корректно.

Возможные проблемы и их решение

• «Конфликт зависимостей» при выполнении yum update — попробуйте выполнить команду yum distro-sync для приведения системы в согласованное состояние.
• Скрипт bx_update_server не запускается или не видит обновлений — проверьте доступ к репозиториям Bitrix: yum repolist.
• После обновления сайт выдаёт ошибки PHP — проверьте, что в настройках виртуального хоста (/etc/nginx/bx/site_avaliable/sitename.conf) указана корректная, обновлённая версия PHP-FPM.

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