Greenstone Wiki

User Tools

Site Tools

You are here: index » en » release » 2.87_release_notes
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/10/02 06:10] – old revision restored (2017/10/02 16:09) anupamaen:release:2.87_release_notes [2024/08/12 22:11] (current) – [Installing a source release] kjdon
Line 12: Line 12:
  
 ===== Installation Instructions===== ===== Installation Instructions=====
 +
 There's a choice between:  There's a choice between: 
   * installing **binaries**, which are precompiled. Choose the one for your Operating System:   * installing **binaries**, which are precompiled. Choose the one for your Operating System:
Line 19: Line 20:
     * MacOS binary for Mountain Lions (10.8) will probably work on Lions (10.7) as well     * MacOS binary for Mountain Lions (10.8) will probably work on Lions (10.7) as well
     * MacOS El Capitan (10.11) binary. You could try this on the older Yosemite and Maverick MacOS, though  we have not tested the El Capitan binary on those.     * MacOS El Capitan (10.11) binary. You could try this on the older Yosemite and Maverick MacOS, though  we have not tested the El Capitan binary on those.
-  <!--* topping up your binary with the source code if you ever decide you want the source: download the **source component**, +  * topping up your binary with the source code if you ever decide you want the source: download the **source component**, 
-  * going straight for the source code to compile Greenstone from scratch: download the **source distribution**-->+  * going straight for the source code to compile Greenstone from scratch: download the **source distribution** 
 + 
 ==== Binary distribution ==== ==== Binary distribution ====
 +Download from www.greenstone.org/download.
 +
 Upon downloading the installer, run the executable: On Windows and Mac you need to double-click it to launch the installation dialog, on Linux you first need to set the downloaded executable's permissions to executable before you can run it from the terminal. Upon downloading the installer, run the executable: On Windows and Mac you need to double-click it to launch the installation dialog, on Linux you first need to set the downloaded executable's permissions to executable before you can run it from the terminal.
  
Line 30: Line 35:
   * **The Linux and Mac versions must be installed into a path with *no* spaces.**   * **The Linux and Mac versions must be installed into a path with *no* spaces.**
  
-When the installation process is finished, you can run the Greenstone Server or the Greenstone Librarian Interface (GLI): +=== 2.87 on Linux 64 === 
 +If you get the error ''/bin/sh: 1: ./jre_bin_x64: not found'', please run with the -extract option: 
 +<code>./Greenstone-2.87-linux-x64 -extract</code> 
 +This just extracts the Greenstone jar file, and doesn't try to use the bundled jre to run it. 
 +Then you can run <code>java -jar greenstone.jar [text]</code> to run the installer. The optional text argument will run in text mode, instead of running the graphical installer. 
 + 
 +==== 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]] 
 + 
 +When the installation process is finished, you can run the Greenstone Server or the Greenstone Librarian Interface (GLI). 
 + 
 +==== Uninstallation ==== 
 +On Windows, the uninstaller is accessible from the Start menu. 
 + 
 +For most people under Linux systems, a Greenstone installation can be removed with the usual //rm// command. However, by using this method, any collections you've created will also be deleted. If you're on Linux or Mac and wish to uninstall Greenstone, the recommended way to do so is by using the Uninstaller, as this will give you the option to retain your collections. To launch the Uninstaller, you can either run "bash uninstall.sh" from the //uninstall// folder, or will first need to give execute permissions to the uninstall/Uninstall.sh file in your Greenstone installation before you can run it: 
 +<code>cd uninstall 
 +chmod u+rx Uninstall.sh 
 +./Uninstall.sh</code> 
 + 
 +===== Running the Greenstone Server =====
  
 1. On Windows, the included Greenstone Server can be launched from the shortcut in the Start menu. On Mac and Linux, use a terminal (in Macs this is found under Applications > Utilities > Terminal) to go into the Greenstone installation directory and run  1. On Windows, the included Greenstone Server can be launched from the shortcut in the Start menu. On Mac and Linux, use a terminal (in Macs this is found under Applications > Utilities > Terminal) to go into the Greenstone installation directory and run 
Line 46: Line 84:
 **To change the language in which you view your Greenstone digital library pages**, click on the ''Preferences'' link at the top left of your Greenstone digital library home page. On the Preferences page, select the interface language in the drop down box. **To change the language in which you view your Greenstone digital library pages**, click on the ''Preferences'' link at the top left of your Greenstone digital library home page. On the Preferences page, select the interface language in the drop down box.
  
 +===== Running the Librarian Interface =====
  
