[Rt-commit] rt branch 5.0/test-apache-proxy-fcgi updated. rt-5.0.4-23-g6b419e21b6

[BPS Git Server]

This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "rt".

The branch, 5.0/test-apache-proxy-fcgi has been updated
       via  6b419e21b6ae58d16ef868cb8d7e21e447053706 (commit)
      from  906007d0c45206348681a6624f3ee6bcfe30cccf (commit)

Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.

- Log -----------------------------------------------------------------
commit 6b419e21b6ae58d16ef868cb8d7e21e447053706
Author: sunnavy <sunnavy at bestpractical.com>
Date:   Fri Jun 9 04:37:35 2023 +0800

    Document web deployment with apache+proxy_fcgi

diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 6ee03d48d8..65983c3e72 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -35,19 +35,17 @@ 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
+=head3 mod_fcgid
 
 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>.
+To use mod_fcgid, you need to run it with the L<prefork MPM|https://httpd.apache.org/docs/2.4/mod/prefork.html>.
 Most Linux distributions today use the event MPM by default, so it is
 important to make sure Apache is configured to use prefork on your RT
 server. If you do not use prefork MPM, RT will start okay but fail under
 production load, either because the web server crashes or performance
 severely degrades.
 
-=head3 mod_fcgid
-
 B<WARNING>: Before mod_fcgid 2.3.6, the maximum request size was 1GB.
 Starting in 2.3.6, this is now 128Kb.  This is unlikely to be large
 enough for any RT install that handles attachments.  You can read more
@@ -80,6 +78,28 @@ to return to the old default.
         </Location>
     </VirtualHost>
 
+=head3 mod_proxy_fcgi
+
+As a proxy module, it requires external RT processes, e.g.
+
+    /opt/rt5/sbin/rt-server.fcgi --listen /opt/rt5/var/rt.sock --nproc 10
+
+Apache configuration is like:
+
+    <VirtualHost rt.example.com>
+        ### Optional apache logs for RT
+        # Ensure that your log rotation scripts know about these files
+        # ErrorLog /opt/rt5/var/log/apache2.error
+        # TransferLog /opt/rt5/var/log/apache2.access
+        # LogLevel debug
+
+        AddDefaultCharset UTF-8
+
+        ProxyPass / unix:/opt/rt5/var/rt.sock|fcgi://localhost/
+        ProxyFCGIBackendType GENERIC
+        ProxyFCGISetEnvIf "true" SCRIPT_NAME ""
+    </VirtualHost>
+
 =head3 mod_perl 2.xx
 
 B<WARNING: mod_perl 1.99_xx is not supported.>
@@ -211,6 +231,13 @@ the relevant directives to:
         ...
     </Location>
 
+If you are using the sample proxy_fcgi config, change relevant directives to:
+
+    ProxyPass /rt/ unix:/opt/rt5/var/rt.sock|fcgi://localhost/
+    <Location /rt>
+        ProxyFCGISetEnvIf "true" SCRIPT_NAME "/rt"
+    </Location>
+
 If you're using the sample mod_perl configuration, you only need to change the
 C<Location> directive.
 

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

Summary of changes:
 docs/web_deployment.pod | 35 +++++++++++++++++++++++++++++++----
 1 file changed, 31 insertions(+), 4 deletions(-)


hooks/post-receive
-- 
rt