paulmataruso/zulip
1
0
Fork 0
mirror of https://github.com/zulip/zulip.git synced 2025-10-25 09:03:57 +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
```
2. Upgrade the operating system using the OS's standard tooling.
E.g. for Ubuntu, this means running `do-release-upgrade` and following
the prompts until it completes successfully:
2. Switch to the root user and upgrade the operating system using the
OS's standard tooling. E.g. for Ubuntu, this means running
`do-release-upgrade` and following the prompts until it completes
successfully:
```
sudo -i # Or otherwise get a root shell
do-release-upgrade
```
3. Run the following commands to upgrade the database installation and
OS configuration to match the new OS version:
When `do-release-upgrade` asks you how to upgrade configuration
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
@@ -296,18 +304,24 @@ to back up the system:
/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
the OS's standard tooling. E.g. for Ubuntu, this means running
2. Switch to the root user and upgrade the operating system using the
OS's standard tooling. E.g. for Ubuntu, this means running
`do-release-upgrade` and following the prompts until it completes
successfully:
```
sudo -i
sudo -i # Or otherwise get a root shell
do-release-upgrade
```
3. Run the following commands to upgrade the database installation and
OS configuration to match the new OS version:
When `do-release-upgrade` asks you how to upgrade configuration
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