Change XID and mxact limits to warn at 40M and stop at 3M.
authorNoah Misch
Sat, 1 Aug 2020 22:31:01 +0000 (15:31 -0700)
committerNoah Misch
Sat, 1 Aug 2020 22:31:01 +0000 (15:31 -0700)
We have edge-case bugs when assigning values in the last few dozen pages
before the wrap limit.  We may introduce similar bugs in the future.  At
default BLCKSZ, this makes such bugs unreachable outside of single-user
mode.  Also, when VACUUM began to consume mxacts, multiStopLimit did not
change to compensate.

pg_upgrade may fail on a cluster that was already printing "must be
vacuumed" warnings.  Follow the warning's instructions to clear the
warning, then run pg_upgrade again.  One can still, peacefully consume
98% of XIDs or mxacts, so DBAs need not change routine VACUUM settings.

Discussion: https://postgr.es/m/20200621083513[email protected]

doc/src/sgml/maintenance.sgml
src/backend/access/transam/multixact.c
src/backend/access/transam/varsup.c

index 4acdd15d4b379ee4efa513b3eb067d466c594100..de0794adeb90bf6842375421c646279508334eef 100644 (file)
@@ -608,10 +608,10 @@ SELECT datname, age(datfrozenxid) FROM pg_database;
    
     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:
+    oldest XIDs reach forty million transactions from the wraparound point:
 
 
-WARNING:  database "mydb" must be vacuumed within 10985967 transactions
+WARNING:  database "mydb" must be vacuumed within 39985967 transactions
 HINT:  To avoid a database shutdown, execute a database-wide VACUUM in that database.
 
 
@@ -621,7 +621,7 @@ HINT:  To avoid a database shutdown, execute a database-wide VACUUM in that data
     be able to advance the database's datfrozenxid.)
     If these warnings are
     ignored, the system will shut down and refuse to start any new
-    transactions once there are fewer than 1 million transactions left
+    transactions once there are fewer than three million transactions left
     until wraparound:
 
 
@@ -629,7 +629,7 @@ ERROR:  database is not accepting commands to avoid wraparound data loss in data
 HINT:  Stop the postmaster and vacuum that database in single-user mode.
 
 
-    The 1-million-transaction safety margin exists to let the
+    The three-million-transaction safety margin exists to let the
     administrator recover without data loss, by manually executing the
     required VACUUM commands.  However, since the system will not
     execute commands once it has gone into the safety shutdown mode,
index ce84dac0c400c38b61ccd67e8bbb9ffec5f52a38..475f5ed86110a76ce2af299ac4e1e2e96e73ca1f 100644 (file)
@@ -2217,28 +2217,24 @@ SetMultiXactIdLimit(MultiXactId oldest_datminmxid, Oid oldest_datoid,
        multiWrapLimit += FirstMultiXactId;
 
    /*
-    * We'll refuse to continue assigning MultiXactIds once we get within 100
-    * multi of data loss.
-    *
-    * Note: This differs from the magic number used in
-    * SetTransactionIdLimit() since vacuum itself will never generate new
-    * multis.  XXX actually it does, if it needs to freeze old multis.
+    * We'll refuse to continue assigning MultiXactIds once we get within 3M
+    * multi of data loss.  See SetTransactionIdLimit.
     */
-   multiStopLimit = multiWrapLimit - 100;
+   multiStopLimit = multiWrapLimit - 3000000;
    if (multiStopLimit < FirstMultiXactId)
        multiStopLimit -= FirstMultiXactId;
 
    /*
-    * We'll start complaining loudly when we get within 10M multis of the
-    * stop point.   This is kind of arbitrary, but if you let your gas gauge
-    * get down to 1% of full, would you be looking for the next gas station?
-    * We need to be fairly liberal about this number because there are lots
-    * of scenarios where most transactions are done by automatic clients that
-    * won't pay attention to warnings. (No, we're not gonna make this
+    * We'll start complaining loudly when we get within 40M multis of data
+    * loss.  This is kind of arbitrary, but if you let your gas gauge get
+    * down to 2% of full, would you be looking for the next gas station?  We
+    * need to be fairly liberal about this number because there are lots of
+    * scenarios where most transactions are done by automatic clients that
+    * won't pay attention to warnings.  (No, we're not gonna make this
     * configurable.  If you know enough to configure it, you know enough to
     * not get in this kind of trouble in the first place.)
     */
-   multiWarnLimit = multiStopLimit - 10000000;
+   multiWarnLimit = multiWrapLimit - 40000000;
    if (multiWarnLimit < FirstMultiXactId)
        multiWarnLimit -= FirstMultiXactId;
 
index e14b53bf9e3524bc2a3d4e02563d7dd1888d67ba..0142bc70f6a63e535138b60c869a1abc415e0897 100644 (file)
@@ -350,27 +350,30 @@ SetTransactionIdLimit(TransactionId oldest_datfrozenxid, Oid oldest_datoid)
 
    /*
     * We'll refuse to continue assigning XIDs in interactive mode once we get
-    * within 1M transactions of data loss.  This leaves lots of room for the
+    * within 3M transactions of data loss.  This leaves lots of room for the
     * DBA to fool around fixing things in a standalone backend, while not
     * being significant compared to total XID space. (Note that since
     * vacuuming requires one transaction per table cleaned, we had better be
-    * sure there's lots of XIDs left...)
+    * sure there's lots of XIDs left...)  Also, at default BLCKSZ, this
+    * leaves two completely-idle segments.  In the event of edge-case bugs
+    * involving page or segment arithmetic, idle segments render the bugs
+    * unreachable outside of single-user mode.
     */
-   xidStopLimit = xidWrapLimit - 1000000;
+   xidStopLimit = xidWrapLimit - 3000000;
    if (xidStopLimit < FirstNormalTransactionId)
        xidStopLimit -= FirstNormalTransactionId;
 
    /*
-    * We'll start complaining loudly when we get within 10M transactions of
-    * the stop point.  This is kind of arbitrary, but if you let your gas
-    * gauge get down to 1% of full, would you be looking for the next gas
-    * station?  We need to be fairly liberal about this number because there
-    * are lots of scenarios where most transactions are done by automatic
-    * clients that won't pay attention to warnings. (No, we're not gonna make
-    * this configurable.  If you know enough to configure it, you know enough
-    * to not get in this kind of trouble in the first place.)
+    * We'll start complaining loudly when we get within 40M transactions of
+    * data loss.  This is kind of arbitrary, but if you let your gas gauge
+    * get down to 2% of full, would you be looking for the next gas station?
+    * We need to be fairly liberal about this number because there are lots
+    * of scenarios where most transactions are done by automatic clients that
+    * won't pay attention to warnings.  (No, we're not gonna make this
+    * configurable.  If you know enough to configure it, you know enough to
+    * not get in this kind of trouble in the first place.)
     */
-   xidWarnLimit = xidStopLimit - 10000000;
+   xidWarnLimit = xidWrapLimit - 40000000;
    if (xidWarnLimit < FirstNormalTransactionId)
        xidWarnLimit -= FirstNormalTransactionId;