diff options
author | Thomas Sibley <trs@bestpractical.com> | 2011-08-12 18:41:09 +0400 |
---|---|---|
committer | Thomas Sibley <trs@bestpractical.com> | 2011-08-12 18:41:09 +0400 |
commit | 23bd6178124df6bddbb4821914f0ee5faa6ee5ce (patch) | |
tree | f961fcea22230c60570d9a129e62cc5b3a87ed8a | |
parent | d1659c7eb0354cb35f5bb12e400ec8cf27e06d0b (diff) | |
parent | ec4b18e31c3a92e63105664045d8460396c30d0a (diff) |
Merge branch '4.0/reorganize-web-deployment' into 4.0.2-relengrt-4.0.2rc2rt-4.0.2
-rw-r--r-- | docs/web_deployment.pod | 95 |
1 files changed, 54 insertions, 41 deletions
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod index e789c7197f..999195a3ff 100644 --- a/docs/web_deployment.pod +++ b/docs/web_deployment.pod @@ -22,47 +22,50 @@ to use L<Starman>, a high performance preforking server: /opt/rt4/sbin/rt-server --server Starman --port 8080 -=head2 mod_perl 2.xx +B<NOTICE>: After you run the standalone server as root, you will need to +remove your C<var/mason> 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. -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. +=head2 Apache + +B<WARNING>: Both C<mod_speling> and C<mod_cache> are known to break RT. +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. + +=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 +85,53 @@ 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 +=head3 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 +175,8 @@ With the nginx configuration: } } -=head3 lighttpd + +=head2 lighttpd server.modules += ( "mod_fastcgi" ) $HTTP["host"] =~ "^rt.example.com" { @@ -176,15 +198,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 / First you need to tell RT where it's located by setting C<$WebPath> in your |