1<appendix id="appendix-support" xreflabel="repmgr support">
2
3  <title>&repmgr; support</title>
4
5  <indexterm>
6    <primary>support</primary>
7  </indexterm>
8
9  <para>
10    <ulink url="https://2ndquadrant.com/">2ndQuadrant</ulink> provides 24x7
11    production support for &repmgr; and other PostgreSQL
12    products, including configuration assistance, installation
13    verification and training for running a robust replication cluster.
14  </para>
15  <para>
16    For further details see: <ulink url="https://2ndquadrant.com/en/support/">https://2ndquadrant.com/en/support/</ulink>
17  </para>
18
19  <para>
20    A mailing list/forum is provided via Google groups to discuss contributions or issues: <ulink url="https://groups.google.com/group/repmgr">https://groups.google.com/group/repmgr</ulink>.
21  </para>
22  <para>
23    Please report bugs and other issues to: <ulink url="https://github.com/2ndQuadrant/repmgr">https://github.com/2ndQuadrant/repmgr</ulink>.
24  </para>
25
26  <important>
27    <para>
28      Please read the <link linkend="appendix-support-reporting-issues">following section</link> before submitting questions or issue reports.
29    </para>
30  </important>
31
32  <sect1 id="appendix-support-reporting-issues" xreflabel="Reportins Issues">
33    <title>Reporting Issues</title>
34
35    <indexterm>
36      <primary>support</primary>
37      <secondary>reporting issues</secondary>
38    </indexterm>
39
40
41    <para>
42      When asking questions or reporting issues, it is extremely helpful if the following information is included:
43
44    <itemizedlist spacing="compact" mark="bullet">
45
46     <listitem>
47      <simpara>
48        PostgreSQL version
49      </simpara>
50     </listitem>
51
52     <listitem>
53      <simpara>
54        &repmgr; version
55      </simpara>
56     </listitem>
57
58     <listitem>
59      <simpara>
60        How was &repmgr; installed? From source? From packages? If
61        so from which repository?
62      </simpara>
63     </listitem>
64
65     <listitem>
66      <simpara>
67        <filename>repmpgr.conf</filename> files (suitably anonymized if necessary)
68      </simpara>
69     </listitem>
70
71     <listitem>
72      <simpara>
73        Contents of the <literal>repmgr.nodes</literal> table (suitably anonymized if necessary)
74      </simpara>
75     </listitem>
76
77
78     <listitem>
79      <simpara>
80        PostgreSQL 11 and earlier: contents of the <filename>recovery.conf</filename> file
81        (suitably anonymized if necessary).
82      </simpara>
83     </listitem>
84     <listitem>
85      <simpara>
86        PostgreSQL 12 and later: contents of the <filename>postgresql.auto.conf</filename> file
87        (suitably anonymized if necessary), and whether or not the PostgreSQL data directory
88        contains the files <filename>standby.signal</filename> and/or <filename>recovery.signal</filename>.
89      </simpara>
90     </listitem>
91
92    </itemizedlist>
93    </para>
94    <para>
95      If issues are encountered with a &repmgr; client command, please provide
96      the output of that command executed with the options
97      <option>-LDEBUG --verbose</option>, which will ensure &repmgr; emits
98      the maximum level of logging output.
99    </para>
100    <para>
101      If issues are encountered with &repmgrd;,
102      please provide relevant extracts from the &repmgr; log files
103      and if possible the PostgreSQL log itself. Please ensure these
104      logs do not contain any confidential data.
105    </para>
106    <para>
107      In all cases it is <emphasis>extremely</emphasis> useful to receive
108      as much detail as possible on how to reliably reproduce
109      an issue.
110    </para>
111
112  </sect1>
113
114</appendix>
115