icingadb/doc
Alvar Penning f49fac0798
CheckSchema: Verify intermediate schema upgrades
When skipping a version for an Icinga DB upgrade, all intermediate
upgrade steps must be taken. While this is already stated in the
documentation, it might be overlooked.

This happened for one community user, upgrading from v1.1.0 to v1.2.0,
skipping the intermediate schema upgrade for v1.1.1.

> https://community.icinga.com/t/icingadb-failing-exactly-5-minutes-after-start/13955

First, the necessity for all upgrades in their release order was made
more prominent in the documentation, hoping that less users would ignore
this when skimming the upgrade docs.

However, the real change here is adding another check to the CheckSchema
function, verifying that all schema upgrades between the lowest known
version and the highest known version in the icingadb_schema table
exists. If an intermediate schema upgrade was skipped, as in the thread
above, this raises a descriptive error.
2026-01-14 09:55:56 +01:00
..
02-Installation.md.d GHA/docs: Containerized Setup 2025-05-27 11:25:21 +02:00
images Docs: Account Redis' trademark policy 2024-04-11 10:07:51 +02:00
01-About.md doc: Update for Notifications 2025-11-17 09:20:07 +01:00
02-Installation.md Release Icinga DB Version 1.4.0 2025-06-17 12:57:56 +02:00
03-Configuration.md Release Icinga DB Version 1.5.0 2025-11-18 09:22:52 +01:00
04-Upgrading.md CheckSchema: Verify intermediate schema upgrades 2026-01-14 09:55:56 +01:00
05-Distributed-Setups.md Fix broken link 2025-01-08 12:58:05 +01:00
06-Migration.md doc/06-Migration.md: ido and icingadb config sections 2025-04-25 16:36:07 +02:00
07-Operations.md docs: Redis tuning notes for huge setups 2025-06-16 16:59:33 +02:00
icingadb-migration.example.yml icingadb-migrate: document TLS support 2023-06-21 16:53:29 +02:00
TRADEMARKS.md Docs: Account Redis' trademark policy 2024-04-11 10:07:51 +02:00