Greenstone Wiki

User Tools

Site Tools

You are here: index » en » release » 3.10_release_notes
en:release:3.10_release_notes

Differences

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

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
Next revisionBoth sides next revision
en:release:3.10_release_notes [2021/09/17 05:51] – [Installing and running the binary release] anupamaen:release:3.10_release_notes [2023/07/04 06:31] – anupama
Line 1: Line 1:
 +
  ====== Greenstone 3.10 Release Notes ======  ====== Greenstone 3.10 Release Notes ======
 //This page may undergo further updates until the Greenstone 3.10 release and possibly for some time after. So continue to consult this page for the latest version of the 3.10 release notes.// //This page may undergo further updates until the Greenstone 3.10 release and possibly for some time after. So continue to consult this page for the latest version of the 3.10 release notes.//
Line 14: Line 15:
  
 ** Release Candidate History ** ** Release Candidate History **
-  * Greenstone 3.10 rc1: Release Candidate 1. Released 6 Dec 2020.\\ Binaries for Windows, GNU/Linux 64 bit, Mac Mojave/Catalina. Mac version generated on MacOS Mojave/10.14 and tested predominantly on Catalina/10.15. See notes immediatebly below.\\ Download from the [[http://www.greenstone.org/snapshots|snapshots]] page\\ [[https://svn.greenstone.org/main/tags/3.10rc1/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.10rc1|trac tag page]]. Code revision up to 34587. Tag revision:34590.+  * Greenstone 3.10 rc1: Release Candidate 1. Released 6 Dec 2020.\\ Binaries for Windows, GNU/Linux 64 bit, Mac Mojave/Catalina. Mac version generated on MacOS Mojave/10.14 and tested predominantly on Catalina/10.15. See notes immediately below.\\ Download from the [[http://www.greenstone.org/snapshots|snapshots]] page\\ [[https://svn.greenstone.org/main/tags/3.10rc1/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.10rc1|trac tag page]]. Code revision up to 34587. Tag revision:34590.
  
 **GS3.10rc1 issues and unknowns on Catalina Mac:** **GS3.10rc1 issues and unknowns on Catalina Mac:**
Line 50: Line 51:
 * **For Windows users:**  To install, download the file and double-click. On newer versions of Windows 10: If the green installer splash screen doesn't appear after a few seconds, then right click on the installer executable, choose Properties, go to the General tab and at the bottom (in the Security section) look for a tick box labelled Unblock and tick this. * **For Windows users:**  To install, download the file and double-click. On newer versions of Windows 10: If the green installer splash screen doesn't appear after a few seconds, then right click on the installer executable, choose Properties, go to the General tab and at the bottom (in the Security section) look for a tick box labelled Unblock and tick this.
  
 +
 +=== When the installer is running ===
 During the installation process you will be presented with several options. For many, the default settings will be sufficient. Some important options are During the installation process you will be presented with several options. For many, the default settings will be sufficient. Some important options are
   * Folder where you want greenstone3 to be installed.    * Folder where you want greenstone3 to be installed. 
Line 69: Line 72:
  
 ==== Installing in text-only mode ====  ==== Installing in text-only mode ==== 
-* Refer to [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]]+* Refer to [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]]
  
  
 ==== Adding source code to a binary release ====  ==== Adding source code to a binary release ==== 
  
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_component|Windows: Source Component instructions]] +  * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_component|Windows: Source Component instructions]] 
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_component1|Linux/Mac: Source Component instructions]]+  * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_component1|Linux/Mac: Source Component instructions]]
 ==== Installing a source release ====  ==== Installing a source release ==== 
  
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_distribution|Windows: Source Distribution instructions]] +  * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution|Windows: Source Distribution instructions]] 
-  * [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:installation#source_distribution1|Linux/Mac: Source Distribution instructions]]+  * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution1|Linux/Mac: Source Distribution instructions]]
  
  
Line 109: Line 112:
  
 ==== Setting up your Greenstone to run over https ==== ==== Setting up your Greenstone to run over https ====
-//**Note:** This section is untested for this release, as the prevalent method of supporting https for tomcat based servers appears to be to have a main apache httpd web server that works with https, then set up a ''reverse proxy'' to let apacha httpd redirect requests for GS3's tomcat server internally to Greenstone.//+//**Note:** This section is untested for this release, as the prevalent method of supporting https for tomcat based servers appears to be to have a main apache httpd web server that works with https, then set up a ''reverse proxy'' to let apache httpd redirect requests for GS3's tomcat server internally to Greenstone.//
  
 The more secure https protocol is increasingly required by browsers and gradually superseding http. Given that you meet the following requirements and configure your GS3 as below, Greenstone 3 has now been automated to obtain an https certificate for you from the free Certification Authority "Let's Encrypt". The more secure https protocol is increasingly required by browsers and gradually superseding http. Given that you meet the following requirements and configure your GS3 as below, Greenstone 3 has now been automated to obtain an https certificate for you from the free Certification Authority "Let's Encrypt".
Line 168: Line 171:
  
 There may be further adjustments made, including to display strings, but so far, we've decided on the above output formats and they seem to work on my regular PDF test documents.  There may be further adjustments made, including to display strings, but so far, we've decided on the above output formats and they seem to work on my regular PDF test documents. 
 +
 +
 +==== OpenOffice extension ====
 +If you have LibreOffice or OpenOffice installed, you can use the OpenOffice extension to process some newer versions of Microsoft Word, Excel and Powerpoint documents. Refer to the [[http://wiki.greenstone.org/doku.php?id=en:user_advanced:greenstone_extensions|openoffice greenstone extension]] instructions.
 ====Changing the admin password==== ====Changing the admin password====
 Login to the administration page, 'edit' the admin account, and click 'change password'. Alternatively, you can login as admin via the login button at the top right of each page. Once you are logged in, this button will change to say 'admin'. Click this button and select 'account settings'. From there, you can select 'change password'. Login to the administration page, 'edit' the admin account, and click 'change password'. Alternatively, you can login as admin via the login button at the top right of each page. Once you are logged in, this button will change to say 'admin'. Click this button and select 'account settings'. From there, you can select 'change password'.
Line 279: Line 286:
   * consult the more detailed instructions on the [[en:user_advanced:remote_greenstone|Remote Greenstone page]] for further steps that may be necessary to carry out.   * consult the more detailed instructions on the [[en:user_advanced:remote_greenstone|Remote Greenstone page]] for further steps that may be necessary to carry out.
  
 +If you are using perl 5.22 or later, these no longer come with the perl CGI module. Please download https://trac.greenstone.org/export/36059/main/trunk/greenstone2/common-src/cgi-bin/CGIModule.tar.gz into web/WEB-INF/cgi, untar it, and copy the contents of the resulting CGIModule folder up one level (i.e. outside of that folder).
  
 **Client-GLI** **Client-GLI**
Line 340: Line 348:
  
 ===== Important Changes and Bug Fixes ===== ===== Important Changes and Bug Fixes =====
-  * Bundling of Apache Tika for [[http://wiki.greenstone.org/doku.php?id=en:plugin:unknownconverterplugin|better support for docx files]]. An UnknownConverterPlugin is largely set up to use Tika for docx processing. But you will need JRE8 installed locally into your GS3 and Windows users will further need to tweak the UnknownConvertPlugin configuration: [[http://wiki.greenstone.org/doku.php?id=en:plugin:unknownconverterplugin#steps_for_310_users|instructionsfor both here]]. Tika can also be used as a fallback for extracting text from a wide range of documents, by configuring an UnknownConverterPlugin in similar fashion for other document types as determined by file extensions.+  * Bundling of Apache Tika for [[http://wiki.greenstone.org/doku.php?id=en:plugin:unknownconverterplugin|better support for docx files]]. An UnknownConverterPlugin is largely set up to use Tika for docx processing. But you will need JRE8 installed locally into your GS3 and Windows users will further need to tweak the UnknownConvertPlugin configuration: [[http://wiki.greenstone.org/doku.php?id=en:plugin:unknownconverterplugin#steps_for_310_users|instructions for both here]]. Tika can also be used as a fallback for extracting text from a wide range of documents, by configuring an UnknownConverterPlugin in similar fashion for other document types as determined by file extensions.
  
   * There has been a change to the naming of custom properties files for a collection. Instead of having resources/collname.properties (eg resources/niupepa.properties), now the file is called resources/interface_custom.properties. If you already have a custom properties file, then please rename it.   * There has been a change to the naming of custom properties files for a collection. Instead of having resources/collname.properties (eg resources/niupepa.properties), now the file is called resources/interface_custom.properties. If you already have a custom properties file, then please rename it.
Line 461: Line 469:
 Compilation failed in require at (eval 1) line 1. Compilation failed in require at (eval 1) line 1.
 </code> </code>
 +
 +CGI.pm is not included with versions of [[https://stackoverflow.com/questions/45434990/why-does-this-code-have-issues-with-the-cgi-module|perl from 5.22 and onwards]], which is when this issue can result.
  
 If you get this error, then please install the CGI module for your system perl. If you get this error, then please install the CGI module for your system perl.
en/release/3.10_release_notes.txt · Last modified: 2023/07/06 03:05 by anupama