-2. The Greenstone Librarian Interface (GLI) can be run from the Windows Start menu. On Mac and Linux, use a terminal to go into the Greenstone installation directory and run +The Greenstone Librarian Interface (GLI) can be run from the Windows Start menu. On Mac and Linux, use a terminal to go into the Greenstone installation directory and run 
 <code>./gli/gli.sh</code> <code>./gli/gli.sh</code>
  
-First, as in (1) above, the Greenstone Server Interface (GSI) dialog will appear.\\ ** Note**: If you're using the included //apache httpd server// and running GLI starts by requesting you for the Local Library URL, then it expects the library home URL that's of the form ''http://HOST:PORT/greenstone/cgi-bin/library.cgi''. By default, this URL will be ''http://localhost:8282/greenstone/cgi-bin/library.cgi''\\ Eventually the Greenstone Librarian Interface (GLI) dialog will appear. Refer to the [[en:tutorials |Greenstone tutorials]] for examples of using the GLI to create collections of documents. Once you have finished creating a collection, you can preview it by pressing the Preview button from GLI's Create tab. It will open your Greenstone collection in the web browser.(1) <nowiki>(2)</nowiki>+First, as in the section above, the Greenstone Server Interface (GSI) dialog will appear.\\ ** Note**: If you're using the included //apache httpd server// and running GLI starts by requesting you for the Local Library URL, then it expects the library home URL that's of the form ''http://HOST:PORT/greenstone/cgi-bin/library.cgi''. By default, this URL will be ''http://localhost:8282/greenstone/cgi-bin/library.cgi''\\ Eventually the Greenstone Librarian Interface (GLI) dialog will appear. Refer to the [[en:tutorials |Greenstone tutorials]] for examples of using the GLI to create collections of documents. Once you have finished creating a collection, you can preview it by pressing the Preview button from GLI's Create tab. It will open your Greenstone collection in the web browser.(1) <nowiki>(2)</nowiki>
  
 (1) If the web page displays a "Forbidden" message instead, go back to the GSI dialog, and use its File > Settings menu to change the Address Resolution method to one of the other options there. Then press the Restart Library Button in the main GSI dialog and see whether the browser page it opens now is the Greenstone home page. Otherwise try another Address Resolution option from the GSI dialog's Settings menu and see whether the pages are visible now. (1) If the web page displays a "Forbidden" message instead, go back to the GSI dialog, and use its File > Settings menu to change the Address Resolution method to one of the other options there. Then press the Restart Library Button in the main GSI dialog and see whether the browser page it opens now is the Greenstone home page. Otherwise try another Address Resolution option from the GSI dialog's Settings menu and see whether the pages are visible now.
Line 57: Line 96:
  
 **To change the GLI interface language**, run GLI, go to the ''File > Preferences'' menu. Then in the General tab, set the Interface Language. If your script is not covered by the Latin 1 charset, then you may also need to set the Font to something that supports your script. In such a case, try setting the value for the ''Font'' field to ''Arial Unicode MS, BOLD, 12''. **To change the GLI interface language**, run GLI, go to the ''File > Preferences'' menu. Then in the General tab, set the Interface Language. If your script is not covered by the Latin 1 charset, then you may also need to set the Font to something that supports your script. In such a case, try setting the value for the ''Font'' field to ''Arial Unicode MS, BOLD, 12''.
- 
-3. The Client-GLI is the version of the Greenstone Librarian Interface that can be run on a machine different to the one that is running the Greenstone server. To be able to run the Client-GLI application, you will need Sun Java 1.5.0 or greater installed and you will need to have: 
-  * Java's //bin// folder on your PATH 
-  * JAVA_HOME set to point to your Java installation folder 
-If you follow Java's installation instructions, they will direct you on how to add the Java installation's bin folder to your system's PATH environment variable and how to set the JAVA_HOME environment variable. 
- 
-If on Windows, you can run client-GLI from its shortcut in the Start Menu. On Linux and Mac systems, you would use a terminal to go into your Greenstone installation folder and then run  
-<code>./gli/client-gli.sh</code> 
- 
-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. 
- 
-  * 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]]. 
- 
- 
-==== 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]]. 
  
  
Line 90: Line 113:
 **NOTE:** If GLI's Preview Button does not succeed in launching the browser with the collection URL, consult [[en:troubleshooting#GLI's_Preview_Button_fails_to_launch_a_web_page| this page]] for a suggested solution. **NOTE:** If GLI's Preview Button does not succeed in launching the browser with the collection URL, consult [[en:troubleshooting#GLI's_Preview_Button_fails_to_launch_a_web_page| this page]] for a suggested solution.
  
