diff options
| author | Tom Lane | 2012-03-05 19:09:01 +0000 |
|---|---|---|
| committer | Tom Lane | 2012-03-05 19:09:01 +0000 |
| commit | 0e925196340bf9279238f780cc10125fca2a0733 (patch) | |
| tree | 7d08185286ea2cadd8401005174f40179506080b /doc | |
| parent | 268ca4f57ea2dc3bf0dfb0f5c17fbda269b5d462 (diff) | |
Improve documentation around logging_collector and use of stderr.
In backup.sgml, point out that you need to be using the logging collector
if you want to log messages from a failing archive_command script. (This
is an oversimplification, in that it will work without the collector as
long as you're not sending postmaster stderr to /dev/null; but it seems
like a good idea to encourage use of the collector to avoid problems
with multiple processes concurrently scribbling on one file.)
In config.sgml, do some wordsmithing of logging_collector discussion.
Per bug #6518 from Janning Vygen
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/src/sgml/backup.sgml | 13 |
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/src/sgml/backup.sgml b/doc/src/sgml/backup.sgml index e08d8ead383..ef18b030153 100644 --- a/doc/src/sgml/backup.sgml +++ b/doc/src/sgml/backup.sgml @@ -1259,9 +1259,6 @@ archive_command = 'local_backup_script.sh "%p" "%f"' This allows all complexity to be managed within the script, which can be written in a popular scripting language such as <application>bash</> or <application>perl</>. - Any messages written to <literal>stderr</> from the script will appear - in the database server log, allowing complex configurations to be - diagnosed easily if they fail. </para> <para> @@ -1290,6 +1287,16 @@ archive_command = 'local_backup_script.sh "%p" "%f"' </listitem> </itemizedlist> </para> + + <tip> + <para> + When using an <varname>archive_command</varname> script, it's desirable + to enable <xref linkend="guc-logging-collector">. + Any messages written to <systemitem>stderr</> from the script will then + appear in the database server log, allowing complex configurations to + be diagnosed easily if they fail. + </para> + </tip> </sect3> </sect2> |
