Release date: 2021-12-06
This is expected to be the last Postgres Pro Enterprise release in the 9.6 series. Users are encouraged to update to a newer Postgres Pro Enterprise major version soon.
This release is based on PostgreSQL 9.6.24 and Postgres Pro Enterprise 9.6.23.1. All improvements inherited from PostgreSQL 9.6.24 are listed in PostgreSQL 9.6.24 Release Notes. As compared with Postgres Pro Enterprise 9.6.23.1, this version also provides the following changes:
Dropped support for the sr_plan extension.
Upgraded mamonsu to version 3.1.0. Notable changes are as follows:
A new option for bootstrap is added. With this option,
if -dbname is not explicitly specified, its value will be automatically set to the
database name defined in the [postgres] section of the mamonsu
configuration file.
A critical issue is fixed that could arise when the bootstrap step was skipped.
In this case, although a user can work with mamonsu under superuser permissions,
the special mamonsu schema is not created, but
after creating the auxiliary extension pg_buffercache
in any other schema, running mamonsu resulted in errors
“ERROR: relation "mamonsu.pg_buffercache" does not exist...”.
Fixed an issue with incorrect handling of short (4-byte) XIDs during heap page pruning, which could cause generation of suboptimal WAL traffic consisting of full-page images.
Fixed a pg_probackup issue with archiving WAL from a
directory outside of the data directory. Previously, multi-threaded and batch optimizations of archive-push
prevented such archiving; now it is possible to archive WAL from any directory, but if it is outside of the data directory,
multi-threaded and batch optimizations are automatically turned off.
Deprecated WAITLSN command.
Leveraged sparse file functionality in Windows for CFS,
which optimizes on-disk size of *.cfm files, up to 1MB each.
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.