User Tools

Site Tools


en:release:2.87_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
en:release:2.87_release_notes [2017/09/27 08:12] anupamaen:release:2.87_release_notes [2023/03/13 01:46] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +
 +
 +
 ====== Greenstone 2.87 Release Notes ====== ====== Greenstone 2.87 Release Notes ======
  
 **Release Name:** 2.87 **Release Name:** 2.87
  
-**Release Date:** Not yet released.+**Release Date:** 01 October 2017
  
 ** Released: ** ** Released: **
 +  * Greenstone v2.87: The official Greenstone 2.87. 01 Oct 2017 \\ Binaries for Windows, GNU/Linux 32 and 64 bit, Mac Mountain Lion and Mac El Capitan. Mac Mountain Lion and 32 bit linux binaries were only spot tested. The other 3 binaries were tested more extensively. The sole Windows binary is, as usual, for both 32 and 64 bit machines and was largely tested on **Windows 10** this time.\\ [[http://svn.greenstone.org/main/tags/2.87/|svn tag page]] [[http://trac.greenstone.org/browser/main/tags/2.87|trac tag page]].  Code revision up to 32016/32017. Tag revision: 32020.
  
 ** Release Candidate History ** ** Release Candidate History **
Line 67: Line 71:
 When the client-GLI starts up, a small dialog appears asking you to enter the URL of the remote Greenstone server's gliserver.pl file. This URL generally has the form: %%http://<host>:<port>/greenstone/cgi-bin/gliserver.pl%%, where you have to fill in the host and port values for the remote Greenstone server. After clicking OK, the client-GLI application window will appear. Client-GLI looks and works just like the GLI, except that most of the document processing takes place on the remote machine where the Greenstone server is running. When the client-GLI starts up, a small dialog appears asking you to enter the URL of the remote Greenstone server's gliserver.pl file. This URL generally has the form: %%http://<host>:<port>/greenstone/cgi-bin/gliserver.pl%%, where you have to fill in the host and port values for the remote Greenstone server. After clicking OK, the client-GLI application window will appear. Client-GLI looks and works just like the GLI, except that most of the document processing takes place on the remote machine where the Greenstone server is running.
  
-  * If you wish to work with password protected collections, here's [[http://wiki.greenstone.org/doku.php?id=en:release:2.86_release_notes&#problemauthenticated_collections_require_constant_authentication|a workaround]] to the bug of constantly requiring to authenticate yourself. 
   * To get your Greenstone installation set up as a remote server so that other GLI clients can connect to it, refer to the section [[2.87_Release_Notes#Working_with_Remote_Greenstone_and_the_GLI-Client | Working with Remote Greenstone and the GLI-Client]].   * To get your Greenstone installation set up as a remote server so that other GLI clients can connect to it, refer to the section [[2.87_Release_Notes#Working_with_Remote_Greenstone_and_the_GLI-Client | Working with Remote Greenstone and the GLI-Client]].
  
Line 73: Line 76:
 ==== 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=en:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]].
 +
 +
 +==== Adding source code to a binary release ==== 
 +Make sure to select the "Greenstone 2" tab of:
 +  * [[http://wiki.greenstone.org/doku.php?id=en: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]]
 +
 +
 +==== Installing a source release ==== 
 +
 +Make sure to select the "Greenstone 2" tab of:
 +
 +  * [[http://wiki.greenstone.org/doku.php?id=en: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]]
  
  
Line 112: Line 129:
  
 ===== Troubleshooting and other Questions ===== ===== Troubleshooting and other Questions =====
-Have a look at the [[http://wiki.greenstone.org/doku.php?id=en:release:2.86_release_notes#known_issues_and_patches | 2.86 release's Known Issues and Patches]] section, to see if your question is already covered there and has a solution.+  * Have a look at the [[http://wiki.greenstone.org/doku.php?id=en:release:2.86_release_notes#known_issues_and_patches | older 2.86 release's Known Issues and Patches]] section, to see if your question is already covered there and has a solution
 + 
 +  * If not, then please consult the Greenstone FAQ at http://wiki.greenstone.org/wiki/index.php/Greenstone_FAQ\\ to see if any of your questions are answered and for further workarounds of known issues. If any issues persist, write to us on [[http://wiki.greenstone.org/doku.php?id=en:support | the Greenstone Mailing List]]. 
 + 
 +  * If you're running Greenstone 2.87 on a machine where the version of Perl is later than 5.18 (e.g. perl 5.22), as may happen when you upgrade your Ubuntu to 16.04 or later, and if your GLI does not start up properly, then first stop and restart GLI in debug mode to get better error reporting: ''./gli/gli.sh -debug''. \\ Upon running GLI in debug mode, if you see some error messages such as the following when GLI fails to start: 
 +<code> 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^(\s*)body(\s*){ <-- HERE (\s*)$/ at /home/karl/Greenstone/perllib/plugins/MediaWikiPlugin.pm line 280. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/_content_(\s*){ <-- HERE / at /home/karl/Greenstone/perllib/plugins/MediaWikiPlugin.pm line 506. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\s*|\n)_content_(\s*){ <-- HERE / at /home/karl/Greenstone/perllib/plugins/MediaWikiPlugin.pm line 529. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\s*|\n)_content_(\s*){ <-- HERE (.|\n)*?}/ at /home/karl/Greenstone/perllib/plugins/MediaWikiPlugin.pm line 534. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(/.*){ <-- HERE ,41}/ at /home/karl/Greenstone/perllib/plugins/DirectoryPlugin.pm line 199. 
 +AutoLoadConverters: PDFBox Extension to Greenstone detected for PDFPlugin 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^[a-z]{ <-- HERE 2..}/ at /home/karl/Greenstone/perllib/plugins/LaTeXPlugin.pm line 220. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/\\(?:addcontentsline){ <-- HERE .*?}\{.*?}\{.*}/ at /home/karl/Greenstone/perllib/plugins/LaTeXPlugin.pm line 371. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/\\(?:label|begin|end){ <-- HERE .*?}\s*\n?/ at /home/karl/Greenstone/perllib/plugins/LaTeXPlugin.pm line 380. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\\[`'="^~\.]){ <-- HERE (\w)}/ at /home/karl/Greenstone/perllib/plugins/LaTeXPlugin.pm line 691. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\\[uvcH]){ <-- HERE (\w)}/ at /home/karl/Greenstone/perllib/plugins/LaTeXPlugin.pm line 699. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/^[a-z]{ <-- HERE 2..}/ at /home/karl/Greenstone/perllib/plugins/BibTexPlugin.pm line 315. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\\[`'="^~\.]){ <-- HERE (\w)}/ at /home/karl/Greenstone/perllib/plugins/BibTexPlugin.pm line 706. 
 +Unescaped left brace in regex is deprecated here (and will be fatal in Perl 5.30), passed through in regex; marked by <-- HERE in m/(\\[uvcH]){ <-- HERE (\w)}/ at /home/karl/Greenstone/perllib/plugins/BibTexPlugin.pm line 713. 
 +Getting Download Info: [perl, -S, /home/karl/Greenstone/bin/script/downloadinfo.pl, -describeall, -xml, -language, en] 
 +WGet thread is waiting for DownloadJobs. 
 +Failed when trying to parse downloadinfo.pl -describeall 
 +java.lang.Exception: *** Error running Download Info process, process exited with: 255 
 +        at org.greenstone.gatherer.gui.DownloadPane.loadDownloadersInfo(DownloadPane.java:277) 
 +        at org.greenstone.gatherer.gui.DownloadPane.<init>(DownloadPane.java:115) 
 +        at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java:394) 
 +        at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java:712) 
 +        at org.greenstone.gatherer.GathererProg.main(GathererProg.java:81) 
 +java.lang.NullPointerException 
 +        at org.greenstone.gatherer.gui.DownloadPane.<init>(DownloadPane.java:116) 
 +        at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java:394) 
 +        at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java:712) 
 +        at org.greenstone.gatherer.GathererProg.main(GathererProg.java:81) 
 +java.lang.NullPointerException 
 +        at org.greenstone.gatherer.gui.DownloadPane.<init>(DownloadPane.java:116) 
 +        at org.greenstone.gatherer.gui.GUIManager.display(GUIManager.java:394) 
 +        at org.greenstone.gatherer.Gatherer.openGUI(Gatherer.java:712) 
 +        at org.greenstone.gatherer.GathererProg.main(GathererProg.java:81) 
 +ShutDownHook called... 
 +Attempting to forcibly terminate the GS server... 
 +Issuing stop command to GS2 Local Library Server. Waiting for GS2 server to stop... 
 +Successfully stopped GS2 server. 
 +Done. 
 +</code>\\ Upon seeing such error messages: 
 + 
 +0. Exit GLI in the proper manner if it's running. 
 + 
 +1. Optional: Back up your  GS2.87's ''gs2build/perllib/plugins'' and ''gs2build/perllib/cpan/'' folders (to restore if the patches below don't work). 
 + 
 +2. Download the ''GS287PluginsForNewerPerlUbuntu.tar.gz'' tarball, which contains the patched up files, from [[http://trac.greenstone.org/browser/patches|the patches page]] and extract the tarball's contents.\\ If you're on a Windows machine, you may want to download the ''GS287PluginsForNewerPerlUbuntu.zip'' ZIP file instead and extract that. 
 + 
 +3. Five files should have been extracted: 
 +  * Put the 3 Plugin.pm files into your GS2.87's ''gs2build/perllib/plugins'' folder. 
 +  * put Escape.pm into the ''gs2build/perllib/cpan/URI'' folder. 
 +  * put PP.pm into into the ''gs2build/perllib/cpan/JSON'' folder.
  
-If not, then please consult the Greenstone FAQ at http://wiki.greenstone.org/wiki/index.php/Greenstone_FAQ +4. Use a //new terminal// to launch GLI or any commands that previously failed with errorsHopefully GLI will launch successfully now.
-to see if any of your questions are answered and for further workarounds of known issues. If any issues persist, write to us on [[http://wiki.greenstone.org/doku.php?id=en:support | the Greenstone Mailing List]].+
  
 ===== Useful information ===== ===== Useful information =====
Line 475: Line 546:
  
 3. Run the web server and usage.txt should become populated with information. 3. Run the web server and usage.txt should become populated with information.
 +
 +
 ===== Known Issues===== ===== Known Issues=====
  
en/release/2.87_release_notes.1506499975.txt.gz · Last modified: 2017/09/27 08:12 (external edit)