Update to v25.06

Update procedure for v25.06 does not differ from the standard one, but requires additional steps when starting the new version.

  1. Download metric migration script on all instances running ClickHouse:

    wget https://docs.mitigator.ru/master/kb/update2506/update2506.sql -O /srv/mitigator/update2506.sql
  2. Add MITIGATOR_PUBLIC_ADDRESS variable to .env file on all instances. To keep existing behavior, set it to the same value as MITIGATOR_HOST_ADDRESS.

    If MITIGATOR_HOST_ADDRESS is set to a domain name, replace it with IP address if possible, otherwise containers may lose connectivity in case of a DNS failure. MITIGATOR_PUBLIC_ADDRESS may be set to either a domain name or an IP address.

  3. Change instance data ownership on all instances:

    chown -R 65534:65534 /var/lib/docker/volumes/mitigator_own_id/_data
  4. Remove obsolete web UI files on all instances:

    docker volume rm mitigator_frontend
  5. Start MITIGATOR:

    docker-compose up -d
  6. Perform metric migration:

    docker-compose exec -T clickhouse clickhouse-client -mn < update2506.sql && \
    docker-compose restart carbon-clickhouse

    Migration may take a while. DDoS-protection functions of MITIGATOR are fully operational while migrating data. Some graphs may not render during migration.

    This command prints nothing if successful. Please report to the developers about any error printed.