github/repmgr
1
0
Fork 0
mirror of https://github.com/EnterpriseDB/repmgr.git synced 2026-03-23 07:06:30 +00:00
Code Issues Packages Projects Releases 1 Wiki Activity

repmgr: mandate explicit configuration for "daemon (start|stop)"

Browse Source 
The initial implementation was designed to fall back to "manual"
start/stop of repmgrd if the "repmgrd_service_..._command" parameters
were not set.

However on reflection, this is too much of a potential footgun, so
we will mandate provision of these parameters.
This commit is contained in:
Ian Barwick
2019-01-30 10:57:06 +09:00
parent 9e7cb6d01c
commit b6264b77c4
4 changed files with 63 additions and 132 deletions
Download Patch File Download Diff File Expand all files Collapse all files

24
doc/repmgr-daemon-start.sgml
View File

@@ -23,13 +23,7 @@
This command starts the <application>repmgrd</application> daemon on the
local node.
</para>
<note>
<para>
If &repmgr; was installed from packages, it is <emphasis>essential</emphasis>
that <application>repmgrd</application> is configured to use the
package-provided service start/stop commands. See below for details.
</para>
</note>
</refsect1>
<refsect1>
@@ -41,10 +35,6 @@
if &repmgr; was installed from a package, this will be the service command defined by the
package. For more details see <link linkend="appendix-packages">Appendix: &repmgr; package details</link>.
</para>
<para>
<emphasis>If</emphasis> <varname>repmgrd_service_start_command</varname> is not set,
&repmgr; will default to executing <application>repmgrd</application> directly.
</para>
<important>
<para>
@@ -94,6 +84,16 @@
</listitem>
</varlistentry>
<varlistentry>
<term><option>ERR_BAD_CONFIG (1)</option></term>
<listitem>
<para>
<varname>repmgrd_service_start_command</varname> is not defined in
<filename>repmgr.conf</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>ERR_REPMGRD_SERVICE (27)</option></term>
<listitem>
@@ -109,7 +109,7 @@
<refsect1>
<title>See also</title>
<para>
<xref linkend="repmgr-daemon-stop">
<xref linkend="repmgr-daemon-stop">, <xref linkend="repmgr-daemon-status">
</para>
</refsect1>

24
doc/repmgr-daemon-stop.sgml
View File

@@ -23,13 +23,7 @@
This command stops the <application>repmgrd</application> daemon on the
local node.
</para>
<note>
<para>
If &repmgr; was installed from packages, it is <emphasis>essential</emphasis>
that <application>repmgrd</application> is configured to use the
package-provided service start/stop commands. See below for details.
</para>
</note>
</refsect1>
<refsect1>
@@ -41,10 +35,6 @@
if &repmgr; was installed from a package, this will be the service command defined by the
package. For more details see <link linkend="appendix-packages">Appendix: &repmgr; package details</link>.
</para>
<para>
<emphasis>If</emphasis> <varname>repmgrd_service_stop_command</varname> is not set,
&repmgr; will default to executing <application>repmgrd</application> directly.
</para>
<important>
<para>
@@ -94,6 +84,16 @@
</listitem>
</varlistentry>
<varlistentry>
<term><option>ERR_BAD_CONFIG (1)</option></term>
<listitem>
<para>
<varname>repmgrd_service_stop_command</varname> is not defined in
<filename>repmgr.conf</filename>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>ERR_REPMGRD_SERVICE (27)</option></term>
<listitem>
@@ -109,7 +109,7 @@
<refsect1>
<title>See also</title>
<para>
<xref linkend="repmgr-daemon-stop">
<xref linkend="repmgr-daemon-start">, <xref linkend="repmgr-daemon-status">
</para>
</refsect1>

14
doc/repmgrd-configuration.sgml
View File

@@ -363,6 +363,20 @@
See appendix <xref linkend="appendix-packages"> for details of service commands
for different distributions.
</para>
<para>
The commands <link linkend="repmgr-daemon-start"><command>repmgr daemon start</command></link> and
<link linkend="repmgr-daemon-stop"><command>repmgr daemon stop</command></link> can be used
as convenience wrappers to start and stop <application>repmgrd</application>.
</para>
<important>
<para>
<link linkend="repmgr-daemon-start"><command>repmgr daemon start</command></link> and
<link linkend="repmgr-daemon-stop"><command>repmgr daemon stop</command></link> require
that the appropriate start/stop commands are configured as
<varname>repmgrd_service_start_command</varname> and <varname>repmgrd_service_stop_command</varname>
in <filename>repmgr.conf</filename>.
</para>
</important>
<para>
<application>repmgrd</application> can be started manually like this:
<programlisting>

133
repmgr-action-daemon.c
View File

