Обновление системных каталогов Pangolin без изменения структуры данных#

Описание решения#

Для выполнения задачи обновления каталога используется инструмент inplace_upgrade.sh, который применяет заранее подготовленные разработчиками SQL-скрипты обновления системного каталога (правила написания приведены в разделе «Правила написания SQL-скриптов для обновления системных данных каталога»), а также утилиту update_catalog_version для изменения версии каталога в global/pg_control. Скрипт обновления и все что он использует находится в директории installer/utilities/pg_inplace_upgrade.

Внимание!

Скрипт inplace_upgrade.sh, прилагаемые SQL-скрипты обновления и утилита update_catalog_version являются необходимыми для корректной работы. Изменение/удаление любого из них приведет к неправильной работе утилиты.

Наличие скрипта недостаточно для проведения обновления – для работы скриптов обновления необходимы бинарные функции, доступные с версии Pangolin 6.4.0.

При обновлении каталога меняется содержимое системных таблиц pg_catalog (таких, как pg_class, pg_type и т.д.). Сами системные таблицы и индексы в данном типе обновления не затрагиваются. Объекты базы данных (функции, представления, типы) описаны в системном каталоге и хранятся в виде записей его таблиц. Добавлять или изменять можно только объекты по OID до 16383 включительно. Все объекты OID которых выше 16383 не должны меняться c помощью SQL-скриптов обновления, так как они относятся к пользовательским объектам, изменение которых не предусмотрено.

inplace_upgrade.sh использует функцию ядра block_user_data_modification для установки ограничений на следующий ряд SQL-операций на время ее работы:

DROP TYPE/FUNCTION/VIEW;
ALTER TYPE/FUNCTION/VIEW ... RENAME;
CREATE OR REPLACE FUNCTION/VIEW, кроме CREATE FUNCTION/VIEW.

Вышеперечисленные ограничения можно при необходимости снять, тем самым разрешив любые изменения системного и пользовательских каталогов, но это увеличит вероятность порчи пользовательских данных и системного каталога в случае наличия ошибок в SQL скриптах. Снятие ограничений производится флагом --drop-on.

По-сравнению с pg_upgrade инструмент работает гораздо быстрее, так как не выполняет полную выгрузку и загрузку данных системного каталога.

Скрипт inplace_upgrade.sh#

Скрипт выполняет обновление системного каталога для всех баз данных СУБД. Также обновляется номер версии системного каталога в global/pg_control и имена папок пользовательских табличных пространств PG_<MAJOR_POSTGRESQL>_<CATALOG_VERSION_NO>.

При вызове скрипта inplace_upgrade.sh используются ключи:

Обязательные ключи:
- -s | --utildir - директория со скриптом inplace_upgrade.sh, утилитой update_catalog_version и папкой sql_upgrade_6xx, содержащей SQL-скрипты для обновления pg_catalog. SQL-скрипты пишутся разработчиками в соответствии изменениями в pg_catalog, которые вносят их доработки. В случае стандартной установки данный параметр имеет значение installer/utilities/pg_inplace_upgrade;
- -d | --pgdatadir - путь к директории с данными (обычно имеет такое же значение, как и $PGDATA);
- -l | --logdir - директория для сохранения логов:
  - логи PostgreSQL, сгенерированные в процессе обновления, записываются в файл postgres_update.log;
  - полный лог работы скрипта обновления inplace_upgrade.sh записываются в файл inplace_upgrade.log;
  - короткий отчет обновления report.log;
- -h | --host - хост СУБД для подключения pg_dump и psql;
- -p | --port - порт СУБД для подключения pg_dump, pg_ctl и psql;
- -u | --user - пользователь СУБД с правами суперпользователя для подключения pg_dump и psql;
- -n | --old-version - текущая версия продукта (например 6.1.8 для СУБД Pangolin 6.1.8). Формат строки проверяется;
- -N | --new-version - версия продукта на которую происходит обновление (например 6.4.0 для СУБД Pangolin 6.4.0). Формат строки проверяется;
- -b | --dbname - имя базы данных для подключения pg_dump и psql (обычно имеет значение postgres);
- -m | --dumpdir - директория для сохранения дампов (sql-дампы до, после и после отката обновления);
- -B | --backupdir - директория для сохранения:
  - резервной копии файлов системного каталога;
  - файлов с перечнем таблиц и индексов системного каталога и информацией о соответствующих им файлах;
  - файл user_tbls.txt с директориями пользовательских табличных пространств;
  - файл version.txt с версией PostgreSQL до обновления;
