Improve wording a bit

This commit is contained in:
Slavi Pantaleev 2021-01-20 10:19:39 +02:00
parent 024a23ed17
commit f6861e3c65

View File

@ -14,7 +14,7 @@ As already mentioned above, you most likely don't need to do anything. If you re
### Upgrade path for people NOT running an external Postgres server (default for the playbook) ### Upgrade path for people NOT running an external Postgres server (default for the playbook)
If you're **not running an external Postgres server**, then this bridge either already works Postgres for you, or you've intentionally kept it back on SQLite with custom configuration (`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) . If you're **not running an external Postgres server**, then this bridge either already works on Postgres for you, or you've intentionally kept it back on SQLite with custom configuration (`matrix_mautrix_facebook_database_engine: 'sqlite'` in your `vars.yml`) .
Simply remove that custom configuration from your `vars.yml` file (if it's there) and re-run the playbook. It should upgrade you automatically. Simply remove that custom configuration from your `vars.yml` file (if it's there) and re-run the playbook. It should upgrade you automatically.
You'll need to send a `login` message to the Facebook bridge bot again. You'll need to send a `login` message to the Facebook bridge bot again.
@ -33,12 +33,12 @@ If you are using an [external Postgres server](docs/configuring-playbook-externa
You have 3 ways to proceed: You have 3 ways to proceed:
- contribute to the playbook to make this possible (difficult) - contribute to the playbook to make this possible (difficult)
- or, do the above "steps" manually: - or, do the migration "steps" manually:
- stop the bridge (`systemctl stop matrix-mautrix-facebook`) - stop the bridge (`systemctl stop matrix-mautrix-facebook`)
- create a new `matrix_mautrix_facebook` Postgres database for it - create a new `matrix_mautrix_facebook` Postgres database for it
- run pgloader manually (we run it with default settings for this bridge) - run [pgloader](https://pgloader.io/) manually (we import this bridge's data using default settings and it works well)
- adjust the `matrix_mautrix_facebook_database_*` database variables (credentials, etc.) - define `matrix_mautrix_facebook_database_*` variables in your `vars.yml` file (credentials, etc.) - you can find their defaults in `roles/matrix-mautrix-facebook/defaults/main.yml`
- switch the bridge to use Postgres (`matrix_mautrix_facebook_database_engine: 'postgres'`) - switch the bridge to Postgres (`matrix_mautrix_facebook_database_engine: 'postgres'` in your `vars.yml` file)
- re-run the playbook (`--tags=setup-all,start`) and ensure the bridge works (`systemctl status matrix-mautrix-facebook` and `journalctl -fu matrix-mautrix-facebook`) - re-run the playbook (`--tags=setup-all,start`) and ensure the bridge works (`systemctl status matrix-mautrix-facebook` and `journalctl -fu matrix-mautrix-facebook`)
- send a `login` message to the Facebook bridge bot again - send a `login` message to the Facebook bridge bot again
- or, [stay on SQLite for a little longer (temporary solution)](#staying-on-sqlite-for-a-little-longer-temporary-solution) - or, [stay on SQLite for a little longer (temporary solution)](#staying-on-sqlite-for-a-little-longer-temporary-solution)