postgresql/doc/src/sgml/appendix-obsolete-recovery-config.sgml
Thomas Munro cd4329d939 Remove promote_trigger_file.
Previously, an idle startup (recovery) process would wake up every 5
seconds to have a chance to poll for promote_trigger_file, even if that
GUC was not configured.  That promotion triggering mechanism was
effectively superseded by pg_ctl promote and pg_promote() a long time
ago.  There probably aren't many users left and it's very easy to change
to the modern mechanisms, so we agreed to remove the feature.

This is part of a campaign to reduce wakeups on idle systems.

Author: Simon Riggs <simon.riggs@enterprisedb.com>
Reviewed-by: Bharath Rupireddy <bharath.rupireddyforpostgres@gmail.com>
Reviewed-by: Robert Haas <robertmhaas@gmail.com>
Reviewed-by: Thomas Munro <thomas.munro@gmail.com>
Reviewed-by: Tom Lane <tgl@sss.pgh.pa.us>
Reviewed-by: Ian Lawrence Barwick <barwick@gmail.com>
Discussion: https://postgr.es/m/CANbhV-FsjnzVOQGBpQ589%3DnWuL1Ex0Ykn74Nh1hEjp2usZSR5g%40mail.gmail.com
2022-11-29 12:08:38 +13:00

56 lines
1.9 KiB
Plaintext

<!-- doc/src/sgml/appendix-obsolete-recovery-config.sgml -->
<!--
See doc/src/sgml/appendix-obsolete.sgml for why this file exists. Do not change the id attribute.
-->
<sect1 id="recovery-config" xreflabel="recovery.conf">
<title><filename>recovery.conf</filename> file merged into <filename>postgresql.conf</filename></title>
<indexterm>
<primary><filename>recovery.conf</filename></primary>
</indexterm>
<para>
PostgreSQL 11 and below used a configuration file named
<filename>recovery.conf</filename>
<indexterm><primary>recovery.conf</primary></indexterm>
to manage replicas and standbys. Support for this file was removed in PostgreSQL 12. See
<link linkend="release-prior">the release notes for PostgreSQL 12</link> for details
on this change.
</para>
<para>
On PostgreSQL 12 and above,
<link linkend="continuous-archiving">archive recovery, streaming replication, and PITR</link>
are configured using
<link linkend="runtime-config-replication-standby">normal server configuration parameters</link>.
These are set in <filename>postgresql.conf</filename> or via
<link linkend="sql-altersystem">ALTER SYSTEM</link>
like any other parameter.
</para>
<para>
The server will not start if a <filename>recovery.conf</filename> exists.
</para>
<para>
PostgreSQL 15 and below had a setting
<literal>promote_trigger_file</literal>, or
<literal>trigger_file</literal> before 12.
Use <command>pg_ctl promote</command> or call
<function>pg_promote()</function> to promote a standby instead.
</para>
<para>
The
<literal>standby_mode</literal>
<indexterm>
<primary>standby_mode</primary>
<see>standby.signal</see>
</indexterm>
setting has been removed. A <filename>standby.signal</filename> file in the data directory
is used instead. See <xref linkend="standby-server-operation"/> for details.
</para>
</sect1>