Fix documentation of "must be vacuumed within" warning.
authorNoah Misch <[email protected]>
Sun, 28 Jun 2020 05:05:04 +0000 (22:05 -0700)
committerNoah Misch <[email protected]>
Sun, 28 Jun 2020 05:05:09 +0000 (22:05 -0700)
Warnings start 10M transactions before xidStopLimit, which is 11M
transactions before wraparound.  The sample WARNING output showed a
value greater than 11M, and its HINT message predated commit
25ec228ef760eb91c094cc3b6dea7257cc22ffb5.  Hence, the sample was
impossible.  Back-patch to 9.5 (all supported versions).

doc/src/sgml/maintenance.sgml

index 0c2d008b86cda2d9fd2f3f680ace38725de31b7d..6d698e1d89c4acb6ccef6d4c23f2433bb39b2d74 100644 (file)
@@ -591,14 +591,13 @@ SELECT datname, age(datfrozenxid) FROM pg_database;
    </para>
 
    <para>
-    If for some reason autovacuum fails to clear old XIDs from a table,
-    the system will begin to emit warning messages like this when the
-    database's oldest XIDs reach ten million transactions from the wraparound
-    point:
+    If for some reason autovacuum fails to clear old XIDs from a table, the
+    system will begin to emit warning messages like this when the database's
+    oldest XIDs reach eleven million transactions from the wraparound point:
 
 <programlisting>
-WARNING:  database "mydb" must be vacuumed within 177009986 transactions
-HINT:  To avoid a database shutdown, execute a database-wide VACUUM in "mydb".
+WARNING:  database "mydb" must be vacuumed within 10985967 transactions
+HINT:  To avoid a database shutdown, execute a database-wide VACUUM in that database.
 </programlisting>
 
     (A manual <command>VACUUM</> should fix the problem, as suggested by the