- -t | --pg_ctldir - директория с исполняемыми файлами утилит pg_ctl и postgres новой версии;
- -T | --pg_utildir - директория с исполняемыми файлами утилит psql и pg_dump новой версии.

Необязательные ключи:

-P | --password - пароль для подключения к СУБД. Если не задан, то пароль берется из переменной окружения PASSWORD;
-r | --replica - ключ указывается при запуске утилиты обновления на реплике;
-D | --drop_on - флаг, разрешающий операции, запрещенные функцией block_user_data_modification;
-k | --test-skip - флаг, устанавливается для отключения запуска тестов системного каталога;
-a | --add-tables - флаг для выполнения резервного копирования таблиц pg_largeobject, pg_largeobject_metadata при необходимости;
-V | --version - версия утилиты;
-? | --help - справка.

Команды:

info - команда проверки актуальности обновления и формирования информационных файлов user_tbls.txt, version.txt для последующего запуска обновления;
update - команда запуска обновления;
reset - команда отката обновления. Откат возможен до первого запуска базы с доступом пользователей.

Требования для запуска#

Пользователь должен иметь права на запуск скрипта обновления inplace_upgrade.sh. Также этот пользователь должен иметь права суперпользователя на доступ к СУБД.

Режимы работы скрипта#

Существуют три режима работы скрипта inplace_upgrade.sh:

info - проверка возможности обновления;
update - обновление;
reset - откат обновления;

inplace_upgrade.sh в режиме info#

В режиме info скрипт осуществляет проверку возможности обновления (наличие утилиты update_catalog_version, папок с SQL-скриптами и всех необходимых прав доступа к ним) и необходимость обновления для новой версии СУБД. Также скрипт создает два файла user_tbls.txt и version.txt. Файл user_tbls.txt содержит список директорий пользовательских табличных пространств для последующего их обновления скриптом в режиме update. Файл version.txt используется для сохранения значения мажорной версии PostgreSQL (MAJOR_POSTGRESQL), которая является элементом пути в пользовательском табличном пространстве PG_<MAJOR_POSTGRESQL>_<CATALOG_VERSION_NO>.

Для кластерной конфигурации необходимо запускать скрипт в режиме info и на мастере и на реплике.

Запуск скрипта осуществляется при включенной СУБД.

Пример запуска скрипта:

./inplace_upgrade.sh -d <pgdata> -l <директория логов> -s <директория с утилитой> -B <директория резервной копии> -p <порт> -h <хост> -u <суперпользователь> -b <база данных для подключения по умолчанию> -n  <текущая версия продукта> -N <новая версия продукта> info --t <директория утилит postgres and pg_ctl> -T <директория утилит psql and pg_dump>

Ограничения#

Необходим доступ к папке sql_upgrade_6xx, ее внутренним папкам и доступ на чтение ко всем файлам внутри папок для администратора СУБД, запускающего утилиту. СУБД должна быть запущена со старыми бинарными файлами.

Коды возврата#

Предусмотренные коды:

0 - вызов утилиты требуется;
1 - провал запуска утилиты, утилита не может быть запущена корректно;
2 - вызов утилиты в режиме update не требуется.

inplace_upgrade.sh в режиме update#

В режиме update скрипт осуществляет обновление таблиц схемы pg_catalog, номера версии системного каталога в pg_control и табличных пространств пользователей.

Пример запуска скрипта:

./inplace_upgrade.sh -d <pgdata> -l <дирктория логов> -p <порт> -h <хост> -u <суперпользоватесь> -b <база данных для подключения по умолчанию> -s <директория с утилитой> -m <директория для sql-дампов> -B <директория бэкапа> -n  <текущая версия продукта> -N <новая версия продукта> update -t <директория утилит postgres and pg_ctl> -T <директория утилит psql and pg_dump>

