paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-04 14:03:30 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Swap upgrade-postgresql steps with rebuilding the venv.

Browse Source 
As of 1f68726cb8, the upgrade-postgresql tool uses Python to connect
to the database used by Django, and thus requires a working venv.
There is no reason we cannot reinstall the venv with the old version
of PostgreSQL; swap the steps.
This commit is contained in:
Alex Vandiver
2024-07-31 17:48:46 +00:00
committed by Tim Abbott
parent e77a425a2b
commit 5e5478307a
1 changed files with 14 additions and 14 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
docs/production/upgrade.md
View File

@@ -329,13 +329,7 @@ instructions for other supported platforms.
currently installed version. But it's not important; the next currently installed version. But it's not important; the next
step will re-install Zulip's configuration in any case. step will re-install Zulip's configuration in any case.
4. As root, upgrade the database to the latest version of PostgreSQL: 4. Next, we need to reinstall the current version of Zulip, which
```bash
/home/zulip/deployments/current/scripts/setup/upgrade-postgresql
```
5. Next, we need to reinstall the current version of Zulip, which
among other things will recompile Zulip's Python module among other things will recompile Zulip's Python module
dependencies for your new version of Python and rewrite Zulip's dependencies for your new version of Python and rewrite Zulip's
full-text search indexes to work with the upgraded dictionary full-text search indexes to work with the upgraded dictionary
@@ -351,6 +345,12 @@ instructions for other supported platforms.
able to navigate to its URL and confirm everything is working able to navigate to its URL and confirm everything is working
correctly. correctly.
5. As root, upgrade the database to the latest version of PostgreSQL:
```bash
/home/zulip/deployments/current/scripts/setup/upgrade-postgresql
```
### Upgrading from Ubuntu 18.04 Bionic to 20.04 Focal ### Upgrading from Ubuntu 18.04 Bionic to 20.04 Focal
1. Upgrade your server to the latest Zulip `3.x` or `4.x` release (at 1. Upgrade your server to the latest Zulip `3.x` or `4.x` release (at
@@ -382,13 +382,7 @@ instructions for other supported platforms.
currently installed version. But it's not important; the next currently installed version. But it's not important; the next
step will re-install Zulip's configuration in any case. step will re-install Zulip's configuration in any case.
4. As root, upgrade the database to the latest version of PostgreSQL: 4. Next, we need to reinstall the current version of Zulip, which
```bash
/home/zulip/deployments/current/scripts/setup/upgrade-postgresql
```
5. Next, we need to reinstall the current version of Zulip, which
among other things will recompile Zulip's Python module among other things will recompile Zulip's Python module
dependencies for your new version of Python and rewrite Zulip's dependencies for your new version of Python and rewrite Zulip's
full-text search indexes to work with the upgraded dictionary full-text search indexes to work with the upgraded dictionary
@@ -404,6 +398,12 @@ instructions for other supported platforms.
able to navigate to its URL and confirm everything is working able to navigate to its URL and confirm everything is working
correctly. correctly.
5. As root, upgrade the database to the latest version of PostgreSQL:
```bash
/home/zulip/deployments/current/scripts/setup/upgrade-postgresql
```
6. Finally, Ubuntu 20.04 has a different version of the low-level 6. Finally, Ubuntu 20.04 has a different version of the low-level
glibc library, which affects how PostgreSQL orders text data (known glibc library, which affects how PostgreSQL orders text data (known
as "collations"); this corrupts database indexes that rely on as "collations"); this corrupts database indexes that rely on