Age Owner Branch data TLA Line data Source code
1 : : /*
2 : : * check.c
3 : : *
4 : : * server checks and output routines
5 : : *
6 : : * Copyright (c) 2010-2026, PostgreSQL Global Development Group
7 : : * src/bin/pg_upgrade/check.c
8 : : */
9 : :
10 : : #include "postgres_fe.h"
11 : :
12 : : #include "catalog/pg_am_d.h"
13 : : #include "catalog/pg_authid_d.h"
14 : : #include "catalog/pg_class_d.h"
15 : : #include "fe_utils/string_utils.h"
16 : : #include "mb/pg_wchar.h"
17 : : #include "pg_upgrade.h"
18 : : #include "common/unicode_version.h"
19 : :
20 : : static void check_new_cluster_is_empty(void);
21 : : static void check_is_install_user(ClusterInfo *cluster);
22 : : static void check_for_unsupported_encodings(ClusterInfo *cluster);
23 : : static void check_for_connection_status(ClusterInfo *cluster);
24 : : static void check_for_prepared_transactions(ClusterInfo *cluster);
25 : : static void check_for_isn_and_int8_passing_mismatch(ClusterInfo *cluster);
26 : : static void check_for_user_defined_postfix_ops(ClusterInfo *cluster);
27 : : static void check_for_incompatible_polymorphics(ClusterInfo *cluster);
28 : : static void check_for_tables_with_oids(ClusterInfo *cluster);
29 : : static void check_for_not_null_inheritance(ClusterInfo *cluster);
30 : : static void check_for_gist_inet_ops(ClusterInfo *cluster);
31 : : static void check_for_pg_role_prefix(ClusterInfo *cluster);
32 : : static void check_for_new_tablespace_dir(void);
33 : : static void check_for_user_defined_encoding_conversions(ClusterInfo *cluster);
34 : : static void check_for_unicode_update(ClusterInfo *cluster);
35 : : static void check_new_cluster_replication_slots(void);
36 : : static void check_new_cluster_subscription_configuration(void);
37 : : static void check_old_cluster_for_valid_slots(void);
38 : : static void check_old_cluster_subscription_state(void);
39 : : static void check_old_cluster_global_names(ClusterInfo *cluster);
40 : :
41 : : /*
42 : : * DataTypesUsageChecks - definitions of data type checks for the old cluster
43 : : * in order to determine if an upgrade can be performed. See the comment on
44 : : * data_types_usage_checks below for a more detailed description.
45 : : */
46 : : typedef struct
47 : : {
48 : : /* Status line to print to the user */
49 : : const char *status;
50 : : /* Filename to store report to */
51 : : const char *report_filename;
52 : : /* Query to extract the oid of the datatype */
53 : : const char *base_query;
54 : : /* Text to store to report in case of error */
55 : : const char *report_text;
56 : : /* The latest version where the check applies */
57 : : int threshold_version;
58 : : /* A function pointer for determining if the check applies */
59 : : DataTypesUsageVersionCheck version_hook;
60 : : } DataTypesUsageChecks;
61 : :
62 : : /*
63 : : * Special values for threshold_version for indicating that a check applies to
64 : : * all versions, or that a custom function needs to be invoked to determine
65 : : * if the check applies.
66 : : */
67 : : #define MANUAL_CHECK 1
68 : : #define ALL_VERSIONS -1
69 : :
70 : : /*--
71 : : * Data type usage checks. Each check for problematic data type usage is
72 : : * defined in this array with metadata, SQL query for finding the data type
73 : : * and functionality for deciding if the check is applicable to the version
74 : : * of the old cluster. The struct members are described in detail below:
75 : : *
76 : : * status A oneline string which can be printed to the user to
77 : : * inform about progress. Should not end with newline.
78 : : * report_filename The filename in which the list of problems detected by
79 : : * the check will be printed.
80 : : * base_query A query which extracts the Oid of the datatype checked
81 : : * for.
82 : : * report_text The text which will be printed to the user to explain
83 : : * what the check did, and why it failed. The text should
84 : : * end with a newline, and does not need to refer to the
85 : : * report_filename as that is automatically appended to
86 : : * the report with the path to the log folder.
87 : : * threshold_version The major version of PostgreSQL for which to run the
88 : : * check. Iff the old cluster is less than, or equal to,
89 : : * the threshold version then the check will be executed.
90 : : * If the old version is greater than the threshold then
91 : : * the check is skipped. If the threshold_version is set
92 : : * to ALL_VERSIONS then it will be run unconditionally,
93 : : * if set to MANUAL_CHECK then the version_hook function
94 : : * will be executed in order to determine whether or not
95 : : * to run.
96 : : * version_hook A function pointer to a version check function of type
97 : : * DataTypesUsageVersionCheck which is used to determine
98 : : * if the check is applicable to the old cluster. If the
99 : : * version_hook returns true then the check will be run,
100 : : * else it will be skipped. The function will only be
101 : : * executed iff threshold_version is set to MANUAL_CHECK.
102 : : */
103 : : static DataTypesUsageChecks data_types_usage_checks[] =
104 : : {
105 : : /*
106 : : * Look for composite types that were made during initdb *or* belong to
107 : : * information_schema; that's important in case information_schema was
108 : : * dropped and reloaded.
109 : : *
110 : : * The cutoff OID here should match the source cluster's value of
111 : : * FirstNormalObjectId. We hardcode it rather than using that C #define
112 : : * because, if that #define is ever changed, our own version's value is
113 : : * NOT what to use. Eventually we may need a test on the source cluster's
114 : : * version to select the correct value.
115 : : */
116 : : {
117 : : .status = gettext_noop("Checking for system-defined composite types in user tables"),
118 : : .report_filename = "tables_using_composite.txt",
119 : : .base_query =
120 : : "SELECT t.oid FROM pg_catalog.pg_type t "
121 : : "LEFT JOIN pg_catalog.pg_namespace n ON t.typnamespace = n.oid "
122 : : " WHERE typtype = 'c' AND (t.oid < 16384 OR nspname = 'information_schema')",
123 : : .report_text =
124 : : gettext_noop("Your installation contains system-defined composite types in user tables.\n"
125 : : "These type OIDs are not stable across PostgreSQL versions,\n"
126 : : "so this cluster cannot currently be upgraded. You can drop the\n"
127 : : "problem columns and restart the upgrade.\n"),
128 : : .threshold_version = ALL_VERSIONS
129 : : },
130 : :
131 : : /*
132 : : * 9.3 -> 9.4 Fully implement the 'line' data type in 9.4, which
133 : : * previously returned "not enabled" by default and was only functionally
134 : : * enabled with a compile-time switch; as of 9.4 "line" has a different
135 : : * on-disk representation format.
136 : : */
137 : : {
138 : : .status = gettext_noop("Checking for incompatible \"line\" data type"),
139 : : .report_filename = "tables_using_line.txt",
140 : : .base_query =
141 : : "SELECT 'pg_catalog.line'::pg_catalog.regtype AS oid",
142 : : .report_text =
143 : : gettext_noop("Your installation contains the \"line\" data type in user tables.\n"
144 : : "This data type changed its internal and input/output format\n"
145 : : "between your old and new versions so this\n"
146 : : "cluster cannot currently be upgraded. You can\n"
147 : : "drop the problem columns and restart the upgrade.\n"),
148 : : .threshold_version = 903
149 : : },
150 : :
151 : : /*
152 : : * pg_upgrade only preserves these system values: pg_class.oid pg_type.oid
153 : : * pg_enum.oid
154 : : *
155 : : * Many of the reg* data types reference system catalog info that is not
156 : : * preserved, and hence these data types cannot be used in user tables
157 : : * upgraded by pg_upgrade.
158 : : */
159 : : {
160 : : .status = gettext_noop("Checking for reg* data types in user tables"),
161 : : .report_filename = "tables_using_reg.txt",
162 : :
163 : : /*
164 : : * Note: older servers will not have all of these reg* types, so we
165 : : * have to write the query like this rather than depending on casts to
166 : : * regtype.
167 : : */
168 : : .base_query =
169 : : "SELECT oid FROM pg_catalog.pg_type t "
170 : : "WHERE t.typnamespace = "
171 : : " (SELECT oid FROM pg_catalog.pg_namespace "
172 : : " WHERE nspname = 'pg_catalog') "
173 : : " AND t.typname IN ( "
174 : : /* pg_class.oid is preserved, so 'regclass' is OK */
175 : : " 'regcollation', "
176 : : " 'regconfig', "
177 : : /* pg_database.oid is preserved, so 'regdatabase' is OK */
178 : : " 'regdictionary', "
179 : : " 'regnamespace', "
180 : : " 'regoper', "
181 : : " 'regoperator', "
182 : : " 'regproc', "
183 : : " 'regprocedure' "
184 : : /* pg_authid.oid is preserved, so 'regrole' is OK */
185 : : /* pg_type.oid is (mostly) preserved, so 'regtype' is OK */
186 : : " )",
187 : : .report_text =
188 : : gettext_noop("Your installation contains one of the reg* data types in user tables.\n"
189 : : "These data types reference system OIDs that are not preserved by\n"
190 : : "pg_upgrade, so this cluster cannot currently be upgraded. You can\n"
191 : : "drop the problem columns and restart the upgrade.\n"),
192 : : .threshold_version = ALL_VERSIONS
193 : : },
194 : :
195 : : /*
196 : : * PG 16 increased the size of the 'aclitem' type, which breaks the
197 : : * on-disk format for existing data.
198 : : */
199 : : {
200 : : .status = gettext_noop("Checking for incompatible \"aclitem\" data type"),
201 : : .report_filename = "tables_using_aclitem.txt",
202 : : .base_query =
203 : : "SELECT 'pg_catalog.aclitem'::pg_catalog.regtype AS oid",
204 : : .report_text =
205 : : gettext_noop("Your installation contains the \"aclitem\" data type in user tables.\n"
206 : : "The internal format of \"aclitem\" changed in PostgreSQL version 16\n"
207 : : "so this cluster cannot currently be upgraded. You can drop the\n"
208 : : "problem columns and restart the upgrade.\n"),
209 : : .threshold_version = 1500
210 : : },
211 : :
212 : : /*
213 : : * It's no longer allowed to create tables or views with "unknown"-type
214 : : * columns. We do not complain about views with such columns, because
215 : : * they should get silently converted to "text" columns during the DDL
216 : : * dump and reload; it seems unlikely to be worth making users do that by
217 : : * hand. However, if there's a table with such a column, the DDL reload
218 : : * will fail, so we should pre-detect that rather than failing
219 : : * mid-upgrade. Worse, if there's a matview with such a column, the DDL
220 : : * reload will silently change it to "text" which won't match the on-disk
221 : : * storage (which is like "cstring"). So we *must* reject that.
222 : : */
223 : : {
224 : : .status = gettext_noop("Checking for invalid \"unknown\" user columns"),
225 : : .report_filename = "tables_using_unknown.txt",
226 : : .base_query =
227 : : "SELECT 'pg_catalog.unknown'::pg_catalog.regtype AS oid",
228 : : .report_text =
229 : : gettext_noop("Your installation contains the \"unknown\" data type in user tables.\n"
230 : : "This data type is no longer allowed in tables, so this cluster\n"
231 : : "cannot currently be upgraded. You can drop the problem columns\n"
232 : : "and restart the upgrade.\n"),
233 : : .threshold_version = 906
234 : : },
235 : :
236 : : /*
237 : : * PG 12 changed the 'sql_identifier' type storage to be based on name,
238 : : * not varchar, which breaks on-disk format for existing data. So we need
239 : : * to prevent upgrade when used in user objects (tables, indexes, ...). In
240 : : * 12, the sql_identifier data type was switched from name to varchar,
241 : : * which does affect the storage (name is by-ref, but not varlena). This
242 : : * means user tables using sql_identifier for columns are broken because
243 : : * the on-disk format is different.
244 : : */
245 : : {
246 : : .status = gettext_noop("Checking for invalid \"sql_identifier\" user columns"),
247 : : .report_filename = "tables_using_sql_identifier.txt",
248 : : .base_query =
249 : : "SELECT 'information_schema.sql_identifier'::pg_catalog.regtype AS oid",
250 : : .report_text =
251 : : gettext_noop("Your installation contains the \"sql_identifier\" data type in user tables.\n"
252 : : "The on-disk format for this data type has changed, so this\n"
253 : : "cluster cannot currently be upgraded. You can drop the problem\n"
254 : : "columns and restart the upgrade.\n"),
255 : : .threshold_version = 1100
256 : : },
257 : :
258 : : /*
259 : : * JSONB changed its storage format during 9.4 beta, so check for it.
260 : : */
261 : : {
262 : : .status = gettext_noop("Checking for incompatible \"jsonb\" data type in user tables"),
263 : : .report_filename = "tables_using_jsonb.txt",
264 : : .base_query =
265 : : "SELECT 'pg_catalog.jsonb'::pg_catalog.regtype AS oid",
266 : : .report_text =
267 : : gettext_noop("Your installation contains the \"jsonb\" data type in user tables.\n"
268 : : "The internal format of \"jsonb\" changed during 9.4 beta so this\n"
269 : : "cluster cannot currently be upgraded. You can drop the problem \n"
270 : : "columns and restart the upgrade.\n"),
271 : : .threshold_version = MANUAL_CHECK,
272 : : .version_hook = jsonb_9_4_check_applicable
273 : : },
274 : :
275 : : /*
276 : : * PG 12 removed types abstime, reltime, tinterval.
277 : : */
278 : : {
279 : : .status = gettext_noop("Checking for removed \"abstime\" data type in user tables"),
280 : : .report_filename = "tables_using_abstime.txt",
281 : : .base_query =
282 : : "SELECT 'pg_catalog.abstime'::pg_catalog.regtype AS oid",
283 : : .report_text =
284 : : gettext_noop("Your installation contains the \"abstime\" data type in user tables.\n"
285 : : "The \"abstime\" type has been removed in PostgreSQL version 12,\n"
286 : : "so this cluster cannot currently be upgraded. You can drop the\n"
287 : : "problem columns, or change them to another data type, and restart\n"
288 : : "the upgrade.\n"),
289 : : .threshold_version = 1100
290 : : },
291 : : {
292 : : .status = gettext_noop("Checking for removed \"reltime\" data type in user tables"),
293 : : .report_filename = "tables_using_reltime.txt",
294 : : .base_query =
295 : : "SELECT 'pg_catalog.reltime'::pg_catalog.regtype AS oid",
296 : : .report_text =
297 : : gettext_noop("Your installation contains the \"reltime\" data type in user tables.\n"
298 : : "The \"reltime\" type has been removed in PostgreSQL version 12,\n"
299 : : "so this cluster cannot currently be upgraded. You can drop the\n"
300 : : "problem columns, or change them to another data type, and restart\n"
301 : : "the upgrade.\n"),
302 : : .threshold_version = 1100
303 : : },
304 : : {
305 : : .status = gettext_noop("Checking for removed \"tinterval\" data type in user tables"),
306 : : .report_filename = "tables_using_tinterval.txt",
307 : : .base_query =
308 : : "SELECT 'pg_catalog.tinterval'::pg_catalog.regtype AS oid",
309 : : .report_text =
310 : : gettext_noop("Your installation contains the \"tinterval\" data type in user tables.\n"
311 : : "The \"tinterval\" type has been removed in PostgreSQL version 12,\n"
312 : : "so this cluster cannot currently be upgraded. You can drop the\n"
313 : : "problem columns, or change them to another data type, and restart\n"
314 : : "the upgrade.\n"),
315 : : .threshold_version = 1100
316 : : },
317 : :
318 : : /* End of checks marker, must remain last */
319 : : {
320 : : NULL, NULL, NULL, NULL, 0, NULL
321 : : }
322 : : };
323 : :
324 : : /*
325 : : * Private state for check_for_data_types_usage()'s UpgradeTask.
326 : : */
327 : : struct data_type_check_state
328 : : {
329 : : DataTypesUsageChecks *check; /* the check for this step */
330 : : bool result; /* true if check failed for any database */
331 : : PQExpBuffer *report; /* buffer for report on failed checks */
332 : : };
333 : :
334 : : /*
335 : : * Returns a palloc'd query string for the data type check, for use by
336 : : * check_for_data_types_usage()'s UpgradeTask.
337 : : */
338 : : static char *
596 nathan@postgresql.or 339 :CBC 30 : data_type_check_query(int checknum)
340 : : {
341 : 30 : DataTypesUsageChecks *check = &data_types_usage_checks[checknum];
342 : :
343 : 30 : return psprintf("WITH RECURSIVE oids AS ( "
344 : : /* start with the type(s) returned by base_query */
345 : : " %s "
346 : : " UNION ALL "
347 : : " SELECT * FROM ( "
348 : : /* inner WITH because we can only reference the CTE once */
349 : : " WITH x AS (SELECT oid FROM oids) "
350 : : /* domains on any type selected so far */
351 : : " SELECT t.oid FROM pg_catalog.pg_type t, x WHERE typbasetype = x.oid AND typtype = 'd' "
352 : : " UNION ALL "
353 : : /* arrays over any type selected so far */
354 : : " SELECT t.oid FROM pg_catalog.pg_type t, x WHERE typelem = x.oid AND typtype = 'b' "
355 : : " UNION ALL "
356 : : /* composite types containing any type selected so far */
357 : : " SELECT t.oid FROM pg_catalog.pg_type t, pg_catalog.pg_class c, pg_catalog.pg_attribute a, x "
358 : : " WHERE t.typtype = 'c' AND "
359 : : " t.oid = c.reltype AND "
360 : : " c.oid = a.attrelid AND "
361 : : " NOT a.attisdropped AND "
362 : : " a.atttypid = x.oid "
363 : : " UNION ALL "
364 : : /* ranges containing any type selected so far */
365 : : " SELECT t.oid FROM pg_catalog.pg_type t, pg_catalog.pg_range r, x "
366 : : " WHERE t.typtype = 'r' AND r.rngtypid = t.oid AND r.rngsubtype = x.oid"
367 : : " ) foo "
368 : : ") "
369 : : /* now look for stored columns of any such type */
370 : : "SELECT n.nspname, c.relname, a.attname "
371 : : "FROM pg_catalog.pg_class c, "
372 : : " pg_catalog.pg_namespace n, "
373 : : " pg_catalog.pg_attribute a "
374 : : "WHERE c.oid = a.attrelid AND "
375 : : " NOT a.attisdropped AND "
376 : : " a.atttypid IN (SELECT oid FROM oids) AND "
377 : : " c.relkind IN ("
378 : : CppAsString2(RELKIND_RELATION) ", "
379 : : CppAsString2(RELKIND_MATVIEW) ", "
380 : : CppAsString2(RELKIND_INDEX) ") AND "
381 : : " c.relnamespace = n.oid AND "
382 : : /* exclude possible orphaned temp tables */
383 : : " n.nspname !~ '^pg_temp_' AND "
384 : : " n.nspname !~ '^pg_toast_temp_' AND "
385 : : /* exclude system catalogs, too */
386 : : " n.nspname NOT IN ('pg_catalog', 'information_schema')",
387 : : check->base_query);
388 : : }
389 : :
390 : : /*
391 : : * Callback function for processing results of queries for
392 : : * check_for_data_types_usage()'s UpgradeTask. If the query returned any rows
393 : : * (i.e., the check failed), write the details to the report file.
394 : : */
395 : : static void
396 : 96 : process_data_type_check(DbInfo *dbinfo, PGresult *res, void *arg)
397 : : {
398 : 96 : struct data_type_check_state *state = (struct data_type_check_state *) arg;
399 : 96 : int ntups = PQntuples(res);
400 : : char output_path[MAXPGPATH];
586 401 : 96 : int i_nspname = PQfnumber(res, "nspname");
402 : 96 : int i_relname = PQfnumber(res, "relname");
403 : 96 : int i_attname = PQfnumber(res, "attname");
404 : 96 : FILE *script = NULL;
405 : :
406 [ + - ]: 96 : if (ntups == 0)
407 : 96 : return;
408 : :
586 nathan@postgresql.or 409 :UBC 0 : snprintf(output_path, sizeof(output_path), "%s/%s",
410 : : log_opts.basedir,
411 : 0 : state->check->report_filename);
412 : :
413 : : /*
414 : : * Make sure we have a buffer to save reports to now that we found a first
415 : : * failing check.
416 : : */
417 [ # # ]: 0 : if (*state->report == NULL)
418 : 0 : *state->report = createPQExpBuffer();
419 : :
420 : : /*
421 : : * If this is the first time we see an error for the check in question
422 : : * then print a status message of the failure.
423 : : */
424 [ # # ]: 0 : if (!state->result)
425 : : {
426 : 0 : pg_log(PG_REPORT, "failed check: %s", _(state->check->status));
305 alvherre@kurilemu.de 427 : 0 : appendPQExpBuffer(*state->report, "\n%s\n%s\n %s\n",
586 nathan@postgresql.or 428 : 0 : _(state->check->report_text),
429 : : _("A list of the problem columns is in the file:"),
430 : : output_path);
431 : : }
432 : 0 : state->result = true;
433 : :
434 [ # # ]: 0 : if ((script = fopen_priv(output_path, "a")) == NULL)
435 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
436 : :
437 : 0 : fprintf(script, "In database: %s\n", dbinfo->db_name);
438 : :
439 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
440 : 0 : fprintf(script, " %s.%s.%s\n",
441 : : PQgetvalue(res, rowno, i_nspname),
442 : : PQgetvalue(res, rowno, i_relname),
443 : : PQgetvalue(res, rowno, i_attname));
444 : :
445 : 0 : fclose(script);
446 : : }
447 : :
448 : : /*
449 : : * check_for_data_types_usage()
450 : : * Detect whether there are any stored columns depending on given type(s)
451 : : *
452 : : * If so, write a report to the given file name and signal a failure to the
453 : : * user.
454 : : *
455 : : * The checks to run are defined in a DataTypesUsageChecks structure where
456 : : * each check has a metadata for explaining errors to the user, a base_query,
457 : : * a report filename and a function pointer hook for validating if the check
458 : : * should be executed given the cluster at hand.
459 : : *
460 : : * base_query should be a SELECT yielding a single column named "oid",
461 : : * containing the pg_type OIDs of one or more types that are known to have
462 : : * inconsistent on-disk representations across server versions.
463 : : *
464 : : * We check for the type(s) in tables, matviews, and indexes, but not views;
465 : : * there's no storage involved in a view.
466 : : */
467 : : static void
596 nathan@postgresql.or 468 :CBC 15 : check_for_data_types_usage(ClusterInfo *cluster)
469 : : {
470 : 15 : PQExpBuffer report = NULL;
471 : 15 : DataTypesUsageChecks *tmp = data_types_usage_checks;
777 dgustafsson@postgres 472 : 15 : int n_data_types_usage_checks = 0;
596 nathan@postgresql.or 473 : 15 : UpgradeTask *task = upgrade_task_create();
474 : 15 : char **queries = NULL;
475 : : struct data_type_check_state *states;
476 : :
617 peter@eisentraut.org 477 : 15 : prep_status("Checking data type usage");
478 : :
479 : : /* Gather number of checks to perform */
777 dgustafsson@postgres 480 [ + + ]: 165 : while (tmp->status != NULL)
481 : : {
482 : 150 : n_data_types_usage_checks++;
483 : 150 : tmp++;
484 : : }
485 : :
486 : : /* Allocate memory for queries and for task states */
67 michael@paquier.xyz 487 :GNC 15 : queries = pg_malloc0_array(char *, n_data_types_usage_checks);
488 : 15 : states = pg_malloc0_array(struct data_type_check_state, n_data_types_usage_checks);
489 : :
596 nathan@postgresql.or 490 [ + + ]:CBC 165 : for (int i = 0; i < n_data_types_usage_checks; i++)
491 : : {
492 : 150 : DataTypesUsageChecks *check = &data_types_usage_checks[i];
493 : :
494 [ + + ]: 150 : if (check->threshold_version == MANUAL_CHECK)
495 : : {
496 [ - + ]: 15 : Assert(check->version_hook);
497 : :
498 : : /*
499 : : * Make sure that the check applies to the current cluster version
500 : : * and skip it if not.
501 : : */
502 [ + - ]: 15 : if (!check->version_hook(cluster))
503 : 15 : continue;
504 : : }
505 [ + + ]: 135 : else if (check->threshold_version != ALL_VERSIONS)
506 : : {
507 [ + - ]: 105 : if (GET_MAJOR_VERSION(cluster->major_version) > check->threshold_version)
508 : 105 : continue;
509 : : }
510 : : else
511 [ - + ]: 30 : Assert(check->threshold_version == ALL_VERSIONS);
512 : :
513 : 30 : queries[i] = data_type_check_query(i);
514 : :
515 : 30 : states[i].check = check;
516 : 30 : states[i].report = &report;
517 : :
518 : 30 : upgrade_task_add_step(task, queries[i], process_data_type_check,
519 : 30 : true, &states[i]);
520 : : }
521 : :
522 : : /*
523 : : * Connect to each database in the cluster and run all defined checks
524 : : * against that database before trying the next one.
525 : : */
526 : 15 : upgrade_task_run(task, cluster);
527 : 15 : upgrade_task_free(task);
528 : :
529 [ - + ]: 15 : if (report)
530 : : {
596 nathan@postgresql.or 531 :UBC 0 : pg_fatal("Data type checks failed: %s", report->data);
532 : : destroyPQExpBuffer(report);
533 : : }
534 : :
596 nathan@postgresql.or 535 [ + + ]:CBC 165 : for (int i = 0; i < n_data_types_usage_checks; i++)
536 : : {
537 [ + + ]: 150 : if (queries[i])
538 : 30 : pg_free(queries[i]);
539 : : }
540 : 15 : pg_free(queries);
541 : 15 : pg_free(states);
542 : :
777 dgustafsson@postgres 543 : 15 : check_ok();
544 : 15 : }
545 : :
546 : : /*
547 : : * fix_path_separator
548 : : * For non-Windows, just return the argument.
549 : : * For Windows convert any forward slash to a backslash
550 : : * such as is suitable for arguments to builtin commands
551 : : * like RMDIR and DEL.
552 : : */
553 : : static char *
4992 andrew@dunslane.net 554 : 24 : fix_path_separator(char *path)
555 : : {
556 : : #ifdef WIN32
557 : :
558 : : char *result;
559 : : char *c;
560 : :
561 : : result = pg_strdup(path);
562 : :
563 : : for (c = result; *c != '\0'; c++)
564 : : if (*c == '/')
565 : : *c = '\\';
566 : :
567 : : return result;
568 : : #else
569 : :
570 : 24 : return path;
571 : : #endif
572 : : }
573 : :
574 : : void
648 nathan@postgresql.or 575 : 19 : output_check_banner(void)
576 : : {
577 [ - + ]: 19 : if (user_opts.live_check)
578 : : {
3178 peter_e@gmx.net 579 :UBC 0 : pg_log(PG_REPORT,
580 : : "Performing Consistency Checks on Old Live Server\n"
581 : : "------------------------------------------------");
582 : : }
583 : : else
584 : : {
3178 peter_e@gmx.net 585 :CBC 19 : pg_log(PG_REPORT,
586 : : "Performing Consistency Checks\n"
587 : : "-----------------------------");
588 : : }
5837 bruce@momjian.us 589 : 19 : }
590 : :
591 : :
592 : : void
648 nathan@postgresql.or 593 : 18 : check_and_dump_old_cluster(void)
594 : : {
595 : : /* -- OLD -- */
596 : :
597 [ + - ]: 18 : if (!user_opts.live_check)
4849 bruce@momjian.us 598 : 18 : start_postmaster(&old_cluster, true);
599 : :
600 : : /*
601 : : * First check that all databases allow connections since we'll otherwise
602 : : * fail in later stages.
603 : : */
545 dgustafsson@postgres 604 : 18 : check_for_connection_status(&old_cluster);
605 : :
606 : : /*
607 : : * Check for encodings that are no longer supported.
608 : : */
27 tmunro@postgresql.or 609 :GNC 17 : check_for_unsupported_encodings(&old_cluster);
610 : :
611 : : /*
612 : : * Validate database, user, role and tablespace names from the old
613 : : * cluster. No need to check in 19 or newer as newline and carriage return
614 : : * are not allowed at the creation time of the object.
615 : : */
73 andrew@dunslane.net 616 [ - + ]: 17 : if (GET_MAJOR_VERSION(old_cluster.major_version) < 1900)
73 andrew@dunslane.net 617 :UNC 0 : check_old_cluster_global_names(&old_cluster);
618 : :
619 : : /*
620 : : * Extract a list of databases, tables, and logical replication slots from
621 : : * the old cluster.
622 : : */
648 nathan@postgresql.or 623 :CBC 17 : get_db_rel_and_slot_infos(&old_cluster);
624 : :
5677 bruce@momjian.us 625 : 17 : init_tablespaces();
626 : :
627 : 17 : get_loadable_libraries();
628 : :
629 : :
630 : : /*
631 : : * Check for various failure cases
632 : : */
4292 633 : 17 : check_is_install_user(&old_cluster);
5439 634 : 17 : check_for_prepared_transactions(&old_cluster);
5603 635 : 17 : check_for_isn_and_int8_passing_mismatch(&old_cluster);
636 : :
922 akapila@postgresql.o 637 [ + - ]: 17 : if (GET_MAJOR_VERSION(old_cluster.major_version) >= 1700)
638 : : {
639 : : /*
640 : : * Logical replication slots can be migrated since PG17. See comments
641 : : * in get_db_rel_and_slot_infos().
642 : : */
648 nathan@postgresql.or 643 : 17 : check_old_cluster_for_valid_slots();
644 : :
645 : : /*
646 : : * Subscriptions and their dependencies can be migrated since PG17.
647 : : * Before that the logical slots are not upgraded, so we will not be
648 : : * able to upgrade the logical replication clusters completely.
649 : : */
286 akapila@postgresql.o 650 :GNC 16 : get_subscription_info(&old_cluster);
854 akapila@postgresql.o 651 :CBC 16 : check_old_cluster_subscription_state();
652 : : }
653 : :
596 nathan@postgresql.or 654 : 15 : check_for_data_types_usage(&old_cluster);
655 : :
656 : : /*
657 : : * Unicode updates can affect some objects that use expressions with
658 : : * functions dependent on Unicode.
659 : : */
397 jdavis@postgresql.or 660 : 15 : check_for_unicode_update(&old_cluster);
661 : :
662 : : /*
663 : : * PG 14 changed the function signature of encoding conversion functions.
664 : : * Conversions from older versions cannot be upgraded automatically
665 : : * because the user-defined functions used by the encoding conversions
666 : : * need to be changed to match the new signature.
667 : : */
1860 heikki.linnakangas@i 668 [ - + ]: 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1300)
1860 heikki.linnakangas@i 669 :UBC 0 : check_for_user_defined_encoding_conversions(&old_cluster);
670 : :
671 : : /*
672 : : * Pre-PG 14 allowed user defined postfix operators, which are not
673 : : * supported anymore. Verify there are none, iff applicable.
674 : : */
2056 tgl@sss.pgh.pa.us 675 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1300)
2056 tgl@sss.pgh.pa.us 676 :UBC 0 : check_for_user_defined_postfix_ops(&old_cluster);
677 : :
678 : : /*
679 : : * PG 14 changed polymorphic functions from anyarray to
680 : : * anycompatiblearray.
681 : : */
1400 tgl@sss.pgh.pa.us 682 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1300)
1400 tgl@sss.pgh.pa.us 683 :UBC 0 : check_for_incompatible_polymorphics(&old_cluster);
684 : :
685 : : /*
686 : : * Pre-PG 12 allowed tables to be declared WITH OIDS, which is not
687 : : * supported anymore. Verify there are none, iff applicable.
688 : : */
2723 andres@anarazel.de 689 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1100)
2723 andres@anarazel.de 690 :UBC 0 : check_for_tables_with_oids(&old_cluster);
691 : :
692 : : /*
693 : : * Pre-PG 18 allowed child tables to omit not-null constraints that their
694 : : * parents columns have, but schema restore fails for them. Verify there
695 : : * are none, iff applicable.
696 : : */
305 alvherre@kurilemu.de 697 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1800)
305 alvherre@kurilemu.de 698 :LBC (12) : check_for_not_null_inheritance(&old_cluster);
699 : :
700 : : /*
701 : : * The btree_gist extension contains gist_inet_ops and gist_cidr_ops
702 : : * opclasses that do not reliably give correct answers. We want to
703 : : * deprecate and eventually remove those, and as a first step v19 marks
704 : : * them not-opcdefault and instead marks the replacement in-core opclass
705 : : * "inet_ops" as opcdefault. That creates a problem for pg_upgrade: in
706 : : * versions where those opclasses were marked opcdefault, pg_dump will
707 : : * dump indexes using them with no explicit opclass specification, so that
708 : : * restore would create them using the inet_ops opclass. That would be
709 : : * incompatible with what's actually in the on-disk files. So refuse to
710 : : * upgrade if there are any such indexes.
711 : : */
117 tgl@sss.pgh.pa.us 712 [ - + ]:GNC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1800)
117 tgl@sss.pgh.pa.us 713 :UNC 0 : check_for_gist_inet_ops(&old_cluster);
714 : :
715 : : /*
716 : : * Pre-PG 10 allowed tables with 'unknown' type columns and non WAL logged
717 : : * hash indexes
718 : : */
3387 tgl@sss.pgh.pa.us 719 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 906)
720 : : {
3273 rhaas@postgresql.org 721 [ # # ]:UBC 0 : if (user_opts.check)
722 : 0 : old_9_6_invalidate_hash_indexes(&old_cluster, true);
723 : : }
724 : :
725 : : /* 9.5 and below should not have roles starting with pg_ */
3679 sfrost@snowman.net 726 [ - + ]:CBC 15 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 905)
3679 sfrost@snowman.net 727 :UBC 0 : check_for_pg_role_prefix(&old_cluster);
728 : :
729 : : /*
730 : : * While not a check option, we do this now because this is the only time
731 : : * the old server is running.
732 : : */
5677 bruce@momjian.us 733 [ + + ]:CBC 15 : if (!user_opts.check)
734 : 12 : generate_old_dump();
735 : :
648 nathan@postgresql.or 736 [ + - ]: 15 : if (!user_opts.live_check)
5489 bruce@momjian.us 737 : 15 : stop_postmaster(false);
5837 738 : 15 : }
739 : :
740 : :
741 : : void
5677 742 : 15 : check_new_cluster(void)
743 : : {
648 nathan@postgresql.or 744 : 15 : get_db_rel_and_slot_infos(&new_cluster);
745 : :
5495 bruce@momjian.us 746 : 15 : check_new_cluster_is_empty();
747 : :
5677 748 : 15 : check_loadable_libraries();
749 : :
2736 peter_e@gmx.net 750 [ + + + + : 15 : switch (user_opts.transfer_mode)
+ - ]
751 : : {
752 : 1 : case TRANSFER_MODE_CLONE:
753 : 1 : check_file_clone();
2736 peter_e@gmx.net 754 :UBC 0 : break;
2736 peter_e@gmx.net 755 :CBC 11 : case TRANSFER_MODE_COPY:
756 : 11 : break;
790 tmunro@postgresql.or 757 : 1 : case TRANSFER_MODE_COPY_FILE_RANGE:
758 : 1 : check_copy_file_range();
759 : 1 : break;
2736 peter_e@gmx.net 760 : 1 : case TRANSFER_MODE_LINK:
406 nathan@postgresql.or 761 : 1 : check_hard_link(TRANSFER_MODE_LINK);
762 : 1 : break;
763 : 1 : case TRANSFER_MODE_SWAP:
764 : :
765 : : /*
766 : : * We do the hard link check for --swap, too, since it's an easy
767 : : * way to verify the clusters are in the same file system. This
768 : : * allows us to take some shortcuts in the file synchronization
769 : : * step. With some more effort, we could probably support the
770 : : * separate-file-system use case, but this mode is unlikely to
771 : : * offer much benefit if we have to copy the files across file
772 : : * system boundaries.
773 : : */
774 : 1 : check_hard_link(TRANSFER_MODE_SWAP);
775 : :
776 : : /*
777 : : * There are a few known issues with using --swap to upgrade from
778 : : * versions older than 10. For example, the sequence tuple format
779 : : * changed in v10, and the visibility map format changed in 9.6.
780 : : * While such problems are not insurmountable (and we may have to
781 : : * deal with similar problems in the future, anyway), it doesn't
782 : : * seem worth the effort to support swap mode for upgrades from
783 : : * long-unsupported versions.
784 : : */
785 [ - + ]: 1 : if (GET_MAJOR_VERSION(old_cluster.major_version) < 1000)
406 nathan@postgresql.or 786 :UBC 0 : pg_fatal("Swap mode can only upgrade clusters from PostgreSQL version %s and later.",
787 : : "10");
788 : :
2736 peter_e@gmx.net 789 :CBC 1 : break;
790 : : }
791 : :
4292 bruce@momjian.us 792 : 14 : check_is_install_user(&new_cluster);
793 : :
5074 794 : 14 : check_for_prepared_transactions(&new_cluster);
795 : :
986 dgustafsson@postgres 796 : 14 : check_for_new_tablespace_dir();
797 : :
286 akapila@postgresql.o 798 :GNC 14 : check_new_cluster_replication_slots();
799 : :
854 akapila@postgresql.o 800 :CBC 12 : check_new_cluster_subscription_configuration();
5837 bruce@momjian.us 801 : 11 : }
802 : :
803 : :
804 : : void
5677 805 : 11 : report_clusters_compatible(void)
806 : : {
807 [ + + ]: 11 : if (user_opts.check)
808 : : {
1393 tgl@sss.pgh.pa.us 809 : 1 : pg_log(PG_REPORT, "\n*Clusters are compatible*");
810 : : /* stops new cluster */
5489 bruce@momjian.us 811 : 1 : stop_postmaster(false);
812 : :
1427 michael@paquier.xyz 813 : 1 : cleanup_output_dirs();
5508 peter_e@gmx.net 814 : 1 : exit(0);
815 : : }
816 : :
5677 bruce@momjian.us 817 : 10 : pg_log(PG_REPORT, "\n"
818 : : "If pg_upgrade fails after this point, you must re-initdb the\n"
819 : : "new cluster before continuing.");
5837 820 : 10 : }
821 : :
822 : :
823 : : void
3241 824 : 10 : issue_warnings_and_set_wal_level(void)
825 : : {
826 : : /*
827 : : * We unconditionally start/stop the new server because pg_resetwal -o set
828 : : * wal_level to 'minimum'. If the user is upgrading standby servers using
829 : : * the rsync instructions, they will need pg_upgrade to write its final
830 : : * WAL record showing wal_level as 'replica'.
831 : : */
832 : 10 : start_postmaster(&new_cluster, true);
833 : :
834 : : /* Reindex hash indexes for old < 10.0 */
3273 rhaas@postgresql.org 835 [ - + ]: 10 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 906)
3273 rhaas@postgresql.org 836 :UBC 0 : old_9_6_invalidate_hash_indexes(&new_cluster, false);
837 : :
1736 bruce@momjian.us 838 :CBC 10 : report_extension_updates(&new_cluster);
839 : :
3241 840 : 10 : stop_postmaster(false);
5837 841 : 10 : }
842 : :
843 : :
844 : : void
2003 magnus@hagander.net 845 : 10 : output_completion_banner(char *deletion_script_file_name)
846 : : {
847 : : PQExpBufferData user_specification;
848 : :
849 : 10 : initPQExpBuffer(&user_specification);
850 [ - + ]: 10 : if (os_info.user_specified)
851 : : {
2003 magnus@hagander.net 852 :UBC 0 : appendPQExpBufferStr(&user_specification, "-U ");
853 : 0 : appendShellString(&user_specification, os_info.user);
854 : 0 : appendPQExpBufferChar(&user_specification, ' ');
855 : : }
856 : :
2037 bruce@momjian.us 857 :CBC 10 : pg_log(PG_REPORT,
858 : : "Some statistics are not transferred by pg_upgrade.\n"
859 : : "Once you start the new server, consider running these two commands:\n"
860 : : " %s/vacuumdb %s--all --analyze-in-stages --missing-stats-only\n"
861 : : " %s/vacuumdb %s--all --analyze-only",
862 : : new_cluster.bindir, user_specification.data,
863 : : new_cluster.bindir, user_specification.data);
864 : :
4828 865 [ + - ]: 10 : if (deletion_script_file_name)
866 : 10 : pg_log(PG_REPORT,
867 : : "Running this script will delete the old cluster's data files:\n"
868 : : " %s",
869 : : deletion_script_file_name);
870 : : else
4828 bruce@momjian.us 871 :UBC 0 : pg_log(PG_REPORT,
872 : : "Could not create a script to delete the old cluster's data files\n"
873 : : "because user-defined tablespaces or the new cluster's data directory\n"
874 : : "exist in the old cluster directory. The old cluster's contents must\n"
875 : : "be deleted manually.");
876 : :
2003 magnus@hagander.net 877 :CBC 10 : termPQExpBuffer(&user_specification);
5837 bruce@momjian.us 878 : 10 : }
879 : :
880 : :
881 : : void
5677 882 : 19 : check_cluster_versions(void)
883 : : {
5431 884 : 19 : prep_status("Checking cluster versions");
885 : :
886 : : /* cluster versions should already have been obtained */
3092 tgl@sss.pgh.pa.us 887 [ - + ]: 19 : Assert(old_cluster.major_version != 0);
888 [ - + ]: 19 : Assert(new_cluster.major_version != 0);
889 : :
890 : : /*
891 : : * We allow upgrades from/to the same major version for alpha/beta
892 : : * upgrades
893 : : */
894 : :
1603 895 [ - + ]: 19 : if (GET_MAJOR_VERSION(old_cluster.major_version) < 902)
1393 tgl@sss.pgh.pa.us 896 :UBC 0 : pg_fatal("This utility can only upgrade from PostgreSQL version %s and later.",
897 : : "9.2");
898 : :
899 : : /* Only current PG version is supported as a target */
5677 bruce@momjian.us 900 [ - + ]:CBC 19 : if (GET_MAJOR_VERSION(new_cluster.major_version) != GET_MAJOR_VERSION(PG_VERSION_NUM))
1393 tgl@sss.pgh.pa.us 901 :UBC 0 : pg_fatal("This utility can only upgrade to PostgreSQL version %s.",
902 : : PG_MAJORVERSION);
903 : :
904 : : /*
905 : : * We can't allow downgrading because we use the target pg_dump, and
906 : : * pg_dump cannot operate on newer database versions, only current and
907 : : * older versions.
908 : : */
5677 bruce@momjian.us 909 [ - + ]:CBC 19 : if (old_cluster.major_version > new_cluster.major_version)
1393 tgl@sss.pgh.pa.us 910 :UBC 0 : pg_fatal("This utility cannot be used to downgrade to older major PostgreSQL versions.");
911 : :
912 : : /* Ensure binaries match the designated data directories */
5431 bruce@momjian.us 913 :CBC 19 : if (GET_MAJOR_VERSION(old_cluster.major_version) !=
914 [ - + ]: 19 : GET_MAJOR_VERSION(old_cluster.bin_version))
1393 tgl@sss.pgh.pa.us 915 :UBC 0 : pg_fatal("Old cluster data and binary directories are from different major versions.");
5431 bruce@momjian.us 916 :CBC 19 : if (GET_MAJOR_VERSION(new_cluster.major_version) !=
917 [ - + ]: 19 : GET_MAJOR_VERSION(new_cluster.bin_version))
1393 tgl@sss.pgh.pa.us 918 :UBC 0 : pg_fatal("New cluster data and binary directories are from different major versions.");
919 : :
920 : : /*
921 : : * Since from version 18, newly created database clusters always have
922 : : * 'signed' default char-signedness, it makes less sense to use
923 : : * --set-char-signedness option for upgrading from version 18 or later.
924 : : * Users who want to change the default char signedness of the new
925 : : * cluster, they can use pg_resetwal manually before the upgrade.
926 : : */
438 msawada@postgresql.o 927 [ + - ]:CBC 19 : if (GET_MAJOR_VERSION(old_cluster.major_version) >= 1800 &&
928 [ + + ]: 19 : user_opts.char_signedness != -1)
323 peter@eisentraut.org 929 : 1 : pg_fatal("The option %s cannot be used for upgrades from PostgreSQL %s and later.",
930 : : "--set-char-signedness", "18");
931 : :
5431 bruce@momjian.us 932 : 18 : check_ok();
5837 933 : 18 : }
934 : :
935 : :
936 : : void
648 nathan@postgresql.or 937 : 18 : check_cluster_compatibility(void)
938 : : {
939 : : /* get/check pg_control data of servers */
940 : 18 : get_control_data(&old_cluster);
941 : 18 : get_control_data(&new_cluster);
5677 bruce@momjian.us 942 : 18 : check_control_data(&old_cluster.controldata, &new_cluster.controldata);
943 : :
648 nathan@postgresql.or 944 [ - + - - ]: 18 : if (user_opts.live_check && old_cluster.port == new_cluster.port)
4599 peter_e@gmx.net 945 :UBC 0 : pg_fatal("When checking a live server, "
946 : : "the old and new port numbers must be different.");
5837 bruce@momjian.us 947 :CBC 18 : }
948 : :
949 : :
950 : : static void
5495 951 : 15 : check_new_cluster_is_empty(void)
952 : : {
953 : : int dbnum;
954 : :
5677 955 [ + + ]: 45 : for (dbnum = 0; dbnum < new_cluster.dbarr.ndbs; dbnum++)
956 : : {
957 : : int relnum;
958 : 30 : RelInfoArr *rel_arr = &new_cluster.dbarr.dbs[dbnum].rel_arr;
959 : :
5837 960 [ + + ]: 150 : for (relnum = 0; relnum < rel_arr->nrels;
961 : 120 : relnum++)
962 : : {
963 : : /* pg_largeobject and its index should be skipped */
964 [ - + ]: 120 : if (strcmp(rel_arr->rels[relnum].nspname, "pg_catalog") != 0)
1393 tgl@sss.pgh.pa.us 965 :UBC 0 : pg_fatal("New cluster database \"%s\" is not empty: found relation \"%s.%s\"",
2909 peter_e@gmx.net 966 : 0 : new_cluster.dbarr.dbs[dbnum].db_name,
967 : 0 : rel_arr->rels[relnum].nspname,
968 : 0 : rel_arr->rels[relnum].relname);
969 : : }
970 : : }
4225 heikki.linnakangas@i 971 :CBC 15 : }
972 : :
973 : : /*
974 : : * A previous run of pg_upgrade might have failed and the new cluster
975 : : * directory recreated, but they might have forgotten to remove
976 : : * the new cluster's tablespace directories. Therefore, check that
977 : : * new cluster tablespace directories do not already exist. If
978 : : * they do, it would cause an error while restoring global objects.
979 : : * This allows the failure to be detected at check time, rather than
980 : : * during schema restore.
981 : : */
982 : : static void
986 dgustafsson@postgres 983 : 14 : check_for_new_tablespace_dir(void)
984 : : {
985 : : int tblnum;
986 : : char new_tablespace_dir[MAXPGPATH];
987 : :
2028 bruce@momjian.us 988 : 14 : prep_status("Checking for new cluster tablespace directories");
989 : :
279 nathan@postgresql.or 990 [ + + ]:GNC 18 : for (tblnum = 0; tblnum < new_cluster.num_tablespaces; tblnum++)
991 : : {
992 : : struct stat statbuf;
993 : :
2028 bruce@momjian.us 994 :GBC 4 : snprintf(new_tablespace_dir, MAXPGPATH, "%s%s",
279 nathan@postgresql.or 995 :GNC 4 : new_cluster.tablespaces[tblnum],
996 : : new_cluster.tablespace_suffix);
997 : :
2028 bruce@momjian.us 998 [ + - - + ]:GBC 4 : if (stat(new_tablespace_dir, &statbuf) == 0 || errno != ENOENT)
1393 tgl@sss.pgh.pa.us 999 :UBC 0 : pg_fatal("new cluster tablespace directory already exists: \"%s\"",
1000 : : new_tablespace_dir);
1001 : : }
1002 : :
2028 bruce@momjian.us 1003 :CBC 14 : check_ok();
1004 : 14 : }
1005 : :
1006 : : /*
1007 : : * create_script_for_old_cluster_deletion()
1008 : : *
1009 : : * This is particularly useful for tablespace deletion.
1010 : : */
1011 : : void
5431 1012 : 10 : create_script_for_old_cluster_deletion(char **deletion_script_file_name)
1013 : : {
5837 1014 : 10 : FILE *script = NULL;
1015 : : int tblnum;
1016 : : char old_cluster_pgdata[MAXPGPATH],
1017 : : new_cluster_pgdata[MAXPGPATH];
1018 : : char *old_tblspc_suffix;
1019 : :
4224 1020 : 10 : *deletion_script_file_name = psprintf("%sdelete_old_cluster.%s",
1021 : : SCRIPT_PREFIX, SCRIPT_EXT);
1022 : :
3729 1023 : 10 : strlcpy(old_cluster_pgdata, old_cluster.pgdata, MAXPGPATH);
1024 : 10 : canonicalize_path(old_cluster_pgdata);
1025 : :
1026 : 10 : strlcpy(new_cluster_pgdata, new_cluster.pgdata, MAXPGPATH);
1027 : 10 : canonicalize_path(new_cluster_pgdata);
1028 : :
1029 : : /* Some people put the new data directory inside the old one. */
1030 [ - + ]: 10 : if (path_is_prefix_of_path(old_cluster_pgdata, new_cluster_pgdata))
1031 : : {
3729 bruce@momjian.us 1032 :UBC 0 : pg_log(PG_WARNING,
1033 : : "\nWARNING: new data directory should not be inside the old data directory, i.e. %s", old_cluster_pgdata);
1034 : :
1035 : : /* Unlink file in case it is left over from a previous run. */
1036 : 0 : unlink(*deletion_script_file_name);
1037 : 0 : pg_free(*deletion_script_file_name);
1038 : 0 : *deletion_script_file_name = NULL;
1039 : 0 : return;
1040 : : }
1041 : :
1042 : : /*
1043 : : * Some users (oddly) create tablespaces inside the cluster data
1044 : : * directory. We can't create a proper old cluster delete script in that
1045 : : * case.
1046 : : */
279 nathan@postgresql.or 1047 [ + + ]:GNC 14 : for (tblnum = 0; tblnum < new_cluster.num_tablespaces; tblnum++)
1048 : : {
1049 : : char new_tablespace_dir[MAXPGPATH];
1050 : :
1051 : 4 : strlcpy(new_tablespace_dir, new_cluster.tablespaces[tblnum], MAXPGPATH);
1052 : 4 : canonicalize_path(new_tablespace_dir);
1053 [ - + ]: 4 : if (path_is_prefix_of_path(old_cluster_pgdata, new_tablespace_dir))
1054 : : {
1055 : : /* reproduce warning from CREATE TABLESPACE that is in the log */
4025 bruce@momjian.us 1056 :UBC 0 : pg_log(PG_WARNING,
1057 : : "\nWARNING: user-defined tablespace locations should not be inside the data directory, i.e. %s", new_tablespace_dir);
1058 : :
1059 : : /* Unlink file in case it is left over from a previous run. */
4828 1060 : 0 : unlink(*deletion_script_file_name);
1061 : 0 : pg_free(*deletion_script_file_name);
1062 : 0 : *deletion_script_file_name = NULL;
1063 : 0 : return;
1064 : : }
1065 : : }
1066 : :
4828 bruce@momjian.us 1067 :CBC 10 : prep_status("Creating script to delete old cluster");
1068 : :
5167 1069 [ - + ]: 10 : if ((script = fopen_priv(*deletion_script_file_name, "w")) == NULL)
784 michael@paquier.xyz 1070 :UBC 0 : pg_fatal("could not open file \"%s\": %m",
1071 : : *deletion_script_file_name);
1072 : :
1073 : : #ifndef WIN32
1074 : : /* add shebang header */
5837 bruce@momjian.us 1075 :CBC 10 : fprintf(script, "#!/bin/sh\n\n");
1076 : : #endif
1077 : :
1078 : : /* delete old cluster's default tablespace */
4012 1079 : 10 : fprintf(script, RMDIR_CMD " %c%s%c\n", PATH_QUOTE,
1080 : : fix_path_separator(old_cluster.pgdata), PATH_QUOTE);
1081 : :
1082 : : /* delete old cluster's alternate tablespaces */
414 nathan@postgresql.or 1083 : 10 : old_tblspc_suffix = pg_strdup(old_cluster.tablespace_suffix);
1084 : 10 : fix_path_separator(old_tblspc_suffix);
279 nathan@postgresql.or 1085 [ + + ]:GNC 14 : for (tblnum = 0; tblnum < old_cluster.num_tablespaces; tblnum++)
414 nathan@postgresql.or 1086 :GBC 4 : fprintf(script, RMDIR_CMD " %c%s%s%c\n", PATH_QUOTE,
279 nathan@postgresql.or 1087 :GNC 4 : fix_path_separator(old_cluster.tablespaces[tblnum]),
1088 : : old_tblspc_suffix, PATH_QUOTE);
414 nathan@postgresql.or 1089 :CBC 10 : pfree(old_tblspc_suffix);
1090 : :
5837 bruce@momjian.us 1091 : 10 : fclose(script);
1092 : :
1093 : : #ifndef WIN32
1094 [ - + ]: 10 : if (chmod(*deletion_script_file_name, S_IRWXU) != 0)
784 michael@paquier.xyz 1095 :UBC 0 : pg_fatal("could not add execute permission to file \"%s\": %m",
1096 : : *deletion_script_file_name);
1097 : : #endif
1098 : :
5677 bruce@momjian.us 1099 :CBC 10 : check_ok();
1100 : : }
1101 : :
1102 : :
1103 : : /*
1104 : : * check_is_install_user()
1105 : : *
1106 : : * Check we are the install user, and that the new cluster
1107 : : * has no other users.
1108 : : */
1109 : : static void
4292 1110 : 31 : check_is_install_user(ClusterInfo *cluster)
1111 : : {
1112 : : PGresult *res;
5477 1113 : 31 : PGconn *conn = connectToServer(cluster, "template1");
1114 : :
4292 1115 : 31 : prep_status("Checking database user is the install user");
1116 : :
1117 : : /* Can't use pg_authid because only superusers can view it. */
5477 1118 : 31 : res = executeQueryOrDie(conn,
1119 : : "SELECT rolsuper, oid "
1120 : : "FROM pg_catalog.pg_roles "
1121 : : "WHERE rolname = current_user "
1122 : : "AND rolname !~ '^pg_'");
1123 : :
1124 : : /*
1125 : : * We only allow the install user in the new cluster (see comment below)
1126 : : * and we preserve pg_authid.oid, so this must be the install user in the
1127 : : * old cluster too.
1128 : : */
4292 1129 [ + - ]: 31 : if (PQntuples(res) != 1 ||
1130 [ - + ]: 31 : atooid(PQgetvalue(res, 0, 1)) != BOOTSTRAP_SUPERUSERID)
1393 tgl@sss.pgh.pa.us 1131 :UBC 0 : pg_fatal("database user \"%s\" is not the install user",
1132 : : os_info.user);
1133 : :
5074 bruce@momjian.us 1134 :CBC 31 : PQclear(res);
1135 : :
1136 : 31 : res = executeQueryOrDie(conn,
1137 : : "SELECT COUNT(*) "
1138 : : "FROM pg_catalog.pg_roles "
1139 : : "WHERE rolname !~ '^pg_'");
1140 : :
1141 [ - + ]: 31 : if (PQntuples(res) != 1)
1393 tgl@sss.pgh.pa.us 1142 :UBC 0 : pg_fatal("could not determine the number of users");
1143 : :
1144 : : /*
1145 : : * We only allow the install user in the new cluster because other defined
1146 : : * users might match users defined in the old cluster and generate an
1147 : : * error during pg_dump restore.
1148 : : */
1141 dgustafsson@postgres 1149 [ + + - + ]:CBC 31 : if (cluster == &new_cluster && strcmp(PQgetvalue(res, 0, 0), "1") != 0)
1393 tgl@sss.pgh.pa.us 1150 :UBC 0 : pg_fatal("Only the install user can be defined in the new cluster.");
1151 : :
5477 bruce@momjian.us 1152 :CBC 31 : PQclear(res);
1153 : :
1154 : 31 : PQfinish(conn);
1155 : :
5475 1156 : 31 : check_ok();
5477 1157 : 31 : }
1158 : :
1159 : :
1160 : : /*
1161 : : * check_for_connection_status
1162 : : *
1163 : : * Ensure that all non-template0 databases allow connections since they
1164 : : * otherwise won't be restored; and that template0 explicitly doesn't allow
1165 : : * connections since it would make pg_dumpall --globals restore fail.
1166 : : */
1167 : : static void
545 dgustafsson@postgres 1168 : 18 : check_for_connection_status(ClusterInfo *cluster)
1169 : : {
1170 : : int dbnum;
1171 : : PGconn *conn_template1;
1172 : : PGresult *dbres;
1173 : : int ntups;
1174 : : int i_datname;
1175 : : int i_datallowconn;
1176 : : int i_datconnlimit;
1503 1177 : 18 : FILE *script = NULL;
1178 : : char output_path[MAXPGPATH];
1179 : :
4007 bruce@momjian.us 1180 : 18 : prep_status("Checking database connection settings");
1181 : :
1503 dgustafsson@postgres 1182 : 18 : snprintf(output_path, sizeof(output_path), "%s/%s",
1183 : : log_opts.basedir,
1184 : : "databases_cannot_connect_to.txt");
1185 : :
4007 bruce@momjian.us 1186 : 18 : conn_template1 = connectToServer(cluster, "template1");
1187 : :
1188 : : /* get database names */
1189 : 18 : dbres = executeQueryOrDie(conn_template1,
1190 : : "SELECT datname, datallowconn, datconnlimit "
1191 : : "FROM pg_catalog.pg_database");
1192 : :
1193 : 18 : i_datname = PQfnumber(dbres, "datname");
1194 : 18 : i_datallowconn = PQfnumber(dbres, "datallowconn");
545 dgustafsson@postgres 1195 : 18 : i_datconnlimit = PQfnumber(dbres, "datconnlimit");
1196 : :
4007 bruce@momjian.us 1197 : 18 : ntups = PQntuples(dbres);
1198 [ + + ]: 95 : for (dbnum = 0; dbnum < ntups; dbnum++)
1199 : : {
1200 : 77 : char *datname = PQgetvalue(dbres, dbnum, i_datname);
1201 : 77 : char *datallowconn = PQgetvalue(dbres, dbnum, i_datallowconn);
545 dgustafsson@postgres 1202 : 77 : char *datconnlimit = PQgetvalue(dbres, dbnum, i_datconnlimit);
1203 : :
4007 bruce@momjian.us 1204 [ + + ]: 77 : if (strcmp(datname, "template0") == 0)
1205 : : {
1206 : : /* avoid restore failure when pg_dumpall tries to create template0 */
1207 [ - + ]: 18 : if (strcmp(datallowconn, "t") == 0)
4007 bruce@momjian.us 1208 :UBC 0 : pg_fatal("template0 must not allow connections, "
1209 : : "i.e. its pg_database.datallowconn must be false");
1210 : : }
1211 : : else
1212 : : {
1213 : : /*
1214 : : * Avoid datallowconn == false databases from being skipped on
1215 : : * restore, and ensure that no databases are marked invalid with
1216 : : * datconnlimit == -2.
1217 : : */
545 dgustafsson@postgres 1218 [ + - + + ]:CBC 59 : if ((strcmp(datallowconn, "f") == 0) || strcmp(datconnlimit, "-2") == 0)
1219 : : {
1503 1220 [ + - - + ]: 1 : if (script == NULL && (script = fopen_priv(output_path, "w")) == NULL)
784 michael@paquier.xyz 1221 :UBC 0 : pg_fatal("could not open file \"%s\": %m", output_path);
1222 : :
1503 dgustafsson@postgres 1223 :CBC 1 : fprintf(script, "%s\n", datname);
1224 : : }
1225 : : }
1226 : : }
1227 : :
4007 bruce@momjian.us 1228 : 18 : PQclear(dbres);
1229 : :
1230 : 18 : PQfinish(conn_template1);
1231 : :
1503 dgustafsson@postgres 1232 [ + + ]: 18 : if (script)
1233 : : {
1343 1234 : 1 : fclose(script);
1393 tgl@sss.pgh.pa.us 1235 : 1 : pg_log(PG_REPORT, "fatal");
1503 dgustafsson@postgres 1236 : 1 : pg_fatal("All non-template0 databases must allow connections, i.e. their\n"
1237 : : "pg_database.datallowconn must be true and pg_database.datconnlimit\n"
1238 : : "must not be -2. Your installation contains non-template0 databases\n"
1239 : : "which cannot be connected to. Consider allowing connection for all\n"
1240 : : "non-template0 databases or drop the databases which do not allow\n"
1241 : : "connections. A list of databases with the problem is in the file:\n"
1242 : : " %s", output_path);
1243 : : }
1244 : : else
1245 : 17 : check_ok();
4007 bruce@momjian.us 1246 : 17 : }
1247 : :
1248 : :
1249 : : /*
1250 : : * check_for_unsupported_encodings()
1251 : : */
1252 : : static void
27 tmunro@postgresql.or 1253 :GNC 17 : check_for_unsupported_encodings(ClusterInfo *cluster)
1254 : : {
1255 : : int i_datname;
1256 : : int i_encoding;
1257 : : int ntups;
1258 : : PGresult *res;
1259 : : PGconn *conn;
1260 : 17 : FILE *script = NULL;
1261 : : char output_path[MAXPGPATH];
1262 : :
1263 : 17 : prep_status("Checking for unsupported encodings");
1264 : :
1265 : 17 : snprintf(output_path, sizeof(output_path), "%s/%s",
1266 : : log_opts.basedir,
1267 : : "databases_unsupported_encoding.txt");
1268 : :
1269 : 17 : conn = connectToServer(cluster, "template1");
1270 : :
1271 : 17 : res = executeQueryOrDie(conn,
1272 : : "SELECT datname, encoding "
1273 : : "FROM pg_catalog.pg_database");
1274 : 17 : ntups = PQntuples(res);
1275 : 17 : i_datname = PQfnumber(res, "datname");
1276 : 17 : i_encoding = PQfnumber(res, "encoding");
1277 [ + + ]: 86 : for (int rowno = 0; rowno < ntups; rowno++)
1278 : : {
1279 : 69 : char *datname = PQgetvalue(res, rowno, i_datname);
1280 : 69 : int encoding = atoi(PQgetvalue(res, rowno, i_encoding));
1281 : :
1282 [ + - + - : 69 : if (!PG_VALID_BE_ENCODING(encoding))
- + ]
1283 : : {
27 tmunro@postgresql.or 1284 [ # # # # ]:UNC 0 : if (script == NULL && (script = fopen_priv(output_path, "w")) == NULL)
1285 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
1286 : :
1287 : 0 : fprintf(script, "%s\n", datname);
1288 : : }
1289 : : }
27 tmunro@postgresql.or 1290 :GNC 17 : PQclear(res);
1291 : 17 : PQfinish(conn);
1292 : :
1293 [ - + ]: 17 : if (script)
1294 : : {
27 tmunro@postgresql.or 1295 :UNC 0 : fclose(script);
1296 : 0 : pg_log(PG_REPORT, "fatal");
1297 : 0 : pg_fatal("Your installation contains databases using encodings that are\n"
1298 : : "no longer supported. Consider dumping and restoring with UTF8.\n"
1299 : : "A list of databases with unsupported encodings is in the file:\n"
1300 : : " %s", output_path);
1301 : : }
1302 : : else
27 tmunro@postgresql.or 1303 :GNC 17 : check_ok();
1304 : 17 : }
1305 : :
1306 : :
1307 : : /*
1308 : : * check_for_prepared_transactions()
1309 : : *
1310 : : * Make sure there are no prepared transactions because the storage format
1311 : : * might have changed.
1312 : : */
1313 : : static void
5439 bruce@momjian.us 1314 :CBC 31 : check_for_prepared_transactions(ClusterInfo *cluster)
1315 : : {
1316 : : PGresult *res;
1317 : 31 : PGconn *conn = connectToServer(cluster, "template1");
1318 : :
1319 : 31 : prep_status("Checking for prepared transactions");
1320 : :
1321 : 31 : res = executeQueryOrDie(conn,
1322 : : "SELECT * "
1323 : : "FROM pg_catalog.pg_prepared_xacts");
1324 : :
1325 [ - + ]: 31 : if (PQntuples(res) != 0)
1326 : : {
3217 alvherre@alvh.no-ip. 1327 [ # # ]:UBC 0 : if (cluster == &old_cluster)
1393 tgl@sss.pgh.pa.us 1328 : 0 : pg_fatal("The source cluster contains prepared transactions");
1329 : : else
1330 : 0 : pg_fatal("The target cluster contains prepared transactions");
1331 : : }
1332 : :
5439 bruce@momjian.us 1333 :CBC 31 : PQclear(res);
1334 : :
1335 : 31 : PQfinish(conn);
1336 : :
1337 : 31 : check_ok();
1338 : 31 : }
1339 : :
1340 : : /*
1341 : : * Callback function for processing result of query for
1342 : : * check_for_isn_and_int8_passing_mismatch()'s UpgradeTask. If the query
1343 : : * returned any rows (i.e., the check failed), write the details to the report
1344 : : * file.
1345 : : */
1346 : : static void
596 nathan@postgresql.or 1347 :UBC 0 : process_isn_and_int8_passing_mismatch(DbInfo *dbinfo, PGresult *res, void *arg)
1348 : : {
1349 : 0 : int ntups = PQntuples(res);
1350 : 0 : int i_nspname = PQfnumber(res, "nspname");
1351 : 0 : int i_proname = PQfnumber(res, "proname");
1352 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1353 : :
586 1354 [ # # ]: 0 : if (ntups == 0)
1355 : 0 : return;
1356 : :
1357 [ # # ]: 0 : if (report->file == NULL &&
1358 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1359 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1360 : :
1361 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1362 : :
596 1363 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1364 : 0 : fprintf(report->file, " %s.%s\n",
1365 : : PQgetvalue(res, rowno, i_nspname),
1366 : : PQgetvalue(res, rowno, i_proname));
1367 : : }
1368 : :
1369 : : /*
1370 : : * check_for_isn_and_int8_passing_mismatch()
1371 : : *
1372 : : * contrib/isn relies on data type int8, and in 8.4 int8 can now be passed
1373 : : * by value. The schema dumps the CREATE TYPE PASSEDBYVALUE setting so
1374 : : * it must match for the old and new servers.
1375 : : */
1376 : : static void
5603 bruce@momjian.us 1377 :CBC 17 : check_for_isn_and_int8_passing_mismatch(ClusterInfo *cluster)
1378 : : {
1379 : : UpgradeTask *task;
1380 : : UpgradeTaskReport report;
596 nathan@postgresql.or 1381 : 17 : const char *query = "SELECT n.nspname, p.proname "
1382 : : "FROM pg_catalog.pg_proc p, "
1383 : : " pg_catalog.pg_namespace n "
1384 : : "WHERE p.pronamespace = n.oid AND "
1385 : : " p.probin = '$libdir/isn'";
1386 : :
5465 peter_e@gmx.net 1387 : 17 : prep_status("Checking for contrib/isn with bigint-passing mismatch");
1388 : :
5677 bruce@momjian.us 1389 : 17 : if (old_cluster.controldata.float8_pass_by_value ==
1390 [ + - ]: 17 : new_cluster.controldata.float8_pass_by_value)
1391 : : {
1392 : : /* no mismatch */
1393 : 17 : check_ok();
5763 1394 : 17 : return;
1395 : : }
1396 : :
596 nathan@postgresql.or 1397 :UBC 0 : report.file = NULL;
1398 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1399 : : log_opts.basedir,
1400 : : "contrib_isn_and_int8_pass_by_value.txt");
1401 : :
1402 : 0 : task = upgrade_task_create();
1403 : 0 : upgrade_task_add_step(task, query, process_isn_and_int8_passing_mismatch,
1404 : : true, &report);
1405 : 0 : upgrade_task_run(task, cluster);
1406 : 0 : upgrade_task_free(task);
1407 : :
1408 [ # # ]: 0 : if (report.file)
1409 : : {
1410 : 0 : fclose(report.file);
1393 tgl@sss.pgh.pa.us 1411 : 0 : pg_log(PG_REPORT, "fatal");
4599 peter_e@gmx.net 1412 : 0 : pg_fatal("Your installation contains \"contrib/isn\" functions which rely on the\n"
1413 : : "bigint data type. Your old and new clusters pass bigint values\n"
1414 : : "differently so this cluster cannot currently be upgraded. You can\n"
1415 : : "manually dump databases in the old cluster that use \"contrib/isn\"\n"
1416 : : "facilities, drop them, perform the upgrade, and then restore them. A\n"
1417 : : "list of the problem functions is in the file:\n"
1418 : : " %s", report.path);
1419 : : }
1420 : : else
5677 bruce@momjian.us 1421 : 0 : check_ok();
1422 : : }
1423 : :
1424 : : /*
1425 : : * Callback function for processing result of query for
1426 : : * check_for_user_defined_postfix_ops()'s UpgradeTask. If the query returned
1427 : : * any rows (i.e., the check failed), write the details to the report file.
1428 : : */
1429 : : static void
596 nathan@postgresql.or 1430 : 0 : process_user_defined_postfix_ops(DbInfo *dbinfo, PGresult *res, void *arg)
1431 : : {
1432 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1433 : 0 : int ntups = PQntuples(res);
1434 : 0 : int i_oproid = PQfnumber(res, "oproid");
1435 : 0 : int i_oprnsp = PQfnumber(res, "oprnsp");
1436 : 0 : int i_oprname = PQfnumber(res, "oprname");
1437 : 0 : int i_typnsp = PQfnumber(res, "typnsp");
1438 : 0 : int i_typname = PQfnumber(res, "typname");
1439 : :
586 1440 [ # # ]: 0 : if (ntups == 0)
596 1441 : 0 : return;
1442 : :
586 1443 [ # # ]: 0 : if (report->file == NULL &&
1444 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1445 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1446 : :
1447 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1448 : :
596 1449 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1450 : 0 : fprintf(report->file, " (oid=%s) %s.%s (%s.%s, NONE)\n",
1451 : : PQgetvalue(res, rowno, i_oproid),
1452 : : PQgetvalue(res, rowno, i_oprnsp),
1453 : : PQgetvalue(res, rowno, i_oprname),
1454 : : PQgetvalue(res, rowno, i_typnsp),
1455 : : PQgetvalue(res, rowno, i_typname));
1456 : : }
1457 : :
1458 : : /*
1459 : : * Verify that no user defined postfix operators exist.
1460 : : */
1461 : : static void
1462 : 0 : check_for_user_defined_postfix_ops(ClusterInfo *cluster)
1463 : : {
1464 : : UpgradeTaskReport report;
1465 : 0 : UpgradeTask *task = upgrade_task_create();
1466 : : const char *query;
1467 : :
1468 : : /*
1469 : : * The query below hardcodes FirstNormalObjectId as 16384 rather than
1470 : : * interpolating that C #define into the query because, if that #define is
1471 : : * ever changed, the cutoff we want to use is the value used by
1472 : : * pre-version 14 servers, not that of some future version.
1473 : : */
1474 : 0 : query = "SELECT o.oid AS oproid, "
1475 : : " n.nspname AS oprnsp, "
1476 : : " o.oprname, "
1477 : : " tn.nspname AS typnsp, "
1478 : : " t.typname "
1479 : : "FROM pg_catalog.pg_operator o, "
1480 : : " pg_catalog.pg_namespace n, "
1481 : : " pg_catalog.pg_type t, "
1482 : : " pg_catalog.pg_namespace tn "
1483 : : "WHERE o.oprnamespace = n.oid AND "
1484 : : " o.oprleft = t.oid AND "
1485 : : " t.typnamespace = tn.oid AND "
1486 : : " o.oprright = 0 AND "
1487 : : " o.oid >= 16384";
1488 : :
1489 : 0 : prep_status("Checking for user-defined postfix operators");
1490 : :
1491 : 0 : report.file = NULL;
1492 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1493 : : log_opts.basedir,
1494 : : "postfix_ops.txt");
1495 : :
1496 : 0 : upgrade_task_add_step(task, query, process_user_defined_postfix_ops,
1497 : : true, &report);
1498 : 0 : upgrade_task_run(task, cluster);
1499 : 0 : upgrade_task_free(task);
1500 : :
1501 [ # # ]: 0 : if (report.file)
1502 : : {
1503 : 0 : fclose(report.file);
1393 tgl@sss.pgh.pa.us 1504 : 0 : pg_log(PG_REPORT, "fatal");
2056 1505 : 0 : pg_fatal("Your installation contains user-defined postfix operators, which are not\n"
1506 : : "supported anymore. Consider dropping the postfix operators and replacing\n"
1507 : : "them with prefix operators or function calls.\n"
1508 : : "A list of user-defined postfix operators is in the file:\n"
1509 : : " %s", report.path);
1510 : : }
1511 : : else
1512 : 0 : check_ok();
1513 : 0 : }
1514 : :
1515 : : /*
1516 : : * Callback function for processing results of query for
1517 : : * check_for_incompatible_polymorphics()'s UpgradeTask. If the query returned
1518 : : * any rows (i.e., the check failed), write the details to the report file.
1519 : : */
1520 : : static void
596 nathan@postgresql.or 1521 : 0 : process_incompat_polymorphics(DbInfo *dbinfo, PGresult *res, void *arg)
1522 : : {
1523 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1524 : 0 : int ntups = PQntuples(res);
1525 : 0 : int i_objkind = PQfnumber(res, "objkind");
1526 : 0 : int i_objname = PQfnumber(res, "objname");
1527 : :
586 1528 [ # # ]: 0 : if (ntups == 0)
1529 : 0 : return;
1530 : :
1531 [ # # ]: 0 : if (report->file == NULL &&
1532 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1533 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1534 : :
1535 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1536 : :
1537 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
596 1538 : 0 : fprintf(report->file, " %s: %s\n",
1539 : : PQgetvalue(res, rowno, i_objkind),
1540 : : PQgetvalue(res, rowno, i_objname));
1541 : : }
1542 : :
1543 : : /*
1544 : : * check_for_incompatible_polymorphics()
1545 : : *
1546 : : * Make sure nothing is using old polymorphic functions with
1547 : : * anyarray/anyelement rather than the new anycompatible variants.
1548 : : */
1549 : : static void
1400 tgl@sss.pgh.pa.us 1550 : 0 : check_for_incompatible_polymorphics(ClusterInfo *cluster)
1551 : : {
1552 : : PQExpBufferData old_polymorphics;
596 nathan@postgresql.or 1553 : 0 : UpgradeTask *task = upgrade_task_create();
1554 : : UpgradeTaskReport report;
1555 : : char *query;
1556 : :
1400 tgl@sss.pgh.pa.us 1557 : 0 : prep_status("Checking for incompatible polymorphic functions");
1558 : :
596 nathan@postgresql.or 1559 : 0 : report.file = NULL;
1560 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1561 : : log_opts.basedir,
1562 : : "incompatible_polymorphics.txt");
1563 : :
1564 : : /* The set of problematic functions varies a bit in different versions */
1400 tgl@sss.pgh.pa.us 1565 : 0 : initPQExpBuffer(&old_polymorphics);
1566 : :
1567 : 0 : appendPQExpBufferStr(&old_polymorphics,
1568 : : "'array_append(anyarray,anyelement)'"
1569 : : ", 'array_cat(anyarray,anyarray)'"
1570 : : ", 'array_prepend(anyelement,anyarray)'");
1571 : :
1572 [ # # ]: 0 : if (GET_MAJOR_VERSION(cluster->major_version) >= 903)
1573 : 0 : appendPQExpBufferStr(&old_polymorphics,
1574 : : ", 'array_remove(anyarray,anyelement)'"
1575 : : ", 'array_replace(anyarray,anyelement,anyelement)'");
1576 : :
1577 [ # # ]: 0 : if (GET_MAJOR_VERSION(cluster->major_version) >= 905)
1578 : 0 : appendPQExpBufferStr(&old_polymorphics,
1579 : : ", 'array_position(anyarray,anyelement)'"
1580 : : ", 'array_position(anyarray,anyelement,integer)'"
1581 : : ", 'array_positions(anyarray,anyelement)'"
1582 : : ", 'width_bucket(anyelement,anyarray)'");
1583 : :
1584 : : /*
1585 : : * The query below hardcodes FirstNormalObjectId as 16384 rather than
1586 : : * interpolating that C #define into the query because, if that #define is
1587 : : * ever changed, the cutoff we want to use is the value used by
1588 : : * pre-version 14 servers, not that of some future version.
1589 : : */
1590 : :
1591 : : /* Aggregate transition functions */
596 nathan@postgresql.or 1592 : 0 : query = psprintf("SELECT 'aggregate' AS objkind, p.oid::regprocedure::text AS objname "
1593 : : "FROM pg_proc AS p "
1594 : : "JOIN pg_aggregate AS a ON a.aggfnoid=p.oid "
1595 : : "JOIN pg_proc AS transfn ON transfn.oid=a.aggtransfn "
1596 : : "WHERE p.oid >= 16384 "
1597 : : "AND a.aggtransfn = ANY(ARRAY[%s]::regprocedure[]) "
1598 : : "AND a.aggtranstype = ANY(ARRAY['anyarray', 'anyelement']::regtype[]) "
1599 : :
1600 : : /* Aggregate final functions */
1601 : : "UNION ALL "
1602 : : "SELECT 'aggregate' AS objkind, p.oid::regprocedure::text AS objname "
1603 : : "FROM pg_proc AS p "
1604 : : "JOIN pg_aggregate AS a ON a.aggfnoid=p.oid "
1605 : : "JOIN pg_proc AS finalfn ON finalfn.oid=a.aggfinalfn "
1606 : : "WHERE p.oid >= 16384 "
1607 : : "AND a.aggfinalfn = ANY(ARRAY[%s]::regprocedure[]) "
1608 : : "AND a.aggtranstype = ANY(ARRAY['anyarray', 'anyelement']::regtype[]) "
1609 : :
1610 : : /* Operators */
1611 : : "UNION ALL "
1612 : : "SELECT 'operator' AS objkind, op.oid::regoperator::text AS objname "
1613 : : "FROM pg_operator AS op "
1614 : : "WHERE op.oid >= 16384 "
1615 : : "AND oprcode = ANY(ARRAY[%s]::regprocedure[]) "
1616 : : "AND oprleft = ANY(ARRAY['anyarray', 'anyelement']::regtype[])",
1617 : : old_polymorphics.data,
1618 : : old_polymorphics.data,
1619 : : old_polymorphics.data);
1620 : :
1621 : 0 : upgrade_task_add_step(task, query, process_incompat_polymorphics,
1622 : : true, &report);
1623 : 0 : upgrade_task_run(task, cluster);
1624 : 0 : upgrade_task_free(task);
1625 : :
1626 [ # # ]: 0 : if (report.file)
1627 : : {
1628 : 0 : fclose(report.file);
1393 tgl@sss.pgh.pa.us 1629 : 0 : pg_log(PG_REPORT, "fatal");
1400 1630 : 0 : pg_fatal("Your installation contains user-defined objects that refer to internal\n"
1631 : : "polymorphic functions with arguments of type \"anyarray\" or \"anyelement\".\n"
1632 : : "These user-defined objects must be dropped before upgrading and restored\n"
1633 : : "afterwards, changing them to refer to the new corresponding functions with\n"
1634 : : "arguments of type \"anycompatiblearray\" and \"anycompatible\".\n"
1635 : : "A list of the problematic objects is in the file:\n"
1636 : : " %s", report.path);
1637 : : }
1638 : : else
1639 : 0 : check_ok();
1640 : :
1641 : 0 : termPQExpBuffer(&old_polymorphics);
596 nathan@postgresql.or 1642 : 0 : pg_free(query);
1400 tgl@sss.pgh.pa.us 1643 : 0 : }
1644 : :
1645 : : /*
1646 : : * Callback function for processing results of query for
1647 : : * check_for_tables_with_oids()'s UpgradeTask. If the query returned any rows
1648 : : * (i.e., the check failed), write the details to the report file.
1649 : : */
1650 : : static void
596 nathan@postgresql.or 1651 : 0 : process_with_oids_check(DbInfo *dbinfo, PGresult *res, void *arg)
1652 : : {
1653 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1654 : 0 : int ntups = PQntuples(res);
1655 : 0 : int i_nspname = PQfnumber(res, "nspname");
1656 : 0 : int i_relname = PQfnumber(res, "relname");
1657 : :
586 1658 [ # # ]: 0 : if (ntups == 0)
596 1659 : 0 : return;
1660 : :
586 1661 [ # # ]: 0 : if (report->file == NULL &&
1662 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1663 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1664 : :
1665 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1666 : :
596 1667 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1668 : 0 : fprintf(report->file, " %s.%s\n",
1669 : : PQgetvalue(res, rowno, i_nspname),
1670 : : PQgetvalue(res, rowno, i_relname));
1671 : : }
1672 : :
1673 : : /*
1674 : : * Verify that no tables are declared WITH OIDS.
1675 : : */
1676 : : static void
1677 : 0 : check_for_tables_with_oids(ClusterInfo *cluster)
1678 : : {
1679 : : UpgradeTaskReport report;
1680 : 0 : UpgradeTask *task = upgrade_task_create();
1681 : 0 : const char *query = "SELECT n.nspname, c.relname "
1682 : : "FROM pg_catalog.pg_class c, "
1683 : : " pg_catalog.pg_namespace n "
1684 : : "WHERE c.relnamespace = n.oid AND "
1685 : : " c.relhasoids AND"
1686 : : " n.nspname NOT IN ('pg_catalog')";
1687 : :
1688 : 0 : prep_status("Checking for tables WITH OIDS");
1689 : :
1690 : 0 : report.file = NULL;
1691 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1692 : : log_opts.basedir,
1693 : : "tables_with_oids.txt");
1694 : :
1695 : 0 : upgrade_task_add_step(task, query, process_with_oids_check,
1696 : : true, &report);
1697 : 0 : upgrade_task_run(task, cluster);
1698 : 0 : upgrade_task_free(task);
1699 : :
1700 [ # # ]: 0 : if (report.file)
1701 : : {
1702 : 0 : fclose(report.file);
1393 tgl@sss.pgh.pa.us 1703 : 0 : pg_log(PG_REPORT, "fatal");
2351 bruce@momjian.us 1704 : 0 : pg_fatal("Your installation contains tables declared WITH OIDS, which is not\n"
1705 : : "supported anymore. Consider removing the oid column using\n"
1706 : : " ALTER TABLE ... SET WITHOUT OIDS;\n"
1707 : : "A list of tables with the problem is in the file:\n"
1708 : : " %s", report.path);
1709 : : }
1710 : : else
2723 andres@anarazel.de 1711 : 0 : check_ok();
1712 : 0 : }
1713 : :
1714 : : /*
1715 : : * Callback function for processing results of query for
1716 : : * check_for_not_null_inheritance.
1717 : : */
1718 : : static void
305 alvherre@kurilemu.de 1719 :LBC (37) : process_inconsistent_notnull(DbInfo *dbinfo, PGresult *res, void *arg)
1720 : : {
1721 : (37) : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1722 : (37) : int ntups = PQntuples(res);
1723 : (37) : int i_nspname = PQfnumber(res, "nspname");
1724 : (37) : int i_relname = PQfnumber(res, "relname");
1725 : (37) : int i_attname = PQfnumber(res, "attname");
1726 : :
1727 [ # # ]: (37) : if (ntups == 0)
1728 : (37) : return;
1729 : :
305 alvherre@kurilemu.de 1730 [ # # ]:UBC 0 : if (report->file == NULL &&
1731 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1732 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1733 : :
1734 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1735 : :
1736 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1737 : : {
1738 : 0 : fprintf(report->file, " %s.%s.%s\n",
1739 : : PQgetvalue(res, rowno, i_nspname),
1740 : : PQgetvalue(res, rowno, i_relname),
1741 : : PQgetvalue(res, rowno, i_attname));
1742 : : }
1743 : : }
1744 : :
1745 : : /*
1746 : : * check_for_not_null_inheritance()
1747 : : *
1748 : : * An attempt to create child tables lacking not-null constraints that are
1749 : : * present in their parents errors out. This can no longer occur since 18,
1750 : : * but previously there were various ways for that to happen. Check that
1751 : : * the cluster to be upgraded doesn't have any of those problems.
1752 : : */
1753 : : static void
305 alvherre@kurilemu.de 1754 :LBC (12) : check_for_not_null_inheritance(ClusterInfo *cluster)
1755 : : {
1756 : : UpgradeTaskReport report;
1757 : : UpgradeTask *task;
1758 : : const char *query;
1759 : :
1760 : (12) : prep_status("Checking for not-null constraint inconsistencies");
1761 : :
1762 : (12) : report.file = NULL;
1763 : (12) : snprintf(report.path, sizeof(report.path), "%s/%s",
1764 : : log_opts.basedir,
1765 : : "not_null_inconsistent_columns.txt");
1766 : :
1767 : (12) : query = "SELECT nspname, cc.relname, ac.attname "
1768 : : "FROM pg_catalog.pg_inherits i, pg_catalog.pg_attribute ac, "
1769 : : " pg_catalog.pg_attribute ap, pg_catalog.pg_class cc, "
1770 : : " pg_catalog.pg_namespace nc "
1771 : : "WHERE cc.oid = ac.attrelid AND i.inhrelid = ac.attrelid "
1772 : : " AND i.inhparent = ap.attrelid AND ac.attname = ap.attname "
1773 : : " AND cc.relnamespace = nc.oid "
1774 : : " AND ap.attnum > 0 and ap.attnotnull AND NOT ac.attnotnull";
1775 : :
1776 : (12) : task = upgrade_task_create();
1777 : (12) : upgrade_task_add_step(task, query,
1778 : : process_inconsistent_notnull,
1779 : : true, &report);
1780 : (12) : upgrade_task_run(task, cluster);
1781 : (12) : upgrade_task_free(task);
1782 : :
1783 [ # # ]: (12) : if (report.file)
1784 : : {
305 alvherre@kurilemu.de 1785 :UBC 0 : fclose(report.file);
1786 : 0 : pg_log(PG_REPORT, "fatal");
1787 : 0 : pg_fatal("Your installation contains inconsistent NOT NULL constraints.\n"
1788 : : "If the parent column(s) are NOT NULL, then the child column must\n"
1789 : : "also be marked NOT NULL, or the upgrade will fail.\n"
1790 : : "You can fix this by running\n"
1791 : : " ALTER TABLE tablename ALTER column SET NOT NULL;\n"
1792 : : "on each column listed in the file:\n"
1793 : : " %s", report.path);
1794 : : }
1795 : : else
305 alvherre@kurilemu.de 1796 :LBC (12) : check_ok();
1797 : (12) : }
1798 : :
1799 : : /*
1800 : : * Callback function for processing results of query for
1801 : : * check_for_gist_inet_ops()'s UpgradeTask. If the query returned any rows
1802 : : * (i.e., the check failed), write the details to the report file.
1803 : : */
1804 : : static void
117 tgl@sss.pgh.pa.us 1805 :UNC 0 : process_gist_inet_ops_check(DbInfo *dbinfo, PGresult *res, void *arg)
1806 : : {
1807 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1808 : 0 : int ntups = PQntuples(res);
1809 : 0 : int i_nspname = PQfnumber(res, "nspname");
1810 : 0 : int i_relname = PQfnumber(res, "relname");
1811 : :
1812 [ # # ]: 0 : if (ntups == 0)
1813 : 0 : return;
1814 : :
1815 [ # # ]: 0 : if (report->file == NULL &&
1816 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1817 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1818 : :
1819 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1820 : :
1821 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1822 : 0 : fprintf(report->file, " %s.%s\n",
1823 : : PQgetvalue(res, rowno, i_nspname),
1824 : : PQgetvalue(res, rowno, i_relname));
1825 : : }
1826 : :
1827 : : /*
1828 : : * Verify that no indexes use gist_inet_ops/gist_cidr_ops, unless the
1829 : : * opclasses have been changed to not-opcdefault (which would allow
1830 : : * the old server to dump the index definitions with explicit opclasses).
1831 : : */
1832 : : static void
1833 : 0 : check_for_gist_inet_ops(ClusterInfo *cluster)
1834 : : {
1835 : : UpgradeTaskReport report;
1836 : 0 : UpgradeTask *task = upgrade_task_create();
1837 : 0 : const char *query = "SELECT nc.nspname, cc.relname "
1838 : : "FROM pg_catalog.pg_opclass oc, pg_catalog.pg_index i, "
1839 : : " pg_catalog.pg_class cc, pg_catalog.pg_namespace nc "
1840 : : "WHERE oc.opcmethod = " CppAsString2(GIST_AM_OID)
1841 : : " AND oc.opcname IN ('gist_inet_ops', 'gist_cidr_ops')"
1842 : : " AND oc.opcdefault"
1843 : : " AND oc.oid = any(i.indclass)"
1844 : : " AND i.indexrelid = cc.oid AND cc.relnamespace = nc.oid";
1845 : :
1846 : 0 : prep_status("Checking for uses of gist_inet_ops/gist_cidr_ops");
1847 : :
1848 : 0 : report.file = NULL;
1849 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1850 : : log_opts.basedir,
1851 : : "gist_inet_ops.txt");
1852 : :
1853 : 0 : upgrade_task_add_step(task, query, process_gist_inet_ops_check,
1854 : : true, &report);
1855 : 0 : upgrade_task_run(task, cluster);
1856 : 0 : upgrade_task_free(task);
1857 : :
1858 [ # # ]: 0 : if (report.file)
1859 : : {
1860 : 0 : fclose(report.file);
1861 : 0 : pg_log(PG_REPORT, "fatal");
1862 : 0 : pg_fatal("Your installation contains indexes that use btree_gist's\n"
1863 : : "gist_inet_ops or gist_cidr_ops opclasses,\n"
1864 : : "which cannot be binary-upgraded. Replace them with indexes\n"
1865 : : "that use the built-in GiST inet_ops opclass.\n"
1866 : : "A list of indexes with the problem is in the file:\n"
1867 : : " %s", report.path);
1868 : : }
1869 : : else
1870 : 0 : check_ok();
1871 : 0 : }
1872 : :
1873 : : /*
1874 : : * check_for_pg_role_prefix()
1875 : : *
1876 : : * Versions older than 9.6 should not have any pg_* roles
1877 : : */
1878 : : static void
3679 sfrost@snowman.net 1879 :UBC 0 : check_for_pg_role_prefix(ClusterInfo *cluster)
1880 : : {
1881 : : PGresult *res;
1882 : 0 : PGconn *conn = connectToServer(cluster, "template1");
1883 : : int ntups;
1884 : : int i_roloid;
1885 : : int i_rolname;
1250 dgustafsson@postgres 1886 : 0 : FILE *script = NULL;
1887 : : char output_path[MAXPGPATH];
1888 : :
3178 peter_e@gmx.net 1889 : 0 : prep_status("Checking for roles starting with \"pg_\"");
1890 : :
1250 dgustafsson@postgres 1891 : 0 : snprintf(output_path, sizeof(output_path), "%s/%s",
1892 : : log_opts.basedir,
1893 : : "pg_role_prefix.txt");
1894 : :
3679 sfrost@snowman.net 1895 : 0 : res = executeQueryOrDie(conn,
1896 : : "SELECT oid AS roloid, rolname "
1897 : : "FROM pg_catalog.pg_roles "
1898 : : "WHERE rolname ~ '^pg_'");
1899 : :
1250 dgustafsson@postgres 1900 : 0 : ntups = PQntuples(res);
1901 : 0 : i_roloid = PQfnumber(res, "roloid");
1902 : 0 : i_rolname = PQfnumber(res, "rolname");
1903 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1904 : : {
1905 [ # # # # ]: 0 : if (script == NULL && (script = fopen_priv(output_path, "w")) == NULL)
784 michael@paquier.xyz 1906 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
1250 dgustafsson@postgres 1907 : 0 : fprintf(script, "%s (oid=%s)\n",
1908 : : PQgetvalue(res, rowno, i_rolname),
1909 : : PQgetvalue(res, rowno, i_roloid));
1910 : : }
1911 : :
3679 sfrost@snowman.net 1912 : 0 : PQclear(res);
1913 : :
1914 : 0 : PQfinish(conn);
1915 : :
1250 dgustafsson@postgres 1916 [ # # ]: 0 : if (script)
1917 : : {
1918 : 0 : fclose(script);
1919 : 0 : pg_log(PG_REPORT, "fatal");
1920 : 0 : pg_fatal("Your installation contains roles starting with \"pg_\".\n"
1921 : : "\"pg_\" is a reserved prefix for system roles. The cluster\n"
1922 : : "cannot be upgraded until these roles are renamed.\n"
1923 : : "A list of roles starting with \"pg_\" is in the file:\n"
1924 : : " %s", output_path);
1925 : : }
1926 : : else
1927 : 0 : check_ok();
3679 sfrost@snowman.net 1928 : 0 : }
1929 : :
1930 : : /*
1931 : : * Callback function for processing results of query for
1932 : : * check_for_user_defined_encoding_conversions()'s UpgradeTask. If the query
1933 : : * returned any rows (i.e., the check failed), write the details to the report
1934 : : * file.
1935 : : */
1936 : : static void
596 nathan@postgresql.or 1937 : 0 : process_user_defined_encoding_conversions(DbInfo *dbinfo, PGresult *res, void *arg)
1938 : : {
1939 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
1940 : 0 : int ntups = PQntuples(res);
1941 : 0 : int i_conoid = PQfnumber(res, "conoid");
1942 : 0 : int i_conname = PQfnumber(res, "conname");
1943 : 0 : int i_nspname = PQfnumber(res, "nspname");
1944 : :
586 1945 [ # # ]: 0 : if (ntups == 0)
596 1946 : 0 : return;
1947 : :
586 1948 [ # # ]: 0 : if (report->file == NULL &&
1949 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
1950 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
1951 : :
1952 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
1953 : :
596 1954 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
1955 : 0 : fprintf(report->file, " (oid=%s) %s.%s\n",
1956 : : PQgetvalue(res, rowno, i_conoid),
1957 : : PQgetvalue(res, rowno, i_nspname),
1958 : : PQgetvalue(res, rowno, i_conname));
1959 : : }
1960 : :
1961 : : /*
1962 : : * Verify that no user-defined encoding conversions exist.
1963 : : */
1964 : : static void
1965 : 0 : check_for_user_defined_encoding_conversions(ClusterInfo *cluster)
1966 : : {
1967 : : UpgradeTaskReport report;
1968 : 0 : UpgradeTask *task = upgrade_task_create();
1969 : : const char *query;
1970 : :
1971 : 0 : prep_status("Checking for user-defined encoding conversions");
1972 : :
1973 : 0 : report.file = NULL;
1974 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
1975 : : log_opts.basedir,
1976 : : "encoding_conversions.txt");
1977 : :
1978 : : /*
1979 : : * The query below hardcodes FirstNormalObjectId as 16384 rather than
1980 : : * interpolating that C #define into the query because, if that #define is
1981 : : * ever changed, the cutoff we want to use is the value used by
1982 : : * pre-version 14 servers, not that of some future version.
1983 : : */
1984 : 0 : query = "SELECT c.oid as conoid, c.conname, n.nspname "
1985 : : "FROM pg_catalog.pg_conversion c, "
1986 : : " pg_catalog.pg_namespace n "
1987 : : "WHERE c.connamespace = n.oid AND "
1988 : : " c.oid >= 16384";
1989 : :
1990 : 0 : upgrade_task_add_step(task, query,
1991 : : process_user_defined_encoding_conversions,
1992 : : true, &report);
1993 : 0 : upgrade_task_run(task, cluster);
1994 : 0 : upgrade_task_free(task);
1995 : :
1996 [ # # ]: 0 : if (report.file)
1997 : : {
1998 : 0 : fclose(report.file);
1393 tgl@sss.pgh.pa.us 1999 : 0 : pg_log(PG_REPORT, "fatal");
1860 heikki.linnakangas@i 2000 : 0 : pg_fatal("Your installation contains user-defined encoding conversions.\n"
2001 : : "The conversion function parameters changed in PostgreSQL version 14\n"
2002 : : "so this cluster cannot currently be upgraded. You can remove the\n"
2003 : : "encoding conversions in the old cluster and restart the upgrade.\n"
2004 : : "A list of user-defined encoding conversions is in the file:\n"
2005 : : " %s", report.path);
2006 : : }
2007 : : else
2008 : 0 : check_ok();
2009 : 0 : }
2010 : :
2011 : : /*
2012 : : * Callback function for processing results of query for
2013 : : * check_for_unicode_update()'s UpgradeTask. If the query returned any rows
2014 : : * (i.e., the check failed), write the details to the report file.
2015 : : */
2016 : : static void
397 jdavis@postgresql.or 2017 : 0 : process_unicode_update(DbInfo *dbinfo, PGresult *res, void *arg)
2018 : : {
2019 : 0 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
2020 : 0 : int ntups = PQntuples(res);
2021 : 0 : int i_reloid = PQfnumber(res, "reloid");
2022 : 0 : int i_nspname = PQfnumber(res, "nspname");
2023 : 0 : int i_relname = PQfnumber(res, "relname");
2024 : :
2025 [ # # ]: 0 : if (ntups == 0)
2026 : 0 : return;
2027 : :
2028 [ # # ]: 0 : if (report->file == NULL &&
2029 [ # # ]: 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
2030 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
2031 : :
2032 : 0 : fprintf(report->file, "In database: %s\n", dbinfo->db_name);
2033 : :
2034 [ # # ]: 0 : for (int rowno = 0; rowno < ntups; rowno++)
2035 : 0 : fprintf(report->file, " (oid=%s) %s.%s\n",
2036 : : PQgetvalue(res, rowno, i_reloid),
2037 : : PQgetvalue(res, rowno, i_nspname),
2038 : : PQgetvalue(res, rowno, i_relname));
2039 : : }
2040 : :
2041 : : /*
2042 : : * Check if the Unicode version built into Postgres changed between the old
2043 : : * cluster and the new cluster.
2044 : : */
2045 : : static bool
397 jdavis@postgresql.or 2046 :CBC 15 : unicode_version_changed(ClusterInfo *cluster)
2047 : : {
2048 : 15 : PGconn *conn_template1 = connectToServer(cluster, "template1");
2049 : : PGresult *res;
2050 : : char *old_unicode_version;
2051 : : bool unicode_updated;
2052 : :
2053 : 15 : res = executeQueryOrDie(conn_template1, "SELECT unicode_version()");
2054 : 15 : old_unicode_version = PQgetvalue(res, 0, 0);
2055 : 15 : unicode_updated = (strcmp(old_unicode_version, PG_UNICODE_VERSION) != 0);
2056 : :
2057 : 15 : PQclear(res);
2058 : 15 : PQfinish(conn_template1);
2059 : :
2060 : 15 : return unicode_updated;
2061 : : }
2062 : :
2063 : : /*
2064 : : * check_for_unicode_update()
2065 : : *
2066 : : * Check if the version of Unicode in the old server and the new server
2067 : : * differ. If so, check for indexes, partitioned tables, or constraints that
2068 : : * use expressions with functions dependent on Unicode behavior.
2069 : : */
2070 : : static void
2071 : 15 : check_for_unicode_update(ClusterInfo *cluster)
2072 : : {
2073 : : UpgradeTaskReport report;
2074 : : UpgradeTask *task;
2075 : : const char *query;
2076 : :
2077 : : /*
2078 : : * The builtin provider did not exist prior to version 17. While there are
2079 : : * still problems that could potentially be caught from earlier versions,
2080 : : * such as an index on NORMALIZE(), we don't check for that here.
2081 : : */
2082 [ - + ]: 15 : if (GET_MAJOR_VERSION(cluster->major_version) < 1700)
2083 : 15 : return;
2084 : :
2085 : 15 : prep_status("Checking for objects affected by Unicode update");
2086 : :
2087 [ + - ]: 15 : if (!unicode_version_changed(cluster))
2088 : : {
2089 : 15 : check_ok();
2090 : 15 : return;
2091 : : }
2092 : :
397 jdavis@postgresql.or 2093 :UBC 0 : report.file = NULL;
2094 : 0 : snprintf(report.path, sizeof(report.path), "%s/%s",
2095 : : log_opts.basedir,
2096 : : "unicode_dependent_rels.txt");
2097 : :
2098 : 0 : query =
2099 : : /* collations that use built-in Unicode for character semantics */
2100 : : "WITH collations(collid) AS ( "
2101 : : " SELECT oid FROM pg_collation "
2102 : : " WHERE collprovider='b' AND colllocale IN ('C.UTF-8','PG_UNICODE_FAST') "
2103 : : /* include default collation, if appropriate */
2104 : : " UNION "
2105 : : " SELECT 'pg_catalog.default'::regcollation FROM pg_database "
2106 : : " WHERE datname = current_database() AND "
2107 : : " datlocprovider='b' AND datlocale IN ('C.UTF-8','PG_UNICODE_FAST') "
2108 : : "), "
2109 : : /* functions that use built-in Unicode */
2110 : : "functions(procid) AS ( "
2111 : : " SELECT proc.oid FROM pg_proc proc "
2112 : : " WHERE proname IN ('normalize','unicode_assigned','unicode_version','is_normalized') AND "
2113 : : " pronamespace='pg_catalog'::regnamespace "
2114 : : "), "
2115 : : /* operators that use the input collation for character semantics */
2116 : : "coll_operators(operid, procid, collid) AS ( "
2117 : : " SELECT oper.oid, oper.oprcode, collid FROM pg_operator oper, collations "
2118 : : " WHERE oprname IN ('~', '~*', '!~', '!~*', '~~*', '!~~*') AND "
2119 : : " oprnamespace='pg_catalog'::regnamespace AND "
2120 : : " oprright='pg_catalog.text'::pg_catalog.regtype "
2121 : : "), "
2122 : : /* functions that use the input collation for character semantics */
2123 : : "coll_functions(procid, collid) AS ( "
2124 : : " SELECT proc.oid, collid FROM pg_proc proc, collations "
2125 : : " WHERE pronamespace='pg_catalog'::regnamespace AND "
2126 : : " ((proname IN ('lower','initcap','upper','casefold') AND "
2127 : : " pronargs = 1 AND "
2128 : : " proargtypes[0] = 'pg_catalog.text'::pg_catalog.regtype) OR "
2129 : : " (proname = 'substring' AND pronargs = 2 AND "
2130 : : " proargtypes[0] = 'pg_catalog.text'::pg_catalog.regtype AND "
2131 : : " proargtypes[1] = 'pg_catalog.text'::pg_catalog.regtype) OR "
2132 : : " proname LIKE 'regexp_%') "
2133 : : /* include functions behind the operators listed above */
2134 : : " UNION "
2135 : : " SELECT procid, collid FROM coll_operators "
2136 : : "), "
2137 : :
2138 : : /*
2139 : : * Generate patterns to search a pg_node_tree for the above functions and
2140 : : * operators.
2141 : : */
2142 : : "patterns(p) AS ( "
2143 : : " SELECT '{FUNCEXPR :funcid ' || procid::text || '[ }]' FROM functions "
2144 : : " UNION "
2145 : : " SELECT '{OPEXPR :opno ' || operid::text || ' (:\\w+ \\w+ )*' || "
2146 : : " ':inputcollid ' || collid::text || '[ }]' FROM coll_operators "
2147 : : " UNION "
2148 : : " SELECT '{FUNCEXPR :funcid ' || procid::text || ' (:\\w+ \\w+ )*' || "
2149 : : " ':inputcollid ' || collid::text || '[ }]' FROM coll_functions "
2150 : : ") "
2151 : :
2152 : : /*
2153 : : * Match the patterns against expressions used for relation contents.
2154 : : */
2155 : : "SELECT reloid, relkind, nspname, relname "
2156 : : " FROM ( "
2157 : : " SELECT conrelid "
2158 : : " FROM pg_constraint, patterns WHERE conbin::text ~ p "
2159 : : " UNION "
2160 : : " SELECT indexrelid "
2161 : : " FROM pg_index, patterns WHERE indexprs::text ~ p OR indpred::text ~ p "
2162 : : " UNION "
2163 : : " SELECT partrelid "
2164 : : " FROM pg_partitioned_table, patterns WHERE partexprs::text ~ p "
2165 : : " UNION "
2166 : : " SELECT ev_class "
2167 : : " FROM pg_rewrite, pg_class, patterns "
2168 : : " WHERE ev_class = pg_class.oid AND relkind = 'm' AND ev_action::text ~ p"
2169 : : " ) s(reloid), pg_class c, pg_namespace n, pg_database d "
2170 : : " WHERE s.reloid = c.oid AND c.relnamespace = n.oid AND "
2171 : : " d.datname = current_database() AND "
2172 : : " d.encoding = pg_char_to_encoding('UTF8');";
2173 : :
394 nathan@postgresql.or 2174 : 0 : task = upgrade_task_create();
397 jdavis@postgresql.or 2175 : 0 : upgrade_task_add_step(task, query,
2176 : : process_unicode_update,
2177 : : true, &report);
2178 : 0 : upgrade_task_run(task, cluster);
2179 : 0 : upgrade_task_free(task);
2180 : :
2181 [ # # ]: 0 : if (report.file)
2182 : : {
2183 : 0 : fclose(report.file);
2184 : 0 : report_status(PG_WARNING, "warning");
323 peter@eisentraut.org 2185 : 0 : pg_log(PG_WARNING, "Your installation contains relations that might be affected by a new version of Unicode.\n"
2186 : : "A list of potentially-affected relations is in the file:\n"
2187 : : " %s", report.path);
2188 : : }
2189 : : else
397 jdavis@postgresql.or 2190 : 0 : check_ok();
2191 : : }
2192 : :
2193 : : /*
2194 : : * check_new_cluster_replication_slots()
2195 : : *
2196 : : * Validate the new cluster's readiness for migrating replication slots:
2197 : : * - Ensures no existing logical replication slots on the new cluster when
2198 : : * migrating logical slots.
2199 : : * - Ensure conflict detection slot does not exist on the new cluster when
2200 : : * migrating subscriptions with retain_dead_tuples enabled.
2201 : : * - Ensure that the parameter settings on the new cluster necessary for
2202 : : * creating slots are sufficient.
2203 : : */
2204 : : static void
286 akapila@postgresql.o 2205 :GNC 14 : check_new_cluster_replication_slots(void)
2206 : : {
2207 : : PGresult *res;
2208 : : PGconn *conn;
2209 : : int nslots_on_old;
2210 : : int nslots_on_new;
2211 : : int rdt_slot_on_new;
2212 : : int max_replication_slots;
2213 : : char *wal_level;
2214 : : int i_nslots_on_new;
2215 : : int i_rdt_slot_on_new;
2216 : :
2217 : : /*
2218 : : * Logical slots can be migrated since PG17 and a physical slot
2219 : : * CONFLICT_DETECTION_SLOT can be migrated since PG19.
2220 : : */
922 akapila@postgresql.o 2221 [ - + ]:CBC 14 : if (GET_MAJOR_VERSION(old_cluster.major_version) <= 1600)
922 akapila@postgresql.o 2222 :UBC 0 : return;
2223 : :
922 akapila@postgresql.o 2224 :CBC 14 : nslots_on_old = count_old_cluster_logical_slots();
2225 : :
2226 : : /*
2227 : : * Quick return if there are no slots to be migrated and no subscriptions
2228 : : * have the retain_dead_tuples option enabled.
2229 : : */
286 akapila@postgresql.o 2230 [ + + + + ]:GNC 14 : if (nslots_on_old == 0 && !old_cluster.sub_retain_dead_tuples)
922 akapila@postgresql.o 2231 :CBC 10 : return;
2232 : :
2233 : 4 : conn = connectToServer(&new_cluster, "template1");
2234 : :
286 akapila@postgresql.o 2235 :GNC 4 : prep_status("Checking for new cluster replication slots");
2236 : :
2237 [ + + ]: 4 : res = executeQueryOrDie(conn, "SELECT %s AS nslots_on_new, %s AS rdt_slot_on_new "
2238 : : "FROM pg_catalog.pg_replication_slots",
2239 : : nslots_on_old > 0
2240 : : ? "COUNT(*) FILTER (WHERE slot_type = 'logical' AND temporary IS FALSE)"
2241 : : : "0",
2242 [ + + ]: 4 : old_cluster.sub_retain_dead_tuples
2243 : : ? "COUNT(*) FILTER (WHERE slot_name = 'pg_conflict_detection')"
2244 : : : "0");
2245 : :
922 akapila@postgresql.o 2246 [ - + ]:CBC 4 : if (PQntuples(res) != 1)
286 akapila@postgresql.o 2247 :UNC 0 : pg_fatal("could not count the number of replication slots");
2248 : :
286 akapila@postgresql.o 2249 :GNC 4 : i_nslots_on_new = PQfnumber(res, "nslots_on_new");
2250 : 4 : i_rdt_slot_on_new = PQfnumber(res, "rdt_slot_on_new");
2251 : :
2252 : 4 : nslots_on_new = atoi(PQgetvalue(res, 0, i_nslots_on_new));
2253 : :
922 akapila@postgresql.o 2254 [ - + ]:CBC 4 : if (nslots_on_new)
2255 : : {
286 akapila@postgresql.o 2256 [ # # ]:UNC 0 : Assert(nslots_on_old);
617 peter@eisentraut.org 2257 :UBC 0 : pg_fatal("expected 0 logical replication slots but found %d",
2258 : : nslots_on_new);
2259 : : }
2260 : :
286 akapila@postgresql.o 2261 :GNC 4 : rdt_slot_on_new = atoi(PQgetvalue(res, 0, i_rdt_slot_on_new));
2262 : :
2263 [ - + ]: 4 : if (rdt_slot_on_new)
2264 : : {
286 akapila@postgresql.o 2265 [ # # ]:UNC 0 : Assert(old_cluster.sub_retain_dead_tuples);
2266 : 0 : pg_fatal("The replication slot \"pg_conflict_detection\" already exists on the new cluster");
2267 : : }
2268 : :
922 akapila@postgresql.o 2269 :CBC 4 : PQclear(res);
2270 : :
2271 : 4 : res = executeQueryOrDie(conn, "SELECT setting FROM pg_settings "
2272 : : "WHERE name IN ('wal_level', 'max_replication_slots') "
2273 : : "ORDER BY name DESC;");
2274 : :
2275 [ - + ]: 4 : if (PQntuples(res) != 2)
922 akapila@postgresql.o 2276 :UBC 0 : pg_fatal("could not determine parameter settings on new cluster");
2277 : :
922 akapila@postgresql.o 2278 :CBC 4 : wal_level = PQgetvalue(res, 0, 0);
2279 : :
133 msawada@postgresql.o 2280 [ + + + - ]:GNC 4 : if ((nslots_on_old > 0 || old_cluster.sub_retain_dead_tuples) &&
286 akapila@postgresql.o 2281 [ - + ]: 4 : strcmp(wal_level, "minimal") == 0)
286 akapila@postgresql.o 2282 :UNC 0 : pg_fatal("\"wal_level\" must be \"replica\" or \"logical\" but is set to \"%s\"",
2283 : : wal_level);
2284 : :
922 akapila@postgresql.o 2285 :CBC 4 : max_replication_slots = atoi(PQgetvalue(res, 1, 0));
2286 : :
286 akapila@postgresql.o 2287 [ + + ]:GNC 4 : if (old_cluster.sub_retain_dead_tuples &&
2288 [ + + ]: 2 : nslots_on_old + 1 > max_replication_slots)
2289 : 1 : pg_fatal("\"max_replication_slots\" (%d) must be greater than or equal to the number of "
2290 : : "logical replication slots on the old cluster plus one additional slot required "
2291 : : "for retaining conflict detection information (%d)",
2292 : : max_replication_slots, nslots_on_old + 1);
2293 : :
922 akapila@postgresql.o 2294 [ + + ]:CBC 3 : if (nslots_on_old > max_replication_slots)
718 peter@eisentraut.org 2295 : 1 : pg_fatal("\"max_replication_slots\" (%d) must be greater than or equal to the number of "
2296 : : "logical replication slots (%d) on the old cluster",
2297 : : max_replication_slots, nslots_on_old);
2298 : :
922 akapila@postgresql.o 2299 : 2 : PQclear(res);
2300 : 2 : PQfinish(conn);
2301 : :
2302 : 2 : check_ok();
2303 : : }
2304 : :
2305 : : /*
2306 : : * check_new_cluster_subscription_configuration()
2307 : : *
2308 : : * Verify that the max_active_replication_origins configuration specified is
2309 : : * enough for creating the subscriptions. This is required to create the
2310 : : * replication origin for each subscription.
2311 : : */
2312 : : static void
854 2313 : 12 : check_new_cluster_subscription_configuration(void)
2314 : : {
2315 : : PGresult *res;
2316 : : PGconn *conn;
2317 : : int max_active_replication_origins;
2318 : :
2319 : : /* Subscriptions and their dependencies can be migrated since PG17. */
2320 [ - + ]: 12 : if (GET_MAJOR_VERSION(old_cluster.major_version) < 1700)
854 akapila@postgresql.o 2321 :UBC 0 : return;
2322 : :
2323 : : /* Quick return if there are no subscriptions to be migrated. */
650 nathan@postgresql.or 2324 [ + + ]:CBC 12 : if (old_cluster.nsubs == 0)
854 akapila@postgresql.o 2325 : 10 : return;
2326 : :
2327 : 2 : prep_status("Checking for new cluster configuration for subscriptions");
2328 : :
2329 : 2 : conn = connectToServer(&new_cluster, "template1");
2330 : :
2331 : 2 : res = executeQueryOrDie(conn, "SELECT setting FROM pg_settings "
2332 : : "WHERE name = 'max_active_replication_origins';");
2333 : :
2334 [ - + ]: 2 : if (PQntuples(res) != 1)
854 akapila@postgresql.o 2335 :UBC 0 : pg_fatal("could not determine parameter settings on new cluster");
2336 : :
410 msawada@postgresql.o 2337 :CBC 2 : max_active_replication_origins = atoi(PQgetvalue(res, 0, 0));
2338 [ + + ]: 2 : if (old_cluster.nsubs > max_active_replication_origins)
2339 : 1 : pg_fatal("\"max_active_replication_origins\" (%d) must be greater than or equal to the number of "
2340 : : "subscriptions (%d) on the old cluster",
2341 : : max_active_replication_origins, old_cluster.nsubs);
2342 : :
854 akapila@postgresql.o 2343 : 1 : PQclear(res);
2344 : 1 : PQfinish(conn);
2345 : :
2346 : 1 : check_ok();
2347 : : }
2348 : :
2349 : : /*
2350 : : * check_old_cluster_for_valid_slots()
2351 : : *
2352 : : * Verify that all the logical slots are valid and have consumed all the WAL
2353 : : * before shutdown.
2354 : : */
2355 : : static void
648 nathan@postgresql.or 2356 : 17 : check_old_cluster_for_valid_slots(void)
2357 : : {
2358 : : char output_path[MAXPGPATH];
922 akapila@postgresql.o 2359 : 17 : FILE *script = NULL;
2360 : :
2361 : 17 : prep_status("Checking for valid logical replication slots");
2362 : :
2363 : 17 : snprintf(output_path, sizeof(output_path), "%s/%s",
2364 : : log_opts.basedir,
2365 : : "invalid_logical_slots.txt");
2366 : :
2367 [ + + ]: 69 : for (int dbnum = 0; dbnum < old_cluster.dbarr.ndbs; dbnum++)
2368 : : {
2369 : 52 : LogicalSlotInfoArr *slot_arr = &old_cluster.dbarr.dbs[dbnum].slot_arr;
2370 : :
2371 [ + + ]: 59 : for (int slotnum = 0; slotnum < slot_arr->nslots; slotnum++)
2372 : : {
2373 : 7 : LogicalSlotInfo *slot = &slot_arr->slots[slotnum];
2374 : :
2375 : : /* Is the slot usable? */
2376 [ - + ]: 7 : if (slot->invalid)
2377 : : {
922 akapila@postgresql.o 2378 [ # # # # ]:UBC 0 : if (script == NULL &&
2379 : 0 : (script = fopen_priv(output_path, "w")) == NULL)
784 michael@paquier.xyz 2380 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
2381 : :
922 akapila@postgresql.o 2382 : 0 : fprintf(script, "The slot \"%s\" is invalid\n",
2383 : : slot->slotname);
2384 : :
2385 : 0 : continue;
2386 : : }
2387 : :
2388 : : /*
2389 : : * Do additional check to ensure that all logical replication
2390 : : * slots have consumed all the WAL before shutdown.
2391 : : *
2392 : : * Note: This can be satisfied only when the old cluster has been
2393 : : * shut down, so we skip this for live checks.
2394 : : */
648 nathan@postgresql.or 2395 [ + - + + ]:CBC 7 : if (!user_opts.live_check && !slot->caught_up)
2396 : : {
922 akapila@postgresql.o 2397 [ + + - + ]: 3 : if (script == NULL &&
2398 : 1 : (script = fopen_priv(output_path, "w")) == NULL)
784 michael@paquier.xyz 2399 :UBC 0 : pg_fatal("could not open file \"%s\": %m", output_path);
2400 : :
922 akapila@postgresql.o 2401 :CBC 2 : fprintf(script,
2402 : : "The slot \"%s\" has not consumed the WAL yet\n",
2403 : : slot->slotname);
2404 : : }
2405 : :
2406 : : /*
2407 : : * The name "pg_conflict_detection" (defined as
2408 : : * CONFLICT_DETECTION_SLOT) has been reserved for logical
2409 : : * replication conflict detection slot since PG19.
2410 : : */
286 akapila@postgresql.o 2411 [ - + ]:GNC 7 : if (strcmp(slot->slotname, "pg_conflict_detection") == 0)
2412 : : {
286 akapila@postgresql.o 2413 [ # # # # ]:UNC 0 : if (script == NULL &&
2414 : 0 : (script = fopen_priv(output_path, "w")) == NULL)
2415 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
2416 : :
2417 : 0 : fprintf(script,
2418 : : "The slot name \"%s\" is reserved\n",
2419 : : slot->slotname);
2420 : : }
2421 : : }
2422 : : }
2423 : :
922 akapila@postgresql.o 2424 [ + + ]:CBC 17 : if (script)
2425 : : {
2426 : 1 : fclose(script);
2427 : :
2428 : 1 : pg_log(PG_REPORT, "fatal");
617 peter@eisentraut.org 2429 : 1 : pg_fatal("Your installation contains logical replication slots that cannot be upgraded.\n"
2430 : : "You can remove invalid slots and/or consume the pending WAL for other slots,\n"
2431 : : "and then restart the upgrade.\n"
2432 : : "A list of the problematic slots is in the file:\n"
2433 : : " %s", output_path);
2434 : : }
2435 : :
922 akapila@postgresql.o 2436 : 16 : check_ok();
2437 : 16 : }
2438 : :
2439 : : /*
2440 : : * Callback function for processing results of query for
2441 : : * check_old_cluster_subscription_state()'s UpgradeTask. If the query returned
2442 : : * any rows (i.e., the check failed), write the details to the report file.
2443 : : */
2444 : : static void
596 nathan@postgresql.or 2445 : 50 : process_old_sub_state_check(DbInfo *dbinfo, PGresult *res, void *arg)
2446 : : {
2447 : 50 : UpgradeTaskReport *report = (UpgradeTaskReport *) arg;
586 2448 : 50 : int ntups = PQntuples(res);
596 2449 : 50 : int i_srsubstate = PQfnumber(res, "srsubstate");
2450 : 50 : int i_subname = PQfnumber(res, "subname");
2451 : 50 : int i_nspname = PQfnumber(res, "nspname");
2452 : 50 : int i_relname = PQfnumber(res, "relname");
2453 : :
586 2454 [ + + ]: 50 : if (ntups == 0)
2455 : 49 : return;
2456 : :
2457 [ - + ]: 1 : if (report->file == NULL &&
586 nathan@postgresql.or 2458 [ # # ]:UBC 0 : (report->file = fopen_priv(report->path, "w")) == NULL)
2459 : 0 : pg_fatal("could not open file \"%s\": %m", report->path);
2460 : :
586 nathan@postgresql.or 2461 [ + + ]:CBC 2 : for (int i = 0; i < ntups; i++)
596 2462 : 1 : fprintf(report->file, "The table sync state \"%s\" is not allowed for database:\"%s\" subscription:\"%s\" schema:\"%s\" relation:\"%s\"\n",
2463 : : PQgetvalue(res, i, i_srsubstate),
2464 : : dbinfo->db_name,
2465 : : PQgetvalue(res, i, i_subname),
2466 : : PQgetvalue(res, i, i_nspname),
2467 : : PQgetvalue(res, i, i_relname));
2468 : : }
2469 : :
2470 : : /*
2471 : : * check_old_cluster_subscription_state()
2472 : : *
2473 : : * Verify that the replication origin corresponding to each of the
2474 : : * subscriptions are present and each of the subscribed tables is in
2475 : : * 'i' (initialize) or 'r' (ready) state.
2476 : : */
2477 : : static void
854 akapila@postgresql.o 2478 : 16 : check_old_cluster_subscription_state(void)
2479 : : {
596 nathan@postgresql.or 2480 : 16 : UpgradeTask *task = upgrade_task_create();
2481 : : UpgradeTaskReport report;
2482 : : const char *query;
2483 : : PGresult *res;
2484 : : PGconn *conn;
2485 : : int ntup;
2486 : :
854 akapila@postgresql.o 2487 : 16 : prep_status("Checking for subscription state");
2488 : :
596 nathan@postgresql.or 2489 : 16 : report.file = NULL;
2490 : 16 : snprintf(report.path, sizeof(report.path), "%s/%s",
2491 : : log_opts.basedir,
2492 : : "subs_invalid.txt");
2493 : :
2494 : : /*
2495 : : * Check that all the subscriptions have their respective replication
2496 : : * origin. This check only needs to run once.
2497 : : */
2498 : 16 : conn = connectToServer(&old_cluster, old_cluster.dbarr.dbs[0].db_name);
2499 : 16 : res = executeQueryOrDie(conn,
2500 : : "SELECT d.datname, s.subname "
2501 : : "FROM pg_catalog.pg_subscription s "
2502 : : "LEFT OUTER JOIN pg_catalog.pg_replication_origin o "
2503 : : " ON o.roname = 'pg_' || s.oid "
2504 : : "INNER JOIN pg_catalog.pg_database d "
2505 : : " ON d.oid = s.subdbid "
2506 : : "WHERE o.roname IS NULL;");
2507 : 16 : ntup = PQntuples(res);
2508 [ + + ]: 17 : for (int i = 0; i < ntup; i++)
2509 : : {
2510 [ + - ]: 1 : if (report.file == NULL &&
2511 [ - + ]: 1 : (report.file = fopen_priv(report.path, "w")) == NULL)
596 nathan@postgresql.or 2512 :UBC 0 : pg_fatal("could not open file \"%s\": %m", report.path);
596 nathan@postgresql.or 2513 :CBC 1 : fprintf(report.file, "The replication origin is missing for database:\"%s\" subscription:\"%s\"\n",
2514 : : PQgetvalue(res, i, 0),
2515 : : PQgetvalue(res, i, 1));
2516 : : }
2517 : 16 : PQclear(res);
2518 : 16 : PQfinish(conn);
2519 : :
2520 : : /*
2521 : : * We don't allow upgrade if there is a risk of dangling slot or origin
2522 : : * corresponding to initial sync after upgrade.
2523 : : *
2524 : : * A slot/origin not created yet refers to the 'i' (initialize) state,
2525 : : * while 'r' (ready) state refers to a slot/origin created previously but
2526 : : * already dropped. These states are supported for pg_upgrade. The other
2527 : : * states listed below are not supported:
2528 : : *
2529 : : * a) SUBREL_STATE_DATASYNC: A relation upgraded while in this state would
2530 : : * retain a replication slot and origin. The sync worker spawned after the
2531 : : * upgrade cannot drop them because the subscription ID used for the slot
2532 : : * and origin name no longer matches.
2533 : : *
2534 : : * b) SUBREL_STATE_SYNCDONE: A relation upgraded while in this state would
2535 : : * retain the replication origin when there is a failure in tablesync
2536 : : * worker immediately after dropping the replication slot in the
2537 : : * publisher.
2538 : : *
2539 : : * c) SUBREL_STATE_FINISHEDCOPY: A tablesync worker spawned to work on a
2540 : : * relation upgraded while in this state would expect an origin ID with
2541 : : * the OID of the subscription used before the upgrade, causing it to
2542 : : * fail.
2543 : : *
2544 : : * d) SUBREL_STATE_SYNCWAIT, SUBREL_STATE_CATCHUP and
2545 : : * SUBREL_STATE_UNKNOWN: These states are not stored in the catalog, so we
2546 : : * need not allow these states.
2547 : : */
2548 : 16 : query = "SELECT r.srsubstate, s.subname, n.nspname, c.relname "
2549 : : "FROM pg_catalog.pg_subscription_rel r "
2550 : : "LEFT JOIN pg_catalog.pg_subscription s"
2551 : : " ON r.srsubid = s.oid "
2552 : : "LEFT JOIN pg_catalog.pg_class c"
2553 : : " ON r.srrelid = c.oid "
2554 : : "LEFT JOIN pg_catalog.pg_namespace n"
2555 : : " ON c.relnamespace = n.oid "
2556 : : "WHERE r.srsubstate NOT IN ('i', 'r') "
2557 : : "ORDER BY s.subname";
2558 : :
2559 : 16 : upgrade_task_add_step(task, query, process_old_sub_state_check,
2560 : : true, &report);
2561 : :
2562 : 16 : upgrade_task_run(task, &old_cluster);
2563 : 16 : upgrade_task_free(task);
2564 : :
2565 [ + + ]: 16 : if (report.file)
2566 : : {
2567 : 1 : fclose(report.file);
854 akapila@postgresql.o 2568 : 1 : pg_log(PG_REPORT, "fatal");
2569 : 1 : pg_fatal("Your installation contains subscriptions without origin or having relations not in i (initialize) or r (ready) state.\n"
2570 : : "You can allow the initial sync to finish for all relations and then restart the upgrade.\n"
2571 : : "A list of the problematic subscriptions is in the file:\n"
2572 : : " %s", report.path);
2573 : : }
2574 : : else
2575 : 15 : check_ok();
2576 : 15 : }
2577 : :
2578 : : /*
2579 : : * check_old_cluster_global_names()
2580 : : *
2581 : : * Raise an error if any database, role, or tablespace name contains a newline
2582 : : * or carriage return character. Such names are not allowed in v19 and later.
2583 : : */
2584 : : static void
73 andrew@dunslane.net 2585 :UNC 0 : check_old_cluster_global_names(ClusterInfo *cluster)
2586 : : {
2587 : : int i;
2588 : : PGconn *conn_template1;
2589 : : PGresult *res;
2590 : : int ntups;
71 2591 : 0 : FILE *script = NULL;
2592 : : char output_path[MAXPGPATH];
73 2593 : 0 : int count = 0;
2594 : :
2595 : 0 : prep_status("Checking names of databases, roles and tablespaces");
2596 : :
2597 : 0 : snprintf(output_path, sizeof(output_path), "%s/%s",
2598 : : log_opts.basedir,
2599 : : "db_role_tablespace_invalid_names.txt");
2600 : :
2601 : 0 : conn_template1 = connectToServer(cluster, "template1");
2602 : :
2603 : : /*
2604 : : * Get database, user/role and tablespace names from cluster. Can't use
2605 : : * pg_authid because only superusers can view it.
2606 : : */
2607 : 0 : res = executeQueryOrDie(conn_template1,
2608 : : "SELECT datname AS objname, 'database' AS objtype "
2609 : : "FROM pg_catalog.pg_database UNION ALL "
2610 : : "SELECT rolname AS objname, 'role' AS objtype "
2611 : : "FROM pg_catalog.pg_roles UNION ALL "
2612 : : "SELECT spcname AS objname, 'tablespace' AS objtype "
2613 : : "FROM pg_catalog.pg_tablespace ORDER BY 2 ");
2614 : :
2615 : 0 : ntups = PQntuples(res);
2616 [ # # ]: 0 : for (i = 0; i < ntups; i++)
2617 : : {
71 2618 : 0 : char *objname = PQgetvalue(res, i, 0);
2619 : 0 : char *objtype = PQgetvalue(res, i, 1);
2620 : :
2621 : : /* If name has \n or \r, then report it. */
73 2622 [ # # ]: 0 : if (strpbrk(objname, "\n\r"))
2623 : : {
2624 [ # # # # ]: 0 : if (script == NULL && (script = fopen_priv(output_path, "w")) == NULL)
2625 : 0 : pg_fatal("could not open file \"%s\": %m", output_path);
2626 : :
2627 : 0 : fprintf(script, "%d : %s name = \"%s\"\n", ++count, objtype, objname);
2628 : : }
2629 : : }
2630 : :
2631 : 0 : PQclear(res);
2632 : 0 : PQfinish(conn_template1);
2633 : :
2634 [ # # ]: 0 : if (script)
2635 : : {
2636 : 0 : fclose(script);
2637 : 0 : pg_log(PG_REPORT, "fatal");
2638 : 0 : pg_fatal("All the database, role and tablespace names should have only valid characters. A newline or \n"
2639 : : "carriage return character is not allowed in these object names. To fix this, please \n"
2640 : : "rename these names with valid names. \n"
2641 : : "To see all %d invalid object names, refer db_role_tablespace_invalid_names.txt file. \n"
2642 : : " %s", count, output_path);
2643 : : }
2644 : : else
2645 : 0 : check_ok();
2646 : 0 : }
|