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

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

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

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

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

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

  1. Убедитесь, что время синхронизировано через один NTP-сервер с MITIGATOR.

  2. Сделайте резервную копию настроек и данных flow по инструкции.

  3. Запишите в файл .env строку с версией. Например:

    VERSION=v23.03.1
  4. Загрузите актуальный compose-файл:

    wget https://docs.mitigator.ru/collector/v24.10/dist/docker-compose.yml -O docker-compose.yml

    Убедитесь, что в адресной строке указан номер целевой мажорной версии.

  5. Выполните вход в хранилище образов со своими учетными данными:

    docker login docker.mitigator.ru
  6. Скачайте образы:

    docker-compose pull
  7. Перезапустите Collector:

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

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

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

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

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

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