29.13. Обновление #
Миграция кластера логической репликации возможна только в том случае, если все члены старого кластера логической репликации находятся на версии 17.0 и выше.
29.13.1. Подготовиться к обновлению публикующего сервера #
Программа pg_upgrade пытается мигрировать логические слоты. Это устраняет необходимость определять те же логические слоты на новом публикующем сервере вручную. Миграция логических слотов поддерживается только в случае, если старый кластер версии 17.0 или выше. Логические слоты на кластерах до версии 17.0 будут игнорироваться без уведомления.
Прежде чем начать обновление публикующего кластера, убедитесь, что подписка временно отключена, выполнив команду ALTER SUBSCRIPTION ... DISABLE. Включите подписку после завершения обновления.
Необходимо выполнить ряд предварительных требований, чтобы программа pg_upgrade смогла обновить логические слоты. В противном случае будет выдаваться ошибка.
В новом кластере
wal_levelдолжен иметь значениеlogical.Для нового кластера у параметра
max_replication_slotsдолжно быть установлено значение не меньше количества слотов на старом кластере или равное ему.Модули вывода, на которые ссылаются слоты на старом кластере, должны быть установлены в каталоге с исполняемыми файлами новой версии PostgreSQL. Они также должны быть включены в параметр output_plugin_libraries нового кластера; за информацией по безопасности обратитесь к документации параметра.
В старом кластере все транзакции и сообщения логического декодирования передавались подписчикам.
Все слоты на старом кластере должны быть доступны для использование, то есть не должно быть слотов, у которых для представления pg_replication_slots.
conflictingне задано значениеtrue.В новом кластере не должно быть постоянных логических слотов, т. е. не должно быть слотов, в которых pg_replication_slots.
temporaryимеет значениеfalse.
29.13.2. Подготовиться к обновлению ведомых серверов #
Установите для нового подписчика subscriber configurations.pg_upgrade предпримет попытку мигрировать зависимости подписчиков, которые включают информацию таблиц подписчиков, находящуюся в системном каталоге pg_subscription_rel, а также источник репликации подписчика. Это позволяет логической репликации на новом подписчике продолжить с момента, где она остановилась на старом подписчике. Миграция зависимостей подписчиков поддерживается только в случае, если старый кластер версии 17.0 или выше. Зависимости подписчиков на кластерах до версии 17.0 будут игнорироваться без уведомления.
Чтобы программа pg_upgrade смогла обновить подписки, должны выполняться определённые условия. В противном случае будет выдаваться ошибка.
Все таблицы подписки в старом подписчике должны быть в состоянии
i(initialize, инициализация) илиr(ready, готовность). Это можно проверить с помощью pg_subscription_rel.srsubstate.В старом кластере должна быть запись об источнике репликации для каждой из подписок. Это можно проверить в системных таблицах pg_subscription и pg_replication_origin.
В новом кластере параметр
max_active_replication_originsдолжен иметь значение, большее или равное числу подписок в старом.
29.13.3. Обновление кластеров логической репликации #
При обновлении подписчика можно выполнять операции записи на публикующем сервере. Такие изменения реплицируются на подписчика по завершении его обновления.
Примечание
Ограничения логической репликации применяются к процессу обновления кластера логической репликации. Более подробная информация описана в Разделе 29.8.
Предварительные условия обновления публикующего сервера применяются к процессу обновления кластера логической репликации. Более подробная информация описана в Подразделе 29.13.1.
Предварительные условия обновления подписчика применяются к процессу обновления кластера логической репликации. Более подробная информация описана в Подразделе 29.13.2.
Предупреждение
Чтобы обновить кластер логической репликации, необходимо выполнить несколько действий на разных узлах. Поскольку не все операции являются транзакционными, пользователям рекомендуется делать резервные копии по инструкции, описанной в Подразделе 25.3.2.
Шаги по обновлению следующих кластеров логической репликации представлены ниже:
Следуйте инструкции в Подразделе 29.13.3.1, чтобы обновить кластер логической репликации с двумя узлами.
Следуйте инструкции в Подразделе 29.13.3.2, чтобы обновить кластер каскадной логической репликации.
Следуйте инструкции в Подразделе 29.13.3.3, чтобы обновить кластер двунаправленной логической репликации с двумя узлами.
29.13.3.1. Шаги по обновлению кластера логической репликации с двумя узлами #
Предположим, что публикующий сервер — node1, а подписчик — node2. У подписчика node2 есть подписка sub1_node1_node2 на изменения на node1.
Отключите на
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... DISABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Остановите публикующий сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1 stop
Инициализируйте экземпляр
data1_upgraded, воспользовавшись более новой версией.Обновите публикующий сервер узла
node1до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый публикующий сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Остановите сервер подписчика на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2 stop
Инициализируйте экземпляр
data2_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node2подписчика до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый сервер подписчика на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
На узле
node2создайте таблицы, созданные на обновлённом сервере публикующего узлаnode2в промежуток времени между Шаг 1 и настоящим моментом, например:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Включите на узле
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... ENABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
Обновите публикации подписки узла
node2, воспользовашись командойALTER SUBSCRIPTION ... REFRESH PUBLICATION, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;
Примечание
В описанных выше шагах первым обновляется публикующей сервер, а после него — подписчик. Как вариант, можно воспользоваться шагами и сначала обновить подписчика, а затем публикующий сервер.
29.13.3.2. Шаги по обновлению кластера каскадной логической репликации #
Предположим, у нас есть конфигурация с каскадной логической репликацией node1->node2->node3. В этом случае node2 подписывается на изменения node1, а node3 — на изменения node2. У node2 есть подписка sub1_node1_node2, то есть подписка на изменения node1. У node3 есть подписка sub1_node2_node3, то есть подписка на изменения node2.
Отключите на
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... DISABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Остановите сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1 stop
Инициализируйте экземпляр
data1_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node1до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Отключите на
node3все подписки, которые подписаны на измененияnode2, воспользовавшись командойALTER SUBSCRIPTION ... DISABLE, например:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 DISABLE;
Остановите сервер на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2 stop
Инициализируйте экземпляр
data2_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node2до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый сервер на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
На узле
node2создайте таблицы, созданные на обновлённом сервере публикующего узлаnode1в промежуток времени между Шаг 1 и настоящим моментом, например:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Включите на узле
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... ENABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
Обновите публикации подписки узла
node2, воспользовашись командойALTER SUBSCRIPTION ... REFRESH PUBLICATION, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;
Остановите сервер на узле
node3, например:pg_ctl -D /opt/PostgreSQL/data3 stop
Инициализируйте экземпляр
data3_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node3до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data3" --new-datadir "/opt/PostgreSQL/postgres/18/data3_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновленный сервер на узле
node3, например:pg_ctl -D /opt/PostgreSQL/data3_upgraded start -l logfile
На узле
node3создайте таблицы, созданные на обновлённом узлеnode2в промежуток времени между Шаг 6 и настоящим моментом, например:/* node3 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Включите на узле
node3все подписки, которые подписаны на измененияnode2, воспользовавшись командойALTER SUBSCRIPTION ... ENABLE, например:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 ENABLE;
Обновите публикации подписки узла
node3, воспользовавшись командойALTER SUBSCRIPTION ... REFRESH PUBLICATION, например:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 REFRESH PUBLICATION;
29.13.3.3. Шаги по обновлению кластера двунаправленной логической репликации с двумя узлами #
Предположим, у нас есть конфигурация с двунаправленной логической репликацией node1->node2 и node2->node1. В таком случае node2 подписывается на изменения node1, а node1 подписывается на изменения node2. У node1 есть подписка sub1_node2_node1, которая подписывает на изменения node2. У node2 есть подписка sub1_node1_node2, которая подписывает на изменения node1.
Отключите на
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... DISABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Остановите сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1 stop
Инициализируйте экземпляр
data1_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node1до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый сервер на узле
node1, например:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Включите на узле
node2все подписки, которые подписаны на измененияnode1, воспользовавшись командойALTER SUBSCRIPTION ... ENABLE, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
На узле
node1создайте таблицы, созданные наnode2в промежуток времени между Шаг 1 и настоящим моментом, например:/* node1 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Обновите публикации подписки узла
node1, чтобы скопировать информацию об исходной таблице изnode2, воспользовавшись командойALTER SUBSCRIPTION ... REFRESH PUBLICATION, например:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 REFRESH PUBLICATION;
Отключите на
node1все подписки, которые подписаны на измененияnode2, воспользовавшись командойALTER SUBSCRIPTION ... DISABLE, например:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 DISABLE;
Остановите сервер на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2 stop
Инициализируйте экземпляр
data2_upgraded, воспользовавшись более новой версией.Обновите сервер узла
node2до новой версии, например:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Запустите обновлённый сервер на узле
node2, например:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
Включите на
node1все подписки, которые подписаны на измененияnode2, воспользовавшись командойALTER SUBSCRIPTION ... ENABLE, например:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 ENABLE;
На узле
node2создайте таблицы, созданные на обновлённом узлеnode1в промежуток времени между Шаг 9 и настоящим моментом, например:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Обновите публикации подписки
node2, чтобы скопировать информацию об исходной таблице изnode1, воспользовавшись командойALTER SUBSCRIPTION ... REFRESH PUBLICATION, например:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;
29.13. Upgrade #
Migration of logical replication clusters is possible only when all the members of the old logical replication clusters are version 17.0 or later.
29.13.1. Prepare for Publisher Upgrades #
pg_upgrade attempts to migrate logical slots. This helps avoid the need for manually defining the same logical slots on the new publisher. Migration of logical slots is only supported when the old cluster is version 17.0 or later. Logical slots on clusters before version 17.0 will silently be ignored.
Before you start upgrading the publisher cluster, ensure that the subscription is temporarily disabled, by executing ALTER SUBSCRIPTION ... DISABLE. Re-enable the subscription after the upgrade.
There are some prerequisites for pg_upgrade to be able to upgrade the logical slots. If these are not met an error will be reported.
The new cluster must have
wal_levelaslogical.The new cluster must have
max_replication_slotsconfigured to a value greater than or equal to the number of slots present in the old cluster.The output plugins referenced by the slots in the old cluster must be installed in the new PostgreSQL executable directory. They must also be included in the new cluster's output_plugin_libraries; see that parameter's documentation for safety information.
The old cluster has replicated all the transactions and logical decoding messages to subscribers.
All slots on the old cluster must be usable, i.e., there are no slots whose pg_replication_slots.
conflictingis nottrue.The new cluster must not have permanent logical slots, i.e., there must be no slots where pg_replication_slots.
temporaryisfalse.
29.13.2. Prepare for Subscriber Upgrades #
Setup the subscriber configurations in the new subscriber. pg_upgrade attempts to migrate subscription dependencies which includes the subscription's table information present in pg_subscription_rel system catalog and also the subscription's replication origin. This allows logical replication on the new subscriber to continue from where the old subscriber was up to. Migration of subscription dependencies is only supported when the old cluster is version 17.0 or later. Subscription dependencies on clusters before version 17.0 will silently be ignored.
There are some prerequisites for pg_upgrade to be able to upgrade the subscriptions. If these are not met an error will be reported.
All the subscription tables in the old subscriber should be in state
i(initialize) orr(ready). This can be verified by checking pg_subscription_rel.srsubstate.The replication origin entry corresponding to each of the subscriptions should exist in the old cluster. This can be found by checking pg_subscription and pg_replication_origin system tables.
The new cluster must have
max_active_replication_originsconfigured to a value greater than or equal to the number of subscriptions present in the old cluster.
29.13.3. Upgrading Logical Replication Clusters #
While upgrading a subscriber, write operations can be performed in the publisher. These changes will be replicated to the subscriber once the subscriber upgrade is completed.
Note
The logical replication restrictions apply to logical replication cluster upgrades also. See Section 29.8 for details.
The prerequisites of publisher upgrade apply to logical replication cluster upgrades also. See Section 29.13.1 for details.
The prerequisites of subscriber upgrade apply to logical replication cluster upgrades also. See Section 29.13.2 for details.
Warning
Upgrading logical replication cluster requires multiple steps to be performed on various nodes. Because not all operations are transactional, the user is advised to take backups as described in Section 25.3.2.
The steps to upgrade the following logical replication clusters are detailed below:
Follow the steps specified in Section 29.13.3.1 to upgrade a two-node logical replication cluster.
Follow the steps specified in Section 29.13.3.2 to upgrade a cascaded logical replication cluster.
Follow the steps specified in Section 29.13.3.3 to upgrade a two-node circular logical replication cluster.
29.13.3.1. Steps to Upgrade a Two-node Logical Replication Cluster #
Let's say publisher is in node1 and subscriber is in node2. The subscriber node2 has a subscription sub1_node1_node2 which is subscribing the changes from node1.
Disable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... DISABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Stop the publisher server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1 stop
Initialize
data1_upgradedinstance by using the required newer version.Upgrade the publisher
node1's server to the required newer version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded publisher server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Stop the subscriber server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2 stop
Initialize
data2_upgradedinstance by using the required newer version.Upgrade the subscriber
node2's server to the required new version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded subscriber server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
On
node2, create any tables that were created in the upgraded publishernode1server between Step 1 and now, e.g.:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Enable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... ENABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
Refresh the
node2subscription's publications usingALTER SUBSCRIPTION ... REFRESH PUBLICATION, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;
Note
In the steps described above, the publisher is upgraded first, followed by the subscriber. Alternatively, the user can use similar steps to upgrade the subscriber first, followed by the publisher.
29.13.3.2. Steps to Upgrade a Cascaded Logical Replication Cluster #
Let's say we have a cascaded logical replication setup node1->node2->node3. Here node2 is subscribing the changes from node1 and node3 is subscribing the changes from node2. The node2 has a subscription sub1_node1_node2 which is subscribing the changes from node1. The node3 has a subscription sub1_node2_node3 which is subscribing the changes from node2.
Disable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... DISABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Stop the server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1 stop
Initialize
data1_upgradedinstance by using the required newer version.Upgrade the
node1's server to the required newer version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Disable all the subscriptions on
node3that are subscribing the changes fromnode2by usingALTER SUBSCRIPTION ... DISABLE, e.g.:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 DISABLE;
Stop the server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2 stop
Initialize
data2_upgradedinstance by using the required newer version.Upgrade the
node2's server to the required new version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
On
node2, create any tables that were created in the upgraded publishernode1server between Step 1 and now, e.g.:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Enable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... ENABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
Refresh the
node2subscription's publications usingALTER SUBSCRIPTION ... REFRESH PUBLICATION, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;
Stop the server in
node3, e.g.:pg_ctl -D /opt/PostgreSQL/data3 stop
Initialize
data3_upgradedinstance by using the required newer version.Upgrade the
node3's server to the required new version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data3" --new-datadir "/opt/PostgreSQL/postgres/18/data3_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded server in
node3, e.g.:pg_ctl -D /opt/PostgreSQL/data3_upgraded start -l logfile
On
node3, create any tables that were created in the upgradednode2between Step 6 and now, e.g.:/* node3 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Enable all the subscriptions on
node3that are subscribing the changes fromnode2by usingALTER SUBSCRIPTION ... ENABLE, e.g.:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 ENABLE;
Refresh the
node3subscription's publications usingALTER SUBSCRIPTION ... REFRESH PUBLICATION, e.g.:/* node3 # */ ALTER SUBSCRIPTION sub1_node2_node3 REFRESH PUBLICATION;
29.13.3.3. Steps to Upgrade a Two-node Circular Logical Replication Cluster #
Let's say we have a circular logical replication setup node1->node2 and node2->node1. Here node2 is subscribing the changes from node1 and node1 is subscribing the changes from node2. The node1 has a subscription sub1_node2_node1 which is subscribing the changes from node2. The node2 has a subscription sub1_node1_node2 which is subscribing the changes from node1.
Disable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... DISABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 DISABLE;
Stop the server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1 stop
Initialize
data1_upgradedinstance by using the required newer version.Upgrade the
node1's server to the required newer version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data1" --new-datadir "/opt/PostgreSQL/postgres/18/data1_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded server in
node1, e.g.:pg_ctl -D /opt/PostgreSQL/data1_upgraded start -l logfile
Enable all the subscriptions on
node2that are subscribing the changes fromnode1by usingALTER SUBSCRIPTION ... ENABLE, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 ENABLE;
On
node1, create any tables that were created innode2between Step 1 and now, e.g.:/* node1 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Refresh the
node1subscription's publications to copy initial table data fromnode2usingALTER SUBSCRIPTION ... REFRESH PUBLICATION, e.g.:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 REFRESH PUBLICATION;
Disable all the subscriptions on
node1that are subscribing the changes fromnode2by usingALTER SUBSCRIPTION ... DISABLE, e.g.:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 DISABLE;
Stop the server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2 stop
Initialize
data2_upgradedinstance by using the required newer version.Upgrade the
node2's server to the required new version, e.g.:pg_upgrade --old-datadir "/opt/PostgreSQL/postgres/17/data2" --new-datadir "/opt/PostgreSQL/postgres/18/data2_upgraded" --old-bindir "/opt/PostgreSQL/postgres/17/bin" --new-bindir "/opt/PostgreSQL/postgres/18/bin"Start the upgraded server in
node2, e.g.:pg_ctl -D /opt/PostgreSQL/data2_upgraded start -l logfile
Enable all the subscriptions on
node1that are subscribing the changes fromnode2by usingALTER SUBSCRIPTION ... ENABLE, e.g.:/* node1 # */ ALTER SUBSCRIPTION sub1_node2_node1 ENABLE;
On
node2, create any tables that were created in the upgradednode1between Step 9 and now, e.g.:/* node2 # */ CREATE TABLE distributors (did integer PRIMARY KEY, name varchar(40));
Refresh the
node2subscription's publications to copy initial table data fromnode1usingALTER SUBSCRIPTION ... REFRESH PUBLICATION, e.g.:/* node2 # */ ALTER SUBSCRIPTION sub1_node1_node2 REFRESH PUBLICATION;