Postgres Pro Enterprise
9.6
Postgres Pro Standard
9.69.5
RUENRU EN
pgpro_upgrade
Пред. НаверхIII. Серверные приложения Postgres ProНачало След.

pgpro_upgrade

pgpro_upgrade — обновить кластер баз данных Postgres Pro до следующей корректирующей версии

Синтаксис

pgpro_upgrade [{ -D | --pgdata }каталог] [ --check ]

pgpro_upgrade [ --help ]

Описание

pgpro_upgrade — скрипт оболочки, включённый в состав дистрибутива Postgres Pro для упрощения установки корректирующих версий Postgres Pro, основанных на одном базовом выпуске PostgreSQL. Этот скрипт проверяет, были ли внесены новой версией изменения в системный каталог, и производит соответствующие модификации в существующем кластере баз данных. При запуске без параметров pgpro_upgrade обновляет кластер, заданный в переменной окружения PGDATA.

Параметры

pgpro_upgrade принимает следующие аргументы командной строки:

-D каталог
--pgdata каталог

Задаёт каталог данных кластера, подлежащего обновлению. По умолчанию pgpro_upgrade обновляет кластер в каталоге, на который указывает переменная окружения PGDATA.

--check

Проверяет, требуется ли модифицировать указанный кластер баз данных, не внося при этом никаких изменений. Возвращаемые значения:

  • 0, если модификации не требуются.

  • 1, если для обновления кластера требуются модификации.

-h
--help

Показать справку, а затем завершиться.

Использование

Для корректирующих выпусков Postgres Pro, в которых происходят изменения в системных каталогах по сравнению с предыдущими версиями, необходимо запускать pgpro_upgrade после установки обновлений. Если вы обновляете вашу инсталляцию Postgres Pro, используя двоичный пакет, скрипт pgpro_upgrade запускается автоматически, либо вам предлагается запустить его вручную. Если вы скомпилировали Postgres Pro из исходного кода или разместили базу данных в нестандартном расположении, вы должны выполнить скрипт pgpro_upgrade вручную.

По умолчанию pgpro_upgrade располагается в пути каталог-инсталляции/bin, где каталог-инсталляции — каталог, в который установлен Postgres Pro. Чтобы вручную выполнить pgpro_upgrade, следуйте этой процедуре:

  1. Остановите службу postgres.

  2. Установите новую версию Postgres Pro в текущий каталог инсталляции.

  3. От имени системного пользователя, владеющего базой данных, запустите скрипт pgpro_upgrade с параметром -D, указав путь к кластеру, подлежащему обновлению: 

    каталог-инсталляции/bin/pgpro_upgrade -D каталог

    Скрипт проверяет, требуются ли изменения, и в случае необходимости производит соответствующие модификации в системных каталогах кластера.

Примечание

В системах Windows вы также можете запустить pgpro_upgrade, воспользовавшись обёрткой каталог-инсталляции/scripts/pgpro_upgrade.cmd, предоставленной для удобства. Этот командный файл запускает скрипт pgpro_upgrade для кластера по умолчанию, не требуя указания никаких аргументов.

См. также

pg_upgrade
Пред. Начало След.
pg_upgrade Наверх pg_xlogdump
pgpro_upgrade
Prev UpIII. Postgres Pro Server ApplicationsHome Next

pgpro_upgrade

pgpro_upgrade — upgrade a Postgres Pro database cluster to a minor update version

Synopsis

pgpro_upgrade [{ -D | --pgdata } directory] [ --check ]

pgpro_upgrade [ --help ]

Description

pgpro_upgrade is a shell script provided in the Postgres Pro distribution to facilitate Postgres Pro upgrades to minor update versions based on the same PostgreSQL major version. This script checks whether the new version introduces any system catalog changes and adds the corresponding features into the catalog of the existing database cluster. When run without any options, pgpro_upgrade upgrades the cluster specified in the PGDATA environment variable.

Options

pgpro_upgrade accepts the following command-line arguments:

-D directory
--pgdata directory

Specify the data directory of the database cluster to be upgraded. By default, pgpro_upgrade upgrades the cluster specified in the PGDATA environment variable.

--check

Check whether the specified database cluster needs to be upgraded, without changing any data. Return values are:

  • 0 if no changes are required.

  • 1 if the cluster needs to be upgraded.

-h
--help

Show help, then exit.

Usage

For Postgres Pro minor updates that introduce any system catalog changes as compared to the previous version, pgpro_upgrade must be run to update system catalogs after installing such updates. 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. 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.

By default, pgpro_upgrade is located in install-dir/bin, where install-dir is the Postgres Pro installation directory. To manually run pgpro_upgrade, follow this procedure:

  1. Stop the postgres service.

  2. Install the new Postgres Pro version into your current installation directory.

  3. On behalf of the system user owning the database, run the pgpro_upgrade script with the -D option specifying the database cluster to upgrade: 

    install-dir/bin/pgpro_upgrade -D directory

    The script checks whether any changes are needed and updates the system catalogs accordingly, if required.

Note

On Windows systems, you can also run pgpro_upgrade using install-dir/scripts/pgpro_upgrade.cmd wrapper provided for convenience. This wrapper launches the pgpro_upgrade script for the default database cluster, without taking any arguments.

See Also

pg_upgrade
Prev Home Next
pg_upgrade Up pg_xlogdump
FAQ