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]
