cocoon-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From stev...@outerthought.org
Subject [WIKI-UPDATE] HowTos ApacheModProxy Wed Feb 5 18:00:05 2003
Date Wed, 05 Feb 2003 17:00:05 GMT
Page: http://wiki.cocoondev.org/Wiki.jsp?page=HowTos, version: 60 on Wed Feb  5 16:15:08 2003
by PierFumagalli

- * __[Using Apache's mod_proxy with Cocoon|http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=104441321803644&w=2]__
-- A description of how to configure Apache mod_proxy as a front-end to Cocoon by [Pier Fumagalli|PierFumagalli]
([Wiki Version|ApacheModProxy]).
+ * __[Using Apache's mod_proxy with Cocoon|ApacheModProxy]__ -- A description of how to configure
Apache mod_proxy as a front-end to Cocoon by [Pier Fumagalli|PierFumagalli] (Original emails
part [#1|http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=104441321803644&w=2] and
[#2|http://marc.theaimsgroup.com/?l=xml-cocoon-dev&m=104445792717349&w=2]).


Page: http://wiki.cocoondev.org/Wiki.jsp?page=ApacheModProxy, version: 5 on Wed Feb  5 16:12:35
2003 by PierFumagalli

-     # Make sure that Apache processes the headers coming back from the proxy
? ----

+ # Make sure that Apache processes the headers coming back from the proxy
-     # requests. This will enable also the evaluation of HTTP status codes.
? ----

+ # requests. This will enable also the evaluation of HTTP status codes.
-     ProxyPassReverse / http://localhost:8000/
? ----

+ ProxyPassReverse / http://localhost:8000/
-     # Tell mod_mod proxy that it should not send back the body-content of
? ----

+ # Tell mod_mod proxy that it should not send back the body-content of
-     # error pages, but be fascist and use its local error pages if the
? ----

+ # error pages, but be fascist and use its local error pages if the
-     # remote HTTP stack is sending an HTTP 4xx or 5xx status code.
? ----

+ # remote HTTP stack is sending an HTTP 4xx or 5xx status code.
-     ProxyErrorOverride On
? ----

+ ProxyErrorOverride On
-     # For each individual error we want to handle, let's specify what file
? ----

+ # For each individual error we want to handle, let's specify what file
-     # we want to use. Note that all files must be available through a
? ----

+ # we want to use. Note that all files must be available through a
-     # locally accessible directory (as our /static/), and they can even be
? ----

+ # locally accessible directory (as our /static/), and they can even be
-     # SSI files (SHTML files).
? ----

+ # SSI files (SHTML files).
-     ErrorDocument 404 /static/notfound.shtml
? ----

+ ErrorDocument 404 /static/notfound.shtml
-     ErrorDocument 500 /static/error.shtml
? ----

+ ErrorDocument 500 /static/error.shtml
-     ErrorDocument 502 /static/unavailable.shtml
? ----

+ ErrorDocument 502 /static/unavailable.shtml
-     # Make sure that the virtual host name is passed through to the
? ----

+ # Make sure that the virtual host name is passed through to the
-     # backend servlet container for virtual host support.
? ----

+ # backend servlet container for virtual host support.
-     ProxyPreserveHost On
? ----

+ ProxyPreserveHost On
- !!Putting it all together
+ !!Putting it all together (step 2)
?                          +++++++++

+ {{{
+ #######################################################################
+ # GLOBAL CONFIGURATIONS                                               #
+ #######################################################################
-     #######################################################################
-     # GLOBAL CONFIGURATIONS                                               #
-     #######################################################################
+ # Make sure that my document root points to the root of the web
+ # application (where the WEB-INF is located, for instance).
+ DocumentRoot /export/webapps/cocoon
-     # Make sure that my document root points to the root of the web
-     # application (where the WEB-INF is located, for instance).
-     DocumentRoot /export/webapps/cocoon
+ # Make sure that Server Side Includes are processed and sent
+ # to the client with mime-type as text/html
+ AddType text/html .shtml
+ AddOutputFilter Includes .shtml
-     # Make sure that Server Side Includes are processed and sent
-     # to the client with mime-type as text/html
-     AddType text/html .shtml
-     AddOutputFilter Includes .shtml
+ # Make sure that our SHTMLs are processed in the static
+ # directory
+ <Directory "/export/webapps/cocoon">
+     Options +IncludesNoExec
+ </Directory>
+ #######################################################################
+ # ERROR PAGES CONFIGURATION                                           #
+ #######################################################################
-     # Make sure that our SHTMLs are processed in the static
-     # directory
-     <Directory "/export/webapps/cocoon">
-         Options +IncludesNoExec
-     </Directory>
-     #######################################################################
-     # ERROR PAGES CONFIGURATION                                           #
-     #######################################################################
+ # If mod_proxy cannot connect to the servlet container, we want
+ # to display a nice static page saying the reason. This is a
+ # SHTML page (using the Server-Side-Includes filter)
+ ErrorDocument 502 /static/unavailable.shtml
-     # If mod_proxy cannot connect to the servlet container, we want
-     # to display a nice static page saying the reason. This is a
-     # SHTML page (using the Server-Side-Includes filter)
+ # For each individual error we want to handle, let's specify what file
+ # we want to use. Note that all files must be available through a
+ # locally accessible directory (as our /static/), and they can even be
+ # SSI files (SHTML files).
+ ErrorDocument 404 /static/notfound.shtml
-     ErrorDocument 502 /static/unavailable.shtml
? ----                ^         ----------

+ ErrorDocument 500 /static/error.shtml
?                 ^          ++++

+ #######################################################################
+ # MOD_PROXY CONFIGURATIONS                                            #
+ #######################################################################
-     # For each individual error we want to handle, let's specify what file
-     # we want to use. Note that all files must be available through a
-     # locally accessible directory (as our /static/), and they can even be
-     # SSI files (SHTML files).
-     ErrorDocument 404 /static/notfound.shtml
-     ErrorDocument 500 /static/error.shtml
-     #######################################################################
-     # MOD_PROXY CONFIGURATIONS                                            #
-     #######################################################################
+ # Make sure that if the servlet container specifies a "Location" HTTP
+ # header during redirection starting with "http://localhost:8080/", we
+ # can handle it and return to our client the effective (not real)
+ # location we want to redirect them to. This is _essential_ to handle
+ # also the error returned by the backend servlet container.
+ ProxyPassReverse / http://localhost:8080/
+ # Make sure that the virtual host name is passed through to the
+ # backend servlet container for virtual host support.
+ ProxyPreserveHost On
-     # Make sure that if the servlet container specifies a "Location" HTTP
-     # header during redirection starting with "http://localhost:8080/", we
-     # can handle it and return to our client the effective (not real)
-     # location we want to redirect them to. This is _essential_ to handle
-     # also the error returned by the backend servlet container.
-     ProxyPassReverse / http://localhost:8080/
-     # Make sure that the virtual host name is passed through to the
-     # backend servlet container for virtual host support.
-     ProxyPreserveHost On
+ # Tell mod_mod proxy that it should not send back the body-content of
+ # error pages, but be fascist and use its local error pages if the
+ # remote HTTP stack is sending an HTTP 4xx or 5xx status code.
+ ProxyErrorOverride On
+ #######################################################################
+ # MOD_REWRITE CONFIGURATIONS                                          #
+ #######################################################################
-     # Tell mod_mod proxy that it should not send back the body-content of
-     # error pages, but be fascist and use its local error pages if the
-     # remote HTTP stack is sending an HTTP 4xx or 5xx status code.
-     ProxyErrorOverride On
+ # The nastiness begins, let's fire up the "rewrite engine"
+ RewriteEngine On
-     #######################################################################
-     # MOD_REWRITE CONFIGURATIONS                                          #
-     #######################################################################
-     # The nastiness begins, let's fire up the "rewrite engine"
-     RewriteEngine On
+ # Everything that starts with "/static" or "/static/" is served straight
+ # through: no redirection, no proxying, no nothing, and the [L] flag
+ # implies that if this rule is matched, no other matching must be
+ # performed
+ RewriteRule "^/static/?(.*)" "$0" [L]
-     # Everything that starts with "/static" or "/static/" is served straight
-     # through: no redirection, no proxying, no nothing, and the [L] flag
-     # implies that if this rule is matched, no other matching must be
-     # performed
-     RewriteRule "^/static/?(.*)" "$0" [L]
+ # Everything that starts with a NON-CASE-SENSITIVE match (the NC flag)
+ # of "/WEB-INF" or "/WEB-INF/" is forbidden (the F flag). And again,
+ # this is the last rule (the L flag), nothing will be processed by the
+ # rewrite engine if this rule is matched
+ RewriteRule "^/WEB-INF/?(.*)" "$0" [L,F,NC]
-     # Everything that starts with a NON-CASE-SENSITIVE match (the NC flag)
-     # of "/WEB-INF" or "/WEB-INF/" is forbidden (the F flag). And again,
-     # this is the last rule (the L flag), nothing will be processed by the
-     # rewrite engine if this rule is matched
-     RewriteRule "^/WEB-INF/?(.*)" "$0" [L,F,NC]
+ # Everything ending in ".gif", ".jpg" or ".jpeg" will be served again
+ # directly by Apache, no need to bother the servlet container. As above
+ # this is the last rule as specified by the [L] flag at the end
+ RewriteRule "^/(.*)\.gif$" "$0" [L]
+ RewriteRule "^/(.*)\.(jpg|jpeg)$" "$0" [L]
-     # Everything ending in ".gif", ".jpg" or ".jpeg" will be served again
-     # directly by Apache, no need to bother the servlet container. As above
-     # this is the last rule as specified by the [L] flag at the end
-     RewriteRule "^/(.*)\.gif$" "$0" [L]
-     RewriteRule "^/(.*)\.(jpg|jpeg)$" "$0" [L]
- 
-     # Everything else not matched above needs to go to the servlet container
? ----

+ # Everything else not matched above needs to go to the servlet container
-     # via HTTP listening on port 8080. The [P] flag (which is required)
? ----

+ # via HTTP listening on port 8080. The [P] flag (which is required)
-     # implies that our requests will be handled by mod_proxy.
? ----

+ # implies that our requests will be handled by mod_proxy.
-     RewriteRule "^/(.*)" "http://localhost:8080/$1" [P]
? ----

+ RewriteRule "^/(.*)" "http://localhost:8080/$1" [P]
+ }}}
- <VirtualHost> section of your httpd.conf (obviously after having applied the
+ {{<VirtualHost>}} section of your {{httpd.conf}} (obviously after having applied the
? ++             ++                 ++          ++

- right now. Together, those three little pieces _will_ conquer the world.
+ right now. Together, those three little pieces __will__ conquer the world.
?                                                 +    +

- Have fun...
+ Have fun...\\[Pier|PierFumagalli]



Mime
View raw message