Differences

This shows you the differences between two versions of the page.

--- en:release:3.13_release_notes [2025/11/21 01:17] – [Important Changes and Bug Fixes for 3.12] kjdon
+++ en:release:3.13_release_notes [2026/02/16 22:41] (current) – [Proxying Tomcat with Apache] kjdon
@@ Line 12: / Line 12: @@
 ===== Installation Instructions=====
+==== Proxying Tomcat with Apache====
+A common scenario is to have tomcat running over http on localhost, and use Apache HTTP server to make it visible to the outside world.
+For example, you have tomcat running greenstone on port 8383, with context /greenstone3. These are set in build.properties using properties:**localhost.port.http** and **greenstone.context**.
+Your Apache webserver is running as https://mysite.org.nz. To have the tomcat available at mysite.org.nz/archive, for example, add something like the following to your apache config file VirtualHost:
+<code>
+<IfModule mod_ssl.c>
+<VirtualHost *:443>
+  ServerAdmin [email protected]
+  ServerName mysite.org.nz
+  LogFormat "%a %l %u %t \"%r\" %>s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
+  TraceEnable off
+  RewriteEngine On
+  RewriteRule ^/archive$ /archive/ [R=301,L]
+  ProxyRequests Off
+  ProxyPreserveHost On
+  ProxyTimeout 300
+  ProxyPass /archive/ http://localhost:8383/greenstone3/
+  ProxyPassReverse /archive/ http://localhost:8383/greenstone3/
+  <Location /archive>
+    ProxyPassReverseCookiePath /greenstone3 /archive
+  </Location>
+  RequestHeader set X-Forwarded-Proto  expr=%{REQUEST_SCHEME}
+  RequestHeader set X-Forwarded-Host   "%{HTTP_HOST}s"
+  RequestHeader set X-Forwarded-Port   "%{SERVER_PORT}s"
+  RequestHeader set X-Forwarded-SSL    expr=%{HTTPS}
+  RequestHeader set X-Forwarded-Prefix "/archive"
+</VirtualHost>
+</IfModule>
+</code>
+Your library will then be available at https://mysite.org.nz/archive/library
 ===== Running Greenstone =====