Обновление до v25.02

Процедура обновления на версию v25.02 требует выполнения дополнительных шагов до и после обновления.

  1. Скачайте скрипт миграции:

    wget https://docs.mitigator.ru/collector/master/maintenance/update/update2502-migrate.py -O /srv/collector/update2502-migrate.py
  2. Перейдите в директорию /srv/collector/:

    cd /srv/collector/
  3. Выполните скрипт в режиме анализа:

    python3 update2502-migrate.py analyze
  4. Если в режиме анализа скрипт укажет на наличие неизвестных источников flow, на время обновления добавьте источники flow в интерфейсе MITIGATOR. Это действие позволит в полном объеме сохранить данные по flow. Повторно выполните скрипт в режиме анализа.

  5. Если вносились изменения в файлы docker-compose.gobgp.yml, docker-compose.vpn.yml, перенесите изменения в файл docker-compose.override.yml.

  6. Если для работы Collector используются написанные вами yml-файлы, перенесите их содержимое в файл docker-compose.override.yml

  7. Удалите строку COMPOSE_FILE в .env.

  8. Если ранее был настроен контейнер gobgp, перенесите конфигурацию контейнера gobgp по инструкции.

  9. Для настроенного VPN создайте директорию config/vpn и перенесите ключи VPN:

    mkdir -p config/vpn && \
    mv vpn-public.conf config/vpn/vpn-public.conf && \
    mv vpn-private.conf config/vpn/vpn-private.conf
  10. Назначьте права доступа к настройкам Collector:

        SETTINGS_PATH=$(docker volume inspect collector_db -f '{{.Mountpoint}}') && \
        chown -R 65534:65534 $SETTINGS_PATH
  11. Выполните процедуру обновления.

  12. Выполните скрипт в режиме миграции:

    python3 update2502-migrate.py migrate

    Если ранее была применена операция по уменьшению объема хранимых данных, задайте параметры через аргументы скрипта:

    python3 update2502-migrate.py migrate \
        --zstd8-interval "1 MONTH" \
        --zstd15-interval "6 MONTH" \
        --delete-interval "1 YEAR"
Информация

Выполнение скриптом некоторых операций может занять продолжительное время.
Во время выполнения скрипта Collector продолжает полноценно работать.
Скрипт может быть остановлен и перезапущен позже.