From 3ec3bb4ba719959de2cb196cd9e78a6d27c072a4 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Sun, 18 Jan 2026 03:03:55 +0000 Subject: [PATCH 1/2] Document StaleTopoPrimary VTOrc analysis and recovery --- content/en/docs/24.0/user-guides/configuration-basic/vtorc.md | 1 + 1 file changed, 1 insertion(+) diff --git a/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md b/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md index 8c536780f..1bdf542dc 100644 --- a/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md +++ b/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md @@ -15,6 +15,7 @@ It detects any configuration problems in the cluster and fixes them. Here is the | `DeadPrimary` | VTOrc detects when the primary tablet is dead | VTOrc runs EmergencyReparentShard to elect a different primary | | `PrimaryIsReadOnly`, `PrimarySemiSyncMustBeSet`, `PrimarySemiSyncMustNotBeSet` | VTOrc detects when the primary tablet has configuration issues like being read-only, semi-sync being set or not being set | VTOrc fixes the configurations on the primary. | | `NotConnectedToPrimary`, `ConnectedToWrongPrimary`, `ReplicationStopped`, `ReplicaIsWritable`, `ReplicaSemiSyncMustBeSet`, `ReplicaSemiSyncMustNotBeSet` | VTOrc detects when a replica has configuration issues like not being connected to the primary, connected to the wrong primary, replication stopped, replica being writable, semi-sync being set or not being set | VTOrc fixes the configurations on the replica. | +| `StaleTopoPrimary` | VTOrc detects when a tablet still has type PRIMARY in the topology but a newer primary has already been elected. This can happen if a topology update fails during an emergency reparent operation. | VTOrc demotes the stale primary to a read-only replica and updates its type to REPLICA in the topology. | ### Flags From 2ad53ae32c277c88c798290af5ae0384759f77a4 Mon Sep 17 00:00:00 2001 From: "promptless[bot]" <179508745+promptless[bot]@users.noreply.github.com> Date: Tue, 27 Jan 2026 21:15:39 +0000 Subject: [PATCH 2/2] Sync documentation updates --- content/en/docs/24.0/user-guides/configuration-basic/vtorc.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md b/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md index 1bdf542dc..7f6ace96e 100644 --- a/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md +++ b/content/en/docs/24.0/user-guides/configuration-basic/vtorc.md @@ -15,7 +15,7 @@ It detects any configuration problems in the cluster and fixes them. Here is the | `DeadPrimary` | VTOrc detects when the primary tablet is dead | VTOrc runs EmergencyReparentShard to elect a different primary | | `PrimaryIsReadOnly`, `PrimarySemiSyncMustBeSet`, `PrimarySemiSyncMustNotBeSet` | VTOrc detects when the primary tablet has configuration issues like being read-only, semi-sync being set or not being set | VTOrc fixes the configurations on the primary. | | `NotConnectedToPrimary`, `ConnectedToWrongPrimary`, `ReplicationStopped`, `ReplicaIsWritable`, `ReplicaSemiSyncMustBeSet`, `ReplicaSemiSyncMustNotBeSet` | VTOrc detects when a replica has configuration issues like not being connected to the primary, connected to the wrong primary, replication stopped, replica being writable, semi-sync being set or not being set | VTOrc fixes the configurations on the replica. | -| `StaleTopoPrimary` | VTOrc detects when a tablet still has type PRIMARY in the topology but a newer primary has already been elected. This can happen if a topology update fails during an emergency reparent operation. | VTOrc demotes the stale primary to a read-only replica and updates its type to REPLICA in the topology. | +| `StaleTopoPrimary` | VTOrc detects when a tablet still has type PRIMARY in the topology but a newer primary has already been elected. This can happen if a topology update fails during an emergency reparent operation. | VTOrc demotes the stale primary to a read-only replica, updates its type to REPLICA in the topology, and configures it to replicate from the current primary. | ### Flags