Update to v25.02

Update procedure to version v25.02 requires performing additional steps before and after the update.

  1. Download the script:

    wget https://docs.mitigator.ru/collector/master/maintenance/update/update2502-migrate.py -O /srv/collector/update2502-migrate.py
  2. Navigate to the /srv/collector/ directory:

    cd /srv/collector/
  3. Run the script in analysis mode:

    python3 update2502-migrate.py analyze
  4. If the analysis mode script reports unknown flow exporters, temporarily add the flow exporters via the MITIGATOR interface during the update. This action will ensure complete migration of flow data. Re-run the script in analysis mode afterward.

  5. If you have changed docker-compose.gobgp.yml or docker-compose.vpn.yml, copy custom YAML elements into docker-compose.override.yml.

  6. If Collector requires custom yml-files, copy its content into docker-compose.override.yml.

  7. Remove COMPOSE_FILE line in .env.

  8. If you previously had a gobgp container configured, migrate the gobgp container configuration according to the instructions.

  9. For a configured VPN create a config/vpn directory and move VPN keys:

    mkdir -p config/vpn
    mv vpn-public.conf config/vpn/vpn-public.conf && \
    mv vpn-private.conf config/vpn/vpn-private.conf
  10. Give required permissions to the Collector settings directory:

    SETTINGS_PATH=$(docker volume inspect collector_db -f '{{.Mountpoint}}') && \
    chown -R 65534:65534 ${SETTINGS_PATH}
  11. Perform the update procedure.

  12. Run the script in migration mode:

    python3 update2502-migrate.py migrate

    If you previously applied data volume reduction operations, specify parameters via script arguments:

    python3 update2502-migrate.py migrate \
        --zstd8-interval "1 MONTH" \
        --zstd15-interval "6 MONTH" \
        --delete-interval "1 YEAR"
Info

The script may take a long time to complete some operations.
While the script is running, the collector is fully operable.
The script could be stopped and restarted later.