https://docs.mitigator.ru/v26.04/maintenance/update/ Recent content in Обновление on BIFIT Mitigator Hugo -- gohugo.io ru https://docs.mitigator.ru/v26.04/maintenance/update/2604/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2604/ Внимание В версии MITIGATOR v26.04 изменены настройки по умолчанию для сетевых интерфейсов. Для инсталляций с количеством сетевых портов больше четырех может потребоваться увеличить значение packet_mempool_size в data-plane.conf. Подробнее. Внимание Начиная с версии MITIGATOR v26.04 для работы TAP-интерфейса требуется версия ядра Linux не ниже 5.0. Если используете перенаправление трафика на TAP-интерфейс в операционной системе, перед обновлением MITIGATOR убедитесь, что в вашей ОС используется ядро нужной версии, иначе TAP-интерфейс работать не будет. https://docs.mitigator.ru/v26.04/maintenance/update/2512/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2512/ Обновление на версию v25.12 выполняется по стандартной процедуре, однако перед запуском MITIGATOR требуется выполнить дополнительные действия. Управление пропуском трафика при перегрузке теперь осуществляется только через Web-интерфейс, поэтому перед запуском MITIGATOR: Удалите параметр congestion_bypass из файла dataplane.conf, если он был задан. Файл может быть пустым, если ранее не менялись параметры dataplane. # Включение пропуска обработки трафика при перегрузке обработчика пакетов # (для `port_direct_mode: false`). congestion_bypass: false Если значение параметра было false — дополнительных действий не требуется. https://docs.mitigator.ru/v26.04/maintenance/update/2510/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2510/ Внимание Перед тем, как приступить к инструкции ниже, нужно сделать резервную копию. Убедиться, что установлена Docker Compose версии 2: docker-compose version --short Обновить при необходимости. MITIGATOR более не поддерживает Docker Compose версии 1. Убрать из файла .env элементы, не поддерживаемые Docker Compose v2: sed -e 's/\b\(docker-compose.yml\):\1/\1/' -i .env Остановить MITIGATOR: docker-compose down Убрать элемент version: "2.2" из всех YAML, используемых Docker Compose: for file in $(sed -n 's/^COMPOSE_FILE=\(.*\)$/\1/p' .env | tr : ' '); do sed -i '/^version: "2. https://docs.mitigator.ru/v26.04/maintenance/update/2506/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2506/ Внимание Перед тем, как приступить к инструкции ниже, нужно сделать резервную копию. Подготовка к обновлению Убедиться, что установлена Docker Compose версии 2: docker-compose version --short Обновить при необходимости. MITIGATOR более не поддерживает Docker Compose версии 1. Убрать из файла .env элементы, не поддерживаемые Docker Compose v2: sed -e 's/\b\(docker-compose.yml\):\1/\1/' -i .env При использовании сетевых адаптеров NVIDIA (Mellanox) обновить OFED до актуальной версии. На всех экземплярах с ClickHouse скачать файл миграции метрик: https://docs.mitigator.ru/v26.04/maintenance/update/2502/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2502/ Процедура обновления на версию v25.02 не отличается от стандартной, но требует дополнительных действий: выполнения миграций метрик; (опционально) настройки распределения запросов на построение графиков; (опционально) задания порогов регистрации инцидентов. Процедура миграции метрик На всех экземплярах с ClickHouse скачать файл миграции. wget https://docs.mitigator.ru/master/kb/update2502/update2502.sql -O /srv/mitigator/update2502.sql Выполнить миграцию: docker-compose exec -T clickhouse clickhouse-client -mn < update2502.sql Сообщения печатаются только в случае ошибок. В этом случае текст сообщения нужно сообщить разработчикам. Перезапустите Carbon Clickhouse: https://docs.mitigator.ru/v26.04/maintenance/update/2408/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2408/ В связи с обновлением Docker в последних версиях операционных систем могут возникать проблемы с работой Docker Compose. MITIGATOR, начиная с версии v24.08, поддерживает работу с Docker Compose первой и второй версий. Тем не менее, если вы запланировали обновление операционной системы, следует выполнить ряд действий, зависящих от используемого дистрибутива ОС и версии Docker. В противном случае нельзя гарантировать правильную работу команд, указанных на данном сайте. Процедура обновления Docker Compose Ubuntu 20.04+ или любой дистрибутив Linux с docker-ce Удалите Docker Compose v1. https://docs.mitigator.ru/v26.04/maintenance/update/2312/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2312/ Процедура обновления на версию v23.12 не отличается от стандартной, но команду docker-compose down следует выполнить с ключом --remove-orphans из-за переименования контейнера. Тем не менее, в версии v23.12 внесен ряд изменений, требующих выполнения дополнительных действий перед запуском MITIGATOR. К таким изменениям относятся: прекращение поддержки старого формата конфигурационного файла data-plane.conf, существовавшего до версии v20.08. Переименование файла data-plane.conf в dataplane.conf. Совместимость со старым названием сохранена, но рекомендуем обновить название файла. Переименование контейнера data-plane в dataplane. https://docs.mitigator.ru/v26.04/maintenance/update/2306/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2306/ Процедура обновления на версию v23.06 не отличается от стандартной, но требует выполнения миграций, для чего после обновления следует: На всех экземплярах с ClickHouse скачать файл миграции. wget https://docs.mitigator.ru/kb/update2306/update2306.sql -O /srv/mitigator/update2306.sql Выполнить миграцию: docker-compose exec -T clickhouse clickhouse-client -mn < update2306.sql Сообщения печатаются только в случае ошибок. В этом случае текст сообщения нужно сообщить разработчикам. Перезапустите Carbon Clickhouse: docker-compose restart carbon-clickhouse https://docs.mitigator.ru/v26.04/maintenance/update/2302/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2302/ Обновление Процедура обновления на версию v23.02 требует обязательной замены всех скаченных ранее с сайта *.yml файлов: docker.compose.yml, docker-compose.failover.yml и т.д. Если при попытке скачать новые образы получаете ошибку следующего вида: ERROR: for accesslog unknown: artifact product/accesslog:v23.02 not found ERROR: unknown: artifact product/accesslog:v23.02 not found следует проверить что во всех файлах *.yml вместо docker.mitigator.ru/product/ и docker.mitigator.ru/vendor/ записано docker.mitigator.ru/mitigator/. Миграция После обновления и запуска MITIGATOR следует выполнить миграцию для оптимизации работы с журналом событий, для чего на лидере: https://docs.mitigator.ru/v26.04/maintenance/update/2212/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2212/ Перед обновлением MITIGATOR необходимо обновить Docker на всех экземплярах системы до актуальной версии (для docker-ce — 20.10.10+, для docker.io — 20.10.5+). Рекомендуется обновление из репозиториев программного обеспечения для вашей ОС. После чего выполняется стандартная процедура обновления. https://docs.mitigator.ru/v26.04/maintenance/update/2208/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2208/ Перед обновлением MITIGATOR необходимо обновить Docker на всех экземплярах системы до актуальной версии (для docker-ce — 20.10.10+, для docker.io — 20.10.5+). Рекомендуется обновление из репозиториев программного обеспечения для вашей ОС. После чего выполняется стандартная процедура обновления. https://docs.mitigator.ru/v26.04/maintenance/update/2206/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2206/ Информация Перед обновлением настоятельно рекомендуется сделать резервную копию. Процедура обновления на версию v22.06 не отличается от стандартной, но требует выполнения миграций, для чего после обновления следует: Скачать файл миграции на лидере metric_restore.sql в /srv/mitigator. Поместить скрипт в контейнер Postgres: docker cp metric_restore.sql mitigator_postgres_1:/tmp/ Запустить выполнение скрипта миграции: docker-compose exec postgres psql mitigator -f /tmp/metric_restore.sql Перезапустить Watchhog: docker-compose restart watchhog Скачать файл миграции на всех экземплярах с ClickHouse update2206.sql в /srv/mitigator. https://docs.mitigator.ru/v26.04/maintenance/update/2202/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2202/ Перед обновлением MITIGATOR до версии v22.02 следует: Настроить синхронизацию времени в операционной системе всех устройств кластера через один NTP-сервер; Сгенерировать новое значение TOKEN openssl rand -hex 20 и записать его в файл .env на всех экземплярах. После чего выполняется стандартная процедура обновления. После завершения процедуры обновления следует проверить настройки интеграции в сеть, если до обновления MITIGATOR работал в режиме L3-роутер On-a-stick. Обновление в рамках мажорной версии v22.02 В случае если производится обновление MITIGATOR с рамках мажорной версии v22. https://docs.mitigator.ru/v26.04/maintenance/update/2104/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2104/ Необходимое вмешательство (инструкции ниже): Чтобы сохранить данные графиков из прошлых версий, нужно выполнить миграцию (даже если экземпляр один). Старые программы BPF нужно заново собрать под новую версию. Обновление стенда Информация Перед обновлением настоятельно рекомендуется сделать резервную копию. Остановить MITIGATOR: docker-compose down Обновить docker-compose.yml в /srv/mitigator: wget https://docs.mitigator.ru/v21.04/dist/docker-compose.yml -O /srv/mitigator/docker-compose.yml Информация Правки для адаптеров Mellanox, изменились в v21.04, нужно произвести их для новой версии. Скачать базовый файл переменных и сохранить его под именем . https://docs.mitigator.ru/v26.04/maintenance/update/2012/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2012/ С версии 20.12 MITIGATOR работает в режиме кластера. Пока используется единственный экземпляр, новые настройки не требуются. Чтобы сохранить данные графиков из прошлых версий, нужно выполнить миграцию (даже если экземпляр один). Обновление стенда Информация Перед обновлением настоятельно рекомендуется сделать резервную копию. Остановить MITIGATOR: docker-compose down Обновить docker-compose.yml в /srv/mitigator: wget https://docs.mitigator.ru/v20.12/dist/docker-compose.yml -O /srv/mitigator/docker-compose.yml Если в нем были сделаны правки для адаптеров Mellanox, воспроизвести их в новой версии файла. Обновить .env: Выставить VERSION=v20. https://docs.mitigator.ru/v26.04/maintenance/update/2006/ Mon, 01 Jan 0001 00:00:00 +0000 https://docs.mitigator.ru/v26.04/maintenance/update/2006/ Старый сервис Graphite (включавший в себя go-carbon с хранилищем whisper, carbonapi, grafana) мигрирует в пять отдельных сервисов: ClickHouse (server), Graphite-ClickHouse, Carbon-ClickHouse, Carbonapi и Grafana. Преимущества Самое важное: существенно (примерно на порядок) снижается утилизация диска по объему записи/чтения, iops, файловым дискрипторам, занимаемому объему; Возможность оптимизации инсталяций методом использования имеющихся сервисов для нескольких инсталяций. Инструкция по обновлению Для обновления рекомендуется выбрать окно минимальной активности: обновление выполняется с рестартом сервисов. Также, на миграцию данных нужно некоторое время (около 10 минут).