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