diff server-setup.html @ 1700:79c837179ffb

Creating site for 2.6-SNAPSHOT
author Robert Casties <casties@mpiwg-berlin.mpg.de>
date Tue, 18 Dec 2018 10:45:17 +0000
parents 8a9c66abb57c
children 9538e27b5c2f
line wrap: on
line diff
--- a/server-setup.html	Mon Mar 26 17:16:47 2018 +0000
+++ b/server-setup.html	Tue Dec 18 10:45:17 2018 +0000
@@ -1,13 +1,13 @@
 <!DOCTYPE html>
 <!--
- | Generated by Apache Maven Doxia at 2018-03-14
+ | Generated by Apache Maven Doxia at 2018-12-18
  | Rendered using Apache Maven Fluido Skin 1.3.0
 -->
 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   <head>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <meta name="Date-Revision-yyyymmdd" content="20180314" />
+    <meta name="Date-Revision-yyyymmdd" content="20181218" />
     <meta http-equiv="Content-Language" content="en" />
     <title>digilib - The Digital Image Library &#x2013; Server setup for digilib</title>
     <link rel="stylesheet" href="./css/apache-maven-fluido-1.3.0.min.css" />
@@ -41,8 +41,8 @@
         <ul class="breadcrumb">
                 
                     
-                  <li id="publishDate">Last Published: 2018-03-14</li>
-                  <li class="divider">|</li> <li id="projectVersion">Version: 2.5-SNAPSHOT</li>
+                  <li id="publishDate">Last Published: 2018-12-18</li>
+                  <li class="divider">|</li> <li id="projectVersion">Version: 2.6-SNAPSHOT</li>
                       
                 
                     
@@ -268,7 +268,8 @@
 
     # do not forward-proxy!
     ProxyRequests off
-    # set proxy proto header
+    # set proxy headers
+    ProxyPreserveHost On
     RequestHeader set X-Forwarded-Proto &quot;https&quot;
     # digilib instances 
     &lt;Proxy balancer://digilibs&gt;
@@ -290,6 +291,16 @@
 <h2><a name="Jetty_behind_a_proxy"></a>Jetty behind a proxy</h2>
 <p>When you are using <a class="externalLink" href="https://www.eclipse.org/jetty/">Jetty</a> as servlet container behind an Apache or nginx proxy then you should make sure that Jetty processes the <tt>X-Forwarded-*</tt> headers from the proxy server to derive the correct request URL for the servlets.</p>
 <p>Please see <a class="externalLink" href="http://www.eclipse.org/jetty/documentation/9.4.x/configuring-connectors.html#_proxy_load_balancer_connection_configuration">this information for Jetty 9.4</a> or <a class="externalLink" href="https://wiki.eclipse.org/Jetty/Tutorial/Apache#Configuring_mod_proxy_http">this information for Jetty 8 and earlier versions</a>.</p></div>
+<div class="section">
+<h2><a name="Tomcat_behind_a_proxy"></a>Tomcat behind a proxy</h2>
+<p>When you are using <a class="externalLink" href="https://tomcat.apache.org">Tomcat</a> as a servlet container behind an Apache or nginx proxy then you should make sure that Tomcat processes the <tt>X-Forwarded-*</tt> headers from the proxy server to derive the correct request URL for the servlets.</p>
+<p>Please see the Tomcat documentation about the <a class="externalLink" href="https://tomcat.apache.org/tomcat-9.0-doc/config/valve.html#Remote_IP_Valve">Remote IP Valve</a>. You basically need to add the following XML tag with your proxy&#x2019;s IP numbers to the <tt>Host</tt> tag of your <tt>server.xml</tt> file: <tt>
+  &lt;Valve className=&quot;org.apache.catalina.valves.RemoteIpValve&quot;
+    internalProxies=&quot;127\.0\.0\.1|123\.45\.67\.89&quot;
+    remoteIpHeader=&quot;x-forwarded-for&quot; 
+    proxiesHeader=&quot;x-forwarded-by&quot; 
+    protocolHeader=&quot;x-forwarded-proto&quot; /&gt;
+</tt> and make sure <tt>ProxyPreserveHost</tt> is set to <tt>on</tt>.</p></div>
                   </div>
             </div>
           </div>