From 3abc1d1ddb70bd6f823ea569a992ae1356183547 Mon Sep 17 00:00:00 2001 From: Drew DeVault Date: Tue, 25 Oct 2022 11:08:34 +0200 Subject: ops/id-unification.md: updates following testing --- ops/id-unification.md | 32 ++++++++++++++++++++------------ 1 file changed, 20 insertions(+), 12 deletions(-) diff --git a/ops/id-unification.md b/ops/id-unification.md index 3f20f53..7132572 100644 --- a/ops/id-unification.md +++ b/ops/id-unification.md @@ -17,14 +17,8 @@ third-party instances. ## Upgrade process -For meta.sr.ht: - -1. Disable automatic migrations -1. Upgrade meta.sr.ht, restart the services, and ensure that the meta.sr.ht - GraphQL API is online -1. Re-enable automatic migrations if desired - -Then, for each service, one at a time: +Ensure meta.sr.ht is running version 0.60.4 or later. Then, for each service, +one at a time: 1. Disable automatic migrations 1. Shut off the service @@ -34,12 +28,26 @@ Then, for each service, one at a time: 1. Turn on the service 1. Re-enable automatic migrations if desired -## Downgrade process +**Note**: hub.sr.ht must be upgraded last, if present, and the other services +must be running during its upgrade. -1. Disable automatic migrations -1. Downgrade meta.sr.ht and restart the services +### pages.sr.ht + +A special upgrade process is required for pages.sr.ht, which does not use the +same system for database migrations as other services. Perform the same steps as +described above, then run the scripts in [contrib][contrib] in the following +order: + +- ./contrib/add\_user\_remote\_id.py upgrade +- ./contrib/use\_canonical\_user\_id.py upgrade + +To downgrade, repeat these commands in the reverse order with "downgrade". + +[contrib]: https://git.sr.ht/~sircmpwn/pages.sr.ht/tree/master/contrib + +## Downgrade process -Then, for each service, one at a time: +For each service (excluding meta.sr.ht), one at a time: 1. Shut off the service 1. Run `$service-migrate downgrade $version`, selecting $version from the list -- cgit