Перейти к содержимому
BXWiki

Обновления не устанавливаются - ключ, срок, доступ, права

Страница обновлений открывается, но обновления не ставятся или список пуст. Разбираем причины в порядке убывания частоты.

Как проверить

Смотрим ключ и срок продления:

echo \Bitrix\Main\Config\Option::get('main', 'update_site_key'), "\n";
echo \Bitrix\Main\Config\Option::get('main', '~PARAM_MAX_SITES'), "\n";
// ключ вводят в настройках главного модуля, в разделе системы обновлений
// пустое значение ключа означает установку без лицензии: обновления закрыты
// поле активации купона - это другое поле и для другой задачи

Ключ и купон путают чаще всего остального. Купон активирует продление или дополнение, а ключ прописывают в настройках главного модуля; введённый не туда ключ выглядит как отказ активации.

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

Окно терминала
curl -sI https://www.1c-bitrix.ru/ | head -3
curl -sI https://update.1c-bitrix.ru/ | head -3
# закрытый исходящий доступ - обычное дело в облаке и за корпоративным шлюзом

Система обновлений ходит наружу из кода сайта. Проверка из браузера администратора ничего не доказывает: важно, что видит сам сервер, а не рабочее место человека.

Смотрим права и место на диске:

Окно терминала
df -h | grep -E "/$|/home"                     # место под распаковку обновлений
ls -ld bitrix/modules bitrix/updates 2>/dev/null
sudo -u www-data test -w bitrix/modules && echo "запись есть" || echo "записи нет"
# обновление распаковывается в каталоги платформы: без записи оно не начнётся

Читаем журнал ошибок во время обновления:

Окно терминала
tail -f /var/log/php-fpm/error.log &
# и запускаем обновление: ошибка приходит сюда, а не на страницу
grep -iE "update|sysupdate" bitrix/modules/error.log | tail -10

Страница обновлений часто молчит о причине. Сообщение «установлено обновлений ноль» само по себе не говорит ничего, а журнал в этот момент показывает и таймаут, и отказ по правам.

Причины

  1. Ключ не введён или введён не в то поле примерно 30% случаев

    ПризнакСистема сообщает об ошибке активации или предлагает ввести ключ снова и снова.

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

    Что делатьПрописываем лицензионный ключ в настройках модуля; купон активируют отдельно и для другой задачи.

  2. Истёк срок продления обновлений примерно 25% случаев

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

    ПроверкаСмотрим дату окончания продления на странице обновлений и в личном кабинете партнёра.

    Что делатьПродлеваем лицензию: без активного продления система не отдаёт даже обновления безопасности.

  3. Закрыт доступ наружу с сервера сайта примерно 20% случаев

    ПризнакСтраница обновлений долго думает и заканчивается ошибкой соединения.

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

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

  4. Нет прав на запись или места на диске примерно 15% случаев

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

    ПроверкаПроверяем свободное место и право записи в каталоги платформы от имени процессов сайта.

    Что делатьОсвобождаем место, выравниваем владельца файлов и повторяем обновление с того же шага.

  5. Сбоит сам клиент обновлений примерно 10% случаев

    ПризнакСтраница обновлений отдаёт ошибку пятисотую или сообщает о нуле установленных обновлений.

    ПроверкаСмотрим журнал ошибок и целостность служебных файлов системы обновлений.

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

Если ничего не помогло

Проверяем, не включена ли версия для разработки. Она отдаёт бета-обновления, и поведение системы на такой ветке отличается от обычной; для боевого сайта эту галочку держат выключенной.

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

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

Частые вопросы

Куда вводить лицензионный ключ?

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

Ставятся ли обновления безопасности после окончания продления?

Нет: без активного продления система обновлений не отдаёт ничего. Именно поэтому продление считают не «покупкой новых возможностей», а условием поддержки сайта в рабочем состоянии.

Как понять, что дело в закрытом доступе наружу?

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

Что делать при сообщении об установке нуля обновлений?

Смотреть журнал ошибок в момент запуска: страница обновлений почти всегда молчит о причине. Дальше по журналу видно, права это, таймаут или сбой служебного файла.

Можно ли обновляться сразу на несколько версий вперёд?

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

Смежное

Первоисточник