paulmataruso/docker-zulip
1
0
Fork 0
mirror of https://github.com/zulip/docker-zulip.git synced 2025-10-23 04:51:58 +00:00
Code Issues Packages Projects Releases Wiki Activity

UPGRADING: Refer to PostgreSQL consistently.

Browse Source
This commit is contained in:
Alex Vandiver
2022-12-05 19:05:11 -05:00
committed by Alex Vandiver
parent d17d4d8be0
commit 07518e4cca
1 changed files with 10 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

20
UPGRADING.md
View File

@@ -116,21 +116,21 @@ file to match, and re-start Zulip.
If you are using an earlier version of `galexrt/docker-zulip` which If you are using an earlier version of `galexrt/docker-zulip` which
used the `quay.io/galexrt/postgres-zulip-tsearchextras:latest` used the `quay.io/galexrt/postgres-zulip-tsearchextras:latest`
Postgres image, you need to run a few manual steps to upgrade to the PostgreSQL image, you need to run a few manual steps to upgrade to the
`zulip/zulip-postgresql` Postgres image (because we've significantly `zulip/zulip-postgresql` PostgreSQL image (because we've significantly
upgraded the major postgres version). upgraded the major postgres version).
These instructions assume that you have not changed the default These instructions assume that you have not changed the default
Postgres data path (`/opt/docker/zulip/postgresql/data`) in your PostgreSQL data path (`/opt/docker/zulip/postgresql/data`) in your
`docker-compose.yml`. If you have changed it, please replace all `docker-compose.yml`. If you have changed it, please replace all
occurences of `/opt/docker/zulip/postgresql/data` with your path. occurences of `/opt/docker/zulip/postgresql/data` with your path.
1. Make a backup of your Zulip Postgres data dir. 1. Make a backup of your Zulip PostgreSQL data dir.
2. Stop all Zulip containers, except the postgres one (e.g. use 2. Stop all Zulip containers, except the postgres one (e.g. use
`docker stop` and not `docker-compose stop`). `docker stop` and not `docker-compose stop`).
3. Create a new (upgraded) Postgres container using a different data directory: 3. Create a new (upgraded) PostgreSQL container using a different data directory:
```shell ```shell
docker run -d \ docker run -d \
@@ -142,15 +142,15 @@ occurences of `/opt/docker/zulip/postgresql/data` with your path.
zulip/zulip-postgresql:latest zulip/zulip-postgresql:latest
``` ```
4. Use `pg_dumpall` to dump all data from the existing Postgres container to 4. Use `pg_dumpall` to dump all data from the existing PostgreSQL container to
the new Postgres container: the new PostgreSQL container:
```shell ```shell
docker-compose exec database pg_dumpall -U postgres | \ docker-compose exec database pg_dumpall -U postgres | \
docker exec -i postgresnew psql -U postgres docker exec -i postgresnew psql -U postgres
``` ```
5. Stop and remove both Postgres containers: 5. Stop and remove both PostgreSQL containers:
```shell ```shell
docker-compose rm --stop database docker-compose rm --stop database
@@ -161,7 +161,7 @@ occurences of `/opt/docker/zulip/postgresql/data` with your path.
`zulip/zulip-postgresql:latest` image for the `database` container `zulip/zulip-postgresql:latest` image for the `database` container
(this is the default in `zulip/docker-zulip`). (this is the default in `zulip/docker-zulip`).
7. Replace the old Postgres data directory with upgraded data directory: 7. Replace the old PostgreSQL data directory with upgraded data directory:
```shell ```shell
mv /opt/docker/zulip/postgresql/data /opt/docker/zulip/postgresql/old mv /opt/docker/zulip/postgresql/data /opt/docker/zulip/postgresql/old
@@ -180,5 +180,5 @@ occurences of `/opt/docker/zulip/postgresql/data` with your path.
docker-compose up docker-compose up
``` ```
That should be it. Your Postgres data has now been updated to use the That should be it. Your PostgreSQL data has now been updated to use the
`zulip/zulip-postgresql` image. `zulip/zulip-postgresql` image.