Perform an immediate shutdown if the postmaster.pid file is removed.
authorTom Lane
Tue, 6 Oct 2015 21:15:27 +0000 (17:15 -0400)
committerTom Lane
Tue, 6 Oct 2015 21:15:27 +0000 (17:15 -0400)
The postmaster now checks every minute or so (worst case, at most two
minutes) that postmaster.pid is still there and still contains its own PID.
If not, it performs an immediate shutdown, as though it had received
SIGQUIT.

The original goal behind this change was to ensure that failed buildfarm
runs would get fully cleaned up, even if the test scripts had left a
postmaster running, which is not an infrequent occurrence.  When the
buildfarm script removes a test postmaster's $PGDATA directory, its next
check on postmaster.pid will fail and cause it to exit.  Previously, manual
intervention was often needed to get rid of such orphaned postmasters,
since they'd block new test postmasters from obtaining the expected socket
address.

However, by checking postmaster.pid and not something else, we can provide
additional robustness: manual removal of postmaster.pid is a frequent DBA
mistake, and now we can at least limit the damage that will ensue if a new
postmaster is started while the old one is still alive.

Back-patch to all supported branches, since we won't get the desired
improvement in buildfarm reliability otherwise.

src/backend/postmaster/postmaster.c
src/backend/utils/init/miscinit.c
src/include/miscadmin.h

index f0bba9e104a6ea5cd12139a0cbd72c42754872d9..c48ec8d52d6de4fd0581cbf8dd559eb504b4dc7f 100644 (file)
@@ -1609,9 +1609,10 @@ ServerLoop(void)
    fd_set      readmask;
    int         nSockets;
    time_t      now,
+               last_lockfile_recheck_time,
                last_touch_time;
 
-   last_touch_time = time(NULL);
+   last_lockfile_recheck_time = last_touch_time = time(NULL);
 
    nSockets = initMasks(&readmask);
 
@@ -1761,27 +1762,56 @@ ServerLoop(void)
        if (StartWorkerNeeded || HaveCrashedWorker)
            maybe_start_bgworker();
 
+#ifdef HAVE_PTHREAD_IS_THREADED_NP
+
+       /*
+        * With assertions enabled, check regularly for appearance of
+        * additional threads.  All builds check at start and exit.
+        */
+       Assert(pthread_is_threaded_np() == 0);
+#endif
+
+       /*
+        * Lastly, check to see if it's time to do some things that we don't
+        * want to do every single time through the loop, because they're a
+        * bit expensive.  Note that there's up to a minute of slop in when
+        * these tasks will be performed, since DetermineSleepTime() will let
+        * us sleep at most that long.
+        */
+       now = time(NULL);
+
+       /*
+        * Once a minute, verify that postmaster.pid hasn't been removed or
+        * overwritten.  If it has, we force a shutdown.  This avoids having
+        * postmasters and child processes hanging around after their database
+        * is gone, and maybe causing problems if a new database cluster is
+        * created in the same place.  It also provides some protection
+        * against a DBA foolishly removing postmaster.pid and manually
+        * starting a new postmaster.  Data corruption is likely to ensue from
+        * that anyway, but we can minimize the damage by aborting ASAP.
+        */
+       if (now - last_lockfile_recheck_time >= 1 * SECS_PER_MINUTE)
+       {
+           if (!RecheckDataDirLockFile())
+           {
+               ereport(LOG,
+                       (errmsg("performing immediate shutdown because data directory lock file is invalid")));
+               kill(MyProcPid, SIGQUIT);
+           }
+           last_lockfile_recheck_time = now;
+       }
+
        /*
         * Touch Unix socket and lock files every 58 minutes, to ensure that
         * they are not removed by overzealous /tmp-cleaning tasks.  We assume
         * no one runs cleaners with cutoff times of less than an hour ...
         */
