E.12. Postgres Pro Standard 9.6.14.1

Release date: 2019-07-03

E.12.1. Overview

This release is based on PostgreSQL 9.6.14 and Postgres Pro Standard 9.6.13.1. All improvements inherited from PostgreSQL 9.6.14 are listed in PostgreSQL 9.6.14 Release Notes.

Major enhancements over Postgres Pro Standard 9.6.13.1 include:

  • Updated pg_probackup module to version 2.1.3. As compared with version 2.0.26, it offers the following major improvements:

    • Backup and restore of a remote Postgres Pro instance via SSH.

    • Merging incremental backups with their expired parent backups to satisfy retention policy.

    • Backing up files and directories located outside of Postgres Pro data directory, such as configuration or log files.

    • The checkdb command for validating all data files in the Postgres Pro instance and logical verification of indexes using amcheck.

    For a full list of changes, see pg_probackup Wiki.

  • Updated pg_pathman module to version 1.5.8. As compared to version 1.5.5 provided in the previous Postgres Pro releases, the following enhancements were introduced:

    • Fixed handling of tables with multilevel partitioning. Previously, SELECT FOR SHARE and SELECT FOR UPDATE commands for such tables could return the following error: ERROR: variable not found in subplan target lists.

    • Enhanced pg_pathman stability.

E.12.2. Migration to Version 9.6.14.1

Depending on your current installation, the upgrade procedure will differ.

To upgrade from a Postgres Pro Standard version based on any previous PostgreSQL major release, make sure you have installed its latest minor version, and then perform a dump/restore using pg_dumpall or use the pg_upgrade utility.

To upgrade from a Postgres Pro Standard version based on the same PostgreSQL major release, a dump/restore is not required.

Since pg_probackup delivery model changed in Postgres Pro Standard 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.8.2 or lower, you must call the REINDEX command for indexes that used mchar or mvarchar types.

If you are upgrading from Postgres Pro Standard 9.6.7.1 or lower, you must also use the pgpro_upgrade script provided in this distribution. This script updates metadata information to handle catalog number format change introduced after Postgres Pro Standard 9.6.4.1, as well as rename the pgpro_build function to pgpro_source_id. If you are upgrading your Postgres Pro installation from a binary package, the pgpro_upgrade script is run automatically, unless you are prompted to run it manually.

Note

If you run pgpro_upgrade manually, you must stop postgres service. The script must be run on behalf of the user owning the database (typically postgres). Running pgpro_upgrade as root will result in an error. For details, see pgpro_upgrade.

If you have compiled Postgres Pro from source code or created your database in a non-default location, you must run the pgpro_upgrade script manually.

Note

On RPM-based Linux distributions, if you are upgrading from version 9.6.2.1 or lower, make sure to move the data directory from pgsql to the pgpro directory before running the pgpro_upgrade script.

To migrate from vanilla PostgreSQL 9.6.x, make sure you have installed its latest available minor version and then perform a dump/restore using pg_dumpall.