aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--ops/id-unification.md24
1 files changed, 20 insertions, 4 deletions
diff --git a/ops/id-unification.md b/ops/id-unification.md
index b0a7c65..4e08e1a 100644
--- a/ops/id-unification.md
+++ b/ops/id-unification.md
@@ -17,20 +17,36 @@ 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:
+
1. Disable automatic migrations
-1. Upgrade meta.sr.ht and ensure that the meta.sr.ht GraphQL API is online
-1. Upgrade remaining services
+1. Shut off the service
+1. Run upgrades
1. Run `$service-migrate upgrade head` (e.g. gitsrht-migrate) for each service
and monitor the migration progress
+1. Turn on the service
1. Re-enable automatic migrations if desired
## Downgrade process
1. Disable automatic migrations
-1. Downgrade meta.sr.ht
-1. Downgrade remaining services
+1. Downgrade meta.sr.ht and restart the services
+
+Then, for each service, one at a time:
+
+1. Shut off the service
+1. Downgrade the software
1. Run `$service-migrate downgrade $version`, selecting $version from the list
below, for each service
+1. Turn on the service
+1. Re-enable automatic migrations if desired
## Affected database schema revisions