====== Greenstone 3.13 Release Notes ======

**Release Name:** 3.13


**Release Date:**

** Released: **


** 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 admin@mysite.org.nz
  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 =====

===== Known Issues =====

===== Updated Translations =====

  * Tigran Zargaryan for Armenian translations