-       now = time(NULL);
        if (now - last_touch_time >= 58 * SECS_PER_MINUTE)
        {
            TouchSocketFiles();
            TouchSocketLockFiles();
            last_touch_time = now;
        }
-
-#ifdef HAVE_PTHREAD_IS_THREADED_NP
-
-       /*
-        * With assertions enabled, check regularly for appearance of
-        * additional threads.  All builds check at start and exit.
-        */
-       Assert(pthread_is_threaded_np() == 0);
-#endif
    }
 }
 
index ca725072bdc17d72e228172bb7e172ed439ec848..e21207c87dbf4ae733ffa4063873389c7552ccf0 100644 (file)
@@ -1151,6 +1151,76 @@ AddToDataDirLockFile(int target_line, const char *str)
 }
 
 
+/*
+ * Recheck that the data directory lock file still exists with expected
+ * content.  Return TRUE if the lock file appears OK, FALSE if it isn't.
+ *
+ * We call this periodically in the postmaster.  The idea is that if the
+ * lock file has been removed or replaced by another postmaster, we should
+ * do a panic database shutdown.  Therefore, we should return TRUE if there
+ * is any doubt: we do not want to cause a panic shutdown unnecessarily.
+ * Transient failures like EINTR or ENFILE should not cause us to fail.
+ * (If there really is something wrong, we'll detect it on a future recheck.)
+ */
+bool
+RecheckDataDirLockFile(void)
+{
+   int         fd;
+   int         len;
+   long        file_pid;
+   char        buffer[BLCKSZ];
+
+   fd = open(DIRECTORY_LOCK_FILE, O_RDWR | PG_BINARY, 0);
+   if (fd < 0)
+   {
+       /*
+        * There are many foreseeable false-positive error conditions.  For
+        * safety, fail only on enumerated clearly-something-is-wrong
+        * conditions.
+        */
+       switch (errno)
+       {
+           case ENOENT:
+           case ENOTDIR:
+               /* disaster */
+               ereport(LOG,
+                       (errcode_for_file_access(),
+                        errmsg("could not open file \"%s\": %m",
+                               DIRECTORY_LOCK_FILE)));
+               return false;
+           default:
+               /* non-fatal, at least for now */
+               ereport(LOG,
+                       (errcode_for_file_access(),
+                 errmsg("could not open file \"%s\": %m; continuing anyway",
+                        DIRECTORY_LOCK_FILE)));
+               return true;
+       }
+   }
+   len = read(fd, buffer, sizeof(buffer) - 1);
+   if (len < 0)
+   {
+       ereport(LOG,
+               (errcode_for_file_access(),
+                errmsg("could not read from file \"%s\": %m",
+                       DIRECTORY_LOCK_FILE)));
+       close(fd);
+       return true;            /* treat read failure as nonfatal */
+   }
+   buffer[len] = '\0';
+   close(fd);
+   file_pid = atol(buffer);
+   if (file_pid == getpid())
+       return true;            /* all is well */
+
+   /* Trouble: someone's overwritten the lock file */
+   ereport(LOG,
+           (errmsg("lock file \"%s\" contains wrong PID: %ld instead of %ld",
+                   DIRECTORY_LOCK_FILE, file_pid, (long) getpid())));
+   return false;
+}
+
+
 /*-------------------------------------------------------------------------
  *             Version checking support
  *-------------------------------------------------------------------------
index 036d004cd6ca1573db679f657cbafb2cdd6e4aff..f88a49183b311c4cbc41ef4cf5aafe73f0491e38 100644 (file)
@@ -449,6 +449,7 @@ extern void CreateSocketLockFile(const char *socketfile, bool amPostmaster,
                     const char *socketDir);
 extern void TouchSocketLockFiles(void);
 extern void AddToDataDirLockFile(int target_line, const char *str);
+extern bool RecheckDataDirLockFile(void);
 extern void ValidatePgVersion(const char *path);
 extern void process_shared_preload_libraries(void);
 extern void process_local_preload_libraries(void);