en:release:3.11_release_notes
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
en:release:3.11_release_notes [2023/07/24 01:20] – [Important Changes and Bug Fixes] kjdon | en:release:3.11_release_notes [2024/02/11 23:19] – [Building Collections] kjdon | ||
---|---|---|---|
Line 7: | Line 7: | ||
**Release Name:** 3.11 | **Release Name:** 3.11 | ||
- | <!--**Release Date: | + | **Release Date: |
** Released: ** | ** Released: ** | ||
- | <!-- | + | * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey |
- | * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey\\ All the binaries have only been spot-tested, | + | * The Mac binary is generated on Monterey/12.6.7 (a VM). For rc1, most of the testing work was done on the same Monterey/12.6.7. The final release' |
- | * The Mac binary is generated on Mojave/10.14. For rc1, most of the testing work was done on Catalina/10.15, with some features tested on Mojave/10.14, such as remote GS3. Final release' | + | * The Windows release candidate 1 binary was tested on Windows 10, and the final release also spot tested |
- | * The Windows release candidate 1 binary was largely | + | * The Linux release-candidate 1 binary was largely tested on Ubuntu |
- | * The Linux release-candidate 1 binary was largely tested on Ubuntu | + | |
- | --> | + | |
** Release Candidate History ** | ** Release Candidate History ** | ||
- | * Greenstone 3.11 rc1: Release Candidate 1. Released 10 July 2023.\\ Binaries for Windows, GNU/Linux 64 bit, Mac Monterey. Mac version generated on MacOS Monterey/ | + | * Greenstone 3.11 rc1: Release Candidate 1. Released 10 July 2023.\\ Binaries for Windows, GNU/Linux 64 bit, Mac Monterey. Mac version generated on MacOS Monterey/ |
**GS3.11rc1 unknowns on Mac Monterey:** | **GS3.11rc1 unknowns on Mac Monterey:** | ||
Line 36: | Line 34: | ||
=== Mac OS Notes === | === Mac OS Notes === | ||
- | * 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 " | + | * 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 " |
- | - Ctrl+click (the Mac rightclick) and choose '' | + | - Double click the downloaded dmg file to mount it. The click the Volume image to open it - it will display the Greenstone installer .app. |
- | - REPEAT: This //second// time you try to Ctrl+click and choose '' | + | - Ctrl+click (the Mac rightclick) and choose '' |
- | - Open a Finder window and navigate to the ''/ | + | - REPEAT: This //second// time you try to Ctrl+click and choose '' |
- | - Now Ctrl+click on the '' | + | - Try running this again - if it passes the jre stage, and gets you to the Greenstone installer dialog, then great. If not, |
+ | - Open a Finder window and navigate to the ''/ | ||
- Now return to the installer .app file inside the .dmg. Ctrl+click on it and launch the installer once more. This time the launch process will complete and within a minute or so you should see the Greenstone Installer opening dialog appear. | - Now return to the installer .app file inside the .dmg. Ctrl+click on it and launch the installer once more. This time the launch process will complete and within a minute or so you should see the Greenstone Installer opening dialog appear. | ||
Line 71: | Line 70: | ||
More notes about running Greenstone can be found in the README.txt file in the top level Greenstone folder. | More notes about running Greenstone can be found in the README.txt file in the top level Greenstone folder. | ||
+ | === On a Mac === | ||
+ | |||
+ | You can either | ||
+ | - open a terminal, navigate to the folder you installed Greenstone in, and run ./ | ||
+ | - Open Finder. Use menu option Go->Go To Folder, and type in hte folder where you installed Greenstone (eg / | ||
+ | - gs3-server - double clicking will start the library server, and open a browser to your library home page | ||
+ | - gli - starts the librarian interface, which you can use to build/edit collections. | ||
+ | - gems - used for editing metadata sets. | ||
==== Building Collections ==== | ==== Building Collections ==== | ||
- | To build collections, | + | To build collections, |
Line 137: | Line 144: | ||
===== Important Changes and Bug Fixes ===== | ===== Important Changes and Bug Fixes ===== | ||
- | * Minimum Java version is now 1.8, and this is the version that is bundled in the releases. | + | * Minimum Java version is now 1.8, and this is the version that is bundled in the releases. See also [[# |
- | * This release introduces the **WebSwing GLI feature: GLI is now built into your browser.** (But regular, desktop GLI is not going away, and still available as before.) WebSwing GLI replaces the client-GLI with Remote GS3 server combination and GLI applet/GLI Webstart application. Refer to [[https:// | + | * This release introduces the **WebSwing GLI feature: GLI is now built into your browser.** (But regular, desktop GLI is not going away, and still available as before.) WebSwing GLI replaces the client-GLI with Remote GS3 server combination and GLI applet/GLI Webstart application. Refer to [[https:// |
- | * GLI Changes: | + | * GLI Changes: |
- | + | ||
- | * CSVPlugin Changed - we have a new CSVPlugin which replaces the old CVSPlugin | + | * CSVPlugin Changed - we have a new CSVPlugin which replaces |
| | ||
* The perl code has been updated to handle UTF16 surrogate pairs. | * The perl code has been updated to handle UTF16 surrogate pairs. | ||
Line 150: | Line 157: | ||
* SOLR changes - support has been added for subcollections and language partitions, to match what you can do with other indexers. While faceted searching provides an equivalent functionality, | * SOLR changes - support has been added for subcollections and language partitions, to match what you can do with other indexers. While faceted searching provides an equivalent functionality, | ||
+ | |||
+ | * A cookie consent functionality has been implemented. | ||
+ | |||
+ | * Namespaced user groups, eg nz.ac.waikato - There is now support for " | ||
+ | |||
+ | * Groups now support users Users can now be made members of a group that is a domain // | ||
+ | |||
+ | * Developing a custom interface? You can now put the interface property files into web/ | ||
+ | |||
+ | * Berry baskets have been replaced by Favourites - a more streamlined, | ||
* From perl 5.22 and later, perl no longer comes with the perl CGI module, but Greenstone 3.11 bundles its own CGIModule and unpacks it for perl v5.22 onwards, so you should be good to go. If however, you find you don't have perl CGI module installed when you want to use remote gli or do online document editing, then manually unpack it as follows: | * From perl 5.22 and later, perl no longer comes with the perl CGI module, but Greenstone 3.11 bundles its own CGIModule and unpacks it for perl v5.22 onwards, so you should be good to go. If however, you find you don't have perl CGI module installed when you want to use remote gli or do online document editing, then manually unpack it as follows: | ||
Line 157: | Line 174: | ||
mv CGIModule/* . | mv CGIModule/* . | ||
</ | </ | ||
- | | + | * Google SignIn - allows users to login to the library using their google credentials. Logging in will create a greenstone account for the user with no groups added. Requires a google client ID to be obtained, and set as a servlet parameter in resources/ |
===== IMPORTANT information ===== | ===== IMPORTANT information ===== | ||
Line 223: | Line 240: | ||
====Known Issues==== | ====Known Issues==== | ||
+ | === Java 8.0.362 issues === | ||
+ | |||
+ | We have found issues when running GLI using update 362 of Java 8. (These may occur with other updates). These are: errors when cancelling a build; GLI hanging when you add a new file type into a collection and add in the suggested new plugin. If you encounter this, please upgrade your Java 8 to the latest update (was 382 at the time of testing). Note, we bundle Java 8 update 301 with the release, which doesn' | ||
=== Changes to Tomcat port affects Solr collections === | === Changes to Tomcat port affects Solr collections === | ||
Line 253: | Line 273: | ||
====Work Arounds==== | ====Work Arounds==== | ||
+ | ===Clicking a search result doesn' | ||
+ | // | ||
+ | |||
+ | For those who know to inspect the browser' | ||
+ | |||
+ | // | ||
+ | |||
+ | // | ||
+ | |||
+ | // | ||
+ | - Download the file https:// | ||
+ | - Put it into your GS3's web/ | ||
+ | - Rename the existing '' | ||
+ | - Rename the newly downloaded '' | ||
+ | |||
+ | |||
+ | |||
+ | |||
+ | |||
===Using filenames containing &, < and > in GS3.11 collections=== | ===Using filenames containing &, < and > in GS3.11 collections=== | ||
The Enrich panel in GS3.11' | The Enrich panel in GS3.11' | ||
Line 318: | Line 357: | ||
* Lavji Zala for Gujarati translations | * Lavji Zala for Gujarati translations | ||
* Hilario Seo for Korean translations | * Hilario Seo for Korean translations | ||
- | * Yvan Arnaud for French translations | + | * Yvan Arnaud |
- | * John Rose for French | + | * Tigran Zargaryan |
- | * | + |
en/release/3.11_release_notes.txt · Last modified: 2024/02/15 02:14 by kjdon