blog/content/mastodon-postgres-upgrade-fun.md

title	date	tags
mastodon postgres upgrade fun	2020-10-28T16:31:39	sysadmin tilde social

howdy friends!

if you’re a mastodon user on tilde.zone (the tildeverse mastodon instance), you might’ve noticed some downtime recently.

here’s a quick recap of what went down during the upgrade process.

we run the current stable version of postgresql from the postgres apt repos. postgres 13 was released recently and the apt upgrades automatically created a new cluster running 13.

the database for mastodon has gotten quite large (about 16gb) which complicates this upgrade a bit. this was my inital plan:

• drop the 13 cluster created by the apt package upgrades
• upgrade the 12-main cluster to 13
• drop the 12 cluster

these steps appeared to work fine, but closer inspection afterwards led me to discover that the new cluster had ended up with SQL_ASCII encoding somehow. this is not a situation we want to be in. time to fix it.

here’s the new plan:

• stop mastodon for i in streaming sidekiq web; do systemctl stop mastodon-$i; done

• dump current database state pg_dump mastodon_production > db.dump

• drop and recreate cluster with utf8 encoding pg_dropcluster 13 main --stop pg_createcluster --locale=en_US.UTF8 13 main --start

• restore backup sudo -u postgres psql -c "create user mastodon createdb;" sudo -u mastodon createdb -E utf8 mastodon_production sudo -u mastodon psql < db.dump

i’m still not 100% sure how the encoding reverted to ascii but it seems that the locale was not correctly set while running the apt upgrades…

if this happens to you, hopefully this helps you wade out while keeping all your data :)