Differences

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

--- en:release:2.87_release_notes [2017/10/02 06:10] – old revision restored (2017/10/02 16:09) anupama
+++ en: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 ======
@@ Line 73: / Line 76: @@
 ==== 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]].
+==== 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 =====
-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.
+  * 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:
+. Exit GLI in the proper manner if it's running.
+. Optional: Back up your  GS2.87's ''gs2build/perllib/plugins'' and ''gs2build/perllib/cpan/'' folders (to restore if the patches below don't work).
+. 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.
+. 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
+. Use a //new terminal// to launch GLI or any commands that previously failed with errors. Hopefully 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 =====