Home Explore Blog CI



postgresql

doc/src/sgml/appendix-obsolete-recovery-config.sgml
27f5753d44bef644c40b30768cd91566d3c87e09099f12e400000003000007ae
<!-- 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>

Chunks
51895b1d (1st chunk of `doc/src/sgml/appendix-obsolete-recovery-config.sgml`)
Title: Removal of recovery.conf and related settings
Summary
The recovery.conf file, used in PostgreSQL 11 and earlier for managing replicas and standbys, was removed in PostgreSQL 12. Archive recovery, streaming replication, and PITR are now configured using regular server configuration parameters in postgresql.conf. Additionally, the promote_trigger_file setting is replaced by pg_ctl promote or pg_promote(), and the standby_mode setting is replaced by the standby.signal file.