Update to v24.04

Update procedure for v24.04 version does not differ from the standard one. But it’s necessary to execute additional steps. Also docker-compose down command should be executed with --remove-orphans key due to container renaming.

Warning

Default container restart policy has been changed to always.
Details: Container restart policy

ClickHouse update

The way data is stored in the database has changed. You have to run a migration script converting the historical data. To do that:

  1. Download the script.

    wget https://docs.mitigator.ru/collector/v24.10/maintenance/update2404-migrate.sh -O /srv/collector/update2404-migrate.sh

  2. Go to /srv/collector/ directory:

    cd /srv/collector/

  3. Set up the next values in the script in case of the data volume reduction procedure has been applied before:

    ttl_recompress_zstd8_interval="1 MONTH"
ttl_recompress_zstd15_interval="6 MONTH"
ttl_delete_interval="1 YEAR"
transfer_interval=$((365 * 24 * 60 * 60)) # 1 year in seconds

  4. Set up the next value in the script to change the size of migration chunk:

    chunk_interval=$((60 * 60)) # 1 hour in seconds

  5. Run the script:

    bash update2404-migrate.sh
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.