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: src/current/v25.3/upgrade-with-pcr.md
+9-16Lines changed: 9 additions & 16 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -8,7 +8,7 @@ docs_area: manage
8
8
When [**physical cluster replication (PCR)**]({% link {{ page.version.version }}/physical-cluster-replication-overview.md %}) is enabled, you must use the process on this page to upgrade your clusters. This process ensures that the standby cluster upgrades before the primary cluster.
9
9
10
10
{{site.data.alerts.callout_info}}
11
-
The entire standby cluster must be at the same version as, or one version ahead of, the primary's virtual cluster. Within the primary and standby CockroachDB clusters, the _system virtual cluster (SystemVC)_ must be at a cluster version greater than or equal to the _app virtual cluster (AppVC)_.
11
+
The entire standby cluster must be on the same version as the primary cluster or a version the primarycluster can directly upgrade to. Within the primary and standby CockroachDB clusters, the _system virtual cluster (SystemVC)_ must be at a cluster version greater than or equal to the _app virtual cluster (AppVC)_.
12
12
{{site.data.alerts.end}}
13
13
14
14
## Upgrade primary and standby clusters
@@ -27,9 +27,7 @@ To upgrade your primary and standby clusters:
27
27
If you need to [roll back]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#roll-back-a-major-version-upgrade) an upgrade, you must do so before the upgrade has been finalized.
28
28
{{site.data.alerts.end}}
29
29
30
-
1. If auto-finalization is disabled, [finalize]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#finalize-a-major-version-upgrade-manually) the upgrade on the standby cluster's AppVC.
31
-
32
-
After you have finalized the upgrade on the standby cluster's AppVC, the clusters can remain in this state for an indefinite amount of time. You can wait to upgrade the primary cluster as long as is needed.
30
+
After you have finalized the upgrade on the standby cluster's SystemVC, the clusters can remain in this state for an indefinite amount of time. You can wait to upgrade the primary cluster as long as is needed.
33
31
34
32
1.[Upgrade the binaries]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#perform-a-major-version-upgrade) on the primary cluster. Replace the binary on each node of the cluster and restart the node.
35
33
@@ -38,16 +36,18 @@ To upgrade your primary and standby clusters:
38
36
1. If auto-finalization is disabled, [finalize]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#finalize-a-major-version-upgrade-manually) the upgrade on the primary cluster's SystemVC.
39
37
40
38
{{site.data.alerts.callout_info}}
41
-
If you need to [roll back]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#roll-back-a-major-version-upgrade) an upgrade, you must do so before the upgrade has been finalized.
39
+
If you need to [roll back]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#roll-back-a-major-version-upgrade) an upgrade, you must do so before the upgrade has been finalized. Rolling back the upgrade on the primary cluster does not also roll back the standby cluster.
42
40
{{site.data.alerts.end}}
43
41
44
-
1. If auto-finalization is disabled, [finalize]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#finalize-a-major-version-upgrade-manually) the upgrade on the primary cluster's AppVC.
42
+
1. If auto-finalization is disabled, [finalize]({% link {{ page.version.version }}/upgrade-cockroach-version.md %}#finalize-a-major-version-upgrade-manually) the upgrade on the primary cluster's AppVC.
43
+
44
+
Upgrading the primary cluster's AppVC also upgrades the standby cluster's AppVC, since it replicates from the primary.
45
45
46
46
## Upgrade ReaderVC
47
47
48
48
If you have a [_reader virtual cluster (ReaderVC)_]({% link {{ page.version.version }}/read-from-standby.md %}), use the following steps to upgrade it by dropping and re-creating it:
49
49
50
-
1. After upgrading the AppVCs on your primary and standby clusters, wait for the replicated time to pass the time at which the upgrade completed.
50
+
1. After upgrading the AppVC on your primary cluster, wait for the replicated time to pass the time at which the upgrade completed.
51
51
1. On the standby cluster, stop the ReaderVC service:
52
52
53
53
{% include_cached copy-clipboard.html %}
@@ -62,13 +62,6 @@ If you have a [_reader virtual cluster (ReaderVC)_]({% link {{ page.version.vers
62
62
DROP VIRTUAL CLUSTER <readervc-name>
63
63
~~~
64
64
65
-
1. On the AppVC, double-check that the standby cluster's AppVC has upgraded:
66
-
67
-
{% include_cached copy-clipboard.html %}
68
-
~~~ sql
69
-
SHOW CLUSTER SETTING version
70
-
~~~
71
-
72
65
1. Back on the standby cluster, if the version is as expected, re-create the ReaderVC:
73
66
74
67
{% include_cached copy-clipboard.html %}
@@ -82,6 +75,6 @@ If you need to perform a [failover]({% link {{ page.version.version }}/failover-
82
75
83
76
However, after performing a failover you cannot perform a [fast failback]({% link {{ page.version.version }}/failover-replication.md %}#failback) to the original primary cluster during the upgrade process. This is because at times during the upgrade the standby cluster is ahead of the primary cluster.
84
77
85
-
## Patch deferrals
78
+
## Minor version upgrades
86
79
87
-
Patch versions are not relevant when determining PCR compatibility. There is no need to consider PCR compatibility when upgrading to a specific patch version within a major version.
80
+
Minor versions are not relevant when determining PCR compatibility. There is no need to consider PCR compatibility when upgrading to a specific minor version within a major version.
0 commit comments