|
| 1 | +## [Omni 1.4.4](https://github.com/siderolabs/omni/releases/tag/v1.4.4) (2025-12-23) |
| 2 | + |
| 3 | +Welcome to the v1.4.4 release of Omni! |
| 4 | + |
| 5 | + |
| 6 | + |
| 7 | +Please try out the release binaries and report any issues at |
| 8 | +https://github.com/siderolabs/omni/issues. |
| 9 | + |
| 10 | +### Urgent Upgrade Notes **(No, really, you MUST read this before you upgrade)** |
| 11 | + |
| 12 | +This release consolidates **Discovery service state**, **Audit logs**, **Machine logs**, and **Secondary resources** into a single SQLite storage backend. |
| 13 | + |
| 14 | +**1. New Required Flag** |
| 15 | +You **must** set the new `--sqlite-storage-path` (or `.storage.sqlite.path`) flag. There is no default value, and Omni will not start without it. |
| 16 | +It **must** be a path to the SQLite file (will be created by Omni), **not** a directory, e.g., `--sqlite-storage-path=/path/to/omni-sqlite.db`. |
| 17 | + |
| 18 | +**2. Audit Logging Changes** |
| 19 | +A new flag `--audit-log-enabled` (or `.logs.audit.enabled`) has been introduced to explicitly enable or disable audit logging. |
| 20 | +* **Default:** `true`. |
| 21 | +* **Change:** Previously, audit logging was implicitly enabled only when the path was set. Now, it is enabled by default. |
| 22 | + |
| 23 | +**3. Automatic Migration** |
| 24 | +Omni will automatically migrate your existing data (BoltDB, file-based logs) to the new SQLite database on the first startup. To ensure this happens correctly, simply add the new SQLite flag and **leave your existing storage flags in place** for the first run. |
| 25 | + |
| 26 | +Once the migration is complete, you are free to remove the deprecated flags listed below. If they remain, they will be ignored and eventually dropped in future versions. |
| 27 | + |
| 28 | +**4. Deprecated Flags (Kept for Migration)** |
| 29 | +The following flags (and config keys) are deprecated and kept solely to facilitate the automatic migration: |
| 30 | +* `--audit-log-dir` (`.logs.audit.path`) |
| 31 | +* `--secondary-storage-path` (`.storage.secondary.path`) |
| 32 | +* `--machine-log-storage-path` (`.logs.machine.storage.path`) |
| 33 | +* `--machine-log-storage-enabled` (`.logs.machine.storage.enabled`) |
| 34 | +* `--embedded-discovery-service-snapshot-path` (`.services.embeddedDiscoveryService.snapshotsPath`) |
| 35 | +* `--machine-log-buffer-capacity` (`.logs.machine.bufferInitialCapacity`) |
| 36 | +* `--machine-log-buffer-max-capacity` (`.logs.machine.bufferMaxCapacity`) |
| 37 | +* `--machine-log-buffer-safe-gap` (`.logs.machine.bufferSafetyGap`) |
| 38 | +* `--machine-log-num-compressed-chunks` (`.logs.machine.storage.numCompressedChunks`) |
| 39 | + |
| 40 | +**5. Removed Flags** |
| 41 | +The following flags have been removed and are no longer supported: |
| 42 | +* `--machine-log-storage-flush-period` (`.logs.machine.storage.flushPeriod`) |
| 43 | +* `--machine-log-storage-flush-jitter` (`.logs.machine.storage.flushJitter`) |
| 44 | + |
| 45 | + |
| 46 | +### Contributors |
| 47 | + |
| 48 | +* Andrey Smirnov |
| 49 | + |
| 50 | +### Changes |
| 51 | +<details><summary>1 commit</summary> |
| 52 | +<p> |
| 53 | + |
| 54 | +* [`2bbd9d79`](https://github.com/siderolabs/omni/commit/2bbd9d791fb4a2a6766ef2dc77e2916891723678) fix: run more aggressive compaction for sqlite/metrics |
| 55 | +</p> |
| 56 | +</details> |
| 57 | + |
| 58 | +### Dependency Changes |
| 59 | + |
| 60 | +This release has no dependency changes |
| 61 | + |
| 62 | +Previous release can be found at [v1.4.3](https://github.com/siderolabs/omni/releases/tag/v1.4.3) |
| 63 | + |
1 | 64 | ## [Omni 1.4.3](https://github.com/siderolabs/omni/releases/tag/v1.4.3) (2025-12-22) |
2 | 65 |
|
3 | 66 | Welcome to the v1.4.3 release of Omni! |
|
0 commit comments