Differences

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

--- en:release:3.08_release_notes [2018/02/27 05:29] – anupama
+++ en:release:3.08_release_notes [2018/12/13 05:40] – [SIGPIPE errors when building a collection] anupama
@@ Line 192: / Line 192: @@
 Many browsers have stopped supporting Java applets. Microsoft's Internet Explorer, and perhaps Microsoft Edge, still support it. So these next steps are for Windows machines using Internet Explorer.
-If your end users will be using the GLI applet, you also need to do the following steps //in addition to// [[http://wiki.greenstone.org/doku.php?id=en:release:3.08_release_notes#setting_up_a_remote_greenstone_3_server|Setting up your remote Greenstone 3 server]]. These next steps require the Java SDK -- if you don't already have this you can download it from [[http://java.sun.com/j2se/1.4.2/download.html|here]]; make sure that the Java SDK's bin directory is included in the PATH environment variable, which may not have been done automatically upon installation.
+If your end users will be using the GLI applet, you also need to do the following steps //in addition to// [[http://wiki.greenstone.org/doku.php?id=en:release:3.08_release_notes#setting_up_a_remote_greenstone_3_server|Setting up your remote Greenstone 3 server]]. These next steps require the Java SDK -- if you don't already have this you can download it from [[http://java.sun.com/j2se/1.4.2/download.html|here]]; make sure that the Java SDK's bin directory is included in the PATH environment variable, which may or may not have been done automatically upon installing Java.
   * In the Greenstone "gli" directory, run
@@ Line 241: / Line 241: @@
 ==== Troubleshooting ====
+=== SIGPIPE errors when building a collection ===
+  - **If your indexer is set to ''solr''**, a newer version of the solr extension has been fixed to circumvent this error (it's a problem in one of Java's HttpURLConnection related classes). You can try one of the following:
+    * You could grab a newer version of Greenstone 3. Greenstone 3.09 (still to be released at the time of writing) will contain this fix, as do nightly binaries from http://www.greenstone.org/caveat-emptor/?latest=latest
+    * Get a newer version of the solr extension from SVN that contains the fix from http://trac.greenstone.org/browser/gs3-extensions/solr/trunk/src?rev=32088. SVN checkout this folder into the GS3 ''ext'' subfolder as ''solr'', after removing the old ''ext/solr'' folder. Then use a terminal to go into the ''ext/solr'' folder and run ''ant del-service add-service''.
+    * Or you can update just the affected files in your solr extension, by following the instructions in the sequence of Greenstone mailing list exchanges with Martín Williman under the subject "SolR bugs".
+  - If your indexer is not solr or if updating the solr extension didn't fix the problem **and if your collection is using ''jdbm'' as the database type**, then either
+     * change the database type to ''gdbm''
+     * or leave the database type at jdbm and move your GS3's bundled JRE (the GS3.08's ''packages/jre'' subfolder) outside your GS3 installation. Next install a newer Java on your system so that GS3.08 can find that. If on Linux, ensure you open a new terminal before running GLI or command line building your collection.
+Many thanks to Martín Williman for 1 and Mariana Pichinini for solution 2.
+=== Ubuntu/Linux perl errors about Bibtex/Latex/MediaWiki plugins or other perl files ===
+This can happen when running GLI or the command line building scripts.
+The errors can look like:
+<code>
+Running the Greenstone Librarian Interface...
+Version: 2.87
+User cache dir: /root/.gli/cache/
+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 /usr/local/Greenstone/perllib/plugins/DirectoryPlugin.pm line 199.
+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 /usr/local/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 /usr/local/Greenstone/perllib/plugins/MediaWikiPlugin.pm line 506.
+...
+</code>
+They're caused by the newer version of perl (that comes installed with newer versions Ubuntu) no longer accepting some older perl syntax.
+If you would like to continue using GS3.08, we've patched the affected plugins. The instructions to use the patch are:
+. Optional: Back up your  GS3.08's ''gs2build/perllib/plugins'' and ''gs2build/perllib/cpan/'' folders.
+. Download [[http://trac.greenstone.org/export/32634/patches/GS308PluginsForNewerPerlUbuntu.tar.gz|the tarball]] containing the patch and extract its contents.
+. Six files should have been extracted:
+- Put the 4 plugin files into your GS3.08'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.
+. Use a //new terminal// to launch GLI or any commands that previously failed with errors.
 === Mac Installer fails ===