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/07/22 22:57] (current) – [Solr 9] kjdon
@@ Line 6: / Line 6: @@
 **Release Date:**
-** Released: **
+**Released:**
-** Release Candidate History **
+**Release Candidate History**
 ===== 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 /solr/ http://localhost:7983/solr/
+  ProxyPassReverse /solr/ http://localhost:7983/solr/
+  ProxyPass /webswing-server/ http://localhost:8383/webswing-server/ upgrade=websocket
+  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
+If you want your library to be available at https://mysite.org.nz/library - i.e. without the archive part, you can modify the lines with archive in them to the following:
+<code>
+  #RewriteRule ^/archive$ /archive/ [R=301,L]  - comment it out as no longer needed
+  ...
+  ProxyPass / http://localhost:8383/greenstone3/
+  ProxyPassReverse / http://localhost:8383/greenstone3/
+  <Location />
+    ProxyPassReverseCookiePath /greenstone3 /
+  </Location>
+  ....
+  RequestHeader set X-Forwarded-Prefix "/"
+</code>
+Note that if you have a ProxyPass for / it must come AFTER any other ProxyPass directives.
 ===== Running Greenstone =====
 ===== Important Changes and Bug Fixes for 3.13 =====
+===== Tomcat 10 =====
+We have moved from Tomcat 8 to Tomcat 10.
+===== Solr 9 =====
+We have moved from Solr 4 to Solr9.
+Solr9 runs as a separate jetty webserver. Collection cores now partly live in data/ext/solr9/cores. Core conf lives here, with dataDir pointing back to the collection, so the actual indexes live in the collection.
+  * If you rename a collection, or rename your Greenstone installation folder, you need to look at the cores folder, and maybe rename directories (for collection/site rename) and also edit the path in the core's core.properties file.
+  * If you want to delete a solr collection its no longer enough just to delete the collection directory from the collect directory. The cores also need deleting. Please run delcol.pl. ''delcol.pl -h'' for options.
 ===== Known Issues =====