Skip to content

Commit 98cee67

Browse files
authored
Update fencing.md
1 parent 5afdb87 commit 98cee67

File tree

1 file changed

+2
-2
lines changed

1 file changed

+2
-2
lines changed

docs/fencing.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,9 @@ Tests can be found here: https://github.com/fly-apps/postgres-flex/pull/49/files
3535
In both of these instances the primary member will be fenced.
3636

3737
**If the real primary is resolvable**
38-
The cluster will be made read-only, the PGBouncer will be reconfigured to target the "real" primary and the ip address is written to a `zombie.lock` file. The PGBouncer reconfiguration will ensure that any connections hitting this member will be routed to the real primary in order to minimize interruptions. Once completed there will be panic to force a full member restart. When the member is restarted, we will read the ip address from the `zombie.lock` file and use that to attempt to rejoin the cluster we diverged from. If we are successful, the `zombie.lock` is cleared and we will boot as a standby.
38+
The cluster will be made read-only. The real primary's ip is written to a `zombie.lock` file and the member role is set to "zombie", this will ensure no new connections will be routed to this node. Once this has completed, the member will be restarted and the boot process will read the ip address from the `zombie.lock` file and use that to attempt to rejoin the cluster we diverged from. If we are successful, the `zombie.lock` is cleared and we will boot as a standby.
3939

4040
**Note: We will not attempt to rejoin a cluster if the resolved primary resides in a region that differs from the `PRIMARY_REGION` environment variable set on self. The `PRIMARY_REGION` will need to be updated before a rejoin will be attempted.**
4141

4242
**If the real primary is NOT resolvable**
43-
The cluster will be made read-only, PGBouncer will remain disabled and a `zombie.lock` file will be created without a value. When the member reboots, we will read the `zombie.lock` file and see that it's empty. This indicates that we've entered a failure mode that can't be recovered automatically. This could be an issue where previously deleted members were not properly unregistered, or the primary's state has diverged to a point where its registered members have been cycled out.
43+
The cluster will be made read-only and the `zombie.lock` file will be created without a value. When the member reboots, we will read the `zombie.lock` file and see that it's empty. This indicates that we've entered a failure mode that can't be recovered automatically. This could be an issue where previously deleted members were not properly unregistered, or the primary's state has diverged to a point where its registered members have been cycled out.

0 commit comments

Comments
 (0)