Skip to content
This repository has been archived by the owner on Apr 26, 2024. It is now read-only.

Clarify that undoing a shutdown might not be possible #8010

Merged
merged 5 commits into from
Aug 7, 2020
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 1 addition & 0 deletions changelog.d/8010.doc
Original file line number Diff line number Diff line change
@@ -0,0 +1 @@
Add documentation for how to undo a room shutdown.
13 changes: 10 additions & 3 deletions docs/admin_api/shutdown_room.md
Original file line number Diff line number Diff line change
Expand Up @@ -79,13 +79,20 @@ Response:
the structure can and does change without notice.

First, it's important to understand that a room shutdown is very destructive. Undoing a shutdown is not as simple as pretending it
never happened - work has to be done to move forward instead of resetting the past.
never happened - work has to be done to move forward instead of resetting the past. In fact, in some cases it might not be possible
to recover at all:

1. For safety reasons, it is recommended to shut down Synapse prior to continuing.
* If the room was invite only, your users will need to be re-invited.
turt2live marked this conversation as resolved.
Show resolved Hide resolved
* If the room became empty, it'll be impossible to rejoin.
turt2live marked this conversation as resolved.
Show resolved Hide resolved
* If the room was purged from your server, it may be inaccessible.
turt2live marked this conversation as resolved.
Show resolved Hide resolved

turt2live marked this conversation as resolved.
Show resolved Hide resolved
With all that being said, if you still want to try and recover the room:

1. For safety reasons, shut down Synapse.
2. In the database, run `DELETE FROM blocked_rooms WHERE room_id = '!example:example.org';`
* For caution: it's recommended to run this in a transaction: `BEGIN; DELETE ...;`, verify you got 1 result, then `COMMIT;`.
* The room ID is the same one supplied to the shutdown room API, not the Content Violation room.
3. Restart Synapse (required).
3. Restart Synapse.

You will have to manually handle, if you so choose, the following:

Expand Down