-==== Uninstallation ==== 
-On Windows, the uninstaller is accessible from the Start menu. 
- 
-For most people under Linux systems, a Greenstone installation can be removed with the usual //rm// command. However, by using this method, any collections you've created will also be deleted. If you're on Linux or Mac and wish to uninstall Greenstone, the recommended way to do so is by using the Uninstaller, as this will give you the option to retain your collections. To launch the Uninstaller, you can either run "bash uninstall.sh" from the //uninstall// folder, or will first need to give execute permissions to the uninstall/Uninstall.sh file in your Greenstone installation before you can run it: 
-<code>cd uninstall 
-chmod u+rx Uninstall.sh 
-./Uninstall.sh</code> 
  
 ===== Important Changes and Bug Fixes ===== ===== Important Changes and Bug Fixes =====
Line 112: Line 128:
  
 ===== 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 | 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 +  * 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]]. 
-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. 
 + 
 +4. Use a //new terminal// to launch GLI or any commands that previously failed with errors. Hopefully GLI will launch successfully now.
  
 ===== Useful information ===== ===== Useful information =====
Line 253: Line 323:
   * To attempt the same on Linux, try typing ''xdg-open %1'' (or if you are specifically on a gnome system, then try ''gnome-open %1'', while on a kde system you'd use ''kde-open %1''). Beware that not all Unix systems support a signal command to open applications, so you may need to use custom commands like ''firefox %1'' to launch in a browser, or ''gedit %1'' to open with a text editor, etc.   * To attempt the same on Linux, try typing ''xdg-open %1'' (or if you are specifically on a gnome system, then try ''gnome-open %1'', while on a kde system you'd use ''kde-open %1''). Beware that not all Unix systems support a signal command to open applications, so you may need to use custom commands like ''firefox %1'' to launch in a browser, or ''gedit %1'' to open with a text editor, etc.
 ==== Working with Remote Greenstone and the GLI-Client ==== ==== Working with Remote Greenstone and the GLI-Client ====
 +
 +The Client-GLI is the version of the Greenstone Librarian Interface that can be run on a machine different to the one that is running the Greenstone server. The server needs to be set up to work as a remote server, and Client-GLI can be run on a different machine, connecting to that server.
  
 **Instructions** **Instructions**
Line 316: Line 388:
   * Press the Submit button.   * Press the Submit button.
  
 +=== Client-GLI ===
  
 9. You can connect to this server from the Client-GLI application included with any Greenstone installation. Either on the current machine or another machine (assuming you want the Greenstone server on one machine and the client on another), use the "Remote Librarian Interface (Client-GLI)" shortcut to launch Client-GLI. Alternatively, you can launch it from the command line, such as by opening a new DOS prompt, going to the gli folder of your Greenstone 2 installation, and running client-gli.bat. E.g. 9. You can connect to this server from the Client-GLI application included with any Greenstone installation. Either on the current machine or another machine (assuming you want the Greenstone server on one machine and the client on another), use the "Remote Librarian Interface (Client-GLI)" shortcut to launch Client-GLI. Alternatively, you can launch it from the command line, such as by opening a new DOS prompt, going to the gli folder of your Greenstone 2 installation, and running client-gli.bat. E.g.
Line 326: Line 399:
   * If your client-gli is running from a different machine to where your Greenstone server is running, you need to specify the name of that remote machine hosting the Greenstone server:  %%http://<YOUR-MACHINE-NAME:YOURPORT>/greenstone/cgi-bin/gliserver.pl%%   * If your client-gli is running from a different machine to where your Greenstone server is running, you need to specify the name of that remote machine hosting the Greenstone server:  %%http://<YOUR-MACHINE-NAME:YOURPORT>/greenstone/cgi-bin/gliserver.pl%%
  
-  * If the client-gli is running on the same machine, you can generally type "localhost":  %%http://localhost/greenstone/cgi-bin/gliserver.pl%%+  * If the client-gli is running on the same machine, you can generally type "localhost":  %%http://localhost:<port>/greenstone/cgi-bin/gliserver.pl%%
  
  
Line 332: Line 405:
  
  
-12. The client-GLI dialog should finally open, and it will look and behave mostly the same as the usual (local) GLI.+12. The client-GLI dialog should finally open, and it will look and behave mostly the same as the usual (local) GLI, except that most of the document processing takes place on the remote machine where the Greenstone server is running. 
  
  
en/release/2.87_release_notes.1506924614.txt.gz · Last modified: 2017/10/02 06:10 by anupama