1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
|
#!/usr/bin/perl -wT
# Completely delete a PostgreSQL cluster. Fails if there is still a server
# process attached.
#
# (C) 2005-2009 Martin Pitt <mpitt@debian.org>
# (C) 2015-2025 Christoph Berg <myon@debian.org>
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
use strict;
use warnings;
use Getopt::Long;
use PgCommon;
# untaint environment
$ENV{'PATH'} = '/sbin:/bin:/usr/sbin:/usr/bin';
delete @ENV{'IFS', 'CDPATH', 'ENV', 'BASH_ENV'};
my $stopserver = 0;
exit 1 unless GetOptions ('stop-server' => \$stopserver, 'stop' => \$stopserver);
# command line options
if ($#ARGV != 1) {
print "Usage: $0 [--stop] <version> <cluster>\n";
exit 1;
}
my ($version) = $ARGV[0] =~ /^(\d+\.?\d+)$/;
my ($cluster) = $ARGV[1] =~ /^([-.\w]+)$/;
error 'invalid version' unless defined $version;
error 'invalid cluster name' unless defined $cluster;
my %info;
my $c; # configuration directory
my $startconf;
if (cluster_exists $version, $cluster) {
%info = cluster_info ($version, $cluster);
validate_cluster_owner \%info if ($info{pgdata} && -d $info{pgdata}); # ignore missing data directory
if ($info{'running'}) {
if ($stopserver) {
if ($info{'pgdata'} && -d $info{'pgdata'}) {
if (system ('pg_ctlcluster', $version, $cluster, 'stop')) {
error 'could not stop server, aborting';
}
} else {
print STDERR "Warning: corrupted cluster: data directory does not exist any more, but server is still running; you have to manually kill the postgres process\n";
}
} else {
error 'This cluster is still running. Stop it or supply the --stop option';
}
}
$c = $info{'configdir'};
$startconf = $info{'start'};
} else {
$c = "/etc/postgresql/$version/$cluster";
# check if we have a broken cluster, clean up if necessary
-d $c or error 'specified cluster does not exist';
}
# disable systemd-enabled clusters
if (not exists $ENV{'PG_CLUSTER_CONF_ROOT'} and -d '/run/systemd/system') {
if ($> == 0) {
system "systemctl", "disable", "postgresql\@$version-$cluster";
system "systemctl", "disable", "--now", "pg_receivewal\@$version-$cluster";
system "systemctl", "disable", "--now", "pg_basebackup\@$version-$cluster.timer";
system "systemctl", "disable", "--now", "pg_dump\@$version-$cluster.timer";
}
}
if ($info{'pgdata'} && -d $info{'pgdata'}) {
# remove custom wal directory
if ($info{waldir} and -d $info{waldir}) {
my $walowner = (stat($info{waldir}))[4];
if (defined $walowner and $walowner == $info{owneruid}) {
my $result = system 'rm', '-r', '--', $info{waldir};
if ($result) {
print STDERR "Warning: could not remove wal directory $info{waldir}";
}
} else {
print STDERR "Warning: wal directory $info{waldir} is not owned by uid $info{owneruid}, not removing\n";
}
}
# get catalog version
my $catversion = "*"; # fall back to glob if pg_controldata is missing
my $pg_controldata = get_program_path 'pg_controldata', $version;
if (-e $pg_controldata and -e "$info{pgdata}/global/pg_control") {
eval { # ignore errors from pg_controldata, we just want to drop the cluster
my $controldata = get_cluster_controldata $version, $cluster;
$catversion = $controldata->{'Catalog version number'};
};
}
# remove tablespace subdirectories that belong to our version
for my $link (glob "$info{pgdata}/pg_tblspc/*") {
next unless (-l $link);
my $tblspc = readlink $link;
my $tblspcowner = (stat($tblspc))[4];
if (defined $tblspcowner and $tblspcowner == $info{owneruid}) {
if ($version >= 9.0) {
for my $dir (glob "$tblspc/PG_${version}_$catversion") {
my $dirowner = (stat($dir))[4];
if (defined $dirowner and $dirowner == $info{owneruid}) {
my $result = system 'rm', '-r', '--', ($dir =~ /(.*)/); # untaint
if ($result) {
print STDERR "Warning: could not remove tablespace directory $dir";
}
} else {
print STDERR "Warning: tablespace subdirectory $dir (in tablespace linked from $link) is not owned by uid $info{owneruid}, not removing\n";
}
}
} else { # before 9.0
if (open my $fh, '<', "$tblspc/PG_VERSION") {
my $v = <$fh>;
chomp $v;
close $fh;
if ($v eq $version) {
$tblspc =~ /(.*)/; # untaint
my $result = system "rm -r -- $1/*";
} else {
print STDERR "Warning: tablespace directory $tblspc (linked from $link) is from PostgreSQL version $v, not removing\n";
}
} else {
print STDERR "Warning: tablespace directory $tblspc (linked from $link) is not a PostgreSQL directory, not removing\n";
}
}
} else {
print STDERR "Warning: tablespace directory $tblspc (linked from $link) is not owned by uid $info{owneruid}, not considering\n";
}
}
# remove pgdata
my $result = system 'rm', '-r', $info{'pgdata'};
if ($result) {
if (! -w ($info{'pgdata'} . '/..')) {
error 'you might need to run this program with root privileges';
}
exit $result;
}
} else {
print STDERR "Warning: corrupted cluster: data directory does not exist\n";
}
# remove config
unlink $c.'/pg_hba.conf', $c.'/pg_ident.conf', $c.'/postgresql.conf',
$c.'/start.conf', $c.'/log', $c.'/autovacuum_log', $c.'/pgdata',
$c.'/environment', $c.'/pg_ctl.conf';
rmdir $_ foreach (map { /(.*)/ && $1 } glob "$c/*"); # remove empty conf.d directories
unlink $info{'logfile'} if defined ($info{'logfile'});
if ($info{'socketdir'} and $info{'socketdir'} !~ /^(\/tmp|\/var\/run\/postgresql)\/?$/) {
rmdir $info{'socketdir'};
}
rmdir $c;
rmdir "/etc/postgresql/$version";
rmdir "/var/lib/postgresql/$version/$cluster";
rmdir "/var/lib/postgresql/$version";
unlink "/var/log/postgresql/postgresql-$version-$cluster.log";
# remove logrotated files
foreach my $f (</var/log/postgresql/postgresql-$version-$cluster.log.[1-9]*>) {
unlink ($f =~ /(.*)/); # untaint
}
# remove stats_temp_directory
my $statstempdir = $info{config}->{stats_temp_directory};
if ($statstempdir) {
my $statsowner = (stat($statstempdir))[4];
if (defined $statsowner and defined $info{owneruid} and $statsowner == $info{owneruid}) {
foreach my $f (<$statstempdir/*.stat>) {
unlink ($f =~ /(.*)/); # untaint
}
rmdir $statstempdir;
}
}
# notify systemd when an autostarted cluster went away
if (not exists $ENV{'PG_CLUSTER_CONF_ROOT'} and $startconf and $startconf eq 'auto' and -d '/run/systemd/system') {
if ($> == 0) {
system 'systemctl daemon-reload';
} elsif (-t 1) {
print "Warning: systemd was not informed about the removed cluster yet. Operations like \"service postgresql start\" might fail. To fix, run:\n";
print " sudo systemctl daemon-reload\n";
}
}
# notify apt about the new cluster
if (not exists $ENV{'PG_CLUSTER_CONF_ROOT'} and $> == 0) {
system "/usr/share/postgresql-common/pg_updateaptconfig";
}
exit 0;
__END__
=head1 NAME
pg_dropcluster - completely delete a PostgreSQL cluster
=head1 SYNOPSIS
B<pg_dropcluster> [B<--stop>] I<cluster-version> I<cluster-name>
=head1 DESCRIPTION
This program removes all files that belong to a given PostgreSQL cluster; that
includes the data, wal, and tablespace directories, the log file, and all configuration files that
were created by L<pg_createcluster(1)>. If the configuration directory
(C</etc/postgresql/>I<version>C</>I<cluster>) is empty after this, it is
removed as well.
An empty socket directory other than B</var/run/postgresql> or B</tmp> is
also removed.
Usually a cluster which still has a running server attached will not be
deleted. To override this, the B<--stop> option forces a server shutdown
before the files are removed.
=head1 SEE ALSO
L<pg_createcluster(1)>, L<pg_ctlcluster(1)>
=head1 AUTHOR
Martin Pitt L<E<lt>mpitt@debian.orgE<gt>>
|
