paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-11-05 06:23:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Clarify some key parts of OS upgrade documentation.

Browse Source 
Thanks to Vishnu Ks for testing to figure these out.
This commit is contained in:
Tim Abbott
2019-04-17 12:47:45 -07:00
parent 6d7a3cf4d7
commit a88643313f
1 changed files with 24 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
docs/production/maintain-secure-upgrade.md
View File

@@ -251,16 +251,24 @@ to back up the system:
/home/zulip/deployments/current/manage.py backup --output=/home/zulip/release-upgrade.backup.tar.gz /home/zulip/deployments/current/manage.py backup --output=/home/zulip/release-upgrade.backup.tar.gz
``` ```
2. Upgrade the operating system using the OS's standard tooling. 2. Switch to the root user and upgrade the operating system using the
E.g. for Ubuntu, this means running `do-release-upgrade` and following OS's standard tooling. E.g. for Ubuntu, this means running
the prompts until it completes successfully: `do-release-upgrade` and following the prompts until it completes
successfully:
``` ```
sudo -i # Or otherwise get a root shell
do-release-upgrade do-release-upgrade
``` ```
3. Run the following commands to upgrade the database installation and When `do-release-upgrade` asks you how to upgrade configuration
OS configuration to match the new OS version: files for services that Zulip manages like `redis`, `postgres`,
`nginx`, and `memcached`, the best choice is `N` to keep the
currently installed version. But it's not important; the next
step will re-install Zulip's configuration in any case.
3. As root, upgrade the database installation and OS configuration to
match the new OS version:
``` ```
/home/zulip/deployments/current/scripts/zulip-puppet-apply -f /home/zulip/deployments/current/scripts/zulip-puppet-apply -f
@@ -296,18 +304,24 @@ to back up the system:
/home/zulip/deployments/current/manage.py backup --output=/home/zulip/release-upgrade.backup.tar.gz /home/zulip/deployments/current/manage.py backup --output=/home/zulip/release-upgrade.backup.tar.gz
``` ```
2. Now, switch to the root user and upgrade the operating system using 2. Switch to the root user and upgrade the operating system using the
the OS's standard tooling. E.g. for Ubuntu, this means running OS's standard tooling. E.g. for Ubuntu, this means running
`do-release-upgrade` and following the prompts until it completes `do-release-upgrade` and following the prompts until it completes
successfully: successfully:
``` ```
sudo -i sudo -i # Or otherwise get a root shell
do-release-upgrade do-release-upgrade
``` ```
3. Run the following commands to upgrade the database installation and When `do-release-upgrade` asks you how to upgrade configuration
OS configuration to match the new OS version: files for services that Zulip manages like `redis`, `postgres`,
`nginx`, and `memcached`, the best choice is `N` to keep the
currently installed version. But it's not important; the next
step will re-install Zulip's configuration in any case.
3. As root, upgrade the database installation and OS configuration to
match the new OS version:
``` ```
/home/zulip/deployments/current/scripts/zulip-puppet-apply -f /home/zulip/deployments/current/scripts/zulip-puppet-apply -f