diff --git a/CHANGELOG.md b/CHANGELOG.md index e96db578..5ba98587 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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 diff --git a/docs/RELEASE_NOTES_5.0.md b/docs/RELEASE_NOTES_5.0.md index b516b9f1..10b55959 100644 --- a/docs/RELEASE_NOTES_5.0.md +++ b/docs/RELEASE_NOTES_5.0.md @@ -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 @@ -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 diff --git a/manifest.json b/manifest.json index eed87895..552c1fde 100644 --- a/manifest.json +++ b/manifest.json @@ -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",