Collector Update Procedure

Warning
  1. Don’t skip major versions during an update.
  2. Perform updates only from the latest minor version of the major version being updated.
  3. Updates between minor versions within the same major version can skip intermediate versions.

Failure to comply with these requirements may result in Collector malfunction.

Example:
If the current version of Colleсtor is v23.12.2, and you need to update to version v24.07.x, then the update path should be as follows:

v23.12.2 → v23.12.8 → v24.04.2 → v24.07.x.

Please refer to the version list when planning your update.

Info

• Special instructions for updating to v24.07.
• Special instructions for updating to v24.04.
• Special instructions for updating to v23.11.
• Special instructions for updating to v23.08.

  1. Make sure clock synchronization is configured via the same NTP server as for MITIGATOR.

  2. Create a backup of Collector settings and flows.

  3. Add a line with the version to .env file. For example:

    VERSION=v23.03.1

  4. Download the latest compose file:

    wget https://docs.mitigator.ru/collector/v24.10/dist/docker-compose.yml -O docker-compose.yml

    Make sure that the target major version number is indicated in the address bar.

  5. Log in to the image repository with your credentials:

    docker login docker.mitigator.ru

  6. Download the images:

    docker-compose pull

  7. Restart Collector:

    docker-compose down && docker-compose up -d

GeoIP database update

Collector uses GeoLite2 databases in CSV format. Place the Country and ASN database files in /srv/collector/geolite2 directory.

Process the files with the command:

find geolite2 -name '*.csv' -exec sed -e "s|,\('[^,]\+\)|,\"\1\"|g" -i {} \;

GeoIP databases will be updated within a few minutes.