Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@
* issue#473: Syslog Status: choosing a card in Add card now appends it (Cacti's select2 dropdowns report changes through jQuery, which the card controller's native listener missed), and the Refresh interval is saved per user through a callback and refreshes the cards in place instead of reloading the page
* issue#473: Bound every log query at the current time so empty future partitions are always pruned, whatever the filter's own date range
* issue#473: The partition rebuild CLI now refuses to start while Syslog processing is enabled and holds a database lock that syslog_process.php also takes (on a connection of its own, so nested locks cannot release it); copies stored and removed messages without seq into a replacement whose AUTO_INCREMENT starts above the original high-water mark; verifies each 50,000-row batch by checksum and checkpoints it for resumable retries; widens the incoming queue in place to keep its sequence identities; and refuses legacy DATETIME history before changing anything
* issue: Tombstone the replaced cli/updatedb_convert_ms.php so upgrades remove it; it truncated the message tables and failed on legacy TO_DAYS partitioned tables. Use cli/upgrade_partitioning.php --convert-ms instead
* issue: Keep log column resizing within the results area on both log tabs, preserve message ellipsis, and use an accessible Font Awesome export button
* issue: Load grouped message details only on expansion, 50 at a time, preserving the displayed query's date range and filters instead of rendering every occurrence into hidden rows
* issue: Place Cancel before an active submit-type Save button in Save Search As, support Enter through a separate dialog form and the existing callback, and show a Font Awesome refresh glyph that spins only while results callbacks are running
Expand Down
18 changes: 13 additions & 5 deletions docs/RELEASE_NOTES_5.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ An empty queue preview does not search previously archived history.
| Storage | InnoDB, or Aria on MariaDB; Remote Data Collector options require InnoDB. Existing traditional tables remain usable with a migration notice. |
| Ordinary upgrade | Preserve the database and local config. Existing timestamp precision stays unchanged. |
| Legacy table conversion | Review the Upgrade Advisor mode. For a legacy non-partitioned table, **Truncate Syslog Table** discards messages; existing partitioned installs retain their data with each advisor choice. |
| Optional timestamp conversion | MariaDB only. The CLI millisecond conversion deletes stored messages from three log tables; it is not needed for the new interface features. |
| Optional timestamp conversion | MariaDB only. `cli/upgrade_partitioning.php --convert-ms` preserves stored messages by default; it is not needed for the new interface features. |

### Upgrade and verify before deployment

Expand All @@ -80,14 +80,22 @@ Also review [storage support](../README.md#table-architecture-and-storage-engine
templates now need absolute executable paths; the `/bin/sh` fallback is removed.
The Statistics tab and its collection are deprecated.

### Optional millisecond conversion: stored messages are deleted
### Optional millisecond conversion

`cli/updatedb_convert_ms.php` is MariaDB-only and truncates `syslog`,
`syslog_incoming` and `syslog_removed`. Rules and settings are preserved and the
remote-delivery outbox is widened in place. Back up first and read the
`cli/upgrade_partitioning.php --convert-ms` is MariaDB-only. It rebuilds
`syslog` and `syslog_removed` into replacement tables, copying stored messages
in verified batches, and widens `syslog_incoming` and the remote-delivery outbox
in place. Data is preserved by default; `--discard-data` deletes stored messages
instead. Legacy `DATETIME` `logtime` tables cannot be preserved automatically.
Rules and settings are preserved. Back up first and read the
[conversion instructions](../README.md#converting-an-existing-mariadb-install).
Normal upgrades never run this conversion automatically.

The earlier `cli/updatedb_convert_ms.php` utility has been replaced and is
removed on upgrade. It truncated the message tables and could fail on legacy
`TO_DAYS` partitioned tables with "Constant, random or timezone-dependent
expressions in (sub)partitioning function are not allowed".

If rollback is needed, restore plugin files and the database from the same
pre-upgrade backup; do not assume a binary-only downgrade reverses migrations.
Rehearse the checklist against a copy of your production configuration before
Expand Down
1 change: 1 addition & 0 deletions manifest.json
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
".travis.yml",
"class.phpmailer.php",
"class.smtp.php",
"cli/updatedb_convert_ms.php",
"compatibility.php",
"database.php",
"docs/recommendations.sql.gz",
Expand Down
Loading