Примечание:

Процесс восстановления СУБД после неудачного окончания работы скрипта в режиме update описан в разделе «Ручное обновление системных каталогов СУБД Pangolin».

Ограничения#

Перед запуском обновления СУБД должна быть остановлена. Доступ для обычных пользователей должен быть ограничен, чтобы не было проблем при снятии дампов системных каталогов (не менялись системные таблицы pg_class, pg_type, pg_proc и другие) и последующем их анализе, если потребуется при ручном восстановлении СУБД. Бинарные файлы СУБД должны быть новой версии и должны содержать необходимые системные объекты (если требуется). В противном случае может возникнуть проблема как примере ниже.

Пример отсутствия функция в ядре (при ее добавлении может быть ошибка в транзакции):

"ERROR: Fail script: ERROR: there is no built-in function named \"<name_function>\"", "CONTEXT: SQL statement \"CREATE FUNCTION pg_catalog.name_function()"

Коды возврата#

Предусмотренные коды:

0 - успех;
1 - провал запуска утилиты, требуется ручное восстановление СУБД;
4 - требуется восстановление файлов из резервной копии системного каталога, также необходим откат исполняемых файлов СУБД к исходной версии;
5 - изменения не применились, необходим откат исполняемых файлов СУБД к исходной версии.

inplace_upgrade.sh в режиме reset#

В режиме reset скрипт осуществляет восстановление pg_catalog и номера каталога СУБД.

Пример запуска скрипта:

./inplace_upgrade.sh -d <pgdata> -l <дирктория логов> -p <порт> -h <хост> -u <суперпользоватесь> -b <база данных для подключения по умолчанию> -s <директория с утилитой> -m <директория для sql-дампов> -B <директория бэкапа> reset -t <директория утилит postgres and pg_ctl> -T <директория утилит psql and pg_dump>

Примечание:

Процесс восстановления СУБД после неудачного окончания работы скрипта в режиме reset описан в разделе «Ручное обновление системных каталогов СУБД Pangolin».

Ограничения#

Должен быть доступ к папке, указанной в --backupdir и доступ на чтение к файлам, внутри этой папки.

Перед запуском восстановления СУБД должна быть остановлена. Доступ для обычных пользователей должен быть ограничен.

Коды возврата#

0 - успех;
1 - провал запуска утилиты, требуется ручное восстановление СУБД.

Утилита update_catalog_version#

Пользователь должен иметь права на исполнение утилиты update_catalog_version, запускающим обновление.

Утилита update_catalog_version производит сравнение версии текущего каталога, считанной из global/pg_control (расположение файла по умолчанию $PGDATA/global/pg_control), с версией на которую планируется обновление. Также проверяется наличие файла резервной копии pg_control.bak в директории указанной в --backup, если файл есть (возможно происходит повторный запуск), то утилита заканчивает свою работу, пишет сообщение с описанием ошибки и возвращает код ошибки 1. В случае совпадения проверяется отличие номера текущей версии от версии на которую необходимо производить обновление, если они совпали, то обновление версии не происходит и утилита заканчивает свою работу, возвращается код 2. Если новая версия больше текущей версии, то делается резервная копия pg_control.bak (файл будет располагаться в --backup) и происходит обновление версии каталога в файле pg_control. В случае успешного обновления утилита заканчивает свою работу и возвращает код 0. Если произошла ошибка при обновлении версии, то происходит восстановление pg_control и завершение работы утилиты с кодом 1. Если восстановить старый pg_control из резервной копии не удалось, то утилита возвращает код 3. Если новая версия меньше текущей версии каталога, то обновление не производится, пишется сообщение об ошибке и возвращается код 1. Если необходимо понизить версию, то нужно использовать ключ --force (-f), с этим ключом не производится проверка повышения версии каталога, также не производится проверка наличия файла резервной копии и он перезаписывается. Если не сделать обновление версии каталога, то бинарные файлы СУБД не смогут запуститься.

