en:release:3.09_release_notes
Differences
This shows you the differences between two versions of the page.
en:release:3.09_release_notes [2019/04/19 05:35] – [Setting up a remote Greenstone 3 server] anupama | en:release:3.09_release_notes [2023/03/13 01:46] (current) – external edit 127.0.0.1 | ||
---|---|---|---|
Line 1: | Line 1: | ||
+ | |||
+ | |||
+ | |||
====== Greenstone 3.09 Release Notes ====== | ====== Greenstone 3.09 Release Notes ====== | ||
**Release Name:** 3.09 | **Release Name:** 3.09 | ||
- | **Release Date: | + | **Release Date: |
+ | |||
+ | ** Released: ** | ||
+ | |||
+ | * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for High Sierra/ | ||
+ | * The Mac binary is generated on High Sierra/ | ||
+ | * The Windows binary was largely tested on Windows 10, but partially on Windows 8.1 | ||
+ | * The Linux binary was largely tested on Ubuntu 18.04.2 LTS and partially on Ubuntu 14.04 and 16.04. | ||
+ | |||
+ | ** Release Candidate History ** | ||
+ | |||
+ | * Greenstone 3.09 rc1: Release Candidate 1. Released 6 May 2019. \\ Binaries for Windows, GNU/Linux 32 and 64 bit machines, Mac High Sierra/ | ||
+ | |||
+ | As always, many thanks to our TSG (tech support) who made this and previous releases possible by setting up test machines for us and getting us access to them, all on short notice. Thanks to TSG, bugs could be found and fixed and 3.09rc1 got a release at last. | ||
- | | ||
===== Installation Instructions===== | ===== Installation Instructions===== | ||
Line 12: | Line 28: | ||
* Download the appropriate binary release for your operating system and run it. | * Download the appropriate binary release for your operating system and run it. | ||
- | * **Note to Mac users:** The security settings in newer Mac OS versions have been altered to by default disallow users from casually opening and running .dmg executables that are not from Apple itself. When attempting to open the Greenstone binary .dmg file, if it pops up an error warning about security, you will need to set up the Security on your Mac to allow you to run .dmg files downloaded from the internet. Otherwise the Greenstone mac binary will not run. To do this, Go to your Mac's System Preferences. Under " | + | * **Note to Mac users:** The security settings in newer Mac OS versions have been altered to by default disallow users from casually opening and running .dmg executables that are not from Apple itself. When attempting to open the Greenstone binary .dmg file, if it pops up an error warning about security, you will need to set up the Security on your Mac to allow you to run .dmg files downloaded from the internet. Otherwise the Greenstone mac binary will not run. To do this, go to your Mac's System Preferences. Under " |
* **For Linux**, you will need to set the file to be executable before running it. (e.g. chmod a+x Greenstone-3.09-linux) | * **For Linux**, you will need to set the file to be executable before running it. (e.g. chmod a+x Greenstone-3.09-linux) | ||
Line 78: | Line 94: | ||
source ./ | source ./ | ||
ant setup-https-cert | ant setup-https-cert | ||
- | </ | + | </ |
- Once the setup-https-cert ant target has finished, you can start your web GS3 server by either running the gs3-server application or by running "ant start" from the terminal. | - Once the setup-https-cert ant target has finished, you can start your web GS3 server by either running the gs3-server application or by running "ant start" from the terminal. | ||
- If you ran the gs3-server application, | - If you ran the gs3-server application, | ||
Line 175: | Line 191: | ||
On Unix, you would do | On Unix, you would do | ||
- | < | + | < |
On Windows, run in a DOS prompt: | On Windows, run in a DOS prompt: | ||
Line 198: | Line 214: | ||
Put these two together with a period mark to separate them and use this as the value for your tomcat.server property.) | Put these two together with a period mark to separate them and use this as the value for your tomcat.server property.) | ||
- | 4. Set up your Greenstone environment if you've not already done so by running '' | + | 4. Set up your Greenstone environment if you've not already done so by running '' |
< | < | ||
ant start | ant start | ||
Line 238: | Line 254: | ||
===GLI Java Web Start application (replacement for GLI Applet) - Additional Steps=== | ===GLI Java Web Start application (replacement for GLI Applet) - Additional Steps=== | ||
+ | **You will need a Java Development Kit (JDK) v 7 or 8 installed for this.** | ||
+ | |||
Many browsers have stopped supporting Java applets including Microsoft Edge, though Microsoft' | Many browsers have stopped supporting Java applets including Microsoft Edge, though Microsoft' | ||
Line 243: | Line 261: | ||
- First follow the instructions above for [[http:// | - First follow the instructions above for [[http:// | ||
- | - Next, generate the SignedGatherer.jar: | + | - Next, generate the SignedGatherer.jar |
* Use a terminal to go into the Greenstone " | * Use a terminal to go into the Greenstone " | ||
- | * Next, run < | + | * Next, run < |
When it prompts, enter the password you used above ('' | When it prompts, enter the password you used above ('' | ||
- Move the created '' | - Move the created '' | ||
- You need to associate JNLP files with Java Web Start ('' | - You need to associate JNLP files with Java Web Start ('' | ||
* On Windows, create the association in the usual way: when you first access the GLI Web Start application through Greenstone, a JNLP file called " | * On Windows, create the association in the usual way: when you first access the GLI Web Start application through Greenstone, a JNLP file called " | ||
+ | * On Mac, .jnlp files may already be associated with the Java Web Start application for launching JNLP files (Java web start applications). Otherwise, see page 3 of http:// | ||
* For Linux, create a file with '' | * For Linux, create a file with '' | ||
# This file should be adjusted and then copied into ~/ | # This file should be adjusted and then copied into ~/ | ||
Line 265: | Line 284: | ||
MimeType=application/ | MimeType=application/ | ||
</ | </ | ||
- | - Launch the Java Control Panel by running '' | + | - Launch the Java Control Panel by running '' |
- Make the GLI link on the home page active: Open web/ | - Make the GLI link on the home page active: Open web/ | ||
< | < | ||
</ | </ | ||
< | < | ||
- | </ | + | </ |
- (Re)Start the GS3 web server and visit your DL library home page, '' | - (Re)Start the GS3 web server and visit your DL library home page, '' | ||
- Since you have set up the JNLP file association in a previous step, you can now click on the "The Librarian Interface" | - Since you have set up the JNLP file association in a previous step, you can now click on the "The Librarian Interface" | ||
- You will need to **authorise** the GLI to run. After that, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI (and like the old GLI applet) from this point onward: starting with providing your account username and password on Greenstone that you created when setting up the remote GS3 server. You may also be asked for your proxy authentication details if set up for behind a proxy. | - You will need to **authorise** the GLI to run. After that, the JNLP version of the GLI Applet will eventually run and behave like the usual client-GLI (and like the old GLI applet) from this point onward: starting with providing your account username and password on Greenstone that you created when setting up the remote GS3 server. You may also be asked for your proxy authentication details if set up for behind a proxy. | ||
- | |||
=== 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 === | ||
The new Format Conversion Wizard to convert GS2 format statements to GS3 format statements (see [[en: | The new Format Conversion Wizard to convert GS2 format statements to GS3 format statements (see [[en: | ||
Line 298: | Line 316: | ||
* Patches to perl code upgrading perl syntax to work with newer versions of perl | * Patches to perl code upgrading perl syntax to work with newer versions of perl | ||
* GLI updates: | * GLI updates: | ||
- | * The GLI Applet has been converted to a Java WebStart Application. Java Web Start not supported from Java 9 or onwards. | + | * The GLI Applet has been converted to a Java WebStart Application. Java Web Start not supported from Java 9 or onwards. |
* GEMS can now launch in languages other than English | * GEMS can now launch in languages other than English | ||
===== IMPORTANT information ===== | ===== IMPORTANT information ===== | ||
For ease of access this section has been brought across from the [[en: | For ease of access this section has been brought across from the [[en: | ||
+ | |||
+ | ==== Patches to 3.09 ==== | ||
+ | These are corrections to a 3.09 installation that should be easy for Greenstone users to make. | ||
+ | |||
+ | 1. Bugfix to online document editor not calculating the correct subsection being edited | ||
+ | |||
+ | Download the file [[http:// | ||
+ | |||
+ | 2. Fix to solrserver on Windows not detecting that the GS3 server isn't running | ||
+ | |||
+ | Download the file [[http:// | ||
+ | |||
==== Troubleshooting ==== | ==== Troubleshooting ==== | ||
+ | |||
+ | === Some perl scripts don't run properly or to completion === | ||
+ | //**If you're running Greenstone 3 on a non-English locale**// and certain perl scripts don't run properly or completely, such as when you run '' | ||
+ | |||
+ | === You see an empty page when visiting the Greenstone 3 library home page on Windows === | ||
+ | //**If you're running Greenstone 3 on a non-English locale on Windows**//, | ||
=== Content Encoding Error when visiting the local solr servlet page === | === Content Encoding Error when visiting the local solr servlet page === | ||
Line 316: | Line 352: | ||
We've added a work around to one kind of SIGPIPE errors which could occur with large collections when using '' | We've added a work around to one kind of SIGPIPE errors which could occur with large collections when using '' | ||
* change the database type from '' | * change the database type from '' | ||
- | * or leave the database type at '' | + | * or leave the database type at '' |
=== Your browser doesn' | === Your browser doesn' | ||
**The issue:** | **The issue:** | ||
Line 368: | Line 404: | ||
==== Useful information ==== | ==== Useful information ==== | ||
- | When you've built a collection of documents, you may discover that there appears to be a copy of all these documents in the collection' | + | When you've built a collection of documents, you may discover that there appears to be a copy of all these documents in the collection' |
- | By default, Windows doesn' | + | By default, Windows doesn' |
====Known Issues==== | ====Known Issues==== | ||
Line 395: | Line 431: | ||
If you get this error, then please install the CGI module for your system perl. | If you get this error, then please install the CGI module for your system perl. | ||
====Work Arounds==== | ====Work Arounds==== | ||
- | ===Filenames in collections should not contain | + | ===Filenames in collections should not contain < and >=== |
- | In order to have better handling of different file and filename encodings, | + | [**Note:** [[https:// |
+ | |||
+ | In order to have better handling of different file and filename encodings, | ||
+ | |||
+ | A workaround is to use different characters for < and >, such as [ and ] or ( and ), or leave them out from filenames. | ||
- | A workaround is to use " | ||
===Greenstone applets (Phind, Collage) crash Firefox=== | ===Greenstone applets (Phind, Collage) crash Firefox=== | ||
See [[https:// | See [[https:// | ||
Line 450: | Line 489: | ||
Thanks to the following people for new and updated translations since 3.08: | Thanks to the following people for new and updated translations since 3.08: | ||
- | *Lavji Zala for Gujarati translations | + | |
+ | * Arabic to Kamal Salih Mustafa Khalafala. | ||
+ | * Diego Spano for Spanish translations | ||
+ | * Vano Tsertsvadze for Georgian translations | ||
+ | * Japanese Gaku Yamaguchi | ||
+ | | ||
+ | * Catalan (GS2 interface) Eduardo del Valle Perez |
en/release/3.09_release_notes.1555652107.txt.gz · Last modified: 2019/04/19 05:35 by anupama