Обновление трекера из панели

Новый выпуск трекера устанавливается из панели: Настройки → Обновления. Вкладку видят владелец и администратор, обновлять может только владелец установки. Перед установкой трекер сохраняет копию данных и на время копирования и установки останавливает приём кликов и постбеков, а при ошибке сам возвращает прежнюю версию.

Где находится раздел и кто может обновлять

Владелец установки — учётная запись владельца, заданная при установке трекера, см. Мастер первого запуска. Из режима входа под пользователем и по API-токену обновление недоступно. Другие владельцы и администраторы видят сообщение «Обновления доступны только владельцу установки».

Вверху вкладки показаны:

• Установленная версия и метка «Клиентская установка»;
• строка «Последняя проверка» с датой или «Проверьте наличие нового выпуска.», если проверок ещё не было;
• строка «Служба установки» — версия службы, которая выполняет обновления на сервере.

При метке «Среда разработки» кнопки Проверить обновления нет: обновление из панели в такой среде не применяется.

Проверка обновлений

1. Откройте Настройки → Обновления.
2. Нажмите Проверить обновления.
3. Дождитесь, пока в блоке «Проверка обновлений» появится «Готово».

Трекер загружает список выпусков и проверяет его подпись и срок действия. Трафик при проверке не останавливается.

Результат — один из двух:

• карточка «Доступна версия …» с описанием выпуска, строкой «Размер выпуска» и кнопкой Установить…;
• строка «Установлен текущий выпуск.» — обновлять нечего.

Если кнопка Установить… неактивна, а над карточкой показано сообщение «Сначала обновите службу установки на сервере: bash install.sh --update-controller. Работающий трекер сохраняется.», выполните шаги со страницы Обновление службы установки.

Установка

1. Нажмите Установить… в карточке «Доступна версия …».
2. В окне «Обновить до …?» отметьте флажок «На время копирования и обновления разрешаю приостановить приём кликов и постбеков. Длительность зависит от объёма данных.»
3. Нажмите Создать копию и обновить.
4. Следите за этапами в блоке «Обновление до …».

Вкладку можно оставить открытой: ход обновления виден и во время перезапуска панели. Строка «Связь со службой временно недоступна. Ожидаем восстановления; это ещё не результат операции.» — не ошибка, дождитесь следующего этапа.

Ошибка на первых трёх этапах отменяет установку до паузы: работающая версия и трафик не затронуты. Этап сменится на «Не завершено», под ним появится причина — см. Сообщения и что делать.

Проверка

1. Дождитесь этапа «Готово».
2. Убедитесь, что в поле Установленная версия стоит новая версия, а ниже есть строка «Установлен текущий выпуск.»
3. Раскройте История операций: в строке с номером версии результат «Готово».

Состояние служб после обновления — на странице Состояние системы.

Копия перед обновлением

Копия создаётся при остановленных службах и хранится на этом же сервере. Она нужна для автоматического возврата и не заменяет резервные копии на отдельном сервере хранения. После обновления копия остаётся на диске и сама не удаляется. Как проверить, закрепить и очистить такие копии — на странице Локальные копии обновлений.

Автоматический откат

Если ошибка случилась после начала паузы, трекер возвращает прежнюю версию сам:

• ошибка при создании копии — службы запускаются обратно, трафик открывается;
• ошибка при установке или проверке запуска — возвращаются прежние файлы установки и данные из копии, запускается прежняя версия.

В блоке операции этап сменится на «Возвращаем предыдущую версию», затем на «Предыдущая версия восстановлена» с текстом «Новая версия не прошла проверку. Предыдущая версия и данные восстановлены.» Если сервер перезагрузился во время обновления, служба установки выполнит возврат после запуска сервера.

Откат относится только к незавершённой установке. После этапа «Готово» вернуть прежнюю версию из панели нельзя, а более старый выпуск трекер не принимает.

Блокировка

Если возврат прежней версии не удался, в блоке операции появляются этап «Нужно восстановление администратором сервера» и текст «Автоматическое восстановление не завершилось. Трафик остаётся на паузе. Нужна проверка администратором сервера.» Новые проверка и установка не запускаются, пока блокировка не снята.

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

sudo systemctl restart tracker-updates.service

При запуске служба повторяет возврат прежней версии. После успешного возврата трафик открывается, блокировка снимается. Как посмотреть состояние службы — на странице Файлы установки, порты, службы и журналы.

Сообщения и что делать