Skip to content

Commit a83e670

Browse files
separate halt section (#1179)
1 parent e62c01e commit a83e670

File tree

1 file changed

+7
-6
lines changed

1 file changed

+7
-6
lines changed

docs/how-to/refresh.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -73,7 +73,7 @@ Check the restored data by ensuring that:
7373

7474
In the event that something goes wrong (e.g. the refresh fails, the new version of PostgreSQL is not performant enough, a database client is incompatible with the new version), you may want to quickly roll back.
7575

76-
Prepare for this possibility by reading through the entire refresh documentation—with special attention to the [rollback section](#roll-back)—before starting the refresh.
76+
Prepare for this possibility by reading through the entire refresh documentation—with special attention to the [](#halt-the-refresh) and [](#roll-back) sections—before starting the refresh.
7777

7878
## Review release notes
7979

@@ -173,9 +173,7 @@ Use `juju refresh` and specify the charm revision that you are refreshing to.
173173
juju refresh postgresql --revision 0
174174
```
175175

176-
## Roll back
177-
178-
### Halt the refresh
176+
## Halt the refresh
179177

180178
If something goes wrong, halt the refresh by running:
181179

@@ -186,13 +184,16 @@ juju config postgresql pause-after-unit-refresh=all
186184
In the command above, replace `postgresql` with the name of the Juju application.
187185

188186
Next, assess the situation and plan the recovery.
187+
Often, the safest recovery path is to [roll back](#roll-back).
189188
Consider [contacting us](/reference/contacts).
190189

191-
### Start the rollback
190+
## Roll back
192191

193192
If something went wrong, the safest recovery path is often to roll back to the original version.
194193

195-
Use the rollback command [you copied down earlier](#pre-refresh-check).
194+
First, [halt the refresh](#halt-the-refresh).
195+
196+
Run the rollback command [you copied down earlier](#pre-refresh-check).
196197
In most cases, the rollback command is also displayed in the application's status message in `juju status`.
197198

198199
### Resume the rollback

0 commit comments

Comments
 (0)