Ключи утилиты update_catalog_version:

-D, --pgdatadir - директория с СУБД (PGDATA);
-b, --backupdir - директория для сохранения резервной копии файла pg_control;
-C, --catalog-version-new - новая версия системного каталога (на которую происходит обновление) (CATALOG_VERSION_NO);
-c, --catalog-version-old - старая версия системного каталога (с которой происходит обновление) (CATALOG_VERSION_NO);
-f, --force - флаг принудительной смены версии;
-y, --dry-run - флаг проверки соответствия версии текущего каталога обновлению, без его изменения;
-V, --version - флаг печати версии утилиты;
-?, --help - флаг печати справки об утилите.

Режимы работы утилиты update_catalog_version#

Работа утилиты без –force#

Утилита запускается с ключами: update_catalog_version -с catalog_version_no_old -C catalog_version_no_new -b <dir_backup> -D <PGDATA>.

Ход работы:

Проверяется что заданы все основные параметры (-D, -c, -C, -b), если хотя бы один не задан, то пишется сообщение в stdout и возвращается код ошибки 1.
Проверяется что PostgreSQL не запущен. Если запущен, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется что версия каталога не понижается, если версия понижается, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется наличие файла резервной копии pg_control.bak, если он есть, то выдается сообщение об ошибке и возвращается код возврата 1. Это нужно для исключения повторного ошибочного обновления.
Проверяется соответствие версии текущего каталога, версии переданной с ключом -c, если версии разные, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется соответствие версии текущего каталога, версии переданной с ключом -С, если версии одинаковые, то выдается сообщение соответствия версий и возвращается код 2.
Формируется файл резервной копии pg_control.bak. Если файл не сформировался, то выдается сообщение об ошибке и возвращается код возврата 1.
Обновляется версия системного каталога в файле pg_control. Если произошла ошибка, то происходит восстановление файла pg_control из резервной копии, выдается сообщение об ошибке и возвращается код 1. Если восстановление файла pg_control не получилось, то выдается сообщение об ошибке и выдается код 3.

Работа утилиты с –force#

Утилита запускается сключами: update_catalog_version -с catalog_version_no_old -C catalog_version_no_new -b <dir_backup> -D <PGDATA> -f.

Ход работы:

Проверяется что заданы все основные параметры (-D, -c, -C, -b), если хотя бы один не задан, то пишется сообщение в stdout и возвращается код ошибки 1.
Проверяется что PostgreSQL не запущен. Если запущен, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется соответствие версии текущего каталога, версии переданной с ключом -c, если версии разные, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется соответствие версии текущего каталога, версии переданной с ключом -С, если версии одинаковые, то выдается сообщение соответствия версий и возвращается код 2.
Формируется файл бэкапа pg_control.bak. Если файл не сформировался, то выдается сообщение об ошибке и возвращается код возврата 1.
Обновляется версия системного каталога в файле pg_control. Если произошла ошибка, то происходит восстановление файла pg_control из резервной копии, выдается сообщение об ошибке и возвращается код 1. Если восстановление файла pg_control не получилось, то выдается сообщение об ошибке и выдается код 3.

Работа утилиты с –dry-run#

Утилита запускается с ключами: update_catalog_version -с catalog_version_no_old -C catalog_version_no_new -b <dir_backup> -D <PGDATA> -y.

Ход работы:

Проверяется что заданы все основные параметры (-D, -c, -C, -b), если хотя бы один не задан, то пишется сообщение в stdout и возвращается код ошибки 1.
Проверяется что версия каталога не понижается. Если версия понижается, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется наличие файла резервной копии pg_control.bak. Если он есть, то выдается сообщение об ошибке и возвращается код возврата 1. Это нужно для исключения повторного ошибочного обновления.
Проверяется соответствие версии текущего каталога, версии переданной с ключом -c. Если версии разные, то выдается сообщение об ошибке и возвращается код возврата 1.
Проверяется соответствие версии текущего каталога версии переданной с ключом -С. Если версии одинаковые, то выдается сообщение соответствия версий и возвращается код 2, если версии разные то выдается сообщение о возможности обновления и возвращается код 0.

