You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
3339 lines
110 KiB
3339 lines
110 KiB
diff --color -uNr a/doc/man/Makefile.am b/doc/man/Makefile.am
|
|
--- a/doc/man/Makefile.am 2021-04-12 12:51:56.831835953 +0200
|
|
+++ b/doc/man/Makefile.am 2021-04-13 13:38:14.198361848 +0200
|
|
@@ -154,6 +154,7 @@
|
|
ocf_heartbeat_ovsmonitor.7 \
|
|
ocf_heartbeat_pgagent.7 \
|
|
ocf_heartbeat_pgsql.7 \
|
|
+ ocf_heartbeat_pgsqlms.7 \
|
|
ocf_heartbeat_pingd.7 \
|
|
ocf_heartbeat_podman.7 \
|
|
ocf_heartbeat_portblock.7 \
|
|
diff --color -uNr a/heartbeat/Makefile.am b/heartbeat/Makefile.am
|
|
--- a/heartbeat/Makefile.am 2021-04-12 12:51:56.831835953 +0200
|
|
+++ b/heartbeat/Makefile.am 2021-04-13 13:37:45.741292178 +0200
|
|
@@ -149,6 +149,7 @@
|
|
ovsmonitor \
|
|
pgagent \
|
|
pgsql \
|
|
+ pgsqlms \
|
|
pingd \
|
|
podman \
|
|
portblock \
|
|
@@ -209,7 +210,10 @@
|
|
mysql-common.sh \
|
|
nfsserver-redhat.sh \
|
|
findif.sh \
|
|
- ocf.py
|
|
+ ocf.py \
|
|
+ OCF_Directories.pm \
|
|
+ OCF_Functions.pm \
|
|
+ OCF_ReturnCodes.pm
|
|
|
|
# Legacy locations
|
|
hbdir = $(sysconfdir)/ha.d
|
|
diff --color -uNr a/heartbeat/OCF_Directories.pm b/heartbeat/OCF_Directories.pm
|
|
--- a/heartbeat/OCF_Directories.pm 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/heartbeat/OCF_Directories.pm 2021-04-13 13:37:35.621267404 +0200
|
|
@@ -0,0 +1,139 @@
|
|
+#!/usr/bin/perl
|
|
+# This program is open source, licensed under the PostgreSQL License.
|
|
+# For license terms, see the LICENSE file.
|
|
+#
|
|
+# Copyright (C) 2016-2020: Jehan-Guillaume de Rorthais and Mael Rimbault
|
|
+
|
|
+=head1 NAME
|
|
+
|
|
+OCF_Directories - Binaries and binary options for use in Resource Agents
|
|
+
|
|
+=head1 SYNOPSIS
|
|
+
|
|
+ use FindBin;
|
|
+ use lib "$FindBin::RealBin/../../lib/heartbeat/";
|
|
+
|
|
+ use OCF_Directories;
|
|
+
|
|
+=head1 DESCRIPTION
|
|
+
|
|
+This module has been ported from the ocf-directories shell script of the
|
|
+resource-agents project. See L<https://github.com/ClusterLabs/resource-agents/>.
|
|
+
|
|
+=head1 VARIABLES
|
|
+
|
|
+Here are the variables exported by this module:
|
|
+
|
|
+=over
|
|
+
|
|
+=item $INITDIR
|
|
+
|
|
+=item $HA_DIR
|
|
+
|
|
+=item $HA_RCDIR
|
|
+
|
|
+=item $HA_CONFDIR
|
|
+
|
|
+=item $HA_CF
|
|
+
|
|
+=item $HA_VARLIB
|
|
+
|
|
+=item $HA_RSCTMP
|
|
+
|
|
+=item $HA_RSCTMP_OLD
|
|
+
|
|
+=item $HA_FIFO
|
|
+
|
|
+=item $HA_BIN
|
|
+
|
|
+=item $HA_SBIN_DIR
|
|
+
|
|
+=item $HA_DATEFMT
|
|
+
|
|
+=item $HA_DEBUGLOG
|
|
+
|
|
+=item $HA_RESOURCEDIR
|
|
+
|
|
+=item $HA_DOCDIR
|
|
+
|
|
+=item $__SCRIPT_NAME
|
|
+
|
|
+=item $HA_VARRUN
|
|
+
|
|
+=item $HA_VARLOCK
|
|
+
|
|
+=item $ocf_prefix
|
|
+
|
|
+=item $ocf_exec_prefix
|
|
+
|
|
+=back
|
|
+
|
|
+=cut
|
|
+
|
|
+package OCF_Directories;
|
|
+
|
|
+use strict;
|
|
+use warnings;
|
|
+use 5.008;
|
|
+use File::Basename;
|
|
+
|
|
+BEGIN {
|
|
+ use Exporter;
|
|
+
|
|
+
|
|
+ our $VERSION = 'v2.3.0';
|
|
+ our @ISA = ('Exporter');
|
|
+ our @EXPORT = qw(
|
|
+ $INITDIR
|
|
+ $HA_DIR
|
|
+ $HA_RCDIR
|
|
+ $HA_CONFDIR
|
|
+ $HA_CF
|
|
+ $HA_VARLIB
|
|
+ $HA_RSCTMP
|
|
+ $HA_RSCTMP_OLD
|
|
+ $HA_FIFO
|
|
+ $HA_BIN
|
|
+ $HA_SBIN_DIR
|
|
+ $HA_DATEFMT
|
|
+ $HA_DEBUGLOG
|
|
+ $HA_RESOURCEDIR
|
|
+ $HA_DOCDIR
|
|
+ $__SCRIPT_NAME
|
|
+ $HA_VARRUN
|
|
+ $HA_VARLOCK
|
|
+ $ocf_prefix
|
|
+ $ocf_exec_prefix
|
|
+ );
|
|
+ our @EXPORT_OK = ( @EXPORT );
|
|
+}
|
|
+
|
|
+our $INITDIR = ( $ENV{'INITDIR'} || '/etc/init.d' );
|
|
+our $HA_DIR = ( $ENV{'HA_DIR'} || '/etc/ha.d' );
|
|
+our $HA_RCDIR = ( $ENV{'HA_RCDIR'} || '/etc/ha.d/rc.d' );
|
|
+our $HA_CONFDIR = ( $ENV{'HA_CONFDIR'} || '/etc/ha.d/conf' );
|
|
+our $HA_CF = ( $ENV{'HA_CF'} || '/etc/ha.d/ha.cf' );
|
|
+our $HA_VARLIB = ( $ENV{'HA_VARLIB'} || '/var/lib/heartbeat' );
|
|
+our $HA_RSCTMP = ( $ENV{'HA_RSCTMP'} || '/run/resource-agents' );
|
|
+our $HA_RSCTMP_OLD = ( $ENV{'HA_RSCTMP_OLD'} || '/var/run/heartbeat/rsctmp' );
|
|
+our $HA_FIFO = ( $ENV{'HA_FIFO'} || '/var/lib/heartbeat/fifo' );
|
|
+our $HA_BIN = ( $ENV{'HA_BIN'} || '/usr/libexec/heartbeat' );
|
|
+our $HA_SBIN_DIR = ( $ENV{'HA_SBIN_DIR'} || '/usr/sbin' );
|
|
+our $HA_DATEFMT = ( $ENV{'HA_DATEFMT'} || '%b %d %T ' );
|
|
+our $HA_DEBUGLOG = ( $ENV{'HA_DEBUGLOG'} || '/dev/null' );
|
|
+our $HA_RESOURCEDIR = ( $ENV{'HA_RESOURCEDIR'}|| '/etc/ha.d/resource.d' );
|
|
+our $HA_DOCDIR = ( $ENV{'HA_DOCDIR'} || '/usr/share/doc/heartbeat' );
|
|
+our $__SCRIPT_NAME = ( $ENV{'__SCRIPT_NAME'} || fileparse($0) );
|
|
+our $HA_VARRUN = ( $ENV{'HA_VARRUN'} || '/var/run' );
|
|
+our $HA_VARLOCK = ( $ENV{'HA_VARLOCK'} || '/var/lock/subsys' );
|
|
+our $ocf_prefix = '/usr';
|
|
+our $ocf_exec_prefix = '/usr';
|
|
+
|
|
+1;
|
|
+
|
|
+=head1 COPYRIGHT AND LICENSE
|
|
+
|
|
+Copyright (C) 2016: Jehan-Guillaume de Rorthais and Mael Rimbault.
|
|
+
|
|
+Licensed under the PostgreSQL License.
|
|
+
|
|
diff --color -uNr a/heartbeat/OCF_Functions.pm b/heartbeat/OCF_Functions.pm
|
|
--- a/heartbeat/OCF_Functions.pm 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/heartbeat/OCF_Functions.pm 2021-04-13 13:37:35.621267404 +0200
|
|
@@ -0,0 +1,631 @@
|
|
+#!/usr/bin/perl
|
|
+# This program is open source, licensed under the PostgreSQL License.
|
|
+# For license terms, see the LICENSE file.
|
|
+#
|
|
+# Copyright (C) 2016-2020: Jehan-Guillaume de Rorthais and Mael Rimbault
|
|
+
|
|
+=head1 NAME
|
|
+
|
|
+OCF_Functions - helper subroutines for OCF agent
|
|
+
|
|
+=head1 SYNOPSIS
|
|
+
|
|
+ use FindBin;
|
|
+ use lib "$FindBin::RealBin/../../lib/heartbeat/";
|
|
+
|
|
+ use OCF_Functions;
|
|
+
|
|
+=head1 DESCRIPTION
|
|
+
|
|
+This module has been ported from the ocf-shellfuncs shell script of the
|
|
+resource-agents project. See L<https://github.com/ClusterLabs/resource-agents/>.
|
|
+
|
|
+=head1 VARIABLE
|
|
+
|
|
+The only variable exported by this module is C<__OCF_ACTION>.
|
|
+
|
|
+=head1 SUBROUTINES
|
|
+
|
|
+Here are the subroutines ported from ocf-shellfuncs and exported by this module:
|
|
+
|
|
+=over
|
|
+
|
|
+=item ha_debug
|
|
+
|
|
+=item ha_log
|
|
+
|
|
+=item hadate
|
|
+
|
|
+=item ocf_is_clone
|
|
+
|
|
+=item ocf_is_ms
|
|
+
|
|
+=item ocf_is_probe
|
|
+
|
|
+=item ocf_is_root
|
|
+
|
|
+=item ocf_is_true
|
|
+
|
|
+=item ocf_is_ver
|
|
+
|
|
+=item ocf_local_nodename
|
|
+
|
|
+=item ocf_log
|
|
+
|
|
+=item ocf_exit_reason
|
|
+
|
|
+=item ocf_maybe_random
|
|
+
|
|
+=item ocf_ver2num
|
|
+
|
|
+=item ocf_ver_complete_level
|
|
+
|
|
+=item ocf_ver_level
|
|
+
|
|
+=item ocf_version_cmp
|
|
+
|
|
+=item set_logtag
|
|
+
|
|
+=back
|
|
+
|
|
+Here are the subroutines only existing in the perl module but not in the
|
|
+ocf-shellfuncs script:
|
|
+
|
|
+=over
|
|
+
|
|
+=item ocf_notify_env
|
|
+
|
|
+=back
|
|
+
|
|
+=cut
|
|
+
|
|
+package OCF_Functions;
|
|
+
|
|
+use strict;
|
|
+use warnings;
|
|
+use 5.008;
|
|
+use POSIX qw( strftime setlocale LC_ALL );
|
|
+use English;
|
|
+
|
|
+use FindBin;
|
|
+use lib "$FindBin::RealBin/../../lib/heartbeat/";
|
|
+
|
|
+use OCF_ReturnCodes;
|
|
+use OCF_Directories;
|
|
+
|
|
+BEGIN {
|
|
+ use Exporter;
|
|
+
|
|
+ our $VERSION = 'v2.3.0';
|
|
+ our @ISA = ('Exporter');
|
|
+ our @EXPORT = qw(
|
|
+ $__OCF_ACTION
|
|
+ ocf_is_root
|
|
+ ocf_maybe_random
|
|
+ ocf_is_true
|
|
+ hadate
|
|
+ set_logtag
|
|
+ ha_log
|
|
+ ha_debug
|
|
+ ocf_log
|
|
+ ocf_exit_reason
|
|
+ ocf_is_probe
|
|
+ ocf_is_clone
|
|
+ ocf_is_ms
|
|
+ ocf_is_ver
|
|
+ ocf_ver2num
|
|
+ ocf_ver_level
|
|
+ ocf_ver_complete_level
|
|
+ ocf_version_cmp
|
|
+ ocf_local_nodename
|
|
+ ocf_notify_env
|
|
+ );
|
|
+ our @EXPORT_OK = ( @EXPORT );
|
|
+}
|
|
+
|
|
+our $__OCF_ACTION;
|
|
+
|
|
+sub ocf_is_root {
|
|
+ return $EUID == 0;
|
|
+}
|
|
+
|
|
+sub ocf_maybe_random {
|
|
+ return int( rand( 32767 ) );
|
|
+}
|
|
+
|
|
+sub ocf_is_true {
|
|
+ my $v = shift;
|
|
+ return ( defined $v and $v =~ /^(?:yes|true|1|YES|TRUE|ja|on|ON)$/ );
|
|
+}
|
|
+
|
|
+sub hadate {
|
|
+ return strftime( $HA_DATEFMT, localtime );
|
|
+}
|
|
+
|
|
+sub set_logtag {
|
|
+
|
|
+ return if defined $ENV{'HA_LOGTAG'} and $ENV{'HA_LOGTAG'} ne '';
|
|
+
|
|
+ if ( defined $ENV{'OCF_RESOURCE_INSTANCE'} and $ENV{'OCF_RESOURCE_INSTANCE'} ne '' ) {
|
|
+ $ENV{'HA_LOGTAG'} = "$__SCRIPT_NAME($ENV{'OCF_RESOURCE_INSTANCE'})[$PID]";
|
|
+ }
|
|
+ else {
|
|
+ $ENV{'HA_LOGTAG'}="${__SCRIPT_NAME}[$PID]";
|
|
+ }
|
|
+}
|
|
+
|
|
+sub __ha_log {
|
|
+ my $ignore_stderr = 0;
|
|
+ my $loglevel = '';
|
|
+
|
|
+ if ( $_[0] eq '--ignore-stderr' ) {
|
|
+ $ignore_stderr = 1;
|
|
+ shift;
|
|
+ }
|
|
+
|
|
+ $ENV{'HA_LOGFACILITY'} = '' if not defined $ENV{'HA_LOGFACILITY'}
|
|
+ or $ENV{'HA_LOGFACILITY'} eq 'none';
|
|
+
|
|
+ # if we're connected to a tty, then output to stderr
|
|
+ if ( -t STDERR ) {
|
|
+ # FIXME
|
|
+ # T.N.: this was ported with the bug on $loglevel being empty
|
|
+ # and never set before the test here...
|
|
+ if ( defined $ENV{'HA_debug'}
|
|
+ and $ENV{'HA_debug'} == 0
|
|
+ and $loglevel eq 'debug'
|
|
+ ) {
|
|
+ return 0;
|
|
+ }
|
|
+ elsif ( $ignore_stderr ) {
|
|
+ # something already printed this error to stderr, so ignore
|
|
+ return 0;
|
|
+ }
|
|
+ if ( defined $ENV{'HA_LOGTAG'} and $ENV{'HA_LOGTAG'} ne '' ) {
|
|
+ printf STDERR "%s: %s\n", $ENV{'HA_LOGTAG'}, join ' ', @ARG;
|
|
+ }
|
|
+ else {
|
|
+ printf STDERR "%s\n", join ' ', @ARG;
|
|
+ }
|
|
+ return 0;
|
|
+ }
|
|
+
|
|
+ set_logtag();
|
|
+
|
|
+ if ( defined $ENV{'HA_LOGD'} and $ENV{'HA_LOGD'} eq 'yes' ) {
|
|
+ system 'ha_logger', '-t', $ENV{'HA_LOGTAG'}, @ARG;
|
|
+ return 0 if ( $? >> 8 ) == 0;
|
|
+ }
|
|
+
|
|
+ unless ( $ENV{'HA_LOGFACILITY'} eq '' ) {
|
|
+ # logging through syslog
|
|
+ # loglevel is unknown, use 'notice' for now
|
|
+ $loglevel = 'notice';
|
|
+ for ( "@ARG" ) {
|
|
+ if ( /ERROR/ ) {
|
|
+ $loglevel = 'err';
|
|
+ }
|
|
+ elsif ( /WARN/ ) {
|
|
+ $loglevel = 'warning';
|
|
+ }
|
|
+ elsif (/INFO|info/ ) {
|
|
+ $loglevel = 'info';
|
|
+ }
|
|
+ }
|
|
+
|
|
+ system 'logger', '-t', $ENV{'HA_LOGTAG'}, '-p',
|
|
+ "$ENV{'HA_LOGFACILITY'}.$loglevel", @ARG;
|
|
+ }
|
|
+
|
|
+ if ( defined $ENV{'HA_LOGFILE'} and $ENV{'HA_LOGFILE'} ne '' ) {
|
|
+ # appending to $HA_LOGFILE
|
|
+ open my $logfile, '>>', $ENV{'HA_LOGFILE'};
|
|
+ printf $logfile "%s: %s %s\n", $ENV{'HA_LOGTAG'}, hadate(),
|
|
+ join (' ', @ARG);
|
|
+ close $logfile;
|
|
+ }
|
|
+
|
|
+ # appending to stderr
|
|
+ printf STDERR "%s %s\n", hadate(), join ' ', @ARG
|
|
+ if (not defined $ENV{'HA_LOGFACILITY'} or $ENV{'HA_LOGFACILITY'} eq '')
|
|
+ and (not defined $ENV{'HA_LOGFILE'} or $ENV{'HA_LOGFILE'} eq '' )
|
|
+ and not $ignore_stderr;
|
|
+
|
|
+ if ( defined $ENV{'HA_DEBUGLOG'} and $ENV{'HA_DEBUGLOG'} ne ''
|
|
+ and $ENV{'HA_LOGFILE'} ne $ENV{'HA_DEBUGLOG'}
|
|
+ ) {
|
|
+ # appending to $HA_DEBUGLOG
|
|
+ open my $logfile, '>>', $ENV{'HA_DEBUGLOG'};
|
|
+ printf $logfile "%s: %s %s\n", $ENV{'HA_LOGTAG'}, hadate(),
|
|
+ join (' ', @ARG);
|
|
+ close $logfile;
|
|
+ }
|
|
+}
|
|
+
|
|
+sub ha_log {
|
|
+ return __ha_log( @ARG );
|
|
+}
|
|
+
|
|
+sub ha_debug {
|
|
+
|
|
+ return 0 if defined $ENV{'HA_debug'} and $ENV{'HA_debug'} == 0;
|
|
+
|
|
+ if ( -t STDERR ) {
|
|
+ if ( defined $ENV{'HA_LOGTAG'} and $ENV{'HA_LOGTAG'} ne '' ) {
|
|
+ printf STDERR "%s: %s\n", $ENV{'HA_LOGTAG'}, join ' ', @ARG;
|
|
+ }
|
|
+ else {
|
|
+ printf STDERR "%s\n", join ' ', @ARG;
|
|
+ }
|
|
+
|
|
+ return 0;
|
|
+ }
|
|
+
|
|
+ set_logtag();
|
|
+
|
|
+ if ( defined $ENV{'HA_LOGD'} and $ENV{'HA_LOGD'} eq 'yes' ) {
|
|
+ system 'ha_logger', '-t', $ENV{'HA_LOGTAG'}, '-D', 'ha-debug', @ARG;
|
|
+ return 0 if ( $? >> 8 ) == 0;
|
|
+ }
|
|
+
|
|
+ $ENV{'HA_LOGFACILITY'} = '' if not defined $ENV{'HA_LOGFACILITY'}
|
|
+ or $ENV{'HA_LOGFACILITY'} eq 'none';
|
|
+
|
|
+ unless ( $ENV{'HA_LOGFACILITY'} eq '' ) {
|
|
+ # logging through syslog
|
|
+
|
|
+ system 'logger', '-t', $ENV{'HA_LOGTAG'}, '-p',
|
|
+ "$ENV{'HA_LOGFACILITY'}.debug", @ARG;
|
|
+ }
|
|
+
|
|
+ if ( defined $ENV{'HA_DEBUGLOG'} and -f $ENV{'HA_DEBUGLOG'} ) {
|
|
+ my $logfile;
|
|
+ # appending to $HA_DEBUGLOG
|
|
+ open $logfile, '>>', $ENV{'HA_DEBUGLOG'};
|
|
+ printf $logfile "%s: %s %s\n", $ENV{'HA_LOGTAG'}, hadate(),
|
|
+ join (' ', @ARG);
|
|
+ close $logfile;
|
|
+ }
|
|
+
|
|
+ # appending to stderr
|
|
+ printf STDERR "%s: %s %s\n", $ENV{'HA_LOGTAG'}, hadate(), join ' ', @ARG
|
|
+ if (not defined $ENV{'HA_LOGFACILITY'} or $ENV{'HA_LOGFACILITY'} eq '')
|
|
+ and (not defined $ENV{'HA_DEBUGLOG'} or $ENV{'HA_DEBUGLOG'} eq '' );
|
|
+}
|
|
+
|
|
+#
|
|
+# ocf_log: log messages from the resource agent
|
|
+# This function is slightly different from its equivalent in ocf-shellfuncs.in
|
|
+# as it behaves like printf.
|
|
+# Arguments:
|
|
+# * __OCF_PRIO: log level
|
|
+# * __OCF_MSG: printf-like format string
|
|
+# * all other arguments are values for the printf-like format string
|
|
+#
|
|
+sub ocf_log {
|
|
+ my $__OCF_PRIO;
|
|
+ my $__OCF_MSG;
|
|
+
|
|
+ # TODO: Revisit and implement internally.
|
|
+ if ( scalar @ARG < 2 ) {
|
|
+ ocf_log ( 'err', "Not enough arguments [%d] to ocf_log", scalar @ARG );
|
|
+ }
|
|
+
|
|
+ $__OCF_PRIO = shift;
|
|
+ $__OCF_MSG = shift;
|
|
+ $__OCF_MSG = sprintf $__OCF_MSG, @ARG;
|
|
+
|
|
+ for ( $__OCF_PRIO ) {
|
|
+ if ( /crit/ ) { $__OCF_PRIO = 'CRIT' }
|
|
+ elsif ( /err/ ) { $__OCF_PRIO = 'ERROR' }
|
|
+ elsif ( /warn/ ) { $__OCF_PRIO = 'WARNING' }
|
|
+ elsif ( /info/ ) { $__OCF_PRIO = 'INFO' }
|
|
+ elsif ( /debug/ ) { $__OCF_PRIO = 'DEBUG' }
|
|
+ else { $__OCF_PRIO =~ tr/[a-z]/[A-Z]/ }
|
|
+ }
|
|
+
|
|
+ if ( $__OCF_PRIO eq 'DEBUG' ) {
|
|
+ ha_debug( "$__OCF_PRIO: $__OCF_MSG");
|
|
+ }
|
|
+ else {
|
|
+ ha_log( "$__OCF_PRIO: $__OCF_MSG");
|
|
+ }
|
|
+}
|
|
+
|
|
+
|
|
+#
|
|
+# ocf_exit_reason: print exit error string to stderr and log
|
|
+# Usage: Allows the OCF script to provide a string
|
|
+# describing why the exit code was returned.
|
|
+# Arguments: reason - required, The string that represents
|
|
+# why the error occured.
|
|
+#
|
|
+sub ocf_exit_reason {
|
|
+ my $cookie = $ENV{'OCF_EXIT_REASON_PREFIX'} || 'ocf-exit-reason:';
|
|
+ my $fmt;
|
|
+ my $msg;
|
|
+
|
|
+ # No argument is likely not intentional.
|
|
+ # Just one argument implies a printf format string of just "%s".
|
|
+ # "Least surprise" in case some interpolated string from variable
|
|
+ # expansion or other contains a percent sign.
|
|
+ # More than one argument: first argument is going to be the format string.
|
|
+ ocf_log ( 'err', 'Not enough arguments [%d] to ocf_exit_reason',
|
|
+ scalar @ARG ) if scalar @ARG < 1;
|
|
+
|
|
+ $fmt = shift;
|
|
+ $msg = sprintf $fmt, @ARG;
|
|
+
|
|
+ print STDERR "$cookie$msg\n";
|
|
+ __ha_log( '--ignore-stderr', "ERROR: $msg" );
|
|
+}
|
|
+
|
|
+# returns true if the CRM is currently running a probe. A probe is
|
|
+# defined as a monitor operation with a monitoring interval of zero.
|
|
+sub ocf_is_probe {
|
|
+ return ( $__OCF_ACTION eq 'monitor'
|
|
+ and $ENV{'OCF_RESKEY_CRM_meta_interval'} == 0 );
|
|
+}
|
|
+
|
|
+# returns true if the resource is configured as a clone. This is
|
|
+# defined as a resource where the clone-max meta attribute is present,
|
|
+# and set to greater than zero.
|
|
+sub ocf_is_clone {
|
|
+ return ( defined $ENV{'OCF_RESKEY_CRM_meta_clone_max'}
|
|
+ and $ENV{'OCF_RESKEY_CRM_meta_clone_max'} > 0 );
|
|
+}
|
|
+
|
|
+# returns true if the resource is configured as a multistate
|
|
+# (master/slave) resource. This is defined as a resource where the
|
|
+# master-max meta attribute is present, and set to greater than zero.
|
|
+sub ocf_is_ms {
|
|
+ return ( defined $ENV{'OCF_RESKEY_CRM_meta_master_max'}
|
|
+ and $ENV{'OCF_RESKEY_CRM_meta_master_max'} > 0 );
|
|
+}
|
|
+
|
|
+# version check functions
|
|
+# allow . and - to delimit version numbers
|
|
+# max version number is 999
|
|
+# letters and such are effectively ignored
|
|
+#
|
|
+sub ocf_is_ver {
|
|
+ return $ARG[0] =~ /^[0-9][0-9.-]*[0-9]$/;
|
|
+}
|
|
+
|
|
+sub ocf_ver2num {
|
|
+ my $v = 0;
|
|
+
|
|
+ $v = $v * 1000 + $1 while $ARG[0] =~ /(\d+)/g;
|
|
+
|
|
+ return $v;
|
|
+}
|
|
+
|
|
+sub ocf_ver_level {
|
|
+ my $v = () = $ARG[0] =~ /(\d+)/g;
|
|
+ return $v;
|
|
+}
|
|
+
|
|
+sub ocf_ver_complete_level {
|
|
+ my $ver = shift;
|
|
+ my $level = shift;
|
|
+ my $i = 0;
|
|
+
|
|
+ for ( my $i = 0; $i < $level; $i++ ) {
|
|
+ $ver .= "$ver.0";
|
|
+ }
|
|
+
|
|
+ return $ver;
|
|
+}
|
|
+
|
|
+# usage: ocf_version_cmp VER1 VER2
|
|
+# version strings can contain digits, dots, and dashes
|
|
+# must start and end with a digit
|
|
+# returns:
|
|
+# 0: VER1 smaller (older) than VER2
|
|
+# 1: versions equal
|
|
+# 2: VER1 greater (newer) than VER2
|
|
+# 3: bad format
|
|
+sub ocf_version_cmp {
|
|
+ my $v1 = shift;
|
|
+ my $v2 = shift;
|
|
+ my $v1_level;
|
|
+ my $v2_level;
|
|
+ my $level_diff;
|
|
+
|
|
+ return 3 unless ocf_is_ver( $v1 );
|
|
+ return 3 unless ocf_is_ver( $v2 );
|
|
+
|
|
+ $v1_level = ocf_ver_level( $v1 );
|
|
+ $v2_level = ocf_ver_level( $v2 );
|
|
+
|
|
+ if ( $v1_level < $v2_level ) {
|
|
+ $level_diff = $v2_level - $v1_level;
|
|
+ $v1 = ocf_ver_complete_level( $v1, $level_diff );
|
|
+ }
|
|
+ elsif ( $v1_level > $v2_level ) {
|
|
+ $level_diff = $v1_level - $v2_level;
|
|
+ $v2 = ocf_ver_complete_level( $v2, $level_diff );
|
|
+ }
|
|
+
|
|
+ $v1 = ocf_ver2num( $v1 );
|
|
+ $v2 = ocf_ver2num( $v2 );
|
|
+
|
|
+ if ( $v1 == $v2 ) { return 1; }
|
|
+ elsif ( $v1 < $v2 ) { return 0; }
|
|
+
|
|
+ return 2; # -1 would look funny in shell ;-) ( T.N. not in perl ;) )
|
|
+}
|
|
+
|
|
+sub ocf_local_nodename {
|
|
+ # use crm_node -n for pacemaker > 1.1.8
|
|
+ my $nodename;
|
|
+
|
|
+ qx{ which pacemakerd > /dev/null 2>&1 };
|
|
+ if ( $? == 0 ) {
|
|
+ my $version;
|
|
+ my $ret = qx{ pacemakerd -\$ };
|
|
+
|
|
+ $ret =~ /Pacemaker ([\d.]+)/;
|
|
+ $version = $1;
|
|
+
|
|
+ if ( ocf_version_cmp( $version, '1.1.8' ) == 2 ) {
|
|
+ qx{ which crm_node > /dev/null 2>&1 };
|
|
+ $nodename = qx{ crm_node -n } if $? == 0;
|
|
+ }
|
|
+ }
|
|
+ else {
|
|
+ # otherwise use uname -n
|
|
+ $nodename = qx { uname -n };
|
|
+ }
|
|
+
|
|
+ chomp $nodename;
|
|
+ return $nodename;
|
|
+}
|
|
+
|
|
+# Parse and returns the notify environment variables in a convenient structure
|
|
+# Returns undef if the action is not a notify
|
|
+# Returns undef if the resource is neither a clone or a multistate one
|
|
+sub ocf_notify_env {
|
|
+ my $i;
|
|
+ my %notify_env;
|
|
+
|
|
+ return undef unless $__OCF_ACTION eq 'notify';
|
|
+
|
|
+ return undef unless ocf_is_clone() or ocf_is_ms();
|
|
+
|
|
+ %notify_env = (
|
|
+ 'type' => $ENV{'OCF_RESKEY_CRM_meta_notify_type'} || '',
|
|
+ 'operation' => $ENV{'OCF_RESKEY_CRM_meta_notify_operation'} || '',
|
|
+ 'active' => [ ],
|
|
+ 'inactive' => [ ],
|
|
+ 'start' => [ ],
|
|
+ 'stop' => [ ],
|
|
+ );
|
|
+
|
|
+ for my $action ( qw{ active start stop } ) {
|
|
+ next unless
|
|
+ defined $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_resource"}
|
|
+ and defined $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_uname"};
|
|
+
|
|
+ $i = 0;
|
|
+ $notify_env{ $action }[$i++]{'rsc'} = $_ foreach split /\s+/ =>
|
|
+ $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_resource"};
|
|
+
|
|
+ $i = 0;
|
|
+ $notify_env{ $action }[$i++]{'uname'} = $_ foreach split /\s+/ =>
|
|
+ $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_uname"};
|
|
+ }
|
|
+
|
|
+ # notify_nactive_uname doesn't exists. See:
|
|
+ # http://lists.clusterlabs.org/pipermail/developers/2017-January/000406.html
|
|
+ if ( defined $ENV{"OCF_RESKEY_CRM_meta_notify_inactive_resource"} ) {
|
|
+ $i = 0;
|
|
+ $notify_env{'inactive'}[$i++]{'rsc'} = $_ foreach split /\s+/ =>
|
|
+ $ENV{"OCF_RESKEY_CRM_meta_notify_inactive_resource"};
|
|
+ }
|
|
+
|
|
+ # exit if the resource is not a mutistate one
|
|
+ return %notify_env unless ocf_is_ms();
|
|
+
|
|
+ for my $action ( qw{ master slave promote demote } ) {
|
|
+ $notify_env{ $action } = [ ];
|
|
+
|
|
+ next unless
|
|
+ defined $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_resource"}
|
|
+ and defined $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_uname"};
|
|
+
|
|
+ $i = 0;
|
|
+ $notify_env{ $action }[$i++]{'rsc'} = $_ foreach split /\s+/ =>
|
|
+ $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_resource"};
|
|
+
|
|
+ $i = 0;
|
|
+ $notify_env{ $action }[$i++]{'uname'} = $_ foreach split /\s+/ =>
|
|
+ $ENV{"OCF_RESKEY_CRM_meta_notify_${action}_uname"};
|
|
+ }
|
|
+
|
|
+ # Fix active and inactive fields for Pacemaker version < 1.1.16
|
|
+ # ie. crm_feature_set < 3.0.11
|
|
+ # See http://lists.clusterlabs.org/pipermail/developers/2016-August/000265.html
|
|
+ # and git commit a6713c5d40327eff8549e7f596501ab1785b8765
|
|
+ if (
|
|
+ ocf_version_cmp( $ENV{"OCF_RESKEY_crm_feature_set"}, '3.0.11' ) == 0
|
|
+ ) {
|
|
+ $notify_env{ 'active' } = [
|
|
+ @{ $notify_env{ 'master' } },
|
|
+ @{ $notify_env{ 'slave' } }
|
|
+ ];
|
|
+ }
|
|
+
|
|
+ return %notify_env;
|
|
+}
|
|
+
|
|
+$__OCF_ACTION = $ARGV[0];
|
|
+
|
|
+# Return to sanity for the agents...
|
|
+
|
|
+undef $ENV{'LC_ALL'};
|
|
+$ENV{'LC_ALL'} = 'C';
|
|
+setlocale( LC_ALL, 'C' );
|
|
+undef $ENV{'LANG'};
|
|
+undef $ENV{'LANGUAGE'};
|
|
+
|
|
+$ENV{'OCF_ROOT'} = '/usr/lib/ocf'
|
|
+ unless defined $ENV{'OCF_ROOT'} and $ENV{'OCF_ROOT'} ne '';
|
|
+
|
|
+# old
|
|
+undef $ENV{'OCF_FUNCTIONS_DIR'}
|
|
+ if defined $ENV{'OCF_FUNCTIONS_DIR'}
|
|
+ and $ENV{'OCF_FUNCTIONS_DIR'} eq "$ENV{'OCF_ROOT'}/resource.d/heartbeat";
|
|
+
|
|
+# Define OCF_RESKEY_CRM_meta_interval in case it isn't already set,
|
|
+# to make sure that ocf_is_probe() always works
|
|
+$ENV{'OCF_RESKEY_CRM_meta_interval'} = 0
|
|
+ unless defined $ENV{'OCF_RESKEY_CRM_meta_interval'};
|
|
+
|
|
+# Strip the OCF_RESKEY_ prefix from this particular parameter
|
|
+unless ( defined $ENV{'$OCF_RESKEY_OCF_CHECK_LEVEL'}
|
|
+ and $ENV{'$OCF_RESKEY_OCF_CHECK_LEVEL'} ne ''
|
|
+) {
|
|
+ $ENV{'OCF_CHECK_LEVEL'} = $ENV{'$OCF_RESKEY_OCF_CHECK_LEVEL'};
|
|
+}
|
|
+else {
|
|
+ ENV{'OCF_CHECK_LEVEL'} = 0;
|
|
+}
|
|
+
|
|
+unless ( -d $ENV{'OCF_ROOT'} ) {
|
|
+ ha_log( "ERROR: OCF_ROOT points to non-directory $ENV{'OCF_ROOT'}." );
|
|
+ $! = $OCF_ERR_GENERIC;
|
|
+ die;
|
|
+}
|
|
+
|
|
+$ENV{'OCF_RESOURCE_TYPE'} = $__SCRIPT_NAME
|
|
+ unless defined $ENV{'OCF_RESOURCE_TYPE'}
|
|
+ and $ENV{'OCF_RESOURCE_TYPE'} ne '';
|
|
+
|
|
+unless ( defined $ENV{'OCF_RA_VERSION_MAJOR'}
|
|
+ and $ENV{'OCF_RA_VERSION_MAJOR'} ne ''
|
|
+) {
|
|
+ # We are being invoked as an init script.
|
|
+ # Fill in some things with reasonable values.
|
|
+ $ENV{'OCF_RESOURCE_INSTANCE'} = 'default';
|
|
+ return 1;
|
|
+}
|
|
+
|
|
+$ENV{'OCF_RESOURCE_INSTANCE'} = "undef" if $__OCF_ACTION eq 'meta-data';
|
|
+
|
|
+unless ( defined $ENV{'OCF_RESOURCE_INSTANCE'}
|
|
+ and $ENV{'OCF_RESOURCE_INSTANCE'} ne ''
|
|
+) {
|
|
+ ha_log( "ERROR: Need to tell us our resource instance name." );
|
|
+ $! = $OCF_ERR_ARGS;
|
|
+ die;
|
|
+}
|
|
+
|
|
+1;
|
|
+
|
|
+
|
|
+=head1 COPYRIGHT AND LICENSE
|
|
+
|
|
+Copyright (C) 2016: Jehan-Guillaume de Rorthais and Mael Rimbault.
|
|
+
|
|
+Licensed under the PostgreSQL License.
|
|
diff --color -uNr a/heartbeat/OCF_ReturnCodes.pm b/heartbeat/OCF_ReturnCodes.pm
|
|
--- a/heartbeat/OCF_ReturnCodes.pm 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/heartbeat/OCF_ReturnCodes.pm 2021-04-13 13:37:35.621267404 +0200
|
|
@@ -0,0 +1,97 @@
|
|
+#!/usr/bin/perl
|
|
+# This program is open source, licensed under the PostgreSQL License.
|
|
+# For license terms, see the LICENSE file.
|
|
+#
|
|
+# Copyright (C) 2016-2020: Jehan-Guillaume de Rorthais and Mael Rimbault
|
|
+
|
|
+=head1 NAME
|
|
+
|
|
+OCF_ReturnCodes - Common varibales for the OCF Resource Agents supplied by
|
|
+heartbeat.
|
|
+
|
|
+=head1 SYNOPSIS
|
|
+
|
|
+ use FindBin;
|
|
+ use lib "$FindBin::RealBin/../../lib/heartbeat/";
|
|
+
|
|
+ use OCF_ReturnCodes;
|
|
+
|
|
+=head1 DESCRIPTION
|
|
+
|
|
+This module has been ported from the ocf-retrurncodes shell script of the
|
|
+resource-agents project. See L<https://github.com/ClusterLabs/resource-agents/>.
|
|
+
|
|
+=head1 VARIABLES
|
|
+
|
|
+Here are the variables exported by this module:
|
|
+
|
|
+=over
|
|
+
|
|
+=item $OCF_SUCCESS
|
|
+
|
|
+=item $OCF_ERR_GENERIC
|
|
+
|
|
+=item $OCF_ERR_ARGS
|
|
+
|
|
+=item $OCF_ERR_UNIMPLEMENTED
|
|
+
|
|
+=item $OCF_ERR_PERM
|
|
+
|
|
+=item $OCF_ERR_INSTALLED
|
|
+
|
|
+=item $OCF_ERR_CONFIGURED
|
|
+
|
|
+=item $OCF_NOT_RUNNING
|
|
+
|
|
+=item $OCF_RUNNING_MASTER
|
|
+
|
|
+=item $OCF_FAILED_MASTER
|
|
+
|
|
+=back
|
|
+
|
|
+=cut
|
|
+
|
|
+package OCF_ReturnCodes;
|
|
+
|
|
+use strict;
|
|
+use warnings;
|
|
+use 5.008;
|
|
+
|
|
+BEGIN {
|
|
+ use Exporter;
|
|
+
|
|
+ our $VERSION = 'v2.3.0';
|
|
+ our @ISA = ('Exporter');
|
|
+ our @EXPORT = qw(
|
|
+ $OCF_SUCCESS
|
|
+ $OCF_ERR_GENERIC
|
|
+ $OCF_ERR_ARGS
|
|
+ $OCF_ERR_UNIMPLEMENTED
|
|
+ $OCF_ERR_PERM
|
|
+ $OCF_ERR_INSTALLED
|
|
+ $OCF_ERR_CONFIGURED
|
|
+ $OCF_NOT_RUNNING
|
|
+ $OCF_RUNNING_MASTER
|
|
+ $OCF_FAILED_MASTER
|
|
+ );
|
|
+ our @EXPORT_OK = ( @EXPORT );
|
|
+}
|
|
+
|
|
+our $OCF_SUCCESS = 0;
|
|
+our $OCF_ERR_GENERIC = 1;
|
|
+our $OCF_ERR_ARGS = 2;
|
|
+our $OCF_ERR_UNIMPLEMENTED = 3;
|
|
+our $OCF_ERR_PERM = 4;
|
|
+our $OCF_ERR_INSTALLED = 5;
|
|
+our $OCF_ERR_CONFIGURED = 6;
|
|
+our $OCF_NOT_RUNNING = 7;
|
|
+our $OCF_RUNNING_MASTER = 8;
|
|
+our $OCF_FAILED_MASTER = 9;
|
|
+
|
|
+1;
|
|
+
|
|
+=head1 COPYRIGHT AND LICENSE
|
|
+
|
|
+Copyright (C) 2016: Jehan-Guillaume de Rorthais and Mael Rimbault.
|
|
+
|
|
+Licensed under the PostgreSQL License.
|
|
diff --color -uNr a/heartbeat/pgsqlms b/heartbeat/pgsqlms
|
|
--- a/heartbeat/pgsqlms 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/heartbeat/pgsqlms 2021-04-13 13:37:40.934280411 +0200
|
|
@@ -0,0 +1,2308 @@
|
|
+#!/usr/bin/perl
|
|
+# This program is open source, licensed under the PostgreSQL License.
|
|
+# For license terms, see the LICENSE file.
|
|
+#
|
|
+# Copyright (C) 2016-2020: Jehan-Guillaume de Rorthais and Mael Rimbault
|
|
+
|
|
+=head1 NAME
|
|
+
|
|
+ocf_heartbeat_pgsqlms - A PostgreSQL multi-state resource agent for Pacemaker
|
|
+
|
|
+=head1 SYNOPSIS
|
|
+
|
|
+B<pgsqlms> [start | stop | monitor | promote | demote | notify | reload | methods | meta-data | validate-all]
|
|
+
|
|
+=head1 DESCRIPTION
|
|
+
|
|
+Resource script for PostgreSQL in replication. It manages PostgreSQL servers using streaming replication as an HA resource.
|
|
+
|
|
+=cut
|
|
+
|
|
+use strict;
|
|
+use warnings;
|
|
+use 5.008;
|
|
+
|
|
+use POSIX qw(locale_h);
|
|
+use Scalar::Util qw(looks_like_number);
|
|
+use File::Spec;
|
|
+use File::Temp;
|
|
+use Data::Dumper;
|
|
+
|
|
+my $OCF_FUNCTIONS_DIR;
|
|
+BEGIN {
|
|
+ $OCF_FUNCTIONS_DIR = defined $ENV{'OCF_FUNCTIONS_DIR'} ? "$ENV{'OCF_FUNCTIONS_DIR'}" : "$ENV{'OCF_ROOT'}/lib/heartbeat";
|
|
+}
|
|
+use lib "$OCF_FUNCTIONS_DIR";
|
|
+
|
|
+use OCF_ReturnCodes;
|
|
+use OCF_Directories;
|
|
+use OCF_Functions;
|
|
+
|
|
+our $VERSION = 'v2.3.0';
|
|
+our $PROGRAM = 'pgsqlms';
|
|
+
|
|
+# OCF environment
|
|
+my $OCF_RESOURCE_INSTANCE = $ENV{'OCF_RESOURCE_INSTANCE'};
|
|
+my $OCF_RUNNING_SLAVE = $OCF_SUCCESS;
|
|
+my %OCF_NOTIFY_ENV = ocf_notify_env() if $__OCF_ACTION eq 'notify';
|
|
+
|
|
+# Default parameters values
|
|
+my $system_user_default = "postgres";
|
|
+my $bindir_default = "/usr/bin";
|
|
+my $pgdata_default = "/var/lib/pgsql/data";
|
|
+my $pghost_default = "/tmp";
|
|
+my $pgport_default = 5432;
|
|
+my $start_opts_default = "";
|
|
+my $maxlag_default = "0";
|
|
+
|
|
+# Set default values if not found in environment
|
|
+my $system_user = $ENV{'OCF_RESKEY_system_user'} || $system_user_default;
|
|
+my $bindir = $ENV{'OCF_RESKEY_bindir'} || $bindir_default;
|
|
+my $pgdata = $ENV{'OCF_RESKEY_pgdata'} || $pgdata_default;
|
|
+my $datadir = $ENV{'OCF_RESKEY_datadir'} || $pgdata;
|
|
+my $pghost = $ENV{'OCF_RESKEY_pghost'} || $pghost_default;
|
|
+my $pgport = $ENV{'OCF_RESKEY_pgport'} || $pgport_default;
|
|
+my $start_opts = $ENV{'OCF_RESKEY_start_opts'} || $start_opts_default;
|
|
+my $maxlag = $ENV{'OCF_RESKEY_maxlag'} || $maxlag_default;
|
|
+my $recovery_tpl = $ENV{'OCF_RESKEY_recovery_template'}
|
|
+ || "$pgdata/recovery.conf.pcmk";
|
|
+
|
|
+
|
|
+# PostgreSQL commands path
|
|
+my $POSTGRES = "$bindir/postgres";
|
|
+my $PGCTL = "$bindir/pg_ctl";
|
|
+my $PGPSQL = "$bindir/psql";
|
|
+my $PGCTRLDATA = "$bindir/pg_controldata";
|
|
+my $PGISREADY = "$bindir/pg_isready";
|
|
+my $PGWALDUMP = "$bindir/pg_waldump";
|
|
+
|
|
+# pacemaker commands path
|
|
+my $CRM_MASTER = "$HA_SBIN_DIR/crm_master --lifetime forever";
|
|
+my $CRM_NODE = "$HA_SBIN_DIR/crm_node";
|
|
+my $CRM_RESOURCE = "$HA_SBIN_DIR/crm_resource";
|
|
+my $ATTRD_PRIV = "$HA_SBIN_DIR/attrd_updater --private --lifetime reboot";
|
|
+
|
|
+# Global vars
|
|
+my $nodename;
|
|
+my $exit_code = 0;
|
|
+# numeric pgsql versions
|
|
+my $PGVERNUM;
|
|
+my $PGVER_93 = 90300;
|
|
+my $PGVER_10 = 100000;
|
|
+my $PGVER_12 = 120000;
|
|
+
|
|
+# Run a query using psql.
|
|
+#
|
|
+# This function returns an array with psql return code as first element and
|
|
+# the result as second one.
|
|
+#
|
|
+sub _query {
|
|
+ my $query = shift;
|
|
+ my $res = shift;
|
|
+ my $connstr = "dbname=postgres";
|
|
+ my $RS = chr(30); # ASCII RS (record separator)
|
|
+ my $FS = chr(3); # ASCII ETX (end of text)
|
|
+ my $postgres_uid = getpwnam( $system_user );
|
|
+ my $oldeuid = $>;
|
|
+ my $tmpfile;
|
|
+ my @res;
|
|
+ my $ans;
|
|
+ my $pid;
|
|
+ my $rc;
|
|
+
|
|
+ unless ( defined $res and defined $query and $query ne '' ) {
|
|
+ ocf_log( 'debug', '_query: wrong parameters!' );
|
|
+ return -1;
|
|
+ }
|
|
+
|
|
+ unless ( $tmpfile = File::Temp->new(
|
|
+ TEMPLATE => 'pgsqlms-XXXXXXXX',
|
|
+ DIR => $HA_RSCTMP
|
|
+ ) )
|
|
+ {
|
|
+ ocf_exit_reason( 'Could not create or write in a temp file' );
|
|
+ exit $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ print $tmpfile $query;
|
|
+ chmod 0644, $tmpfile;
|
|
+
|
|
+ ocf_log( 'debug', '_query: %s', $query );
|
|
+
|
|
+ # Change the effective user to the given system_user so after forking
|
|
+ # the given uid to the process should allow psql to connect w/o password
|
|
+ $> = $postgres_uid;
|
|
+
|
|
+ # Forking + piping
|
|
+ $pid = open(my $KID, "-|");
|
|
+
|
|
+ if ( $pid == 0 ) { # child
|
|
+ exec $PGPSQL, '--set', 'ON_ERROR_STOP=1', '-qXAtf', $tmpfile,
|
|
+ '-R', $RS, '-F', $FS, '--port', $pgport, '--host', $pghost,
|
|
+ $connstr;
|
|
+ }
|
|
+
|
|
+ # parent
|
|
+ $> = $oldeuid;
|
|
+
|
|
+ {
|
|
+ local $/;
|
|
+ $ans = <$KID>;
|
|
+ }
|
|
+
|
|
+ close $KID;
|
|
+ $rc = $? >> 8;
|
|
+
|
|
+ ocf_log( 'debug', '_query: psql return code: %d', $rc );
|
|
+
|
|
+ if ( defined $ans ) {
|
|
+ chop $ans;
|
|
+
|
|
+ push @{ $res }, [ split(chr(3) => $_, -1) ]
|
|
+ foreach split (chr(30) => $ans, -1);
|
|
+
|
|
+ ocf_log( 'debug', '_query: @res: %s',
|
|
+ Data::Dumper->new( [ $res ] )->Terse(1)->Dump );
|
|
+ }
|
|
+
|
|
+ # Possible return codes:
|
|
+ # -1: wrong parameters
|
|
+ # 0: OK
|
|
+ # 1: failed to get resources (memory, missing file, ...)
|
|
+ # 2: unable to connect
|
|
+ # 3: query failed
|
|
+ return $rc;
|
|
+}
|
|
+
|
|
+# Get the last received location on a standby
|
|
+# if the first argument is true, returns the value as decimal
|
|
+# if the first argument is false, returns the value as LSN
|
|
+# Returns undef if query failed
|
|
+sub _get_last_received_lsn {
|
|
+ my ( $dec ) = @_;
|
|
+ my $pg_last_wal_receive_lsn = 'pg_last_wal_receive_lsn()';
|
|
+ my $pg_wal_lsn_diff = 'pg_wal_lsn_diff';
|
|
+ my $query;
|
|
+ my $rc;
|
|
+ my @rs;
|
|
+
|
|
+ if ( $PGVERNUM < $PGVER_10 ) {
|
|
+ $pg_last_wal_receive_lsn = 'pg_last_xlog_receive_location()';
|
|
+ $pg_wal_lsn_diff = 'pg_xlog_location_diff';
|
|
+ }
|
|
+
|
|
+ if ( $dec ) {
|
|
+ $query = "SELECT $pg_wal_lsn_diff( $pg_last_wal_receive_lsn, '0/0' )";
|
|
+ }
|
|
+ else {
|
|
+ $query = "SELECT $pg_last_wal_receive_lsn";
|
|
+ }
|
|
+
|
|
+ $rc = _query( $query, \@rs );
|
|
+
|
|
+ return $rs[0][0] if $rc == 0 and $rs[0][0];
|
|
+
|
|
+ ocf_log( 'err', 'Could not query last received LSN (%s)', $rc ) if $rc != 0;
|
|
+ ocf_log( 'err', 'No values for last received LSN' )
|
|
+ if $rc == 0 and not $rs[0][0];
|
|
+
|
|
+ return undef;
|
|
+}
|
|
+
|
|
+# Get the master score for each connected standby
|
|
+# Returns directly the result set of the query or exit with an error.
|
|
+# Exits with OCF_ERR_GENERIC if the query failed
|
|
+sub _get_lag_scores {
|
|
+ my $pg_current_wal_lsn = 'pg_current_wal_lsn()';
|
|
+ my $pg_wal_lsn_diff = 'pg_wal_lsn_diff';
|
|
+ my $write_lsn = 'write_lsn';
|
|
+ my $query;
|
|
+ my $rc;
|
|
+ my @rs;
|
|
+
|
|
+ if ( $PGVERNUM < $PGVER_10 ) {
|
|
+ $pg_current_wal_lsn = 'pg_current_xlog_location()';
|
|
+ $pg_wal_lsn_diff = 'pg_xlog_location_diff';
|
|
+ $write_lsn = 'write_location';
|
|
+ }
|
|
+
|
|
+ # We check locations of connected standbies by querying the
|
|
+ # "pg_stat_replication" view.
|
|
+ # The row_number applies on the result set ordered on write_location ASC so
|
|
+ # the highest row_number should be given to the closest node from the
|
|
+ # master, then the lowest node name (alphanumeric sort) in case of equality.
|
|
+ # The result set itself is order by priority DESC to process best known
|
|
+ # candidate first.
|
|
+ $query = qq{
|
|
+ SELECT application_name, priority, location, state, current_lag
|
|
+ FROM (
|
|
+ SELECT application_name,
|
|
+ (1000 - (
|
|
+ row_number() OVER (
|
|
+ PARTITION BY state IN ('startup', 'backup')
|
|
+ ORDER BY location ASC, application_name ASC
|
|
+ ) - 1
|
|
+ ) * 10
|
|
+ ) * CASE WHEN ( $maxlag > 0
|
|
+ AND current_lag > $maxlag)
|
|
+ THEN -1
|
|
+ ELSE 1
|
|
+ END AS priority,
|
|
+ location, state, current_lag
|
|
+ FROM (
|
|
+ SELECT application_name, $write_lsn AS location, state,
|
|
+ $pg_wal_lsn_diff($pg_current_wal_lsn, $write_lsn) AS current_lag
|
|
+ FROM pg_stat_replication
|
|
+ ) AS s2
|
|
+ ) AS s1
|
|
+ ORDER BY priority DESC
|
|
+ };
|
|
+
|
|
+ $rc = _query( $query, \@rs );
|
|
+
|
|
+ if ( $rc != 0 ) {
|
|
+ ocf_exit_reason( 'Query to get standby locations failed (%d)', $rc );
|
|
+ exit $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ return \@rs;
|
|
+}
|
|
+
|
|
+# get the timeout for the current action given from environment var
|
|
+# Returns timeout as integer
|
|
+# undef if unknown
|
|
+sub _get_action_timeout {
|
|
+ my $timeout = $ENV{'OCF_RESKEY_CRM_meta_timeout'} / 1000;
|
|
+
|
|
+ ocf_log( 'debug', '_get_action_timeout: known timeout: %s',
|
|
+ defined $timeout ? $timeout : 'undef' );
|
|
+
|
|
+ return $timeout if defined $timeout and $timeout =~ /^\d+$/;
|
|
+
|
|
+ return undef;
|
|
+}
|
|
+
|
|
+# Get, parse and return the value of the given private attribute name
|
|
+# Returns an empty string if not found.
|
|
+sub _get_priv_attr {
|
|
+ my ( $name, $node ) = @_;
|
|
+ my $val = '';
|
|
+ my $node_arg = '';
|
|
+ my $ans;
|
|
+
|
|
+ $node = '' unless defined $node;
|
|
+ $name = "$name-$OCF_RESOURCE_INSTANCE";
|
|
+
|
|
+ $node_arg= "--node $node" if $node ne '';
|
|
+
|
|
+ $ans = qx{ $ATTRD_PRIV --name "$name" --query $node_arg };
|
|
+
|
|
+ $ans =~ m/^name=".*" host=".*" value="(.*)"$/;
|
|
+
|
|
+ $val = $1 if defined $1;
|
|
+
|
|
+ ocf_log( 'debug', '_get_priv_attr: value of "%s"%s is "%s"', $name,
|
|
+ ( $node ? " on \"$node\"": ""),
|
|
+ $val );
|
|
+
|
|
+ return $val;
|
|
+}
|
|
+
|
|
+# Set the given private attribute name to the given value
|
|
+# As setting an attribute is asynchronous, this will return as soon as the
|
|
+# attribute is really set by attrd and available.
|
|
+sub _set_priv_attr {
|
|
+ my ( $name, $val ) = @_;
|
|
+ my $name_instance = "$name-$OCF_RESOURCE_INSTANCE";
|
|
+
|
|
+ ocf_log( 'debug', '_set_priv_attr: set "%s=%s"...', $name_instance, $val );
|
|
+
|
|
+ qx{ $ATTRD_PRIV --name "$name_instance" --update "$val" };
|
|
+
|
|
+ # give attr name without the resource instance name as _get_priv_attr adds
|
|
+ # it as well
|
|
+ while ( _get_priv_attr( $name ) ne $val ) {
|
|
+ ocf_log( 'debug', '_set_priv_attr: waiting attrd ack for "%s"...', $name_instance );
|
|
+ select( undef, undef, undef, 0.1 );
|
|
+ }
|
|
+
|
|
+ return;
|
|
+}
|
|
+
|
|
+# Delete the given private attribute.
|
|
+# As setting an attribute is asynchronous, this will return as soon as the
|
|
+# attribute is really deleted by attrd.
|
|
+sub _delete_priv_attr {
|
|
+ my ( $name ) = @_;
|
|
+ my $name_instance = "$name-$OCF_RESOURCE_INSTANCE";
|
|
+
|
|
+ ocf_log( 'debug', '_delete_priv_attr: delete "%s"...', $name_instance );
|
|
+
|
|
+ qx{ $ATTRD_PRIV --name "$name_instance" --delete };
|
|
+
|
|
+ # give attr name without the resource instance name as _get_priv_attr adds
|
|
+ # it as well
|
|
+ while ( _get_priv_attr( $name ) ne '' ) {
|
|
+ ocf_log( 'debug', '_delete_priv_attr: waiting attrd ack for "%s"...',
|
|
+ $name_instance );
|
|
+ select( undef, undef, undef, 0.1 );
|
|
+ }
|
|
+
|
|
+ return;
|
|
+}
|
|
+
|
|
+# Get, parse and return the resource master score on given node.
|
|
+# Returns an empty string if not found.
|
|
+# Returns undef on crm_master call on error
|
|
+sub _get_master_score {
|
|
+ my ( $node ) = @_;
|
|
+ my $node_arg = '';
|
|
+ my $score;
|
|
+
|
|
+ $node_arg = sprintf '--node "%s"', $node if defined $node and $node ne '';
|
|
+
|
|
+ $score = qx{ $CRM_MASTER --quiet --get-value $node_arg 2> /dev/null };
|
|
+
|
|
+ return '' unless $? == 0 and defined $score;
|
|
+
|
|
+ chomp $score;
|
|
+
|
|
+ return $score;
|
|
+}
|
|
+
|
|
+# Set the master score of the local node or the optionally given node.
|
|
+# As setting an attribute is asynchronous, this will return as soon as the
|
|
+# attribute is really set by attrd and available everywhere.
|
|
+sub _set_master_score {
|
|
+ my ( $score, $node ) = @_;
|
|
+ my $node_arg = '';
|
|
+ my $tmp;
|
|
+
|
|
+ $node_arg = sprintf '--node "%s"', $node if defined $node and $node ne '';
|
|
+
|
|
+ qx{ $CRM_MASTER $node_arg --quiet --update "$score" };
|
|
+
|
|
+ while ( ( $tmp = _get_master_score( $node ) ) ne $score ) {
|
|
+ ocf_log( 'debug',
|
|
+ '_set_master_score: waiting to set score to "%s" (currently "%s")...',
|
|
+ $score, $tmp );
|
|
+ select(undef, undef, undef, 0.1);
|
|
+ }
|
|
+
|
|
+ return;
|
|
+}
|
|
+
|
|
+# _master_score_exists
|
|
+# This subroutine checks if a master score is set for one of the relative clones
|
|
+# in the cluster and the score is greater or equal of 0.
|
|
+# Returns 1 if at least one master score >= 0 is found.
|
|
+# Returns 0 otherwise
|
|
+sub _master_score_exists {
|
|
+ my @partition_nodes = split /\s+/ => qx{ $CRM_NODE --partition };
|
|
+
|
|
+ foreach my $node ( @partition_nodes ) {
|
|
+ my $score = _get_master_score( $node );
|
|
+
|
|
+ return 1 if defined $score and $score ne '' and $score > -1;
|
|
+ }
|
|
+
|
|
+ return 0;
|
|
+}
|
|
+
|
|
+# Check if the current transiation is a recover of a master clone on given node.
|
|
+sub _is_master_recover {
|
|
+ my ( $n ) = @_;
|
|
+
|
|
+ return (
|
|
+ scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'master'} }
|
|
+ and scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'promote'} }
|
|
+ );
|
|
+}
|
|
+
|
|
+# Check if the current transition is a recover of a slave clone on given node.
|
|
+sub _is_slave_recover {
|
|
+ my ( $n ) = @_;
|
|
+
|
|
+ return (
|
|
+ scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'slave'} }
|
|
+ and scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'start'} }
|
|
+ );
|
|
+}
|
|
+
|
|
+# check if th current transition is a switchover to the given node.
|
|
+sub _is_switchover {
|
|
+ my ( $n ) = @_;
|
|
+ my $old = $OCF_NOTIFY_ENV{'master'}[0]{'uname'};
|
|
+
|
|
+ return 0 if scalar @{ $OCF_NOTIFY_ENV{'master'} } != 1
|
|
+ or scalar @{ $OCF_NOTIFY_ENV{'demote'} } != 1
|
|
+ or scalar @{ $OCF_NOTIFY_ENV{'promote'} } != 1;
|
|
+
|
|
+ return (
|
|
+ scalar grep { $_->{'uname'} eq $old } @{ $OCF_NOTIFY_ENV{'demote'} }
|
|
+ and scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'slave'} }
|
|
+ and scalar grep { $_->{'uname'} eq $n } @{ $OCF_NOTIFY_ENV{'promote'} }
|
|
+ and not scalar grep { $_->{'uname'} eq $old } @{ $OCF_NOTIFY_ENV{'stop'} }
|
|
+ );
|
|
+}
|
|
+
|
|
+# Run the given command as the "system_user" given as parameter.
|
|
+# It basically forks and seteuid/setuid away from root.
|
|
+#
|
|
+sub _runas {
|
|
+ my $rc;
|
|
+ my $pid;
|
|
+ my @cmd = @_;
|
|
+ my (undef, undef, $postgres_uid, $postgres_gid ) = getpwnam( $system_user );
|
|
+
|
|
+ $pid = fork;
|
|
+
|
|
+ if ( $pid == 0 ) { # in child
|
|
+ $) = "$postgres_gid $postgres_gid";
|
|
+ while ( my ( undef, undef, $gid, $members ) = getgrent ) {
|
|
+ $) .= " $gid" if grep { $system_user eq $_ } split /\s+/, $members
|
|
+ }
|
|
+ $( = $postgres_gid;
|
|
+
|
|
+ $< = $> = $postgres_uid;
|
|
+
|
|
+ exec @cmd;
|
|
+ }
|
|
+
|
|
+ ocf_log( 'debug', '_runas: launching as "%s" command "%s"', $system_user,
|
|
+ join(' ', @cmd) );
|
|
+
|
|
+ waitpid $pid, 0;
|
|
+ $rc = $? >> 8;
|
|
+
|
|
+ return $rc;
|
|
+}
|
|
+
|
|
+# Check if instance is listening on the given host/port.
|
|
+#
|
|
+sub _pg_isready {
|
|
+ # Add 60s to the timeout or use a 24h timeout fallback to make sure
|
|
+ # Pacemaker will give up before us and take decisions
|
|
+ my $timeout = ( _get_action_timeout() || 60*60*24 ) + 60;
|
|
+ my $rc = _runas( $PGISREADY, '-h', $pghost, '-p', $pgport, '-d', 'postgres', '-t', $timeout );
|
|
+
|
|
+ # Possible error codes:
|
|
+ # 1: ping rejected (usually when instance is in startup, in crash
|
|
+ # recovery, in warm standby, or when a shutdown is in progress)
|
|
+ # 2: no response, usually means the instance is down
|
|
+ # 3: no attempt, probably a syntax error, should not happen
|
|
+ return $rc;
|
|
+}
|
|
+
|
|
+# Check the postmaster.pid file and the postmaster process.
|
|
+# WARNING: we do not distinguish the scenario where postmaster.pid does not
|
|
+# exist from the scenario where the process is still alive. It should be ok
|
|
+# though, as this is considered a hard error from monitor.
|
|
+#
|
|
+sub _pg_ctl_status {
|
|
+ my $rc = _runas( $PGCTL, '--pgdata', $pgdata, 'status' );
|
|
+
|
|
+ # Possible error codes:
|
|
+ # 3: postmaster.pid file does not exist OR it does but the process
|
|
+ # with the PID found in the file is not alive
|
|
+ return $rc;
|
|
+}
|
|
+
|
|
+# Start the local instance using pg_ctl
|
|
+#
|
|
+sub _pg_ctl_start {
|
|
+ # Add 60s to the timeout or use a 24h timeout fallback to make sure
|
|
+ # Pacemaker will give up before us and take decisions
|
|
+ my $timeout = ( _get_action_timeout() || 60*60*24 ) + 60;
|
|
+
|
|
+ my @cmd = ( $PGCTL, '--pgdata', $pgdata, '-w', '--timeout', $timeout, 'start' );
|
|
+
|
|
+ push @cmd => ( '-o', $start_opts ) if $start_opts ne '';
|
|
+
|
|
+ return _runas( @cmd );
|
|
+}
|
|
+
|
|
+# Enable the Standby mode.
|
|
+#
|
|
+# Up to v11, creates the recovery.conf file based on the given template.
|
|
+# Since v12, creates standby.signal.
|
|
+sub _enable_recovery {
|
|
+ my $fh;
|
|
+ my $content = '';
|
|
+ my $standby_file = "$datadir/standby.signal";
|
|
+ my (undef, undef, $uid, $gid) = getpwnam($system_user);
|
|
+
|
|
+ if ( $PGVERNUM < $PGVER_12 ) {
|
|
+ $standby_file = "$datadir/recovery.conf";
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ '_enable_recovery: get replication configuration from the template file "%s"',
|
|
+ $recovery_tpl );
|
|
+
|
|
+ # Create the recovery.conf file to start the instance as a secondary.
|
|
+ # NOTE: the recovery.conf is supposed to be set up so the secondary can
|
|
+ # connect to the primary instance, eg. using a virtual IP address.
|
|
+ # As there is no primary instance available at startup, secondaries will
|
|
+ # complain about failing to connect.
|
|
+ # As we can not reload a recovery.conf file on a standby without restarting
|
|
+ # it, we will leave with this.
|
|
+ # FIXME how would the reload help us in this case ?
|
|
+ unless ( defined open( $fh, '<', $recovery_tpl ) ) {
|
|
+ ocf_exit_reason( 'Could not open file "%s": %s', $recovery_tpl, $! );
|
|
+ exit $OCF_ERR_CONFIGURED;
|
|
+ }
|
|
+
|
|
+ # Copy all parameters from the template file
|
|
+ while (my $line = <$fh>) {
|
|
+ chomp $line;
|
|
+ $content .= "$line\n";
|
|
+ }
|
|
+ close $fh;
|
|
+ }
|
|
+
|
|
+ ocf_log( 'debug', '_enable_recovery: write the standby file "%s"', $standby_file );
|
|
+
|
|
+ unless ( open( $fh, '>', $standby_file ) ) {
|
|
+ ocf_exit_reason( 'Could not open file "%s": %s', $standby_file, $! );
|
|
+ exit $OCF_ERR_CONFIGURED;
|
|
+ }
|
|
+
|
|
+ # Write the recovery.conf file using configuration from the template file
|
|
+ print $fh $content;
|
|
+
|
|
+ close $fh;
|
|
+
|
|
+ unless ( chown $uid, $gid, $standby_file ) {
|
|
+ ocf_exit_reason( 'Could not set owner of "%s"', $standby_file );
|
|
+ exit $OCF_ERR_CONFIGURED;
|
|
+ };
|
|
+}
|
|
+
|
|
+# Parse and return various informations about the local PostgreSQL instance as
|
|
+# reported by its controldata file.
|
|
+#
|
|
+# WARNING: the status is NOT updated in case of crash.
|
|
+#
|
|
+# This sub exit the script with an error on failure
|
|
+sub _get_controldata {
|
|
+ my %controldata;
|
|
+ my $ans;
|
|
+
|
|
+ $ans = qx{ $PGCTRLDATA "$datadir" 2>/dev/null };
|
|
+
|
|
+ # Parse the output of pg_controldata.
|
|
+ # This output is quite stable between pg versions, but we might need to sort
|
|
+ # it at some point if things are moving in there...
|
|
+ $ans =~ m{
|
|
+ # get the current state
|
|
+ ^\QDatabase cluster state\E:\s+(.*?)\s*$
|
|
+ .*
|
|
+ # Get the latest known REDO location
|
|
+ ^\QLatest checkpoint's REDO location\E:\s+([/0-9A-F]+)\s*$
|
|
+ .*
|
|
+ # Get the latest known TL
|
|
+ ^\QLatest checkpoint's TimeLineID\E:\s+(\d+)\s*$
|
|
+ .*
|
|
+ # Get the wal level
|
|
+ # NOTE: pg_controldata output changed with PostgreSQL 9.5, so we need to
|
|
+ # account for both syntaxes
|
|
+ ^(?:\QCurrent \E)?\Qwal_level setting\E:\s+(.*?)\s*$
|
|
+ }smx;
|
|
+
|
|
+ $controldata{'state'} = $1 if defined $1;
|
|
+ $controldata{'redo'} = $2 if defined $2;
|
|
+ $controldata{'tl'} = $3 if defined $3;
|
|
+ $controldata{'wal_level'} = $4 if defined $4;
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ "_get_controldata: found: %s",
|
|
+ Data::Dumper->new( [ \%controldata ] )->Terse(1)->Dump );
|
|
+
|
|
+ return %controldata if defined $controldata{'state'}
|
|
+ and defined $controldata{'tl'}
|
|
+ and defined $controldata{'redo'}
|
|
+ and defined $controldata{'wal_level'};
|
|
+
|
|
+ ocf_exit_reason( 'Could not read all datas from controldata file for "%s"',
|
|
+ $datadir );
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ "_get_controldata: controldata file: %s",
|
|
+ Data::Dumper->new( [ \%controldata ] )->Terse(1)->Dump, $ans );
|
|
+
|
|
+ exit $OCF_ERR_ARGS;
|
|
+}
|
|
+
|
|
+# Pead major version from datadir/PG_VERSION and return it as numeric version
|
|
+sub _get_pg_version {
|
|
+ my $fh;
|
|
+ my $PGVERSION;
|
|
+ my $PGVERNUM;
|
|
+
|
|
+ # check PG_VERSION
|
|
+ if ( ! -s "$datadir/PG_VERSION" ) {
|
|
+ ocf_exit_reason( 'PG_VERSION does not exist in "%s"', $datadir );
|
|
+ exit $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ unless ( open( $fh, '<', "$datadir/PG_VERSION" ) ) {
|
|
+ ocf_exit_reason( "Could not open file \"$datadir/PG_VERSION\": $!" );
|
|
+ exit $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ read( $fh, $PGVERSION, 32 );
|
|
+ close $fh;
|
|
+
|
|
+ chomp $PGVERSION;
|
|
+
|
|
+ $PGVERSION =~ /^(\d+)(?:\.(\d+))?$/;
|
|
+ $PGVERNUM = $1 * 10000;
|
|
+ $PGVERNUM += $2 * 100 if $1 < 10; # no 2nd num in the major version from v10
|
|
+
|
|
+ return $PGVERNUM;
|
|
+}
|
|
+
|
|
+# Use pg_controldata to check the state of the PostgreSQL server. This
|
|
+# function returns codes depending on this state, so we can find whether the
|
|
+# instance is a primary or a secondary, or use it to detect any inconsistency
|
|
+# that could indicate the instance has crashed.
|
|
+#
|
|
+sub _controldata_to_ocf {
|
|
+ my %cdata = _get_controldata();
|
|
+
|
|
+ while ( 1 ) {
|
|
+ ocf_log( 'debug', '_controldata: instance "%s" state is "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE, $cdata{'state'} );
|
|
+
|
|
+ # Instance should be running as a primary.
|
|
+ return $OCF_RUNNING_MASTER if $cdata{'state'} eq "in production";
|
|
+
|
|
+ # Instance should be running as a secondary.
|
|
+ # This state includes warm standby (rejects connections attempts,
|
|
+ # including pg_isready)
|
|
+ return $OCF_SUCCESS if $cdata{'state'} eq "in archive recovery";
|
|
+
|
|
+
|
|
+ # The instance should be stopped.
|
|
+ # We don't care if it was a primary or secondary before, because we
|
|
+ # always start instances as secondaries, and then promote if necessary.
|
|
+ return $OCF_NOT_RUNNING if $cdata{'state'} eq "shut down"
|
|
+ or $cdata{'state'} eq "shut down in recovery";
|
|
+
|
|
+ # The state is "in crash recovery", "starting up" or "shutting down".
|
|
+ # This state should be transitional, so we wait and loop to check if
|
|
+ # it changes.
|
|
+ # If it does not, pacemaker will eventually abort with a timeout.
|
|
+ ocf_log( 'debug',
|
|
+ '_controldata: waiting for transitionnal state "%s" to finish',
|
|
+ $cdata{'state'} );
|
|
+ sleep 1;
|
|
+ %cdata = _get_controldata();
|
|
+ }
|
|
+
|
|
+ # If we reach this point, something went really wrong with this code or
|
|
+ # pg_controldata.
|
|
+ ocf_exit_reason( 'Unable get instance "%s" state using pg_controldata',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ return $OCF_ERR_INSTALLED ;
|
|
+}
|
|
+
|
|
+# Check the write_location of all secondaries, and adapt their master score so
|
|
+# that the instance closest to the master will be the selected candidate should
|
|
+# a promotion be triggered.
|
|
+# NOTE: This is only a hint to pacemaker! The selected candidate to promotion
|
|
+# actually re-check it is the best candidate and force a re-election by failing
|
|
+# if a better one exists. This avoid a race condition between the call of the
|
|
+# monitor action and the promotion where another slave might have catchup faster
|
|
+# with the master.
|
|
+# NOTE: we cannot directly use the write_location, neither a lsn_diff value as
|
|
+# promotion score as Pacemaker considers any value greater than 1,000,000 as
|
|
+# INFINITY.
|
|
+#
|
|
+# This sub must be executed from a master monitor action.
|
|
+#
|
|
+sub _check_locations {
|
|
+ my $partition_nodes;
|
|
+ my $node_score;
|
|
+ my $row_num;
|
|
+ my $row;
|
|
+ my @rs;
|
|
+
|
|
+ # Set the master score if not already done
|
|
+ $node_score = _get_master_score();
|
|
+ _set_master_score( '1001' ) unless $node_score eq '1001';
|
|
+
|
|
+ # Ask crm_node what nodes are present in our current cluster partition
|
|
+ $partition_nodes = qx{ $CRM_NODE --partition };
|
|
+
|
|
+ @rs = @{ _get_lag_scores() };
|
|
+
|
|
+ $row_num = scalar @rs;
|
|
+
|
|
+ # If no lag are reported at this point, it means that there is no
|
|
+ # secondary instance connected.
|
|
+ ocf_log( 'warning', 'No secondary connected to the master' )
|
|
+ if $row_num == 0;
|
|
+
|
|
+ # For each standby connected, set their master score based on the following
|
|
+ # rule: the first known node/application, with the highest priority and
|
|
+ # an acceptable state.
|
|
+ while ( $row = shift @rs ) {
|
|
+
|
|
+ if ( $partition_nodes !~ /$row->[0]/ ) {
|
|
+ ocf_log( 'info', 'Ignoring unknown application_name/node "%s"',
|
|
+ $row->[0] );
|
|
+ next;
|
|
+ }
|
|
+
|
|
+ if ( $row->[0] eq $nodename ) {
|
|
+ ocf_log( 'warning', 'Streaming replication with myself!' );
|
|
+ next;
|
|
+ }
|
|
+
|
|
+ $node_score = _get_master_score( $row->[0] );
|
|
+
|
|
+ if ( $row->[3] =~ /^\s*(?:startup|backup)\s*$/ ) {
|
|
+ # We exclude any standby being in state backup (pg_basebackup) or
|
|
+ # startup (new standby or failing standby)
|
|
+ ocf_log( 'info', 'Forbidding promotion on "%s" in state "%s"',
|
|
+ $row->[0], $row->[3] );
|
|
+
|
|
+ _set_master_score( '-1', $row->[0] ) unless $node_score eq '-1';
|
|
+ }
|
|
+ else {
|
|
+ ocf_log( 'debug',
|
|
+ '_check_locations: checking "%s" promotion ability (current_score: %s, priority: %s, location: %s, lag: %s)',
|
|
+ $row->[0], $node_score, $row->[1], $row->[2], $row->[4] );
|
|
+
|
|
+ if ( $node_score ne $row->[1] ) {
|
|
+ if ( $row->[1] < -1 ) {
|
|
+ ocf_log( 'info', 'Update score of "%s" from %s to %s because replication lag (%s) is higher than given maxlag (%s).',
|
|
+ $row->[0], $node_score, $row->[1], $row->[4], $maxlag );
|
|
+ }
|
|
+ else {
|
|
+ ocf_log( 'info', 'Update score of "%s" from %s to %s because of a change in the replication lag (%s).',
|
|
+ $row->[0], $node_score, $row->[1], $row->[4] );
|
|
+ }
|
|
+ _set_master_score( $row->[1], $row->[0] );
|
|
+ }
|
|
+ else {
|
|
+ ocf_log( 'debug',
|
|
+ '_check_locations: "%s" keeps its current score of %s',
|
|
+ $row->[0], $row->[1] );
|
|
+ }
|
|
+ }
|
|
+
|
|
+ # Remove this node from the known nodes list.
|
|
+ $partition_nodes =~ s/(?:^|\s)$row->[0](?:\s|$)/ /g;
|
|
+ }
|
|
+
|
|
+ $partition_nodes =~ s/(?:^\s+)|(?:\s+$)//g;
|
|
+
|
|
+ # If there are still nodes in "partition_nodes", it means there is no
|
|
+ # corresponding line in "pg_stat_replication".
|
|
+ # Exclude these nodes that are not part of the cluster at this
|
|
+ # point.
|
|
+ foreach my $node (split /\s+/ => $partition_nodes) {
|
|
+ # Exclude the current node.
|
|
+ next if $node eq $nodename;
|
|
+
|
|
+ # do not warn if the master score is already set to -1000.
|
|
+ # this avoid log flooding (gh #138)
|
|
+ $node_score = _get_master_score( $node );
|
|
+ next if $node_score eq '-1000';
|
|
+
|
|
+ ocf_log( 'warning', '"%s" is not connected to the primary', $node );
|
|
+ _set_master_score( '-1000', $node );
|
|
+ }
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# _check_switchover
|
|
+# check if the pgsql switchover to the localnode is safe.
|
|
+# This is supposed to be called **after** the master has been stopped or demoted.
|
|
+# This sub checks if the local standby received the shutdown checkpoint from the
|
|
+# old master to make sure it can take over the master role and the old master
|
|
+# will be able to catchup as a standby after.
|
|
+#
|
|
+# Returns 0 if switchover is safe
|
|
+# Returns 1 if swithcover is not safe
|
|
+# Returns 2 for internal error
|
|
+sub _check_switchover {
|
|
+ my $has_sht_chk = 0;
|
|
+ my $last_redo;
|
|
+ my $last_lsn;
|
|
+ my $ans;
|
|
+ my $rc;
|
|
+ my $tl;
|
|
+ my %cdata;
|
|
+
|
|
+ $PGWALDUMP = "$bindir/pg_xlogdump" if $PGVERNUM < $PGVER_10;
|
|
+
|
|
+ ocf_log( 'info', 'Switchover in progress from "%s" to "%s".'
|
|
+ .' Need to check the last record in WAL',
|
|
+ $OCF_NOTIFY_ENV{'demote'}[0]{'uname'}, $nodename );
|
|
+
|
|
+ # check if we received the shutdown checkpoint of the master during its
|
|
+ # demote process.
|
|
+ # We need the last local checkpoint LSN and the last received LSN from
|
|
+ # master to check in the WAL between these adresses if we have a
|
|
+ # "checkpoint shutdown" using pg_xlogdump/pg_waldump.
|
|
+ #
|
|
+ # Force a checkpoint to make sure the controldata shows the very last TL
|
|
+ # and the master's shutdown checkpoint
|
|
+ _query( q{ CHECKPOINT }, {} );
|
|
+ %cdata = _get_controldata();
|
|
+ $tl = $cdata{'tl'};
|
|
+ $last_redo = $cdata{'redo'};
|
|
+
|
|
+ # Get the last received LSN from master
|
|
+ $last_lsn = _get_last_received_lsn();
|
|
+
|
|
+ unless ( defined $last_lsn ) {
|
|
+ ocf_exit_reason( 'Could not fetch last received LSN!' );
|
|
+
|
|
+ return 2;
|
|
+ }
|
|
+
|
|
+ $ans = qx{ $PGWALDUMP --path "$datadir" --timeline "$tl" \\
|
|
+ --start "$last_redo" --end "$last_lsn" 2>&1 };
|
|
+ $rc = $?;
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ '_check_switchover: %s rc: "%s", tl: "%s", last_chk: %s, last_lsn: %s, output: "%s"',
|
|
+ $PGWALDUMP, $rc, $tl, $last_redo, $last_lsn, $ans
|
|
+ );
|
|
+
|
|
+ if ( $rc == 0 and
|
|
+ $ans =~ m{^rmgr: XLOG.*desc: (?i:checkpoint)(?::|_SHUTDOWN) redo [0-9A-F/]+; tli $tl;.*; shutdown$}m
|
|
+ ) {
|
|
+ ocf_log( 'info', 'Slave received the shutdown checkpoint' );
|
|
+ return 0;
|
|
+ }
|
|
+
|
|
+ ocf_exit_reason(
|
|
+ 'Did not receive the shutdown checkpoint from the old master!' );
|
|
+
|
|
+ return 1;
|
|
+}
|
|
+
|
|
+# Check to confirm if the instance is really started as _pg_isready stated and
|
|
+# check if the instance is primary or secondary.
|
|
+#
|
|
+sub _confirm_role {
|
|
+ my $is_in_recovery;
|
|
+ my $rc;
|
|
+ my @rs;
|
|
+
|
|
+ $rc = _query( "SELECT pg_is_in_recovery()", \@rs );
|
|
+
|
|
+ $is_in_recovery = $rs[0][0];
|
|
+
|
|
+ if ( $rc == 0 ) {
|
|
+ # The query was executed, check the result.
|
|
+ if ( $is_in_recovery eq 't' ) {
|
|
+ # The instance is a secondary.
|
|
+ ocf_log( 'debug', "_confirm_role: instance $OCF_RESOURCE_INSTANCE is a secondary");
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+ elsif ( $is_in_recovery eq 'f' ) {
|
|
+ # The instance is a primary.
|
|
+ ocf_log( 'debug', "_confirm_role: instance $OCF_RESOURCE_INSTANCE is a primary");
|
|
+ # Check lsn diff with current slaves if any
|
|
+ _check_locations() if $__OCF_ACTION eq 'monitor';
|
|
+ return $OCF_RUNNING_MASTER;
|
|
+ }
|
|
+
|
|
+ # This should not happen, raise a hard configuration error.
|
|
+ ocf_exit_reason(
|
|
+ 'Unexpected result from query to check if "%s" is a primary or a secondary: "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE, $is_in_recovery );
|
|
+
|
|
+ return $OCF_ERR_CONFIGURED;
|
|
+ }
|
|
+ elsif ( $rc == 1 or $rc == 2 ) {
|
|
+ # psql cound not connect to the instance.
|
|
+ # As pg_isready reported the instance was listening, this error
|
|
+ # could be a max_connection saturation. Just report a soft error.
|
|
+ ocf_exit_reason( 'psql could not connect to instance "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # The query failed (rc: 3) or bad parameters (rc: -1).
|
|
+ # This should not happen, raise a hard configuration error.
|
|
+ ocf_exit_reason(
|
|
+ 'The query to check if instance "%s" is a primary or a secondary failed (rc: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+
|
|
+ return $OCF_ERR_CONFIGURED;
|
|
+}
|
|
+
|
|
+
|
|
+# Check to confirm if the instance is really stopped as _pg_isready stated
|
|
+# and if it was propertly shut down.
|
|
+#
|
|
+sub _confirm_stopped {
|
|
+ my $pgctlstatus_rc;
|
|
+ my $controldata_rc;
|
|
+
|
|
+ # Check the postmaster process status.
|
|
+ $pgctlstatus_rc = _pg_ctl_status();
|
|
+
|
|
+ if ( $pgctlstatus_rc == 0 ) {
|
|
+ # The PID file exists and the process is available.
|
|
+ # That should not be the case, return an error.
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" is not listening, but the process referenced in postmaster.pid exists',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # The PID file does not exist or the process is not available.
|
|
+ ocf_log( 'debug',
|
|
+ '_confirm_stopped: no postmaster process found for instance "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ if ( -f "$datadir/backup_label" ) {
|
|
+ # We are probably on a freshly built secondary that was not started yet.
|
|
+ ocf_log( 'debug',
|
|
+ '_confirm_stopped: backup_label file exists: probably on a never started secondary',
|
|
+ );
|
|
+ return $OCF_NOT_RUNNING;
|
|
+ }
|
|
+
|
|
+ # Continue the check with pg_controldata.
|
|
+ $controldata_rc = _controldata_to_ocf();
|
|
+ if ( $controldata_rc == $OCF_RUNNING_MASTER ) {
|
|
+ # The controldata has not been updated to "shutdown".
|
|
+ # It should mean we had a crash on a primary instance.
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" controldata indicates a running primary instance, the instance has probably crashed',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_FAILED_MASTER;
|
|
+ }
|
|
+ elsif ( $controldata_rc == $OCF_SUCCESS ) {
|
|
+ # The controldata has not been updated to "shutdown in recovery".
|
|
+ # It should mean we had a crash on a secondary instance.
|
|
+ # There is no "FAILED_SLAVE" return code, so we return a generic error.
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" controldata indicates a running secondary instance, the instance has probably crashed',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+ elsif ( $controldata_rc == $OCF_NOT_RUNNING ) {
|
|
+ # The controldata state is consistent, the instance was probably
|
|
+ # propertly shut down.
|
|
+ ocf_log( 'debug',
|
|
+ '_confirm_stopped: instance "%s" controldata indicates that the instance was propertly shut down',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_NOT_RUNNING;
|
|
+ }
|
|
+
|
|
+ # Something went wrong with the controldata check.
|
|
+ ocf_exit_reason(
|
|
+ 'Could not get instance "%s" status from controldata (returned: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $controldata_rc );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+}
|
|
+
|
|
+############################################################
|
|
+#### OCF FUNCS
|
|
+
|
|
+
|
|
+
|
|
+=head1 SUPPORTED PARAMETERS
|
|
+
|
|
+=over
|
|
+
|
|
+=item B<pgdata>
|
|
+
|
|
+Location of the PGDATA of your instance
|
|
+
|
|
+(optional, string, default "/var/lib/pgsql/data")
|
|
+
|
|
+=item B<pghost>
|
|
+
|
|
+The socket directory or IP address to use to connect to the local instance
|
|
+
|
|
+(optional, string, default "/tmp")
|
|
+
|
|
+=item B<pgport>
|
|
+
|
|
+The port to connect to the local instance
|
|
+
|
|
+(optional, integer, default "5432")
|
|
+
|
|
+=item B<bindir>
|
|
+
|
|
+Location of the PostgreSQL binaries.
|
|
+
|
|
+(optional, string, default "/usr/bin")
|
|
+
|
|
+=item B<system_user>
|
|
+
|
|
+The system owner of your instance's process
|
|
+
|
|
+(optional, string, default "postgres")
|
|
+
|
|
+=item B<recovery_template>
|
|
+
|
|
+B<ONLY> for PostgreSQL 11 and bellow.
|
|
+
|
|
+The local template that will be copied as the C<PGDATA/recovery.conf> file.
|
|
+This template file must exists on all node.
|
|
+
|
|
+With PostgreSQL 12 and higher, the cluster will refuse to start if this
|
|
+parameter is set or a template file is found.
|
|
+
|
|
+(optional, string, default "$PGDATA/recovery.conf.pcmk")
|
|
+
|
|
+=item B<maxlag>
|
|
+
|
|
+Maximum lag allowed on a standby before we set a negative master score on it.
|
|
+The calculation is based on the difference between the current xlog location on
|
|
+the master and the write location on the standby.
|
|
+
|
|
+(optional, integer, default "0" disables this feature)
|
|
+
|
|
+=item B<datadir>
|
|
+
|
|
+Path to the directory set in C<data_directory> from your postgresql.conf file.
|
|
+This parameter has same default than PostgreSQL itself: the C<pgdata> parameter
|
|
+value.
|
|
+
|
|
+Unless you have a special PostgreSQL setup and you understand this parameter,
|
|
+B<ignore it>
|
|
+
|
|
+(optional, string, default to the value of C<pgdata>)
|
|
+
|
|
+=item B<start_opts>
|
|
+
|
|
+Additional arguments given to the postgres process on startup. See
|
|
+"postgres --help" for available options. Useful when the postgresql.conf file
|
|
+is not in the data directory (PGDATA), eg.:
|
|
+
|
|
+ -c config_file=/etc/postgresql/9.3/main/postgresql.conf
|
|
+
|
|
+(optinal, string, default "")
|
|
+
|
|
+=back
|
|
+
|
|
+=cut
|
|
+
|
|
+sub ocf_meta_data {
|
|
+ print qq{<?xml version="1.0"?>
|
|
+ <!DOCTYPE resource-agent SYSTEM "ra-api-1.dtd">
|
|
+ <resource-agent name="pgsqlms">
|
|
+ <version>1.0</version>
|
|
+
|
|
+ <longdesc lang="en">
|
|
+ Resource script for PostgreSQL in replication. It manages PostgreSQL servers using streaming replication as an HA resource.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Manages PostgreSQL servers in replication</shortdesc>
|
|
+ <parameters>
|
|
+ <parameter name="system_user" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ System user account used to run the PostgreSQL server
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">PostgreSQL system User</shortdesc>
|
|
+ <content type="string" default="$system_user_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="bindir" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Path to the directory storing the PostgreSQL binaries. The agent uses psql, pg_isready, pg_controldata and pg_ctl.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Path to the PostgreSQL binaries</shortdesc>
|
|
+ <content type="string" default="$bindir_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="pgdata" unique="1" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Path to the data directory, e.g. PGDATA
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Path to the data directory</shortdesc>
|
|
+ <content type="string" default="$pgdata_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="datadir" unique="1" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Path to the directory set in data_directory from your postgresql.conf file. This parameter
|
|
+ has the same default than PostgreSQL itself: the pgdata parameter value. Unless you have a
|
|
+ special PostgreSQL setup and you understand this parameter, ignore it.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Path to the directory set in data_directory from your postgresql.conf file</shortdesc>
|
|
+ <content type="string" default="PGDATA" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="pghost" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Host IP address or unix socket folder the instance is listening on.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Instance IP or unix socket folder</shortdesc>
|
|
+ <content type="string" default="$pghost_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="pgport" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Port the instance is listening on.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Instance port</shortdesc>
|
|
+ <content type="integer" default="$pgport_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="maxlag" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Maximum lag allowed on a standby before we set a negative master score on it. The calculation
|
|
+ is based on the difference between the current LSN on the master and the LSN
|
|
+ written on the standby.
|
|
+ This parameter must be a valid positive number as described in PostgreSQL documentation.
|
|
+ See: https://www.postgresql.org/docs/current/static/sql-syntax-lexical.html#SQL-SYNTAX-CONSTANTS-NUMERIC
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Maximum write lag before we mark a standby as inappropriate to promote</shortdesc>
|
|
+ <content type="integer" default="$maxlag_default" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="recovery_template" unique="1" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Path to the recovery.conf template. This file is simply copied to \$PGDATA
|
|
+ before starting the instance as slave.
|
|
+ ONLY for PostgreSQL 11 and bellow. This parameter is IGNORED for
|
|
+ PostgreSQL 12 and higher. The cluster will refuse to start if a template
|
|
+ file is found.
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Path to the recovery.conf template for PostgreSQL 11 and older.</shortdesc>
|
|
+ <content type="string" default="PGDATA/recovery.conf.pcmk" />
|
|
+ </parameter>
|
|
+
|
|
+ <parameter name="start_opts" unique="0" required="0">
|
|
+ <longdesc lang="en">
|
|
+ Additionnal arguments given to the postgres process on startup.
|
|
+ See "postgres --help" for available options. Usefull when the
|
|
+ postgresql.conf file is not in the data directory (PGDATA), eg.:
|
|
+ "-c config_file=/etc/postgresql/9.3/main/postgresql.conf".
|
|
+ </longdesc>
|
|
+ <shortdesc lang="en">Additionnal arguments given to the postgres process on startup.</shortdesc>
|
|
+ <content type="string" default="$start_opts_default" />
|
|
+ </parameter>
|
|
+
|
|
+ </parameters>
|
|
+ <actions>
|
|
+ <action name="start" timeout="60" />
|
|
+ <action name="stop" timeout="60" />
|
|
+ <action name="reload" timeout="20" />
|
|
+ <action name="promote" timeout="30" />
|
|
+ <action name="demote" timeout="120" />
|
|
+ <action name="monitor" depth="0" timeout="10" interval="15"/>
|
|
+ <action name="monitor" depth="0" timeout="10" interval="15" role="Master"/>
|
|
+ <action name="monitor" depth="0" timeout="10" interval="16" role="Slave"/>
|
|
+ <action name="notify" timeout="60" />
|
|
+ <action name="meta-data" timeout="5" />
|
|
+ <action name="validate-all" timeout="5" />
|
|
+ <action name="methods" timeout="5" />
|
|
+ </actions>
|
|
+ </resource-agent>
|
|
+ };
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+
|
|
+=head1 SUPPORTED ACTIONS
|
|
+
|
|
+This resource agent supports the following actions (operations):
|
|
+
|
|
+=over
|
|
+
|
|
+=item B<start>
|
|
+
|
|
+Starts the resource. Suggested minimum timeout: 60.
|
|
+
|
|
+=item B<stop>
|
|
+
|
|
+Stops the resource. Suggested minimum timeout: 60.
|
|
+
|
|
+=item B<reload>
|
|
+
|
|
+Suggested minimum timeout: 20.
|
|
+
|
|
+=item B<promote>
|
|
+
|
|
+Promotes the resource to the Master role. Suggested minimum timeout: 30.
|
|
+
|
|
+=item B<demote>
|
|
+
|
|
+Demotes the resource to the Slave role. Suggested minimum timeout: 120.
|
|
+
|
|
+=item B<monitor (Master role)>
|
|
+
|
|
+Performs a detailed status check. Suggested minimum timeout: 10.
|
|
+Suggested interval: 15.
|
|
+
|
|
+=item B<monitor (Slave role)>
|
|
+
|
|
+Performs a detailed status check. Suggested minimum timeout: 10.
|
|
+Suggested interval: 16.
|
|
+
|
|
+=item B<notify>
|
|
+
|
|
+Suggested minimum timeout: 60
|
|
+
|
|
+=item B<meta-data>
|
|
+
|
|
+Retrieves resource agent metadata (internal use only).
|
|
+Suggested minimum timeout: 5.
|
|
+
|
|
+=item B<methods>
|
|
+
|
|
+Suggested minimum timeout: 5.
|
|
+
|
|
+=item B<validate-all>
|
|
+
|
|
+Performs a validation of the resource configuration.
|
|
+Suggested minimum timeout: 5.
|
|
+
|
|
+=back
|
|
+
|
|
+=cut
|
|
+
|
|
+sub ocf_methods {
|
|
+ print q{
|
|
+ start
|
|
+ stop
|
|
+ reload
|
|
+ promote
|
|
+ demote
|
|
+ monitor
|
|
+ notify
|
|
+ methods
|
|
+ meta-data
|
|
+ validate-all
|
|
+ };
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+############################################################
|
|
+#### RA FUNCS
|
|
+
|
|
+sub pgsql_validate_all {
|
|
+ my $fh;
|
|
+ my $ans = '';
|
|
+ my %cdata;
|
|
+
|
|
+ unless (
|
|
+ ocf_version_cmp( $ENV{"OCF_RESKEY_crm_feature_set"}, '3.0.9' ) == 2
|
|
+ ) {
|
|
+ ocf_exit_reason(
|
|
+ 'PAF %s is compatible with Pacemaker 1.1.13 and greater',
|
|
+ $VERSION
|
|
+ );
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ # check notify=true
|
|
+ $ans = qx{ $CRM_RESOURCE --resource "$OCF_RESOURCE_INSTANCE" \\
|
|
+ --meta --get-parameter notify 2>/dev/null };
|
|
+ chomp $ans;
|
|
+ unless ( lc($ans) =~ /^true$|^on$|^yes$|^y$|^1$/ ) {
|
|
+ ocf_exit_reason(
|
|
+ 'You must set meta parameter notify=true for your master resource'
|
|
+ );
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ # check master-max=1
|
|
+ unless (
|
|
+ defined $ENV{'OCF_RESKEY_CRM_meta_master_max'}
|
|
+ and $ENV{'OCF_RESKEY_CRM_meta_master_max'} eq '1'
|
|
+ ) {
|
|
+ ocf_exit_reason(
|
|
+ 'You must set meta parameter master-max=1 for your master resource'
|
|
+ );
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ if ( $PGVERNUM >= $PGVER_12 ) {
|
|
+ # check PostgreSQL setup: checks related to v12 and after
|
|
+ my $guc;
|
|
+
|
|
+ # recovery.conf template must not exists
|
|
+ if ( -f $recovery_tpl ) {
|
|
+ ocf_exit_reason(
|
|
+ 'Recovery template file "%s" is forbidden for PostgreSQL 12 and above',
|
|
+ $recovery_tpl );
|
|
+ exit $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ # WARNING: you MUST put -C as first argument to bypass the root check
|
|
+ $guc = qx{ $POSTGRES -C recovery_target_timeline -D "$pgdata" $start_opts};
|
|
+ chomp $guc;
|
|
+ unless ( $guc eq 'latest' ) {
|
|
+ ocf_exit_reason(
|
|
+ q{Parameter "recovery_target_timeline" MUST be set to 'latest'. } .
|
|
+ q{It is currently set to '%s'}, $guc );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ $guc = qx{ $POSTGRES -C primary_conninfo -D "$pgdata" $start_opts};
|
|
+ unless ($guc =~ /\bapplication_name='?$nodename'?\b/) {
|
|
+ ocf_exit_reason(
|
|
+ q{Parameter "primary_conninfo" MUST contain 'application_name=%s'. }.
|
|
+ q{It is currently set to '%s'}, $nodename, $guc );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+ }
|
|
+ else {
|
|
+ my @content;
|
|
+
|
|
+ # check recovery template
|
|
+ if ( ! -f $recovery_tpl ) {
|
|
+ ocf_exit_reason( 'Recovery template file "%s" does not exist',
|
|
+ $recovery_tpl );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ # check content of the recovery template file
|
|
+ unless ( open( $fh, '<', $recovery_tpl ) ) {
|
|
+ ocf_exit_reason( 'Could not open file "%s": %s', $recovery_tpl, $! );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+ @content = <$fh>;
|
|
+ close $fh;
|
|
+
|
|
+
|
|
+ unless ( grep /^\s*standby_mode\s*=\s*'?on'?\s*$/, @content ) {
|
|
+ ocf_exit_reason(
|
|
+ 'Recovery template file must contain "standby_mode = on"' );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ unless ( grep /^\s*recovery_target_timeline\s*=\s*'?latest'?\s*$/, @content ) {
|
|
+ ocf_exit_reason(
|
|
+ "Recovery template file must contain \"recovery_target_timeline = 'latest'\""
|
|
+ );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ unless (
|
|
+ grep /^\s*primary_conninfo\s*=.*['\s]application_name=$nodename['\s]/,
|
|
+ @content
|
|
+ ) {
|
|
+ ocf_exit_reason(
|
|
+ 'Recovery template file must contain in primary_conninfo parameter "application_name=%s"',
|
|
+ $nodename );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+ }
|
|
+
|
|
+ unless ( looks_like_number($maxlag) ) {
|
|
+ ocf_exit_reason( 'maxlag is not a number: "%s"', $maxlag );
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ # check system user
|
|
+ unless ( defined getpwnam $system_user ) {
|
|
+ ocf_exit_reason( 'System user "%s" does not exist', $system_user );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ # require 9.3 minimum
|
|
+ if ( $PGVERNUM < $PGVER_93 ) {
|
|
+ ocf_exit_reason( "Require 9.3 and more" );
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ # check binaries
|
|
+ unless ( -x $PGCTL and -x $PGPSQL and -x $PGCTRLDATA and -x $PGISREADY
|
|
+ and ( -x $PGWALDUMP or -x "$bindir/pg_xlogdump")
|
|
+ ) {
|
|
+ ocf_exit_reason(
|
|
+ "Missing one or more binary. Check following path: %s, %s, %s, %s, %s or %s",
|
|
+ $PGCTL, $PGPSQL, $PGCTRLDATA, $PGISREADY, $PGWALDUMP, "$bindir/pg_xlogdump" );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ # require wal_level >= hot_standby
|
|
+ %cdata = _get_controldata();
|
|
+ unless ( $cdata{'wal_level'} =~ m{hot_standby|logical|replica} ) {
|
|
+ ocf_exit_reason(
|
|
+ 'wal_level must be one of "hot_standby", "logical" or "replica"' );
|
|
+ return $OCF_ERR_ARGS;
|
|
+ }
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+
|
|
+# Start the PostgreSQL instance as a *secondary*
|
|
+#
|
|
+sub pgsql_start {
|
|
+ my $rc = pgsql_monitor();
|
|
+ my %cdata = _get_controldata();
|
|
+ my $prev_state = $cdata{'state'};
|
|
+
|
|
+ # Instance must be running as secondary or being stopped.
|
|
+ # Anything else is an error.
|
|
+ if ( $rc == $OCF_SUCCESS ) {
|
|
+ ocf_log( 'info', 'Instance "%s" already started',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+ elsif ( $rc != $OCF_NOT_RUNNING ) {
|
|
+ ocf_exit_reason( 'Unexpected state for instance "%s" (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ #
|
|
+ # From here, the instance is NOT running for sure.
|
|
+ #
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_start: instance "%s" is not running, starting it as a secondary',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ # Must start as a standby, so enable recovery.
|
|
+ _enable_recovery();
|
|
+
|
|
+ # Start the instance as a secondary.
|
|
+ $rc = _pg_ctl_start();
|
|
+
|
|
+ if ( $rc == 0 ) {
|
|
+
|
|
+ # Wait for the start to finish.
|
|
+ sleep 1 while ( $rc = pgsql_monitor() ) == $OCF_NOT_RUNNING;
|
|
+
|
|
+ if ( $rc == $OCF_SUCCESS ) {
|
|
+ ocf_log( 'info', 'Instance "%s" started', $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ # Check if a master score exists in the cluster.
|
|
+ # During the very first start of the cluster, no master score will
|
|
+ # exists on any of the existing slaves, unless an admin designated
|
|
+ # one of them using crm_master. If no master exists the cluster will
|
|
+ # not promote a master among the slaves.
|
|
+ # To solve this situation, we check if there is at least one master
|
|
+ # score existing on one node in the cluster. Do nothing if at least
|
|
+ # one master score is found among the clones of the resource. If no
|
|
+ # master score exists, set a score of 1 only if the resource was a
|
|
+ # shut downed master before the start.
|
|
+ if ( $prev_state eq "shut down" and not _master_score_exists() ) {
|
|
+ ocf_log( 'info', 'No master score around. Set mine to 1' );
|
|
+
|
|
+ _set_master_score( '1' );
|
|
+ }
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" is not running as a slave (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ ocf_exit_reason( 'Instance "%s" failed to start (rc: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+}
|
|
+
|
|
+# Stop the PostgreSQL instance
|
|
+#
|
|
+sub pgsql_stop {
|
|
+ my $rc;
|
|
+ my $state;
|
|
+ my $pidfile = "$datadir/postmaster.pid";
|
|
+ # Add 60s to the timeout or use a 24h timeout fallback to make sure
|
|
+ # Pacemaker will give up before us and take decisions
|
|
+ my $timeout = ( _get_action_timeout() || 60*60*24 ) + 60;
|
|
+
|
|
+ # Instance must be running as secondary or primary or being stopped.
|
|
+ # Anything else is an error.
|
|
+ $rc = pgsql_monitor();
|
|
+ if ( $rc == $OCF_NOT_RUNNING ) {
|
|
+ ocf_log( 'info', 'Instance "%s" already stopped',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+ elsif ( $rc != $OCF_SUCCESS and $rc != $OCF_RUNNING_MASTER ) {
|
|
+ ocf_exit_reason( 'Unexpected state for instance "%s" (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ #
|
|
+ # From here, the instance is running for sure.
|
|
+ #
|
|
+
|
|
+ ocf_log( 'debug', 'pgsql_stop: instance "%s" is running, stopping it',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ # Try to quit with proper shutdown.
|
|
+
|
|
+
|
|
+ $rc = _runas( $PGCTL, '--pgdata', $pgdata, '-w', '--timeout', $timeout,
|
|
+ '-m', 'fast', 'stop' );
|
|
+
|
|
+ if ( $rc == 0 ) {
|
|
+ # Wait for the stop to finish.
|
|
+ sleep 1 while ( $rc = pgsql_monitor() ) != $OCF_NOT_RUNNING ;
|
|
+
|
|
+ ocf_log( 'info', 'Instance "%s" stopped', $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+
|
|
+ ocf_exit_reason( 'Instance "%s" failed to stop', $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+}
|
|
+
|
|
+# Monitor the PostgreSQL instance
|
|
+#
|
|
+sub pgsql_monitor {
|
|
+ my $pgisready_rc;
|
|
+ my $controldata_rc;
|
|
+
|
|
+ ocf_log( 'debug', 'pgsql_monitor: monitor is a probe' ) if ocf_is_probe();
|
|
+
|
|
+ # First check, verify if the instance is listening.
|
|
+ $pgisready_rc = _pg_isready();
|
|
+
|
|
+ if ( $pgisready_rc == 0 ) {
|
|
+ # The instance is listening.
|
|
+ # We confirm that the instance is up and return if it is a primary or a
|
|
+ # secondary
|
|
+ ocf_log( 'debug', 'pgsql_monitor: instance "%s" is listening',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return _confirm_role();
|
|
+ }
|
|
+
|
|
+ if ( $pgisready_rc == 1 ) {
|
|
+ # The attempt was rejected.
|
|
+ # This could happen in several cases:
|
|
+ # - at startup
|
|
+ # - during shutdown
|
|
+ # - during crash recovery
|
|
+ # - if instance is a warm standby
|
|
+ # Except for the warm standby case, this should be a transitional state.
|
|
+ # We try to confirm using pg_controldata.
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_monitor: instance "%s" rejects connections - checking again...',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ $controldata_rc = _controldata_to_ocf();
|
|
+
|
|
+ if ( $controldata_rc == $OCF_RUNNING_MASTER
|
|
+ or $controldata_rc == $OCF_SUCCESS
|
|
+ ) {
|
|
+ # This state indicates that pg_isready check should succeed.
|
|
+ # We check again.
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_monitor: instance "%s" controldata shows a running status',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ $pgisready_rc = _pg_isready();
|
|
+ if ( $pgisready_rc == 0 ) {
|
|
+ # Consistent with pg_controdata output.
|
|
+ # We can check if the instance is primary or secondary
|
|
+ ocf_log( 'debug', 'pgsql_monitor: instance "%s" is listening',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return _confirm_role();
|
|
+ }
|
|
+
|
|
+ # Still not consistent, raise an error.
|
|
+ # NOTE: if the instance is a warm standby, we end here.
|
|
+ # TODO raise an hard error here ?
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" controldata is not consistent with pg_isready (returned: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $pgisready_rc );
|
|
+ ocf_log( 'info',
|
|
+ 'If this instance is in warm standby, this resource agent only supports hot standby',
|
|
+ $OCF_RESOURCE_INSTANCE, $pgisready_rc );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ if ( $controldata_rc == $OCF_NOT_RUNNING ) {
|
|
+ # This state indicates that pg_isready check should fail with rc 2.
|
|
+ # We check again.
|
|
+ $pgisready_rc = _pg_isready();
|
|
+ if ( $pgisready_rc == 2 ) {
|
|
+ # Consistent with pg_controdata output.
|
|
+ # We check the process status using pg_ctl status and check
|
|
+ # if it was propertly shut down using pg_controldata.
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_monitor: instance "%s" is not listening',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return _confirm_stopped();
|
|
+ }
|
|
+ # Still not consistent, raise an error.
|
|
+ # TODO raise an hard error here ?
|
|
+ ocf_exit_reason(
|
|
+ 'Instance "%s" controldata is not consistent with pg_isready (returned: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $pgisready_rc );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # Something went wrong with the controldata check, hard fail.
|
|
+ ocf_exit_reason(
|
|
+ 'Could not get instance "%s" status from controldata (returned: %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $controldata_rc );
|
|
+
|
|
+ return $OCF_ERR_INSTALLED;
|
|
+ }
|
|
+
|
|
+ elsif ( $pgisready_rc == 2 ) {
|
|
+ # The instance is not listening.
|
|
+ # We check the process status using pg_ctl status and check
|
|
+ # if it was propertly shut down using pg_controldata.
|
|
+ ocf_log( 'debug', 'pgsql_monitor: instance "%s" is not listening',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return _confirm_stopped();
|
|
+ }
|
|
+
|
|
+ elsif ( $pgisready_rc == 3 ) {
|
|
+ # No attempt was done, probably a syntax error.
|
|
+ # Hard configuration error, we don't want to retry or failover here.
|
|
+ ocf_exit_reason(
|
|
+ 'Unknown error while checking if instance "%s" is listening (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $pgisready_rc );
|
|
+
|
|
+ return $OCF_ERR_CONFIGURED;
|
|
+ }
|
|
+
|
|
+ ocf_exit_reason( 'Unexpected result when checking instance "%s" status',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ return $OCF_ERR_GENERIC;
|
|
+}
|
|
+
|
|
+
|
|
+# Demote the PostgreSQL instance from primary to secondary
|
|
+# To demote a PostgreSQL instance, we must:
|
|
+# * stop it gracefully
|
|
+# * create recovery.conf with standby_mode = on
|
|
+# * start it
|
|
+#
|
|
+sub pgsql_demote {
|
|
+ my $rc;
|
|
+
|
|
+ $rc = pgsql_monitor();
|
|
+
|
|
+ # Running as primary. Normal, expected behavior.
|
|
+ if ( $rc == $OCF_RUNNING_MASTER ) {
|
|
+ ocf_log( 'debug', 'pgsql_demote: "%s" currently running as a primary',
|
|
+ $OCF_RESOURCE_INSTANCE ) ;
|
|
+ }
|
|
+ elsif ( $rc == $OCF_SUCCESS ) {
|
|
+ # Already running as secondary. Nothing to do.
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_demote: "%s" currently running as a secondary',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+ elsif ( $rc == $OCF_NOT_RUNNING ) {
|
|
+ # Instance is stopped. Nothing to do.
|
|
+ ocf_log( 'debug', 'pgsql_demote: "%s" currently shut down',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ }
|
|
+ elsif ( $rc == $OCF_ERR_CONFIGURED ) {
|
|
+ # We actually prefer raising a hard or fatal error instead of leaving
|
|
+ # the CRM abording its transition for a new one because of a soft error.
|
|
+ # The hard error will force the CRM to move the resource immediately.
|
|
+ return $OCF_ERR_CONFIGURED;
|
|
+ }
|
|
+ else {
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # TODO we need to make sure at least one slave is connected!!
|
|
+
|
|
+ # WARNING if the resource state is stopped instead of master, the ocf ra dev
|
|
+ # rsc advises to return OCF_ERR_GENERIC, misleading the CRM in a loop where
|
|
+ # it computes transitions of demote(failing)->stop->start->promote actions
|
|
+ # until failcount == migration-threshold.
|
|
+ # This is a really ugly trick to keep going with the demode action if the
|
|
+ # rsc is already stopped gracefully.
|
|
+ # See discussion "CRM trying to demote a stopped resource" on
|
|
+ # developers@clusterlabs.org
|
|
+ unless ( $rc == $OCF_NOT_RUNNING ) {
|
|
+ # Add 60s to the timeout or use a 24h timeout fallback to make sure
|
|
+ # Pacemaker will give up before us and take decisions
|
|
+ my $timeout = ( _get_action_timeout() || 60*60*24 ) + 60;
|
|
+
|
|
+ # WARNING the instance **MUST** be stopped gracefully.
|
|
+ # Do **not** use pg_stop() or service or systemctl here as these
|
|
+ # commands might force-stop the PostgreSQL instance using immediate
|
|
+ # after some timeout and return success, which is misleading.
|
|
+
|
|
+ $rc = _runas( $PGCTL, '--pgdata', $pgdata, '--mode', 'fast', '-w',
|
|
+ '--timeout', $timeout , 'stop' );
|
|
+
|
|
+ # No need to wait for stop to complete, this is handled in pg_ctl
|
|
+ # using -w option.
|
|
+ unless ( $rc == 0 ) {
|
|
+ ocf_exit_reason( 'Failed to stop "%s" using pg_ctl (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # Double check that the instance is stopped correctly.
|
|
+ $rc = pgsql_monitor();
|
|
+ unless ( $rc == $OCF_NOT_RUNNING ) {
|
|
+ ocf_exit_reason(
|
|
+ 'Unexpected "%s" state: monitor status (%d) disagree with pg_ctl return code',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+ }
|
|
+
|
|
+ #
|
|
+ # At this point, the instance **MUST** be stopped gracefully.
|
|
+ #
|
|
+
|
|
+ # Note: We do not need to handle the recovery.conf file here as pgsql_start
|
|
+ # deal with that itself. Equally, no need to wait for the start to complete
|
|
+ # here, handled in pgsql_start.
|
|
+ $rc = pgsql_start();
|
|
+ if ( $rc == $OCF_SUCCESS ) {
|
|
+ ocf_log( 'info', 'pgsql_demote: "%s" started as a secondary',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+
|
|
+ # NOTE: No need to double check the instance state as pgsql_start already use
|
|
+ # pgsql_monitor to check the state before returning.
|
|
+
|
|
+ ocf_exit_reason( 'Starting "%s" as a standby failed (returned %d)',
|
|
+ $OCF_RESOURCE_INSTANCE, $rc );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+}
|
|
+
|
|
+
|
|
+# Promote the secondary instance to primary
|
|
+#
|
|
+sub pgsql_promote {
|
|
+ my $rc;
|
|
+ my $cancel_switchover;
|
|
+
|
|
+ $rc = pgsql_monitor();
|
|
+
|
|
+ if ( $rc == $OCF_SUCCESS ) {
|
|
+ # Running as slave. Normal, expected behavior.
|
|
+ ocf_log( 'debug', 'pgsql_promote: "%s" currently running as a standby',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ }
|
|
+ elsif ( $rc == $OCF_RUNNING_MASTER ) {
|
|
+ # Already a master. Unexpected, but not a problem.
|
|
+ ocf_log( 'info', '"%s" already running as a primary',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+ elsif ( $rc == $OCF_NOT_RUNNING ) { # INFO this is not supposed to happen.
|
|
+ # Currently not running. Need to start before promoting.
|
|
+ ocf_log( 'info', '"%s" currently not running, starting it',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ $rc = pgsql_start();
|
|
+ if ( $rc != $OCF_SUCCESS ) {
|
|
+ ocf_exit_reason( 'Failed to start the instance "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+ }
|
|
+ else {
|
|
+ ocf_exit_reason( 'Unexpected error, cannot promote "%s"',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ #
|
|
+ # At this point, the instance **MUST** be started as a secondary.
|
|
+ #
|
|
+
|
|
+ # Cancel the switchover if it has been considered not safe during the
|
|
+ # pre-promote action
|
|
+ $cancel_switchover = _get_priv_attr('cancel_switchover');
|
|
+ if ( $cancel_switchover ) { # if not empty or not 0
|
|
+ ocf_exit_reason( 'Switchover has been canceled from pre-promote action' );
|
|
+
|
|
+ _delete_priv_attr( 'cancel_switchover' );
|
|
+
|
|
+ return $OCF_ERR_GENERIC if $cancel_switchover eq '1';
|
|
+ return $OCF_ERR_ARGS; # ban the resource from the node if we have an
|
|
+ # internal error during _check_switchover
|
|
+ }
|
|
+
|
|
+ # Do not check for a better candidate if we try to recover the master
|
|
+ # Recover of a master is detected during the pre-promote action. It sets the
|
|
+ # private attribute 'recover_master' to '1' if this is a master recover.
|
|
+ if ( _get_priv_attr( 'recover_master' ) eq '1' ) {
|
|
+ ocf_log( 'info', 'Recovering old master, no election needed');
|
|
+ }
|
|
+ else {
|
|
+
|
|
+ # The promotion is occurring on the best known candidate (highest
|
|
+ # master score), as chosen by pacemaker during the last working monitor
|
|
+ # on previous master (see pgsql_monitor/_check_locations subs).
|
|
+ # To avoid any race condition between the last monitor action on the
|
|
+ # previous master and the **real** most up-to-date standby, we
|
|
+ # set each standby location during the "pre-promote" action, and stored
|
|
+ # them using the "lsn_location" resource attribute.
|
|
+ #
|
|
+ # The best standby to promote would have the highest known LSN. If the
|
|
+ # current resource is not the best one, we need to modify the master
|
|
+ # scores accordingly, and abort the current promotion.
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_promote: checking if current node is the best candidate for promotion' );
|
|
+
|
|
+ # Exclude nodes that are known to be unavailable (not in the current
|
|
+ # partition) using the "crm_node" command
|
|
+ my @active_nodes = split /\s+/ => _get_priv_attr( 'nodes' );
|
|
+ my $node_to_promote = '';
|
|
+ my $ans;
|
|
+ my $max_tl;
|
|
+ my $max_lsn;
|
|
+ my $node_tl;
|
|
+ my $node_lsn;
|
|
+ my $wal_num;
|
|
+ my $wal_off;
|
|
+
|
|
+ # Get the "lsn_location" attribute value for the current node, as set
|
|
+ # during the "pre-promote" action.
|
|
+ # It should be the greatest among the secondary instances.
|
|
+ $ans = _get_priv_attr( 'lsn_location' );
|
|
+
|
|
+ if ( $ans eq '' ) {
|
|
+ # This should not happen as the "lsn_location" attribute should have
|
|
+ # been updated during the "pre-promote" action.
|
|
+ ocf_exit_reason( 'Can not get current node LSN location' );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ chomp $ans;
|
|
+ ( $max_tl, $max_lsn ) = split /#/, $ans;
|
|
+
|
|
+ ocf_log( 'debug', 'pgsql_promote: current node TL#LSN location: %s#%s',
|
|
+ $max_tl, $max_lsn );
|
|
+
|
|
+ # Now we compare with the other available nodes.
|
|
+ foreach my $node ( @active_nodes ) {
|
|
+ # We exclude the current node from the check.
|
|
+ next if $node eq $nodename;
|
|
+
|
|
+ # Get the "lsn_location" attribute value for the node, as set during
|
|
+ # the "pre-promote" action.
|
|
+ # This is implemented as a loop as private attributes are asynchronously
|
|
+ # available from other nodes.
|
|
+ # see: https://github.com/ClusterLabs/PAF/issues/131
|
|
+ # NOTE: if a node did not set its lsn_location for some reason, this will end
|
|
+ # with a timeout and the whole promotion will start again.
|
|
+ WAIT_FOR_LSN: {
|
|
+ $ans = _get_priv_attr( 'lsn_location', $node );
|
|
+ if ( $ans eq '' ) {
|
|
+ ocf_log( 'info', 'pgsql_promote: waiting for LSN from %s', $node );
|
|
+ select( undef, undef, undef, 0.1 );
|
|
+ redo WAIT_FOR_LSN;
|
|
+ }
|
|
+ }
|
|
+
|
|
+ chomp $ans;
|
|
+ ( $node_tl, $node_lsn ) = split /#/, $ans;
|
|
+
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_promote: comparing with "%s": TL#LSN is %s#%s',
|
|
+ $node, $node_tl, $node_lsn );
|
|
+
|
|
+ # If the node has a higher LSN, select it as a best candidate to
|
|
+ # promotion and keep looping to check the TL/LSN of other nodes.
|
|
+ if ( $node_tl > $max_tl
|
|
+ or ( $node_tl == $max_tl and $node_lsn > $max_lsn )
|
|
+ ) {
|
|
+ ocf_log( 'debug',
|
|
+ 'pgsql_promote: "%s" is a better candidate to promote (%s#%s > %s#%s)',
|
|
+ $node, $node_tl, $node_lsn, $max_tl, $max_lsn );
|
|
+ $node_to_promote = $node;
|
|
+ $max_tl = $node_tl;
|
|
+ $max_lsn = $node_lsn;
|
|
+ }
|
|
+ }
|
|
+
|
|
+ # If any node has been selected, we adapt the master scores accordingly
|
|
+ # and break the current promotion.
|
|
+ if ( $node_to_promote ne '' ) {
|
|
+ ocf_exit_reason(
|
|
+ '%s is the best candidate to promote, aborting current promotion',
|
|
+ $node_to_promote );
|
|
+
|
|
+ # Reset current node master score.
|
|
+ _set_master_score( '1' );
|
|
+
|
|
+ # Set promotion candidate master score.
|
|
+ _set_master_score( '1000', $node_to_promote );
|
|
+
|
|
+ # We fail the promotion to trigger another promotion transition
|
|
+ # with the new scores.
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # Else, we will keep on promoting the current node.
|
|
+ }
|
|
+
|
|
+ unless (
|
|
+ # Promote the instance on the current node.
|
|
+ _runas( $PGCTL, '--pgdata', $pgdata, '-w', 'promote' ) == 0 )
|
|
+ {
|
|
+ ocf_exit_reason( 'Error during promotion command' );
|
|
+ return $OCF_ERR_GENERIC;
|
|
+ }
|
|
+
|
|
+ # The instance promotion is asynchronous, so we need to wait for this
|
|
+ # process to complete.
|
|
+ while ( pgsql_monitor() != $OCF_RUNNING_MASTER ) {
|
|
+ ocf_log( 'info', 'Waiting for the promote to complete' );
|
|
+ sleep 1;
|
|
+ }
|
|
+
|
|
+ ocf_log( 'info', 'Promote complete' );
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# This action is called **before** the actual promotion when a failing master is
|
|
+# considered unreclaimable, recoverable or a new master must be promoted
|
|
+# (switchover or first start).
|
|
+# As every "notify" action, it is executed almost simultaneously on all
|
|
+# available nodes.
|
|
+sub pgsql_notify_pre_promote {
|
|
+ my $rc;
|
|
+ my $node_tl;
|
|
+ my $node_lsn;
|
|
+ my %cdata;
|
|
+ my %active_nodes;
|
|
+ my $attr_nodes;
|
|
+
|
|
+ ocf_log( 'info', 'Promoting instance on node "%s"',
|
|
+ $OCF_NOTIFY_ENV{'promote'}[0]{'uname'} );
|
|
+
|
|
+ # No need to do an election between slaves if this is recovery of the master
|
|
+ if ( _is_master_recover( $OCF_NOTIFY_ENV{'promote'}[0]{'uname'} ) ) {
|
|
+ ocf_log( 'warning', 'This is a master recovery!' );
|
|
+
|
|
+ _set_priv_attr( 'recover_master', '1' )
|
|
+ if $OCF_NOTIFY_ENV{'promote'}[0]{'uname'} eq $nodename;
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+
|
|
+ # Environment cleanup!
|
|
+ _delete_priv_attr( 'lsn_location' );
|
|
+ _delete_priv_attr( 'recover_master' );
|
|
+ _delete_priv_attr( 'nodes' );
|
|
+ _delete_priv_attr( 'cancel_switchover' );
|
|
+
|
|
+ # check for the last received entry of WAL from the master if we are
|
|
+ # the designated slave to promote
|
|
+ if ( _is_switchover( $nodename ) and scalar
|
|
+ grep { $_->{'uname'} eq $nodename } @{ $OCF_NOTIFY_ENV{'promote'} }
|
|
+ ) {
|
|
+ $rc = _check_switchover();
|
|
+
|
|
+ unless ( $rc == 0 ) {
|
|
+ # Shortcut the election process as the switchover will be
|
|
+ # canceled
|
|
+ _set_priv_attr( 'cancel_switchover', $rc );
|
|
+ return $OCF_SUCCESS; # return code is ignored during notify
|
|
+ }
|
|
+
|
|
+ # If the sub keeps going, that means the switchover is safe.
|
|
+ # Keep going with the election process in case the switchover was
|
|
+ # instruct to the wrong node.
|
|
+ # FIXME: should we allow a switchover to a lagging slave?
|
|
+ }
|
|
+
|
|
+ # We need to trigger an election between existing slaves to promote the best
|
|
+ # one based on its current LSN location. Each node set a private attribute
|
|
+ # "lsn_location" with its TL and LSN location.
|
|
+ #
|
|
+ # During the following promote action, The designated standby for
|
|
+ # promotion use these attributes to check if the instance to be promoted
|
|
+ # is the best one, so we can avoid a race condition between the last
|
|
+ # successful monitor on the previous master and the current promotion.
|
|
+
|
|
+ # As we can not break the transition from a notification action, we check
|
|
+ # during the promotion if each node TL and LSN are valid.
|
|
+
|
|
+ # Force a checpoint to make sure the controldata shows the very last TL
|
|
+ _query( q{ CHECKPOINT }, {} );
|
|
+ %cdata = _get_controldata();
|
|
+ $node_lsn = _get_last_received_lsn( 'in decimal' );
|
|
+
|
|
+ unless ( defined $node_lsn ) {
|
|
+ ocf_log( 'warning', 'Unknown current node LSN' );
|
|
+ # Return code are ignored during notifications...
|
|
+ return $OCF_SUCCESS;
|
|
+ }
|
|
+
|
|
+ $node_lsn = "$cdata{'tl'}#$node_lsn";
|
|
+
|
|
+ ocf_log( 'info', 'Current node TL#LSN: %s', $node_lsn );
|
|
+
|
|
+ # Set the "lsn_location" attribute value for this node so we can use it
|
|
+ # during the following "promote" action.
|
|
+ _set_priv_attr( 'lsn_location', $node_lsn );
|
|
+
|
|
+ ocf_log( 'warning', 'Could not set the current node LSN' )
|
|
+ if $? != 0 ;
|
|
+
|
|
+ # If this node is the future master, keep track of the slaves that
|
|
+ # received the same notification to compare our LSN with them during
|
|
+ # promotion
|
|
+ if ( $OCF_NOTIFY_ENV{'promote'}[0]{'uname'} eq $nodename ) {
|
|
+ # Build the list of active nodes:
|
|
+ # master + slave + start - stop
|
|
+ # FIXME: Deal with rsc started during the same transaction but **after**
|
|
+ # the promotion ?
|
|
+ $active_nodes{ $_->{'uname'} }++ foreach @{ $OCF_NOTIFY_ENV{'active'} },
|
|
+ @{ $OCF_NOTIFY_ENV{'start'} };
|
|
+ $active_nodes{ $_->{'uname'} }-- foreach @{ $OCF_NOTIFY_ENV{'stop'} };
|
|
+
|
|
+ $attr_nodes = join " "
|
|
+ => grep { $active_nodes{$_} > 0 } keys %active_nodes;
|
|
+
|
|
+ _set_priv_attr( 'nodes', $attr_nodes );
|
|
+ }
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# This action is called after a promote action.
|
|
+sub pgsql_notify_post_promote {
|
|
+
|
|
+ # We have a new master (or the previous one recovered).
|
|
+ # Environment cleanup!
|
|
+ _delete_priv_attr( 'lsn_location' );
|
|
+ _delete_priv_attr( 'recover_master' );
|
|
+ _delete_priv_attr( 'nodes' );
|
|
+ _delete_priv_attr( 'cancel_switchover' );
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# This is called before a demote occurs.
|
|
+sub pgsql_notify_pre_demote {
|
|
+ my $rc;
|
|
+ my %cdata;
|
|
+
|
|
+ # do nothing if the local node will not be demoted
|
|
+ return $OCF_SUCCESS unless scalar
|
|
+ grep { $_->{'uname'} eq $nodename } @{ $OCF_NOTIFY_ENV{'demote'} };
|
|
+
|
|
+ $rc = pgsql_monitor();
|
|
+
|
|
+ # do nothing if this is not a master recovery
|
|
+ return $OCF_SUCCESS unless _is_master_recover( $nodename )
|
|
+ and $rc == $OCF_FAILED_MASTER;
|
|
+
|
|
+ # in case of master crash, we need to detect if the CRM tries to recover
|
|
+ # the master clone. The usual transition is to do:
|
|
+ # demote->stop->start->promote
|
|
+ #
|
|
+ # There are multiple flaws with this transition:
|
|
+ # * the 1st and 2nd actions will fail because the instance is in
|
|
+ # OCF_FAILED_MASTER step
|
|
+ # * the usual start action is dangerous as the instance will start with
|
|
+ # a recovery.conf instead of entering a normal recovery process
|
|
+ #
|
|
+ # To avoid this, we try to start the instance in recovery from here.
|
|
+ # If it success, at least it will be demoted correctly with a normal
|
|
+ # status. If it fails, it will be catched up in next steps.
|
|
+
|
|
+ ocf_log( 'info', 'Trying to start failing master "%s"...',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ # Either the instance managed to start or it couldn't.
|
|
+ # We rely on the pg_ctk '-w' switch to take care of this. If it couldn't
|
|
+ # start, this error will be catched up later during the various checks
|
|
+ _pg_ctl_start();
|
|
+
|
|
+ %cdata = _get_controldata();
|
|
+
|
|
+ ocf_log( 'info', 'State is "%s" after recovery attempt', $cdata{'state'} );
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# This is called before a stop occurs.
|
|
+sub pgsql_notify_pre_stop {
|
|
+ my $rc;
|
|
+ my %cdata;
|
|
+
|
|
+ # do nothing if the local node will not be stopped
|
|
+ return $OCF_SUCCESS unless scalar
|
|
+ grep { $_->{'uname'} eq $nodename } @{ $OCF_NOTIFY_ENV{'stop'} };
|
|
+
|
|
+ $rc = _controldata_to_ocf();
|
|
+
|
|
+ # do nothing if this is not a slave recovery
|
|
+ return $OCF_SUCCESS unless _is_slave_recover( $nodename )
|
|
+ and $rc == $OCF_RUNNING_SLAVE;
|
|
+
|
|
+ # in case of slave crash, we need to detect if the CRM tries to recover
|
|
+ # the slaveclone. The usual transition is to do: stop->start
|
|
+ #
|
|
+ # This transition can no twork because the instance is in
|
|
+ # OCF_ERR_GENERIC step. So the stop action will fail, leading most
|
|
+ # probably to fencing action.
|
|
+ #
|
|
+ # To avoid this, we try to start the instance in recovery from here.
|
|
+ # If it success, at least it will be stopped correctly with a normal
|
|
+ # status. If it fails, it will be catched up in next steps.
|
|
+
|
|
+ ocf_log( 'info', 'Trying to start failing slave "%s"...',
|
|
+ $OCF_RESOURCE_INSTANCE );
|
|
+
|
|
+ # Either the instance managed to start or it couldn't.
|
|
+ # We rely on the pg_ctk '-w' switch to take care of this. If it couldn't
|
|
+ # start, this error will be catched up later during the various checks
|
|
+ _pg_ctl_start();
|
|
+
|
|
+ %cdata = _get_controldata();
|
|
+
|
|
+ ocf_log( 'info', 'State is "%s" after recovery attempt', $cdata{'state'} );
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# Notify type actions, called on all available nodes before (pre) and after
|
|
+# (post) other actions, like promote, start, ...
|
|
+#
|
|
+sub pgsql_notify {
|
|
+ my $type_op;
|
|
+
|
|
+ ocf_log( 'debug', "pgsql_notify: environment variables: %s",
|
|
+ Data::Dumper->new( [ \%OCF_NOTIFY_ENV ] )->Sortkeys(1)->Terse(1)->Dump );
|
|
+
|
|
+ return unless %OCF_NOTIFY_ENV;
|
|
+
|
|
+ $type_op = "$OCF_NOTIFY_ENV{'type'}-$OCF_NOTIFY_ENV{'operation'}";
|
|
+
|
|
+ for ( $type_op ) {
|
|
+ if ( /^pre-promote$/ ) { return pgsql_notify_pre_promote() }
|
|
+ elsif ( /^post-promote$/ ) { return pgsql_notify_post_promote() }
|
|
+ elsif ( /^pre-demote$/ ) { return pgsql_notify_pre_demote() }
|
|
+ elsif ( /^pre-stop$/ ) { return pgsql_notify_pre_stop() }
|
|
+ }
|
|
+
|
|
+ return $OCF_SUCCESS;
|
|
+}
|
|
+
|
|
+# Action used to allow for online modification of resource parameters value.
|
|
+#
|
|
+sub pgsql_reload {
|
|
+
|
|
+ # No action necessary, the action declaration is enough to inform pacemaker
|
|
+ # that the modification of any non-unique parameter can be applied without
|
|
+ # having to restart the resource.
|
|
+ ocf_log( 'info', 'Instance "%s" reloaded', $OCF_RESOURCE_INSTANCE );
|
|
+ return $OCF_SUCCESS;
|
|
+
|
|
+}
|
|
+
|
|
+############################################################
|
|
+#### MAIN
|
|
+
|
|
+exit ocf_meta_data() if $__OCF_ACTION eq 'meta-data';
|
|
+exit ocf_methods() if $__OCF_ACTION eq 'methods';
|
|
+
|
|
+# Avoid "could not change directory" when executing commands as "system-user".
|
|
+chdir File::Spec->tmpdir();
|
|
+
|
|
+# mandatory sanity checks
|
|
+# check pgdata
|
|
+if ( ! -d $pgdata ) {
|
|
+ ocf_exit_reason( 'PGDATA "%s" does not exist', $pgdata );
|
|
+ exit $OCF_ERR_ARGS;
|
|
+}
|
|
+
|
|
+# check datadir
|
|
+if ( ! -d $datadir ) {
|
|
+ ocf_exit_reason( 'data_directory "%s" does not exist', $datadir );
|
|
+ exit $OCF_ERR_ARGS;
|
|
+}
|
|
+
|
|
+# Set PostgreSQL version
|
|
+$PGVERNUM = _get_pg_version();
|
|
+
|
|
+# Set current node name.
|
|
+$nodename = ocf_local_nodename();
|
|
+
|
|
+$exit_code = pgsql_validate_all();
|
|
+
|
|
+exit $exit_code if $exit_code != $OCF_SUCCESS or $__OCF_ACTION eq 'validate-all';
|
|
+
|
|
+# Run action
|
|
+for ( $__OCF_ACTION ) {
|
|
+ if ( /^start$/ ) { $exit_code = pgsql_start() }
|
|
+ elsif ( /^stop$/ ) { $exit_code = pgsql_stop() }
|
|
+ elsif ( /^monitor$/ ) { $exit_code = pgsql_monitor() }
|
|
+ elsif ( /^promote$/ ) { $exit_code = pgsql_promote() }
|
|
+ elsif ( /^demote$/ ) { $exit_code = pgsql_demote() }
|
|
+ elsif ( /^notify$/ ) { $exit_code = pgsql_notify() }
|
|
+ elsif ( /^reload$/ ) { $exit_code = pgsql_reload() }
|
|
+ else { $exit_code = $OCF_ERR_UNIMPLEMENTED }
|
|
+}
|
|
+
|
|
+exit $exit_code;
|
|
+
|
|
+
|
|
+=head1 EXAMPLE CRM SHELL
|
|
+
|
|
+The following is an example configuration for a pgsqlms resource using the
|
|
+crm(8) shell:
|
|
+
|
|
+ primitive pgsqld pgsqlms \
|
|
+ params pgdata="/var/lib/postgresql/9.6/main" \
|
|
+ bindir="/usr/lib/postgresql/9.6/bin" \
|
|
+ pghost="/var/run/postgresql" \
|
|
+ recovery_template="/etc/postgresql/9.6/main/recovery.conf.pcmk" \
|
|
+ start_opts="-c config_file=/etc/postgresql/9.6/main/postgresql.conf" \
|
|
+ op start timeout=60s \
|
|
+ op stop timeout=60s \
|
|
+ op promote timeout=30s \
|
|
+ op demote timeout=120s \
|
|
+ op monitor interval=15s timeout=10s role="Master" \
|
|
+ op monitor interval=16s timeout=10s role="Slave" \
|
|
+ op notify timeout=60s
|
|
+
|
|
+ ms pgsql-ha pgsqld meta notify=true
|
|
+
|
|
+
|
|
+=head1 EXAMPLE PCS
|
|
+
|
|
+The following is an example configuration for a pgsqlms resource using pcs(8):
|
|
+
|
|
+ pcs resource create pgsqld ocf:heartbeat:pgsqlms \
|
|
+ bindir=/usr/pgsql-9.6/bin pgdata=/var/lib/pgsql/9.6/data \
|
|
+ op start timeout=60s \
|
|
+ op stop timeout=60s \
|
|
+ op promote timeout=30s \
|
|
+ op demote timeout=120s \
|
|
+ op monitor interval=15s timeout=10s role="Master" \
|
|
+ op monitor interval=16s timeout=10s role="Slave" \
|
|
+ op notify timeout=60s --master notify=true
|
|
+
|
|
+=head1 SEE ALSO
|
|
+
|
|
+http://clusterlabs.org/
|
|
+
|
|
+=head1 AUTHOR
|
|
+
|
|
+Jehan-Guillaume de Rorthais and Mael Rimbault.
|
|
+
|
|
+=cut
|
|
diff --color -uNr a/paf_LICENSE b/paf_LICENSE
|
|
--- a/paf_LICENSE 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/paf_LICENSE 2021-04-14 09:16:39.083555835 +0200
|
|
@@ -0,0 +1,19 @@
|
|
+Copyright (c) 2016-2020, Jehan-Guillaume de Rorthais, Mael Rimbault.
|
|
+
|
|
+Permission to use, copy, modify, and distribute this software and its
|
|
+documentation for any purpose, without fee, and without a written agreement
|
|
+is hereby granted, provided that the above copyright notice and this
|
|
+paragraph and the following two paragraphs appear in all copies.
|
|
+
|
|
+IN NO EVENT SHALL THE AUTHOR OR DISTRIBUTORS BE LIABLE TO ANY PARTY FOR
|
|
+DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING
|
|
+LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS
|
|
+DOCUMENTATION, EVEN IF THE AUTHOR OR DISTRIBUTORS HAVE BEEN ADVISED OF THE
|
|
+POSSIBILITY OF SUCH DAMAGE.
|
|
+
|
|
+THE AUTHOR AND DISTRIBUTORS SPECIFICALLY DISCLAIMS ANY WARRANTIES,
|
|
+INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY
|
|
+AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS
|
|
+ON AN "AS IS" BASIS, AND THE AUTHOR AND DISTRIBUTORS HAS NO OBLIGATIONS TO
|
|
+PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
|
|
+
|
|
diff --color -uNr a/paf_README.md b/paf_README.md
|
|
--- a/paf_README.md 1970-01-01 01:00:00.000000000 +0100
|
|
+++ b/paf_README.md 2021-04-14 09:18:57.450968048 +0200
|
|
@@ -0,0 +1,86 @@
|
|
+# PostgreSQL Automatic Failover
|
|
+
|
|
+High-Availibility for Postgres, based on industry references Pacemaker and
|
|
+Corosync.
|
|
+
|
|
+## Description
|
|
+
|
|
+Pacemaker is nowadays the industry reference for High Availability. In the same
|
|
+fashion than for Systemd, all Linux distributions moved (or are moving) to this
|
|
+unique Pacemaker+Corosync stack, removing all other existing high availability
|
|
+stacks (CMAN, RGManager, OpenAIS, ...). It is able to detect failure on various
|
|
+services and automatically decide to failover the failing resource to another
|
|
+node when possible.
|
|
+
|
|
+To be able to manage a specific service resource, Pacemaker interact with it
|
|
+through a so-called "Resource Agent". Resource agents must comply to the OCF
|
|
+specification which define what they must implement (start, stop, promote,
|
|
+etc), how they should behave and inform Pacemaker of their results.
|
|
+
|
|
+PostgreSQL Automatic Failover is a new OCF resource Agent dedicated to
|
|
+PostgreSQL. Its original wish is to keep a clear limit between the Pacemaker
|
|
+administration and the PostgreSQL one, to keep things simple, documented and
|
|
+yet powerful.
|
|
+
|
|
+Once your PostgreSQL cluster built using internal streaming replication, PAF is
|
|
+able to expose to Pacemaker what is the current status of the PostgreSQL
|
|
+instance on each node: master, slave, stopped, catching up, etc. Should a
|
|
+failure occurs on the master, Pacemaker will try to recover it by default.
|
|
+Should the failure be non-recoverable, PAF allows the slaves to be able to
|
|
+elect the best of them (the closest one to the old master) and promote it as
|
|
+the new master. All of this thanks to the robust, feature-full and most
|
|
+importantly experienced project: Pacemaker.
|
|
+
|
|
+For information about how to install this agent, see `INSTALL.md`.
|
|
+
|
|
+## Setup and requirements
|
|
+
|
|
+PAF supports PostgreSQL 9.3 and higher. It has been extensively tested under
|
|
+CentOS 6 and 7 in various scenario.
|
|
+
|
|
+PAF has been written to give to the administrator the maximum control
|
|
+over their PostgreSQL configuration and architecture. Thus, you are 100%
|
|
+responsible for the master/slave creations and their setup. The agent
|
|
+will NOT edit your setup. It only requires you to follow these pre-requisites:
|
|
+
|
|
+ * slave __must__ be in hot_standby (accept read-only connections) ;
|
|
+ * the following parameters __must__ be configured in the appropriate place :
|
|
+ * `standby_mode = on` (for PostgreSQL 11 and before)
|
|
+ * `recovery_target_timeline = 'latest'`
|
|
+ * `primary_conninfo` wih `application_name` set to the node name as seen
|
|
+ in Pacemaker.
|
|
+ * these last parameters has been merged inside the instance configuration
|
|
+ file with PostgreSQL 12. For PostgreSQL 11 and before, you __must__
|
|
+ provide a `recovery.conf` template file.
|
|
+
|
|
+When setting up the resource in Pacemaker, here are the available parameters you
|
|
+can set:
|
|
+
|
|
+ * `bindir`: location of the PostgreSQL binaries (default: `/usr/bin`)
|
|
+ * `pgdata`: location of the PGDATA of your instance (default:
|
|
+ `/var/lib/pgsql/data`)
|
|
+ * `datadir`: path to the directory set in `data_directory` from your
|
|
+ postgresql.conf file. This parameter has same default than PostgreSQL
|
|
+ itself: the `pgdata` parameter value. Unless you have a special PostgreSQL
|
|
+ setup and you understand this parameter, __ignore it__
|
|
+ * `pghost`: the socket directory or IP address to use to connect to the
|
|
+ local instance (default: `/tmp` or `/var/run/postgresql` for DEBIAN)
|
|
+ * `pgport`: the port to connect to the local instance (default: `5432`)
|
|
+ * `recovery_template`: __only__ for PostgreSQL 11 and before. The local
|
|
+ template that will be copied as the `PGDATA/recovery.conf` file. This
|
|
+ file must not exist on any node for PostgreSQL 12 and after.
|
|
+ (default: `$PGDATA/recovery.conf.pcmk`)
|
|
+ * `start_opts`: Additional arguments given to the postgres process on startup.
|
|
+ See "postgres --help" for available options. Useful when the postgresql.conf
|
|
+ file is not in the data directory (PGDATA), eg.:
|
|
+ `-c config_file=/etc/postgresql/9.3/main/postgresql.conf`
|
|
+ * `system_user`: the system owner of your instance's process (default:
|
|
+ `postgres`)
|
|
+ * `maxlag`: maximum lag allowed on a standby before we set a negative master
|
|
+ score on it. The calculation is based on the difference between the current
|
|
+ xlog location on the master and the write location on the standby.
|
|
+ (default: 0, which disables this feature)
|
|
+
|
|
+For a demonstration about how to setup a cluster, see
|
|
+[http://clusterlabs.github.io/PAF/documentation.html](http://clusterlabs.github.io/PAF/documentation.html).
|
|
+
|