Skip to content

Commit 0e50d7d

Browse files
committed
Fix up according to notes, update versions command for 5.7
Signed-off-by: Dj Walker-Morgan <[email protected]>
1 parent d315095 commit 0e50d7d

File tree

4 files changed

+28
-52
lines changed

4 files changed

+28
-52
lines changed

product_docs/docs/pgd/5.6/planning/limitations.mdx

+1-3
Original file line numberDiff line numberDiff line change
@@ -99,9 +99,7 @@ versions. Mixed version clusters are not supported for extended periods of time.
9999
Therefore, once an PGD cluster upgrade has begun, you should complete the whole
100100
cluster upgrade as quickly as possible.
101101

102-
We don't support running mixed versions of PGD except during an upgrade, and we
103-
don't support clusters running mixed versions even while being upgraded, for
104-
extended periods.
102+
We don't support running mixed versions of PGD except during an upgrade, and we don't support clusters running mixed versions even while being upgraded, for extended periods.
105103

106104
For more information on rolling upgrades and mixed versions, see [Rolling upgrade considerations](/pgd/latest/upgrades/manual_overview#rolling-upgrade-considerations).
107105

product_docs/docs/pgd/5.6/upgrades/manual_overview.mdx

+7-11
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,14 @@ nodes are at the newer release. There must be no more than two versions of the
5959
software running at the same time. An upgrade must be completed, with all nodes
6060
fully upgraded, before starting another upgrade.
6161

62-
Where additional caution is required to reduce business risk, more time may be
63-
required to perform an upgrade. For maximum caution and to reduce the time
64-
required upgrading production systems, we suggest performing the upgrades in a
65-
separate test environment first.
66-
67-
Don't run with mixed versions of the software for any longer than is absolutely
68-
necessary to complete the upgrade. You can check on the versions in the cluster
69-
using the [`pgd show-version`](/pgd/5.6/cli/command_ref/pgd_show-version/)
62+
Where additional caution is required to reduce business risk, more time may be required to perform an upgrade.
63+
For maximum caution and to reduce the time required upgrading production systems, we suggest performing the upgrades in a separate test environment first.
64+
65+
Don't run with mixed versions of the software for any longer than is absolutely necessary to complete the upgrade.
66+
You can check on the versions in the cluster using the [`pgd show-version`](/pgd/5.6/cli/command_ref/pgd_show-version/)
7067
command. The longer you run with mixed versions, the more likely you are to
71-
encounter issues, the more difficult it is to diagnose and resolve them. We
72-
recommend upgrading in off peak hours for your business, and over a short period
73-
of time.
68+
encounter issues, the more difficult it is to diagnose and resolve them.
69+
We recommend upgrading in off peak hours for your business, and over a short period of time.
7470

7571
While you can use a rolling upgrade for upgrading a major version of the
7672
software, we don't support mixing PostgreSQL, EDB Postgres Extended, and EDB

product_docs/docs/pgd/5.7/planning/limitations.mdx

+13-26
Original file line numberDiff line numberDiff line change
@@ -76,32 +76,19 @@ and current listing.
7676

7777
## Mixed PGD versions
7878

79-
While PGD was developed to [enable rolling upgrades of
80-
PGD](/pgd/latest/upgrades) by allowing mixed versions of PGD to operate during
81-
the upgrade process, we expect users to run mixed versions only during upgrades
82-
and for users to complete their upgrades as quickly as possible. We also
83-
recommend that you test any rolling upgrade process in a non-production
84-
environment before attempting it in production.
85-
86-
When a node is upgraded, it returns to the cluster and communicates with the
87-
other nodes in the cluster using the lowest version of the inter-node protocol
88-
that is supported by all the other nodes in the cluster. This means that the
89-
upgraded node will be able to communicate with all other nodes in the cluster,
90-
but it will not be able to take advantage of any new features or improvements
91-
that were introduced in the newer version of PGD.
92-
93-
That will stay the case until all nodes in the cluster have been upgraded to the
94-
same newer version. The longer you run mixed versions, the longer you will be
95-
without the benefits of the new version, and the longer you will be exposed to
96-
any potential interoperability issues that might arise from running mixed
97-
versions. Mixed version clusters are not supported for extended periods of time.
98-
99-
Therefore, once an PGD cluster upgrade has begun, you should complete the whole
100-
cluster upgrade as quickly as possible.
101-
102-
We don't support running mixed versions of PGD except during an upgrade, and we
103-
don't support clusters running mixed versions even while being upgraded, for
104-
extended periods.
79+
While PGD was developed to [enable rolling upgrades of PGD](/pgd/latest/upgrades) by allowing mixed versions of PGD to operate during the upgrade process, we expect users to run mixed versions only during upgrades and for users to complete their upgrades as quickly as possible.
80+
We also recommend that you test any rolling upgrade process in a non-production environment before attempting it in production.
81+
82+
When a node is upgraded, it returns to the cluster and communicates with the other nodes in the cluster using the lowest version of the inter-node protocol that is supported by all the other nodes in the cluster.
83+
This means that the upgraded node will be able to communicate with all other nodes in the cluster, but it will not be able to take advantage of any new features or improvements that were introduced in the newer version of PGD.
84+
85+
That will stay the case until all nodes in the cluster have been upgraded to the same newer version.
86+
The longer you run mixed versions, the longer you will be without the benefits of the new version, and the longer you will be exposed to any potential interoperability issues that might arise from running mixed versions.
87+
Mixed version clusters are not supported for extended periods of time.
88+
89+
Therefore, once an PGD cluster upgrade has begun, you should complete the whole cluster upgrade as quickly as possible.
90+
91+
We don't support running mixed versions of PGD except during an upgrade, and we don't support clusters running mixed versions even while being upgraded, for extended periods.
10592

10693
For more information on rolling upgrades and mixed versions, see [Rolling upgrade considerations](/pgd/latest/upgrades/manual_overview#rolling-upgrade-considerations).
10794

product_docs/docs/pgd/5.7/upgrades/manual_overview.mdx

+7-12
Original file line numberDiff line numberDiff line change
@@ -59,18 +59,13 @@ nodes are at the newer release. There must be no more than two versions of the
5959
software running at the same time. An upgrade must be completed, with all nodes
6060
fully upgraded, before starting another upgrade.
6161

62-
Where additional caution is required to reduce business risk, more time may be
63-
required to perform an upgrade. For maximum caution and to reduce the time
64-
required upgrading production systems, we suggest performing the upgrades in a
65-
separate test environment first.
66-
67-
Don't run with mixed versions of the software for any longer than is absolutely
68-
necessary to complete the upgrade. You can check on the versions in the cluster
69-
using the [`pgd show-versions`](/pgd/latest/cli/command_ref/pgd_show-version/)
70-
command. The longer you run with mixed versions, the more likely you are to
71-
encounter issues, the more difficult it is to diagnose and resolve them. We
72-
recommend upgrading in off peak hours for your business, and over a short period
73-
of time.
62+
Where additional caution is required to reduce business risk, more time may be required to perform an upgrade.
63+
For maximum caution and to reduce the time required upgrading production systems, we suggest performing the upgrades in a separate test environment first.
64+
65+
Don't run with mixed versions of the software for any longer than is absolutely necessary to complete the upgrade.
66+
You can check on the versions in the cluster using the [`pgd nodes list --versions`](/pgd/5.7/cli/command_ref/nodes/list/) command.
67+
The longer you run with mixed versions, the more likely you are to encounter issues, the more difficult it is to diagnose and resolve them.
68+
We recommend upgrading in off peak hours for your business, and over a short period of time.
7469

7570
While you can use a rolling upgrade for upgrading a major version of the software,
7671
we don't support mixing PostgreSQL, EDB Postgres Extended, and

0 commit comments

Comments
 (0)