E.2. Postgres Pro Enterprise 9.6.23.1
Release date: 2021-09-07
E.2.1. Overview
This release is based on PostgreSQL 9.6.23 and Postgres Pro Enterprise 9.6.22.1. All improvements inherited from PostgreSQL 9.6.23 are listed in PostgreSQL 9.6.23 Release Notes. As compared with Postgres Pro Enterprise 9.6.22.1, this version also provides the following changes:
Upgraded mamonsu to version 3.0, which is incompatible with the previous one. Read mamonsu Compatibility Considerations to learn what you need to do to continue using the application.
Fixed an issue with pgpro_scheduler that could result in a failure to stop a stand-by server, e.g. with
pg_ctl.Fixed the behavior of
ALTER TABLE IF EXISTScommand in the case when the source table is missing and the pg_pathman extension was loaded. Previously,tableRENAME TOtable1ERRORwas returned, and nowNOTICEis generated, which is how Postgres Pro behaves with no pg_pathman extension loaded.Upgraded pg_probackup to version 2.5.1, which added a new
catchupcommand to copy a Postgres Pro instance directly, without using the backup catalog. This allows you to add a new standby server in a parallel mode or to have a fallen-behind standby server “catch up” with master.Implemented I/O buffering in CFS, which can improve performance on HDD.
Fixed the behavior of pg_wait_sampling in case of interrupting a client backend that accessed the shared queue. Previously, the pg_wait_sampling collector could hang in such cases and block other backends trying to read the
pg_wait_sampling_profileview.
E.2.2. Migration to Version 9.6.23.1
Depending on your current installation, the upgrade procedure will differ.
To migrate from vanilla PostgreSQL 9.6.x or Postgres Pro Standard, make sure you have installed its latest minor version and then perform a dump/restore using pg_dumpall. Besides, make sure to pay special attention to implementation specifics of 64-bit transaction IDs. If you have used explicit casts to 32-bit integers when handling transaction IDs, you have to replace them with casts to bigint since 64-bit transaction IDs are of the bigint type.
While functions numeric_eq, numeric_ne, numeric_gt, numeric_ge, numeric_lt, and numeric_le are actually leakproof, they were not marked as such in Postgres Pro Enterprise 9.6.16.1 or lower, which could lead to incorrect query optimization. In particular, it negatively affected query execution if row-level security policy was in use. Version 9.6.17.1 repairs this issue for new installations by correcting the initial catalog data, but existing installations will still have incorrect markings unless you update pg_proc entries for these functions. You can run pg_upgrade to upgrade your server instance to a version containing the corrected initial data, or manually correct these entries in each database of the installation using the ALTER FUNCTION command. For example:
ALTER FUNCTION pg_catalog.numeric_eq LEAKPROOF
To upgrade from a Postgres Pro Enterprise version based on the same PostgreSQL major release, a dump/restore is not required. It is usually enough to install the new version into the same installation directory. Once the new binaries are installed, the pgpro_upgrade script is run automatically to check whether additional setup is required and complete the upgrade.
Before Postgres Pro Enterprise 9.6.15.1, functions age and mxid_age returned 32-bit values for 64-bit transaction identifiers. Even after upgrade, previous installations would still have incorrect function definitions. You should manually correct the definitions in each database of the installation using the following commands:
ALTER FUNCTION pg_catalog.age(xid) RENAME TO xid_age_old;
CREATE FUNCTION pg_catalog.age(xid) RETURNS bigint STABLE PARALLEL RESTRICTED LANGUAGE INTERNAL AS 'xid_age';
ALTER FUNCTION pg_catalog.mxid_age(xid) RENAME TO mxid_age_old;
CREATE FUNCTION pg_catalog.mxid_age(xid) RETURNS bigint STABLE PARALLEL SAFE LANGUAGE INTERNAL AS 'mxid_age';
Since pg_probackup delivery model changed in Postgres Pro Enterprise 9.6.12.1, when upgrading from a lower version on ALT Linux and Debian-based systems, run apt dist-upgrade (or apt-get dist-upgrade) to ensure that all new dependencies are handled correctly. On Windows, you have to run a separate pg_probackup installer to complete the upgrade.
When upgrading from versions 9.6.9.1 through 9.6.14.1, you must run the REINDEX command to rebuild GIN, GiST, and SP-GiST indexes to fix replication issues that could be observed in these versions. You should also retake all backups for these versions if your database had such indexes.
When upgrading from versions 9.6.8.2 or lower, you have to rebuild indexes that used mchar or mvarchar types.
When upgrading from versions 9.6.2.1 or lower, you have to rebuild GiST indexes built over columns of the intarray type.
When upgrading from version 9.6.1.2 on RPM-based Linux distributions, make sure to move the data directory from pgsql to the pgproee directory before running the pgpro_upgrade script.
For some Linux distributions, you may be prompted to run pgpro_upgrade manually. In this case, you must stop the postgres service. The script must be run on behalf of the user owning the database (typically postgres) and PGDATA environment variable should be set to the directory where database resides. Running pgpro_upgrade as root will result in an error. This step is not required when upgrading from version 9.6.4.1 or higher.