Differences

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

--- en:release:3.11_release_notes [2023/08/14 08:07] – anupama
+++ en:release:3.11_release_notes [2024/02/15 02:14] (current) – [On a Mac] kjdon
@@ Line 12: / Line 12: @@
    * 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.
-      * The Mac binary is generated on Monterey/12.6.7. For rc1, most of the testing work was done on Monterey/12.6.7, and the final release's spot-testing also on the same.
+      * 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 Windows release candidate 1 binary was tested on Windows 10, and the final release also spot tested on the same.
       * 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.
@@ Line 34: / 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 69: / 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 137: / 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).