[Rt-commit] rt branch, psgi, updated. rt-3.9.4-280-gd7c8bcc

[Shawn Moore]

The branch, psgi has been updated
       via  d7c8bcc94f2618a2d5a8c8190f5e8781de6e936c (commit)
      from  e7dbc0053a798f84c2dafc96e1c96da332383bce (commit)

Summary of changes:
 docs/web_deployment.pod |  105 +++++++++++++++++++++++------------------------
 1 files changed, 52 insertions(+), 53 deletions(-)

- Log -----------------------------------------------------------------
commit d7c8bcc94f2618a2d5a8c8190f5e8781de6e936c
Author: Shawn M Moore <sartak at bestpractical.com>
Date:   Thu Nov 4 15:57:33 2010 -0400

    PODify web_deployment.pod

diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index cf6b7d2..cf11d83 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -1,17 +1,17 @@
-SETTING UP THE WEB INTERFACE
-----------------------------
+=head1 SETTING UP THE WEB INTERFACE
 
-RT's web interface is based around HTML::Mason, which works well with
+RT's web interface is based around L<HTML::Mason>, which works well with
 the mod_perl perl interpreter within Apache httpd and FastCGI.
 
 Once you've set up the web interface, consider setting up automatic
 logout for inactive sessions. For more information about how to do that,
 run
+
     perldoc /path/to/rt/sbin/rt-clean-sessions
 
+=head2 mod_perl
 
-mod_perl 1.xx
--------------
+=head3 mod_perl 1.xx
 
 WARNING: mod_perl 1.99_xx is not supported.
 
@@ -26,62 +26,60 @@ the following command:
 Next, add a few lines to your Apache 1.3.xx configuration file, so that
 it knows where to find RT:
 
-<VirtualHost your.ip.address>
-    ServerName your.rt.server.hostname
+    <VirtualHost your.ip.address>
+        ServerName your.rt.server.hostname
 
-    DocumentRoot /opt/rt3/share/html
-    AddDefaultCharset UTF-8
+        DocumentRoot /opt/rt3/share/html
+        AddDefaultCharset UTF-8
 
-    # optional apache logs for RT
-    # ErrorLog /opt/rt3/var/log/apache.error
-    # TransferLog /opt/rt3/var/log/apache.access
+        # optional apache logs for RT
+        # ErrorLog /opt/rt3/var/log/apache.error
+        # TransferLog /opt/rt3/var/log/apache.access
 
-    PerlModule Apache::DBI
-    PerlRequire /opt/rt3/bin/webmux.pl
+        PerlModule Apache::DBI
+        PerlRequire /opt/rt3/bin/webmux.pl
 
-    <Location /NoAuth/images>
-        SetHandler default
-    </Location>
-    <Location />
-        SetHandler perl-script
-        PerlHandler RT::Mason
-    </Location>
-</VirtualHost>
+        <Location /NoAuth/images>
+            SetHandler default
+        </Location>
+        <Location />
+            SetHandler perl-script
+            PerlHandler RT::Mason
+        </Location>
+    </VirtualHost>
 
-mod_perl 2.xx
--------------
+=head3 mod_perl 2.xx
 
 WARNING: mod_perl 1.99_xx is not supported.
 
 Add a few lines to your Apache 2.xx configuration file, so that
 it knows where to find RT:
 
-<VirtualHost your.ip.address>
-    ServerName your.rt.server.hostname
+    <VirtualHost your.ip.address>
+        ServerName your.rt.server.hostname
 
-    DocumentRoot /opt/rt3/share/html
-    AddDefaultCharset UTF-8
+        DocumentRoot /opt/rt3/share/html
+        AddDefaultCharset UTF-8
 
-    # optional apache logs for RT
-    # ErrorLog /opt/rt3/var/log/apache2.error
-    # TransferLog /opt/rt3/var/log/apache2.access
+        # optional apache logs for RT
+        # ErrorLog /opt/rt3/var/log/apache2.error
+        # TransferLog /opt/rt3/var/log/apache2.access
 
-    PerlRequire "/opt/rt3/bin/webmux.pl"
+        PerlRequire "/opt/rt3/bin/webmux.pl"
 
-    <Location /NoAuth/images>
-        SetHandler default
-    </Location>
-    <Location />
-        SetHandler perl-script
-        PerlResponseHandler RT::Mason
-    </Location>
-</VirtualHost>
+        <Location /NoAuth/images>
+            SetHandler default
+        </Location>
+        <Location />
+            SetHandler perl-script
+            PerlResponseHandler RT::Mason
+        </Location>
+    </VirtualHost>
 
-FastCGI
--------
+=head2 FastCGI
 
 Installation with FastCGI is a little bit more complex and is documented
-in detail at http://wiki.bestpractical.com/index.cgi?FastCGIConfiguration
+in detail at L<http://wiki.bestpractical.com/index.cgi?FastCGIConfiguration>
 
 In the most basic configuration, you can set up your webserver to run
 as a user who is a member of the "rt" unix group so that the FastCGI script
@@ -92,19 +90,20 @@ mentioned above.
 To install RT with FastCGI, you'll need to add a few lines to your
 Apache configuration file telling it about RT:
 
+    # Tell FastCGI to put its temporary files somewhere sane.
+    FastCgiIpcDir /tmp
 
-# Tell FastCGI to put its temporary files somewhere sane.
-FastCgiIpcDir /tmp
+    FastCgiServer /opt/rt3/bin/mason_handler.fcgi -idle-timeout 120
 
-FastCgiServer /opt/rt3/bin/mason_handler.fcgi -idle-timeout 120
+    <VirtualHost rt.example.com>
+       ServerName your.rt.server.hostname
 
-<VirtualHost rt.example.com>
-   ServerName your.rt.server.hostname
+       # Pass through requests to display images
+       Alias /NoAuth/images/ /opt/rt3/share/html/NoAuth/images/
 
-   # Pass through requests to display images
-   Alias /NoAuth/images/ /opt/rt3/share/html/NoAuth/images/
+       AddHandler fastcgi-script fcgi
+       ScriptAlias / /opt/rt3/bin/mason_handler.fcgi/
+    </VirtualHost>
 
-   AddHandler fastcgi-script fcgi
-   ScriptAlias / /opt/rt3/bin/mason_handler.fcgi/
-</VirtualHost>
+=cut
 

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