Skip to content

Commit 0bae5bf

Browse files
authored
Update manual_failovers.md
1 parent 948ae9b commit 0bae5bf

File tree

1 file changed

+9
-7
lines changed

1 file changed

+9
-7
lines changed

docs/manual_failovers.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,14 @@
22

33
While automatic failures are already baked-in, there may be times where a manually issued failover is necessary. The steps to perform a manual failover are listed below:
44

5-
**Note: The promotion candidate must reside within your PRIMARY_REGION.**
5+
_**Note: The promotion candidate must reside within your PRIMARY_REGION.**_
66

7-
1. Connect to the Machine you wish to promote
7+
**1. Connect to the Machine you wish to promote**
88
```
99
fly ssh console -s <app-name>
1010
```
1111

12-
2. Confirm the member is healthy.
12+
**2. Confirm the member is healthy**
1313
```
1414
# Switch to the postgres user and move to the home directory.
1515
su postgres
@@ -30,7 +30,8 @@ Node "fdaa:0:2e26:a7b:7d17:9b36:6e4b:2":
3030
3131
```
3232

33-
2. Stop the Machine running as primary
33+
**2. Stop the Machine running as primary**
34+
3435
Open up a separate terminal and stop the Machine running `primary`.
3536

3637
```
@@ -46,10 +47,9 @@ ID STATE ROLE REGION HEALTH CHECKS IMAGE
4647
fly machines stop 6e82931b729087 --app <app-name>
4748
```
4849

49-
3. Run the standby promotion command
50+
**3. Run the standby promotion command**
5051
Go back to the first terminal you opened that's connected to your promotion candidate.
5152

52-
**WARNING: It's important that you specify `--siblings-follow`, otherwise any other standbys will not be reconfigured to follow the new primary.**
5353
```
5454
# Issue a dry-run to ensure our candidate is eligible for promotion.
5555
repmgr standby promote --siblings-follow --dry-run
@@ -63,6 +63,8 @@ INFO: node will be promoted using the "pg_promote()" function
6363
INFO: prerequisites for executing STANDBY PROMOTE are met
6464
```
6565

66+
**WARNING: It's important that you specify `--siblings-follow`, otherwise any other standbys will not be reconfigured to follow the new primary.**
67+
6668
If everything looks good, go ahead and re-run the command without the `--dry-run` argument.
6769
```
6870
repmgr standby promote --siblings-follow
@@ -79,7 +81,7 @@ NOTICE: executing STANDBY FOLLOW on 1 of 1 siblings
7981
INFO: STANDBY FOLLOW successfully executed on all reachable sibling nodes
8082
```
8183

82-
4. Start the Machine that was previously operating as Primary
84+
**4. Start the Machine that was previously operating as Primary**
8385
```
8486
fly machines start 6e82931b729087 --app <app-name>
8587
```

0 commit comments

Comments
 (0)