mirror of
				https://github.com/zulip/zulip.git
				synced 2025-11-04 05:53:43 +00:00 
			
		
		
		
	docs: Swap upgrade-postgresql steps with rebuilding the venv.
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:
		
				
					committed by
					
						
						Tim Abbott
					
				
			
			
				
	
			
			
			
						parent
						
							e77a425a2b
						
					
				
				
					commit
					5e5478307a
				
			@@ -329,13 +329,7 @@ instructions for other supported platforms.
 | 
			
		||||
   currently installed version. But it's not important; the next
 | 
			
		||||
   step will re-install Zulip's configuration in any case.
 | 
			
		||||
 | 
			
		||||
4. As root, upgrade the database to the latest version of PostgreSQL:
 | 
			
		||||
 | 
			
		||||
   ```bash
 | 
			
		||||
   /home/zulip/deployments/current/scripts/setup/upgrade-postgresql
 | 
			
		||||
   ```
 | 
			
		||||
 | 
			
		||||
5. Next, we need to reinstall the current version of Zulip, which
 | 
			
		||||
4. Next, we need to reinstall the current version of Zulip, which
 | 
			
		||||
   among other things will recompile Zulip's Python module
 | 
			
		||||
   dependencies for your new version of Python and rewrite Zulip's
 | 
			
		||||
   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
 | 
			
		||||
   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
 | 
			
		||||
 | 
			
		||||
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
 | 
			
		||||
   step will re-install Zulip's configuration in any case.
 | 
			
		||||
 | 
			
		||||
4. As root, upgrade the database to the latest version of PostgreSQL:
 | 
			
		||||
 | 
			
		||||
   ```bash
 | 
			
		||||
   /home/zulip/deployments/current/scripts/setup/upgrade-postgresql
 | 
			
		||||
   ```
 | 
			
		||||
 | 
			
		||||
5. Next, we need to reinstall the current version of Zulip, which
 | 
			
		||||
4. Next, we need to reinstall the current version of Zulip, which
 | 
			
		||||
   among other things will recompile Zulip's Python module
 | 
			
		||||
   dependencies for your new version of Python and rewrite Zulip's
 | 
			
		||||
   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
 | 
			
		||||
   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
 | 
			
		||||
   glibc library, which affects how PostgreSQL orders text data (known
 | 
			
		||||
   as "collations"); this corrupts database indexes that rely on
 | 
			
		||||
 
 | 
			
		||||
		Reference in New Issue
	
	Block a user