User Tools

Site Tools


en:release:3.08_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:3.08_release_notes [2018/11/23 07:58] – [Troubleshooting] anupamaen:release:3.08_release_notes [2023/03/13 01:46] (current) – external edit 127.0.0.1
Line 1: Line 1:
 +
 +
 +
 ====== Greenstone 3.08 Release Notes ====== ====== Greenstone 3.08 Release Notes ======
  
Line 231: Line 234:
   * a lot of work has been done on getting all the text strings into properties files so the complete interface can be translated.   * a lot of work has been done on getting all the text strings into properties files so the complete interface can be translated.
   * collection groups web/sites/localsite/groupConfig.xml   * collection groups web/sites/localsite/groupConfig.xml
-  * <extraInfo> element in collectionConfig.xml (for eg <naviagationTab type=external-link|frame url='http://xxx'>) add displayItems inside for name and description. +  * <extraInfo> element in collectionConfig.xml (for eg <navigationTab type=external-link|frame url='http://xxx'>) add displayItems inside for name and description. 
-  * support for classifier tabs that are just linksq+  * support for classifier tabs that are just links
   * The raw collectionConfig.xml file can now be edited directly from within GLI: Edit->Edit collectionConfig.xml.   * The raw collectionConfig.xml file can now be edited directly from within GLI: Edit->Edit collectionConfig.xml.
   * Tidied up collection building using manifest files. See the [[http://files.greenstone.org/tutorial/gs3-current/en/incremental_cmdline.htm| incremental collection building tutorial]]   * Tidied up collection building using manifest files. See the [[http://files.greenstone.org/tutorial/gs3-current/en/incremental_cmdline.htm| incremental collection building tutorial]]
Line 241: Line 244:
  
 ==== Troubleshooting ==== ==== Troubleshooting ====
-=== Ubuntu/Linux perl errors about Bibtex/Latex/MediaWiki plugins ===+ 
 +=== Can't link to original files via cross collection search === 
 + 
 +When using cross collection search, if you try to view associated files, e.g. PDF files (instead of the Greenstone document) you will get errors like "ERROR: Assoc file paths must now contain the library name". To fix this please edit web/sites/localsite/siteConfig.xml. 
 + 
 +Look for  
 +<code> 
 +<gsf:template match="documentNode"> 
 +   <xsl:variable name="collname" select="@collection"/> 
 +   <td><gsf:if-metadata-exists><gsf:metadata name="srclinkFile"/> 
 +<gsf:if><a><xsl:attribute name='href'>sites/localsite/collect/<xsl:value-of select='@collection'/> 
 +/index/assoc/<gsf:metadata name="assocfilepath"/>/<gsf:metadata name="srclinkFile"/> 
 +</xsl:attribute><gsf:choose-metadata><gsf:metadata name="thumbicon"/> 
 +<gsf:metadata name="srcicon"/></gsf:choose-metadata></a></gsf:if></gsf:if-metadata-exists></td> 
 +</code> 
 + 
 +Add <xsl:value-of select="$library_name"/>/ at the start of the href value, i.e. 
 + 
 +<code> 
 +<gsf:template match="documentNode"> 
 +   <xsl:variable name="collname" select="@collection"/> 
 +   <td><gsf:if-metadata-exists><gsf:metadata name="srclinkFile"/> 
 +<gsf:if><a><xsl:attribute name='href'><xsl:value-of select="$library_name"/>/sites/localsite 
 +/collect/<xsl:value-of select='@collection'/>/index/assoc/<gsf:metadata name="assocfilepath"/> 
 +/<gsf:metadata name="srclinkFile"/></xsl:attribute><gsf:choose-metadata> 
 +<gsf:metadata name="thumbicon"/><gsf:metadata name="srcicon"/></gsf:choose-metadata></a></gsf:if></gsf:if-metadata-exists></td> 
 +</code> 
 + 
 +=== 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 a SIGPIPE error caused by 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** and the error messages surrounding the SIGPIPE mention issues with "transaction commit", 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. This can happen when running GLI or the command line building scripts.
  
Line 260: Line 302:
 If you would like to continue using GS3.08, we've patched the affected plugins. The instructions to use the patch are: If you would like to continue using GS3.08, we've patched the affected plugins. The instructions to use the patch are:
  
-1. Back up your  GS3.08's ''gs2build/perllib/plugins'' folder 
  
-2. Download [[http://trac.greenstone.org/export/32634/patches/GS308PluginsForNewerPerlUbuntu.tar.gz|the tarball]] containing the patch and extract its contents.+0. Exit GLI in the proper manner if it's running. 
 + 
 +1. Optional: Back up your  GS3.08's ''gs2build/perllib/plugins'' and ''gs2build/perllib/cpan/'' folders  (so you can restore these folders if the patches below don't work for you). 
 + 
 +2. Download the ''GS308PluginsForNewerPerlUbuntu.tar.gz'' tarball, which contains the patched up files, from [[http://trac.greenstone.org/browser/patches|the patches page]] and extract the tarball'contents.\\ If you're on a Windows machine, you may want to download the ''GS308PluginsForNewerPerlUbuntu.zip'' ZIP file instead and extract that.
  
-3. Put the contents, 4 plugin filesinto your GS3.08's ''gs2build/perllib/plugins'' folder.+3. Five files should have been extracted: 
 +  * Put the 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.
  
-4. Use a //new terminal// to launch GLI or any commands that previously failed with errors.+4. Use a //new terminal// to launch GLI or any commands that previously failed with errors. Hopefully GLI will launch successfully now.
  
 === Mac Installer fails === === Mac Installer fails ===
en/release/3.08_release_notes.1542959919.txt.gz · Last modified: 2018/11/23 07:58 (external edit)