@@ -394,16 +394,16 @@ do_daemon_start(void)
PQExpBufferData output_buf;
bool success;
/*
* if local connection available, check if repmgr.so is installed, and
* whether repmgrd is running
*/
if (config_file_options.repmgrd_service_start_command[0] == '\0')
{
log_error(_("\"repmgrd_service_start_command\" is not set"));
log_hint(_("set \"repmgrd_service_start_command\" in \"repmgr.conf\""));
exit(ERR_BAD_CONFIG);
}
log_verbose(LOG_INFO, _("connecting to local node"));
if (strlen(config_file_options.conninfo))
conn = establish_db_connection(config_file_options.conninfo, false);
else
conn = establish_db_connection_by_params(&source_conninfo, false);
conn = establish_db_connection(config_file_options.conninfo, false);
if (PQstatus(conn) != CONNECTION_OK)
{
@@ -413,6 +413,10 @@ do_daemon_start(void)
exit(ERR_REPMGRD_SERVICE);
}
/*
* if local connection available, check if repmgr.so is installed, and
* whether repmgrd is running
*/
check_shared_library(conn);
if (is_repmgrd_running(conn) == true)
@@ -424,25 +428,10 @@ do_daemon_start(void)
PQfinish(conn);
initPQExpBuffer(&repmgrd_command);
if (config_file_options.repmgrd_service_start_command[0] != '\0')
{
appendPQExpBufferStr(&repmgrd_command,
config_file_options.repmgrd_service_start_command);
}
else
{
/*
* repmgr will attempt to construct appropriate commands, but
* usually it's preferable for them to be explicitly defined,
* particularly if repmgr is installed from packages.
*/
log_warning(_("\"repmgrd_service_start_command\" is not set"));
log_hint(_("specify appropriate repmgrd start and stop commands in \"repmgr.conf\" for reliable operation"));
make_repmgrd_path(&repmgrd_command);
}
appendPQExpBufferStr(&repmgrd_command,
config_file_options.repmgrd_service_start_command);
if (runtime_options.dry_run == true)
{
@@ -479,16 +468,20 @@ void do_daemon_stop(void)
bool success;
pid_t pid = UNKNOWN_PID;
if (config_file_options.repmgrd_service_start_command[0] == '\0')
{
log_error(_("\"repmgrd_service_stop_command\" is not set"));
log_hint(_("set \"repmgrd_service_stop_command\" in \"repmgr.conf\""));
exit(ERR_BAD_CONFIG);
}
/*
* if local connection available, check if repmgr.so is installed, and
* whether repmgrd is running
*/
log_verbose(LOG_INFO, _("connecting to local node"));
if (strlen(config_file_options.conninfo))
conn = establish_db_connection(config_file_options.conninfo, false);
else
conn = establish_db_connection_by_params(&source_conninfo, false);
conn = establish_db_connection(config_file_options.conninfo, false);
if (PQstatus(conn) != CONNECTION_OK)
{
@@ -514,84 +507,8 @@ void do_daemon_stop(void)
initPQExpBuffer(&repmgrd_command);
if (config_file_options.repmgrd_service_start_command[0] != '\0')
{
appendPQExpBufferStr(&repmgrd_command,
config_file_options.repmgrd_service_stop_command);
}
else
{
log_warning(_("\"repmgrd_service_stop_command\" is not set"));
log_hint(_("specify appropriate repmgrd start and stop commands in \"repmgr.conf\" for reliable operation"));
/* PID not known - attempt to retrieve repmgrd default PID */
if (pid == UNKNOWN_PID)
{
PQExpBufferData repmgrd_pid_command;
char pidfile[MAXPGPATH] = "";
int pidfile_pathlen;
struct stat stat_pidfile;
initPQExpBuffer(&repmgrd_pid_command);
make_repmgrd_path(&repmgrd_pid_command);
appendPQExpBufferStr(&repmgrd_pid_command, " --show-pid-file 2>/dev/null");
initPQExpBuffer(&output_buf);
log_debug("%s", repmgrd_pid_command.data);
success = local_command(repmgrd_pid_command.data, &output_buf);
termPQExpBuffer(&repmgrd_pid_command);
if (success == false)
{
log_error(_("unable to execute \"repmgrd --show-pid-file\""));
if (output_buf.data[0] != '\0')
log_detail("%s", output_buf.data);
termPQExpBuffer(&output_buf);
exit(ERR_REPMGRD_SERVICE);
}
if (output_buf.data[0] == '\0')
{
log_error(_("\"repmgrd --show-pid-file\" did not return a file"));
termPQExpBuffer(&output_buf);
exit(ERR_REPMGRD_SERVICE);
}
pidfile_pathlen = strlen(output_buf.data);
if (pidfile_pathlen > MAXPGPATH)
pidfile_pathlen = MAXPGPATH;
else
pidfile_pathlen --;
strncpy(pidfile, output_buf.data, pidfile_pathlen);
/* check if pid file actually exists */
if (stat(pidfile, &stat_pidfile) != 0)
{
log_error(_("PID file \"%s\" not found"),
pidfile);
log_detail("%s", strerror(errno));
if (config_file_options.repmgrd_pid_file[0] == '\0')
log_hint(_("set \"repmgrd_pid_file\" in \"%s\""), config_file_path);
exit(ERR_REPMGRD_SERVICE);
}
appendPQExpBuffer(&repmgrd_command,
"kill `cat %s`", pidfile);
termPQExpBuffer(&output_buf);
}
else
{
appendPQExpBuffer(&repmgrd_command,
"kill %i", pid);
}
}
appendPQExpBufferStr(&repmgrd_command,
config_file_options.repmgrd_service_stop_command);
if (runtime_options.dry_run == true)
{