<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Collector Update Procedure :: MITIGATOR Collector</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/</link><description>Warning Don’t skip major versions during an update. Perform updates only from the latest minor version of the major version being updated. 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:</description><generator>Hugo</generator><language>en</language><atom:link href="https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/index.xml" rel="self" type="application/rss+xml"/><item><title>Update to v26.04</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2604/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2604/</guid><description>Update procedure to version v26.04 requires additional actions after the standard steps.
Download the script:
wget https://docs.mitigator.ru/collector/v26.08/maintenance/update/update2604-migrate.py -O /srv/collector/update2604-migrate.py Navigate to the /srv/collector/ directory:
cd /srv/collector/ Run the script:
python3 update2604-migrate.py If you previously applied data volume reduction operations, specify parameters via script arguments:
python3 update2604-migrate.py \ --zstd8-interval "1 MONTH" \ --zstd15-interval "6 MONTH" \ --delete-interval "1 YEAR" Info Collector can accept new flow data while the script is running. Historical data will appear in reports and charts as the script migrates the data. The script may take a long time to complete some operations. The script could be stopped and restarted later without data loss.</description></item><item><title>Update to v25.10</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2510/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2510/</guid><description>Collector v25.10 has dropped support for Docker Compose version 1.
Docker Compose Update Remove Docker Compose v1. Install Docker Compose from the official repository and make the binary executable: curl -L "https://github.com/docker/compose/releases/download/v2.28.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/bin/docker-compose \ &amp;&amp; chmod +x /usr/bin/docker-compose Make sure that the docker-compose version command output shows version 2. Make sure there is no version: "2.2" line in docker-compose.override.yml or any additional YAML from the COMPOSE_FILE variable in .env. VPN Usage Please check that your VPN settings are correct. In v25.10, security enhancements have been implemented, in particular, access to ClickHouse (9000) and GRPC API (8853) ports has been closed. If you need to open access, for example for external integrations, you must:</description></item><item><title>Update to v25.06</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2506/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2506/</guid><description>Update procedure to version v25.06 requires additional actions after the standard steps.
Download the script:
wget https://docs.mitigator.ru/collector/v26.08/maintenance/update/update2506-migrate.py -O /srv/collector/update2506-migrate.py Navigate to the /srv/collector/ directory:
cd /srv/collector/ Run the script:
python3 update2506-migrate.py If you previously applied data volume reduction operations, specify parameters via script arguments:
python3 update2506-migrate.py \ --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.</description></item><item><title>Update to v25.02</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2502/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2502/</guid><description>Update procedure to version v25.02 requires performing additional steps before and after the update.
Download the script:
wget https://docs.mitigator.ru/collector/v26.08/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.</description></item><item><title>Update to v24.07</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2407/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2407/</guid><description>Due to Docker updates in latest versions of operating systems, you may experience problems with Docker Compose. Collector, starting with v24.07, supports both Docker Compose versions v1 and v2. However, if you are planning to upgrade your operating system, there are some additional steps you should perform, depending on the OS distribution and version of Docker you are using. Otherwise, the correct operation of the commands specified on this site cannot be guaranteed.</description></item><item><title>Update to v24.04</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2404/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2404/</guid><description>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:</description></item><item><title>Update to v23.11</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2311/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2311/</guid><description>Update procedure for v23.11 version does not differ from the standard one. But it’s necessary to execute additional steps.
Graphana update The default Collector dashboard has been changed. Execute steps for update dashboard:
Info • User dashboards will be removed.
Go to /srv/collector/ directory:
cd /srv/collector/ Stop Collector:</description></item><item><title>Update to v23.08</title><link>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2308/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://docs.mitigator.ru/collector/v26.08/en/maintenance/update/2308/</guid><description>Update procedure for v23.08 version does not differ from the standard one, but the way data is stored in the database in version v23.08 has changed. To save the access to historical data, you need to run a migration script. To do that:
Download the script.
wget https://docs.mitigator.ru/collector/v26.08/maintenance/update2308-migrate.sh -O /srv/collector/update2308-migrate.sh Go to /srv/collector/ directory:
cd /srv/collector/ Run the script:
./update2308-migrate.sh Info The script may take a long time to complete some operations.</description></item></channel></rss>