Update to v25.02
Update procedure to version v25.02 requires performing additional steps before and after the update.
Download the script:
wget https://docs.mitigator.ru/collector/master/maintenance/update/update2502-migrate.py -O /srv/collector/update2502-migrate.py
Navigate to the
/srv/collector/
directory:cd /srv/collector/
Run the script in analysis mode:
python3 update2502-migrate.py analyze
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.
If you have changed
docker-compose.gobgp.yml
ordocker-compose.vpn.yml
, copy custom YAML elements intodocker-compose.override.yml
.If Collector requires custom
yml
-files, copy its content intodocker-compose.override.yml
.Remove
COMPOSE_FILE
line in.env
.If you previously had a
gobgp
container configured, migrate thegobgp
container configuration according to the instructions.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
Give required permissions to the Collector settings directory:
SETTINGS_PATH=$(docker volume inspect collector_db -f '{{.Mountpoint}}') && \ chown -R 65534:65534 ${SETTINGS_PATH}
Perform the update procedure.
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"
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.