Процедура обновления Collector

Внимание

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

Несоблюдение этих требований может привести к неправильной работе Collector и потере данных.

Пример:
Если текущая версия Colleсtor – v23.12.2, а требуется обновиться на версию v24.07.x, то путь обновления должен выглядеть следующим образом:

v23.12.2 → v23.12.8 → v24.04.2 → v24.07.x.

Сверяйтесь со списком версий при планировании обновления.

Информация

• Специальные инструкции для обновления до v26.04.
• Специальные инструкции для обновления до v25.06.
• Специальные инструкции для обновления до v25.02.
• Специальные инструкции для обновления до v24.07.
• Специальные инструкции для обновления до v24.04.
• Специальные инструкции для обновления до v23.11.
• Специальные инструкции для обновления до v23.08.

Убедитесь, что время синхронизировано через один NTP-сервер с MITIGATOR.
Сделайте резервную копию настроек и данных flow по инструкции.
Запишите в файл .env строку с версией. Например:
```
VERSION=v23.03.1
```
Загрузите актуальный compose-файл:
```
wget https://docs.mitigator.ru/collector/master/dist/docker-compose.yml -O docker-compose.yml
```
Убедитесь, что в адресной строке указан номер целевой мажорной версии.
Выполните вход в хранилище образов со своими учетными данными:
docker login docker.mitigator.ru
podman login docker.mitigator.ru
Скачайте образы:
docker-compose pull
podman-compose pull
Установите значение лицензионной полосы равное нулю.

Перезапустите Collector:

docker-compose down && docker-compose up -d

podman-compose down && podman-compose up -d

Восстановите значение лицензионной полосы.

Обновление баз GeoIP

Collector использует GeoLite2 базы в формате CSV. Разместите файлы баз Country и ASN в директории /srv/collector/geolite2:

Обработайте файлы командой:

find geolite2 -name '*.csv' -exec sed -e "s|,\('[^,]\+\)|,\"\1\"|g" -i {} \;

Базы GeoIP обновятся в течение нескольких минут.