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 [2017/10/13 08:10] 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 179: Line 182:
  
 1. Run client-gli quite as you would GLI. It's accessible from the Windows Start menu, otherwise you can run the client-gli script (located at the toplevel of a Greenstone installation) from a terminal. 1. Run client-gli quite as you would GLI. It's accessible from the Windows Start menu, otherwise you can run the client-gli script (located at the toplevel of a Greenstone installation) from a terminal.
 +
 +  * NOTE: 3.08 client-gli.sh/bat scripts are missing a jar file reference in the classpath. If you are using 3.08 version of client-gli, please edit the appropriate script. 
 +     * Linux: client-gli.sh. Look for the two lines starting <code>$javapath -Xmx128M -classpath classes/:GLI.jar:lib/apache.jar:lib/qfslib.jar:lib/commons-codec-1.3.jar</code> Add in '':lib/rsyntaxtextarea.jar'' after ''lib/qfslib.jar'' on BOTH lines.
 +     * Windows: client-gli.bat. Look for the two lines starting <code> "%JAVA_EXECUTABLE%" -Xmx128M -cp classes/;GLI.jar;lib/apache.jar;lib/qfslib.jar org.greenstone.gatherer.GathererProg</code> Add in '';lib/rsyntaxtextarea.jar'' after ''qfslib.jar'' on BOTH lines.
  
 2. You'll be asked for the gliserver.pl URL of the remote Greenstone 3 server that you wish to connect to. This is of the form  2. You'll be asked for the gliserver.pl URL of the remote Greenstone 3 server that you wish to connect to. This is of the form 
 <code>http://<remote-gs3-server-machine-name>:<remote-port>/greenstone3/cgi-bin/gliserver.pl</code> <code>http://<remote-gs3-server-machine-name>:<remote-port>/greenstone3/cgi-bin/gliserver.pl</code>
 It's the same URL as in Step 10 of setting up the remote GS3 server above. It's the same URL as in Step 10 of setting up the remote GS3 server above.
 +
 +
 +===GLI Applet Additional Steps===
 +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 or may not have been done automatically upon installing Java.
 +
 +  * In the Greenstone "gli" directory, run
 +<code>    keytool -genkey -alias privateKey -keystore appletstore -storepass greenstone</code>
 +Enter the appropriate details for your organization. When it asks to enter the key password for <privateKey>, choose your own password or hit Enter to use "greenstone".
 +  * Run
 +<code>    jarsigner -keystore appletstore -signedjar SignedGatherer.jar GLI.jar privateKey</code>
 +When it prompts, enter the password you used above.
 +  * For GS3, move the created ''SignedGatherer.jar'' file from gli into GS3's ''web/applet'' subdirectory.
 +  * The following won't be necessary for future releases of GS3. However, for GS3.08, download the following files and put them into your GS3's ''web/interfaces/default/transform'' folder:
 +     * [[http://trac.greenstone.org/browser/main/trunk/greenstone3/web/interfaces/default/transform/gli4gs3.xsl?rev=32127&format=txt|gli4gs3.xsl]]
 +     * [[http://trac.greenstone.org/browser/main/trunk/greenstone3/web/interfaces/default/transform/style.xsl?rev=32127&format=txt|style.xsl]]
 +     * [[http://trac.greenstone.org/browser/main/trunk/greenstone3/web/interfaces/default/transform/icons.xsl?rev=32127&format=txt|icons.xsl]]
 +  * Open ''web/interfaces/default/transform/pages/home.xsl'' for editing, find the line <code><gslib:authenticationLink/><br/><br/></code> and add the line <code><gslib:libraryInterfaceLink/><br/><br/></code> before it.
 +  * An optional step is to open ''web/interfaces/default/transform/gslib.xsl'' for editing, locate ''<xsl:template name="libraryInterfaceLink">'' template, and remove the occurrences of ''<li>'' and ''</li>'' in this template.
 +
 +To use the GLI applet, (re)start  the GS3 web server.
 +  * Use Internet Explorer, and set things up in IE and with Java to be able to run applets.\\ //To be able to view applets in a browser, you will need a JRE installed and, from Java 7 onwards, will need to additionally add the remote Greenstone digital library home URL to the Exception Site List via the Security tab of your Java Control Panel. We have found that installing web browsers before installing a JRE allows browsers to find your JRE and run applets. If you're installing browsers after the JRE has already been installed, then your browser should prompt you to install the JRE again when trying to view Java applets. For further information see http://java.com/en/download/help/enable_browser.xml on how to enable Java in a web browser and http://www.java.com/en/download/help/javaconsole.xml to locate the Java Control Panel for your operating system.//\\ To open up the Java Control Panel, go to your java installation folder's ''jre\bin'' subfolder. On Windows run the ''javacpl.exe'', on Linux run ''./ControlPanel'' (which is also included in the bin subfolder of the jre bundled with GS3.08). In the Security tab, set the security level to "High", then press the ''Edit Site List'' and add a new line containing the ''host:port'' for the remote GS3 server base URL to which you want the applet to connect.\\ Next, launch Internet Explorer, and
 +    - Click Tools and then Internet Options
 +    - Select the Security tab, and select the Custom Level button
 +    - Scroll down to Scripting of Java applets
 +    - Make sure the Enable radio button is checked
 +    - Click OK to save your preference  
 +  * Use Internet Explorer to visit your Greenstone library homepage. Click the "The Librarian Interface" link that should now be there. A dialog should pop up, which asks you to allow the GLI applet to run. Acquiesce and the GLI applet will begin loading, and after a short wait a "Launch Greenstone Librarian Interface" button will become available. Click this to start using the GLI applet.
  
 === Converting a GS2 collection to GS3 when working with a remote GS3 server === === Converting a GS2 collection to GS3 when working with a remote GS3 server ===
Line 198: 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 208: Line 244:
  
 ==== Troubleshooting ==== ==== Troubleshooting ====
 +
 +=== 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.
 +
 +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:
 +
 +
 +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's contents.\\ If you're on a Windows machine, you may want to download the ''GS308PluginsForNewerPerlUbuntu.zip'' ZIP file instead and extract that.
 +
 +3. Five files should have been extracted:
 +  * Put the 3 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. Hopefully GLI will launch successfully now.
  
 === Mac Installer fails === === Mac Installer fails ===
en/release/3.08_release_notes.1507882256.txt.gz · Last modified: 2017/10/13 08:10 by anupama