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


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

<!-- 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>