doc/src/sgml/appendix-obsolete-recovery-config.sgml

   1 <!-- doc/src/sgml/appendix-obsolete-recovery-config.sgml -->
   2 <!--
   3   See doc/src/sgml/appendix-obsolete.sgml for why this file exists. Do not change the id attribute.
   4 -->
   5
   6 <sect1 id="recovery-config" xreflabel="recovery.conf">
   7   <title><filename>recovery.conf</filename> file merged into <filename>postgresql.conf</filename></title>
   8
   9    <indexterm>
  10      <primary><filename>recovery.conf</filename></primary>
  11    </indexterm>
  12
  13    <para>
  14     PostgreSQL 11 and below used a configuration file named
  15     <filename>recovery.conf</filename>
  16     <indexterm><primary>recovery.conf</primary></indexterm>
  17     to manage replicas and standbys. Support for this file was removed in PostgreSQL 12. See
  18     <link linkend="release-prior">the release notes for PostgreSQL 12</link> for details
  19     on this change.
  20    </para>
  21
  22    <para>
  23     On PostgreSQL 12 and above,
  24     <link linkend="continuous-archiving">archive recovery, streaming replication, and PITR</link>
  25     are configured using
  26     <link linkend="runtime-config-replication-standby">normal server configuration parameters</link>.
  27     These are set in <filename>postgresql.conf</filename> or via
  28     <link linkend="sql-altersystem">ALTER SYSTEM</link>
  29     like any other parameter.
  30    </para>
  31
  32    <para>
  33     The server will not start if a <filename>recovery.conf</filename> exists.
  34    </para>
  35
  36    <para>
  37     PostgreSQL 15 and below had a setting
  38     <literal>promote_trigger_file</literal>, or
  39     <literal>trigger_file</literal> before 12.
  40     Use <command>pg_ctl promote</command> or call
  41     <function>pg_promote()</function> to promote a standby instead.
  42    </para>
  43
  44    <para>
  45     The
  46     <literal>standby_mode</literal>
  47     <indexterm>
  48      <primary>standby_mode</primary>
  49      <see>standby.signal</see>
  50     </indexterm>
  51     setting has been removed. A <filename>standby.signal</filename> file in the data directory
  52     is used instead. See <xref linkend="standby-server-operation"/> for details.
  53    </para>
  54
  55 </sect1>