Put the disk information all in one chapter.

petere · petere · commit 841e4b208956 · 2002-10-16T22:06:33.000Z
diff --git a/doc/src/sgml/admin.sgml b/doc/src/sgml/admin.sgml
@@ -1,5 +1,5 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.38 2002/09/25 21:16:10 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.39 2002/10/16 22:06:33 petere Exp $
 -->
 
 <book id="admin">
@@ -34,7 +34,6 @@ $Header: /cvsroot/pgsql/doc/src/sgml/Attic/admin.sgml,v 1.38 2002/09/25 21:16:10
   &monitoring;
   &diskusage;
   &wal;
-  &recovery;
   &regress;
   &release;
 
diff --git a/doc/src/sgml/diskusage.sgml b/doc/src/sgml/diskusage.sgml
@@ -1,12 +1,20 @@
 <!--
-$Header: /cvsroot/pgsql/doc/src/sgml/diskusage.sgml,v 1.5 2002/09/21 18:32:52 petere Exp $
+$Header: /cvsroot/pgsql/doc/src/sgml/diskusage.sgml,v 1.6 2002/10/16 22:06:33 petere Exp $
 -->
 
 <chapter id="diskusage">
  <title>Monitoring Disk Usage</title>
 
+ <para>
+  This chapter discusses how to monitor the disk usage of a PostgreSQL
+  database system.  In the current release, the database administrator
+  does not have much control over the on-disk storage layout, so this
+  chapter is mostly informative and can give you some ideas how to
+  manage the disk usage with operating system tools.
+ </para>
+
  <sect1 id="disk-usage">
-  <title>Monitoring Disk Usage</Title>
+  <title>Determining Disk Usage</Title>
 
   <indexterm zone="disk-usage">
    <primary>disk usage</primary>
@@ -96,6 +104,40 @@ play-# ORDER BY relpages DESC;
    shows disk usage for each database.
   </para>
  </sect1>
+
+ <sect1 id="disk-full">
+  <title>Disk Full Failure</title>
+
+  <para>
+   The most important disk monitoring task of a database administrator
+   is to make sure the disk doesn't grow full.  A filled data disk may
+   result in subsequent corruption of database indexes, but not of the
+   fundamental data tables. If the WAL files are on the same disk (as
+   is the case for a default configuration) then a filled disk during
+   database initialization may result in corrupted or incomplete WAL
+   files. This failure condition is detected and the database server
+   will refuse to start up.
+  </para>
+
+  <para>
+   If you cannot free up additional space on the disk by deleting
+   other things you can move some of the database files to other file
+   systems and create a symlink from the original location.  But
+   note that <application>pg_dump</> cannot save the location layout
+   information of such a setup; a restore would put everything back in
+   one place.  To avoid running out of disk space, you can place the
+   WAL files or individual databases in other locations while creating
+   them.  See the <application>initdb</> documentation and <xref
+   linkend="manage-ag-alternate-locs"> for more information.
+  </para>
+
+  <tip>
+   <para>
+    Some file systems perform badly when they are almost full, so do
+    not wait until the disk is full to take action.
+   </para>
+  </tip>
+ </sect1>
 </chapter>
 
 <!-- Keep this comment at the end of the file
diff --git a/doc/src/sgml/filelist.sgml b/doc/src/sgml/filelist.sgml
@@ -1,4 +1,4 @@
-<!-- $Header: /cvsroot/pgsql/doc/src/sgml/filelist.sgml,v 1.23 2002/09/25 21:16:10 petere Exp $ -->
+<!-- $Header: /cvsroot/pgsql/doc/src/sgml/filelist.sgml,v 1.24 2002/10/16 22:06:33 petere Exp $ -->
 
 <!entity history    SYSTEM "history.sgml">
 <!entity info       SYSTEM "info.sgml">
@@ -49,7 +49,6 @@
 <!entity maintenance   SYSTEM "maintenance.sgml">
 <!entity manage-ag     SYSTEM "manage-ag.sgml">
 <!entity monitoring    SYSTEM "monitoring.sgml">
-<!entity recovery      SYSTEM "recovery.sgml">
 <!entity regress       SYSTEM "regress.sgml">
 <!entity release       SYSTEM "release.sgml">
 <!entity runtime       SYSTEM "runtime.sgml">
diff --git a/doc/src/sgml/recovery.sgml b/doc/src/sgml/recovery.sgml
