zelo72
/
documentation
mirror of https://github.com/mastodon/documentation
1
0
Fork 0
Code Issues 6 Releases Wiki Activity

Updated the migration guide for Redis and services 

Added more details for migrating the Redis database and where/when to stop the services.
This commit is contained in:
KuJoe 2024-01-14 21:16:23 -05:00
parent 2fc35e875b
commit 1a4b9daebc
1 changed files with 12 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
content/en/admin/migrating.md
View File

@ -16,11 +16,11 @@ This guide was written with Ubuntu Server in mind; your mileage may vary for oth
## Basic steps {#basic-steps}
1. Set up a new Mastodon server using the [Production Guide]({{< relref "install" >}}) (however, don’t run `mastodon:setup` and only leave the PostgreSQL service running).
2. Stop Mastodon and Redis on the old server (e.g. `systemctl stop 'mastodon-*.service'` and `systemctl stop redis-server.service).
2. Stop Mastodon on the old server (e.g. `systemctl stop 'mastodon-*.service'`).
3. Dump and load the PostgreSQL database using the instructions below.
4. Copy the `system/` files using the instructions below. (Note: if you’re using S3, you can skip this step.)
5. Copy the `.env.production` file.
6. Copy the Redis database from `/var/lib/redis/` to the new server.
6. Save the Redis database, stop the Redis service, and copy the Redis database from `/var/lib/redis/` to the new server.
7. Run `RAILS_ENV=production bundle exec rails assets:precompile` to compile Mastodon
8. Start Mastodon and Redis on the new server.
9. Run `RAILS_ENV=production ./bin/tootctl feeds build` to rebuild the home timelines for each user.
@ -31,6 +31,12 @@ This guide was written with Ubuntu Server in mind; your mileage may vary for oth
## Detailed steps {#detailed-steps}
### Stop the Mastodon services
```bash
systemctl stop 'mastodon-*.service'
```
### What data needs to be migrated {#what-data-needs-to-be-migrated}
At a high level, you’ll need to copy over the following:
@ -95,6 +101,10 @@ You should also copy over the `.env.production` file, which contains secrets.
Now copy your Redis database over (adjust the location of your Redis database as needed). On your old machine, as the `root` user, run:
```bash
redis-cli
SAVE
EXIT
systemctl stop redis-server.service
rsync -avz /var/lib/redis/ root@example.com:/var/lib/redis
```