You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: product_docs/docs/pgd/5.8/upgrades/upgrading_major_rolling.mdx
+9-1Lines changed: 9 additions & 1 deletion
Original file line number
Diff line number
Diff line change
@@ -15,6 +15,8 @@ Doing the same for an EDB Postgres Distributed (PGD) cluster is essentially the
15
15
The rolling upgrade process allows updating individual cluster nodes to a new major Postgres version while maintaining cluster availability and operational continuity.
16
16
This approach minimizes downtime and ensures data integrity by allowing the rest of the cluster to remain operational as each node is upgraded sequentially.
17
17
18
+
While the upgrade process is in progress, the cluster will have mixed Postgres major versions running on different nodes. DDL replication is not supported between different major versions of Postgres, so you must ensure that no DDL changes are made to the cluster while the upgrade is in progress. That includes not running the `ALTER EXTENSION` commands generated by the upgrade processes until all nodes in the cluster are upgraded to the same major version.
19
+
18
20
The following overview of the general instructions and [worked example](#worked-example) help to provide a smooth and controlled upgrade process.
19
21
20
22
!!!Note
@@ -145,12 +147,14 @@ Using the [preliminary order](#prepare-the-upgrade), perform the following steps
145
147
146
148
`sudo systemctl daemon-reload`
147
149
148
-
149
150
***Restart Postgres**
150
151
* Proceed to restart the PostgreSQL service:
151
152
152
153
`systemctl start postgres`
153
154
155
+
***Update the extensions**
156
+
* The upgrade process checks for extension updates and generates a script named `updated_extensions.sql` in the current directory if needed.
157
+
This contains `ALTER EXTENSION` commands for any extensions that need updating after the upgrade. As these are DDL commands, if you have to run the script before all nodes are upgraded, you should turn off DDL replication temporarily to avoid issues with mixed major versions. If you can defer running the script until all nodes are upgraded, you can run it on each node after the upgrade of that node is complete.
154
158
155
159
***Validate the new Postgres version**
156
160
* Verify that your PostgreSQL instance is now upgraded:
@@ -551,6 +555,10 @@ Start the modified Postgres service:
551
555
sudo systemctl start postgres
552
556
```
553
557
558
+
### Update the extensions
559
+
560
+
After the upgrade, you may need to update the extensions. The upgrade process checks for extension updates and generates a script named `updated_extensions.sql` in the current directory if needed. In this case, no script was generated, so no extensions need updating.
561
+
554
562
### Validate the new Postgres version
555
563
556
564
Repeating the first step, check the version of Postgres to confirm that you upgraded kaboom correctly. While still on kaboom, run:
0 commit comments