[Rt-commit] rt branch, 4.0/doc-sublocation-deployment, updated. rt-4.0.0rc6-7-g3789fc0
Thomas Sibley
trs at bestpractical.com
Wed Mar 2 11:24:09 EST 2011
The branch, 4.0/doc-sublocation-deployment has been updated
via 3789fc0f75da2718fdcbaa2d9c0c5abe322973ba (commit)
via ec39f5df4dfa96ce365e0f0f547e0f0fc2eec5d0 (commit)
via 6ce8b76809fe247bed68bb8da0da96ec6ff728b4 (commit)
via d6bc7faf51b344c85b5e2a969e4ae88fa1643722 (commit)
via 9f20655fa10acac55da75c76f0860b53b23dc277 (commit)
via dd485135b51e9b60f7f122c65a0065e7179ffc27 (commit)
from 06a1ef2d1b41df2d4aa93bef0440eef5e5949cfc (commit)
Summary of changes:
docs/web_deployment.pod | 39 +++++++++++++++++++++------------------
1 files changed, 21 insertions(+), 18 deletions(-)
- Log -----------------------------------------------------------------
commit dd485135b51e9b60f7f122c65a0065e7179ffc27
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:13:52 2011 -0500
Reword doc into prose instead of multiple headers
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 3d4bae2..5005169 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -131,33 +131,23 @@ configuration examples.
=cut
-=head1 Extra
+=head1 Running RT at /rt rather than /
-=head2 RT web in sublocation like /rt
-
-=head3 Update RT config
-
-Set C<$WebPath> config in F<RT_SiteConfig.pm>:
+First you need to tell RT where it's located by setting C<$WebPath> in your F<RT_SiteConfig.pm>:
Set($WebPath, "/rt");
-=head3 Update web server config
-
-=head4 If it's Apache
+Then you need to update your Apache configuration to match. Prefix the RT related C<Alias>, C<ScriptAlias> and C<Location> directives with C</rt>.
-Prefix RT related C<Alias>, C<ScriptAlias> and C<Location> directives with '/rt'
+For example: if you're using the sample FastCGI config above, you might change it to:
-e.g.
-
- Alias /rt/NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
- ScriptAlias /rt /opt/rt4/sbin/rt-server.fcgi/
+ Alias /rt/NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
+ ScriptAlias /rt/ /opt/rt4/sbin/rt-server.fcgi/
- <Location /rt>
+ <Location /rt>
...
- </Location>
-
-=head4 If it's not Apache
+ </Location>
-Please see L<Plack::Handler::FCGI> or the web server's documents for
-configuration examples.
+If you're not using Apache, please see L<Plack::Handler::FCGI> or the web
+server's own documentation for configuration examples.
commit 9f20655fa10acac55da75c76f0860b53b23dc277
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:14:37 2011 -0500
Add a note about trailing slashes
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 5005169..b30cda0 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -135,6 +135,8 @@ configuration examples.
First you need to tell RT where it's located by setting C<$WebPath> in your F<RT_SiteConfig.pm>:
+ # Important: don't include a trailing slash here. Read `perldoc
+ # etc/RT_Config.pm` for more information.
Set($WebPath, "/rt");
Then you need to update your Apache configuration to match. Prefix the RT related C<Alias>, C<ScriptAlias> and C<Location> directives with C</rt>.
commit d6bc7faf51b344c85b5e2a969e4ae88fa1643722
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:18:25 2011 -0500
Add a note about the DocumentRoot pitfall
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index b30cda0..16a1c0b 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -139,13 +139,19 @@ First you need to tell RT where it's located by setting C<$WebPath> in your F<RT
# etc/RT_Config.pm` for more information.
Set($WebPath, "/rt");
-Then you need to update your Apache configuration to match. Prefix the RT related C<Alias>, C<ScriptAlias> and C<Location> directives with C</rt>.
+Then you need to update your Apache configuration to match. Prefix the RT
+related C<Alias>, 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 it 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
+ DocumentRoot /var/www
+
<Location /rt>
...
</Location>
commit 6ce8b76809fe247bed68bb8da0da96ec6ff728b4
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:18:43 2011 -0500
Wrapping to 80
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 16a1c0b..a13df77 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -133,7 +133,8 @@ configuration examples.
=head1 Running RT at /rt rather than /
-First you need to tell RT where it's located by setting C<$WebPath> in your F<RT_SiteConfig.pm>:
+First you need to tell RT where it's located by setting C<$WebPath> in your
+F<RT_SiteConfig.pm>:
# Important: don't include a trailing slash here. Read `perldoc
# etc/RT_Config.pm` for more information.
@@ -144,7 +145,8 @@ related C<Alias>, 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 it to:
+For example: if you're using the sample FastCGI config above, you might change
+it to:
Alias /rt/NoAuth/images/ /opt/rt4/share/html/NoAuth/images/
ScriptAlias /rt/ /opt/rt4/sbin/rt-server.fcgi/
commit ec39f5df4dfa96ce365e0f0f547e0f0fc2eec5d0
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:20:36 2011 -0500
Add a note about the sample mod_perl config
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index a13df77..17573d3 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -158,6 +158,9 @@ it to:
...
</Location>
+If you're using the sample mod_perl configuration, you only need to change the
+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.
commit 3789fc0f75da2718fdcbaa2d9c0c5abe322973ba
Author: Thomas Sibley <trs at bestpractical.com>
Date: Wed Mar 2 11:23:57 2011 -0500
Imply that you might not have all of these directives
diff --git a/docs/web_deployment.pod b/docs/web_deployment.pod
index 17573d3..6b94e39 100644
--- a/docs/web_deployment.pod
+++ b/docs/web_deployment.pod
@@ -140,7 +140,7 @@ F<RT_SiteConfig.pm>:
# etc/RT_Config.pm` for more information.
Set($WebPath, "/rt");
-Then you need to update your Apache configuration to match. Prefix the 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
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</>.
-----------------------------------------------------------------------
More information about the Rt-commit
mailing list