Ограничения#

Перед запуском update_catalog_version, для изменения версии каталога, СУБД должна быть остановлена. Доступ для обычных пользователей должен быть ограничен.

Коды возврата утилиты update_catalog_version#

Предусмотренные коды:

0 - успешное завершения обновления версии каталога (в режиме проверки --dry-run данный код означает, что обновление возможно);
1 - ошибка обновления версии каталога, файл pg_control не поменялся;
2 - обновление каталога не требуется (в режиме проверки --dry-run данный код означает, что обновление не требуется);
3 - ошибка обновления версии каталога, файл pg_control поменялся, требуется ручное восстановление из файла резервной копии pg_control.bak.

Ручное обновление исполняемых файлов СУБД Pangolin (с использованием утилиты inplace_upgrade.sh)#

Перед началом обновления необходимо знать особенности, в связи с изменением формата WAL-файлов:

Корректный откат к исходной версии Pangolin (6.1.0/6.1.2/6.1.4) при отсутствии резервной копии осуществить не получится, поэтому необходимо это учесть при попытке обновиться.
При обновлении стенда кластерной конфигурации, перед началом обновления необходимо выключить все узлы кластера во избежание фоновых записей старого формата, который при старте уже обновленного узла считаются некорректными.

Перед началом выполнения инструкции необходимо убедиться, что yum/dnf-репозитории настроены корректно.

Внимание!

Перед началом обновления рекомендуется заблокировать трафик и выключить службу crond во избежание сторонних подключений.

Обновление СУБД осуществляется от пользователя с правами sudo, пользователя postgres и пользователя kmadmin_pg.

Поскольку инструкция является универсальной для standalone и cluster-архитектур, каждый пункт необходимо выполнить на всех узлах кластера БД. На узле arbiter производить обновление компонентов только по необходимости.

Обозначения

В инструкции используются переменные для динамической настройки. Перед выполнением команд эти переменные будут экспортироваться. Скорректируйте значение относительно вашего кейса обновления:

PANGOLIN_VER – новая версия СУБД Pangolin (формат - х.х.х);
PANGOLIN_BACKUP_TOOLS – новая версия компонента pangolin-backup-tools (формат - х.х.х);
PANGOLIN_POOLER – новая версия компонента pangolin-pooler (формат - х.х.х);
PANGOLIN_MANAGER – новая версия компонента pangolin-manager (формат - х.х.х);
PANGOLIN_TIMESCALEDB – новая версия компонента pangolin-timescaledb (формат - х.х.х);
PANGOLIN_TIMESCALEDB_OLD – исходная версия компонента pangolin-timescaledb (формат - х.х.х);
PANGOLIN_PGHOME_VER – новая версия в пути к бинарным файлам СУБД Pangolin (формат - х.х);
PANGOLIN_PGHOME_OLD_VER – исходная версия в пути к бинарным файлам СУБД Pangolin (формат - х.х.х/х.х);
PANGOLIN_OLD_VER – исходная версия СУБД Pangolin (формат - х.х.х);
PANGOLIN_FULL_VER – новая версия СУБД Pangolin (формат - 0х.00х.0х);
PANGOLIN_FULL_OLD_VER – исходная версия СУБД Pangolin (формат - 0х.00х.0х).

Шаг 1. Подготовка#

Скачайте дистрибутив в рабочий каталог и распакуйте его. Далее по инструкции путь к компонентам дистрибутива будет формироваться по ~/pangolin:
```
mkdir -p ~/pangolin
tar -xzvf pangolin_6.tar.gz  -C ~/pangolin
```

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

