Differences

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

--- en:release:3.11_release_notes [2023/11/29 00:26] – [Important Changes and Bug Fixes] kjdon
+++ en:release:3.11_release_notes [2024/09/15 22:56] (current) – kjdon
@@ Line 11: / Line 11: @@
 ** 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 (OS version 12.6.7)
+   * Download from [[https://www.greenstone.org/download]]
+   * 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 (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.
@@ Line 30: / Line 33: @@
 ==== Installing and running the binary release====
-  * Download the appropriate binary release for your operating system and run it.
+  * [[https://www.greenstone.org/download | Download]] the appropriate binary release for your operating system and run it.
 === 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.
 === Linux Notes ===
-  * You will need to set the file to be executable before running it. e.g. \\ In a terminal ''chmod a+x Greenstone-3.11-linux''\\ or on Ubuntu, you can right-click on the installer, choose Properties, Go to the Permissions tab and ensure the "Execute: Allow executing file as program" tickbox is ticked.
+  * You will need to set the file to be executable before running it. e.g. \\ In a terminal ''chmod a+x Greenstone-3.11-linux-x64''\\ or on Ubuntu, you can right-click on the installer, choose Properties, Go to the Permissions tab and ensure the "Execute: Allow executing file as program" tickbox is ticked.
     * The installer initially unpacks into a temporary directory (/tmp on linux). If you wish to change this, set the TMPDIR environment variable.
 Note that in some cases, the following **doesn't** work
 <code> export TMPDIR=/something/else
- ./Greenstone-3.11-linux</code>
+ ./Greenstone-3.11-linux-x64</code>
 Use the following instead
-<code> TMPDIR=/something/else ./Greenstone-3.11-linux</code>
+<code> TMPDIR=/something/else ./Greenstone-3.11-linux-x64</code>
 ===Windows Notes ===
@@ Line 65: / Line 69: @@
   * Choosing a password for the administration pages. These pages allow the admin user to inspect and manage the list of registered Greenstone users. You can add new users, and change group settings for existing users. Greenstone user registration is needed if you want to use remote GLI login to the Greenstone server, or if you want to make collections/documents only accessible by certain groups of users. (//If the password is not set during installation, the default password for the 'admin' user is 'admin'. You can change the password any time after installation, by running the Greenstone 3 server and visiting the Administration pages. See [[#disabling_admin_access_in_installer| below]]//).
-==== Running Greenstone ====
+==== Running the installer in text-only mode ====
-Once you have successfully installed Greenstone3, you can start up the server by choosing Grenstone3 Digital Library from the Start menu (Windows) or running gs3-server.sh/bat. This launches a small server program which starts up Tomcat and launches a browser. A small window pops up which allows you to change some settings for your library and restart the Tomcat server. Closing this program will stop Tomcat running. By default, your library will be available at localhost:8383/greenstone3/library. File->Settings in the Greenstone Server window gives you options to change the port number and which browser it uses by default.
-More notes about running Greenstone can be found in the README.txt file in the top level Greenstone folder.
-==== 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.
-==== Installing in text-only mode ====
+You may want to run in text-only mode if you are installing on a headless server for example.
-* Refer to [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#running_the_installer_in_text-only_mode|Running the installer in text-only mode]]
+  - If you're on Linux or Mac, give the binary of the installer execute permissions
+  - Then run it by passing in the -textonly flag, as shown below.
+  - Follow the instructions on the screen thereafter. If you mistype at any stage, press ctrl-C to start again.
+<code>
+> ./Greenstone-3.11-linux-x64 -textonly
+</code>
 ==== Adding source code to a binary release ====
@@ Line 85: / Line 88: @@
   * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution|Windows: Source Distribution instructions]]
   * [[http://wiki.greenstone.org/doku.php?id=old:user_advanced:installation#source_distribution1|Linux/Mac: Source Distribution instructions]]
+===== Running Greenstone =====
+Once you have successfully installed Greenstone3, you can start up the server by choosing Grenstone3 Digital Library from the Start menu (Windows) or running gs3-server.sh/bat. This launches a small server program which starts up Tomcat and launches a browser. A small window pops up which allows you to change some settings for your library and restart the Tomcat server. Closing this program will stop Tomcat running. By default, your library will be available at localhost:8383/greenstone3/library. File->Settings in the Greenstone Server window gives you options to change the port number and which browser it uses by default.
+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 (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.