E.2. Postgres Pro Standard 10.22.1

Release Date: 2022-08-22

E.2.1. Overview

This release is based on PostgreSQL 10.22 and Postgres Pro Standard 10.21.1. All changes inherited from PostgreSQL 10.22 are listed in PostgreSQL 10.22 Release Notes. Other major changes and enhancements are as follows:

  • Upgraded mamonsu to version 3.5.1. Notable changes are as follows:

    • Resolved the security issue of exposing passwords through the configuration file. Only mamonsu user can access agent.conf now.

    • Fixed metrics computation that caused float division by zero errors in the mamonsu STATEMENTS plugin.

  • Upgraded pg_probackup to version 2.5.7, which provides the following new features and bugfixes:

    • Added the --dry-run flag to the catchup command to allow you to estimate the size of data files to be transferred, but make no changes on disk.

    • Fixed a bug that prevented correct rereading of a block after a message File: ... blknum ... have wrong checksum, try again was issued.

    • Enabled output of logs in the JSON format by adding new logging options.

    • Added an option to explicitly specify the directory where the restore command should restore WAL records.

    • Changed the level of detail of logging some messages of pg_probackup commands to add user convenience to reading logs.

    • Fixed pg_probackup hanging that could occur when the ControlMaster option was specified in the SSH config file. Now the value of ControlMaster is explicitly set to no.

E.2.2. Migration to Version 10.22.1

If you are upgrading from a Postgres Pro Standard version based on the same PostgreSQL major release, it is enough to install the new version into your current installation directory.

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 Standard 10.11.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 10.12.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

Starting from Postgres Pro Standard 10.11.1, the ICU library upgrade does not interfere with the server start. Before connecting to a database using ICU as the default collation, Postgres Pro compares this collation version to the one provided by the ICU library and displays a warning if the collation versions do not match; you may need to rebuild the objects that depend on the default collation if you think the collation change may affect the sort order of your data. To suppress these warnings, you can use the ALTER COLLATION "default" REFRESH VERSION command, as explained in ALTER COLLATION.

Since pg_probackup delivery model changed in Postgres Pro Standard 10.7.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 version 10.3.2 or lower, you must call the REINDEX command for indexes that used mchar or mvarchar types. Besides, if you have been using pg_repack on Debian-based systems, you have to reinstall its package manually when upgrading to this version since its package got renamed to pg-repack-std-10.

To migrate from PostgreSQL or a Postgres Pro Standard release based on a previous PostgreSQL major version, see the migration instructions for version 10. If you are opting for a dump/restore, make sure to use the --add-collprovider option to correctly choose the provider for the default collation of the migrated database.