Master to 4.2.8

[usit-rt.git] / docs / web_deployment.pod

diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 5d2cd4c00a7d393e76c37b37ce4b912706cf615b..79a9fb48d6200e3bb4bcc5d9666b36c307bd85eb 100644 (file)
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -22,12 +22,6 @@ to use L<Starman>, a high performance preforking server:
 
     /opt/rt4/sbin/rt-server --server Starman --port 8080
 
-B<NOTICE>: After you run the standalone server as root, you will need to
-remove your C<var/mason_data> directory, or the non-standalone servers
-(Apache, etc), which run as a non-privileged user, will not be able to
-write to it and will not work.
-
-
 =head2 Apache
 
 B<WARNING>: Both C<mod_speling> and C<mod_cache> are known to break RT.
@@ -35,6 +29,9 @@ C<mod_speling> will cause RT's CSS and JS to not be loaded, making RT
 appear unstyled. C<mod_cache> will cache cookies, making users be
 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 mod_fastcgi
 
     # Tell FastCGI to put its temporary files somewhere sane; this may
@@ -52,7 +49,6 @@ spontaneously logged in as other users in the system.
 
         AddDefaultCharset UTF-8
 
-        Alias /NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
         ScriptAlias / /opt/rt4/sbin/rt-server.fcgi/
 
         DocumentRoot "/opt/rt4/share/html"
@@ -89,7 +85,6 @@ to return to the old default.
 
         AddDefaultCharset UTF-8
 
-        Alias /NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
         ScriptAlias / /opt/rt4/sbin/rt-server.fcgi/
 
         DocumentRoot "/opt/rt4/share/html"
@@ -113,6 +108,11 @@ preference are ignored.  We suggest the C<prefork> MPM or FastCGI
 deployment if your privileged users are in a different timezone than the
 one the server is configured for.
 
+B<NOTE>: RT 3.8 and below suggested use of C<SetHandler perl-script>;
+this is incorrect for RT 4, and (starting in RT 4.0.11) RT will refuse
+to start, to prevent difficulties sending mail from RT.  Change to
+C<SetHandler modperl>, as the example below uses.
+
     <VirtualHost rt.example.com>
         ### Optional apache logs for RT
         # ErrorLog /opt/rt4/var/log/apache2.error
@@ -182,10 +182,6 @@ With the nginx configuration:
             fastcgi_param  SERVER_NAME        $server_name;
             fastcgi_pass 127.0.0.1:9000;
         }
-
-        location /NoAuth/images {
-            root /opt/rt4/share/html;
-        }
     }
 
 
@@ -193,21 +189,16 @@ With the nginx configuration:
 
     server.modules += ( "mod_fastcgi" )
     $HTTP["host"] =~ "^rt.example.com" {
-        alias.url = (
-            "/NoAuth/images/" => "/opt/rt4/share/html/NoAuth/images/",
-        )
-        $HTTP["url"] !~ "^/NoAuth/images/" {
-            fastcgi.server = (
-                "/" => (
-                    "rt" => (
-                        "port"        => "9000",
-                        "bin-path"    => "/opt/rt4/sbin/rt-server.fcgi",
-                        "check-local" => "disable",
-                        "fix-root-scriptname" => "enable",
-                    )
+        fastcgi.server = (
+            "/" => (
+                "rt" => (
+                    "port"        => "9000",
+                    "bin-path"    => "/opt/rt4/sbin/rt-server.fcgi",
+                    "check-local" => "disable",
+                    "fix-root-scriptname" => "enable",
                 )
             )
-        }
+        )
     }
 
 
@@ -221,14 +212,13 @@ F<RT_SiteConfig.pm>:
     Set($WebPath, "/rt");
 
 Then you need to update your Apache configuration to match.  Prefix any RT
-related C<Alias>, C<ScriptAlias> and C<Location> directives with C</rt>.  You
+related C<ScriptAlias> and C<Location> directives with C</rt>.  You
 should also make sure C<DocumentRoot> is B<not> set to
 C</opt/rt4/share/html/>, otherwise RT's source will be served from C</>.
 
 For example: if you're using the sample FastCGI config above, you might change
 the relevant directives to:
 
-    Alias /rt/NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
     ScriptAlias /rt /opt/rt4/sbin/rt-server.fcgi/
 
     # Set DocumentRoot as appropriate for the other content you want to serve
@@ -243,4 +233,3 @@ C<Location> directive.
 
 If you're not using Apache, please see L<Plack::Handler::FCGI> or the web
 server's own documentation for configuration examples.
-