sudo mkdir -p /home/postgres/pg_inplace_upgrade/{util,backup,log,dump}
sudo cp -r ~/pangolin/installer/utilities/pg_inplace_upgrade/* /home/postgres/pg_inplace_upgrade/util
sudo chmod 700 -R /home/postgres/pg_inplace_upgrade
sudo chown postgres:postgres -R /home/postgres/pg_inplace_upgrade

sudo su - postgres
cd /home/postgres/pg_inplace_upgrade/util
./inplace_upgrade.sh info -n 6.3.0 -N 6.4.0 -s /home/postgres/pg_inplace_upgrade/util -B /home/postgres/pg_inplace_upgrade/backup -d /pgdata/06/data -l /home/postgres/pg_inplace_upgrade/log -p 5433 -h 127.0.0.1 -u postgres -b postgres -m /home/postgres/pg_inplace_upgrade/dump -t /usr/pangolin/bin -T /usr/pangolin-dbms-client/bin

В случае, если необходимо произвести обновление системных данных каталога, будет выведено сообщение:

INFO: Location of update_catalog_version utility: /opt/pangolin_cache/pg_inplace_upgrade/update_catalog_version
INFO: The log-file containing postgresql logs produced during catalog update: /pgarclogs/pg_inplace_upgrade/log/postgres_updade.log
INFO: The summarized catalog update report: /pgarclogs/pg_inplace_upgrade/log/report.log
INFO: ======= START INPLACE_UPGRADE IN INFO MODE =======
INFO: ----------- Initial update analysis -----------
INFO: CATALOG_VERSION_NO_OLD: 202310091
INFO: Following directories will be searched to find sql-scripts applicable in this run:
INFO: /opt/pangolin_cache/pg_inplace_upgrade/update_catalog_version/sql_upgrade_6xx/6.4.0/
INFO: Version: 6.4.0 CATALOG_VERSION_NO_NEW: 202409231
INFO: Initial update analysis........................... OK
INFO: ----------- Update CATALOG_VERSION_NO -----------
INFO: update_catalog_version: The new catalog version is the same as the current one.
INFO: Update CATALOG_VERSION_NO......................... OK
INFO: ----------- Read all catalog update SQL-scripts -----------
INFO: Read all catalog update SQL-scripts............... OK
INFO: ----------- Extract info about users tablespaces -----------
INFO: paths: /opt/pangolin_cache/pg_inplace_upgrade/tmp_check/test_db
INFO: version: PostgreSQL 15.5 on x86_64-pc-linux-gnu, compiled by gcc (GCC) 8.5.0 20210514 (Platform V SberLinux 8.5.0-18), 64-bit
INFO: Extract info about users tablespaces.............. OK
INFO:
   INFO mode finished with Success. Update required.
===================================================

Если нет необходимости в обновлении системных данных каталога, будет выведено сообщение:

INFO: Location of update_catalog_version utility: /opt/pangolin_cache/pg_inplace_upgrade/update_catalog_version
INFO: The log-file containing postgresql logs produced during catalog update: /pgarclogs/pg_inplace_upgrade/log/postgres_updade.log
INFO: The summarized catalog update report: /pgarclogs/pg_inplace_upgrade/log/report.log
INFO: ======= START INPLACE_UPGRADE IN INFO MODE =======
INFO: ----------- Initial update analysis -----------
INFO: CATALOG_VERSION_NO_OLD: 202409231
INFO: Following directories will be searched to find sql-scripts applicable in this run:
INFO: /opt/pangolin_cache/pg_inplace_upgrade/sql_upgrade_6xx/6.4.0/
INFO: Version: 6.4.0 CATALOG_VERSION_NO_NEW: 202409231
INFO: Initial update analysis........................... OK
INFO:
   INFO mode finished with Success. Update not required.
===================================================

Если в процессе работы утилиты что то пошло не так, будет выведено сообщение:

INFO: Location of update_catalog_version utility: /opt/pangolin_cache/pg_inplace_upgrade/update_catalog_version
INFO: The log-file containing postgresql logs produced during catalog update: /pgarclogs/pg_inplace_upgrade/log/postgres_updade.log
INFO: The summarized catalog update report: /pgarclogs/pg_inplace_upgrade/log/report.log
INFO: ======= START INPLACE_UPGRADE IN INFO MODE =======
INFO: ----------- Initial update analysis -----------
INFO: CATALOG_VERSION_NO_OLD: 202310091
INFO: Following directories will be searched to find sql-scripts applicable in this run:
INFO: /opt/pangolin_cache/pg_inplace_upgrade/sql_upgrade_6xx/6.2.0/
INFO: Version: 6.2.0 CATALOG_VERSION_NO_NEW: 202310091
INFO: /opt/pangolin_cache/pg_inplace_upgrade/sql_upgrade_6xx/6.3.0/
INFO: Version: 6.3.0 CATALOG_VERSION_NO_NEW: 202310091
INFO: /opt/pangolin_cache/pg_inplace_upgrade/sql_upgrade_6xx/6.4.0/
INFO: Version: 6.4.0 CATALOG_VERSION_NO_NEW: 202409231
ERROR: File /opt/pangolin_cache/pg_inplace_upgrade/sql_upgrade_6xx/6.4.1/CATALOG_VERSION was not found
INFO: Initial update analysis........................... FAIL
INFO:
   INFO mode finished with Error.
===================================================

Создайте временный физический слот репликации на master:

sudo -iu postgres  
SELECT * FROM pg_create_physical_replication_slot('tmp_update_slot', 'TRUE');
exit

Шаг 2. Остановка компонентов СУБД Pangolin#

В случае конфигурации с Pangolin Manager введите компонент в режим паузы:

sudo -iu postgres
patronictl -c /etc/patroni/postgres.yml edit-config --set 'pause=true' --force
exit

или

sudo -iu postgres
pangolin-manager-ctl -c /etc/pangolin-manager/postgres.yml edit-config --set 'pause=true' --force
exit

Остановите все компоненты СУБД Pangolin. В случае кластерной конфигурации действия по остановке произведите сначала на реплике, затем на основном узле:

# Для конфигурации без pangolin-manager
sudo systemctl stop postgresql

# Для конфигурации с pangolin-manager
sudo -iu postgres
pg_ctl stop
exit
sudo systemctl stop patroni
sudo systemctl stop pangolin-manager

# Для конфигурации с etcd
sudo systemctl stop etcd

# Для любой конфигурации
sudo systemctl stop pangolin-pooler
sudo systemctl stop pangolin_reencrypt@postgres.service
sudo systemctl stop pangolin_reencrypt@kmadmin_pg.service
sudo systemctl stop pg_certs_rotate_agent.service
sudo systemctl stop pangolin-certs-rotate
sudo systemctl stop pangolin-auth-reencrypt@postgres
sudo systemctl stop pangolin-auth-reencrypt@kmadmin_pg

С включенной функциональностью «Отказ от root»:

# Для конфигурации с etcd
sudo systemctl stop etcd

sudo -iu postgres

# Для конфигурации с pangolin-manager
pg_ctl stop
systemctl --user stop pangolin-manager

# Для конфигурации без pangolin-manager
systemctl --user stop postgresql

# Для любой конфигурации
systemctl --user stop pangolin-pooler
systemctl --user stop pangolin-certs-rotate
systemctl --user stop pangolin-auth-reencrypt
exit
sudo -iu kmadmin_pg
export XDG_RUNTIME_DIR=/run/user/$(id -u)
export DBUS_SESSION_BUS_ADDRESS="unix:path=${XDG_RUNTIME_DIR}/bus"
systemctl --user stop pangolin-auth-reencrypt
exit

Проверьте, что все компоненты корректно остановлены:

sudo ps aux | grep -E "pangolin-pooler|pangolin-manager|postgresql|pangolin-certs-rotate|pg_certs_rotate_agent|pangolin-auth-reencrypt@postgres|pangolin_reencrypt@postgres.service|pangolin-auth-reencrypt@kmadmin_pg|pangolin_reencrypt@kmadmin_pg.service|etcd" | grep -v grep

Если команда на шаге 3 вернула результат, то выполните следующее:

sudo kill -9 <pid>

sudo ps aux | grep -E "pangolin-pooler|pangolin-manager|postgresql|pangolin-certs-rotate|pg_certs_rotate_agent|pangolin-auth-reencrypt@postgres|pangolin_reencrypt@postgres.service|pangolin-auth-reencrypt@kmadmin_pg|pangolin_reencrypt@kmadmin_pg.service|etcd" | grep -v grep