Merge pull request #3680 from luixxiul/fix

Update docs/configuring-playbook-s3-goofys.md
This commit is contained in:
Slavi Pantaleev 2024-10-25 13:17:29 +03:00 committed by GitHub
commit b63d8a5687
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -34,18 +34,13 @@ If you have local media store files and wish to migrate to Backblaze B2 subseque
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before migrating your local media store to an S3-backed one.
Follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage:
After making the backup, follow one of the guides below for a migration path from a locally-stored media store to one stored on S3-compatible storage:
- [Storing Matrix media files on Amazon S3 with Goofys (optional)](#storing-matrix-media-files-on-amazon-s3-with-goofys-optional)
- [Usage](#usage)
- [Migrating from local filesystem storage to S3](#migrating-from-local-filesystem-storage-to-s3)
- [Migrating to any S3-compatible storage (universal, but likely slow)](#migrating-to-any-s3-compatible-storage-universal-but-likely-slow)
- [Migrating to Backblaze B2](#migrating-to-backblaze-b2)
### Migrating to any S3-compatible storage (universal, but likely slow)
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before doing this.
1. Proceed with the steps below without stopping Matrix services
2. Start by adding the base S3 configuration in your `vars.yml` file (seen above, may be different depending on the S3 provider of your choice)
@ -72,7 +67,7 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
7. Start the S3 service by running this **on the server**: `systemctl start matrix-goofys`
8. Sync the files again by re-running the `rsync` command you see in step #6
8. Sync the files again by re-running the `rsync` command you see in step #5
9. Stop the S3 service by running this **on the server**: `systemctl stop matrix-goofys`
@ -93,8 +88,6 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
### Migrating to Backblaze B2
It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-data-on-my-server) before doing this.
1. While all Matrix services are running, run the following command on the server:
(you need to adjust the 3 `--env` line below with your own data)
@ -126,7 +119,7 @@ It's a good idea to [make a complete server backup](faq.md#how-do-i-backup-the-d
mv /matrix/synapse/storage/media-store /matrix/synapse/storage/media-store-local-backup
```
5. Put the [Backblaze B2 settings seen above](#backblaze-b2) in your `vars.yml` file
5. Put the [Backblaze B2 settings](configuring-playbook-s3.md#backblaze-b2) in your `vars.yml` file
6. Run the playbook: `ansible-playbook -i inventory/hosts setup.yml --tags=setup-all,start`