summaryrefslogtreecommitdiff
path: root/doc/src/sgml/basic-archive.sgml
diff options
context:
space:
mode:
authorMichael Paquier2023-01-25 05:36:51 +0000
committerMichael Paquier2023-01-25 05:36:51 +0000
commit0ad3c60caf5f77edfefaf8850fbba5ea4fe28640 (patch)
tree0edd80514358104a8ac00ca35f23e5b4f69219ef /doc/src/sgml/basic-archive.sgml
parent239b1753421ccbd52f4f628a9265c3034d38b80f (diff)
Rename contrib module basic_archive to basic_wal_module
This rename is in preparation for the introduction of recovery modules, where basic_wal_module will be used as a base template for the set of callbacks introduced. The former name did not really reflect all that. Author: Nathan Bossart Discussion: https://postgr.es/m/20221227192449.GA3672473@nathanxps13
Diffstat (limited to 'doc/src/sgml/basic-archive.sgml')
-rw-r--r--doc/src/sgml/basic-archive.sgml81
1 files changed, 0 insertions, 81 deletions
diff --git a/doc/src/sgml/basic-archive.sgml b/doc/src/sgml/basic-archive.sgml
deleted file mode 100644
index b4d43ced203..00000000000
--- a/doc/src/sgml/basic-archive.sgml
+++ /dev/null
@@ -1,81 +0,0 @@
-<!-- doc/src/sgml/basic-archive.sgml -->
-
-<sect1 id="basic-archive" xreflabel="basic_archive">
- <title>basic_archive &mdash; an example WAL archive module</title>
-
- <indexterm zone="basic-archive">
- <primary>basic_archive</primary>
- </indexterm>
-
- <para>
- <filename>basic_archive</filename> is an example of an archive module. This
- module copies completed WAL segment files to the specified directory. This
- may not be especially useful, but it can serve as a starting point for
- developing your own archive module. For more information about archive
- modules, see <xref linkend="archive-modules"/>.
- </para>
-
- <para>
- In order to function, this module must be loaded via
- <xref linkend="guc-archive-library"/>, and <xref linkend="guc-archive-mode"/>
- must be enabled.
- </para>
-
- <sect2 id="basic-archive-configuration-parameters">
- <title>Configuration Parameters</title>
-
- <variablelist>
- <varlistentry>
- <term>
- <varname>basic_archive.archive_directory</varname> (<type>string</type>)
- <indexterm>
- <primary><varname>basic_archive.archive_directory</varname> configuration parameter</primary>
- </indexterm>
- </term>
- <listitem>
- <para>
- The directory where the server should copy WAL segment files. This
- directory must already exist. The default is an empty string, which
- effectively halts WAL archiving, but if <xref linkend="guc-archive-mode"/>
- is enabled, the server will accumulate WAL segment files in the
- expectation that a value will soon be provided.
- </para>
- </listitem>
- </varlistentry>
- </variablelist>
-
- <para>
- These parameters must be set in <filename>postgresql.conf</filename>.
- Typical usage might be:
- </para>
-
-<programlisting>
-# postgresql.conf
-archive_mode = 'on'
-archive_library = 'basic_archive'
-basic_archive.archive_directory = '/path/to/archive/directory'
-</programlisting>
- </sect2>
-
- <sect2 id="basic-archive-notes">
- <title>Notes</title>
-
- <para>
- Server crashes may leave temporary files with the prefix
- <filename>archtemp</filename> in the archive directory. It is recommended to
- delete such files before restarting the server after a crash. It is safe to
- remove such files while the server is running as long as they are unrelated
- to any archiving still in progress, but users should use extra caution when
- doing so.
- </para>
- </sect2>
-
- <sect2 id="basic-archive-author">
- <title>Author</title>
-
- <para>
- Nathan Bossart
- </para>
- </sect2>
-
-</sect1>