Files
repmgr/doc/configuration-file.sgml
2017-10-05 10:30:29 +09:00

43 lines
1.6 KiB
Plaintext

<sect1 id="configuration-file" xreflabel="configuration file location">
<title>Configuration file location</title>
<para>
`repmgr` and `repmgrd` use a common configuration file, by default called
`repmgr.conf` (although any name can be used if explicitly specified).
`repmgr.conf` must contain a number of required parameters, including
the database connection string for the local node and the location
of its data directory; other values will be inferred from defaults if
not explicitly supplied. See section `configuration file parameters`
for more details.
</para>
<para>
The configuration file will be searched for in the following locations:
<itemizedlist spacing="compact" mark="bullet">
<listitem>
<para>a configuration file specified by the `-f/--config-file` command line option</para>
</listitem>
<listitem>
<para>a location specified by the package maintainer (if `repmgr` was installed
from a package and the package maintainer has specified the configuration
file location)</para>
</listitem>
<listitem>
<para>`repmgr.conf` in the local directory</para>
</listitem>
<listitem>
<para>`/etc/repmgr.conf`</para>
</listitem>
<listitem>
<para>the directory reported by `pg_config --sysconfdir`</para>
</listitem>
</itemizedlist>
</para>
<para>
Note that if a file is explicitly specified with `-f/--config-file`, an error will
be raised if it is not found or not readable and no attempt will be made to check
default locations; this is to prevent `repmgr` unexpectedly reading the wrong file.
</para>
</sect1>