From 6e8d6aac66d02a103863be41c0f33b430bf00d71 Mon Sep 17 00:00:00 2001
From: k <30611210+countvonzero@users.noreply.github.com>
Date: Wed, 27 Sep 2023 14:09:02 +0000
Subject: [PATCH] add more info on state reduction to changelog (#5082)

---
 CHANGELOG.md | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index acf05a5ea5..8fa7544711 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -6,6 +6,16 @@ See [RELEASE](./RELEASE.md) for workflow instructions.
 
 ### Upgrade information
 
+This upgrade is incompatible with versions older than v1.1.6.
+
+At the start of the upgrade, mesh data will be pruned and compacted/vacuumed. Pruning takes longer for
+nodes that joined the network earlier. For 1-week-old nodes, it takes ~20 minutes. for 3-week-old
+nodes it takes ~40 minutes. The vacuum operation takes ~5 minutes and requires extra disk space
+to complete successfully. If the size of state.sql is 25 GiB at the beginning of upgrade, the WAL file
+(state.sql-wal) will grow to 25 GiB and then drop to 0 when the vacuum is complete. The node will resume
+its normal startup routine after the pruning and vacuum is complete. The final size of state.sql is
+expected to be ~1.5 GiB.
+
 A new config `poet-request-timeout` has been added, that defines the timeout for requesting PoET proofs.
 It defaults to 9 minutes so there is enough time to retry if the request fails.