[Rt-commit] rt branch, 4.0/reorganize-web-deployment, created. rt-4.0.2rc1-13-gdc5df6d
Kevin Falcone
falcone at bestpractical.com
Thu Aug 11 13:05:50 EDT 2011
The branch, 4.0/reorganize-web-deployment has been created
at dc5df6dd89a9f7a7e6ef23a7cc0f61729bb2b426 (commit)
- Log -----------------------------------------------------------------
commit 186ade7aaa57d4b474c2e9fb62801edb1761978a
Author: Kevin Falcone <falcone at bestpractical.com>
Date: Thu Aug 11 13:04:40 2011 -0400
Reorganize by web server
Instead of having nginx and lighttpd be under the fcgi section, group by
Apache/nginx/lighttpd. Also moves mod_perl1/2 together at the bottom of
the apache section.
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index e789c71..d218b48 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -22,47 +22,40 @@ to use L<Starman>, a high performance preforking server:
/opt/rt4/sbin/rt-server --server Starman --port 8080
-=head2 mod_perl 2.xx
+=head2 Apache
-B<WARNING: mod_perl 1.99_xx is not supported.>
-B<WARNING>: Due to thread-safety limitations, all timestamps will be
-presented in the webserver's default time zone when using the C<worker>
-and C<event> MPMs; the C<$Timezone> setting and the user's timezone
-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.
+=head3 mod_fastcgi
+
+ # Tell FastCGI to put its temporary files somewhere sane; this may
+ # be necessary if your distribution doesn't already set it
+ #FastCgiIpcDir /tmp
+
+ FastCgiServer /opt/rt4/sbin/rt-server.fcgi -processes 5 -idle-timeout 300
<VirtualHost rt.example.com>
### Optional apache logs for RT
+ # Ensure that your log rotation scripts know about these files
# ErrorLog /opt/rt4/var/log/apache2.error
# TransferLog /opt/rt4/var/log/apache2.access
# LogLevel debug
AddDefaultCharset UTF-8
+ Alias /NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
+ ScriptAlias / /opt/rt4/sbin/rt-server.fcgi/
+
DocumentRoot "/opt/rt4/share/html"
<Location />
Order allow,deny
Allow from all
- SetHandler modperl
- PerlResponseHandler Plack::Handler::Apache2
- PerlSetVar psgi_app /opt/rt4/sbin/rt-server
+ Options +ExecCGI
+ AddHandler fastcgi-script fcgi
</Location>
- <Perl>
- use Plack::Handler::Apache2;
- Plack::Handler::Apache2->preload("/opt/rt4/sbin/rt-server");
- </Perl>
</VirtualHost>
-=head2 mod_fastcgi
-
- # Tell FastCGI to put its temporary files somewhere sane; this may
- # be necessary if your distribution doesn't already set it
- #FastCgiIpcDir /tmp
-
- FastCgiServer /opt/rt4/sbin/rt-server.fcgi -processes 5 -idle-timeout 300
+=head3 mod_fcgid
<VirtualHost rt.example.com>
### Optional apache logs for RT
@@ -82,35 +75,52 @@ one the server is configured for.
Allow from all
Options +ExecCGI
- AddHandler fastcgi-script fcgi
+ AddHandler fcgid-script fcgi
</Location>
</VirtualHost>
-=head2 mod_fcgid
+=head3 mod_perl 2.xx
+
+B<WARNING: mod_perl 1.99_xx is not supported.>
+
+B<WARNING>: Due to thread-safety limitations, all timestamps will be
+presented in the webserver's default time zone when using the C<worker>
+and C<event> MPMs; the C<$Timezone> setting and the user's timezone
+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.
<VirtualHost rt.example.com>
### Optional apache logs for RT
- # Ensure that your log rotation scripts know about these files
# ErrorLog /opt/rt4/var/log/apache2.error
# TransferLog /opt/rt4/var/log/apache2.access
# LogLevel debug
AddDefaultCharset UTF-8
- Alias /NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
- ScriptAlias / /opt/rt4/sbin/rt-server.fcgi/
-
DocumentRoot "/opt/rt4/share/html"
<Location />
Order allow,deny
Allow from all
- Options +ExecCGI
- AddHandler fcgid-script fcgi
+ SetHandler modperl
+ PerlResponseHandler Plack::Handler::Apache2
+ PerlSetVar psgi_app /opt/rt4/sbin/rt-server
</Location>
+ <Perl>
+ use Plack::Handler::Apache2;
+ Plack::Handler::Apache2->preload("/opt/rt4/sbin/rt-server");
+ </Perl>
</VirtualHost>
-=head3 nginx
+=head2 mod_perl 1.xx
+
+B<WARNING: mod_perl 1.99_xx is not supported.>
+
+To run RT using mod_perl 1.xx please see L<Plack::Handler::Apache1> for
+configuration examples.
+
+=head2 nginx
C<nginx> requires that you start RT's fastcgi process externally, for
example using C<spawn-fcgi>:
@@ -154,7 +164,7 @@ With the nginx configuration:
}
}
-=head3 lighttpd
+=head2 lighttpd
server.modules += ( "mod_fastcgi" )
$HTTP["host"] =~ "^rt.example.com" {
@@ -176,13 +186,6 @@ With the nginx configuration:
}
-=head2 mod_perl 1.xx
-
-B<WARNING: mod_perl 1.99_xx is not supported.>
-
-To run RT using mod_perl 1.xx please see L<Plack::Handler::Apache1> for
-configuration examples.
-
=cut
=head1 Running RT at /rt rather than /
commit dc5df6dd89a9f7a7e6ef23a7cc0f61729bb2b426
Author: Kevin Falcone <falcone at bestpractical.com>
Date: Thu Aug 11 13:05:33 2011 -0400
Warn about mod_speling and mod_cache and the fail they cause
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index d218b48..2b5bbc7 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -24,6 +24,10 @@ to use L<Starman>, a high performance preforking server:
=head2 Apache
+B<WARNING>: Both mod_speling and mod_cache are known to break RT.
+mod_speling will cause RT's CSS and JS to not be loaded, making RT
+appear unstyled. mod_cache will cause cookies to be cached, making it
+appear that RT is logging you in as a different user.
=head3 mod_fastcgi
-----------------------------------------------------------------------
More information about the Rt-commit
mailing list