Differences

This shows you the differences between two versions of the page.

--- en:release:3.11_release_notes [2023/08/01 07:24] – [Important Changes and Bug Fixes] anupama
+++ en:release:3.11_release_notes [2024/02/15 02:14] (current) – [On a Mac] kjdon
@@ Line 7: / Line 7: @@
 **Release Name:** 3.11
-<!--**Release Date:** July 2023-->
+**Release Date:** 14 August 2023
 ** Released: **
-<!--
+   * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey (OS version 12.6.7)\\ All the binaries have only been spot-tested, since the 3.11 release candidate 1 binaries, which came out some months before, were tested more extensively on all the tutorials. Source distributions and source components have been tested (in week of 28 July 2023) to compile on Mac Monterey/12.6.7, Windows 10, Ubuntu 32 (12.04) and 64 bit (20.04.6 LTS). \\ [[http://svn.greenstone.org/main/tags/3.11/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11|trac tag page]]. Code revision up to 37940. Tag revision: 37949.
-   * Binaries for Windows, GNU/Linux 32 and 64 bit machines, a Mac binary for Mac Monterey\\ All the binaries have only been spot-tested, since the 3.11 release candidate 1 binaries, which came out some months before, were tested more extensively on all the tutorials. Source distributions and source components tested to compile on Mac Mojave/10.14, Windows 8.1, Ubuntu 32 (14.04) and 64 bit (16.04). \\ [[http://svn.greenstone.org/main/tags/3.11/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11|trac tag page]]. Code revision up to 33119. Tag revision: 33122.
+      * 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's spot-testing was also done on a Monterey/12.6.7, but slightly distinct: the physical machine that runs the release virtual machine/VM. (There was a fix made after the release candidate 1 was released, when we noticed the installed Mac Monterey's GS3-server and GLI had issues launching on a Monterey other than the VM it had been generated on.)
-      * 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's spot-testing done on Mojave/10.14.
+      * The Windows release candidate 1 binary was tested on Windows 10, and the final release also spot tested on the same.
-      * The Windows release candidate 1 binary was largely tested on Windows 10, but partially on Windows 8.1. Spot testing was on Windows 8.1.
+      * The Linux release-candidate 1 binary was largely tested on Ubuntu 20.04.6 LTS and spot tested on Ubuntu 12.04. Spot testing of the final release was on both of these.
-      * The Linux release-candidate 1 binary was largely tested on Ubuntu 18.04 LTS and partially on Ubuntu 14.04 and 16.04. Spot testing of the final release was on Ubuntu 16.04 LTS.
--->
 ** 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/12.6 and tested on the same. See notes directly below.\\ Download from the [[http://www.greenstone.org/snapshots|snapshots]] page\\ [[https://svn.greenstone.org/main/tags/3.11rc1/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11rc1|trac tag page]]. Code revision up to 37807. Tag revision:37810.
+  * 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/12.6 and tested on the same. See notes directly below.\\ Download from the [[http://www.greenstone.org/snapshots|snapshots]] page\\ [[https://svn.greenstone.org/main/tags/3.11rc1/|svn tag page]] [[https://trac.greenstone.org/browser/main/tags/3.11rc1|trac tag page]]. Code revision up to 37807. Tag revision: 37810.
 **GS3.11rc1 unknowns on Mac Monterey:**
@@ Line 36: / Line 34: @@
 === 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 "Personal", select Security & Privacy. In the General tab, tick "Allow apps downloaded from Anywhere", then confirm that you want to "Allow From Anywhere". You'll need to be admin to do this, otherwise click on the padlock at the bottom left of the Security & Privacy tab and log in as admin.\\ **If you are on a Mac Catalina and do not have admin rights**, you can still get around this (for now) and install GS3.11  on Mac Catalina as follows:
+  * 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 "Personal", select Security & Privacy. In the General tab, tick "Allow apps downloaded from Anywhere", then confirm that you want to "Allow From Anywhere". You'll need to be admin to do this, otherwise click on the padlock at the bottom left of the Security & Privacy tab and log in as admin.\\ **If you are on a Mac and do not have admin rights**, you can still get around this (for now) and install GS3.11  on Mac (Catalina, Monterey) as follows:
-  - Ctrl+click (the Mac rightclick) and choose ''Open With'' //or something like that// to launch the installer ''.app'' inside the ''.dmg'' Mac binary file
+  - 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 ''Open With'' to launch the installer ''.app'' inside the ''.dmg'' Mac binary file, Catalina will provide a buttonlink to allow you to "open anyway" and run the installer .app file in the ''.dmg''. After a brief time the attempt to launch the installer will fail without admin rights, mentioning something about ''/tmp/jre'' failing. //This is expected.// Press Cancel.
+  - Ctrl+click (the Mac rightclick) and choose ''Open'' //(or ''Open With''?)// to launch this installer ''.app''
-  - Open a Finder window and navigate to the ''/tmp'' folder. (One way to do this, is to launch a terminal through Go > Utilities > Terminal, then type ''cd /tmp'' and press Enter. Next type: ''open .'' and press Enter to get a Finder window opened at the ''/tmp'' folder)
+  - REPEAT: This //second// time you try to Ctrl+click and choose ''Open'' to launch the installer ''.app'' inside the ''.dmg'' Mac binary file, the Mac will provide a buttonlink to allow you to "open anyway" and run the installer .app file in the ''.dmg''. After a brief time the attempt to launch the installer will fail without admin rights, mentioning something about ''/tmp/jre'' failing. //This is expected.// Press Cancel.
-  - Now Ctrl+click on the ''jre'' inside ''/tmp''. Press Open (or maybe the button link is labelled Run) to attempt to extract the jre. This will eventually fail as the ''.dmg'' launcher did before. That's fine too. Press Cancel.
+  - 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 ''/tmp'' folder. (One way to do this, is to launch a terminal through Go > Utilities > Terminal, then type ''cd /tmp'' and press Enter. Next type: ''./jre_bin'' to extract the jre file.
   - 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.
+=== On a Mac ===
+You can either
+  - open a terminal, navigate to the folder you installed Greenstone in, and run ./gs3-server.sh
+  - Open Finder. Use menu option Go->Go To Folder, and type in the folder where you installed Greenstone (eg /Users/kjdon/Greenstone3). Then there are 3 round greenstone icons like: {{ :wiki:favicon.ico |}}
+    - 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 ====
-To build collections, run GLI from the Start menu (Windows) or by running gli/gli.sh/bat in the top level Greenstone3 folder. Tutorial exercises about building collections in Greenstone 3 can be found [[en:tutorials | here]]. Make sure you select the Greenstone3 tab at the top if it is not already selected.
+To build collections, run GLI from the Start menu (Windows) or by running gli/gli.sh (gli/gli.bat on windows) in a terminal cd'd to the top level Greenstone3 folder. Tutorial exercises about building collections in Greenstone 3 can be found [[en:tutorials | here]]. Make sure you select the Greenstone3 tab at the top if it is not already selected.
@@ Line 139: / Line 146: @@
   * Minimum Java version is now 1.8, and this is the version that is bundled in the releases. See also [[#java_80362_issues| notes about Java 8 update 362]].
-  * 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://files.greenstone.org/tutorial/gs3-current/en/all_tutorials.html#webswing_gli|Using WebSwing GLI (Web GLI)]] for instructions on how to start using WebSwing GLI. It's mostly the same as Desktop GLI, so the linked tutorial runs you through just the differences.
+  * 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://files.greenstone.org/tutorial/gs3-current/en/all_tutorials.html#webswing_gli|Using WebSwing GLI (Web GLI)]] for instructions on how to start using WebSwing GLI. It's mostly the same as Desktop GLI, so the linked tutorial runs you through just the differences. See also [[en:user_advanced:webswing_gli|Webswing GLI page]] for additional info on getting it working.
   * GLI Changes: GUI support added for SOLR indexing, and for specifying sortfields (Lucece/SOLR) and facets (SOLR).
@@ Line 153: / Line 160: @@
   * A cookie consent functionality has been implemented.
-  * Namespaced user groups, eg nz.ac.waikato - There is now support for "namespaced user groups" which are group names that use dots and look like a //reversed// domain name (but needn't be a real domain, just a sequence of characters separated by dots). Users who are members of namespaced user groups are automatically members of subsidiary groups (which is each //prefix// that can be formed upto //any// dot in the full namespaced user group name). For example, a user who is member of user group ''nz.ac.waikato.cs.pinky'', will be able to access not only documents and collections restricted to that very group, ''nz.ac.waikato.cs.pinky'', but will also have access to collections and documents restricted to ''nz.ac.waikato.cs'', ''nz.ac.waikato'', ''nz.ac'' and ''nz''. Note however, that the group ''nz.ac.waikato.cs.pinky'' does not give access to content restricted to a group whose name is //not// a prefix of it, like '''waikato.cs''.
+  * Namespaced user groups, eg nz.ac.waikato - There is now support for "namespaced user groups" which are group names that use dots and look like a //reversed// domain name (but needn't be a real domain, just a sequence of characters separated by dots). Users who are members of namespaced user groups are automatically members of subsidiary groups (which is each //prefix// that can be formed upto //any// dot in the full namespaced user group name). For example, a user who is member of user group ''nz.ac.waikato.cs.pinky'', will be able to access not only documents and collections restricted to that very group, ''nz.ac.waikato.cs.pinky'', but will also have access to collections and documents restricted to ''nz.ac.waikato.cs'', ''nz.ac.waikato'', ''nz.ac'' and ''nz''. Note however, that the group ''nz.ac.waikato.cs.pinky'' does not give access to content restricted to a group whose name is //not// a prefix of it, like ''waikato.cs''.
   * Groups now support users Users can now be made members of a group that is a domain //reversed//, e.g. user nz.ac.waikato.cs.pinky will hor any proper prefix thereof, and it will check users are members of any prefix of that group when choosing to give access to them.
@@ Line 350: / Line 357: @@
   * Lavji Zala for Gujarati translations
   * Hilario Seo for Korean translations
-  * Yvan Arnaud for French translations
+  * Yvan Arnaud and John Rose for French translations
-  * John Rose for French translations
   * Tigran Zargaryan for Armenian translations