Release Name: 3.13

Release Date:

Released:

Release Candidate History

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:

<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>

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:

  #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 "/"

Note that if you have a ProxyPass for / it must come AFTER any other ProxyPass directives.

We have moved from Tomcat 8 to Tomcat 10.

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.

• Tigran Zargaryan for Armenian translations