Просмотр исходного кода

Use just for Postgres maintenance command examples

pull/2575/head
Slavi Pantaleev 3 лет назад
Родитель
Сommit
2b49ae79ca
2 измененных файлов: 11 добавлений и 9 удалений
  1. +7
    -7
      docs/importing-postgres.md
  2. +4
    -2
      docs/maintenance-postgres.md

+ 7
- 7
docs/importing-postgres.md Просмотреть файл

@@ -20,18 +20,18 @@ Before doing the actual import, **you need to upload your Postgres dump file to


## Importing ## Importing


To import, run this command (make sure to replace `<server-path-to-postgres-dump.sql>` with a file path on your server):
To import, run this command (make sure to replace `SERVER_PATH_TO_POSTGRES_DUMP_FILE` with a file path on your server):


```sh ```sh
ansible-playbook -i inventory/hosts setup.yml \
--extra-vars='server_path_postgres_dump=<server-path-to-postgres-dump.sql> postgres_default_import_database=matrix' \
--tags=import-postgres
just run-tags import-postgres \
--extra-vars=server_path_postgres_dump=SERVER_PATH_TO_POSTGRES_DUMP_FILE \
--extra-vars=postgres_default_import_database=main
``` ```


**Notes**: **Notes**:


- `<server-path-to-postgres-dump.sql>` must be a file path to a Postgres dump file on the server (not on your local machine!)
- `postgres_default_import_database` defaults to `matrix`, which is useful for importing multiple databases (for dumps made with `pg_dumpall`). If you're importing a single database (e.g. `synapse`), consider changing `postgres_default_import_database` accordingly
- `SERVER_PATH_TO_POSTGRES_DUMP_FILE` must be a file path to a Postgres dump file on the server (not on your local machine!)
- `postgres_default_import_database` defaults to `main`, which is useful for importing multiple databases (for dumps made with `pg_dumpall`). If you're importing a single database (e.g. `synapse`), consider changing `postgres_default_import_database` accordingly




## Troubleshooting ## Troubleshooting
@@ -86,7 +86,7 @@ In this case you can use the command suggested in the import task to clear the d
# systemctl start matrix-postgres # systemctl start matrix-postgres
``` ```


Now on your local machine run `ansible-playbook -i inventory/hosts setup.yml --tags=setup-postgres` to prepare the database roles etc.
Now on your local machine run `just run-tags setup-postgres` to prepare the database roles etc.


If not, you probably get this error. `synapse` is the correct table owner, but the role is missing in database. If not, you probably get this error. `synapse` is the correct table owner, but the role is missing in database.
``` ```


+ 4
- 2
docs/maintenance-postgres.md Просмотреть файл

@@ -41,7 +41,7 @@ To perform a `FULL` Postgres [VACUUM](https://www.postgresql.org/docs/current/sq
Example: Example:


```bash ```bash
ansible-playbook -i inventory/hosts setup.yml --tags=run-postgres-vacuum,start
just run-tags run-postgres-vacuum,start
``` ```


**Note**: this will automatically stop Synapse temporarily and restart it later. You'll also need plenty of available disk space in your Postgres data directory (usually `/matrix/postgres/data`). **Note**: this will automatically stop Synapse temporarily and restart it later. You'll also need plenty of available disk space in your Postgres data directory (usually `/matrix/postgres/data`).
@@ -78,7 +78,9 @@ Upgrades must be performed manually.


This playbook can upgrade your existing Postgres setup with the following command: This playbook can upgrade your existing Postgres setup with the following command:


ansible-playbook -i inventory/hosts setup.yml --tags=upgrade-postgres
```sh
just run-tags upgrade-postgres
```


**Warning: If you're using Borg Backup keep in mind that there is no official Postgres 15 support yet.** **Warning: If you're using Borg Backup keep in mind that there is no official Postgres 15 support yet.**




Загрузка…
Отмена
Сохранить