[Rt-commit] rt branch, 4.4/apache-mpm-doc, created. rt-4.4.4-120-g12d9e034ce

[Jim Brandt]

The branch, 4.4/apache-mpm-doc has been created
        at  12d9e034ce454c90f9be2b5b4b23a6b7ddcbce22 (commit)

- Log -----------------------------------------------------------------
commit 12d9e034ce454c90f9be2b5b4b23a6b7ddcbce22
Author: Jim Brandt <jbrandt at bestpractical.com>
Date:   Fri Jul 10 10:04:46 2020 -0400

    Document recommended Apache MPM for RT

diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index a6cba442b4..47d3473490 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -32,6 +32,19 @@ spontaneously logged in as other users in the system.
 See also L<authentication/Apache configuration>, in case you intend to
 use Apache to provide authentication.
 
+=head3 prefork MPM
+
+Apache can run with several different
+L<Multi-Processing Modules (MPMs)|https://httpd.apache.org/docs/2.4/mpm.html>.
+RT is designed to run only with the L<prefork MPM|https://httpd.apache.org/docs/2.4/mod/prefork.html>
+RT will run with the event MPM, but it will run very poorly
+and you are likely to see issues like intermittent errors when loading
+pages, slowness, and possible excessive memory usage.
+
+In the past, Apache defaulted to the prefork MPM, but the packaged Apache
+on many newer Linux systems defaults to event, so it is important to
+make sure Apache is configured to use prefork on your RT server.
+
 =head3 mod_fastcgi
 
     # Tell FastCGI to put its temporary files somewhere sane; this may

-----------------------------------------------------------------------