zulip/docs
Alex Vandiver faf71eea41 upgrade-postgresql: Do not remove other supervisor configs.
We previously used `zulip-puppet-apply` with a custom config file,
with an updated PostgreSQL version but more limited set of
`puppet_classes`, to pre-create the basic settings for the new cluster
before running `pg_upgradecluster`.

Unfortunately, the supervisor config uses `purge => true` to remove
all SUPERVISOR configuration files that are not included in the puppet
configuration; this leads to it removing all other supervisor
processes during the upgrade, only to add them back and start them
during the second `zulip-puppet-apply`.

It also leads to `process-fts-updates` not being started after the
upgrade completes; this is the one supervisor config file which was
not removed and re-added, and thus the one that is not re-started due
to having been re-added.  This was not detected in CI because CI added
a `start-server` command which was not in the upgrade documentation.

Set a custom facter fact that prevents the `purge` behaviour of the
supervisor configuration.  We want to preserve that behaviour in
general, and using `zulip-puppet-apply` continues to be the best way
to pre-set-up the PostgreSQL configuration -- but we wish to avoid
that behaviour when we know we are applying a subset of the puppet
classes.

Since supervisor configs are no longer removed and re-added, this
requires an explicit start-server step in the instructions after the
upgrades complete.  This brings the documentation into alignment with
what CI is testing.
2021-08-24 19:00:58 -07:00
..
_static readthedocs: Add proper backlink to the Zulip homepage. 2021-07-06 10:59:59 -07:00
_templates readthedocs: Add proper backlink to the Zulip homepage. 2021-07-06 10:59:59 -07:00
contributing docs: Adjust list item indentation for Prettier compatibility. 2021-08-20 23:14:37 -07:00
development docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
documentation docs: Avoid [GitHub] as an internal Markdown link reference name. 2021-08-20 23:14:37 -07:00
git docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
images docs: Add missing width to Zulip logo. 2021-02-05 09:49:33 -08:00
overview docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
production upgrade-postgresql: Do not remove other supervisor configs. 2021-08-24 19:00:58 -07:00
subsystems docs: Escape asterisks for Prettier compatibility. 2021-08-20 23:14:37 -07:00
testing docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
translating docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
tutorials reading-list: Inline links. 2021-08-20 23:14:37 -07:00
.gitignore gitignore: Anchor patterns that should be anchored. 2017-07-19 14:03:49 -07:00
code-of-conduct.md repository: Add CODE_OF_CONDUCT.md. 2017-06-14 18:43:08 -07:00
conf.py docs: Migrate from recommonmark to MyST-Parser. 2021-08-19 00:53:32 -07:00
index.md docs: Convert reST index pages to Markdown. 2021-08-20 06:22:42 -07:00
Makefile docs: Replace Makefile based on output of newer sphinx-quickstart. 2019-12-02 18:39:33 -08:00
README.md docs: Capitalize Markdown consistently. 2020-08-11 10:23:06 -07:00
requirements.readthedocs.txt requirements: Rename requirements files. 2017-11-21 02:38:26 +05:30
THIRDPARTY nagios: Replace check_website_response with standard check_http plugin. 2021-07-09 16:47:03 -07:00

Zulip Markdown documentation hosted elsewhere

The Markdown files in this directory ( /zulip/docs ) are not intended to be read on GitHub. Instead, visit our ReadTheDocs to read the Zulip documentation.