Обновление :: BIFIT Mitigator

Обновление до v26.08

Mon, 01 Jan 0001 00:00:00 +0000

Обновление на версию v26.08 выполняется по стандартной процедуре, однако перед запуском MITIGATOR требуется выполнить дополнительные действия. Задайте в файле /srv/mitigator/.env значение для переменной MITIGATOR_MASTER_SECRET, содержащей мастер-секрет для шифрования чувствительных настроек. Значением может быть произвольная строка, одинаковая на всех экземплярах кластера. Рекомендуется сгенерировать её командой: openssl rand -hex 32 Информация Важно сохранять значение MITIGATOR_MASTER_SECRET при обновлении MITIGATOR или при восстановлении из резервной копии. В противном случае придется заново задавать чувствительные настройки, такие как параметры двухфакторной аутентификации (2FA).

Обновление до v26.04

Mon, 01 Jan 0001 00:00:00 +0000

Внимание В версии MITIGATOR v26.04 изменены настройки по умолчанию для сетевых интерфейсов. Для инсталляций с количеством сетевых портов больше четырех может потребоваться увеличить значение packet_mempool_size в data-plane.conf. Подробнее. Внимание Начиная с версии MITIGATOR v26.04 для работы TAP-интерфейса требуется версия ядра Linux не ниже 5.0. Если используете перенаправление трафика на TAP-интерфейс в операционной системе, перед обновлением MITIGATOR убедитесь, что в вашей ОС используется ядро нужной версии, иначе TAP-интерфейс работать не будет.

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

Mon, 01 Jan 0001 00:00:00 +0000

Обновление на версию v25.12 выполняется по стандартной процедуре, однако перед запуском MITIGATOR требуется выполнить дополнительные действия. Управление пропуском трафика при перегрузке теперь осуществляется только через Web-интерфейс, поэтому перед запуском MITIGATOR: Удалите параметр congestion_bypass из файла dataplane.conf, если он был задан. Файл может быть пустым, если ранее не менялись параметры dataplane. # Включение пропуска обработки трафика при перегрузке обработчика пакетов # (для `port_direct_mode: false`). congestion_bypass: false Если значение параметра было false — дополнительных действий не требуется. Если значение параметра было true — включите пропуск трафика при перегрузке при помощи флага «Пропускать трафик без обработки при перегрузке системы» на странице «Общие параметры» в настройках системы.

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

Mon, 01 Jan 0001 00:00:00 +0000

Внимание Перед тем, как приступить к инструкции ниже, нужно сделать резервную копию. Убедиться, что установлена 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:

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

Mon, 01 Jan 0001 00:00:00 +0000

Внимание Перед тем, как приступить к инструкции ниже, нужно сделать резервную копию. Подготовка к обновлению Убедиться, что установлена 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 до актуальной версии.

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

Mon, 01 Jan 0001 00:00:00 +0000

Процедура обновления на версию 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 Сообщения печатаются только в случае ошибок. В этом случае текст сообщения нужно сообщить разработчикам.

Обновление до v24.08

Mon, 01 Jan 0001 00:00:00 +0000

В связи с обновлением Docker в последних версиях операционных систем могут возникать проблемы с работой Docker Compose. MITIGATOR, начиная с версии v24.08, поддерживает работу с 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 первой версии.

Обновление до v23.12

Mon, 01 Jan 0001 00:00:00 +0000

Процедура обновления на версию v23.12 не отличается от стандартной, но команду docker-compose down следует выполнить с ключом --remove-orphans из-за переименования контейнера. Тем не менее, в версии v23.12 внесен ряд изменений, требующих выполнения дополнительных действий перед запуском MITIGATOR. К таким изменениям относятся: прекращение поддержки старого формата конфигурационного файла data-plane.conf, существовавшего до версии v20.08. Переименование файла data-plane.conf в dataplane.conf. Совместимость со старым названием сохранена, но рекомендуем обновить название файла. Переименование контейнера data-plane в dataplane. Внесение изменений в логику работы pgfailover. Перенос настроек VPN в файл базовой конфигурации docker-compose.yml. Поэтому, при обновлении убедитесь, что:

Обновление до v23.06

Mon, 01 Jan 0001 00:00:00 +0000

Процедура обновления на версию 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

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

Mon, 01 Jan 0001 00:00:00 +0000

Обновление Процедура обновления на версию 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/.

Обновление до v22.12

Mon, 01 Jan 0001 00:00:00 +0000

Перед обновлением MITIGATOR необходимо обновить Docker на всех экземплярах системы до актуальной версии (для docker-ce — 20.10.10+, для docker.io — 20.10.5+). Рекомендуется обновление из репозиториев программного обеспечения для вашей ОС. После чего выполняется стандартная процедура обновления.

Обновление до v22.08

Mon, 01 Jan 0001 00:00:00 +0000

Обновление до v22.06

Mon, 01 Jan 0001 00:00:00 +0000

Информация Перед обновлением настоятельно рекомендуется сделать резервную копию. Процедура обновления на версию 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.

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

Mon, 01 Jan 0001 00:00:00 +0000

Перед обновлением MITIGATOR до версии v22.02 следует: Настроить синхронизацию времени в операционной системе всех устройств кластера через один NTP-сервер; Сгенерировать новое значение TOKEN openssl rand -hex 20 и записать его в файл .env на всех экземплярах. После чего выполняется стандартная процедура обновления. После завершения процедуры обновления следует проверить настройки интеграции в сеть, если до обновления MITIGATOR работал в режиме L3-роутер On-a-stick. Обновление в рамках мажорной версии v22.02 В случае если производится обновление MITIGATOR в рамках мажорной версии v22.02, например с v22.02.1 на v22.02.4, перед обновлением необходимо вручную перенести настройки интеграции в сеть из карточки «Сетевой уровень» в каждую пару VLAN.

Обновление до v21.04

Mon, 01 Jan 0001 00:00:00 +0000

Необходимое вмешательство (инструкции ниже): Чтобы сохранить данные графиков из прошлых версий, нужно выполнить миграцию (даже если экземпляр один). Старые программы 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, нужно произвести их для новой версии.

Обновление до v20.12

Mon, 01 Jan 0001 00:00:00 +0000

С версии 20.12 MITIGATOR работает в режиме кластера. Пока используется единственный экземпляр, новые настройки не требуются. Чтобы сохранить данные графиков из прошлых версий, нужно выполнить миграцию (даже если экземпляр один). Обновление стенда Информация Перед обновлением настоятельно рекомендуется сделать резервную копию. Остановить MITIGATOR: docker-compose down Обновить docker-compose.yml в /srv/mitigator:

Обновление до v20.06

Mon, 01 Jan 0001 00:00:00 +0000

Старый сервис Graphite (включавший в себя go-carbon с хранилищем whisper, carbonapi, grafana) мигрирует в пять отдельных сервисов: ClickHouse (server), Graphite-ClickHouse, Carbon-ClickHouse, Carbonapi и Grafana. Преимущества Самое важное: существенно (примерно на порядок) снижается утилизация диска по объему записи/чтения, iops, файловым дескрипторам, занимаемому объему; Возможность оптимизации инсталляций методом использования имеющихся сервисов для нескольких инсталляций. Инструкция по обновлению Для обновления рекомендуется выбрать окно минимальной активности: обновление выполняется с рестартом сервисов. Также, на миграцию данных нужно некоторое время (около 10 минут).