https://docs.mitigator.ru/collector/v26.08/maintenance/update/Внимание При обновлении нельзя пропускать мажорные версии. Обновление должно всегда выполняться с последней минорной версии обновляемого мажора. Обновление между минорными версиями в рамках одного мажора может выполняться с пропусками. Несоблюдение этих требований может привести к неправильной работе Collector и потере данных. Пример: Если текущая версия Colleсtor – v23.12.2, а требуется обновиться на версию v24.07.x, то путь обновления должен выглядеть следующим образом: v23.12.2 → v23.12.8 → v24.04.2 → v24.07.x.Hugoruhttps://docs.mitigator.ru/collector/v26.08/maintenance/update/2604/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2604/Процедура обновления на версию v26.04 требует дополнительных действий после стандартных шагов. Скачайте скрипт миграции: wget https://docs.mitigator.ru/collector/v26.08/maintenance/update/update2604-migrate.py -O /srv/collector/update2604-migrate.py Перейдите в директорию /srv/collector/: cd /srv/collector/ Выполните скрипт: python3 update2604-migrate.py Если ранее была применена операция по уменьшению объема хранимых данных, задайте параметры через аргументы скрипта: python3 update2604-migrate.py \ --zstd8-interval "1 MONTH" \ --zstd15-interval "6 MONTH" \ --delete-interval "1 YEAR" Информация Collector может принимать новые данные, пока выполняется скрипт. Старые данные будут становиться доступны в отчетах и графиках по мере выполнения скрипта. Скрипт может выполняться продолжительное время. Скрипт может быть остановлен и перезапущен позже без потери данных.https://docs.mitigator.ru/collector/v26.08/maintenance/update/2510/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2510/В Collector v25.10 прекращена поддержка Docker Compose первой версии. Обновление Docker Compose Удалите Docker Compose v1. Установите Docker Compose из официального репозитория и сделайте файл исполняемым: curl -L "https://github.com/docker/compose/releases/download/v2.28.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose \ && chmod +x /usr/bin/docker-compose Убедитесь, что в выводе команды docker-compose version отображается Docker Compose второй версии. Убедитесь, что отсутствует строка version: "2.2" в docker-compose.override.yml и любых дополнительных YAML из переменной COMPOSE_FILE в .env. Использование VPN Проверьте корректность настройки VPN. В версии v25.10 предпринят ряд мер по усилению безопасности, в частности закрыт доступ к портам ClickHouse (9000) и GRPC API (8853). При необходимости открыть доступ, например для внешних интеграций, следует:https://docs.mitigator.ru/collector/v26.08/maintenance/update/2506/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2506/Процедура обновления на версию v25.06 требует дополнительных действий после стандартных шагов. Скачайте скрипт миграции: wget https://docs.mitigator.ru/collector/v26.08/maintenance/update/update2506-migrate.py -O /srv/collector/update2506-migrate.py Перейдите в директорию /srv/collector/: cd /srv/collector/ Выполните скрипт: python3 update2506-migrate.py Если ранее была применена операция по уменьшению объема хранимых данных, задайте параметры через аргументы скрипта: python3 update2506-migrate.py \ --zstd8-interval "1 MONTH" \ --zstd15-interval "6 MONTH" \ --delete-interval "1 YEAR" Информация Выполнение скриптом некоторых операций может занять продолжительное время. Во время выполнения скрипта Collector продолжает полноценно работать. Скрипт может быть остановлен и перезапущен позже.https://docs.mitigator.ru/collector/v26.08/maintenance/update/2502/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2502/Процедура обновления на версию v25.02 требует выполнения дополнительных шагов до и после обновления. Скачайте скрипт миграции: wget https://docs.mitigator.ru/collector/v26.08/maintenance/update/update2502-migrate.py -O /srv/collector/update2502-migrate.py Перейдите в директорию /srv/collector/: cd /srv/collector/ Выполните скрипт в режиме анализа: python3 update2502-migrate.py analyze Если в режиме анализа скрипт укажет на наличие неизвестных источников flow, на время обновления добавьте источники flow в интерфейсе MITIGATOR. Это действие позволит в полном объеме сохранить данные по flow. Повторно выполните скрипт в режиме анализа.https://docs.mitigator.ru/collector/v26.08/maintenance/update/2407/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2407/В связи с обновлением Docker в последних версиях операционных систем могут возникать проблемы с работой Docker Compose. Сollector, начиная с версии v24.07, поддерживает работу с Docker Compose первой и второй версий. Тем не менее, если вы запланировали обновление операционной системы, следует выполнить ряд действий, зависящих от используемого дистрибутива ОС и версии Docker. В противном случае нельзя гарантировать правильную работу команд, указанных на данном сайте. Процедура обновления Docker Compose Ubuntu 20.04+ или любой дистрибутив Linux с docker-ce Удалите Docker Compose v1. Обновите системные пакеты ОС. Установите Docker Compose из официального репозитория и сделайте файл исполняемым: curl -L "https://github.com/docker/compose/releases/download/v2.28.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose \ && chmod +x /usr/bin/docker-compose Убедитесь, что в выводе команды docker-compose version отображается Docker Compose второй версии. Debian или Ubuntu 18.04 При обновлении ОС никаких дополнительных действий выполнять не нужно. Сохранится Docker Compose первой версии.https://docs.mitigator.ru/collector/v26.08/maintenance/update/2404/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2404/Процедура обновления на версию v24.04 не отличается от стандартной, но требует выполнения дополнительных шагов. Также команду docker-compose down следует выполнить с ключом --remove-orphans из-за переименования контейнера. Внимание После обновления версии политика перезапуска контейнеров по умолчанию изменена на always. Подробнее: Политика перезапуска контейнеров Обновление ClickHouse Изменился способ хранения данных в базе. Требуется выполнить скрипт миграции для переноса ретроспективных данных.https://docs.mitigator.ru/collector/v26.08/maintenance/update/2311/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2311/Процедура обновления на версию v23.11 не отличается от стандартной, но требует выполнения дополнительных шагов. Обновление Graphana Изменился дашборд по умолчанию для Grafana. Для обновления дашборда требуется выполнить следующие шаги: Информация • Пользовательские дашборды будут удалены. Перейдите в директорию /srv/collector/: cd /srv/collector/ Останавите Collector: docker-compose down Удалите вольюм Grafana:https://docs.mitigator.ru/collector/v26.08/maintenance/update/2308/Mon, 01 Jan 0001 00:00:00 +0000https://docs.mitigator.ru/collector/v26.08/maintenance/update/2308/Процедура обновления на версию v23.08 не отличается от стандартной, но в версии v23.08 изменился способ хранения данных в базе. Поэтому, чтобы сохранить доступ к ретроспективным данным, требуется выполнить скрипт миграции, для чего: Скачайте скрипт. wget https://docs.mitigator.ru/collector/v26.08/maintenance/update2308-migrate.sh -O /srv/collector/update2308-migrate.sh Перейдите в директорию /srv/collector/: cd /srv/collector/ Запустите скрипт: ./update2308-migrate.sh Информация Выполнение скриптом некоторых операций может занять продолжительное время.